Go to: Related nodes. Attributes.

This node takes geometry as input and deforms it based on pairs of target shapes and weight values, to produce a new shape that is the specified blending of the input shapes.

Node nameParentsMFn typeCompatible function sets
blendShapegeometryFilterkBlendShapekBase
kNamedObject
kDependencyNode
kGeometryFilt
kBlendShape

Related nodes

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

Attributes (30)

baseOrigin, baseOriginX, baseOriginY, baseOriginZ, baseWeights, icon, inputComponentsTarget, inputGeomTarget, inputPointsTarget, inputTarget, inputTargetGroup, inputTargetItem, normalizationGroup, normalizationId, normalizationUseWeights, normalizationWeights, origin, paintTargetIndex, paintTargetWeights, paintWeights, parallelBlender, supportNegativeWeights, targetOrigin, targetOriginX, targetOriginY, targetOriginZ, targetWeights, topologyCheck, useTargetCompWeights, weight

Long name (short name)TypeDefaultFlags
topologyCheck (tc) booltrueoutputinputconnectablestorable
Should the deformation check to see if the input topologies match?
weight (w) float0arrayoutputinputconnectablestorablekeyable
The array of weight values (one per target shape)
icon (icn) stringNULLarrayinputconnectablestorable
The name of a file containing an icon per target shape (not currently supported).
inputTarget (it) compoundn/aarrayoutputinputconnectablestorable
Bundled list of target info for a shape that is being deformed. The array index of this attribute corresponds to the array index of the input attribute, meaning that this target info is used to deform a given input shape.
inputTargetGroup (itg) compoundn/aarrayoutputinputconnectablestorable
Bundled group of target information for a particular target weight. The array index of this attribute corresponds to the array index of the weight attribute, meaning that the corresponding weight value controls this target.
inputTargetItem (iti) compoundn/aarrayoutputinputconnectablestorable
Collection of all targets in a sequential target chain. The array index of this attribute is used to control which two target items we are interpolating between with the relationship: index = wt * 1000 + 5000. Thus a weight of 1 corresponds to the index 6000. An inbetween placed at a weight of 0.5 would be at the index 5500.
inputGeomTarget (igt) geometryNULLoutputinputconnectable
The target geometry input
inputPointsTarget (ipt) pointArrayNULLoutputinputconnectablestorable
Delta values for points in a target geometry.
inputComponentsTarget (ict) componentListNULLoutputinputconnectablestorable
Component list for points in a target geometry.
targetWeights (tw) float1.0arrayoutputinputconnectablestorablekeyable
The weights themselves, in the same order as the components deformed by the deformation.
normalizationId (nid) integer0outputinputconnectablestorable
The ID of the normalization group that includes this target, or zero for no normalization.
baseWeights (bw) float1.0arrayoutputinputconnectablestorablekeyable
The weights associated with the base shape, in the same order as the components deformed by the deformation.
normalizationGroup (ng) compoundn/aarrayoutputinputconnectablestorable
Bundled group of normalization information for a particular normalization group ID.
normalizationUseWeights (nuw) boolfalseoutputinputconnectablestorable
Controls whether this normalization group uses the normalizationWeights in the normalization calculation.
normalizationWeights (nw) float1.0arrayoutputinputconnectablestorablekeyable
The normalization weights, in the same order as the components deformed by the deformation.
paintTargetWeights (pwt) float1.0arrayoutputinputconnectablehidden
Temporarily stores the weights for one of the targets during painting.
paintTargetIndex (pti) integer0outputinputconnectablehidden
Tracks which target is being painted. The value corresponds to the index of the inputTargetGroup or normalizationGroup attribute. If value < 0, normalization group (-value) is indicated.
origin (or) enum1outputinputconnectablestorable
Specifies the space in which point deltas are calculated. Valid values are 0 = "world", 1 = "local", 2 = "user".
baseOrigin (bo) double3outputinputconnectablestorable
When the origin flag is userDefined, the origin of the base shape is computed with respect to this point.
baseOriginX (bx) distance (double)0.0cmoutputinputconnectablestorable
X position of baseOrigin.
baseOriginY (by) distance (double)0.0cmoutputinputconnectablestorable
Y position of baseOrigin.
baseOriginZ (bz) distance (double)0.0cmoutputinputconnectablestorable
Z position of baseOrigin.
targetOrigin (to) double3outputinputconnectablestorable
When the origin flag is userDefined, the origin of the target is computed with respect to this point.
targetOriginX (tx) distance (double)0.0cmoutputinputconnectablestorable
X position of targetOrigin.
targetOriginY (ty) distance (double)0.0cmoutputinputconnectablestorable
Y position of targetOrigin.
targetOriginZ (tz) distance (double)0.0cmoutputinputconnectablestorable
Z position of targetOrigin.
parallelBlender (pb) bool0outputinputstorablehidden
This is true if the blendShape is used to blend parallel deformations.
useTargetCompWeights (itcw) booltrueoutputinputhidden
This attribute is used internally to enable/disable the use of the per target component weights during evaluation
supportNegativeWeights (sn) bool0outputinputstorablehidden
Set to true if weights below -5 will be used in a target group. When this is off, blending between in-between shapes only supports weights >= -5.0. Enabling this attribute allows interpolation to in-betweens at numbers less than -5.0.
paintWeights (ptw) doubleArrayemptyoutputinputconnectablehidden
Legacy attribute left in to provide file format compatibility with Maya 2012 Gold/Hotfix 1.