Package 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 Detail

      • generateRenditions

        java.util.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

      • 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,
                                             java.lang.String mimeType,
                                             java.lang.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

      • createThumbnailTemplate

        RenditionTemplate createThumbnailTemplate​(Rendition rendition,
                                          int width,
                                          int height,
                                          boolean center)
        Defines a template for a standard DAM PNG thumbnail rendition from a given 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:
        rendition - rendition that is the base for the thumbnail. It could be any rendition of the asset.
        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
        Since:
        6.1

      • createWebRenditionTemplate

        RenditionTemplate createWebRenditionTemplate​(Rendition rendition,
                                             int width,
                                             int height,
                                             int quality,
                                             java.lang.String mimeType,
                                             java.lang.String[] mimeTypesToKeep)
        Defines a template for a standard DAM web enabled rendition from a given 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:
        rendition - rendition that is the base for the web rendition. It could be any rendition of the asset.
        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
        Since:
        6.1