copyDeformerWeights

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

Synopsis

copyDeformerWeights [-destinationDeformer string] [-destinationShape string] [-mirrorInverse] [-mirrorMode string] [-noMirror] [-smooth] [-sourceDeformer string] [-sourceShape string] [-surfaceAssociation string] [-uvSpace string string]

copyDeformerWeights is undoable, queryable, and editable.

Return value

In query mode, return type is based on queried flag.

Keywords

Flags

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

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 plane and a cluster.
//
file -f -new;
polyPlane -w 10 -h 10 -sx 5 -sy 5 -ax 0 1 0 -ch 1;
cluster -n "testCluster" pPlane1;
// Modify some weights on the -x side of the character
//
select pPlane1.vtx[0] pPlane1.vtx[6] pPlane1.vtx[12] pPlane1.vtx[18];
percent -v 0.5 testCluster;
// 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.
//
copyDeformerWeights -ss pPlane1 -ds pPlane1 -sd testCluster -mirrorMode YZ -mirrorInverse;
select pPlane1.vtx[5] pPlane1.vtx[11] pPlane1.vtx[17] pPlane1.vtx[23];
percent -q -v testCluster;