CDN加速

图片裁剪

2024-05-31 07:30:36

开通图片处理后，客户可通过URL请求中携带图片裁剪参数，裁剪原图中指定位置的内容并生成新的图片。

注意

图片处理为付费服务，目前处于公测期间，暂不收取费用，收费时间另行通知。

居中裁剪：从图片居中部分裁剪指定宽和高的图片内容。宽的起点=(图片总宽 - w)/2，高的起点=(图片总高-h)/2，找到该原点，然后裁剪宽×高大小的图片内容。
指定X、Y轴裁剪：按指定x、y、宽和高裁剪，以x和y为起点，裁剪宽×高大小的图片内容。
九宫格裁剪：设置原点位置，原点按九宫格分布，横向以w指示的宽度向右裁剪，纵向以h指示的高度向下裁剪，裁剪宽×高大小的图片内容。

参数说明及示例

参数名称：cut。

支持的参数值说明如下：

参数类型	参数	说明	取值范围
裁剪类型	mid	居中裁剪参数，需与参数w、h一起使用。	无。
	x	指定X、Y轴裁剪参数，指定裁剪起点横坐标，需与参数y、w、h一起使用，必填。	不能超出原图宽度，如x超出原图宽，将会返回原图。
	y	指定X、Y轴裁剪参数，指定裁剪起点纵坐标，需与参数x、w、h一起使用，必填。	不能超出原图高度，如y超出原图高，将会返回原图。
	g	九宫格裁剪参数，设置裁剪的原点位置。原点按照九宫格的形式分布，一共有九个位置可以设置，为每个九宫格的左上角顶点。需与参数w、h一起使用。	NW：左上。 N：中上。 NE：右上。 W：左中。 M：中部。 E：右中。 SW：左下。 S：中下。 SE：右下。超出上述值，裁剪不生效，将会返回原图。
裁剪宽和高	w	指定从原点开始向右的裁剪宽度。与居中裁剪、指定X、Y轴裁剪、九宫格裁剪参数一起使用。	不能超出原图宽度，如w超出原图宽，将会按照对应的宽最大值处理。
裁剪宽和高	h	指定从原点开始向下的裁剪高度。与居中裁剪、指定X、Y轴裁剪、九宫格裁剪参数一起使用。	不能超出原图高度，如h超出原图高，将会按照对应的高最大值处理。

操作方式说明及示例如下：

裁剪类型	说明	参数示例
居中裁剪	参数为mid、w、h，从图片居中部分裁剪指定宽和高的图片内容。宽的起点=(图片总宽 - w)/2，高的起点=(图片总高-h)/2，找到该原点，然后裁剪宽（w）×高（h）大小的图片内容。	http://test.ctyun.cn/a.png?action=cut:mid,w_400,h_200。从图片居中部分裁剪指定宽和高的图片内容。宽的起点=(图片总宽 - w)/2，高的起点=(图片总高-h)/2，找到该原点，然后向右向下裁剪400×200大小的图片内容。
指定X、Y轴裁剪	参数为x、y、w、h，按指定x、y、宽（w）和高（h）裁剪，以x和y为起点，裁剪宽（w）×高（h）大小的图片内容。注意：x、y值必填，否则会返回原图。	http://test.ctyun.cn/a.png?action=cut:x_10,y_10,w_400,h_200。指定X、Y轴剪切：按x为10，y为10的位置为指定原点，向右向下裁剪400×200的图片内容。
九宫格裁剪	参数为g、w、h，设置原点位置，原点按九宫格分布，横向以w指示的宽度向右裁剪，纵向以h指示的高度向下裁剪，裁剪宽×高大小的图片内容。	http://test.ctyun.cn/a.png?action=cut:g_NW,w_400,h_200。九宫格切：设置原点位置为九宫格左上位置，横向向右以w指示的400宽度裁切，纵向向下以h指示的高度200裁切，裁剪400×200大小的图片内容。