This is an old documentation. Go to the latest Customer's Canvas docs


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:

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

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

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.

See Also