Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

    documents, formatted in the best way to be embedded into a web portal

  • Generate image

    ouptut

    output 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.

  Image RemovedDepending on the File Type you choose, you’ll see different options.

Settings for .jpg

...

Options

Description

Name

Here you can specified Scaling (None)

Specify the name of the Profile.

File type

Specified the file type that must be exported.

.jpg in this case

Scaling

Image Added

Scaling: None

By choosing this option the image will not be scaled and converted at full size.

Scaling: Exact (

Exact

*)

The image will be scaled to fit inside (

adjust

scaled proportionally centered) the exact dimensions specified for this options

NxN

px. The space left unfilled with the image

must

will be filled

in

with the specified Padding Color

Specified

. The result will be an image with the exact dimensions specified in the setting

NxN

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

NxN px

. No

padding

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

in 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

(*)

Image Added

The image canvas that was left blank by the image scaling will be filled with the specified color

or be transparent.Resample (dpi)

.

Note

Only available when Scaling is set to Exact.

Width & Height

The size in Pixels of the output image.

For fit inside / outside, these are the dimensions where the image will fit into.

Note

Not available when Scaling > None is selected

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.

Image Added

Color

space

profile (

source)If nothing is selected, the source color space will be detected. Otherwise you can specify the original colorspace of the image

destination)

The image will be converted to the selected color profile.

Simulate Overprinting

Image Added

Overprint is a concept in printing (click to view in WikiPedia).

When selected, elements that would overprint will show simulated in the image.

Processing URL

Will redirect to the specified URL while processing the image.

Error URL

Will redirect to the specified URL if an error occurred.

Note

Since version 2022 the Transparent option for Padding Color has been removed for JPEG output. Existing Image Conversion Profiles that use transparent padding for JPEG output will use white as padding color instead. If you want transparent padding you have to use PNG output, where you can set the Background Color to Transparent.

Note

Since version 2022 the 1-100 numeric Jpeg Quality setting has been replaced by 5 new options to define the image quality of the JPEG output: “Minimum”, “Low”, “Medium”, “High” and “Maximum”. Existing Image Conversion Profiles will be mapped automatically to one of the new options.

Settings for .png

...

Options

Description

Name

Specify the name of the Profile

File type

.png in this case

Scaling

Image Added

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 will be filled with the specified Padding Color. 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 in px. No padding will be added and the final size of the image will be a proportional scaling of the original.

Background Color

Image Added

This color is used both for padding (when Scaling is set to Exact) and as background color for the transparent parts of the PNG image (for all Scaling settings). You can either set it to Transparent or to a specific RGB color, in case you want to replace the transparency by a color.

Width & Height

The size in Pixels of the output image.

For fit inside / outside, these are the dimensions where the image will fit into.

Note

Not available when Scaling > None is selected

Output resolution

The image will be resampled to the specified ppi.

Color profile (destination)

The image will be converted to the selected ICC color profile.

Simulate Overprinting

Image Added

Overprint is a concept in printing (click to view in WikiPedia).

When selected, elements that would overprint will show simulated in the image.

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.

Image Removed

...

titleDisclaimer

...

Note

Since version 2022 it is possible to generate transparent PNG images. Before version 2022, if the Padding Color was set to Transparent, it was only the padding that was transparent, the PNG images were generated with a white background. Since version 2022, those PNG images will have a transparent background instead. If you still want to have a white background, you have to set the Background Color to white instead of transparent.

Overprint simulation

New since version 2022

You can generate images that simulate the effects of overprint in a PDF document, by enabling the Simulate Overprinting setting in the Image Conversion Profiles. Overprint can be applied to text or to a frame border or fill, but PDF assets can also contain overprint. With this feature enabled you can have a more reliable validation workflow, since the generated image will show you how the PDF document with overprint will look like when it is printed.

Example 1: The "WATER" text is set to overprint to compensate for misregistration on a press. If you look closely at the bottom image, you can see that the black text is darker when printed on top of the water.

...

Without overprint simulation

...

With overprint simulation

Example 2: The "spicy" text is set to overprint to create an effect of the background items showing through the text, as you can see on the bottom image.

...

Without overprint simulation

...

With overprint simulation