crop_or_fill

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.