在网站做相关宣传推广或版权保护的场景中,通常会在对应图片上添加水印,以达成相应效果。
开通图片处理后,客户可通过URL请求中携带的相关参数,在原图上添加水印,目前同时支持文字水印和图片水印。
注意图片处理为付费服务,目前处于公测期间,暂不收取费用,收费时间另行通知。
参数说明及示例
文字水印
参数名称:textwatermarks。
参数 | 说明 | 默认值 |
---|---|---|
text | 经url_safe_base64编码后的水印文字。例如对“天翼云”做base64编码后为 "5aSp57-85LqR"。 | 无 |
size | 字号,值类型为int。 | 无 |
color | 颜色,值为十六进制编码(hex)形式,范围为[000000-FFFFFF],例如:"FF0000"代表红色。 | 默认为白色,即"FFFFFF" |
angle | 旋转角度,值范围为[0,360]。 | 默认为0 |
t | 水印文字的透明度,值为[0,100] ;数字越小透明度越高,100代表完全不透明。 | 默认为100 |
g | 由一组g,x,y值唯一指定水印在图片中的基准点位置,这里的基准点随g值的不同而不同。 g代表原图及水印的基准点位置,值为如下: NW:左上 N:上,左右居中 NE:右上 W : 左,上下居中 C :全图居中 E : 右,上下居中 SW:左下 S : 下,左右居中 SE:右下 |
默认为NW左上 |
x | 距离原图基准点g的水平距离,需在图片宽度范围内,单位:px(像素),与y成对出现;x轴的方向为从左到右,但g值为NE、E、SE时,向右会超出原图,故这3个g值对应x轴方向为从右向左。 | 默认为0 |
y | 距离原图基准点g的垂直距离,需在图片高度范围内,单位:px(像素),与x成对出现;y轴的方向为从上到下,但g值为SW、S、SE时,向下会超出原图,故这3个g值对应y轴方向为从下到上。 | 默认为0 |
font | 字体, 支持如下值: SourceHanSans,中文为思源黑体 SourceHanSerif,中文为思源宋体 SourceHanMono,中文为思源等宽 GenShinGothic,中文为思源真黑 GenJyuuGothic,中文为思源柔黑 NotoSans NotoSansMono |
默认为思源黑体 |
相同的x,y值,以及相同水印大小情况下,g代表的基准点(包含原图及水印)不同时,水印的位置如下图所示:
蓝色圆点:代表基于g值的原图基准点及水印基准点;
绿色长方形:代表基于g值的原图基准点及x、y轴距离得出水印基准点后(水印基准点取值与原图基准点相同),再基于size大小得出的水印位置示意图。
一组g,x,y值定义的原点及x、y轴方向如下:
N:上部中间位置为坐标原点,x轴方向从左到右,y轴方向从上到下。
NE:右上角位置为坐标原点,x轴方向从右到左,y轴方向从上到下。
W:左边缘中间位置为坐标原点,x轴方向从左到右,y轴方向从上到下。
C:正中间位置为坐标原点,x轴方向从左到右,y轴方向从上到下。
E:右边缘的中间位置为坐标原点,x轴方向从右到左,y轴方向从上到下。
SW:左下角为坐标原点,x轴方向从左到右,y轴方向从下到上。
S:下边缘的中间为坐标原点,x轴方向从左到右,y轴方向从下到上。
SE:右下角坐标原点,x轴方向从右到左,y轴方向从下到上。
访问示例:
http://example.ctyun.cn/a.jpg?action=textwatermarks:text_5aSp57-85LqR,size_50,color_FF0000,x_50,y_50,font_SourceHanSerif,其中5aSp57-85LqR为“天翼云”做base64编码后的结果。
访问该URL时,将以原图的左上角NW向右50像素,向下50像素点作为文字水印左上角的位置,插入字号为50,字体为思源宋体的“天翼云”水印logo。
图片水印
参数名称:imagewatermarks。
参数 | 说明 | 默认值 |
---|---|---|
image | 经url_safe_base64编码后的水印图片URL。 注:仅支持可直接响应200的URL,如果对应URL存在鉴权,则可能无法拉取成功。 | 无 |
w,h | 水印在原图中的大小,即宽和高。默认为原水印图片大小,单位:px(像素); w和h成对出现, 且不能超出原图宽高范围,最大限制为1000*1000。 | 默认为原始水印图片大小 |
angle | 旋转角度,支持值为0,90,180,270,方向为顺时针。 | 默认为0,即不旋转 |
t | 水印的透明度,值为[0,100] ;数字越小透明度越高,100代表完全不透明。 | 默认100 |
g | 由一组g,x,y值唯一指定的水印在图片中的基准点位置,这里的基准点随g值的不同而不同。 g代表原图及水印的基准点位置,值为如下: NW: 左上 N : 上, 左右居中 NE: 右上 W : 左, 上下居中 C : 全图居中 E : 右, 上下居中 SW: 左下 S : 下, 左右居中 SE: 右下 |
默认为NW左上 |
x | x,距离原图基准点g的水平距离,需在原图宽度范围内,单位:px(像素),与y成对出现;x轴的方向为从左到右,但g值为NE、E、SE时,向右会超出原图,故这3个g值对应x轴方向为从右向左。 | 默认为0 |
y | y,距离原图基准点g的垂直距离,需在原图高度范围内,单位:px(像素),与x成对出现;y轴的方向为从上到下,但g值为SW、S、SE时,向下会超出原图,故这3个g值对应y轴方向为从下到上。 具体位置和含义与“文字水印”部分相同。 |
默认为0 |
访问示例:
http://example.ctyun.cn/a.jpg?action=imagewatermarks:image_aHR0cDovL3Rlc3QuY29tL2xvZ28ucG5n,angle_90,t_50,其中aHR0cDovL3Rlc3QuY29tL2xvZ28ucG5n为对http://example.com/logo.png做base64编码后的结果。
访问上述URL时,CDN将从http://example.com/logo.png地址获取水印图片,并按照水印原图大小,顺时针旋转90度,并作50%透明度处理后,放在原图a.jpg的左上角位置。
注意推荐使用[(SimplyCalc) base64url encoder](https://simplycalc.com/base64url-encode.php)对文字水印的文字内容及图片水印的水印地址进行base64编码。