Go to: Related nodes. Attributes.

The cluster node deforms one or more geometries by transforming them by some percentage of the transformation of another object in the scene. The default percentage is one, so the default cluster will rigidly deform the geometries.

A different percentage can be associated with each CV in the deformed object.

The accuracy of the deformation is controlled by the percentResolution attribute.

The envelope attribute can be used to globally attenuate the amount of deformation.

Node nameParentsClassificationMFn typeCompatible function sets
clusterweightGeometryFilterdeformerkClusterFilterkBase
kNamedObject
kDependencyNode
kGeometryFilt
kWeightGeometryFilt
kClusterFilter

Related nodes

lattice, jointCluster, nonLinear, blendShape, skinCluster, boneLattice, wrap, wire, ffd, jointFfd, sculpt, jointLattice, flexorShape, deformFunc, deformSquash, deformTwist, deformBend, deformWave, deformFlare, deformSine, baseLattice, clusterHandle

Attributes (15)

angleInterpolation, bindPreMatrix, bindState, clusterXforms, geomMatrix, matrix, percentResolution, postCompensationMatrix, postMatrix, preCompensationMatrix, preMatrix, relative, usePartialResolution, weightedCompensationMatrix, weightedMatrix

Long name (short name)TypeDefaultFlags
bindState (bs) boolfalseoutputinputconnectable
not used
clusterXforms (x) compoundn/aoutputinputconnectable
the bundled cluster transforms
preMatrix (pre) matrixidentityoutputinputconnectable
Represents the transformation in the DAG above the weighted node.
weightedMatrix (wt) matrixidentityoutputinputconnectable
cluster weighted matrix
postMatrix (post) matrixidentityoutputinputconnectable
Represents the transformation in the DAG below the weighted node.
geomMatrix (gm) matrixidentityarrayoutputinputconnectablestorablehidden
Matrix to set account for the geom matrix at cluster creation time.
angleInterpolation (ait) enum3outputinputconnectablestorable
The method of angle interpolation. Mode 3 (Shortest) will take the shortest path between the start and end orientation. Modes 1 (Positive) and 2 (Negative) both use a quaternion interpolation with an extra spin to avoid the flip at 180 degrees. They differ in the path they take to move from the start to end orientation. Mode 0 (Closest) is a mix between Positive and Negative. For each sample it will pick the path that is the closest to the straightforward Euler interpolation. Note that this can cause discontinuities: some verts will take the Positive path and other verts the Negative path. Also when changing the overall envelope verts can suddenly pick the alternative path.
percentResolution (ptr) float5outputinputstorable
resolution by which cluster percents can differ without being lumped together as a single percentage for efficiency
postCompensationMatrix (psc) matrixidentityoutputinputconnectablehidden
WorldSpace matrix below cluster weighted matrix compensation
preCompensationMatrix (prc) matrixidentityoutputinputconnectablehidden
WorldSpace matrix above cluster weighted matrix comp (-bs)
bindPreMatrix (pm) matrixidentityoutputinputconnectablestorable
compensation matrix used when we rigidly deform the geometry
relative (rel) boolfalseoutputinputconnectablestorable
relative => only use weighted node i.e. no pre, post matrix
matrix (ma) matrixidentityoutputinputconnectablestorable
transform that we will rigidly deform by when all percentages are at one
usePartialResolution (upr) enum0outputinputconnectablestorable
whether or not to use the partial resolution
weightedCompensationMatrix (wcm) matrixidentityoutputinputconnectablestorablehidden
cluster weighted matrix compensation