High-Level Sequence Functions

Sequence functions include imgSequenceSetup, imgSessionStartAcquisition, and imgStopAcquisition. A sequence initiates a variable-length and variable-delay transfer to multiple buffers. You can configure the delay between acquisitions with imgSequenceSetup and specify both the buffer list used for transfers and the number of buffers. After imgSequenceSetup, you can monitor the status of the transfer and perform processing on any of the buffers in the sequence or you can wait until the acquisition completes and process all buffers simultaneously.

Use a sequence in applications where you need to perform processing on multiple images. You can configure a sequence to acquire every frame or skip a variable number of frames between each image.

The following figure illustrates a typical sequence programming order.

The HLSeq.c example demonstrates how to perform a sequence acquisition using imgSequenceSetup. The example sets up a sequence that uses ten user-allocated buffers. Each buffer in the sequence has its own skip count associated with it. The skip count is the number of frames to skip prior to acquiring the next image. The acquisition is started at setup time and the setup call is synchronous.