# 剪切图片 #### 普通剪切 此功能仅支持通过[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)代码编辑模式和接口调用模式使用。 关于图片样式的使用，请参见[步骤三：创建图片样式](https://support.huaweicloud.com/usermanual-obs/obs_01_0211.html#ZH-CN_TOPIC_0000001981807973__zh-cn_topic_0000001942807756_section1115734213383)和[处理图片](https://support.huaweicloud.com/usermanual-obs/obs_01_0224.html#ZH-CN_TOPIC_0000001950528530__zh-cn_topic_0000001942967080_section169561325535)。 可以设置图片上的任意一点为起始点，根据指定宽高进行图片剪切，剪切后的图片为矩形。具体说明如[表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，图片高度\]。 | image/crop,x_10,y_10,w_200,h_200,g_br | | w | 剪切的宽度，取值范围为\[0，图片宽度\]。 | image/crop,x_10,y_10,w_200,h_200,g_br | | x | 表示剪切起始点的横坐标，默认左上角为原点。取值范围为\[0，图片边界\]。 | image/crop,x_10,y_10,w_200,h_200,g_br | | y | 表示剪切起始点的纵坐标，默认左上角为原点。取值范围为\[0，图片边界\]。 | image/crop,x_10,y_10,w_200,h_200,g_br | 剪切原点位置九宫格如[图1]所示。 图1剪切原点位置九宫格 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000001971717393.png "点击放大") ![](https://support.huaweicloud.com/usermanual-obs/public_sys-resources/note_3.0-zh-cn.png) - 如果从剪切原点开始设置的x和y坐标大于原图，则剪切无法正常执行，将返回错误。 - 如果从剪切原点开始设置的h和w均大于原图，则会直接剪切至图片边界。 #### 普通剪切示例 - 剪切起点坐标设置为(1000，500)，剪切的宽和高均设置为1000。 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000001942808016.jpg "点击放大") - 剪切起点设置在九宫格右下角br区，起点坐标为(10，10)，剪切的宽和高均设置为200。 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000001970006509.jpg) #### 内切圆 此功能仅支持通过[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)代码编辑模式和接口调用模式使用。 以图片的中心为圆心，根据指定的半径进行图片剪切，剪切后的图片为圆形。具体说明如[表2]所示。 操作名称：circle 表2内切圆说明 | 参数 | 取值说明 | 代码样例 | |:---|:---|:---| | r | 图片剪切的圆形半径，取值范围为\[0，图片最短边的一半\]。 | image/circle,r_100 | ![](https://support.huaweicloud.com/usermanual-obs/public_sys-resources/note_3.0-zh-cn.png) - 如果图片的输出格式是jpg，则内切圆以外区域为白色。如果图片的输出格式是png、webp、bmp等矢量图格式，则内切圆以外区域为透明。建议输出为png格式。 - 如果r取值超过图片最短边的一半，则输出的内切圆仍然是图片的最大内切圆。 #### 内切圆示例 设置图片剪切的圆形半径为100，输出格式为jpg，内切圆以外区域为白色。 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000001944758250.jpg) #### 索引剪切 此功能仅支持通过[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)代码编辑模式和接口调用模式使用。 以图片左上角顶点为起始点，设宽为x轴，高为y轴。根据指定长度进行等长剪切，根据指定索引取出剪切后区域。具体说明如[表3]所示。 操作名称：indexcrop 表3索引剪切说明 | 参数 | 取值范围 | 代码样例 | |:---|:---|:---| | x | 水平剪切的每块图片长度。取值范围为\[1，图片宽度\]。x和y参数只能任选其一。 | image/indexcrop,x_1000,i_0 | | y | 垂直剪切的每块图片长度。取值范围为\[1，图片高度\]。 x和y参数只能任选其一。 | image/indexcrop,x_1000,i_0 | | i | 如果剪切后一共有n块，则i的取值范围为\[0，n-1\]。0表示第一块，超过最大的块数则返回原图。 | image/indexcrop,x_1000,i_0 | #### 索引剪切示例 - 按照水平切割，每块图片的长度为1000，选择第一块。 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000001971837129.jpg "点击放大") - 按照水平切割，每块图片的长度为600，选择第一块。 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000001944598978.jpg "点击放大") #### 圆角剪切 此功能仅支持通过[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)代码编辑模式和接口调用模式使用。 指定圆角大小将图片剪切为圆角矩形。支持通过圆角半径大小和水平垂直大小两种方式设置，具体说明如[表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同时使用。 | image/rounded-corners,rx_100,ry_200 | ![](https://support.huaweicloud.com/usermanual-obs/public_sys-resources/note_3.0-zh-cn.png) 如果图片的输出格式是jpg，则非圆角区域为白色。如果图片的输出格式是png、webp、bmp等矢量图格式，则非圆角区域为透明。建议在圆角剪切后保存为png格式。 #### 圆角剪切示例 - 将example.jpg图片设置为圆角大小为100、格式为png的圆角图片。 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000001971717397.png "点击放大") - 将example.jpg图片设置为水平圆角大小为100、垂直圆角大小为200的圆角图片。 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000001944758254.jpg "点击放大")