图片水印
以下示例的原图均为:https://demo.bitiful.com/bridge.jpeg
图片水印只作用于静态图片。动图(GIF、动态 WebP、APNG 等)会原样输出,不加水印。
参数说明
水印图源
支持的格式:SVG / JPEG / PNG / WebP / AVIF / HEIC / BMP
- 水印图只能是同一个桶内的图片。
- 需要半透明或异形水印时,使用带透明通道的 PNG、WebP、AVIF,或直接使用 SVG。
- SVG 水印按目标尺寸矢量渲染,放大后依然清晰(2025 年 7 月起支持)。
参数总览
| 参数 | 说明 | 默认值 | 取值 |
|---|---|---|---|
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-widthmark-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 缩放裁剪之后),比例值能让水印的位置在不同图片上保持一致。
参数示例
将桶内的 Logo 置于图片底部居中:
URL:https://demo.bitiful.com/bridge.jpeg? mark=static/img/bitiful-logo@3x.png & mark-pos=0.5,0.95
