|
Beginning with version 9.0 of PDF Image Printer and Raster Image Printer this method has been superseded by SetSaveOptions and SetPDFCompressionOptions. This method will still work when called but it its recommended that all new code use the updated methods |
Description
Sets the PDF file format options including color reduction, dithering methods and image and content compression methods used to store the image in the output file. The actual compression method used on each page will depend on the color reduction method chosen, if any.
To set only a single compression option use the SetProperty call with the appropriate arguments. See the Remarks below for a list of arguments.
Syntax
expression.SetPDFFileFormatOptions(UseCompression, UseASCIICompression
ColorReduction, Dithering, ContentEncoding
Color, Indexed, Greyscale, BW)
where expression is a IPNSession object.
Parameters
Boolean UseCompression
Set True to create a compressed PDF file, False to create an uncompressed document. Uncompressed PDF files can be very large.
Boolean UseASCIICompression
Set True to store the PDF document in ASCII format.
pnColorReduction ColorReduction
A pnColorReduction constant for any color reduction options to apply to the output file. There are four color reduction options available for reducing the number of colors in true color images. In general, the fewer the colors in an image, the smaller the file size.
pnDitheringMethod Dithering
A pnDitheringMethod constant to determine the method used when reducing color images to black and white. Dithering is used to enhance the appearance of color images that have been reduced to black and white.
pnPDFContentEncodingMethod ContentEncoding
A pnPDFContentEncodingMethod constant for the compression method to use to compress any text and line art in the PDF document.
pnColorCompressionMethod Color
A pnColorCompressionMethod constant for the compression method to use for color images.
pnIndexedCompressionMethod Indexed
A pnIndexedCompressionMethod constant for the compression method to use for indexed images. An indexed image is an image that has 256 colors or less.
pnGreyscaleCompressionMethod Greyscale
A pnGreyscaleCompressionMethod constant for the compression method to use for greyscale images.
pnBWCompressionMethod BW
A pnBWCompressionMethod constant for the compression method to use for black and white images.
Remarks
Use the following to set these options using SetProperty:
Method Parameter |
SetProperty Parameters |
||||||
|---|---|---|---|---|---|---|---|
UseCompression |
|
||||||
UseASCIICompression |
|
||||||
ColorReduction |
|
||||||
Dithering |
|
||||||
ContentEncoding |
|
||||||
Color |
|
||||||
Indexed |
|
||||||
Greyscale |
|
||||||
BW |
|
Supported Printers: PDF Image Printer, %SUPDRV_RASTER%>
See Also: SetSaveOptions SetPDFCompressionOptions SetPDFPassword SetPDFSecurity ClearPDFCompressionOptions ClearPDFFileFormatOptions ClearPDFPassword ClearPDFSecurity SetProperty pnColorReduction pnDitheringMethod pnPDFContentEncodingMethod pnColorColorCompressionMethod pnIndexedCompressionMethod pnGreyscaleCompressionMethod pnBWCompressionMethod
