TYPE: Object State
TITLE: Paint Capture Layer Operation

The Paint Capture Layer operation allows you to interactively paint the
capture weights of your geometry.

After choosing this operation, your first task is to select the object to
paint, then right-click to complete.

As you move the mouse over the geometry, you will see a circular brush follow
the surface to show where you would paint.  The size of the brush and its
orientation will show you which points will be affected by a paint operation.

Painting is done to the weights of one bone at a time.  You may change which
bone by Ctrl-middle clicking the desired bone.  Ctrl-middle clicking on the
current bone will select the null bone.  Ctrl-left clicking will switch to
the previously selected bone.

The null bone is an imaginary bone that follows the parenting of the object.
Painting with the null bones allows you to create non-normalized capture
weights.  "Normalize Weights" must be turned off in the Deform SOP to see this
effect.

The state's "Visualize OP" parameter specifies which OP to use for computing
the visualization.  When set to "Deform SOP", the visualization is computed
from the capture weights at the Deform SOP.  When set to "Current SOP", the
visualization is computed from the capture weights at Capture Layer Paint SOP
currently being operated upon.

Each of the brushes also can have its own independent operation.  To select the
operation for each brush, use Ctrl-right mouse to bring up the operation menu.
The options are:

- Paint: This paints your new weight onto the geometry.

- Smooth: This smoothly blends the weights of nearby points under the
  brush.

- Smooth Layer: This smoothly blends the weights of nearby points under the
  brush.  This operation only operates on weight in the current layer.

- Smooth Single Bone: This smoothly blends the weights of nearby points under
  the brush.  This operation only smooths the weights for the current bone.

- Reduce: Reduces the capture weights for the currently selected bone by
  introducing more weight to other bones affecting the geometry.

- Erase Changes: This is a local undo - it restores the points under
  your brush to the pre-capturepaint values.

The other important parameters are:

- Visualize: This controls how to display the bone's weightings.  The
  default "bone color" will color each point by the amount each bone
  affects it with that bones color.  This is useful to see what bone
  controls which point.  The "false color" will only show that bone's
  weights, but allow you to tell with greater precision how much any
  point is affected by the bone.

- Radius: The size of the brush.

- Opacity: How strong the brush is.  A fully opaque brush replaces the
  original weight, while a less opaque brush blends it.

The other Ctrl-right mouse menu options are:

- Circle/Square/Bitmap Brush: The shape of the brush.  The bitmap is
  set in the operation parameters dialog.

- Orient Brush To Surface: When disabled, the brush is always oriented
  the same way.  This is useful when painting crinkly geometry.

- Accumulate to Stencil: This advanced option is described in more
  detail in the manual.

See also: Capture Geometry(capturegeometry),
	  Edit Capture Weights(editcaptureweight),
	  Edit Capture Regions(editcaptureregion),
          Mirror Capture Weights(mirrorcapture)
