简介

imageMogr2 提供一系列高级图片处理功能，本文介绍 图片裁剪，可与 imageMogr2 的其他参数一起使用，详细的计费说明请参见 计费与定价。

限制说明

• 原图格式支持： psd、jpeg、png、gif、webp、tiff、bmp、avif、heic
• 同步处理
  • 原图支持 20MB 以内的图片
  • 处理前动图帧数限制：webp动图 最大帧数为50，gif 最大帧数为 200
  • 处理前体积限制：图片 w 和h不能超过3万像素，总像素不能超过1.5亿像素
  • 处理后体积限制：图片w和h 不能超过9999像素，总像素不得超过2500w 像素。以下情况特别说明：
    • 输出为 avif 时，图片 w和h 不能超过9999像素，总像素不能超过768w像素
    • 输出为 webp静图 时，图片 w 和 h 不能超过16383像素，总像素不得超过2500w 像素
    • 仅限 输入为webp动图格式，输出webp动图/gif动图时，图片 w 和 h 不能超过999像素，总像素（宽x高x帧数）不能超过3150万像素
• 持久化处理
  • 原图支持 512MB 以内的图片
  • 处理前动图帧数限制：gif、webp动图，最大帧数为 500
  • 处理前体积限制：图片 w和h 不能超过3万像素，总像素不能超过1.5亿像素
  • 处理后体积限制：图片 w和h 不能超过14999像素，总像素不得超过6000w像素。以下情况特别说明：
    • 输出为 heic和 avif 时，图片 w和h 不能超过9999像素，总像素不能超过3072w像素
    • 输出为 webp动图和静图 时，图片 w 和 h 不能超过16383像素，总像素不得超过6000w像素

参数说明

注意：接口规格不含任何空格与换行符。

• thumbnail 和 crop 之间的操作可以管道处理，即可以先对图进行缩略再裁剪，或者先裁剪再缩略。

imageMogr2/crop
          /gravity

裁剪操作参数表 (cropsize)

裁剪偏移参数表 (cropoffset)

示例

• /crop/!300x400a10a10 表示从源图坐标为 x:10,y:10 处截取 300x400 的子图片。
• /crop/!300x400-10a10 表示从源图坐标为 x:0,y:10 处截取 290x400 的子图片。

重心参数表

在图片高级处理现有的功能中只影响其后的 裁剪操作参数表，即裁剪操作以 gravity 为原点开始偏移后，进行裁剪操作。

• gravity 会使其后的裁剪偏移 cropoffset 受到影响，建议放在 /crop 参数之前。
• 计算偏移值会受到位置偏移指示符 /gravity/ 的影响。默认为相对于左上角 NorthWest 计算偏移值，参考 重心参数表。

NorthWest     |     North      |     NorthEast
              |                |    
              |                |    
--------------+----------------+--------------
              |                |    
West          |     Center     |          East 
              |                |    
--------------+----------------+--------------
              |                |    
              |                |    
SouthWest     |     South      |     SouthEast

转义说明

部分参数以 ! 开头，表示参数将被转义。为便于阅读，我们采用特殊转义方法，如下所示：

p => % (percent)
r => ^ (reverse)
a => + (add)

即!50x50r 实际代表 50x50^ 这样一个字符串。而!50x50实际代表 50x50 这样一个字符串（该字符串并不需要转义）。 中的 OffsetGeometry 部分可以省略，默认为 +0+0。即 /crop/50x50 等价于 /crop/!50x50a0a0，执行 -crop 50x50+0+0 语义。

示例

0. 原图

1. 生成 300x427 裁剪图

https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/crop/300x

2. 生成 640x200 裁剪图

https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/crop/x200

3. 生成 300x300 裁剪图

https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/crop/300x300

4. 生成 300x300 裁剪图，偏移距离 30x100

https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/crop/!300x300a30a100

5. 生成 300x200 裁剪图，偏移距离 30x0

https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/crop/!300x300a30-100

6. 生成 270x300 裁剪图，偏移距离 0x100

https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/crop/!300x300-30a100

7. 生成 270x200 裁剪图，偏移距离 0x0

https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/crop/!300x300-30-100

8. 锚点在左上角 (NorthWest)，生成 300x300 裁剪图

https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/gravity/NorthWest/crop/300x300

9. 锚点在正上方 (North)，生成 300x300 裁剪图

https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/gravity/North/crop/300x300

10. 锚点在右上角 (NorthEast)，生成 300x300 裁剪图

https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/gravity/NorthEast/crop/300x300

11. 锚点在正左方 (West)，生成 300x300 裁剪图

https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/gravity/West/crop/300x300

12. 锚点在正中 (Center)，生成 300x300 裁剪图

https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/gravity/Center/crop/300x300

13. 锚点在正右方 (East)，生成 300x300 裁剪图

https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/gravity/East/crop/300x300

14. 锚点在左下角 (SouthWest)，生成 300x300 裁剪图

https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/gravity/SouthWest/crop/300x300

15. 锚点在正下方 (South)，生成 300x300 裁剪图

https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/gravity/South/crop/300x300

16. 锚点在右下角 (SouthEast)，生成 300x300 裁剪图

https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/gravity/SouthEast/crop/300x300

操作方式

您可以通过 同步处理、持久化处理、图片样式设置、CDN中间源处理 等方式，对图片进行处理，详情介绍请参见图片处理操作方式。