图片水印

基本介绍

描述

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

接口

GET /${ObjectKey}?watermark
HTTP/1.1

参数

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

水印位置

  • 其中靠边的Gravity其对应dx,dy起点为对应边,如 NorthWest,NorthEast,SouthWest,SouthEast 其对应的原点为四个顶点,向内延伸为正。
  • 非靠边点,则以该模块和水印对象的中心点为原点,对应左右上下延伸分别为正负。 dx,dy原点对应九宫格里位置如下:
Gravitydx对应原点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时,水印位于底部居中

图片水印

请求query

watermark&type=1&dissolve=${dissolve}&quality=${quality}&gravity=${gravity}&image=${image}

参数

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

示例

效果图:http://img-sample.nos-eastchina1.126.net/Koala2.jpg?watermark&type=1&dissolve=80&quality=100&gravity=north&image=Y2FydG9vbl9sb2dvLnBuZw==

文字水印

请求query

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

参数

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

水印字体

中文字体

参数字体文件字体
simfangsimfang.ttf仿宋
simheisimhei.ttf黑体
simkaisimkai.ttf楷体
simsumsimsun.ttc宋体
msyhmsyh.ttf微软雅黑
msyhbdmsyhdb.ttf微软雅黑(粗体)

其它字体

参数字体文件
arialarial.ttf
comiccomic.ttf
couricouri.ttf
georgiageorgia.ttf
impactimpact.ttf
timestimes.ttf
trebuctrebuc.ttf
verdanaverdana.ttf

示例

效果图:http://img-sample.nos-eastchina1.126.net/Koala2.jpg?watermark&type=2&text=Tk9TIOmdoOiwsQ==&fontsize=2500&fontcolor=cmVk&dissolve=30&gravity=north