National Instruments NI-IMAQ Digital Camera User Manual


 
Chapter 3 Programming with NI-IMAQ for 1394
© National Instruments Corporation 3-5 NI-IMAQ for IEEE-1394 Cameras User Manual
Introductory Programming Examples
This section introduces some examples for performing the different types
of image acquisition.
Note
The error codes returned by NI-IMAQ are not included in the examples. Always
check the return code for errors in your program.
IfyouhaveIMAQVisioninstalledonyourcomputer,youcantake
advantage of the additional Image functions installed with NI-IMAQ for
1394. These functions use the IMAQ Vision memory management feature,
in which you must first create an image using
imaqCreate
and then pass
that image to an acquisition function.
If you do not have IMAQ Vision installed on your computer, you must
manually allocate the memory for your image. Use the attributes
ImageWidth, ImageHeight,andBytesPerPixel to determine how much
memory you should allocate.
Note
You can find the code examples discussed in this section in the
NI-IMAQ for
IEEE-1394\samples
directory. The LabWindows/CVI examples emphasize the Image
functions, and the C examples for Visual C++ and Borland C++ emphasize the standard
functions.
High-Level Snap Functions
A snap acquires a single image into a memory buffer. Snap functions
include
imaq1394Snap
and
imaq1394SnapImage
.Use thesefunctions to
acquire a single frame to a buffer. To use these functions, you must have a
valid session handle.