本文介绍自定义裁剪图片时所用到的参数及示例。

注意事项

在使用自定义裁剪功能时,请注意以下事项:

  • 如果指定的起始横纵坐标大于原图,将会返回BadRequest错误,错误信息为:Advance cut’s position is out of image。
  • 如果从起点开始指定的宽度和高度超过了原图,将会直接裁剪到原图边界为止。

参数说明

操作名称:crop

参数说明如下:

参数 描述 取值范围
w 指定裁剪宽度。 [0~图片宽度]
h 指定裁剪高度。 [0~图片高度]
x 指定裁剪起点横坐标(默认左上角为原点)。 [0~图片边界]
y 指定裁剪起点纵坐标(默认左上角为原点)。 [0~图片边界]
g 设置裁剪的原点位置。原点按照九宫格的形式分布,一共有九个位置可以设置,为每个九宫格的左上角顶点。 nw、north、ne、west、center、east、sw、south、se

裁剪原点位置参数示意图如下。

示例

  • 裁剪图片,从起点(100,50)开始,范围至图的边界。

    处理后的URL为:<原图URL>?x-oss-process=image/crop,x_100,y_50

  • 裁剪图片,从起点(100,50)开始,裁剪范围为100 × 100。

    处理后的URL为:<原图URL>?x-oss-process=image/crop,x_100,y_50,w_100,h_100

  • 裁剪图右下角200 × 200的范围。

    处理后的URL为:<原图URL>?x-oss-process=image/crop,x_0,y_0,w_200,h_200,g_se

  • 裁剪图右下角200 × 200的范围,起点为相对右下九宫格的左上顶点再位移(10,10)。

    处理后的URL为:<原图URL>?x-oss-process=image/crop,x_10,y_10,w_200,h_200,g_se