User`s guide

SPECIAL GUIDES
SDK SECTION 9
Page 67
DATA RETRIEVAL METHODS
How to determine when new data is available
There are a wide of range of functions available for retrieving data from the camera. Deciding which functions
should be used depends on whether the data will be retrieved during an acquisition or once the acquisition is
complete. See
Retrieving Image Data
For certain cases it may be useful to know what stage an acquisition is at. The GetStatus function can be
used to get the current status of the acquisition. It will return information such as, the acquisition is in
progress or it is finished. See GetStatus for full list of return information.
Another way to know if an acquisition is finished is with the WaitForAcquisition function. When an acquisition
is started, the WaitForAcquisition function can be called, it does not return from this function until the
acquisition is finished. The function can be cancelled by calling the CancelWait function although this will
require the user application to be multi-threaded.
Figure 12: Example of WaitForAcquisition Pseudo Code