Converters.config

• 1 minute to read

The ~/Configuration/Converters.config file allows you to configure external graphics converters.

For graphics formats that do not have built-in support in Customer's Canvas, you can set up external command-line image conversion tools (converters) in the Aurigma.DesignAtoms.Converters section and in the separate ~/Configuration/Converters.config file. Customer's Canvas runs such converters when the Asset Manager opens images or you open PSD files with embedded images in the specified format at the first time. As a result, converters generate PDF files.

For example, you may want to use your vector graphics in the EPS format. In this case, you can set up the Ghostscript or PStill tools for obtaining vector PDF files as follows:

<Aurigma.DesignAtoms.Converters>
    <Converters>
        <Converter name="epsgs"
                    format="eps"
                    executable="C:\Program Files\gs\gs9.22\bin\gswin64c.exe"
                    args="-dPSFitPage -dSAFER -dBATCH -dNOPAUSE -sDEVICE=pdfwrite -dFitPage -r300 -sOutputFile=%OUTPUT% %INPUT%"
                    timeout="30" />
    </Converters>
</Aurigma.DesignAtoms.Converters>

Important

The command line arguments must contain variables for the input and output file names, %INPUT% and %OUTPUT%.

Let's look at these parameters in more detail.

Parameter	Description
name	The unique converter name.
format	The file format that requires the conversion. To allow your users to upload a new image format, add this format to the allowedExtensions list.
executable	The path to the executable file of the converter.
args	Command line arguments. Customer's Canvas uses the %INPUT% variable for the input file path and file name of the original image. %OUTPUT% contains the file path and file name of the converted image.
timeout	The time limit for the conversion. The default value is 30 seconds.