ImageMagick资源配置

Aprilus
2009.4.27

 

ImageMagick依靠许多的外部资源，包括配置文件、可加载的模块、字体和环境变量。

配置文件

• coder.xml

  用指定的编码器模块关联图片格式。

  ImageMagick有许多编码器模块支持图像格式（例如JPEG）的读入和/或写入。一些编码器模块支持超过一种关联的图像格式和关联格式之间 的映射，各自的编码器模块都定义在这个配置文件中。举例来说，PNG编码器模块除了支持PNG图像格式，还支持JNG和MNG格式。

• colors.xml

  用红绿蓝和alpha亮度值关联一个颜色名。

  许多命令行选项要求带 颜色参数，用名字（比如white）来引用一个颜色通常都比用十六进制值（比如#fff）更方便。这个文件映射了颜色名到它等价的红绿蓝和aplha亮度值（比如white就对应red=255，green=255，blue=255，alpha=0）

• configure.xml

  设置ImageMagick的构建参数和系统范围的环境变量（比如MAGICK_TEMPORARY_PATH）。

  ImageMagick构建后，许多构建参数被保存在这个配置文件中。它们包括版本、发行日期、依赖的可删除的库，还包括quantum depth等。

• delegates.xml

  关联处理某个图像格式的程序。

  ImageMagick依靠许多指定的程序来支持某个图像格式，比如 用来读取raw照相机格式，又如 用来读取Postscript图像。这个配置文件用来将输入或者输出格式映射到指定的外部程序。

• english.xml

  用英文翻译来关联消息标签。

• francais.xml

  用法文翻译来关联消息标签。

• locale.xml

  用你设定的locale值的翻译来关联消息标签。

  ImageMagick有许多用标签表示的提示、警告和错误消息。标签是一个消息的简短描述，比如 FileNotFound 或者 MemoryAllocationFailed。这个配置文件列出了所有可用的locale值，这些locale都有一个相应的译文来对应每个被ImageMagick识别的标签。当前只有英语和法语翻译是可用的，分别在 english.xml 和 francais.xml 配置文件中。

• log.xml

  配置记录参数。

  ImageMagick能够展示出丰富的信息或者调试语句。使用此文件来配置如何表现日志消息中的信息，和想让日志消息投递到的地方。

• magic.xml

  用一个唯一的标识符来关联一个图像格式。

  许多图像格式都有一个唯一标识特定图像格式的标识符。举例来说，GIF图像格式经常以 GIF8 作为文件开始的四个字符。当ImageMagck读取一张图像的时候，它使用这个信息来快速判断它正在处理的图像类型。

• mime.xml

  用一个唯一的标识符来关联一个internet媒体类型。

  许多文件和数据流都有一个唯一标识特定互联网媒体类型的标识符。举例来说，“Corel Draw drawing”格式（mime类型=“application/vnd.corel-draw”）的文件经常关联以*.cdr的文件名模式，同时还有一个初始化字符串“CDRXvrsn”。如果可行的话，ImageMagick会利用这些信息尝试快速判断一个文件或者数据流的互联网媒体类型。

• policy.xml

  配置ImageMagick策略。

  默认情况下任何编码器、委托、筛选器或者文件路径都是允许的。使用策略来拒绝访问，比如，MPEG视频委托，或者允许从文件系统中读取图片，但是禁 止写入。或者使用资源策略来设置资源限制。对于需要限制使用ImageMagick对系统造成影响的多用户服务器来说，策略是很有用的，举例来说，限制内 存中的最大图像大小在100MB内：

  任何大于这个area限制的图像都会被缓存到磁盘上，而不是内存。

  将ImageMagick命令运行的时间限制在5分钟以内，使用下面的策略：

• thresholds.xml

  为有序的色调分离的抖动设置阈值映射。

• type.xml

  配置字体。

  为你想通过ImageMagick使用的任意字体定义font name、family、foundry、style、format、metrics和glyphs。

• type-ghostscript.xml

  配置 字体。

  Ghostscript软件包包含许多能够被ImageMagick使用的字体。

• type-windows.xml

  配置Windows字体字形的name关联。

在Unix和Linux下，ImageMagick会搜索上面列出的所有配置文件来查看以下给出的位置参数，如果找到的话就加载它们。

  $MAGICK_CONFIGURE_PATH
  $PREFIX/lib/ImageMagick-6.6.1/config
  $PREFIX/share/ImageMagick-6.6.1/config
  $PREFIX/share/ImageMagick-6.6.1  $HOME/.magick/
  /lib/ImageMagick-6.6.1/
  /

环境变量$PREFIX是默认的安装路径（例如/usr/local）。client path是ImageMagick客户端执行的路径。（例如/usr/local）

对于那些Unix或Linux的预编译二进制发布版，配置加载顺序如下：

  $MAGICK_CONFIGURE_PATH
  $MAGICK_HOME/lib/ImageMagick-6.6.1/config
  $MAGICK_HOME/share/ImageMagick-6.6.1/config
  $PREFIX/share/ImageMagick-6.6.1  $HOME/.magick/
  /lib/ImageMagick-6.6.1/
  /

在Windows下，ImageMagick用以下顺序搜索配置文件，如果找到的话就加载它们：

  $MAGICK_CONFIGURE_PATH
  
  $PREFIX/config
  $USERPROFILE/.magick/
  
  

上面的$PREFIX是默认的安装路径，如 c:\\Program Files\\ImageMagick-6.6.1。

对于一个已卸载的Windows安装程序，配置加载顺序为：

  $MAGICK_CONFIGURE_PATH
  $MAGICK_HOME
  $USERPROFILE/.magick/
  client path
  

如果找不到某个配置文件，ImageMagick会依靠内建的默认值。

模块

ImageMagick的图像格式支持通常以可加载模块的形式提供。它按照以下顺序搜索可加载模块，并且使用最先匹配的那个。

  /
  $MAGICK_HOME/lib/ImageMagick-6.6.1/modules-Q16/coders/
  $HOME/.magick/
  /../lib/ImageMagick-6.6.1/modules-Q16/coders/
  $MAGICK_HOME/lib/ImageMagick-6.6.1/modules-Q16/coders
  $MAGICK_HOME/share/ImageMagick-6.6.1/modules-Q16/coders
  $HOME/.magick/
  /lib/ImageMagick-6.6.1/modules-Q16/coders
  /

字体

ImageMagick能够加载raw TrueType和Postscript字体文件。它按照以下顺序搜索字体配置文件，type.xml，如果找到了就加载它们：

  $MAGICK_CONFIGURE_PATH
  $MAGICK_HOME/lib/ImageMagick-6.6.1/config
  $MAGICK_HOME/share/ImageMagick-6.6.1/config
  $HOME/.magick/
  /lib/ImageMagick-6.6.1/
  /
  $MAGICK_FONT_PATH

环境变量

能够被ImageMagick识别的环境变量包括：

• HOME

  设置路径来搜索在$HOME/.magick中的配置文件——如果目录存在的话。

• LD_LIBRARY_PATH

  设置ImageMagick的共享函数库和其它依赖的库的路径。

• MAGICK_AREA_LIMIT

  设置图像能够缓存的最大宽度*高度。

  超过area限制的图像将会被缓存到磁盘上（参见 MAGICK_DISK_LIMIT）。

• MAGICK_CODER_FILTER_PATH

  设置搜索筛选器处理模块的路径（通过 -process 调用）

  这个路径允许用户通过增加可加载的模块来扩展ImageMagick的图像处理功能，用自定义路径而不是只能将他们复制到ImageMagick安 装目录下。搜索路径的格式类似于操作系统的搜索路径（例如对于UNIX来说是用冒号分隔的，Microsoft Windows则是用分号）。这个用户定义的搜索路径先于 default search path 被搜索。

• MAGICK_CODER_MODULE_PATH

  设置ImageMagick找出编码器模块的路径。

  这个路径允许用户通过增加可加载的编码器模块来任意扩展ImageMagick对图像格式的支持。用户可以自定义路径，而不是只能将它们复制到 ImageMagick安装目录下。搜索路径的格式类似于操作系统的搜索路径（例如对于UNIX来说是用冒号分隔的，Microsoft Windows则是用分号）。这个用户定义的搜索路径先于 default search path 被搜索。

• MAGICK_CONFIGURE_PATH

  设置ImageMagick找出配置文件的路径。

  使用这个搜索路径来搜索配置（.xml）文件。搜索路径的格式类似于操作系统的搜索路径（例如对于UNIX来说是用冒号分隔的，Microsoft Windows则是用分号）。这个用户定义的搜索路径先于 default search path 被搜索。

• MAGICK_DEBUG

  设置调试选项。

  关于调试选项的描述见 -debug。

• MAGICK_DISK_LIMIT

  设置图像缓存允许使用的以字节为单位的最大磁盘空间量。

  超过限制时，图像缓存不会被创建，同时返回一个错误消息。

• MAGICK_FILE_LIMIT

  设置同时打开的缓存图像文件的最大数量。

  超过限制时，任何接下来的图像缓存到磁盘的操作会被关闭，再次请求时会重开。这种行为允许在磁盘上同时处理大量图片，但是由于反复的打开/关闭调用会导致速度上的限制。

• MAGICK_FONT_PATH

  设置ImageMagick搜索TrueType和Postscript Type1字体文件的路径。

  如果在当前目录中找不到指定字体文件，会查询这个路径。

• MAGICK_HOME

  设置ImageMagick安装目录的路径。

  当ImageMagick的卸载构造没有硬编码定位或被安装程序设置时，这个路径会被考虑进来。

• MAGICK_MAP_LIMIT

  设置以字节为单位的最大内存映射容量，用来分配图像缓存。

  当超过限制时，图像会被缓存到磁盘上（参见MAGICK_DISK_LIMIT）。

• MAGICK_MEMORY_LIMIT

  设置以字节为单位的最大内存容量，用来从堆里分配图像缓存。

  当超过限制时，图像会被缓存到内存映射的磁盘上（参见 MAGICK_MAP_LIMIT）

• MAGICK_PRECISION

  设置打印有效数字的最大位数。

• MAGICK_TEMPORARY_PATH

  设置存储临时文件的路径。

• MAGICK_THREAD_LIMIT

  设置最大数目的并行线程。

  许多ImageMagick算法在多处理器系统中是并行运行的。使用这个环境变量来设置允许并行运行的最大数目的线程。

• MAGICK_TIME_LIMIT

  设置以秒为单位的最大时间。

  当超过限制时，抛出异常，同时停止运行。