添加文字水印
更新时间：2024-09-10
概述
对一张图片添加文字水印。
文字水印参数
命令名称：watermark。
| 参数 | 取值 | 说明 |
|---|---|---|
| text | - | 水印文字内容，需要进行url安全的Base64编码，且编码后最多不能超过200个字符。文字水印必选。 |
| size | 1-1024 | 指定水印字体大小。非必选，默认30。 |
| color | 8位十六进制颜色码 | 指定字体颜色，格式为RRGGBBAA。最后2位Alpha通道可省略，省略时默认为00表示不透明。非必选，默认黑色000000。 |
| type | 支持的字体见下表 | 指定字体的字体类型，取值要求进行url安全的Base64编码。非必选。若指定的字体不支持的字体列表中，则为默认为宋体。 |
| style | normal、italic、bold | 指定字体样式。normal（常规）italic（斜体）bold（粗体）。非必选，默认normal。只有当字体支持style效果时，才会渲染文字效果。 |
| g | 1-9 | 指定水印的锚点位置。非必选，默认9。具体含义见下方说明。 |
| x | -4096-4096 | 指定水印基于锚点的水平方向距离。非必选，默认值10。 |
| y | -4096-4096 | 指定水印基于锚点的垂直方向距离。非必选，默认值10。 |
| a | -360-360 | 指定水印旋转角度。正数表示顺时针旋转，负数表示逆时针旋转。非必选，默认值0。 |
| skw | 1-1024 | 指定文字描边宽度。非必选，默认值0。 |
| skc | 8位十六进制颜色码 | 指定文字描边颜色，格式为RRGGBBAA。最后2位Alpha通道可省略，省略时默认为00表示不透明。非必选，默认黑色000000。 |
| blr | 1-50 | 指定描边高斯模糊半径。非必选，默认值0。 |
| bls | 1-50 | 指定描边高斯模糊标准差。非必选，默认值0。 |
| layout | tile | 指定水印布局。tile（平铺）。非必选，默认值 无，具体效果见示例。 |
水印编码
在添加水印操作中，水印的文字内容、文字字体、图片水印的水印图片名称等参数需要进行URL安全的Base64编码。编码步骤如下：
- 将内容编码成Base64。将结果中的部分编码替换。
- 将结果中的加号（+）替换成短划线（-）。
- 将结果中的正斜线（/）替换成下划线（_）。
- 将结果中尾部的所有等号（=）省略。
锚点位置
将原始图片分成如下图所示9个区域，并按照图示位置进行编号，每个区域的锚点位置如图所示：
支持的字体类型
| 字体 | 名称 | base64编码 |
|---|---|---|
| FZLanTingHei | 方正兰亭黑简体 | RlpMYW5UaW5nSGVp |
| FZLanTingHeiSBGB | 方正兰亭粗黑简体 | RlpMYW5UaW5nSGVpU0JHQg== |
| FZLanTingHeiSDB1GB | 方正兰亭中粗黑简体 | RlpMYW5UaW5nSGVpU0RCMUdC |
| FZLanTingHeiSDBGB | 方正兰亭中黑简体 | RlpMYW5UaW5nSGVpU0RCR0I= |
| FZLanTingHeiSEBGB | 方正兰亭大黑简体 | RlpMYW5UaW5nSGVpU0VCR0I= |
| FZLanTingHeiSELGB | 方正兰亭纤黑简体 | RlpMYW5UaW5nSGVpU0VMR0I= |
| FZLanTingHeiSHGB | 方正兰亭特黑简体 | RlpMYW5UaW5nSGVpU0hHQg== |
| FZLanTingHeiSLGB | 方正兰亭细黑简体 | RlpMYW5UaW5nSGVpU0xHQg== |
| FZLanTingHeiSMGB | 方正兰亭准黑简体 | RlpMYW5UaW5nSGVpU01HQg== |
| FZLanTingHeiSRGB | 方正兰亭黑简体 | RlpMYW5UaW5nSGVpU1JHQg== |
| FZLanTingHeiSULGB | 方正兰亭超细黑简体 | RlpMYW5UaW5nSGVpU1VMR0I= |
| FZKaTongM19S | 方正卡通简体 | RlpLYVRvbmdNMTlT |
| FZFangSong | 方正仿宋简体 | RlpGYW5nU29uZw== |
| FZShuSong | 方正书宋简体 | RlpTaHVTb25n |
| FZKai | 方正楷体简体 | RlpLYWk= |
| FZHei | 方正黑体简体 | RlpIZWk= |
示例
- 添加文字水印，文字为蓝色
https://doc.bce.baidu.com/bce-documentation/BOS/image.jpg?x-bce-process=image/watermark,text_aGVsbG8=,type_RlpMYW5UaW5nSGVp,g_9,color_0000ff
- 添加文字水印，文字为白色，使用蓝色描边
https://doc.bce.baidu.com/bce-documentation/BOS/image.jpg?x-bce-process=image/watermark,text_aGVsbG8=,type_RlpMYW5UaW5nSGVp,size_36,g_9,color_ffffff,skw_1,skc_0000ff
- 添加文字水印，使用平铺布局
https://doc.bce.baidu.com/bce-documentation/BOS/image.jpg?x-bce-process=image/watermark,text_aGVsbG8=,size_30,g_3,x_20,y_20,a_45,layout_tile
