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.
| Preview | Syntax |
|---|---|
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.
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
