Adobe PDF / PostScript Support

Top  Previous  Next

With the DTWAIN / PDF add-on, additional PDF and PostScript file support is provided for DTWAIN_AcquireFile and DTWAIN_AcquireFileEx.  When acquiring to PDF files, the application has the option of:

 

Acquiring single or multi-page PDF's,
Setting the PDF page size
Setting the PDF page orientation.
Scaling the image.
Setting PDF author, producer, title, subject, and keywords.
Creating encrypted PDF files.
Add text to PDF pages.
Add searchable text to PDF pages using an OCR engine.

 

The following support functions are available:

 

DTWAIN_AddPDFText

DTWAIN_SetPDFAuthor

DTWAIN_SetPDFEncryption

DTWAIN_SetPDFKeywords

DTWAIN_SetPDFOrientation

DTWAIN_SetPDFPageScale

DTWAIN_SetPDFPageSize

DTWAIN_SetPDFProducer

DTWAIN_SetPDFSubject

DTWAIN_SetPDFTitle

 

It is advisable to use the functions above to add text to a page, since DTWAIN_AddPDFText only provides a subset of what can be done with the functions above.

 

It is most appropriate that these functions are called prior to calling DTWAIN_AcquireFile or DTWAIN_AcquireFileEx.  You can also call these functions before a page is acquired by trapping the DTWAIN_TN_TRANSFERREADY notification and calling the PDF function(s) in your handler.

 

For PostScript files, your applications have a choice of PostScript Level 1, 2, or 3 compliant files.  The files that are produced are fully DSC (Document Structuring Conventions) compliant, therefore they can be easily manipulated with various third-party PostScript tools.

 

Special Note:  The saving of Adobe PDF and PostScript files requires a writeable and accessible temporary directory.  If you are attempting to acquire PDF / PostScript files, and have errors in creating the files, make sure that your temporary directory (usually C:\TEMP, please check your System settings) is writeable and accessible from the computer running the application.  You can also set the temp file directory by calling DTWAIN_SetTempFileDirectory before acquiring images.

 

Also, PDF / PostScript creation requires that your acquired images are 1, 8, 16, or 24 bit images.  If they are any other bit-depth, the PDF / PostScript creation will fail, or the PDF/ PostScript  file will not be created correctly.

 

For more information on the PDF and PostScript file formats, and other Adobe information, go to www.adobe.com.