blendShape

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.

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 (78)

The following quick index only shows top-level attributes (too many attributes to show them all): baseOrigin (3), deformationOrder, icon, inbetweenInfoGroup (8), inputTarget (31), localVertexFrame, midLayerId, midLayerParent, nextNode, nextTarget, offsetDeformer (3), origin, paintWeights, parallelBlender, parentDirectory, supportNegativeWeights, symmetryEdge, targetDirectory (6), targetOrigin (3), targetParentVisibility, targetVisibility, topologyCheck, useTargetCompWeights, weight

Long name (short name)	Type	Default	Flags
baseOrigin (bo)	double3
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 X position of baseOrigin.
baseOriginY (by) distance (double) 0.0cm Y position of baseOrigin.
baseOriginZ (bz) distance (double) 0.0cm Z position of baseOrigin.
deformationOrder (dfo)	enum	0
kPreDeformation: The blendshape is created before any exsiting deformers. kPostDeformation: The blendshape is created before the mesh shape.
icon (icn)	string	nullptr
The name of a file containing an icon per target shape (not currently supported).
inputTarget (it)	compound	n/a
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 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 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 nullptr The target geometry input inputRelativePointsTarget (irp) pointArray nullptr Relative delta values for points in a target geometry. inputRelativeComponentsTarget (irc) componentList nullptr Component list for points with delta relative to hero target in a target geometry. inputPointsTarget (ipt) pointArray nullptr Delta values for points in a target geometry. inputComponentsTarget (ict) componentList nullptr Component list for points in a target geometry. targetWeights (tw) float 1.0 The weights themselves, in the same order as the components deformed by the deformation. normalizationId (nid) integer 0 The ID of the normalization group that includes this target, or zero for no normalization. postDeformersMode (pdm) enum 0 kNone: The normal case, delta is not encoded neither tangent space nor transform space. kTangentSpace: The delta will become relative to the tangent space of the surface, when the mesh rotates the target will still lock "correct" in that the delta is relative to the movement of the surface. kTransformSpace: The delta will become relative to transform space. targetBindMatrix (bmx) matrix identity The inclusive matrix inverse of the driving transform at the time of bind. targetMatrix (tmx) matrix identity Driving transforms matrix.
baseWeights (bw) float 1.0 The weights associated with the base shape, in the same order as the components deformed by the deformation.
normalizationGroup (ng) compound n/a Bundled group of normalization information for a particular normalization group ID. normalizationUseWeights (nuw) bool false Controls whether this normalization group uses the normalizationWeights in the normalization calculation. normalizationWeights (nw) float 1.0 The normalization weights, in the same order as the components deformed by the deformation.
paintTargetWeights (pwt) float 1.0 Temporarily stores the weights for one of the targets during painting.
paintTargetIndex (pti) integer 0 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.
sculptTargetIndex (sti) integer -1 Tracks which target is being sculpted.
sculptInbetweenWeight (siw) double -1.0 Tracks which inbetween target is being sculpted.
sculptTargetTweaks (stt) compound n/a Temporarily stores tweak values for input targets vertex (vt) float3 amounts to move the vertices xVertex (vx) distance (float) 0.0cm X value of a vertex yVertex (vy) distance (float) 0.0cm Y value of a vertex zVertex (vz) distance (float) 0.0cm Z value of a vertex controlPoints (cp) double3 amounts to move the control points xValue (xv) distance (double) 0.0cm X value of a control point yValue (yv) distance (double) 0.0cm Y value of a control point zValue (zv) distance (double) 0.0cm Z value of a control point
deformMatrix (dmx) 4dDblMatrixArray nullptr Temporarily stores matrix for inverting delta
deformMatrixModified (dmxm) bool false Mark the deform matrix has been modified or not
inbetweenInfoGroup (ibig)	compound	n/a
The array of inbetween target group
inbetweenInfo (ibi) compound n/a The array of inbetween target item inbetweenTargetType (ibtt) enum 0 Describe the inbetween target item is relative to hero target or not. Valid values are 0 = "absolute", 1 = "relative". inbetweenTargetName (ibtn) string TmultiSharedObject::create<TdataString>"IB" The name of inbetween target item interpolation (itp) enum 0 The type of interpolation interpolationCurve (itc) float2 The control points array of interpolation curve. curvePosition (cvp) float 0 The position of control point in interpolation curve. curveValue (cvv) float 0.5 The value of control point in interpolation curve. inbetweenVisibility (ibvs) bool true Visibility of the inbetween target
localVertexFrame (lvf)	bool	true
Use local vertex frame instead of the maya tangents for tangent space target.
midLayerId (mlid)	integer	INT_MIN
The ID to identify this node in shape editor midlayer
midLayerParent (mlpr)	integer	-1
Parent directory of the node in the midLayer
nextNode (nxnd)	integer	INT_MIN
Next node or directory in the midLayer directory
nextTarget (nxtg)	integer	INT_MIN
Next target or directory in the directory
offsetDeformer (ofm)	double3
Temp offset for calculating deform matrix
offsetX (ofx) distance (double) 0.0cm Offset X value
offsetY (ofy) distance (double) 0.0cm Offset Y value
offsetZ (ofz) distance (double) 0.0cm Offset Z value
origin (or)	enum	1
Specifies the space in which point deltas are calculated. Valid values are 0 = "world", 1 = "local", 2 = "user".
paintWeights (ptw)	doubleArray	empty
Legacy attribute left in to provide file format compatibility with Maya 2012 Gold/Hotfix 1.
parallelBlender (pb)	bool	0
This is true if the blendShape is used to blend parallel deformations.
parentDirectory (pndr)	integer	-1
Parent directory of the target
supportNegativeWeights (sn)	bool	0
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.
symmetryEdge (syme)	string	TmultiSharedObject::create<TdataString>""
The symmetry edge of each input geometry
targetDirectory (tgdt)	compound	n/a
The array of shape editor target directories
childIndices (cid) intArray empty Child directory and target indices of the directory
parentIndex (pnid) integer 0 Parent directory of the directory
directoryName (dtn) string TmultiSharedObject::create<TdataString>"Group" The directory name
directoryVisibility (dvs) bool true Visibility of the directory, or visibility of the blendShape node if multiIndex of targetDirectory is 0.
directoryParentVisibility (dpvs) bool true Visibility of the directory parents, or visibility of the blendShape parents if multiIndex of targetDirectory is 0.
directoryWeight (dwgh) float 1 Weight of the directory
targetOrigin (to)	double3
When the origin flag is userDefined, the origin of the target is computed with respect to this point.
targetOriginX (tx) distance (double) 0.0cm X position of targetOrigin.
targetOriginY (ty) distance (double) 0.0cm Y position of targetOrigin.
targetOriginZ (tz) distance (double) 0.0cm Z position of targetOrigin.
targetParentVisibility (tpvs)	bool	true
Visibility of the target parents
targetVisibility (tgvs)	bool	true
Visibility of the target
topologyCheck (tc)	bool	true
Should the deformation check to see if the input topologies match?
useTargetCompWeights (itcw)	bool	true
This attribute is used internally to enable/disable the use of the per target component weights during evaluation
weight (w)	float	0
The array of weight values (one per target shape)