Conversion Settings
Contents
Conversion settings are used to describe the output created by PEERNET.ConvertUtility and consist of a collection of name-value pairs. These settings can also be used to control the behavior of the individual converters used by Document Conversion Service, such as configuring Word to pass a password or telling Excel to ignore the print areas when printing worksheets.
When using the PEERNET.ConvertUtility .NET library methods from your own managed code you have the choice of supplying the name of a profile file, an XML file that contains the list of settings, or by passing in an IDictionary<String,String> collection of name-value pairs directly. Several sample profiles are included for your use, or to use as a base to customize to your needs.
|
Code Sample - Calling ConvertFile with a Profile |
using PEERNET.ConvertUtility;
// conversion results returned, use to find files created or errors PNConversionItem resultItem = PNConverter.ConvertFile(@"C:\Input\Memo.doc", @"C:\Output\", "ConvertedMemo", true, // overwrite existing false, // remove file extension false, // create log file "TIFF 300dpi OptimizedColor", // profile String.Empty, String.Empty, null, // no extra settings String.Empty, //remote computer String.Empty); |
|
|
Code Sample - Calling ConvertFile with a settings collection |
using PEERNET.ConvertUtility;
IDictionary<String, String> settings = new Dictionary<String, String>();
settings.Add("Devmode settings;Resolution", "300"); settings.Add("Save;Output File Format", "TIFF Multipaged"); settings.Add("Save;Color reduction", "Optimal"); settings.Add("Save;Dithering method", "Halftone");
// conversion results returned, use to find files created or errors PNConversionItem resultItem = PNConverter.ConvertFile(@"C:\Input\Memo.doc", @"C:\Output\", "ConvertedMemo", true, // overwrite existing false, // remove file extension false, // create log file settings, String.Empty, String.Empty, null, // no extra settings String.Empty, //remote computer String.Empty); |
|
Name-Value Tables for Conversion Settings
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. |