文档简介:
图片水印
图片水印就是在原图的基础上加上一张水印图片
1.访问类型
@oosImage|watermark=1&bucket=bucketName&object=<encodedobject>&t=<transparency>&x=<distanceX>&y=<distanceY>&p=<position>…
其中watermark与object两个参数为必填项。
2.参数
名称 |
描述 |
参数类型 |
object |
水印图片的object名字(必须编码)。 注意 内容必须是url 安全Base64编码 EncodedObject = url_safe_base64_encode(object) 如object为”panda.png”, 编码过后的内容就是 “cGFuZGEucG5n”。 |
必选参数 |
bucket |
水印图片所在的bucket,必须是和要加图片水印的object是同一个用户,否则返回403 Access Denied。 |
必选参数 |
3.水印图片预处理
水印图片支持预处理,目前支持的处理有调节亮度(b)和对比度(d),按比例缩略(p),指定宽度缩略(w,h) 这几个参数,其他参数暂未支持。
参数 |
描述 |
取值范围 |
p |
对当前水印图片进行按比例缩略或放大。 |
整数形式,取值范围是:1~1000。如10p表示基于水印图片的10%进行处理。 |
P |
水印图片按主图的比例进行处理。 |
整数形式,取值范围是:1~100。如果设置了10P,主图是100x100, 那么水印图片此时的大小就是10x10, 当主图变成了200x200,那么水印图片就变成了20x20。 |
w |
按宽度缩略。指定水印图的宽度,高度按比较缩略。 |
整数形式,取值范围是: 1~4096。单位是像素(px)。 |
h |
按高度缩略。指定水印图的高度, 宽度按比较缩略。 |
整数形式,取值范围是: 1~4096。单位是像素(px)。 |
如果要指定对水印图片进行预处理,处理参数带在水印object之后,以@oosImage|连接。如:
•对panda.png 进行放大2倍: Object = url_safe_base64_encode(“panda.png@oosImage|200p”)
•所以尽量不要让原object名字是带@。不然可能会导致访问异常。如不要让 原始object名字是”panda@123.png”。
4.使用示例
· 原图example.jpg 加上水印图片是panda.png,右下角,水平边距为10, 垂直边距为10, 透明度为90
http://bucket.oos.ctyunapi.cn/example.jpg@oosImage|watermark=1&bucket=bucketName&object=cGFuZGEucG5n&t=90&p=9&x=10&y=10
· 原图example.jpg 加上水印图片是panda.png。按宽度缩略成100, 水印大小是主图的40%, 此时水印图的是40x40
http://bucket.oos.ctyunapi.cn/example.jpg@oosImage|100w.jpg|watermark=1&bucket=bucketName&object=cGFuZGEucG5nQDQwUA&t=90&p=9&x=10&y=10
· 原图example.jpg 加上水印图片是panda.png。按宽度缩略成200,水印大小是主图的40%, 此时水印图是80x80
http://bucket.oos.ctyunapi.cn/example.jpg@oosImage|200w.jpg|watermark=1&bucket=bucketName&object=cGFuZGEucG5nQDQwUA&t=90&p=9&x=10&y=10