全部文档
当前文档
最近更新时间：2024-01-17 10:25:06
indexcrop
功能描述
切割坐标定义：以图片左上角顶点为起始点，设宽为x轴，高为y轴
指定索引切割参数（x/y,i），将原图按指定大小水平/垂直分割，按指定索引取出剪切后特定区域
限制说明
权限要求
该接口操作需要是Bucket Owner或具有ks3:GetObject权限
参数值超出
如果指定的索引值大于切割后形成的区域数量，原图返回
参数值x/y同时存在
当x和y同时指定且值合法时，以y参数的值为准
GIF图片的索引切割要求
超过200帧动图不作处理，原图返回
GET /{ObjectKey} @base@tag=indexcrop HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}参数名称 | 是否必填 | 取值范围 | 解释说明 |
|---|---|---|---|
tag | 是 | indexcrop | 操作标志，取值为接口名称。索引切割操作，则URL中tag=indexcrop |
x | 否 | [1,图片宽度] | 指定在x轴切割出的每块区域的长度，宽度单位px |
y | 否 | [1,图片高度] | 指定在y轴切割出的每块区域的长度，高度单位px |
i | 否 | [0，n-1] | n表示选择切割后返回的图片块数 默认值为0，0表示第一块 n超过最大的块数原图返回 |
该请求不需要设置特殊的头部
头部名称 | 是否必选 | 说明 |
|---|---|---|
Content-Type | 是 | MIME类型，成功时为图片固定的MIME类型image/*，失败时为application/json |
如果请求处理成功，返回图片的二进制图片数据
如果请求失败，则返回如下JSON格式的内容
{
"errorCode": <HttpCode int>,
"tipInfo": <ErrorTipInfo String>,
}HTTP状态码 | 描述 |
|---|---|
400 |
|
403 | 签名不匹配或无操作对应权限 |
404 | 请求的资源不存在 |
500 | 服务器端操作失败。如果遇到此种错误，请及时联系我们 |
原图
处理参数如下：
操作参数：indexcrop
将图片在x轴按100 px为单位切割：x=100
选取切割后的第1块区域：i=0
http://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@tag=indexcrop&x=100&i=0目标图
处理参数如下：
操作参数：indexcrop
将图片在x轴按100 px为单位切割：y=100
选取切割后的第1块区域：i=0
http://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@tag=indexcrop&y=100&i=0目标图
纯净模式