Conversion settings are used to describe the output created by Document Conversion Service and consist of a collection of name-value pairs. These settings can also be used to control the behavior of the individual converters, such as configuring Word to pass a password or telling Excel to ignore the print areas when printing worksheets.
When using the command line utilities the settings are passed by supplying the name of a profile file, a structured XML file that contains the list of settings. Below is a sample command line using a profile file named TIFF 300dpi Optimized Color.xml, followed by a listing of the XML file itself. Note that the .xml extension is not needed when using the command line utilities. Several sample profiles are included for your use, or to use as a base to customize to your needs.
Passing setting using a profile |
|
DCSConvertFile /P="TIFF 300dpi OptimizedColor" /NE "C:\Test\File.pdf" |
Sample Profile |
|
<?xml version="1.0" encoding="utf-8"?> <Profile Type="0" DisplayName="TIFF 300dpi OptimizedColor" Description ="Creates a single TIFF image at 300dpi."> <Settings>
<!-- Output file options --> <add Name="Devmode settings;Resolution" Value="300"/> <add Name="Save;Output File Format" Value="TIFF Multipaged"/> <add Name="Save;Color reduction" Value="Optimal"/> <add Name="Save;Dithering method" Value="Halftone"/>
<!-- TIFF Compression Options --> <add Name="TIFF File Format;BW compression" Value="Group4"/> <add Name="TIFF File Format;Color compression" Value="LZW RGB"/> <add Name="TIFF File Format;Indexed compression" Value="LZW"/> <add Name="TIFF File Format;Greyscale compression" Value="LZW"/> <add Name="JPEG File Format;Color compression" Value="Medium Quality"/> <add Name="JPEG File Format;Greyscale compression" Value="High Quality"/> <add Name="Image Options;Fax" Value="0"/>
</Settings> </Profile> |
The table below lists the different conversion settings separated out into categories with a description of the settings available in each. Click the link for that category to view all available settings for that option.
Options |
Description of Settings |
---|---|
These are general options that can be applied to the conversion process itself or to all converters. |
|
Endorsements are header and footer information that can be stamped onto each page of the output created by Document Conversion Service. |
|
These options are specific to the behavior of the Word converter. |
|
These options are specific to the behavior of the Excel converter. |
|
These options are specific to the behavior of the PowerPoint converter. |
|
These options are specific to the behavior of the Ghostscript converter. |
|
These options are specific to the behavior of the Image converter. |
|
These options are specific to the behavior of the OutsideIn converter. |
|
Advanced settings such as custom paper size and text extraction. |
|
Settings to configure the file naming profiles (preset file naming schemes) for multipaged, multipaged with JobID, serialized and serialized with JobID. |
|
Resolution (DPI), page size and color mode settings. |
|
Image output options such as creating fax mode images and page rotation settings. |
|
Compression settings for color and greyscale JPEG images. |
|
PDF file format settings for compression, content encoding and PDF/A-1b compliant PDF files. |
|
PDF encryption and file permissions. |
|
Settings to adjust the image during conversion such as trimming, cropping, copying to a new page size, resampling and brightness adjustment. |
|
Settings for output file format, color reduction, dithering and file name prompting. |
|
Compression settings for black and white, color, indexed and greyscale TIFF images. |
|
Settings to create a text watermark diagonally across the page. |