Array  | Count | ItemsByIndex | |
Related C++ Class: CClusterElementArray
v1.0
A collection of cluster elements in a Cluster object
or ClusterProperty object.
The purpose of the data stored in this object depends whether it is on a Cluster or
a ClusterProperty.
The ClusterElementCollection returned by Cluster.Elements (and
Envelope.Elements) provides the mapping between an index of a
component in a cluster with the index of the component on the Geometry.
For example index 10 on a polygon Cluster might refer to Polygon 45 on the geometry,
in which case ClusterElementCollection.Item(10) has the value 45. This data is read-only.
When trying to find if a particular geometry component is part of a cluster
it would be possible to search through this array. However a more convenient and
efficient method is to use Cluster.FindIndex.
On the other hand, the ClusterElementCollection returned by
ClusterProperty.Elements (and Envelope.Weights)
provides read/write access to the actual data of the ClusterProperty. For example in
the case of a Vertex Color property this provides access to the RGB values stored for
each component. In this case the first dimension has size 3, corresponding to the RGB
values and the second dimension corresponds to the index of the component. The values
are always represented as Doubles.
'
' This example demonstrates how to read and write the values on
' a weight map, using the ClusterElementCollection object.
' It also demonstrates how the indices on the cluster property
' correspond to the indices of the cluster, but that these indices do
' not directly correspond to the indices on the geometry.
NewScene ,false
set oSphere = ActiveSceneRoot.AddGeometry("Sphere","NurbsSurface")
' Create a weight map on a cluster that includes only a subset of the points
set oCluster = oSphere.ActivePrimitive.Geometry.AddCluster( _
siVertexCluster, "MyFrontPoints", Array( 18,19,20,25,26,27) )
CreateWeightMap , oCluster.FullName, "MyWeightMap"
set oWM = oCluster.LocalProperties( "MyWeightMap" )
' Use the ClusterElementCollection.Array to access all the weights in a
' single 2-dimensional array
ElArray = oWM.Elements.Array
' Set the weight on second item in the cluster, (which is point 19), to 100
ElArray(0,1) = 100
' Set the weight on point 25 to 99
ElArray(0,3) = 99
' Copy our altered array of values back onto the weight map
oWM.Elements.Array = ElArray
' Use ClusterElementCollection.Item to set an individual weight on the
' Weight Map. Notice how it is still using an array
'Create a 1 Dimensional array with 1 element
dim myWeight(0)
myWeight(0) = 10
'Assign the value
oWM.Elements.Item( 2 ) = myWeight
'Print out the contents
set oCluster = oWM.Parent
for i = 0 to oWM.Elements.Count - 1
indexOnGeometry = oCluster.Elements.Item(i)
logmessage "Weight at " & i & " (pnt" & indexOnGeometry & _
") is " & oWM.Elements.Item(i)(0)
next
'Output of running this script is:
'INFO : "Weight at 0 (pnt18) is 1"
'INFO : "Weight at 1 (pnt19) is 100"
'INFO : "Weight at 2 (pnt20) is 10"
'INFO : "Weight at 3 (pnt25) is 99"
'INFO : "Weight at 4 (pnt26) is 1"
'INFO : "Weight at 5 (pnt27) is 1" |