Home

Previous

Up

Next

MultiCam Boards Documentation > MultiCam Documentation > MultiCam User Guide > MultiCam Basics > Acquisition > Cluster Mechanism > Cluster State

Cluster State

The cluster mechanism description uses an internal state associated to the cluster. The destination cluster of a channel is necessarily in one of the four following states:

Cluster state

Meaning

OFF

The cluster if OFF when the acquisition is not alive.

READY

The cluster is READY when the acquisition is alive, no surface is PROCESSING, and the cluster can accept a new acquisition.

BUSY

The cluster is BUSY when the acquisition is alive and one of its surfaces is PROCESSING.

UNAVAILABLE

The cluster is UNAVAILABLE when the acquisition is alive but the cluster cannot accept a new acquisition. This is an exceptional situation.

The goal of the cluster mechanism is to make available to the application an unalterable surface for image processing. The callback mechanism offers a separate thread to realize the image processing task.

As long as the callback thread is processing a surface, this surface is in the state PROCESSING. As the thread is unique, no other surface can be processed at this time.

When the processing callback function is in operation, the cluster is said to be BUSY. Otherwise, the cluster is said to be READY. In other words, the cluster is BUSY when one of its surfaces is PROCESSING.