自定义裁剪--对象存储-火山引擎

文档中心

导航

自定义裁剪

最近更新时间：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 代表原图高度。

裁剪原点	位置计算方法
nw	0, 0
north	srcW/2 - w/2, 0
ne	srcW - w, 0
west	0, srcH/2 - h/2
center	srcW/2 - w/2, srcH/2 - h/2
east	srcW - w, srcH/2 - h/2
sw	0, srcH - h
south	srcW/2 - w/2, srcH - h
se	srcW - w, srcH - h

注意事项

如果最终计算的坐标原点超出了原图范围，将会返回 BadRequest 错误，错误信息为 Advance cut's position is out of image。
如果从坐标原点开始指定的宽度和高度超过了原图范围，将会直接裁剪到原图边界为止。
如果输入多帧图片，会变成单帧图片。

示例

裁剪坐标原点使用默认值，宽、高均设置为 400，不设置 x、y 偏移量。
https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/crop,w_400,h_400
裁剪坐标原点使用默认值，宽、高均设置为 400，设置 x 偏移量 50，设置 y 偏移量 50。
https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/crop,w_400,h_400,x_50,y_50