Transformations
As a superuser, you can use transformations to manage the configuration of preset renditions and have these presets applied to renditions dynamically. Transformations allow you to provide users with renditions, in different dimensions, without the need to regenerate the public link.
The Media processing best practices provide guidelines for deciding which renditions to set according to your business needs.
The Transformations page lets you manage your transformations. To access the Transformation page:
- On the menu bar, click Manage .
On the Manage page, click Transformations.
A table lists the available transformations.
Tip
You can sort the transformations by name or modification date using the sorting buttons above the table. You can also search for the transformation you want using the search tile at the top of the page.
Transformations work as follows:
- The system tries to apply a transformation on a file type and to convert it to the same file type (svg to svg, png to png, gif to gif).
- If the system cannot do such a conversion, it returns the original file.
Add a transformation
To add a transformation:
- On the menu bar, click Manage .
- On the Manage page, click Transformations.
- On the Transformations page, on the top right, click + Transformation.
On the Transformation dialog box, set the following settings.
Field Type Description Value Mandatory? Name String Name of the transformation. String value Yes Crop Drop-down list Type of crop. None, Smart crop, or Crop to center No Width (px) Numerical value The transformation is scaled to this width depending on the selected Crop option. Numerical value Mandatory for Smart crop and Crop to center. Height (px) Numerical value The transformation is scaled to this height depending on the selected Crop option. Numerical value Mandatory for Smart crop and Crop to center. Quality Drop-down list Quality of the transformation. None, Maximum quality, High quality, Medium quality, or Low quality No Click Save.
Note
Width (px) and Height (px) parameters are not required for Crop type None, even if asterisks are visible.
Crop options
The following table describes the available crop options.
Crop Option | Description |
---|---|
None | No crop |
Smart crop | Smart crop intelligently examines the content of an image and automatically focuses on the essential part of an image for cropping. This focus automatically searches the image for edges, skin tones, and areas of saturated color and attempts to position the crop box over the most significant feature. |
Crop to center | Crop to center provides a rendition that you can resize with the aspect ratio unlocked. This option positions the crop box to the center of the image. |
Dimensions
The dimensions of a transformation are defined by either the width or the height value that you input. The transformation image is scaled to this width or height depending on the selected crop option.
Note
Pay attention to the naming convention of the default transformations, as they might require editing if the height or width values are changed (e.g. w1200).
Edit a transformation
To edit a transformation:
- On the menu bar, click Manage .
- On the Manage page, click Transformations.
- Look for the transformation you want to edit in the table.
- On the transformation row, click Edit Transformation.
- Edit the parameters you want.
- Click Save.
Note
To delete a transformation, on the transformation row, click Delete .
Apply a transformation
To apply a transformation to an asset, you must append the transformation name to the URL of the public link as a query parameter named t. For example, to apply a transformation called NewTransformation to an asset, append the value &t=NewTransformation
to the public link URL:
Can we improve this article ? Provide feedback