Handling Template Files

Template files are used to store capability information for a specific TWAIN source. That way, the next time that TWAIN source is used, the corresponding template file can provide information on the capabilities used previously.

LEADTOOLS provides the following functions for working with template files:

$image\sqrblit.gif$ L_TwainTemplateDlg displays the scanning dialog provided by the manufacturer of the TWAIN source without actually acquiring the images. Instead it gets the values of all supported capabilities, which will be saved to the specified template file. Before calling this function you can determine which user interface to display by calling the L_TwainEnableShowUserInterfaceOnly function.

$image\sqrblit.gif$ L_TwainOpenTemplateFile opens a template file for either reading or writing. When a template file is open for reading, the user can get capability information stored within the file. When a template file is opened for writing, capability information can be saved to that file.

$image\sqrblit.gif$ L_TwainAddCapabilityToFile adds a certain capability to the file when the file is opened with write access.

$image\sqrblit.gif$ L_TwainGetNumOfCapsInFile gets the number of capabilities stored in a template file.

$image\sqrblit.gif$ L_TwainGetCapabilityFromFile gets the capability information by passing its index to the function.

$image\sqrblit.gif$ L_TwainCloseTemplateFile closes the file and saves its contents if the file was opened with write access.

When a user acquires one or more images using the L_TwainAcquire function, the capability settings used for the TWAIN source can be saved in a template file. The next time the user wishes to use that TWAIN source he or she can open the template file saved previously, for read access, using L_TwainOpenTemplateFile. The L_TwainGetNumOfCapsInFile function will provide the number of capabilities stored in the template file. This information allows the user to loop through the stored capabilities using the L_TwainGetCapabilityFromFile function. As each capability is obtained, the user can set the capabilities for the TWAIN source using the L_TwainSetCapability function.