DTWAIN_SetPDFASCIICompression

The following function is available only with DTWAIN / PDF.

The DTWAIN_SetPDFASCIICompression sets the compression method used within the PDF file to ASCII85.

DTWAIN_BOOL DTWAIN_SetPDFASCIICompression (

Parameters

Source

An open TWAIN Source.

bSet

Enables or disables ASCII85 compression in the PDF file.

Return Values

The return value is TRUE if successful.  Otherwise FALSE is returned.

Comments

The DTWAIN_SetPDFASCIICompression function sets the internal compression used in the PDF file to ASCII85.  The ASCII85 compression allows the PDF file to use a portable ASCII representation instead of a binary representation.  For example, without ASCII85 compression, binary streams in the PDF file may contain control characters (and possibly null bytes), and may not be interpreted correctly by the system that will read or manipulate the PDF file.

With ASCII85 compression, the PDF file is a text file that will contain only the carriage return, line feed, and printable ASCII characters.

If bSet is TRUE, ASCII85 compression will be used within the file producing text streams, otherwise the PDF data within the file will be compressed to a binary data stream.  By default, binary data streams will be produced if DTWAIN_SetPDFASCIICompression is not called.

Please note that if encryption is turned on using DTWAIN_SetPDFEncryption, the data within the PDF file will always be a binary stream, since encrypted data will contain control characters and null bytes.

TWAIN State Transitions

The Source must be in State 4. or higher

Prerequisite Function Call(s)

DTWAIN_SysInitialize

DTWAIN Source Selection Function