添加水印可以用于品牌推广和宣传,还可以帮助保护图片的版权,防止他人未经授权使用图片。ESA支持图片水印和文字水印,可以将水印放在图片的特定位置,并调整水印的透明度,以便在不干扰图片内容的情况下显示水印。
参数说明
操作名称:watermark
基础参数(水印位置)
参数 | 说明 | 取值范围 |
t | 指定水印图片或水印文字的透明度。 | [0,100] 默认值为100, 表示透明度100%(即不透明)。 |
g | 指定水印在图片中的位置。 |
详情请参见上方基准点图片。 |
x | 指定水印的水平边距, 即距离图片边缘的水平距离。这个参数只有当水印位置是左上、左中、左下、右上、右中、右下才有意义。 | [0,4096] 默认值为10 ,单位:px(像素)。 |
y | 指定水印的垂直边距,即距离图片边缘的垂直距离。 这个参数只有当水印位置是左上、中上、右上、左下、中下、右下才有意义。 | [0,4096] 默认值为10, 单位:px(像素)。 |
水平边距、垂直边距、中线垂直偏移不仅可以调节水印在图片中的位置,当图片存在多重水印时,还可以调节水印在图中的布局。
图片水印参数
参数 | 说明 | 取值范围 |
image | 指定可以访问的图片水印地址,水印地址可以公开访问,若有鉴权或权限设置,可能导致获取水印地址失败。 水印地址需进行Base64编码。详细信息,请参见水印编码。 | Base64编码后的字符串。 |
文字水印参数
参数 | 说明 | 取值范围 |
text | 指定文字水印的文字内容,文字内容需进行Base64编码。详细信息,请参见水印编码。 | Base64编码后的字符串,最大长度不能超过60个字符。 |
type | 指定文字水印的字体,字体名称需进行Base64编码。详细信息,请参见水印编码。 | 共支持10种文字字体,字体及字体编码请参见type参数中可选的文字类型及编码如下表所示。。 说明 如果您使用的是10种文字字体之外的其他字体,系统会识别出您使用的是默认字体alihyaihei。 |
color | 指定文字水印的文字颜色,参数值为RGB颜色值。 | RGB颜色值,例如:000000表示黑色,FFFFFF表示白色。 默认值:000000(黑色)。 |
rotate | 指定文字顺时针旋转角度。 | [0,360] 默认值:0,表示不旋转。 |
fill | 指定是否将文字水印铺满原图。 | [0,1],默认值为0。
|
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