Houdini 19.5 Shelf tools

Mirror Capture Weights shelf tool

Applies capture weights from one side of a geometry object to another.

On this page


This tool saves you time because you can mirror the capture weights of Bones and muscles on characters instead of creating them twice.

Using Mirror Capture Weights

  1. Click the Mirror Capture Weights tool on the Characters tab.

  2. Select the destination points to mirror the capture weights to and press Enter to confirm your selection.


    You must include the symmetry points as well.

  3. Select the source bones or muscles to mirror from and press Enter to confirm your selection.

  4. Select the destination bones or muscles and press Enter to confirm your selection.

The first image shows the capture weights before using the mirror tool. The second image shows the capture weights after using the mirror tool.


If you do not get the desired results, you can specify the exact bones or muscles to mirror to by clicking the Spreadsheet button on the operation controls toolbar and choosing the corresponding bones or muscles in the drop-down menu.

You can also choose the exact bones or muscles to mirror to by changing the From and To values in the parameter editor. The first item in the From list corresponds with the first item in the To list and so on.

For specific parameter help see the Mirror Capture Weights on one side of a geometry, and have those painted weights applied to the other side.


To perform this operation, you first select the points in your geometry that you wish to mirror. Only points from a single object can be chosen, and the chosen object must have either a Bone Deform SOP or have the boneCapture or metaCapture capture weight attributes. Once the points on this object are chosen, right-click to proceed.


The second step in this operation is to select the source bone or muscle objects whose weights will be mirrored. When you complete the selection of your points, all bones or muscles with non-zero weights on those points are selected automatically. You can either use this default selection, or modify it, then right-click to proceed. Only bones (objects that contain capture regions) and objects that contain metaballs can be included in this selection.


The third step is to choose the destination bones or muscles that will receive the weights from the source bones or muscles selected in Step 2. After selecting source bone or muscle objects, the set of destination objects whose name match names of the source objects will be selected. Matching is performed by trying to replace the prefix of the source objects' names with a different prefix to generate the destination bone names. This tool finds the shortest prefix possible to allow this substitution. Again, you can either accept this default selection, or modify the selection. Right-click to complete the operation.

A Capture Mirror SOP will be created in the object where you are mirroring capture weights. The SOP will be created as the input to the Bone Deform SOP if there is one, or as the end of the SOP chain if there is no Bone Deform SOP. You will be presented with handles that allow you to define the plane through which the capture weights are mirrored.

Shelf tools

Using the shelf

  • Customize the shelf

    How to change the look of the shelf, change and rearrange its contents, and create your own shelf tools.