最后更新时间:2020-06-11 16:37:49

    功能描述

    COS 通过数据万象接口 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

    如果图片中没有识别到人脸,则返回原图。

    Was this page helpful?

    本页内容是否解决了您的问题?

    • 完全没帮助
    • 文档较差
    • 文档一般
    • 文档不错
    • 文档很好
    反馈
    帮助