Ruby-Vips 技术文档

1. 安装指南

1.1 Linux 和 macOS 安装

在 Linux 和 macOS 系统上，首先需要通过包管理器安装 libvips 二进制文件。例如，在 Ubuntu 上可以使用以下命令：

sudo apt install libvips42

在 macOS 上可以使用 Homebrew 安装：

brew install vips

安装完成后，可以通过以下命令安装 ruby-vips gem：

gem install ruby-vips

或者在你的 Gemfile 中添加以下内容：

gem "ruby-vips"

1.2 Windows 安装

在 Windows 系统上，ruby-vips gem 会自动拉取并安装 msys libvips，因此只需执行以下命令：

gem install ruby-vips

或者在你的 Gemfile 中添加以下内容：

gem "ruby-vips"

2. 项目的使用说明

ruby-vips 是一个用于图像处理的 Ruby 库，它基于 libvips 图像处理库。以下是一个简单的使用示例：

require "vips"

# 从文件加载图像
im = Vips::Image.new_from_file filename

# 将图像嵌入到一个 3000 x 3000 像素的图像中，位置为 (100, 100)，并使用镜像扩展
im = im.embed 100, 100, 3000, 3000, extend: :mirror

# 将绿色通道（中间通道）乘以 2，其他通道保持不变
im *= [1, 2, 1]

# 创建一个卷积核，并进行卷积操作
mask = Vips::Image.new_from_array [
    [-1, -1, -1],
    [-1, 16, -1],
    [-1, -1, -1]], 8
im = im.conv mask, precision: :integer

# 将处理后的图像保存到文件
im.write_to_file output_filename

3. 项目 API 使用文档

ruby-vips 提供了丰富的 API 接口，以下是一些常用的 API 方法：

3.1 加载图像

im = Vips::Image.new_from_file filename

3.2 图像嵌入

im = im.embed x, y, width, height, extend: :mirror

3.3 图像通道操作

im *= [1, 2, 1]  # 将绿色通道乘以 2

3.4 图像卷积

mask = Vips::Image.new_from_array [
    [-1, -1, -1],
    [-1, 16, -1],
    [-1, -1, -1]], 8
im = im.conv mask, precision: :integer

3.5 保存图像

im.write_to_file output_filename

4. 项目安装方式

4.1 通过 gem 安装

在终端中执行以下命令即可安装 ruby-vips：

gem install ruby-vips

4.2 通过 Gemfile 安装

在你的 Gemfile 中添加以下内容：

gem "ruby-vips"

然后执行 bundle install 安装依赖。

4.3 依赖库安装

在 Linux 和 macOS 上，需要先安装 libvips 库。在 Windows 上，ruby-vips 会自动安装所需的依赖库。

通过以上步骤，你可以成功安装并使用 ruby-vips 进行图像处理。