grabInt

grabInt ( integer Output, integer Frames [, integer Delay ] )

Use this function to capture a single image as a result of accumulating and integrating several video frames. This function is typically used to boost intensity values under low-light conditions. The format and size of the image captured depends on the video device settings.

Parameters

Output

An integer between 1 and 116 specifying the number of the workspace frame into which the image will be placed. Values in the range of 100-116 correspond to hidden frames.

Frames

A positive integer specifying the amount of video frames used for the integration.

Delay

A positive integer specifying the delay (in milliseconds) between consecutive video frames used for the integration. f this parameter is omitted or if the video device frame rate is lower than the rate corresponding to the specified delay time, the function will use the fastest frame rate possible for the current video device adjusting the actual delay time accordingly.

Error flags

ERR_OK

The flag set if successful.

ERR_FAILED

The flag set if failed.

ERR_TIMEOUT

The flag set if timeout occurred.

Example

This set of statements will continuously grab the live video integrating every four frames of the video stream. If a capture error occurs, the script will terminate.

do

grabInt(1, 4, 60)

loop while getError()=ERR_OK