开通图片处理后,客户可通过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大小的图片内容。 |