imaqSetupRing
Usage
int imaqSetupRing(SESSION_ID sessionID, Image** images, int numImages, int skipCount, Rect rect);
Purpose
Configures a ring acquisition. A ring acquisition acquires images continuously and loops them into a buffer list. To start the acquisition, call imaqStartAcquisition(). To stop the acquisition, call imaqStopAcquisition(). To get an image from the ring, call imaqExtractFromRing() or imaqCopyFromRing(). Do not modify or dispose of the images in the ring until you end the acquisition with imaqStopAcquisition().
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(). |