Image Retrieval Functions
|
After an acquisition is done, you will need to get the images that were created for the pages that were acquired from the Source. For almost all acquisitions, the returned images are Device Independent Bitmaps (DIBs). To retrieve the number of acquisitions, number of images for a particular acquisition and the images generated, the following functions are used:
Number of requests to acquire images
Number of DIBs generated for each acquisition request
Retrieval of one HANDLE to acquired image memory
Retrieval of all acquired images for an acquisition request
Retrieval of last successfully acquired image DTWAIN_GetCurrentAcquiredImage
Note: If the DTWAIN_AcquireBuffered is called to acquire images, and compression is used, compressed image data is returned instead of DIBs. The image data can be then saved to a file or processed by the application in any way it sees fit.
To get a handle to the image data, the application must call the Windows API function GlobalLock to lock the memory, and GlobalUnlock and GlobalFree to destroy the memory. The application is solely responsible for deleting the memory. |