添加水印可以用于品牌推广和宣传,还可以帮助保护图片的版权,防止他人未经授权使用图片。CDN支持图片水印和文字水印,可以将水印放在图片的特定位置,并调整水印的透明度,以便在不干扰图片内容的情况下显示水印。
图像处理为付费服务,公测期间暂不收费,收费时间另行通知。
注意事项
支持同时添加多个水印,且支持同时添加图片水印和文字水印,最多支持添加5个。
图片水印暂不支持缩放,水印图片原图不能超过1 MB。
参数说明
操作名称:watermark
基础参数(水印位置)
参数
说明
取值范围
t
指定水印图片或水印文字的透明度。
[0,100]
默认值为100, 表示透明度100%(即不透明)。
g
指定水印在图片中的位置。
nw:左上
north:中上
ne:右上
west:左中
center:中部
east:右中
sw:左下
south:中下
se:右下
详情请参见上方基准点图片。
x
指定水印的水平边距, 即距离图片边缘的水平距离。这个参数只有当水印位置是左上、左中、左下、右上、右中、右下才有意义。
[0,4096]
默认值为10 ,单位:px(像素)。
y
指定水印的垂直边距,即距离图片边缘的垂直距离。 这个参数只有当水印位置是左上、中上、右上、左下、中下、右下才有意义。
[0,4096]
默认值为10, 单位:px(像素)。
水平边距、垂直边距、中线垂直偏移不仅可以调节水印在图片中的位置,当图片存在多重水印时,还可以调节水印在图中的布局。
图片水印参数
参数
说明
取值范围
image
指定可以访问的图片水印地址,水印地址可以公开访问,若有鉴权或权限设置,可能导致获取水印地址失败。
水印地址需进行Base64编码。详细信息,请参见水印编码。
Base64编码后的字符串。
文字水印参数
参数
说明
取值范围
text
指定文字水印的文字内容,文字内容需进行Base64编码。详细信息,请参见水印编码。
Base64编码后的字符串,最大长度不能超过60个字符。
type
指定文字水印的字体,字体名称需进行Base64编码。详细信息,请参见水印编码。
共支持10种文字字体,字体及字体编码请参见文字类型编码对应表。
说明如果您使用的是10种文字字体之外的其他字体,系统会识别出您使用的是默认字体alihyaihei。
color
指定文字水印的文字颜色,参数值为RGB颜色值。
RGB颜色值,例如:000000表示黑色,FFFFFF表示白色。
默认值:000000(黑色)。
rotate
指定文字顺时针旋转角度。
[0,360]
默认值:0,表示不旋转。
fill
指定是否将文字水印铺满原图。
[0,1],默认值为0。
0:表示不将文字水印铺满原图。
1:表示将文字水印铺满原图。
size
指定文字水印的文字大小。
(0,1000]
默认值:40
单位:px
type参数中可选的文字类型及编码如下表所示。
文字字体
中文含义
编码值
alihyaihei
阿里汉仪智能黑体,默认字体
YWxpaHlhaWhlaQ
hysong
汉仪宋体
aHlzb25n
hyhei
汉仪黑体
aHloZWk
hyshuangxian
汉仪双线体
aHlzaHVhbmd4aWFu
fzltzhk
方正兰亭中黑
ZnpsdHpoaw
fzshengsks
方正盛世楷书
ZnpzaGVuZ3Nrcw
fzqusongjian
方正趣宋简体
ZnpxdXNvbmdqaWFu
zzgfxingyan
造字工房星岩
enpnZnhpbmd5YW4
comfortaa
Comfortaa
Y29tZm9ydGFh
notosans
NotoSans
bm90b3NhbnM
水印编码
添加水印时,文字水印的文字内容、文字字体和图片水印的水印地址需进行URL安全的Base64编码。编码方式如下:
将内容编码成Base64。
推荐使用URL-safe Baes64编码工具对文字水印的文字内容、文字字体和图片水印的水印地址进行编码。水印编码后的内容仅适合应用在水印操作的特定参数中,请勿将其用在签名字符串(Signature)的内容里。
替换编码结果中的部分编码。
将结果中的加号(+)替换成短划线(-)。
将结果中的正斜线(/)替换成下划线(_)。
将结果中尾部的等号(=)省略。
操作示例
添加Hello World的文字水印:
对文字水印的内容Hello World进行URL安全的Base64位编码。具体操作,请参见水印编码,编码结果为
SGVsbG8gV29ybGQ
;hysong字体的为编码为aHlzb25n
。图片处理URL为:http(s)://example.com/image01.png?image_process=watermark,text_SGVsbG8gV29ybGQ,type_aHlzb25n
添加文字和图片水印:
文字水印内容:新年快乐,进行URL安全的Base64位编码结果为:
5paw5bm05b-r5LmQ
。水印文字位置是右下、水平边距10、中线垂直偏移10:
g_se,x_10,y_10
图片水印地址
http://example-test.oss-ap-southeast-1.aliyuncs.com/image/shuiyin.png
,Base64编码后为aHR0cDovL2V4YW1wbGUtdGVzdC5vc3MtYXAtc291dGhlYXN0LTEuYWxpeXVuY3MuY29tL2ltYWdlL3NodWl5aW4ucG5n
。水印图片位于原图的左上方、水平边距10、中线垂直偏移10:
g_nw,x_10,y_10
图片处理URL为:
http(s)://example.com/image01.png?image_process=watermark,text_5paw5bm05b-r5LmQ,g_se,x_10,y_10/watermark,image_aHR0cDovL2V4YW1wbGUtdGVzdC5vc3MtYXAtc291dGhlYXN0LTEuYWxpeXVuY3MuY29tL2ltYWdlL3NodWl5aW4ucG5n,g_nw,x_10,y_10
- 本页导读 (1)