imaq1394SnapImage

Format

rval = imaq1394SnapImage (SESSION_ID sessionId, Image *image, Rect rectangle);

Purpose

Configures, starts, acquires, stops, and unconfigures a snap acquisition. Use a snap for low-speed or single-capture applications where ease of programming is essential. If you call this function before calling imaq1394CameraOpen2, imaq1394SnapImage uses cam0 by default. If the image type does not match the video format of the camera, this function changes the image type to a suitable format.

Parameters

Parameter	Type	Description
sessionId	SESSION_ID	A valid Session ID, which you can obtain using imaq1394CameraOpen2.
image	Image *	The image into which to acquire. Use the IMAQ Vision function imaqCreateImage to create an image.
rectangle	Rect	The area to acquire. Set this parameter to IMAQ_NO_RECT to acquire the entire acquisition window.

Return Value

On success, this function returns IMG1394_ERR_GOOD. On failure, this function returns an error code. You can obtain a more detailed error message with imaq1394ShowError.