功能概述
图片处理服务由腾讯云 数据万象 CI 提供，数据万象通过 imageMogr2 接口提供裁剪功能，包括普通裁剪、缩放裁剪、内切圆裁剪、圆角裁剪和人脸智能裁剪。
接口形式
download_url?imageMogr2/cut/<width>x<height>x<dx>x<dy>
/crop/<imageSizeAndOffsetGeometry>
/iradius/<radius>
/rradius/<radius>
/scrop/<Width>x<Height>说明：请忽略上面的空格与换行符。
参数说明
| 参数 | 含义 |
|---|---|
| download_url | 文件的访问链接，具体构成为<BucketName-APPID>.cos.<picture region>.<domain>.com/<picture name>，例如 examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/picture.jpeg |
普通裁剪参数说明
操作名称：cut。
| 参数 | 含义 |
|---|---|
| <width> | 指定目标图片的宽为 width |
| <height> | 指定目标图片的高为 height |
| <dx> | 相对于图片左上顶点水平向右偏移 dx |
| <dy> | 相对于图片左上顶点垂直向下偏移 dy |
说明：参数取值范围应大于0，小于原图宽高。
缩放裁剪参数说明
操作名称：crop。
| 参数 | 含义 |
|---|---|
| /crop/<Width>x | 指定目标图片宽度为 Width ，高度不变。Width 取值范围应大于0，小于原图宽度 |
| /crop/x<Height> | 指定目标图片高度为 Height ，宽度不变。Height 取值范围应大于0，小于原图宽度 |
| /crop/<Width>x<Height> | 指定目标图片宽度为 Width，高度为 Height 。Width 和 Height 取值范围都应大于0，小于原图宽度/高度 |
在进行缩放裁剪操作时，您也可以使用 gravity 参数指定操作的起点位置，详见下文中 缩放裁剪操作示例。
内切圆裁剪参数说明
操作名称：iradius。
| 参数 | 含义 |
|---|---|
| /iradius/<radius> | 内切圆裁剪功能，radius 是内切圆的半径，取值范围为大于0且小于原图最小边一半的整数。内切圆的圆心为图片的中心。图片格式为 gif 时，不支持该参数。 |
圆角裁剪参数说明
操作名称：rradius。
| 参数 | 含义 |
|---|---|
| /rradius/<radius> | 圆角裁剪功能，radius 为图片圆角边缘的半径，取值范围为大于0且小于原图最小边一半的整数。圆角与原图边缘相切。图片格式为 gif 时，不支持该参数。 |
人脸智能裁剪参数说明
操作名称：scrop。
| 参数 | 含义 |
|---|---|
| /scrop/<Width>x<Height> | 基于图片中的人脸位置进行缩放裁剪。目标图片的宽度为 Width、高度为 Height。 |
九宫格方位图
九宫格方位图可为图片的多种操作提供位置参考。红点为各区域位置的原点（通过 gravity 参数选定各区域后位移操作会以相应远点为参照）。
注意：
- 当 gravity 参数设置为 center 时，dx、dy 参数无效。
- 当 gravity 参数设置为 north 或 south 时，dx 参数无效（水印会水平居中）。
- 当 gravity 参数设置为 west 或 east 时，dy 参数无效（水印会垂直居中）。
示例
普通裁剪
相对于图片左上顶点水平向右平移100像素，垂直向下平移10像素，指定目标图片大小为600×600进行裁剪：
http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?imageMogr2/cut/600x600x100x10原图如下：
最终效果如下：
缩放裁剪
假设以中心点 center 为参考点，缩放裁剪至300×400，示例如下：
http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?imageMogr2/crop/300x400/gravity/center 最终效果如下：
内切圆裁剪
取半径为300，进行内切圆裁剪：
http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?imageMogr2/iradius/300最终效果如下：
圆角裁剪
取半径为100，进行圆角裁剪：
http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?imageMogr2/rradius/100 最终效果如下：
人脸智能裁剪
基于图片中的人脸位置进行缩放裁剪，目标图片大小为100×600，示例如下：
http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?imageMogr2/scrop/100x600说明：如果图片中没有识别到人脸，则返回原图。