pymel.core.animation.deformerWeights

deformerWeights(*args, **kwargs)

Command to import and export the deformer weights to simple XML file. The Weight data is store in a per vertex fashion and reference into a point cloud of vertex data coming from the input geometry of the the deformer. For example a cluster deformer would have the following information: On import the weights are then maped back to the given deformer based on the method.

Flags:
  • deformer : df (unicode) [create,query,edit]

    Specify the deformer whose weights should be exported or imported.

  • export : ex (bool) [create,query,edit]

    Export the given deformer

  • ignoreName : ig (bool) [create,query,edit]

    Ignore the names of the layers on import, just use the order of the layers instead. This can be used for case that joint names have been changed. Leaving it on only name that match on import will be write to the deformer. Flag can have multiple arguments, passed either as a tuple or a list.

  • im : im (bool) [create,query,edit]

    Import the given file to place weight on the listed deformer. See the method flag for details on the weights will be mapped to the destination deformer.

  • method : m (unicode) [create,query,edit]

    Set the method for find the weight of a given vertex on import. indexmethod uses the vertex index to map the weights onto the object. This is used when the object share the same topology as the exported data. nearestmethod find the nearest vertex in the imported data set and set the weight value to that value. This is best used when mapping a higher resolution mesh to a lower resolution. barycentricmethod is only support with polygon meshes. It finds the nearest triangle of the target geometry and rescales the weights by how close the source point is the the vertices. This is normally used with course mesh being mapped to a high resolution mesh. Note that the geometry being used is not the shape node but rather the incoming geometry to the deformer. In the case of a skin cluster this would be that bind pose.

  • path : p (unicode) [create,query,edit]

    The path to the given file. Default to the current project.

  • shape : sh (unicode) [create,query,edit]

    Specify the source deformed shape. CURRENTLY NOT SUPPORTED!

Derived from mel command maya.cmds.deformerWeights

Previous topic

pymel.core.animation.deformer

Next topic

pymel.core.animation.deviceManager

Core

Core Modules

Other Modules

This Page