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 name Parents MFn type Compatible function sets
blendShape geometryFilter kBlendShape kBase
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) Type Default Flags
topologyCheck (tc) bool true outputinputconnectablestorable
Should the deformation check to see if the input topologies match?
weight (w) float 0 arrayoutputinputconnectablestorablekeyable
The array of weight values (one per target shape)
icon (icn) string NULL arrayinputconnectablestorable
The name of a file containing an icon per target shape (not currently supported).
inputTarget (it) compound n/a arrayoutputinputconnectablestorable
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) compound n/a arrayoutputinputconnectablestorable
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) compound n/a arrayoutputinputconnectablestorable
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) geometry NULL outputinputconnectable
The target geometry input
inputPointsTarget (ipt) pointArray NULL outputinputconnectablestorable
Delta values for points in a target geometry.
inputComponentsTarget (ict) componentList NULL outputinputconnectablestorable
Component list for points in a target geometry.
targetWeights (tw) float 1.0 arrayoutputinputconnectablestorablekeyable
The weights themselves, in the same order as the components deformed by the deformation.
normalizationId (nid) integer 0 outputinputconnectablestorable
The ID of the normalization group that includes this target, or zero for no normalization.
baseWeights (bw) float 1.0 arrayoutputinputconnectablestorablekeyable
The weights associated with the base shape, in the same order as the components deformed by the deformation.
normalizationGroup (ng) compound n/a arrayoutputinputconnectablestorable
Bundled group of normalization information for a particular normalization group ID.
normalizationUseWeights (nuw) bool false outputinputconnectablestorable
Controls whether this normalization group uses the normalizationWeights in the normalization calculation.
normalizationWeights (nw) float 1.0 arrayoutputinputconnectablestorablekeyable
The normalization weights, in the same order as the components deformed by the deformation.
paintTargetWeights (pwt) float 1.0 arrayoutputinputconnectablehidden
Temporarily stores the weights for one of the targets during painting.
paintTargetIndex (pti) integer 0 outputinputconnectablehidden
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) enum 1 outputinputconnectablestorable
Specifies the space in which point deltas are calculated. Valid values are 0 = "world", 1 = "local", 2 = "user".
baseOrigin (bo) double3 outputinputconnectablestorable
When the origin flag is userDefined, the origin of the base shape is computed with respect to this point.
baseOriginX (bx) distance (double) 0.0cm outputinputconnectablestorable
X position of baseOrigin.
baseOriginY (by) distance (double) 0.0cm outputinputconnectablestorable
Y position of baseOrigin.
baseOriginZ (bz) distance (double) 0.0cm outputinputconnectablestorable
Z position of baseOrigin.
targetOrigin (to) double3 outputinputconnectablestorable
When the origin flag is userDefined, the origin of the target is computed with respect to this point.
targetOriginX (tx) distance (double) 0.0cm outputinputconnectablestorable
X position of targetOrigin.
targetOriginY (ty) distance (double) 0.0cm outputinputconnectablestorable
Y position of targetOrigin.
targetOriginZ (tz) distance (double) 0.0cm outputinputconnectablestorable
Z position of targetOrigin.
parallelBlender (pb) bool 0 outputinputstorablehidden
This is true if the blendShape is used to blend parallel deformations.
useTargetCompWeights (itcw) bool true outputinputhidden
This attribute is used internally to enable/disable the use of the per target component weights during evaluation
supportNegativeWeights (sn) bool 0 outputinputstorablehidden
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) doubleArray empty outputinputconnectablehidden
Legacy attribute left in to provide file format compatibility with Maya 2012 Gold/Hotfix 1.