libvips图像处理库技术文档

1. 安装指南

1.1 包管理器安装

对于大多数类Unix操作系统（包括macOS），可以通过包管理器进行安装。请检查您的系统包管理器。

1.2 Windows二进制安装

Windows系统上，可以在发布页面找到预编译的二进制文件。

1.3 从源代码构建

libvips使用Meson构建系统，版本0.56或更高。Meson可以使用ninja、Visual Studio或XCode作为后端，因此您需要安装其中之一。

构建libvips前，需要确保安装了build-essential、pkg-config、libglib2.0-dev、libexpat1-dev等依赖。查看以下可选依赖部分获取完整依赖列表。

基本构建步骤如下：

cd libvips-x.y.z
meson setup build --prefix /my/install/prefix
cd build
meson compile
meson test
meson install

仔细检查meson setup的输出，确保找到了所需的依赖项。可以通过添加参数到meson setup来修改构建配置。

• 使用-Dnsgif=false之类的标志来开启或关闭libvips选项，查看meson_options.txt获取所有构建选项。
• 使用-Dmagick=disabled之类的标志来开启或关闭libvips的依赖，查看meson_options.txt和下面的列表获取所有libvips依赖。

其他选项包括：

• 在Debian系统上，如果不想在库路径中加入架构名称，可能需要添加--libdir lib。
• 为了静态构建，可以添加--default-library static。
• 使用例如CC=clang CXX=clang++ meson setup ...来更改编译器。
• 可以创建多个build-dir，使用不同的名称，例如为发布和调试各创建一个。

安装后，可以运行pytest在libvips基目录下进行更全面的测试。

2. 项目的使用说明

libvips支持多种编程语言绑定，包括C、C++、Python、Ruby、PHP、C#/.NET、Go、Lua、Crystal和Elixir。用户可以通过以下方式使用libvips：

• 命令行界面：libvips提供了命令行界面，用户可以直接通过命令行执行图像处理操作。
• 编程语言绑定：用户可以选择支持的语言绑定，使用libvips提供的API进行图像处理。

3. 项目API使用文档

libvips提供了大约300个操作，包括算术、直方图、卷积、形态学操作、频率滤波、颜色处理、重采样、统计等。它支持多种图像格式，包括JPEG、JPEG2000、JPEG-XL、TIFF、PNG、WebP、HEIC、AVIF、FITS、Matlab、OpenEXR、PDF、SVG、HDR、PPM/PGM/PFM、CSV、GIF、Analyze、NIfTI、DeepZoom和OpenSlide等。

具体API使用文档可以在libvips的官方网站上找到。

4. 项目安装方式

安装libvips的方式如下：

4.1 使用包管理器

对于大多数类Unix操作系统，可以使用系统包管理器安装libvips。

4.2 下载预编译二进制文件

对于Windows系统，可以从libvips的发布页面下载预编译的二进制文件。

4.3 从源代码构建

按照上述1. 安装指南中1.3. 从源代码构建部分的说明进行操作。确保安装所有必需的依赖项，然后使用Meson构建系统进行编译和安装。

以上是libvips图像处理库的技术文档，希望对您使用libvips有所帮助。