With Image Conversion Profiles you can specify a profile by which images are to be transformed. They can be used to do some (limited) optimization of PDF output (but mostly for low res files), but the main purpose is to provide image output for documents and assets, used for:
Allowing developers to get various thumbnail / medium / high res previews of assets and/or document, formatted in the best way to be embedded into a web portal
Generate image ouptut of CHILI documents (as a separate output format, or for embedding in other output formats such as the mobile reader in design mode)
See Extracting Preview Images for an overview on how to call Image Conversion Profiles using the API.
Depending on the File Type you choose, you’ll see different options.
Settings for .jpg
Options | Description |
|---|---|
Name | Specify the name of the Profile. |
File type | .jpg in this case |
Scaling |  |
Scaling: None | By choosing this option the image will not be scaled and converted at full size. |
Scaling: Exact | The image will be scaled to fit inside (scaled proportionally centered) the exact dimensions specified for this options … px. The space left unfilled with the image must be filled in with the Background Color Specified. The result will be an image with the exact dimensions specified in the setting Width x Height px. |
Scaling: Fit Inside | By choosing this, the width and height of the image is reduced proportionally so that the image fits inside the given size. No background will be added and the final size of the image will be a proportional scaling of the original. |
Scaling: Fit Outside | By choosing this, the width and height of the image is reduced proportionally so that the image fits outside the given size NxN px. No padding will be added and the final size of the image will be a proportional scaling of the original. |
Width & Height | The size in Pixels of the output image |
Background Color | The image canvas that was left blank by the image scaling will be filled with the specified color. |
Output resolution | The image will be resampled to the specified ppi. |
Jpeg quality | The image will be adjusted to the quality specified in this option.  |
Color space (source) | If nothing is selected, the source color space will be detected. Otherwise you can specify the original colorspace of the image. |
Color profile (destination) | The image will be converted to the selected color profile. |
Processing URL | Will redirect to the specified URL while processing the image. |
Error URL | Will redirect to the specified URL if an error occurred. |
Settings for .png
Options | Description |
|---|---|
Name | Here you can specified the name of the Profile. |
File type | Specified the file type that must be exported. |
Scaling (None) | By choosing this option the image will not be scaled and converted at full size. |
Scaling (Exact) | The image will be scaled to fit inside (adjust proportionally centered) the exact dimensions specified for this options NxN px. The space left unfilled with the image must be filled in with the Padding Color Specified. The result will be an image with the exact dimensions specified in the setting NxN px. |
Scaling (Fit Inside) | By choosing this, the width and height of the image is reduced proportionally so that the image fits inside the given size NxN px. No padding will be added and the final size of the image will be a proportional scaling of the original. |
Scaling (Fit Outside) | By choosing this, the width and height of the image is reduced proportionally so that the image fits outside the given size NxN px. No padding will be added and the final size of the image will be a proportional scaling of the original. |
Scaling (Padding Color) - PNG only | The image canvas that was left blank by the image scaling will be filled with the specified color or be transparent. |
Resample (dpi) | The image will be resampled to the specified ppi. |
Jpeg quality | The image will be adjusted to the quality specified in this option. |
Color space (source) | If nothing is selected, the source color space will be detected. Otherwise you can specify the original colorspace of the image. |
Color profile (destination) | The image will be converted to the selected ICC color profile. |
Processing URL | Will redirect to the specified URL while processing the image. |
Error URL | Will redirect to the specified URL if an error occurred. |
Transparent PNG output
It is now (Since version 2021.2) possible to generate transparent PNG images! In the Image Conversion Profiles settings you can set the "Background Color" for PNG output to "Transparent" or to a specific RGB color, in case you want to replace the transparency by a color.
The "Padding Color" setting has been renamed to "Background Color" for PNG output, because it is used both for padding (if "Scaling" is set to "Exact") and as background color for the transparent parts of the PNG image (for all "Scaling" options).
The "Transparent" option for "Padding Color" has been removed (Since version 2021.2) for JPEG output. Existing Image Conversion Profiles that use transparent padding for JPEG output will use white as padding color instead. If you still prefer transparent padding, please use PNG output, where you can set the "Background Color" to "Transparent".
PDF Export settings
In the PDF export settings you can define an image conversion profile in the dropdown.
