Go to: Synopsis. Return value. Keywords.
Flags. Python
examples.
substituteGeometry([disableNonSkinDeformers=boolean],
[newGeometryToLayer=boolean],
[oldGeometryToLayer=boolean],
[reWeightDistTolerance=float],
[retainOldGeometry=boolean])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
substituteGeometry is undoable, NOT queryable, and NOT
editable.
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.
| string |
Name of shapes that were replaced |
deformers, replace, geometry, skin
disableNonSkinDeformers,
newGeometryToLayer, oldGeometryToLayer, reWeightDistTolerance, retainOldGeometry
| Long name (short name) |
Argument types |
Properties |
retainOldGeometry(rog) |
boolean |
 |
|
A copy of the old geometry should be retained |
|
oldGeometryToLayer(ogl) |
boolean |
|
|
Create a new layer and move the old geometry to this layer |
|
newGeometryToLayer(ngl) |
boolean |
|
|
Create a new layer for the new geometry. |
|
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. |
|
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. |
|
| 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 have multiple arguments, passed
either as a tuple or a list. |
import maya.cmds as cmds
# substitute the smooth skinned outPutGeom with newInputShape.
#
cmds.substituteGeometry( 'outPutGeom', 'newInputShape' )