剪切图片
普通剪切
此功能仅支持通过控制台代码编辑模式和接口调用模式使用。
可以设置图片上的任意一点为起始点,根据指定宽高进行图片剪切,剪切后的图片为矩形。具体说明如表1所示。
操作说明:crop
参数 |
取值说明 |
代码样例 |
---|---|---|
g |
表示剪切起始原点位置。取值为tl、top、tr、left、center、right、bl、bottom和br,共9个取值。取值的九宫格如图1所示,每个取值位置均位于每一小格的左上角顶点。 |
image/crop,x_10,y_10,w_200,h_200,g_br |
h |
剪切的高度,取值范围为[0,图片高度]。 |
|
w |
剪切的宽度,取值范围为[0,图片宽度]。 |
|
x |
表示剪切起始点的横坐标,默认左上角为原点。取值范围为[0,图片边界]。 |
|
y |
表示剪切起始点的纵坐标,默认左上角为原点。取值范围为[0,图片边界]。 |
剪切原点位置九宫格如图1所示。
- 如果从剪切原点开始设置的x和y坐标大于原图,则剪切无法正常执行,将返回错误。
- 如果从剪切原点开始设置的h和w均大于原图,则会直接剪切至图片边界。
内切圆
此功能仅支持通过控制台代码编辑模式和接口调用模式使用。
以图片的中心为圆心,根据指定的半径进行图片剪切,剪切后的图片为圆形。具体说明如表2所示。
操作名称:circle
- 如果图片的输出格式是jpg,则内切圆以外区域为白色。如果图片的输出格式是png、webp、bmp等矢量图格式,则内切圆以外区域为透明。建议输出为png格式。
- 如果r取值超过图片最短边的一半,则输出的内切圆仍然是图片的最大内切圆。
索引剪切
此功能仅支持通过控制台代码编辑模式和接口调用模式使用。
以图片左上角顶点为起始点,设宽为x轴,高为y轴。根据指定长度进行等长剪切,根据指定索引取出剪切后区域。具体说明如表3所示。
操作名称:indexcrop
圆角剪切
此功能仅支持通过控制台代码编辑模式和接口调用模式使用。
指定圆角大小将图片剪切为圆角矩形。支持通过圆角半径大小和水平垂直大小两种方式设置,具体说明如表4所示。
操作名称:rounded-corners
参数 |
取值说明 |
代码样例 |
---|---|---|
r |
将图片切出圆角,指定圆角的半径,水平和垂直的值相同,可以使用像素数(如200)或百分比(如25p)。 像素数取值范围为[1,4096],当像素数大于原图最小边的一半时,取最小边的二分之一。 百分比取值范围为[1p,50p]。 不能与rx和ry参数同时使用。 |
image/rounded-corners,r_100 |
rx |
圆角水平大小的参数,可以使用像素数(如200)或百分比(如25p)。 像素数取值范围为[1,4096],当像素数大于原图最小边的一半时,取最小边的二分之一。 百分比取值范围为[1p,50p]。 需要与ry同时使用。 |
image/rounded-corners,rx_100,ry_200 |
ry |
圆角垂直大小的参数,可以使用像素数(如200)或百分比(如25p)。 像素数取值范围为[1,4096],当像素数大于原图最小边的一半时,取最小边的二分之一。 百分比取值范围为[1p,50p]。 需要与rx同时使用。 |
如果图片的输出格式是jpg,则非圆角区域为白色。如果图片的输出格式是png、webp、bmp等矢量图格式,则非圆角区域为透明。建议在圆角剪切后保存为png格式。