DTWAIN File Transfer Constants
|
The following constants are used for the DTWAIN_AcquireFile and DTWAIN_AcquireFileEx functions.
These constants describe the various image file types that DTWAIN can save acquired images to using the DTWAIN file transfer support. Any Twain Source, regardless of make or model of the device, can acquire to the file types below. To use the constants defined below, the DTWAIN_USESOURCEMODE flag must not be set when you specify the file control flags in the call to DTWAIN_AcquireFile or DTWAIN_AcquireFileEx. Note: These constants are not to be used if using the Source's internal file transfer support (see Source Internal File Support below for the proper constants to use for DTWAIN_EnumFileXferFormats).
* The multi-page file types are supported only for Twain devices that can acquire multiple pages (for example, a scanner equipped with an automatic document feeder) or if the DTWAIN_SetMultipageScanMode has been set with DTWAIN_FILESAVE_UICLOSE or DTWAIN_FILESAVE_SOURCECLOSE option. Otherwise, the multi-page file types revert to their single-page equivalent.
** PDF and PostScript option is available only with DTWAIN / PDF support.
*** Text file support is only available if one of the supported OCR engines is installed.
Source Internal File Support These constants describe the image file types that a Source can save an acquired image to if the Source's internal file transfer support is used. These constants are to be used only for the internal file transfer that the Source provides. Note that not all Sources have File transfer support. If the Twain Source does not support file transfers, you must use one of the constants defined above!.
When calling DTWAIN_AcquireFile or DTWAIN_AcquireFileEx and specifying the DTWAIN_USESOURCEMODE flag, the Source is responsible for the file transfer, and DTWAIN provides no other support except to initiate the transfer. Problems with improper files being generated, incorrect bitmaps, etc. are not the responsibility of DTWAIN when specifying DTWAIN_USESOURCEMODE.
These constants are returned by the DTWAIN_EnumFileXferFormats and are to be used when acquiring an image using the Source's internal file transfer.
|