.. _sec-zRivetToBone:

zRivetToBone
------------

A deformer for riveting curve CVs to bone meshes.


Use this to drive :ref:`sec-zLineOfAction` curves.
Some built-in Maya techniques for doing this create cycles in the Dependency Graph, 
which can make simulation results incorrect.
This node and its command should not introduce cycles.
Furthermore, having this node as a standardized approach for driving :ref:`sec-zLineOfAction` curves
simplifies scripting and improves script portability.

This node can only be created with the :ref:`sec-zRivetToBoneCmd` command.
That command intializes the internal hidden information to control the bind.
To modify the rivet node in any way, delete the node and create a new one.

+--------------------------+--------------------------------------------------------------------------------+
| Attribute                | Meaning                                                                        |
|                          |                                                                                | 
+==========================+================================================================================+
| **envelope**             | Interpolates between no effect (0) and the riveted positions (1).              |       
+--------------------------+--------------------------------------------------------------------------------+
| **cvIndices**            | List of which CVs on the curve the rivet is affecting.                         |
|                          | This list cannot be modified. It is set at bind time.                          |
+--------------------------+--------------------------------------------------------------------------------+
| **rivetMesh**            | The (bone) mesh that's driving the deformation.                                |
+--------------------------+--------------------------------------------------------------------------------+
| **segments**             | A list of points. Each consecutive pair of points forms a segment between a    |
|                          | riveted CV and the anchor point on the mesh that is is riveted to.             |
|                          | This is here for visualization purposes.                                       |
+--------------------------+--------------------------------------------------------------------------------+