pymel.core.animation.copyDeformerWeights

static animation.copyDeformerWeights(*args, **kwargs)

Command to copy or mirror the deformer weights accross one of the three major axes. The command can be used to mirror weights either from one surface to another or within the same surface.

Flags:

Long name (short name)		Argument Types	Properties
destinationDeformer (dd)		unicode
	Specify the deformer used by the destination shape
destinationShape (ds)		unicode
	Specify the destination deformed shape
mirrorInverse (mi)		bool
	Values are mirrored from the positive side to the negative. If this flag is used then the direction is inverted.
mirrorMode (mm)		unicode
	The mirrorMode flag defines the plane of mirroring (XY, YZ, or XZ) when the mirror flag is used. The default plane is XY.
noMirror (nm)		bool
	When the no mirror flag is used, the weights are copied instead of mirrored.
smooth (sm)		bool
	When the smooth flag is used, the weights are smoothly interpolated between the closest vertices, instead of assigned from the single closest.
sourceDeformer (sd)		unicode
	Specify the deformer whose weights should be mirrored. When queried, returns the deformers used by the source shapes.
sourceShape (ss)		unicode
	Specify the source deformed shape
surfaceAssociation (sa)		unicode
	The surfaceAssociation flag controls how the weights are transferred between the surfaces: closestPoint, rayCast, or closestComponent. The default is closestComponent.
uvSpace (uv)		unicode, unicode
	The uvSpace flag indicates that the weight transfer should occur in UV space, based on the source and destination UV sets specified. Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.copyDeformerWeights

Example:

import pymel.core as pm

# Create plane and a cluster.
#
pm.file( f=True,new=True )
pm.polyPlane( ch=1, w=10, h=10, sx=5, sy=5, ax=(0,1,0) )
pm.cluster( n='testCluster', 'pPlane1' )
# Modify some weights on the -x side of the character
#
pm.select( ['pPlane1.vtx[0]', 'pPlane1.vtx[6]', 'pPlane1.vtx[12]', 'pPlane1.vtx[18]'])
pm.percent( 'testCluster', v='0.5' )
# Mirror the skin weights to the other side of the character
# Mirror inverse is chosen since we want to go from -x to +x, not +x to -x.
#
pm.copyDeformerWeights( ss='pPlane1', ds='pPlane1', sd='testCluster', mirrorMode='YZ', mirrorInverse = True)
pm.select( ['pPlane1.vtx[5]', 'pPlane1.vtx[11]', 'pPlane1.vtx[17]', 'pPlane1.vtx[23]'])
pm.percent( 'testCluster', q=True, v=True )