jpeg_filter_dropon_file
`jpeg_filter_dropon_file` 指令将在 NGINX JPEG 过滤模块处理的 JPEG 图像上覆盖指定的图像。
NGINX JPEG filter module
·
location
语法jpeg_filter_dropon_file image [mask];
默认值none
上下文location
参数1-2
说明
jpeg_filter_dropon_file 指令允许用户定义一个覆盖图像，该图像可以在通过 NGINX 提供 JPEG 图像时应用。此功能特别适用于在不更改服务器上原始图像文件的情况下动态为图像添加水印或徽标。该指令接受一个或两个参数：第一个参数是覆盖图像的路径，可选的第二个参数是一个掩码图像，用于控制覆盖层对主图像的透明度和混合效果。
要配置此指令，必须将其放置在 location 块内，指定覆盖图像并可选地指定掩码。覆盖是在 NGINX 的图像处理阶段使用 libmodjpeg 库应用的。该指令支持各种使用场景，例如为不同用户或用途动态添加品牌标识，而无需重新处理 JPEG 文件，从而提高灵活性并减少服务器开销。
当使用可选的掩码图像时，其作用是定义覆盖层中将可见或被修改的区域，从而实现更复杂的覆盖效果。若仅提供一个图像，则将以该图像作为覆盖图层，可能覆盖整个 JPEG 图像。若指定了掩码，则掩码将决定覆盖层的混合和覆盖区域，从而对覆盖在原始图像上的渲染提供更精细的控制。
配置示例
location /images/ {
jpeg_filter on;
jpeg_filter_dropon_file /path/to/overlay.png /path/to/mask.png;
}⚠
确保叠加图像和掩码图像的格式和尺寸与原始 JPEG 兼容，以实现正确的混合。
⚠
应提供绝对路径以防止文件未找到错误，尤其是在工作目录可能不同的情况下。
⚠
该模块可能需要特定权限才能读取叠加图像和掩码图像文件；请确保已设置正确的文件权限。