图片裁剪
更新时间 2025-11-28 18:15:09
最近更新时间: 2025-11-28 18:15:09
本文介绍图片裁剪具体使用参数及示例。
客户可通过URL请求中携带图片裁剪参数，裁剪原图中指定位置的内容并生成新的图片。
注意
图片处理为付费服务，目前处于公测期间，暂不收取费用，收费时间另行通知。
居中裁剪：从图片居中部分裁剪指定宽和高的图片内容。宽的起点=(图片总宽-w)/2，高的起点=(图片总高-h)/2，找到该原点，然后裁剪宽×高大小的图片内容。
指定X、Y轴裁剪：按指定x、y、宽和高裁剪，以x和y为起点，裁剪宽×高大小的图片内容。
九宫格裁剪：设置原点位置，原点按九宫格分布，横向以w指示的宽度向右裁剪，纵向以h指示的高度向下裁剪，裁剪宽×高大小的图片内容。
参数说明及示例
参数名称：cut。
支持的参数值说明如下：
| 参数类型 | 参数 | 说明 | 取值范围 |
|---|---|---|---|
| 裁剪类型 | mid | 居中裁剪参数，需与参数w、h一起使用。 | 无。 |
| x | 指定X、Y轴裁剪参数，指定裁剪起点横坐标，需与参数y、w、h一起使用，必填。 | 不能超出原图宽度，如x超出原图宽，将会返回原图。 | |
| y | 指定X、Y轴裁剪参数，指定裁剪起点纵坐标，需与参数x、w、h一起使用，必填。 | 不能超出原图高度，如y超出原图高，将会返回原图。 | |
| g | 九宫格裁剪参数，设置裁剪的原点位置。原点按照九宫格的形式分布，一共有九个位置可以设置，为每个九宫格的左上角顶点。 需与参数w、h一起使用。 | NW：左上。 N：中上。 NE：右上。 W：左中。 M：中部。 E：右中。 SW：左下。 S：中下。 SE：右下。 超出上述值，裁剪不生效，将会返回原图。 | |
| 裁剪宽和高 | w | 指定从原点开始向右的裁剪宽度。与居中裁剪、指定X、Y轴裁剪、九宫格裁剪参数一起使用。 | 不能超出原图宽度，如w超出原图宽，将会按照对应的宽最大值处理。 |
| h | 指定从原点开始向下的裁剪高度。与居中裁剪、指定X、Y轴裁剪、九宫格裁剪参数一起使用。 | 不能超出原图高度，如h超出原图高，将会按照对应的高最大值处理。 |
操作方式说明及示例如下：
| 裁剪方式 | 说明 | 参数示例 |
|---|---|---|
| 居中裁剪 | 从图片居中部分裁剪指定宽和高的图片内容。宽的起点=(图片总宽-w)/2，高的起点=(图片总高-h)/2，找到该原点，然后裁剪宽×高大小的图片内容。 | http://test.ctyun.cn/a.png?action=cut:mid,w_400,h_200。 从图片居中部分裁剪指定宽和高的图片内容。宽的起点=(图片总宽-w)/2，高的起点=(图片总高-h)/2，找到该原点，然后向右向下裁剪400×200大小的图片内容。 |
| 指定X、Y轴裁剪 | 按指定x、y、宽和高裁剪，以x和y为起点，裁剪宽×高大小的图片内容。注意：x、y值必填，否则会返回原图。 | http://test.ctyun.cn/a.png?action=cut:x_10,y_10,w_400,h_200。 指定X、Y轴剪切：按x为10，y为10的位置为指定原点，向右向下裁剪400×200的图片内容。 |
| 九宫格裁剪 | 设置原点位置，原点按九宫格分布，横向以w指示的宽度向右裁剪，纵向以h指示的高度向下裁剪，裁剪宽×高大小的图片内容。 | http://test.ctyun.cn/a.png?action=cut:g_NW,w_400,h_200。 九宫格切：设置原点位置为九宫格左上位置，横向向右以w指示的400宽度裁切，纵向向下以h指示的高度200裁切，裁剪400×200大小的图片内容。 |
