添加水印

添加水印可以用于品牌推广和宣传,还可以帮助保护图片的版权,防止他人未经授权使用图片。ESA支持图片水印和文字水印,可以将水印放在图片的特定位置,并调整水印的透明度,以便在不干扰图片内容的情况下显示水印。

参数说明

操作名称: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种文字字体,字体及字体编码请参见type参数中可选的文字类型及编码如下表所示。

说明

如果您使用的是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编码。编码方式如下:

  1. 将内容编码成Base64。

推荐使用URL-safe Baes64编码工具对文字水印的文字内容、文字字体和图片水印的水印地址进行编码。水印编码后的内容仅适合应用在水印操作的特定参数中,请勿将其用在签名字符串(Signature)的内容里。

  1. 替换编码结果中的部分编码。

    • 将结果中的加号(+)替换成短划线(-)。

    • 将结果中的正斜线(/)替换成下划线(_)。

    • 将结果中尾部的等号(=)省略。

操作示例

  • 添加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