Go to: Synopsis. Return value. Flags. MEL examples.

Synopsis

deformableShape [-chain] [-createOriginalGeometry] [-createTweakNode] [-createUpstreamTagInjectionNode] [-deformShapeInAttr] [-deformShapeOutAttr] [-frontOfChain] [-localShapeInAttr] [-localShapeOutAttr] [-nodeChain] [-originalGeometry] [-outputPlugChain] [-plugChain] [-supportsComponentTags] [-tagInjectionList] [-tagInjectionNode] [-tweakNode] [-upstreamTagInjectionNode] [-worldShapeOutAttr] [objects...]

deformableShape is undoable, NOT queryable, and NOT editable.

This command finds information about deforming shape(s).

If no shapes are specified on the command then the curently selected shapes are used.

Return value

None

Flags

chain, createOriginalGeometry, createTweakNode, createUpstreamTagInjectionNode, deformShapeInAttr, deformShapeOutAttr, frontOfChain, localShapeInAttr, localShapeOutAttr, nodeChain, originalGeometry, outputPlugChain, plugChain, supportsComponentTags, tagInjectionList, tagInjectionNode, tweakNode, upstreamTagInjectionNode, worldShapeOutAttr
Long name (short name) Argument types Properties
-chain(-ch) create
This flag will return the list of deformers that deformer the specified shapes
-createOriginalGeometry(-cog) create
This creates an original geometry for the shape if it does not exist yet.
-createTweakNode(-ctw) create
This creates a traditional tweak node if one did not exist yet.
-createUpstreamTagInjectionNode(-cti) create
This creates an upstream component tag injection node if an editable one does not exist yet.
-deformShapeInAttr(-dsi) create
Returns the name of deform shape in attribute
-deformShapeOutAttr(-dso) create
Returns the name of deform shape out attribute
-frontOfChain(-foc) create
This flag will return the name of the plug on a shape node at the front end of the deformation chain. This can return an empty plug when none exists.
-localShapeInAttr(-lsi) create
Returns the name of local shape in attribute
-localShapeOutAttr(-lso) create
Returns the name of local shape out attribute
-nodeChain(-nch) create
This flag will return the list of nodes through which the geometry passes to get to this shape
-originalGeometry(-og) create
This flag will return the name of a plug on a node in the deformation chain (likely at the front end) that is the best candidate to be used as the originalGeometry. This can return an empty plug when none exists.
-outputPlugChain(-och) create
This flag will return the list of output plugs leading to the shape
-plugChain(-pch) create
This flag will return the list of plugs leading to the shape (both input and output plugs)
-supportsComponentTags(-sct) create
Returns whether the shape supports component tags
-tagInjectionList(-til) create
This flag will return the list of nodes which are non-procedural componentTag injection nodes
-tagInjectionNode(-ti) create
This flag will return the name of the non-referenced component tag injection node as high up in the deformation chain as possible. This can be the same as the input shape or an empty string when none exists.
-tweakNode(-tw) create
This flag will return the name of the tweak node in the deformation chain. This can return an empty string when none exists.
-upstreamTagInjectionNode(-uti) create
This flag will return the name of the non-referenced component tag injection node most upstream from (but not including) the input shape. This can be an empty string when none exists. If so, one can be created using the cti/createUpstreamTagInjectionNode flag.
-worldShapeOutAttr(-wso) create
Returns the name of world shape out attribute
Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can be used more than once in a command.

MEL examples

    // Create an original geometry if it does not exist
    deformableShape ball -cog

    polyCylinder -r 1 -h 6 -sx 4 -sy 5 -sz 1 -name myGeo;
    select myGeo.vtx[12:23] myGeo.vtx[25];
    string $clusterList[]=`cluster`;
    move -absolute 1.0 0 0 $clusterList[1];

    // Get the node chain leading up to the shape
    deformableShape -nch myGeoShape;
    // Result: polyCylinder1 myGeoShapeOrig groupParts2 tweak1 cluster1GroupParts cluster1 myGeoShape //

    // Get the deformer chain leading up to the shape
    deformableShape -ch myGeoShape;
    // Result: tweak1 cluster1 //

    // Get the plug chain leading up to the shape
    deformableShape -pch myGeoShape;
    // Result: polyCylinder1.output myGeoShapeOrig.inMesh myGeoShapeOrig.worldMesh[0] groupParts2.inputGeometry groupParts2.outputGeometry tweak1.input[0].inputGeometry tweak1.outputGeometry[0] cluster1GroupParts.inputGeometry cluster1GroupParts.outputGeometry cluster1.input[0].inputGeometry cluster1.outputGeometry[0] myGeoShape.inMesh //

    // Get the output plug chain leading up to the cluster
    deformableShape -och myGeoShape;
    // Result: polyCylinder1.output myGeoShapeOrig.worldMesh[0] groupParts2.outputGeometry tweak1.outputGeometry[0] cluster1GroupParts.outputGeometry cluster1.outputGeometry[0] //