Poly Deformer Weights Command

polyDeformerWeights

Synopsis

polyDeformerWeights
    [-destinationDeformer],
    [-destinationMesh],
    [-direction],
    [-flip],
    [-mirror],
    [-sourceDeformer],
    [-sourceMesh]

polyDeformerWeights is undoable, NOT queryable, and NOT editable.

Command to copy, mirror, or flip the deformer weights. The command can be used to copy weights from one mesh to another or to modify weights on the same mesh.

Known Issues

This command is not compatible with deltaMush and shrinkWrap nodes. They are not compatible with the API class used to set weights on deformers.

Long name (short name)	Argument types	Properties
destinationDeformer(dd)	string	[C]
Specifies the deformer to which the weights will be copied. If this flag is not used, the deformer specified by the -sourceDeformer flag will be used.
destinationMesh (dm)	string	[C]
Specifies the destination deformed mesh. If this flag is not used, the mesh specified by the -sourceMesh flag will be used.
direction (d)	int	[C]
Specifies the direction that a mirror operation will occur in. Must be 1 (left to right) or -1 (right to left). Only applicable when the -mirror flag is also used. By default, weights will be mirrored from left to right.
flip (f)	boolean	[C]
When the flip flag is used, the weights of symmetrical vertices are swapped.
mirror (m)	boolean	[C]
When the mirror flag is used, the weights of the vertices on the source side (specified by the -direction flag) are copied to the symmetrical vertices..
sourceDeformer (sd)	string	[C]
Specifies the deformer from which the weights will be copied.
sourceMesh (sm)	string	[C]
Specifies the source deformed mesh.

Examples

This command mirrors the weights on the specified cluster using the pre-computed symmetry data for the specified mesh. If symmetry data has not been computed this command will fail.

polyDeformerWeights -sourceMesh head_MESH -sourceDeformer nose_cluster -mirror;

// This command reflects the weights from one cluster to another on the same mesh.
polyDeformerWeights -sourceMesh head_MESH -sourceDeformer L_mouth_cluster -destinationDeformer R_mouth_cluster -flip;