You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /
  • 对象存储

自定义裁剪

最近更新时间：2023.04.11 14:40:24

首次发布时间：2022.11.18 17:58:41

我的收藏

自定义裁剪功能（crop），指定原图上的任意一点作为起始坐标，根据指定的宽高裁剪出矩形区域。本文介绍自定义裁剪相关的参数说明及使用示例。

参数说明

参数参数说明取值说明是否必须

g

裁剪的起始坐标原点。

  • nw（默认值）：左上

  • north：中上

  • ne：右上

  • west：左中

  • center：中部

  • east：右中

  • sw：左下

  • south：中下

  • se：右下

否

w

裁剪宽度。

[0,图片宽度]
默认为最大值。

否

h

裁剪高度。

[0,图片高度]
默认为最大值。

否

x裁剪起始点横坐标偏移（相对于指定的坐标原点）。横坐标向右偏移为正，向左偏移为负。否
y裁剪起始点纵坐标偏移（相对于指定的坐标原点）。纵坐标向下偏移为正，向上偏移为负。否

各裁剪起始坐标原点的计算方法如下，其中 srcW 代表原图宽度，srcH 代表原图高度。

裁剪原点位置计算方法
nw0, 0
northsrcW/2 - w/2, 0
nesrcW - w, 0
west0, srcH/2 - h/2
centersrcW/2 - w/2, srcH/2 - h/2
eastsrcW - w, srcH/2 - h/2
sw0, srcH - h
southsrcW/2 - w/2, srcH - h
sesrcW - w, srcH - h

注意事项

  • 如果最终计算的坐标原点超出了原图范围，将会返回 BadRequest 错误，错误信息为 Advance cut's position is out of image。

  • 如果从坐标原点开始指定的宽度和高度超过了原图范围，将会直接裁剪到原图边界为止。

  • 如果输入多帧图片，会变成单帧图片。

示例