If you set both width and height options, you can omit the func=crop option since it is the default operation for this case.
Gravity
Specifies which part of the image you wish to keep while cropping. If you omit the gravity option, centred cropping is performed.
gravity=X
Available gravity values
| northwest | north | northeast |
|---|---|---|
| west | centre | center (default) | east |
| southwest | south | southeast |
| auto (more information) | X,Y - focal point (more information) | face (more information) |
Cropped to 400x290px, keeping the left part
/docs/birds.jpg?w=400&h=290&gravity=west
To position the crop, use the gravity operation. Here, gravity=west means that Cloudimage will focus on the left part of the image when cropping.
To focus a crop on the most prominent object on the image, you can use automatic crop.
If you need full cropping control, please see positionable crop and focal point crop.
Face crop looks for faces in the image and focuses on the most prominent one.
You can crop without resizing the image by providing a target aspect ratio or a range of minimum and maximum of permitted aspect ratios.