Customizing Cumulus : Crop Templates : Overview: Crop Templates
   
Overview: Crop Templates
Crop templates are a means to determine the generation of renditions of images that will be delivered via the Media Delivery Cloud and the Media Delivery on Premise.
Additionally, crop templates are used with the Pixel Image Crop Template Processor to convert assets (see Cropping Image Assets with Templates).
In a crop template, you can define
the size and the aspect ratio of the area that shall be cropped in an image,
the size and aspect ratio of the resulting cutout, and
where Region of Interest defined on an image shall be placed within the resulting rendition.
NOTE: A Region of Interest can be defined on the preview of a file in the Cumulus Web Client.
To set up Crop Templates, select  Cumulus /  Edit > Preferences and click Crop Templates­.
Header (1 - 7)
1 Displays the selected Crop Template.
2 Opens a list of available Crop Templates. Shared Crop Templates are displayed in italics.
3 Opens the Properties dialog for the selected template – providing two tabs. On the Description tab you may enter or modify language-specific display names and descriptions. The Sharing tab allows you to define whether you want to share the template with others. Additionally you may restrict the usage to specific users or roles.
4 Opens a dialog to create a new Crop Template by copying the selected one.
5 Opens a dialog to rename the selected Crop Template.
NOTE: When renaming a shared templates, remember to update user permissions for this template, as needed.
6 Deletes the selected Crop Template.
7 Sets the selected Crop Template as default.
Crop Area (8 - 12)
8 Focus area – If activated, the “Region of Interest” specified for an image asset is taken into account by the cropping process and included in the resulting image. – For assets without a specified Region of Interest, the whole image is considered as Region of interest.
9 Position region of interest in result – If activated, you can define the approximate position of the Region of Interest within the resulting cutout from the original image (top, bottom, right, left, center, etc.). If not activated, the region of interest is always centered.
 
The following options apply to manual cropping only!
10 Enforce aspect ratio – If activated, the cropped area always has the specified aspect ratio. Size and position within the image must be specified manually.
You can freely define the aspect ratio.
11 Enforce crop size – If activated, the cropped area always has the Width and Height defined here. The actual position of the cropped area within the image must be specified manually.
12 User defined – Aspect ratio, size and position of the area to be cropped must be specified manually.
Crop Editor Option(13)
(Only relevant for manual cropping - not available if Focus area is selected!)
13 This template can have multiple parameter sets – If activated, you can define multiple parameter sets for this template, using the crop editor of the Cumulus Web Client. Each parameter set is identified by the template ID and an additional number.
14 Group – Crop templates can be ordered in groups. Selecting a Group from the drop-down list of available groups, or creating a new group, immediately assigns the current crop template to this group.
A crop templates can be assigned to one group only. Removing the last, or only, member from a group also deletes the group itself – you can’t have empty groups.
15 This template is master in it’s group – This option is activated by default for new templates. Deactivate it to make the current template a non-master.
A group can have any number of master and non-master templates. Non-master templates are restricted in that they can only be used with a specific asset, if a master template of the same group has already been applied to that asset before.
Output Size of Cropped Area (14-16)
16 Same as cropped area – If activated, the size of the resulting cutout (in pixel) is identical with the size of the cropped area.
17 Set manually – If activated, the size of the resulting cutout (in pixel) must be defined manually. If the cropped area is larger in size, it will be scaled down.
18 Enforce output size – If activated, the resulting cutout will always have the Width and Height defined here.
Additionally, you may activate the Keep the aspect ratio option. The resulting image will have the same aspect ratio as the cropped area. In this case, the defined values for Width and Height will be adapted accordingly. – Only available if either the Enforce aspect ratio or the Enforce crop size option is selected