ENABLING THE FEATURE
This feature enables users to manually add parameters to the Public sharing URL of image assets to transform the asset on the fly. This is an alternative to creating Transformation Presets via the Share / Embed feature.
To get started, enable the Manual Image Transformations For Public Images setting under Admin > Settings > Resources - Public Sharing.
All image assets that currently support preview generation can be used for transformation. Some restrictions on the type of transformations apply for certain file formats (in particular RAW).
The maximum file size limit supported is 50MB.
Any image that supports preview generation is supported (see full list here), however not for all parameters.
The public URL, which can be retrieved for each asset from the Share / Embed action, will look like this:
The parameters are inserted in replacement of the /original/ part.
You can combine multiple parameters with the character &.
SUPPORTED TRANSFORMATION PARAMETERS
- Extension (ext)
This parameter is to convert the source format to one of the following destination formats.
# Accepted Values: jpeg, jpg, bmp, gif, png, webp
Convert extension to PNG:
The desired extension can also be added to the name portion at the end of the URL.
The size parameter allows to change the original image to a different size. Note that any cropping has to be applied separately (see below).
Resize to 500 width:
Resize to 500 height:
Resize to 500 width x 500 height:
If &ignore is not entered, the closest match with the same aspect ratio as the original will be automatically applied.
Crop (crop & cropgravity)
Note: You are still required to enter the desired pre-crop dimensions if you want to resize the original image before cropping.
Crop 100x100 starting 10 pixels on the right and 10 pixels from the top of top left corner:
Crop 100x100 starting from the center right of the image:
Extent (extentbackground & extentgravity)
- Flip (flip)
Only applies for "jpg", "jpg2", "bpg", "djvu", "djv", "icer", "jbig2", "pgf", "jxr", "hdp", "wdp" formats.
# Accepted Values: 1 to 100 (original quality).
Change quality to 50%
Compression Type (compresstype)
Use pixel compression specified by type when writing the image.
# Accepted Values:
- Color Space (colorspace)
- Density (density)
Set the horizontal and vertical resolution of an image for rendering to devices.
# Accepted Values: 1+
Change resolution to 72dpi.
- svg and the majority of RAW formats only support the ext parameter.
- Quality only supports jpg, jpg2, bpg, djvu, djv, icer, jbig, pgf, jxr, hdp, wdp extensions.
- When a parameter is not supported, it will get skipped.
- When a parameter entered is incorrect, an error page will appear.
- The parameters are order sensitive and will be processed successively as inputted in the URL.
ABOUT TRANSFORMATIONS & PUBLIC SHARING
Image Transformations is an optional add-on which needs to be enabled on your platform as part of the Public Sharing feature set. The feature comes with a default monthly allowance, which covers 200GB of data transfer, 1000 transformations and 1000 invalidations per month. An additional 1000 transformations and 1000 invalidations per month with every additional 1TB of public data transfer allowance added to your account.
Please contact your Customer Success Manager or firstname.lastname@example.org to learn more. You can also submit a request directly from the Helpdesk Center.