Available since version 1.2.0
This feature is not AEM as a Cloud Service compatible; starting with the release 4.6.2 this feature is disabled on this platform (including the SDK).
This process ensures that an rendition exactly matches a set of dimensions by applying a matte. This is sometimes referred to as letterboxing (when the matte is applied on the top and bottom of the image) or windowboxing (when the matte is applied on the left and right of the Both the horizontal and the vertical position along with the dimensions can be configured via parameters.
How to Use
Update the DAM Update Asset workflow (
/etc/workflow/models/dam/update_asset) and add a custom process step at any point after the rendition you want to matte has been generated.
- Open the DAM Update Asset workflow
- At the end insert a new Process step, Workflow/Process Step
- Edit the Process Step
- Title: Matte Rendition
- On the Process tab, select “Matte Rendition” from the Process drop down
- Check the Handler Advance option
- Five arguments are required
bgcolor: The background color (in hex notation) you want to apply to the rendition
dimension: dimensions of the image size
vpos: starting vertical position, the options are “top”, “bottom”, and “middle”
hpos: horizontal start position , the options are “left”, “right”, “center”
renditionName: The name of the rendition to modify like “cq5dam.web.1280.1280”
- Click OK and then “Save” the workflow.
A full configuration example might have all the following:
This will ensure that the rendition “cq5dam.web.1280.1280” is 1280x1280 pixels, adding black (#000000) pixels to the bottom right where necessary.