MultiCam Boards Documentation > MultiCam Documentation > MultiCam Reference > Channel Class > Cluster Category > Select Level (Cluster) > Cluster

Cluster

Description

Type

Instance Collection

Description

Set of surfaces associated to a channel

"Set" effect

Sets the ownership of a surface as a member of the cluster collection

"Get" effect

Returns the handle of a specified surface belonging to the cluster

Classification

Class

Channel

Category

Cluster

Level

Select

Identifiers

String

Cluster

C, C++

MC_Cluster

.NET

MC.Cluster

Numerical

12

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 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.