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) |
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.
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