Object Hierarchy | Related C++ Class: Cluster
Cluster
A cluster represents a set of components on a Geometry. For example, the
polygons of the left arm of a human model might be grouped together by creating a cluster.
A cluster has a SIObject.Type which corresponds to the component type that
it contains, (pnt, knot, poly). A geometry can have multiple clusters, including clusters of
different types. Any particular component might be included in multiple clusters. The
ClusterTypes that are supported on a geometry depend on the type of object.
For example only NurbsSurface or NurbsCurve can have a
siKnotCluster.
Clusters can be created on the geometry of a ParticleCloud. These clusters
are of type siVertexCluster but they contain Particles.
A cluster that includes all the components of a particular type is said to be "always complete",
which you can verify with the Cluster.IsAlwaysComplete method. An always-complete
cluster always covers all components of the geometry, even when components are added by a modeling
operation; however, notice that a cluster which covers all components of a geometry is not necessarily
always-complete. Other clusters may contain a subset of components. In all cases the indices of the
components in the cluster do not directly match the indices of the component on the geometry.
The mapping between cluster indices and geometry indices is available through
Cluster.Elements and Cluster.FindIndices.
Clusters are useful for storing per-component data with a ClusterProperty or
UserDataMap. Clusters can also have their own CustomProperty
objects. All these properties can be created with SceneItem.AddProperty and
enumerated with SceneItem.LocalProperties. Notice that some types of
ClusterProperty require the cluster to be always complete.
Warning: Operations that change the geometry, for example adding an edge to a mesh, can result
in the cluster growing or shrinking.
Note: As of v5.0, the base property SIObject.Parent called on a Cluster object returns
a Primitive instead of an X3DObject.
' ' This example shows how to create many different cluster types. ' It also shows how to find all clusters in a scene ' NewScene ,false set oRoot = Application.ActiveProject.ActiveScene.Root set grid = oRoot.AddGeometry("Grid","MeshSurface") set gridGeometry = grid.ActivePrimitive.Geometry 'Only certain types makes sense on a MeshSurface 'This cluster we will create as a subset of the vertices gridGeometry.AddCluster siVertexCluster,"PntCluster",Array(1,4,7,10,13,16,19,22) 'The rest we will create as complete clusters gridGeometry.AddCluster siPolygonCluster,"PolygonC" gridGeometry.AddCluster siEdgeCluster gridGeometry.AddCluster siSampledPointCluster 'A different set makes sense with Nurbs set torus = oRoot.AddGeometry("Torus","NurbsSurface") set torusGeometry = torus.ActivePrimitive.Geometry torusGeometry.AddCluster siVertexCluster,"PntCluster" torusGeometry.AddCluster siSampledPointCluster torusGeometry.AddCluster siSurfaceCurveCluster torusGeometry.AddCluster siKnotCurveUCluster torusGeometry.AddCluster siKnotCurveVCluster torusGeometry.AddCluster siBoundaryCluster torusGeometry.AddCluster siKnotCluster torusGeometry.AddCluster siTrimCurveCluster torusGeometry.AddCluster siIsoLineUCluster torusGeometry.AddCluster siIsoLineVCluster torusGeometry.AddCluster siSubSurfaceCluster set circle = oRoot.AddGeometry("Circle","NurbsCurve") set circleGeometry = circle.ActivePrimitive.Geometry circleGeometry.AddCluster siIsoPointCluster circleGeometry.AddCluster siVertexCluster,"PntCluster" circleGeometry.AddCluster siKnotCluster set particleCloud = CreateParticleCloud().Item(0) particleCloud.ActivePrimitive.Geometry.AddCluster siVertexCluster, "MyParticles" ' Now traverse the scene finding all the clusters logmessage "Clusters in Scene......................" set oSceneObjs = ActiveSceneRoot.FindChildren() for each oItem in oSceneObjs 'Use error handling to skip over the objects that don't 'support clusters on error resume next set oClusters = oItem.ActivePrimitive.Geometry.Clusters if ( err = 0 ) then logmessage oItem & " has " & oClusters.Count & " Clusters: " for each oCls in oClusters logmessage " " & oCls & " (type: " & oCls.Type & ")" next end if next 'The output of this script is: 'INFO : "Clusters in Scene......................" 'INFO : "grid has 4 Clusters: " 'INFO : " grid.polymsh.cls.PntCluster (type: pnt)" 'INFO : " grid.polymsh.cls.edge.clslist.Edge (type: edge)" 'INFO : " grid.polymsh.cls.PolygonC (type: poly)" 'INFO : " grid.polymsh.cls.sample.clslist.Sample (type: sample)" 'INFO : "torus has 11 Clusters: " 'INFO : " torus.surfmsh.cls.V_Knot_Curve (type: knotcrvv)" 'INFO : " torus.surfmsh.cls.U_Knot_Curve (type: knotcrvu)" 'INFO : " torus.surfmsh.cls.sample.clslist.Sample (type: sample)" 'INFO : " torus.surfmsh.cls.PntCluster (type: pnt)" 'INFO : " torus.surfmsh.cls.Surface_Curve (type: srfcrv)" 'INFO : " torus.surfmsh.cls.V_Isoline (type: isolinev)" 'INFO : " torus.surfmsh.cls.knot.clslist.Knot (type: knot)" 'INFO : " torus.surfmsh.cls.Boundary (type: bndry)" 'INFO : " torus.surfmsh.cls.Subsurface (type: subsrf)" 'INFO : " torus.surfmsh.cls.U_Isoline (type: isolineu)" 'INFO : " torus.surfmsh.cls.Trim_Curve (type: trimcrv)" 'INFO : "circle has 3 Clusters: " 'INFO : " circle.crvlist.cls.Isopoint (type: isopnt)" 'INFO : " circle.crvlist.cls.PntCluster (type: pnt)" 'INFO : " circle.crvlist.cls.knot.clslist.Knot (type: knot)" 'INFO : "cloud has 1 Clusters: " 'INFO : " cloud.cloud.cls.MyParticles (type: pnt)" |
//Step 1: Simulate the user creating a scene and selecting //some points on a grid var oGrid = ActiveSceneRoot.AddGeometry( "Grid", "MeshSurface" ) ; SelectObj( oGrid ) ; ActivateVertexSelTool(); AddToSelection( oGrid.Name + ".pnt[0-8]", null, true); //Step 2: Get the selected components using OM var oSubComponent = Selection(0).SubComponent ; //Expect that 9 components were selected logmessage( oSubComponent.ComponentCollection.Count ) ; //Step 3: it is simple to create a cluster var oCluster = oSubComponent.CreateCluster() ; logmessage( oCluster.FullName ) ; //Output of this example: //INFO : "9" //INFO : "grid.polymsh.cls.Point" |