TYPE: SOP
TITLE: Capture Mirror SOP

Capture Mirror mirrors capture attributes from one half of a symmetrical model
to another.  A correspondence is established between each point of the
source side of the model (the side in which the arrow is on) with the
closest mirrored point on the destination side.

The From and To fields specify a list of capture regions that are to
be mirrored.  Both the from and to list orders are important.  For
example, to mirror the right arm to the left arm one might have:

~c(
From: "ruparm/cregion 0" "rlowarm/cregion 0" "rhand/cregion 0"
To:   "luparm/cregion 0" "llowarm/cregion 0" "lhand/cregion 0"
~c)

Parameters:

    Group        - Specifies a subset of points to affect.
    Use Group As - Specifies whether the Group field specifies the set
                   of source or destination points.
    Behavior     - How to treat unspecified capture regions. These
		   also change the behaviour of the capturing.  Each
		   choice is associated with a different workflow.
	Copy	 - With this option, the destination point's capture
		   weights are replaced by the source point's weights.
		   Any "from" bone is changed to a "to" bone and
		   vice-versa.  This operation is only done to one
		   side of the model, the side the mirror arrow points
		   away from. 

		   This choice is best when one has one side of the
		   model properly weighted and wishes to recreate the
		   weights on the other side.
	Leave    - This option processes all selected points.  All of
	           the point's to bone weights are deleted, and then 
		   the mirror point's from bone weights are copied in,
		   after being properly converted to to bones.

		   This choice is best when one has the from bones
		   properly weighted and wishes to create the to bones
		   to be symmetric copies.  It does not affect
		   bone weights unlisted.
	Average  - This option processes all selected points.  The
		   points weights are added to the weights of it's
		   mirror point, after the mirror point's bones have
		   under gone the from->to and to->from conversion.
		   The points capture weights are then normalized.

		   This choice is best when combining the above
		   workflows.  It ensures a symmetrical weighting and
		   does not damage cross-boundary feathering.  One
		   should note that *all* of the models weights are
		   used - spurious weights will be spread to the other
		   side of the model.
    Origin       - The origin of the reflection plane.		/origin{x,y,z}
    Distance     - Distance to move reflection plane.		/dist
    Direction    - Direction of the reflection plane's normal.
                   This normal should face the source points when
                   "Copying" unspecified capture regions.	/dir{x,y,z}
    From         - This is a space delimmitted list of /obj relative
                   paths of capture regions to act as the source side
                   bones.
    To           - This is the same as From, but specifies the
                   destination bones.  The two lists form a one-to-one
                   correspondence so their order is important.

See also: Capture
