These options allow you to do extra processing to the image, such as trimming whitespace, cropping and resampling. Table values in bold text are the default value for that setting.

 

Sample Profile

 

<?xml version="1.0" encoding="utf-8"?>

<Profile Type="0"

         DisplayName="TIFF 300dpi Serialized with Trim"

         Description ="Create TIFF serialized, trim whitespace">

  <Settings>

 

    <!-- Output file options -->

    <add Name="Devmode settings;Resolution" Value="300"/>

    <add Name ="Save;Output File Format" Value="TIFF Serialized"/>

    <add Name ="Save;Prompt" Value="0"/>

    <add Name ="Processing;Trim Threshold" Value="0"/>
    <add Name ="Processing;Trim left" Value="1"/>

    <add Name ="Processing;Trim top" Value="1"/>

    <add Name ="Processing;Trim bottom" Value="1"/>

    <add Name ="Processing;Trim right" Value="1"/>

    ...

    

  </Settings>

</Profile>

 

 

Code Sample - C#

 
PNDocConvQueueServiceLib.PNDocConvQueueItem item = null;
 
// Create the conversion item
item = new PNDocConvQueueServiceLib.PNDocConvQueueItem();
 
// Set conversion settings

item.Set("Devmode settings;Resolution", "300");

item.Set("Save;Output File Format""TIFF Serialized");

item.Set("Save;Prompt""0");

item.Set("Processing;Trim Threshold""0");

item.Set("Processing;Trim left""1");

item.Set("Processing;Trim top""1");

item.Set("Processing;Trim bottom""1");

item.Set("Processing;Trim right""1");
...
// convert the file
item.Convert("Microsoft Word",
             @"C:\Test\Report.docx",
             @"C:\Test\Out\ConvertedReport");

 

Code Sample - VB.NET

 

Dim item As PNDocConvQueueServiceLib.IPNDocConvQueueItem

 

 ' Create the conversion item

item = New PNDocConvQueueServiceLib.PNDocConvQueueItem()

 

' Set conversion settings

item.Set("Devmode settings;Resolution""300")

item.Set("Save;Output File Format""TIFF Serialized")

item.Set("Save;Prompt""0")

item.Set("Processing;Trim Threshold""0")

item.Set("Processing;Trim left""1")

item.Set("Processing;Trim top""1")

item.Set("Processing;Trim bottom""1")

item.Set("Processing;Trim right""1")

...

' convert the file

item.Convert("Microsoft Word", _

             "C:\Test\Report.docx", _

             "C:\Test\Out\ConvertedReport")

 

 

Conversion Settings - Processing

Name:

Processing;Units

 

Specifies what unit of measurement is used for settings such as custom paper width or hardware margin. Units can be entered in inches (8.50in) or centimeters (21.59cm), provided the unit designation of inches (in) or centimeters (cm) is given. Also accepted are units entered in as hundredths of an inch (.01 Inches) or tenths of a millimeter(.1 Millimeters)

 

Values:

.01 Inches

.1 Millimeters

 

Name:

Processing;Trim left

 

Trim all areas from the left side of the page, based on the Trim Threshold below.

 

Values:

0 - Do not trim left side of page

1 - Trim left side of page

 

Name:

Processing;Trim top

 

Trim all areas from the top edge of the page, based on the Trim Threshold below.

 

Values:

0 - Do not trim top of page

1 - Trim top of page

 

Name:

Processing;Trim right

 

Trim all areas from the right side of the page, based on the Trim Threshold below.

 

Values:

0 - Do not trim right side of page

1 - Trim right side of page

 

Name:

Processing;Trim bottom

 

Trim all areas from the bottom edge of the page, based on the Trim Threshold below.

 

Values:

0 - Do not trim bottom of page

1 - Trim bottom of page

 

Name:

Processing;Trim Threshold

 

All areas on the chosen sides of the image that fall at or below the chosen intensity level, or trim threshold. The intensity level is used to decide what pixels get thrown away. Colors are converted to a grayscale palette, and then compared to the chosen intensity level. Trimming on any side stops as soon as a pixel is encountered that is greater the chosen level. 0 is white, and 100 is black.

 

Values:

0-100

 

Name:

Processing;Crop

 

Enable or disable the cropping options.

 

Values:

0 - Disable cropping

1 - Enable cropping

 

Name:

Processing;Crop Option

 

Cropping can be specified in either of two ways: as page margins, or as a central area or region on the page.

 

Values:

0 - Crop region

1 - Crop margins

 

Name:

Processing;Crop left

 

Applies when Crop Option is set to crop region.

 

Values:

0 - 8000000 - Range in hundredths of an inch

0 - 20000000 - Range in tenths of a millimeter

0.000in - 80000.000in - Range in inches

0.000cm - 200000.000cm - Range in centimeters

 

Name:

Processing;Crop top

 

Applies when Crop Option is set to 0 for crop region.

 

Values:

Same as Processing;Crop left above

 

Name:

Processing;Crop width

 

Applies when Crop Option is set to 0 for crop region.

 

Values:

Same as Processing;Crop left above.

 

Name:

Processing;Crop height

 

Applies when Crop Option is set to 0 for crop region.

 

Values:

Same as Processing;Crop left above

 

Name:

Processing;Crop margin left

 

Applies when Crop Option is set to 1 for crop margins.

 

Values:

Same as Processing;Crop left above

 

Name:

Processing;Crop margin top

 

Applies when Crop Option is set to 1 for crop margins

 

Values:

Same as Processing;Crop left above

 

Name:

Processing;Crop margin right

 

Applies when Crop Option is set to 1 for crop margins

 

Values:

Same as Processing;Crop left above

 

Name:

Processing;Crop margin bottom

 

Applies when Crop Option is set to 1 for crop margins

 

Values:

Same as Processing;Crop left above

 

Name:

Processing;Copy

 

Enable or disable the copy options. The Copy feature allow you to copy each page of the document to a larger or smaller page.

 

Values:

0 - Disable copy options

1 - Enable copy options

 

Name:

Processing;Copy to width

 

The width of the new image

 

Values:

0 - 8000000 - Range in hundredths of an inch

0 - 20000000 - Range in tenths of a millimeter

0.000in - 80000.000in - Range in inches

0.000cm - 200000.000cm - Range in centimeters

 

Name:

Processing;Copy to height

 

The height of the new image.

 

Values:

Same as Processing;Copy to width above.

 

Name:

Processing;Copy to IAM Left

 

The desired left area margin settings for the new image.

 

Values:

Same as Processing;Copy to width above

 

Name:

Processing;Copy to IAM Top

 

The desired top area margin settings for the new image.

 

Values:

Same as Processing;Copy to width above

 

Name:

Processing;Copy to IAM Right

 

The desired right area margin settings for the new image.

 

Values:

Same as Processing;Copy to width above

 

Name:

Processing;Copy to IAM Bottom

 

The desired bottom area margin settings for the new image.

 

Values:

Same as Processing;Copy to width above

 

Name:

Processing;Copy H align

 

How to horizontally align the copied image area.

 

Values:

Left - Align the copied image to the left on the page

Middle - Align the copied image horizontally center on the page

Right - Align the copied image to the right of the page

 

Name:

Processing;Copy V align

 

How to vertically align the copied image area.

 

Values:

Top - Align the copied image to the top of the page

Middle - Align the copied image vertically centered on the page

Bottom - Align the copied image to the bottom of the page

 

Name:

Processing;Copy Page Scaling

 

How to place the original page in the new image.

 

Values:

0 - Fit to Page

1 - Actual Size

 

Name:

Processing;Copy Page Scaling Shrink Larger

 

Scales the image down to fit the new image size if the original image is larger.

 

Values:

0 - Do not shrink page to fit

1 - Shrink page to fit

 

Name:

Processing;Copy Page Scaling Lock Aspect Ratio

 

Use this option on to prevent distortion when scaling larger or smaller image to different image sizes.

 

Values:

0 - Do not maintain page aspect ratio when scaling

1 - Maintain page aspect ratio when scaling

 

Name:

Processing;Resample

 

Scale the output file to a particular width and height in pixels, as a percentage of the original size, or by setting a new image resolution (DPI).

 

Values:

0 - Disable resampling options

1 - Enable resampling options

 

Name:

Processing;Resample Units

 

Values:

0 - Pixels

1 - Percentage

2 - DPI

 

Name:

Processing;Resample Lock Aspect Ratio

 

Values:

0 - Do not maintain page aspect ratio when resampling

1 - Maintain page aspect ratio when resampling

 

Name:

Processing;Resample Pixels Width

 

Desired width in pixels.

 

Values:

0-4294967295 pixels, default width is 200.

 

Name:

Processing;Resample Pixels Height

 

Desired height in pixels.

 

Values:

0-4294967295 pixels, default height is 200.

 

Name:

Processing;Resample Width Percentage

 

Change the width as a percentage of the original size.

 

Values:

1 to 500, default is 100.

Name:

Processing;Resample Height Percentage

 

Change the height as a percentage of the original size.

 

Values:

1 to 500, default is 100

 

Name:

Processing;Resample X DPI

 

Change the X resolution of the image.

 

Values:

50-3600, default is 200

 

Name:

Processing;Resample Y DPI

 

Change the Y resolution of the image.

 

Values:

50-3600, default is 200

 

Name:

Processing;Brightness Adjust

 

Allows you to lighten or darken the images or text on your incoming pages.

 

Values:

--100 to -1 - darkens the image

0 - no change

1 to 100 - lightens the image

 

Name:

Processing;Rotate portrait

 

Rotates portrait orientated images the desired degrees counter-clockwise.

 

Values:

0, 90, 180, or 270

 

Name:

Processing;Rotate landscape

 

Rotates landscape orientated images the desired degrees counter-clockwise.

 

Values:

0, 90, 180, or 270