ImageControls 3.1 Application NoteImageControls Toolkit 3.1 is the latest release of the Kofax ImageControls Toolkit product. |
To access the following Web pages for this release, please click on the desired page's link. Application Notes - Error Codes - Frequently Asked Questions - Revision Levels - Supported Configurations |
Frequency of Display While Scanning/ImportingImageControls 3 provides the capability to display all images while they are being scanned. This is normally accomplished by connecting the KView to the KScan controls, and automatically displaying the scanned or imported image. But, the displaying of images as they are being scanned or imported can negatively impact the ImageControls scan process. As an alternative to displaying all images as they are processed, a developer can control the frequency which processed images are displayed. For example, instead of displaying each and every image as it is processed, the user may only wish to see every five (5) images processed. This is outlined in the ImageControls 3 Programmer's Guide, Chapter 4 Scanning and Importing Images, the section Programmatic Control Over the Frequency of the Display. This project modifies the original demonstration utility, VBDEM32x.EXE, source code as provided with the ImageControls 3 Toolkit. It provides the ability to alter the frequency at which processed images are displayed. The user would select a number between "0" and "9" inclusive. A zero (0) would denote the deactivation of any display of processed images. A one (1) would denote that all images processed are to be displayed. A two (2) would denote that every other image processed be displayed and so on. It contains one additional form, frmDisplayFreq, which is a dialog box to select frequency at which images will be displayed. This form consists of the following:
Figure 1 displays the placement of these items on the form. Figure 1 A menu selection, mnuSourceDisplayFreq, was added after the Batch Processing menu item in the Source pull down menu of the main form, frmMain. When it is selected, the form frmDisplayFreq is displayed. When the user closes the dialog box, it is unloaded.
The user is able to select the frequency in which the images will be displayed during processing. When the form loads, it centers itself and puts the dialog box on top. The initial value is derived from a global variable, g_DisplayFreq.
When the OK command button is selected, the value for the display frequency is validated.
Three new global variables are added to the General Declarations of the KFUTIL.BAS file: g_DisplayFreq, g_PEFileName and g_Pefront. These global variables are used to determine the frequency in which images should be displayed, the filename to which the image was saved, and the page to which the image was saved.
When the main form is loaded, Form_Load event, the global variable g_DisplayFreq is initialized. It is initialized to a value of one (1), or to display all images while processing.
It is determined if the image is a front or back side image during the KScan_PageEnd event. (Existing Code)
(New Code)
(Existing Code)
The filename and page to view are also updated during the KScan_PageEnd event. (Existing Code)
(New Code)
(Existing Code)
(New Code)
Finally, during the KScan_PageDone event the filename, page and whether it is a front or back page are set and the image is viewed. If the user has selected zero (0) or one (1) for the display frequency, then the standard way of handling the viewing of scanned image is performed. If not, then the images are manually displayed. This is placed at the end of the procedure.
|
