.. |paint_primvar_icon| image:: ../../images/tools/paint_primvar_tool/paint_primvar_icon.png

Paint Primvar Tool
==================

The |paint_primvar_icon| Paint PrimVar tool allows you to directly manipulate the values of primitive variables (PrimVars) 
associated with the vertices of a mesh. This tool provides a visual way to add artistic effects, 
control material properties, or create procedural variations.

.. image:: ../../images/tools/paint_primvar_tool/paint_primvar_demo.gif
        :align: center

To utilize the Paint PrimVar tool, begin by selecting the mesh you wish to modify. Once selected, 
click on the |paint_primvar_icon| Paint PrimVar tool icon on the Shelf panel. Once the Paint Primvar tool is selected use the
Tool Settings Panel to control its parameters.

Paint Primvar Tool Settings
---------------------------

**Mode:**

* **Add:**  Adds the paint value to the existing PrimVar value.
* **Set:**  Sets the PrimVar value to the paint value, overriding existing values.
* **Smooth:**  Blends the paint value with existing PrimVar values.

**Primvar:**

* Select the specific PrimVar you want to paint on.

**Value:**

* Select a color or other value to paint with. This will depend on the type of the selected PrimVar.

**Radius:**

* Adjust the radius of the brush to control the area affected by each brush stroke.

**Falloff:**

* Control how the brush's influence fades away from the center. A higher falloff value will create a smoother transition.