全部文档
当前文档
最近更新时间：2026-03-31 13:47:33
可以设置图片上的任意一点为起始点，根据指定宽高进行图片裁剪，裁剪后的图片为矩形。
操作说明：crop
具体参数说明如下表所示。
参数 | 取值说明 | 代码样例 |
g | 表示裁剪起始原点位置。 取值：
关于各裁剪原点位置的计算方法，请参见计算方法表格。 | image/crop,x_10,y_10,w_200,h_200,g_br |
h | 裁剪的高度，取值范围为[0，图片高度]。 | |
w | 裁剪的宽度，取值范围为[0，图片宽度]。 | |
x | 表示裁剪起始点的横坐标，默认左上角为原点。取值范围为[0，图片边界]。 | |
y | 表示裁剪起始点的纵坐标，默认左上角为原点。取值范围为[0，图片边界]。 |
各裁剪原点位置的计算方法如下，其中srcW代表原图宽度，srcH代表原图高度。
裁剪原点 | 位置计算方法 |
tl | 0, 0 |
top | srcW/2 - w/2, 0 |
tr | srcW - w, 0 |
left | 0, srcH/2 - h/2 |
center | srcW/2 - w/2, srcH/2 - h/2 |
right | srcW - w, srcH/2 - h/2 |
bl | 0, srcH - h |
bottom | srcW/2 - w/2, srcH - h |
br | srcW - w, srcH - h |
说明：
如果从裁剪原点开始设置的x和y坐标大于原图，则裁剪无法正常执行，将返回错误。
如果从裁剪原点开始设置的h和w均大于原图，则会直接裁剪至图片边界。
裁剪起点坐标设置为(1000，500)，裁剪的宽和高均设置为1000。
裁剪起点设置在九宫格右下角br区，起点坐标为(10，10)，裁剪的宽和高均设置为200。
纯净模式
