This module extends the Crop API to intelligently handle image cropping. When an image's orientation doesn't match the desired crop ratio, it either crops the image or places it on a background canvas of the correct ratio, filling the empty space with a configurable color to preserve the entire image.
Crop or Fill
Crop or Fill is an image effect that extends the Crop API module. It intelligently handles the mismatch between an image's orientation and the crop selection's orientation.
How it works
- Same orientation (e.g. portrait image + portrait ratio): crops the image using the Crop API.
- Opposite orientation (e.g. portrait image + landscape crop): instead of cropping, it creates a canvas matching the crop's aspect ratio, fills it with a configurable background color, and centers the original image on it. No pixels are lost.
- Square crop: treated as "same orientation" — always crops normally.
Use case
A site has a "Hero" image style with a landscape crop type (16:9). An editor uploads a portrait photo. With the standard crop effect, the image would be severely cropped, losing most of the content. With Crop or Fill, the portrait photo is placed on a landscape canvas with colored bars on the sides — similar to letterboxing — preserving the entire image.
Configuration
- Crop type: select which crop type to use (inherited from Crop API).
- Background color: hex color picker for the fill bars (default: white).
Requirements
- Crop API module
- ImageMagick module — optional, for ImageMagick toolkit support. Both GD and ImageMagick toolkits are supported.
Depends on
Dependencies of the latest stable release
Required by
Tracked projects that depend on this one
No tracked projects depend on this one yet.