缤纷云 S4 文字水印说明
本文介绍为图片增加水印功能的参数说明及使用示例。
以下例子中，默认原图均为: 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 |
由于原图的比例、大小（特别是在配合w和h参数对原图进行裁剪、缩略后）各不相同，为 txt-size 和 txt-pos 设定小于 1 的比例值能让水印大小及偏移位置**更可靠。
