TIFF Image Printer

Description

Sets the Copy To options on the IPNSession object. The concept of image copying is similar to enlarging or shrinking a page using a photocopier, with the added ability to position the page on the new image using the scaling and alignment options. You can enter units with up to three digits of accuracy, or to an eighth of an inch (0.125in or 0.318cm).

These settings are only applied when the Copy To options is enabled. The combined Left and Right image area margins must be less than the Width of the new page. The combined Top and Bottom image area margins must be less than the Height of the new page.

To set a single Copy To option use the SetProperty call with the appropriate arguments. See the Remarks below for a list of arguments.

For a more detailed explanation of the copy to feature, see the Page Resizing options in the conversion profile settings.

Syntax

expression.SetImageCopyToOn(Units, CopyToWidth, CopyToHeight,

                            CopyToImageMarginLeft, CopyToImageMarginTop,

                            CopyToImageMarginRight, CopyToImageMarginBottom,

                            ImageCopyScaling, ImageCopyHAlign, ImageCopyVAlign,

                            ImageCopyShrinkIfLarger, ImageCopyMaintainAspect)

where expression is an IPNSession object.

Parameters

pnUnits Units

A pnUnits constant for the unit of measure used to enter any Copy To image size options.

Double CopyToWidth

The width of the new image in units to match Units.

Double CopyToHeight

The height of the new image in units to match Units.

Double CopyToImageMarginLeft

The left margin in units to match Units.

Double CopyToImageMarginTop

The top margin in units to match Units.

Double CopyToImageMarginRight

The right margin in units to match Units.

Double CopyToImageMarginBottom

The bottom matgin in units to match Units.

pnImageCopyScaling ImageCopyScaling

A pnImageCopyScaling constant to determine how the page is scaled to fit the new image size.

pnImageCopyScalingHAlign ImageCopyHAlign

A pnImageCopyScalingHAlign constant for how to horizontally align the page in the new image.

pnImageCopyScalingVAlign ImageCopyVAlign

A pnImageCopyScalingVAlign constant for how to vertically align the page in the new image.

Boolean ImageCopyShrinkIfLarger

Enter True to shrink the page to fit inside the new image size if the original page size is larger.

Boolean ImageCopyMaintainAspect

Enter True to prevent distortion when scaling larger or smaller image to different image sizes.

Remarks

Use the following to set this option using SetProperty:

Supported Printers: TIFF Image Printer, PDF Image Printer, Raster Image Printer

See Also: SetImageCopyOn SetResamplingOn SetResamplingOptions SetProperty pnUnits pnImageCopyScaling pnImageCopyScalingHAlign pnImageCopyScalingVAlign