ngx_http_image_filter_module

• 指令
  • image_filter_buffer
  • image_filter_jpeg_quality
  • image_filter_webp_quality

此模块不是默认构建的，可以使用 --with-http_image_filter_module 配置参数启用。

设置图片执行的转换类型：

• 关闭对 location 模块的处理

• 确保响应是 JPEG、GIF、PNG 或 WebP 格式的图片。否则，返回 415（不支持的媒体类型）错误。

• size

  以 JSON 格式输出图片的信息，例如：

  发生错误时，输出如下：

• rotate 90|180|270

  将图片逆时针旋转指定的度数。参数值可以包含变量。此模式可以单独使用，也可以与调整大小和裁剪转换一起使用。

• resize width height

  按比例将图片缩小到指定的尺寸。要只指定一个维度，可以将另一个维度指定为 -。当发生错误，服务器将返回 415 状态码（不支持的媒体类型）。参数值可以包含变量。当与 rotate 参数一起使用时，旋转变换将在缩小变换之后执行。

image_filter_buffer

设置用于读取图片的缓冲区的最大大小。当超过指定大小时，服务器返回 415 错误状态码（不支持的媒体类型）。

如果启用此选项，图片最后将被逐行扫描。对于 JPEG，图片最终将采用逐行 JPEG 格式。

image_filter_jpeg_quality

设置 JPEG 图片的转换质量。可接受的值范围在 1 到 100 之间。较小的值意味着较低的图片质量和较少的数据传输。最大的推荐值是 95，参数值可以包含变量。

增加最终图像的清晰度。锐度百分比可以超过 100。零值将禁用锐化。参数值可以包含变量。

image_filter_transparency

定义在使用调色板指定的颜色转换 GIF 图像或 PNG 图像时是否保留透明度。透明度的丧失使图像的质量更好的。PNG 中的 alpha 通道透明度始终保留。

设置 WebP 图片的转换质量。可接受的值在 1 到 100 之间。较小的值意味着较低的图片质量和较少的数据传输。参数值可以包含变量。

http://nginx.org/en/docs/http/ngx_http_image_filter_module.html