更新时间:2024-10-23 GMT+08:00

剪切图片

普通剪切

此功能仅支持通过控制台代码编辑模式和接口调用模式使用。

可以设置图片上的任意一点为起始点,根据指定宽高进行图片剪切,剪切后的图片为矩形。具体说明如表1所示。

操作说明:crop

表1 普通剪切

参数

取值说明

代码样例

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所示。

图1 剪切原点位置九宫格
  • 如果从剪切原点开始设置的x和y坐标大于原图,则剪切无法正常执行,将返回错误。
  • 如果从剪切原点开始设置的h和w均大于原图,则会直接剪切至图片边界。

内切圆

此功能仅支持通过控制台代码编辑模式和接口调用模式使用。

以图片的中心为圆心,根据指定的半径进行图片剪切,剪切后的图片为圆形。具体说明如表2所示。

操作名称:circle

表2 内切圆说明

参数

取值说明

代码样例

r

图片剪切的圆形半径,取值范围为[0,图片最短边的一半]。

image/circle,r_100

  • 如果图片的输出格式是jpg,则内切圆以外区域为白色。如果图片的输出格式是png、webp、bmp等矢量图格式,则内切圆以外区域为透明。建议输出为png格式。
  • 如果r取值超过图片最短边的一半,则输出的内切圆仍然是图片的最大内切圆。

索引剪切

此功能仅支持通过控制台代码编辑模式和接口调用模式使用。

以图片左上角顶点为起始点,设宽为x轴,高为y轴。根据指定长度进行等长剪切,根据指定索引取出剪切后区域。具体说明如表3所示。

操作名称:indexcrop

表3 索引剪切说明

参数

取值范围

代码样例

x

水平剪切的每块图片长度。取值范围为[1,图片宽度]。x和y参数只能任选其一。

image/indexcrop,x_1000,i_0

y

垂直剪切的每块图片长度。取值范围为[1,图片高度]。

x和y参数只能任选其一。

i

如果剪切后一共有n块,则i的取值范围为[0,n-1]。0表示第一块,超过最大的块数则返回原图。

圆角剪切

此功能仅支持通过控制台代码编辑模式和接口调用模式使用。

指定圆角大小将图片剪切为圆角矩形。支持通过圆角半径大小和水平垂直大小两种方式设置,具体说明如表4所示。

操作名称:rounded-corners

表4 圆角剪切参数

参数

取值说明

代码样例

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格式。