grabSeq

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

Use this function to capture several video frames as an image sequence. The format and size of the sequence 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 sequence will be placed. Values in the range of 100-116 correspond to hidden frames.

Frames

A positive integer specifying the amount of video frames to be captured into the sequence.

Delay

A positive integer specifying the delay (in milliseconds) between consecutive video frames to be captured into the sequence. If 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

The following operator will capture a sequence of 64 video frames with a five seconds interval between the frames:

grabSeq(1, 64, 5000)