TwainSave Command Information

Top  Previous  Next

DTWAIN 4.x now contains the same technology as the standalone command-line utility TwainSave.  This allows you to easily acquire and save images to files using a single DTWAIN function call using the DTWAIN_TwainSave function.

 

For many situations, giving a command-line of options rather than setting up the acquisition process with a series of DTWAIN function call is easier to implement for the programmer.  However, since TwainSave can only do a subset (albeit, a very large subset) of the overall DTWAIN library, your program may not find the DTWAIN_TwainSave function adequate enough, and will need to make DTWAIN calls to set up your acquisitions properly.  In that case, it would be more appropriate to use the full DTWAIN API.

 

Here are a few examples that are not currently supported by DTWAIN_TwainSave command-line options.
 

Buffered Transfer Mode.  Only Native Transfer Mode is supported.
Returning acquired image data as a bitmap (DTWAIN_TwainSave only saves acquired images to files).
Notification processing.   For example, you cannot programmatically react to DTWAIN's messages that are sent during the acquisition of multiple pages.
OCR processing.  You cannot have DTWAIN use your OCR engine to acquire text files, or to create searchable text when acquiring to PDF files.
Writing additional text to PDF files.  Only the original image that is acquired can be saved to a PDF file.

 

 

The following commands are currently not supported with DTWAIN_TwainSave, but are supported in the TwainSave standalone product:

-dsmsearchorder

-overwritemode

-overwritemax

 

In general, please note that the TwainSave standalone product is updated more frequently than the DTWAIN library.  It is highly possible that one or more newly added TwainSave commands may not exist for DTWAIN_TwainSave.

 

At a future date, DTWAIN_TwainSave may support one or more of the above items.  If your application needs to support one or more of the above, you will have to use the other DTWAIN functions to accomplish them.

 

Your programming needs should decide whether using DTWAIN_TwainSave, or setting up acquisitions using traditional DTWAIN calls is appropriate.