10. 图片水印

10.1. 基本介绍

10.1.1. 描述

水印操作可以在图片上设置另外一张图片或者文字做为水印。水印类型分成图片水印和文字水印

10.1.2. 接口

GET /${ObjectKey}?watermark HTTP/1.1

10.1.3. 参数

名称 描述 是否必须
watermark 水印操作标志
type 水印类型,1代表图片水印,2代表文字水印
gravity 水印位置,详细见水印位置参数表,默认为:SouthEast
dissolve 水印透明度,取值为1-100,默认为100(完全不透明)
dx 横轴边距,单位:像素(px),缺省值为10
dy 竖轴边距,单位:像素(px),缺省值为10
stripmeta 是否去除元数据,1表示去除,0表示保留,默认为去除

10.1.4. 水印位置

../_images/water_pos.png
  • 其中靠边的Gravity其对应dx,dy起点为对应边,如NorthWest,NorthEast,SouthWest,SouthEast其对应的原点为四个顶点,向内延伸为正。
  • 非靠边点,则以该模块和水印对象的中心点为原点,对应左右上下延伸分别为正负。

dx,dy原点对应九宫格里位置如下:

Gravity dx对应原点 dy对应原点 备注
northwest 纵轴左侧0列,向右延伸为正 横轴最顶部0行,向下延伸为正 dx,dy为0时,水印位于左上角
north 纵轴中心轴为水印部分纵轴中心中轴所在轴,向右延伸为正 横轴最顶部行,向下延伸为正 dx,dy为0时水印位于顶部居中
northeast 纵轴最右侧列,向左延伸为正 横轴最顶部行,向下延伸为正 dx,dy为0时,水印位于右上角
west 纵轴最左侧列,向右延伸为正 横轴居中行为水印部分横轴中心轴所在轴,向下延伸为正 dx,dy为0时,水印位于左侧居中
center 纵轴中心轴为水印部分纵轴中心中轴所在列,向右延伸为正 横轴居中行为水印部分横轴中心轴所在轴,向下延伸为正 dx,dy为0时,水印位于上下左右居中
east 纵轴最右侧列,向左延伸为正 横轴居中行为水印部分横轴中心轴所在轴,向下延伸为正 dx,dy为0时,水印位于右侧居中
southwest 纵轴最右侧列,向左延伸为正 横轴居中行为水印部分横轴中心轴所在轴,向下延伸为正 dx,dy为0时,水印位于右侧居中
south 纵轴中心轴为水印部分纵轴中心中轴所在轴,向右延伸为正 横轴最底部0行,向上延伸为正 dx,dy为0时,水印位于底部居中
southeast 纵轴最右侧列,向左延伸为正 横轴最底部0行,向上延伸为正 dx,dy为0时,水印位于底部居中

10.2. 图片水印

10.2.1. 请求query

watermark&type=2&text=${text}&font=${font}&fontsize=${fontsize}&fontcolor=${color}&gravity=${gravity}&dissolve=${dissolve}&dx=${distanceX}&dy=${distanceY}

10.2.2. 参数

名称 描述 是否必须
image
图片水印logo的object 名字(经过URL安全的Base64编码)。
Logo图片必须位于同一bucket下且存在,且边长不得超过4096

10.3. 文字水印

10.3.1. 请求query

watermark&type=2&text=${text}&font=${font}&fontsize=${fontsize}&fontcolor=${color}&gravity=${gravity}&dissolve=${dissolve}&dx=${distanceX}&dy=${distanceY}

10.3.2. 参数

名称 描述 是否必须
text 水印文字内容(经过URL安全的Base64编码)
font
水印文字字体(经过URL安全的Base64编码),
缺省为黑体.注意:中文水印必须指定中文字体。
fontsize 水印文字大小,单位: 缇,等于1/20磅,默认大小为250,参考DPI为72,范围[20,+..]
fontcolor
水印文字颜色(经过URL安全的Base64编码),RGB格式,可以是颜色名称(比如red)或十六进制(比如#FF0000),
缺省为白色(white)

10.3.3. 水印字体

中文字体

参数 字体文件 字体
simfang simfang.ttf 仿宋
simhei simhei.ttf 黑体
simkai simkai.ttf 楷体
simsum simsun.ttc 宋体
msyh msyh.ttf 微软雅黑
msyhbd msyhdb.ttf 微软雅黑(粗体)

其它字体

参数 字体文件
arial arial.ttf
comic comic.ttf
couri couri.ttf
georgia georgia.ttf
impact impact.ttf
times times.ttf
trebuc trebuc.ttf
verdana verdana.ttf