Cluster

Set of surfaces associated to a channel

Parameter Info

Class Category Level Type Access
Channel Cluster SELECT Instance collection Set and Get
Num ID String Identifier C, C++ identifier
12 << 14 Cluster MC_Cluster

Parameter Description

This parameter gives access to the list of handles of the surfaces belonging to the destination cluster.

A cluster is a set of surfaces having compatible characteristics, but different locations. All surfaces belonging to a cluster should be able to accept images coming from the same source through a given channel.

The idea behind the clusters is the capability to easily implement advanced destination structures such as double, triple or rotating image buffers.

Surface to Cluster Assignment

A surface can be assigned to several clusters provided that:

  • The clusters belong to channels defined within the same application.
  • The channels address the same board.

The maximum number of surfaces assigned to a channel is 4096, and the maximum number of surfaces instantiated within an application is 4096.

Currently, the number of surfaces that can be handled by a board may be less than the maximum, depending on the hardware capabilities and characteristics of the acquisition surface.