Accessing a Collection Parameter
Some MultiCam parameters exist as a collection. This applies to any parameter type.
A collection parameter is a container able to host several values of the same type. In other words, it provides a way to reach several parameters of the same type using a single parameter name.
Accessing a collection parameter can be performed using the by-identifier parameter access method.
In this case, the parameter reference is established with an integer identifier defined in the MultiCam McParams.h header file.
The first element of the collection is referred to with this identifier just like a non-collection parameter. The following elements are referred to with consecutive integer values starting from the identifier value.
Accessing a collection parameter can also be performed using the by-name parameter access method.
In this case, the name allowing access to the collection element is the concatenation of the following items:
- Parameter name
- Colon (:)
- String representing the zero-based index of the collection element.
The following table summarizes the access methods using the collection parameter Cluster.
Collection element |
By-identifier access |
By-name access |
First element |
MC_Cluster |
Cluster |
First element, alternative |
MC_Cluster + 0 |
Cluster:0 |
Second element |
MC_Cluster + 1 |
Cluster:1 |
Third element |
MC_Cluster + 2 |
Cluster:2 |