White paper: Templates in web-to-print.  Free download

Converters.config

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:

XML
<configuration>
    <configSections>
        <section name="Aurigma.DesignAtoms.Converters"
        type="Aurigma.DesignAtoms.Configuration.ConvertersConfig.ConvertersConfigSection, Aurigma.DesignAtoms" />
    </configSections>
    <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>
</configuration>
Important

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

Manual