Alibaba Cloud Content Delivery Network (CDN) allows you to crop images based on a specified size. This topic describes how to crop images and provides examples of how to crop images.
Note
- This feature is in private preview. To participate in the private preview, submit a ticket.
- This feature is free of charge during the private preview. After it is officially released, it charges fees. For more information, see the product updates.
Parameters
Set the action to crop
.
The following table describes the parameters.
Note If any of the following parameters is set to a negative value, the image remains uncropped.
Parameter | Description | Valid value |
---|---|---|
w | The width of the cropped area. | The default value is 0. Both the width and height can be at most 4,096 pixels. |
h | The height of the cropped area. | |
x | The X coordinate of the cropped area. The default value is the X coordinate of the upper-left corner of the image. | |
y | The Y coordinate of the cropped area. The default value is the Y coordinate of the upper-left corner of the image. | |
g | The position of the area to be cropped in a 3 by 3 grid. The image is located in a 3 by 3 grid, which has 9 tiles. Each tile is positioned by its upper-left corner. |
|
The following figure shows the position of each tile in a 3 by 3 grid.

Features and examples
The following table describes the features for cropping images and provides examples of cropping images.
Feature | Description | Example |
---|---|---|
Cropping in a circle shape | You can specify the radius of a circle to crop an image. The radius can be at most half the length of the shorter side of the base image. | image_process=circle,200 |
Cropping in a 3 by 3 grid | An image can be represented by a 3 by 3 grid. You can specify the position of the tile in the grid that you want to crop. | image_process=crop,w_200,h_200,g_se |
Cropping based on an X and Y coordinate | You can specify the X coordinate, y coordinate, width, and height to crop an image. The X and Y coordinate represents the lower-left corner of the cropped area. The width and height specify the size of the cropped area. | image_process=crop,x_10,y_10,w_400,h_200 |
Centered cropping | You can specify the width and height to crop equally on all four sides at a time. | image_process=crop,mid,w_400,h_200 |