High-Level Grab Functions - National Instruments Image Acquisition Software User Manual

Chapter 3 Programming with NI-IMAQ

High-Level Grab Functions

NI-IMAQ User Manual
The sample then calls a process function to analyze the image. When the
program is finished, it calls
the freeResources flag to TRUE. This instructs NI-IMAQ to free all of the
resources associated with this interface, which releases the session as well
as the memory buffer allocated by
A grab is a continuous high-speed acquisition of data to a single buffer in
host memory. Grab functions include
. You can use these functions to perform an acquisition that
imgGrabArea
loops continually on one buffer. A copy of the acquisition buffer is
obtained by grabbing a copy to a separate buffer. To use these functions,
you must have a valid session handle.
Calling
imgGrabSetup
After
imgGrabSetup
buffer into a user buffer where you can perform processing on the image. A
grab is appropriate for high-speed applications where you need processing
performed on only one image at a time. Figure 3-3 illustrates a typical grab
programming order.
with the interface handle and sets
imgClose
imgSnap
imgGrabSetup
initializes a session for a grab acquisition.
, each successive grab will copy the last acquired
3-8
.
, and
imgGrab
© National Instruments Corporation