CDN支持图片水印和文字水印。您可以通过水印参数为图片添加图片水印和水印文字。本文介绍为图片添加水印所用到的参数及示例。
说明 图像处理为付费服务，当前免费使用，收费时间另行通知。
图片水印
参数说明
操作名称：watermark
下表列出了图片水印支持的功能及功能对应的参数。
说明
- 图片水印暂不支持缩放，水印图片原图不能超过1 MB。
- 支持同时添加多个水印，且支持同时添加图片水印和文字水印，最多支持添加5个。
| 支持的功能 | 功能描述 | 参数 | 取值范围 |
|---|---|---|---|
| 水印地址 | 指定可以访问的图片水印地址，水印地址可以公开访问，若有鉴权或权限设置，可能导致获取水印地址失败。
水印地址需进行Base64编码。详细信息，请参见水印编码。 |
image | Base64编码后的字符串。 |
操作示例
- 图片水印
example.com/image01.png?image_process=watermark,image_Base64编码后的图片请求,x_20,y_20,g_se,t_70 - 文字和图片水印
example.com/image01.png?image_process=watermark,text_Base64编码后的文字内容,x_10,y_10,g_nw,size_24,color_FF0000,t_70/watermark,image_Base64编码后的图片请求,x_20,y_20,g_se,t_70
文字水印
参数说明
操作名称：watermark
下表列出了文字水印支持的功能及功能对应的参数。
说明 支持同时添加多个水印，且支持同时添加图片水印和文字水印，最多支持添加5个。
| 支持的功能 | 功能描述 | 参数 | 取值范围 |
|---|---|---|---|
| 文字内容 | 指定文字水印的文字内容，文字内容需进行Base64编码。详细信息，请参见水印编码。 | text | Base64编码后的字符串，最大长度不能超过60个字符。 |
| 文字字体 | 指定文字水印的字体，字体名称需进行Base64编码。详细信息，请参见水印编码。 | type | 共支持10种文字字体，字体及字体编码请参见文字字体。
说明 如果您使用的是10种文字字体之外的其他字体，系统会识别出您使用的是默认字体alihyaihei。
|
| 文字颜色 | 指定文字水印的文字颜色，参数值为RGB颜色值。 | color | RGB颜色值，例如：000000表示黑色，FFFFFF表示白色。
默认值：000000（黑色）。 |
| 文字旋转 | 指定文字顺时针旋转角度。 | rotate | 支持按顺时针旋转90°、180°和270°。 |
| 文字铺满 | 指定是否将文字水印铺满原图。 | fill | 取值范围[0,1]，默认值为0。
|
操作示例
- 文字水印
example.com/image01.png?image_process=watermark,text_Base64编码后的文字内容,type_YWxpaHlhaWhlaQ,x_10,y_10,g_se,size_24,color_FF0000,t_70,rotate_45,fill_0 - 文字和图片水印
example.com/image01.png?image_process=watermark,text_Base64编码后的文字内容,x_10,y_10,g_nw,size_24,color_FF0000,t_70/watermark,image_Base64编码后的图片请求,x_20,y_20,g_se,t_70
下表列出了文字水印支持的10种文字字体。
| 文字字体 | 中文含义 | 编码值 |
|---|---|---|
| alihyaihei | 阿里汉仪智能黑体，默认字体 | YWxpaHlhaWhlaQ |
| hysong | 汉仪宋体 | aHlzb25n |
| hyhei | 汉仪黑体 | aHloZWk |
| hyshuangxian | 汉仪双线体 | aHlzaHVhbmd4aWFu |
| fzltzhk | 方正兰亭中黑 | ZnpsdHpoaw |
| fzshengsks | 方正盛世楷书 | ZnpzaGVuZ3Nrcw |
| fzqusongjian | 方正趣宋简体 | ZnpxdXNvbmdqaWFu |
| zzgfxingyan | 造字工房星岩 | enpnZnhpbmd5YW4 |
| comfortaa | Comfortaa | Y29tZm9ydGFh |
| notosans | NotoSans | bm90b3NhbnM |
水印位置
图片水印和文字水印均可以按照九宫格定位、水印垂直边距和水印水平边距来设置水印的位置。九宫格定位、垂直边距和水平边距不仅可以调节水印在图片中的位置，当图片存在多重水印时，还可以调节水印在图中的布局。区域数值以及每个区域对应的基准点如下图所示。
| 参数 | 说明 | 取值范围 |
|---|---|---|
| t | 指定水印图片或水印文字的透明度。 | [0,100]
默认值为100， 表示透明度100%（即不透明）。 |
| g | 指定水印在图片中的位置。 |
|
| x | 指定水印的水平边距， 即距离图片边缘的水平距离。这个参数只有当水印位置是左上、左中、左下、右上、右中、右下才有意义。 | [0,4096]
默认值为10 ，单位：px（像素）。 |
| y | 指定水印的垂直边距，即距离图片边缘的垂直距离。 这个参数只有当水印位置是左上、中上、右上、左下、中下、右下才有意义。 | [0,4096]
默认值为10， 单位：px（像素）。 |
水印编码
添加水印时，文字水印的文字内容、文字字体和图片水印的水印地址需进行URL安全的Base64编码。编码方式如下：
- 将内容编码成Base64。
推荐使用URL-safe Baes64编码工具对文字水印的文字内容、文字字体和图片水印的水印地址进行编码。水印编码后的内容仅适合应用在水印操作的特定参数中，请勿将其用在签名字符串（Signature）的内容里。
- 替换编码结果中的部分编码。
- 将结果中的加号（+）替换成短划线（-）。
- 将结果中的正斜线（/）替换成下划线（_）。
- 将结果中尾部的等号（=）省略。