substituteGeometry

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

Synopsis

substituteGeometry [-disableNonSkinDeformers boolean] [-newGeometryToLayer] [-oldGeometryToLayer] [-reWeightDistTolerance float] [-retainOldGeometry]

substituteGeometry is undoable, NOT queryable, and NOT editable.

Return value

Keywords

Flags

Long name (short name)	Argument types	Properties
-disableNonSkinDeformers(-dnd)	boolean
This flag controls the state of deformers other than skin deformers after the substitution has taken place. If the flag is true then non-skin deformer nodes are left in a disabled state at the completion of the command. Default value is false.
-newGeometryToLayer(-ngl)
Create a new layer for the new geometry.
-oldGeometryToLayer(-ogl)
Create a new layer and move the old geometry to this layer
-reWeightDistTolerance(-wdt)	float
Specify the distance tolerance value to be used for retargeting weights. While transferring weights the command tries to find the corresponding vertices by overlapping the geometries with all deformers disabled. Sometimes this results in selection of unrelated vertices. (Example when a hole in the old geometry has been filled with new vertices in the new geometry.) This distance tolerance value is used to detect this kind of faults and either ignore these cases or to vary algorithm to find more corresponding vertices.
-retainOldGeometry(-rog)
A copy of the old geometry should be retained

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

// substitute the smooth skinned outPutGeom with newInputShape.
//
substituteGeometry outPutGeom newInputShape ;