水印管理
添加水印可以用于品牌推广和宣传,还可以帮助保护图片的版权,防止他人未经授权使用图片。CDN支持图片水印和文字水印,可以将水印放在图片的特定位置,并调整水印的透明度,以便在不干扰图片内容的情况下显示水印。
阿里云CDN、DCDN和OSS的图片处理都是独立的功能,不能相互混用。
图像处理为付费服务,公测期间暂不收费,收费时间另行通知。
图像处理功能处于内测阶段,您需提交工单。申请开通。
当您使用图像处理功能时,由于不同图片格式在压缩算法上存在较大差异,因此不同图片格式之间相互转换可能会导致图片体积变大,例如:jpeg转webp、jpeg转png、png转webp。如果您需要降低图片文件的体积,建议您通过调整质量参数
quality
降低图片质量来实现。
注意事项
支持同时添加多个水印,且支持同时添加图片水印和文字水印,最多支持添加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
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
添加文字和图片水印:
文字水印内容:Hello World,进行URL安全的Base64位编码结果为:
SGVsbG8gV29ybGQ
。水印文字位置是右下、水平边距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_SGVsbG8gV29ybGQ,g_se,x_10,y_10/watermark,image_aHR0cDovL2V4YW1wbGUtdGVzdC5vc3MtYXAtc291dGhlYXN0LTEuYWxpeXVuY3MuY29tL2ltYWdlL3NodWl5aW4ucG5n,g_nw,x_10,y_10