功能概述
图片处理服务由腾讯云 数据万象 CI 提供,数据万象通过 watermark 接口提供图片水印处理功能。目前水印图片必须指定为已存储于数据万象中的图片。处理图片原图大小不超过20MB、宽高不超过30000像素且总像素不超过1亿像素,处理结果图宽高设置不超过9999像素;针对动图,原图宽 x 高 x 帧数不超过1亿像素。
接口形式
download_url?watermark/1/image/<encodedURL>
/gravity/<gravity>
/dx/<dx>
/dy/<dy>
/blogo/<type>
说明:请忽略上面的空格与换行符。
参数说明
操作名称:watermark,数字1,表示水印类型为图片水印。
参数 | 含义 |
---|---|
download_url | 文件的访问链接,具体构成为<BucketName-APPID>.cos.<picture region>.<domain>.com/<picture name> ,例如 examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/picture.jpeg |
/image/ | 水印图片地址,需要经过 URL 安全的 Base64 编码。例如,水印图片为http://examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/shuiyin_2.png ,则该处编码后的字符串为aHR0cDovL2V4YW1wbGVidWNrZXQtMTI1MDAwMDAwMC5jb3MuYXAtc2hhbmdoYWkubXlxY2xvdWQuY29tL3NodWl5aW5fMi5wbmc |
/gravity/ | 文字水印位置,九宫格位置(参考九宫格方位图 ),默认值 SouthEast |
/dx/ | 水平(横轴)边距,单位为像素,缺省值为0 |
/dy/ | 垂直(纵轴)边距,单位为像素,默认值为0 |
/blogo/ | 水印图适配功能,适用于水印图尺寸过大的场景(如水印墙)。共有两种类型: |
注意:指定的水印图片必须同时满足如下3个条件:
- 水印图片与源图片必须位于同一个存储桶下。
- URL 需使用数据万象源站域名(不能使用 CDN 加速、COS 源站域名),例如
examplebucket-1250000000.image.myqcloud.com
属于 CDN 加速域名,不能在水印 URL 中使用。- URL 必须以
http://
开始,不能省略 HTTP 头,也不能填 HTTPS 头,例如examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/shuiyin_2.png
,https://examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/shuiyin_2.png
为非法的水印 URL。
九宫格方位图
九宫格方位图可为图片的多种操作提供位置参考。红点为各区域位置的原点(通过 gravity 参数选定各区域后位移操作会以相应远点为参照)。
说明:
- 当 gravity 参数设置为 center 时,dx、dy 参数无效。
- 当 gravity 参数设置为 north 或 south 时,dx 参数无效(水印会水平居中)。
- 当 gravity 参数设置为 west 或 east 时,dy 参数无效(水印会垂直居中)。
示例
原图如下
添加图片水印
http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?watermark/1/image/aHR0cDovL2V4YW1wbGVzLTEyNTEwMDAwMDQucGljc2gubXlxY2xvdWQuY29tL3NodWl5aW4uanBn/gravity/southeast
添加图片水印后效果如下: