图片水印

图片水印只作用于静态图片。动图（GIF、动态 WebP、APNG 等）会原样输出，不加水印。

参数说明

支持的格式：SVG / JPEG / PNG / WebP / AVIF / HEIC / BMP

参数	说明	默认值	取值
`mark`	水印图片路径，即桶内 path（如 `img/logo.png`）。为空则不加水印；建议 UrlEncode	空	同桶内的图片
`mark-pos`	水印位置，格式 `x,y`，详见下方「位置写法」	`0.96,0.98`	–
`mark-pct`	最大占比。水印超过「图片宽高 × 该值」时等比缩小；大于 1 表示允许超出图片。可写 `x,y` 分别约束宽、高	0.25	大于 0，至多 5
`mark-alpha`	不透明度，0 为全透明，1 为不透明	1	0 ~ 1
`mark-blend`	混合模式	`normal`	`normal` / `multiply` / `screen` / `overlay` / `darken` / `lighten` / `soft-light` / `hard-light` / `difference` / `add` / `subtract`
`mark-tile`	平铺，设为 `1` 时铺满整张图，隔行错位	关闭	`1`
`mark-tile-gap`	平铺间距，格式 `横,纵`；百分比按水印自身宽高计算	`50%`	像素或百分比
`mark-tile-rot`	平铺倾斜角度	0	-90 ~ 90
`mark-if-min-width` `mark-if-min-height`	尺寸门槛。图片宽或高小于该值时不加水印，避免缩略图被水印遮挡	不限	像素
`mark-hdr-rate`	HDR 亮度增益（与文字水印共用），仅对带增益图的 HDR 输出生效。0 为不提亮，1 为最亮	0.5	0 ~ 1，或 0% ~ 100%

mark-pct 对位图水印是上限：水印只会缩小，不会放大。对 SVG 水印是目标尺寸：水印会按该比例渲染。

mark-pos 的 x、y 各自独立，可以混用不同写法；只写一个值时两个方向取相同值。位置按处理后的图片（缩放、裁剪之后）计算。 比例值（小于 1） 有三种定位基准：

写法	定位基准	效果
`0.5`	在「水印完整留在图内」的范围里按比例取位：0 贴左 / 上边，越接近 1 越靠右 / 下边	水印始终完整显示
`*0.5`	水印中心落在图片的该比例处	靠近边缘时最多有一半超出图片
`**0.5`	水印左 / 上边缘落在图片的该比例处	靠近右 / 下边缘时可完全移出图片

绝对值（大于等于 1）：水印左上角相对图片左上角的像素偏移。

建议为 mark-pos 设定小于 1 的比例值。原图的尺寸与比例各不相同（尤其是配合 w、h 缩放裁剪之后），比例值能让水印的位置在不同图片上保持一致。