com.day.cq.dam.api.renditions

Interface RenditionMaker

public interface RenditionMaker

Service interface for creating standard thumbnail, web and other renditions for DAM assets.

Since:

6.0

Method Summary

Methods

Modifier and Type	Method and Description
RenditionTemplate	createThumbnailTemplate(Asset asset, int width, int height, boolean center) Defines a template for a standard DAM PNG thumbnail rendition.
RenditionTemplate	createWebRenditionTemplate(Asset asset, int width, int height, int quality, String mimeType, String[] mimeTypesToKeep) Defines a template for a standard DAM web enabled rendition.
List<Rendition>	generateRenditions(Asset asset, RenditionTemplate... templates) Generates or updates multiple renditions for the given asset based on the given templates.

Method Detail

createThumbnailTemplate

RenditionTemplate createThumbnailTemplate(Asset asset,
                                        int width,
                                        int height,
                                        boolean center)

Defines a template for a standard DAM PNG thumbnail rendition.

The aspect ratio of the assets base image will be preserved. Depending on orientation, either width or height of the target size will be smaller.

If center=true, the rendition image will have the exact given target size and the resized image, which still keeps the original aspect ratio, will be centered with possible transparent whitespace around it to fill up to the target size.

Parameters:

asset - asset that is the base for the thumbnail (could be different from the asset on which the template will be applied)

width - target width of the thumbnail

height - target height of the thumbnail

center - true if the thumbnail should have the exact target size and the resized image would be centered with transparent whitespace around it

Returns:

a rendition template

createWebRenditionTemplate

RenditionTemplate createWebRenditionTemplate(Asset asset,
                                           int width,
                                           int height,
                                           int quality,
                                           String mimeType,
                                           String[] mimeTypesToKeep)

Defines a template for a standard DAM web enabled rendition.

The aspect ratio of the assets base image will be preserved. Depending on orientation, either width or height of the target size will be smaller.

Parameters:

asset - asset that is the base for the web rendition (could be different from the asset on which the template will be applied)

width - target width of the web rendition

height - target height of the web rendition

quality - for jpegs, the jpeg quality from 0 to 100; for gifs, the number of colors in the palette from 0 to 256

mimeType - mime type of the new web rendition unless asset mime type is in 'mimeTypesToKeep'

mimeTypesToKeep - list of asset mime types that will be used for the rendition as well, in which case the parameter 'mimeType' will be ignored

Returns:

a rendition template

generateRenditions

List<Rendition> generateRenditions(Asset asset,
                                 RenditionTemplate... templates)

Generates or updates multiple renditions for the given asset based on the given templates. All successfully generated renditions will be returned. In case one generation failed, it will not be part of the returned list.

Parameters:

asset - asset for which to create or update renditions

templates - a vararg list of rendition templates

Returns:

a list with all renditions that were successfully created or updated