Image Retrieval Functions

Top  Previous  Next

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

DTWAIN_ArrayGetCount

 

Number of DIBs generated for each acquisition request

DTWAIN_GetNumAcquiredImages

 

Retrieval of one HANDLE to acquired image memory

DTWAIN_GetAcquiredImage

 

Retrieval of all acquired images for an acquisition request

DTWAIN_GetAcquiredImageArray

 

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.