Image resizing
Resizing operations allow you to apply various transformations and deliver your images with the desired size. Below is a list of all operations. For more details, click on the respective operation.
Available operations
| operation | syntax | description |
|---|---|---|
| width | width=X | sets the image width to X pixels |
| height | height=X | sets the image height to X pixels |
| prevent enlargement | org_if_sml=1 | prevents resizing if the target size is larger than the origin image |
| crop | func=crop | sets crop resize mode |
| gravity=X | defines the part of the image to be retained when cropping X = [north | south][east | west] | auto | X,Y | |
| positionable crop | tl_px=X,Y | sets coordinates of the top left corner of the cropping rectangle |
| br_px=X,Y | sets coordinates of the bottom right corner of the cropping rectangle | |
| face crop | func=face | crops the image automatically focusing on the most prominent face |
| fit | func=fit | sets fit resize mode |
| cropfit | func=cropfit | sets crop or fit resize mode depending on the origin and the desired dimensions |
| bound | func=bound | sets bound resize mode |
| cover | func=cover | sets cover resize mode (distorts image proportions) |
| flip | flip=[h][v] | mirrors the image horizontally and/or vertically |
| rotate | r=X | rotates the image to X degrees (counterclockwise) |
| trim | trim=X | trims a solid-colour border (if present), X is the aggressiveness of the operation |
Do not hesitate to contact us if you need any additional operations not listed above.
Crop
Keeps image proportions cutting the image to fit the defined width and height.
/docs/hotel.jpg?width=400&height=200&func=crop
For more details, see the crop section.
Fit
Resizes the image keeping proportions adding padding to satisfy the desired dimensions.
/docs/hotel.jpg?w=400&h=200&func=fit
You can see all padding options in the fit section.
The cropfit operation performs either crop or fit based on image content and transformation parameters.
Bound
Tries to resize the image while keeping proportions. Similar to fit but without padding.
/docs/hotel.jpg?w=400&h=200&func=bound
For more details, see the bound section.
Cover
Resizes the image to the given width and height ignoring original image proportions.
/docs/hotel.jpg?w=400&h=200&func=cover
For more details, see the cover section.
For troubleshooting purposes, you can add the ci_info=1 operation to view details about resizing and compression, example: /docs/hotel.jpg?w=400&ci_info=1