pymel.core.animation.substituteGeometry

substituteGeometry(*args, **kwargs)

This command can be used to replace the geometry which is already connected to deformers with a new geometry. The weights on the old geometry will be retargeted to the new geometry.

Flags:
Long name (short name) Argument Types Properties
disableNonSkinDeformers (dnd) bool ../../../_images/create.gif
 

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) bool ../../../_images/create.gif
 
Create a new layer for the new geometry.
oldGeometryToLayer (ogl) bool ../../../_images/create.gif
 
Create a new layer and move the old geometry to this layer
reWeightDistTolerance (wdt) float ../../../_images/create.gif
 

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.Flag can appear in Create mode of commandFlag can have multiple arguments, passed either as a tuple or a list.

retainOldGeometry (rog) bool ../../../_images/create.gif
 
A copy of the old geometry should be retained

Derived from mel command maya.cmds.substituteGeometry

Example:

import pymel.core as pm

# substitute the smooth skinned outPutGeom with newInputShape.
#
pm.substituteGeometry( 'outPutGeom', 'newInputShape' )

Previous topic

pymel.core.animation.sound

Next topic

pymel.core.animation.tangentConstraint

Core

Core Modules

Other Modules

This Page