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.

For Grablink Full, Grablink DualBase and Grablink Base, refer to the Multicam surface allocation rules.