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。

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

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

示例