处理参数
文字水印
本文介绍为图片增加 文字水印 功能的参数说明及使用示例。
以下例子中,默认原图均为: https://fanfan.s3.bitiful.net/bridge.jpeg
参数说明
该方法只能用于静态图片
相关参数总览
**水印参数: **
参数 | 含义 | 作用说明 | 范围 |
---|---|---|---|
txt | 水印内容 | 默认为空 - 代表不增加文字水印(推荐进行 UrlEncode) | 可打印字符 |
txt-font | 水印字体 | 默认为空, 多个字体用半角逗号隔开, 系统按顺序匹配 | Inter, NotoSansSC, NotoSansTC, SmileySans |
txt-size | 水印字号大小 | - < 1 时: 表示按原图最小边像素百分比自动计算字号 - ≥ 1 时: 表示按 px 绝对值设定字号 | - |
txt-weight | 水印字号粗细 | 同 CSS 中 font-weight,默认: 400 | 100 ~ 900 |
txt-line-height | 水印行高 | 按倍数设置行高,同 CSS 中 line-height(不支持px),默认: 1.1 | 0.0 ~ 100.0 |
txt-pos | 水印位置偏移 | - ≥ 1 时: 表示按绝 px 对值设定偏移 - < 1 时: 表示按原图像素百分比自动计算偏移(支持 3 种偏移策略) — 策略A: 0.99,0.99 表示按水印渲染范围的最远边(即: 右&下边)计算(此时水印绝对不会超过原图边界) — 策略B: *0.99,*0.99 表示按水印渲染范围的中心计算(此时水印会超出原图边界一半) - 策略C: **0.99,**0.99 表示按水印渲染范围的最近边(即: 左&上边)计算(此时水印会完全超出原图边界) | - |
txt-pct | 水印最大百分比 | - 当水印 size 过大时,系统会用该值对总大小进行约束 如: 设定 0.5 代表无论 size 多大都不会超过原图 50% 大于 1 时代表可超出原图大小,有助于部分艺术表达场景 | 0.0 ~ 2.0 |
txt-color | 水印颜色 | RGB 颜色 16 进制值,不支持颜色名称(默认为白色) 多个颜色用半角逗号(,)隔开,可txt-color-deg方向实现渐变色 | 000000 ~ FFFFFF |
txt-color-deg | 水印颜色渐变方向 | 代表代表渐变角度(默认为 90 代表从 左 -> 右) | 0 ~ 360 |
txt-alpha | 水印透明度 | 透明度百分比。 | 0.0 ~ 1.0 |
txt-shad | 水印阴影虚化度 | - 为像素 px 绝对值 - 注意: txt-color 为多个颜色适合,阴影自动关闭 | 0 ~ 50 |
txt-shad-pos | 水印阴影偏移 | 为像素 px 绝对值 | 0 ~ 100 |
txt-shad-color | 水印阴影颜色 | - RGB 颜色 16 进制值,不支持颜色名称(默认为灰色) - 注意: 不支持多个颜色 | 000000 ~ FFFFFF |
推荐: 为 txt-size 和 txt-pos 设定比例值而不是绝对值。
由于原图的比例、大小(特别是在配合 w 和 h 参数对原图进行裁剪、缩略后)各不相同,为 txt-size 和 txt-pos 设定 小于 1 的比例值 能让水印大小及偏移位置更可靠。