ImageGear for C and C++ on Windows v19.1 - Updated
IG_TWAIN_auto_capture
API Reference Guide > TWAIN Component API Reference > TWAIN Component Functions Reference > Scanning Functions > IG_TWAIN_auto_capture

This function automatically captures images from the selected TWAIN device.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_TWAIN_auto_capture(
        LONG lImageCount,
        LONG lTimeBeforeFirstCapture,
        LONG lTimeBetweenCaptures,
        LPCSTR lpszImageDirName
);

Arguments:

Name Type Description
lImageCount LONG The number of images to be captured.
lTimeBeforeFirstCapture LONG The number of milliseconds before the first picture is to be taken, or the first image is to be scanned.
lTimeBetweenCaptures LONG The number of milliseconds to wait between pictures taken or images scanned.
lpszImageDirName LPCSTR The destination directory within the Source (camera, storage, etc.) where captured images will be stored.

Return Value:

Returns the number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.

Supported Raster Image Formats:

This function does not process image pixels.

Remarks:

The captured images are stored on the device in lpszImageDirName directory and can be retrieved through browsing the file system.

Use IG_TWAIN_source_open() to select the desired Data Source, and IG_TWAIN_cap_set() to set desired capabilities values, prior to calling this function.