ImageMagick 项目中 MagickWand API 的官方文档页面。MagickWand 是 ImageMagick 图像处理库的 C 语言接口,它提供了一组推荐的方法来在 C 程序中使用 ImageMagick 功能。
以下是 MagickWand API 的一些关键特点:
简化的接口:与 MagickCore C API 相比,MagickWand 使用少量的不透明类型,并通过访问器方法设置或获取重要的属性。
公共方法描述:文档提供了 MagickWand 公共方法的描述,包括设置或获取 Magick 属性、图像方法、像素迭代器方法、像素棒方法、图像向量绘制等。
示例程序:页面提供了示例程序,展示如何使用 MagickWand API 读取图像、创建缩略图并写入磁盘。
编译指令:提供了编译 MagickWand 程序的示例指令,包括如何使用 MagickWand-config 工具来获取编译和链接标志。
环境变量设置:如果 ImageMagick 不在默认系统路径中,可以设置 PKG_CONFIG_PATH 环境变量来指定其位置。
错误处理:示例代码中包含了错误处理的宏定义 ThrowWandException,用于获取异常描述并退出程序。
多线程支持:ImageMagick 可能内部使用 OpenMP 进行多线程处理,因此文档中提到了确保在调用 MagickWandTerminus() 之前完成所有 ImageMagick 函数调用的重要性。
MagickWandTerminus() 函数用于在应用程序关闭时清理和释放资源。这是一个重要的函数,应该在应用程序的主线程中调用,以确保在使用 ImageMagick 函数的任何线程终止后正确地释放资源。
此外,页面还提供了一些使用 MagickWand 的示例,如对比度控制和并行处理图像的示例,展示了如何利用多核处理器提高图像处理的效率。