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