Crop by aspect ratio or aspect ratio range
Sets target aspect ratio or aspect ratio range when cropping. Aspect ratios can be set as decimal values (1.778) or ratios (16:9).
aspect_ratio=AR | ar=AR
aspect_ratio=AR1,AR2 | ar=AR1,AR2
If you provide only one dimension parameter (width or height) and aspect_ratio, the other dimension will be calcualted. If you include both width and height in the URL, aspect_ratio is ignored.
If you provide only aspect_ratio and no dimensions (width or height), the image will be cropped without resizing.
You can spcify a range of aspect ratio, for example aspect_ratio=4:3,16:9. Images which fall within this range, will not be cropped. Useful to avoid very wide ot very tall images by cropping them to the closest aspect ratio.
Preview | Syntax |
---|---|
Original aspect ratio (3:2 or 1.5): /docs/car1.jpg?w=400
Cropped to 1.8: /docs/car1.jpg?w=400&aspect_ratio=1.8
Original aspect ratio (1.323): /docs/frog.png
Cropped to 3:2 (1.5): /docs/frog.png?aspect_ratio=3:2
Original aspect ratio 1.5: /docs/car1.jpg?w=400
Aspect ratio range 1.5..2 (no crop needed): /docs/car1.jpg?w=400&aspect_ratio=1.5,2.0
Original aspect ratio 2.25:1 (2.25): /docs/kids.jpg?w=400
Aspect ratio range 3:2..2:1 (1.5..2): /docs/kids.jpg?w=400&aspect_ratio=3:2,2:1