网站内容管理系统上传图片(图片基础处理的限制说明(2)--示例1. )
优采云 发布时间: 2022-03-29 07:04网站内容管理系统上传图片(图片基础处理的限制说明(2)--示例1.
)
功能概述
对象存储通过数据万象水印接口提供图像水印处理功能。目前，水印图片必须指定为数据万象绑定（或新创建）的桶中存储的图片。有关图像水印等基本图像处理的限制，请参阅规则和限制。
该函数支持以下处理方式：
阐明：
接口示例1. 下载时的处理
download_url?watermark/1/image/
/gravity/
/dx/
/dy/
/blogo/
阐明：
请忽略上面的空格和换行符。
2. 上传过程
PUT / HTTP/1.1
Host: .cos..myqcloud.com
Date: GMT Date
Authorization: Auth String
Pic-Operations:
{
"is_pic_info": 1,
"rules": [{
"fileid": "exampleobject",
"rule": "watermark/1/image/
/gravity/
/dx/
/dy/
/blogo/"
}]
}
3. 云数据处理
POST /?image_process HTTP/1.1
Host: .cos..myqcloud.com
Date: GMT Date
Content-length: Size
Authorization: Auth String
Pic-Operations:
{
"is_pic_info": 1,
"rules": [{
"fileid": "exampleobject",
"rule": "watermark/1/image/
/gravity/
/dx/
/dy/
/blogo/"
}]
}
阐明：
授权：Auth String（有关详细信息，请参阅请求签名文档）。
加工参数说明
操作名称：watermark，数字为1，表示水印类型为图片水印。
参数含义
下载网址
文件的访问链接，具体由.cos../组成
,
例如 /picture.jpeg
/图片/
水印图片的地址，需要用 URL-safe Base64 编码。比如水印图片是，这里的编码字符串是aHR0cDovL2V4YW1wbGVidWNrZXQtMTI1MDAwMDAwMC5jb3MuYXAtc2hhbmdoYWkubXlxY2xvdWQuY29tL3NodWl5aW5fMi5wbmc
/重力/
文字水印位置，九方格位置（ ），默认为SouthEast
/dx/
水平（水平）边距，以像素为单位，默认值为 0
/dy/
Vertical（垂直）边距，以像素为单位，默认为0
/博客/
水印适配功能适用于水印尺寸过大的场景（如水印墙）。有两种类型：
当 blogo 设置为 1 时，水印图片会被缩放到与原图相近的大小并添加
blogo设置为2时，水印图片会直接裁剪成与原图相近的大小并添加
/scatype/
根据原图大小，缩放调整水印图大小：
当scatype设置为1时，按原图宽度缩放
当scatype设置为2时，按原图高度缩放
当scatype设置为3时，按原图整体面积进行缩放
/spcent/
与 scatype 一起使用：当 scatype 设置为 1 时，有效值为 [1, 1000]，单位为千分之一。当scatype设置为2时，有效值为[1, 1000]，单位为千分之一。当 scatype 设置为 3 时，有效值为 [1, 250]，单位为千分之一。例子：
/溶解/
图片水印的透明度，取值1-100，默认90（90%不透明度）
/批/
平铺水印功能可以将图片水印平铺到整张图片上。值为1时，表示启用平铺水印功能
/程度/
批量值为1时生效。图片水印的旋转角度设置，取值范围0-360，默认0
注意：
指定的水印图片必须同时满足以下三个条件：
九宫阁方位图
九方位图可以为图片上的各种操作提供位置参考。红点是各个区域的原点（通过重力参数选择各个区域后，位移操作会以对应的远点为参考）。
阐明：
实际案例
阐明：
本文档中的实际案例仅包括下载时的处理，此类处理不会将处理后的图像保存到存储桶中。如需保存，可参考图片持久化处理文档，配置上传时处理或云数据处理。
案例一：添加图片水印
http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?watermark/1/image/aHR0cDovL2V4YW1wbGVzLTEyNTEwMDAwMDQucGljc2gubXlxY2xvdWQuY29tL3NodWl5aW4uanBn/gravity/southeast
添加图片水印后，效果如下：
案例二：添加图片水印并携带私密文件签名
处理方法同上，只是加了签名部分，用“&”与图像处理参数连接。示例如下：
http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?q-sign-algorithm=&watermark/1/image/aHR0cDovL2V4YW1wbGVzLTEyNTEwMDAwMDQucGljc2gubXlxY2xvdWQuY29tL3NodWl5aW4uanBn/gravity/southeast
阐明：
签名部分，获取方法请参考请求签名。
防范措施
为了防止未经授权的人员在没有处理参数的情况下访问链接访问和下载原创图像，您可以同时将处理参数签入请求签名中。加工参数整体为参数的键，值为空。示例（仅供样式参考，可能已过期，无法直接访问）。详细计算方法请参考请求签名。
http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?q-sign-algorithm=sha1&q-ak=AKID********************&q-sign-time=1593342360;1593342720&q-key-time=1593342360;1593342720&q-header-list=&q-url-param-list=watermark%252f1%252fimage%252fahr0cdovl2v4yw1wbgvzlteyntewmdawmdqucgljc2gubxlxy2xvdwquy29tl3nodwl5aw4uanbn%252fgravity%252fsoutheast&q-signature=26a429871963375c88081ef60247c5746e834a98&watermark/1/image/aHR0cDovL2V4YW1wbGVzLTEyNTEwMDAwMDQucGljc2gubXlxY2xvdWQuY29tL3NodWl5aW4uanBn/gravity/southeast
