水印
水印基本参数
图片水印，文字水印，和文图混合水印都可以使用如下参数。
参数
| 名称 | 描述 | 参数类型 |
|---|---|---|
| t | 参数意义：透明度。表示图片水印和文字水印的透明度。 默认值：100，表示 100%（不透明） 取值范围：[0-100] |
可选参数 |
| p | 参数意义：区域，原图上水印所在的区域，如下图（区域数值对应表）。 默认值：9，表示在右下角打水印。 取值范围：[1-9] |
可选参数 |
| x | 参数意义：水平边距，即距离图片边缘的水平距离，这个参数只有当水印位置是左上，左中，左下，右上，右中，右下才有意义。 默认值：10 取值范围：[0-4096] 单位：像素（px） |
可选参数 |
| y | 参数意义：垂直边距，即距离图片边缘的垂直距离，这个参数只有当水印位置是左上，中上，右上，左下，中下，右下才有意义。 默认值：10 取值范围：[0-4096] 单位：像素（px） |
可选参数 |
| voffset | 参数意义：中线垂直偏移，当水印位置在左中，中部，右中时，可以指定水印位置根据中线往上或者往下偏移。 默认值：0 取值范围：[-1000，1000] 单位：像素（px） |
可选参数 |
| watermark | 参数意义：水印的类型。 | 取值范围：[1-3] 1：图片水印 2:文字水印 3:文图混合水印 |
区域数值对应表
注意事项
- 部分URL参数以base64编码
示例
- 右下角打上文字水印。
- 右中部分打上水印，水平边距为10，垂直中线偏移为20，透明度为50。
图片水印
在原图的基础上加上一张水印图片。
访问类型
image@watermark=1&object=<encodeobject>&t=<transparency>&x=<distanceX>&y=<distanceY>&p=<position>&voffset=<voffset>
其中watermark与object两个参数为必填项。文中出现的url_safe_base64_encode指的是符合URL标准的base64编码。
参数
| 名称 | 描述 | 参数类型 |
|---|---|---|
| object | 参数意义：水印图片object的名字（必须为base64编码） 注意：内容必须是URL安全base64编码 encodeObject = url_safe_base64_encode(object) 如object为"panda.png"，编码过后的内容为"cGFuZGEucG5n" |
必选参数 |
水印位置参数请参考水印基本参数
水印图片预处理
用户在打水印时，可以对水印图片进行预处理，支持的预处理操作有：图片缩放，图片裁剪（不支持内切圆），图片旋转（具体内容请直接查看文档相关章节），但不支持管道操作。还额外支持一个参数：P（大写P），表示水印图片按原图的比例进行处理，取值范围为[1-100]，表示百分比。
示例
- 右下角打水印。水印图片是：ball.png@30P， 表示水印的大小按主图的30%缩放。
文字水印
在原图的基础上加上一段文字内容作为水印。
访问类型
image@watermark=2&text=<encodeText>&type=<encodeType>&size=<size>&color=<encodeColor>&t=<transparency>&x<distanceX>&y=<distanceY>&p=<position>&voffset=<voffset>
其中watermark与text两个参数为必填项。文中出现的url_safe_base64_encode指的是符合URL标准的base64编码。
参数
| 名称 | 描述 | 参数类型 |
|---|---|---|
| text | 参数意义：表示文字水印的文字内容（必须编码） 注意：参数必须是符合URL标准的base64编码 encodeText = url_safe_base64_encode(fontText) 最大长度为64个字符（即支持汉字最多20个左右） |
必选参数 |
| type | 参数意义：表示文字水印的文字字体（必须编码） 注意：参数必须是符合URL标准的base64编码 encodeType = url_safe_base64_encode(fontType) 取值范围：见下表（文字类型编码对应表） 默认值：wqy-zenhei（编码后的值：d3F5LXplbmhlaQ） |
可选参数 |
| color | 参数意义：文字水印文字的颜色（必须编码） 注意：参数必须是符合URL标准的base64编码 encodeFontColor = url_safe_base64_encode(fontColor) 参数构成必须是："#"+六位十六进制数 如：#000000表示黑色。#是表示前缀，000000每两位构成RGB颜色，#FFFFFF表示的是白色。 默认值：#000000（黑色）（ 编码后的值：IzAwMDAwMA） |
可选参数 |
| size | 参数意义：文字水印的文字大小（px） 取值范围：(0-1000] 默认值：40 |
可选参数 |
| s | 参数意义：文字水印的阴影透明度。 取值范围：(0-100] |
可选参数 |
水印位置参数请参考水印基本参数
文字类型编码对应表
| 参数值 | 中文意思 | URL安全base64编码后的值 | 备注 |
|---|---|---|---|
| wqy-zenhei | 文泉驿正黑 | d3F5LXplbmhlaQ== | 根据RFC，可省略填充符=变为d3F5LXplbmhlaQ |
示例
- 最简单水印：文字内容是：Hello, 图片服务！
http://www.ct-accel-demo.com/api/v1/vendor1/test2.jpeg@watermark=2&text=SGVsbG8g5LiW55WM77yB
- 字体是文泉驿正黑，字体大小是30, 颜色是白色(#FFFFFF), 文字阴影是50, 文字水印透明度是：90 文字水印内容是：Hello, 图片服务！ 水印位置是：右中，水平边距是：10， 中线垂直偏移是：20
文图混合水印
将文字，图片一起做为水印打在图片上。
访问类型
image@watermark=3&object=<encodeObject>&test=<encodeText>&type=<encodeType>&size=<siez>&color=<encodeColor>&order=<order>&align=<alingn>&interval=<interval>&t=<tranparency>&p=<position>&x=<distanceX>&y=<distanceY>&voffset=<voffset>
其中watermark，object与text三个参数为必填项。文中出现的url_safe_base64_encode指的是符合URL标准的base64编码。
参数
文图混合水印，相当于文字水印和图片水印的混合，并行在一行输出。所以文图混合水印支持文字水印和图片水印的参数。其中watermark，object，text为必选参数。
| 名称 | 描述 | 参数类型 |
|---|---|---|
| order | 参数意义：文字，图片水印前后顺序。 取值范围：[0,1] order = 0 图片在前（默认值）；order = 1 文字在前。 |
可选参数 |
| align | 参数意义：文字，图片对齐方式。 取值范围：[0，1，2] align = 0 上对齐（默认值）align = 1 中对齐 align = 2 下对齐。 |
可选参数 |
| interval | 参数意义：文字和图片间的间距 取值范围：[0，1000] | 可选参数 |
水印位置参数请参考水印基本参数
示例
- 文图混合水印，文字内容是Hello，图片服务！阴影是50, 位置在右下角，水印图片是ball.png。 水平边距和垂直边距都是10, 水印透明是：90，排版方式是图片在前，对齐方式是中对齐，间距是10。
