Image converter settings

Prev Next

Basic Information


Location: Site Configuration > {Module name} > Media File Converters > Create Media File Converter

In the 'Basic Information' tab information about INPUT and OUTPUT format is configured together with the source and destination locations. 

'Destination' is setup in Media File Holders:

/v1/docs/media-file-holders

0d0b575308.jpg

Note: SVG file format will be available from version 11.0.0 onwards

Limitations:

  • For input format WEBP only the follow output formats are supported: JPG, PNG and vice versa.

  • For input format SVG only the follow output formats are supported: .JPG, PNG and TIF.

    • Currently no convertion to SVG format is supported.

Application Settings


The 'Apllication Settings' tab allows detailed configuration of the output file. 

mceclip0.png

Option

Default

Meaning

Max Size

None

Maximum size of the image. Width and Height are given in pixels.

Keep Aspect

Enabled

When enabled, this ensures that the relative dimensions of the image are not altered and therefore not vertically or horizontally stretched or compressed.

Metadata

Disabled

When enabled, metadata from the original image is transferred over to the output image.

Note: PNG Doesn't support embedding EXIF metadata. Hence EXIF metadata will get lost when output format is PNG.

Canvas

Same as Converted File

Allow to add the canvas area (colored or transparent) around the image, for example, in order to have the same dimensions of the resulted images.

Canvas Size

None

The user can enter numeric values into the two input fields, specifying the desired size of the output file.

“Canvas Size” Values can be both bigger and smaller than the values set in the “Max Size”-field. If Canvas Size is smaller than Max Size, the result image will be cropped from the center.

Canvas Extension Color

Transparent

“Canvas Extension Color” consists of two radio buttons: The first option is “Transparent” which will make the extended areas transparent if the output file format supports transparency (Please note that transparency is not supported for all output file types, so if transparency is selected for a file type that does not support transparency (JPG), the canvas color will be white).

The second option is “Color”, where the user can enter a hex value or click the “Color”-button which will display a color picker.

Path Handling

Apply Clipping Path

Defines which path to apply on conversion: Clipping Path (Default), First Path or Ignore All Paths.

Setting is available only for input format JPG, TIFF, PSD, EPS, WEBP

Transparent Background

Disabled

Defines whether the transparent background (checkerboard) will be applied to converted image. If disabled, the background will be white. If enabled together with colored canvas, background will have the canvas color.

Setting is available only for output format PNG, TIFF, PSD, GIF, WEBP, SVG

Resolution

As Original

Resolution of the resulting image (specified in dpi). This setting is applicable to all resolution-based image formats that the image converter supports.

Resample Image

Disabled

Select the check box to change image resolution without affecting the dimensions of the file.

Changing the dpi value with the Resampling option enabled will change image size in pixels but not the size in millimeters.

Multi page PDFs (convert only first page)

Disabled

When the PDF format is selected as an input format, select the check box to generate preview only for the 1st page of the uploaded PDF document.

Do not create previews for files

None

When enabled, it is possible to specify the size of the file in MB for which preview will not be generated.

Limitations

  • Canvas is not applied to vector input formats AI, EPS.

  • Metadata from/to JXL files won’t be copied.

  • Exiftool doesn’t support writing metadata to WEBP files (only metadata copied by imageMagic will be present when output format is WEBP).

  • Exiftool doesn’t support embedding IPTC, Photoshop metadata to HEIC, HEIF, GIF, JP2 file formats.

Color Options

Option

Default

Meaning

Color Space

Convert to ICC profile

Specify whether to use the selected icc profile, or leave image’s icc profile unchanged during conversion.

ICC profile

default_rgb.icc (default)

Select the icc profile that will be used during image conversion.

Rendering Intent

Perceptual

Select one of the following options:

  • Perceptual

  • Saturation

  • Relative Colorimetric

  • Absolute Colorimetric

Black Point Compensation

Enabled

Enable or disable the Black Point Compensation

Limitations

  • Transparent background is not applied:

    • to PSD and PDF with premultiplied and layer mask transparency (without clipping paths);

    • to Photoshop PDF with clipping path;

    • to Photoshop EPS with clipping path and RGB colorspace. 

  • “Ignore All Paths” setting is not applied to EPS and PDF files (clipping is always done if path is present in the file).

  • ICC Profile convertion to CMYK as target format for PNG and WEBP not supported: 

    • PNG and WEBP formats are designed for transferring images on the Internet, not for professional-quality print graphics, and therefore do not support non-RGB color spaces such as CMYK. 

Watermarks


A watermark is a “stamp” or logos embedded to the preview files.

This functionality only works for image converters and can be activated on the “Watermark”-tab in the “Edit Media Converter”-window. User can enable the Watermark feature and upload the desired Watermark file (PNG-file is recommended). Watermark file is not scaled automatically, so it is necessary to prepare the file of the size which corresponds the size of preview produced by image converter. 

mceclip1.png

Option

Meaning

Generate Watermark

This checkbox activates the functionality

Watermark file

Watermark image file should be uploaded to this field

Opacity

Defines the watermark’s transparency (0% is completely transparent, 100% is opaque).

Tile

Watermark image can be tiled all over the preview area

Position

If “Tile”-option is disabled, the position of the watermark could be defined by this option.

Remember, adding Watermarks to preview is only applicable to image files (converters). Watermarks cannot be configured and applied to Video, swf and Copy File converters.

The watermark is only applied to the output file of the converter, not the original.

Convertible image files


Below follows the list of image file extensions that can be converted in our system. The first list represents the list of image file input formats that are supported in our system, the second lists image output formats to which the files can be converted.

List of image input formats supported in our system:

.jpg

.tif

.gif

.psd

.png

.bmp

.pdf

.eps

.ps

.ai

.arw

.cr2

.nef

.dcr

.crw

.dng

.mrw

.orf

.pef

.raf

.x3f

.3fr

.fff

.webp

.svg

.heic

.heif

.eip

.jp2

.jxl

List of image output formats supported in our system:

.jpg

.gif

.png

.pdf

.ps

.tif

.psd

.bmp

.eps

.webp

.heic

.heif

.jp2

.jxl

 

Note: naming of converted from PDF to image files will have dynamic format, depending on amount of pages in input file

Example 1:

Input file - "test.pdf". Amount of pages is 1 or only first page will be converted 

Output file - "test.jpeg"

Example 2:

Input file - "test.pdf". Amount of pages < 10

Output files - "test-1.jpeg", "test-2.jpeg",... "test-9.jpeg"

Example 3

Input file - "test.pdf". Amount of pages >=10 and < 100

Output files - "test-01.jpeg", "test-02.jpeg",... "test-99.jpeg"

Example 4:

Input file - "test.pdf". Amount of pages >=100 and < 1000

Output files - "test-001.jpeg", "test-002.jpeg",... "test-999.jpeg"