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.
| 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. |
In the PDF export settings you can define an image conversion profile in the dropdown.
Disclaimer
For the image conversion CHILI Publisher relies on functionality of Ghostscript. Issues with the functionalities of Ghostscript are beyond our responsibility.
It is highly recommended to verify your configuration before using it in a production environment.