功能概述
内容识别服务基于腾讯云数据万象,通过 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,小于原图宽度 |
内切圆裁剪参数说明
操作名称: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
说明:
如果图片中没有识别到人脸,则返回原图。