图片水印

最近更新时间:2019-07-30 14:46:09

功能概述

腾讯云数据万象通过 watermark 接口提供图片水印处理功能。目前水印图片必须指定为已存储于数据万象中的图片。支持原图大小在20M以内、长宽小于9999像素的图片处理。

接口形式

download_url?watermark/1/image/<encodedURL>
                        /gravity/<gravity>
                        /dx/<dx>
                        /dy/<dy>
                        /blogo/<type>

说明:

请忽略上面的空格与换行符。

参数说明

操作名称:watermark,数字1,表示水印类型为图片水印。

参数 含义
download_url 文件的访问链接,具体构成为<BucketName-APPID>.<picture region>.<domain>.com/<picture name>,如examplebucket-1250000000.picsh.myqcloud.com/picture.jpeg
/image/ 水印源图片地址,需要经过 URL 安全的 Base64 编码。
/gravity/ 文字水印位置,九宫格位置(参考九宫格方位图 ),默认值 SouthEast
/dx/ 水平(横轴)边距,单位为像素,缺省值为0
/dy/ 垂直(纵轴)边距,单位为像素,默认值为0
/blogo/ 水印图适配功能,适用于水印图尺寸过大的场景(如水印墙)。共有两种类型,当 blogo 设置为1时,水印图会被缩放至与原图相似大小后添加;当 blogo 设置为2时,水印图会被直接裁剪至与原图相似大小后添加

注意:

指定的水印图片必须同时满足如下3个条件:

  • 水印图片与源图片必须位于同一个存储桶下。
  • URL 需使用数据万象源站域名(不能使用 CDN 加速、COS 源站域名),如:v2test-10000812.image.myqcloud.com属于 CDN 加速域名,不能在水印 URL 中使用。
  • URL 必须以http://开始,不能省略 HTTP 头,也不能填 HTTPS 头,如:examplebucket-1250000000.picsh.myqcloud.com/shuiyin_2.pnghttps://examplebucket-1250000000.picsh.myqcloud.com/shuiyin_2.png 为非法的水印 URL。

九宫格方位图

九宫格方位图可为图片的多种操作提供位置参考。红点为各区域位置的原点(通过 gravity 参数选定各区域后位移操作会以相应远点为参照)。

说明:

  • 当 gravity 参数设置为 center 时,dx、dy 参数无效。
  • 当 gravity 参数设置为 north 或 south 时,dx 参数无效(水印会水平居中)。
  • 当 gravity 参数设置为 west 或 east 时,dy 参数无效(水印会垂直居中)。

示例

添加图片水印

http://examples-1251000004.picsh.myqcloud.com/sample.jpeg?watermark/1/image/aHR0cDovL2V4YW1wbGVzLTEyNTEwMDAwMDQucGljc2gubXlxY2xvdWQuY29tL3NodWl5aW4uanBn/gravity/southeast

添加图片水印后效果如下: