imaqSetupSequence

NI Vision for LabWindows/CVI Function

imaqSetupSequence

Usage

int imaqSetupSequence(SESSION_ID sessionID, Image** images, int numImages, int skipCount, Rect rect);

Purpose

Configures a sequence acquisition. A sequence acquisition acquires a full sequence of images into the image array. To start the acquisition, call imaqStartAcquisition(). The acquisition finishes upon reaching the end of the sequence or when you call imaqStopAcquisition(). Do not modify or dispose of the images in the sequence until the acquisition has finished.

Image Types Supported

IMAQ_IMAGE_U8, IMAQ_IMAGE_I16, IMAQ_IMAGE_RGB, IMAQ_IMAGE_HSL

Parameters

Name

Type

Description

sessionID SESSION_ID A valid session ID.
images Image** An array of images. Each element in the array must be a pointer to a valid image.
numImages int The number of images in the images array.
skipCount int The number of frames to skip between each acquired image. A skipCount of 0 acquires images continuously without skipping frames between acquired images.
rect Rect The area to acquire. Set this parameter to IMAQ_NO_RECT to acquire the entire acquisition window.

Return Value

Type

Description

int On success, this function returns a non-zero value. On failure, this function returns 0. To get extended error information, call imaqGetLastError().