更新时间:2022-05-17 GMT+08:00

公共参数

此功能在控制台图形界面模式和代码编辑模式使用,也支持通过接口调用模式使用。

可以将文字内容或另一张图片设置为原图的水印。

添加水印中的文字内容和字体或图片水印路径均需使用用于URL传输的Base64编码。标准的Base64编码并不适合直接放在URL里传输。用于URL传输的Base64编码的编码方式基本过程是:先用标准Base64编码将内容编码为字符串,然后检查该字符串,将字符串中的加号(+)换成中划线(-),并且将斜杠(/)换成下划线(_)。详细编码规范请参考RFC4648标准中的相关描述。

操作名称:watermark

公共参数为设置图片水印和文字水印均可以使用的参数,可以同时添加文字和图片水印。具体基础参数说明如表1所示。

表1 公共参数

参数

取值说明

代码样例

g

可选参数,表示水印处于图片的位置。取值为tl、top、tr、left、center、right、bl、bottom和br,共9个取值。默认值为tl。

取值的九宫格如图1所示,每个取值位置均位于每一小格的左上角顶点。

image/watermark,image_aW1hZ2UtZGVtby

9sb2dvLnBuZw==,g_br,t_90,x_10,y_10

x

可选参数,表示距离图片边缘的水平距离,默认左上角为原点。取值范围为[0,4096]。默认值为10。单位为像素(px)。

y

可选参数,表示距离图片边缘的垂直距离,默认左上角为原点。取值范围为[0,4096]。默认值为10。单位为像素(px)。

voffset

可选参数,表示水印距离图片水平中线的垂直偏移方向。可以使水印根据中线往上或往下偏移。取值范围为[-1000,1000]。默认值为0。单位为像素(px)。

当g取值为left、center、right才有意义,即位置为左中、正中、右中才有意义。

align

可选参数,水印文字和图片的对齐方式。取值为0、1或2。默认值为0。

  • 0:表示上对齐。
  • 1:表示中对齐。
  • 2:表示下对齐。

order

可选参数,水印文字和图片的前后顺序。取值为0或1。默认值为0。

  • 0:表示图片在前面。
  • 1:表示文字在前面。

t

可选参数,文字或图片水印的透明度。取值范围为[0,100]。默认值为100,100%表示不透明。

interval

可选参数,表示文字和图片的间距。取值范围为[0,1000]。

水印位置九宫格如图1所示。

图1 水印位置九宫格

如果为原图同时添加文字和图片水印时,水平距离x、垂直距离y和中线垂直偏移voffset可以用于调节水印位于原图中的位置,也可以调节两张水印的布局。