TYPE: SOP
TITLE: CaptureProximity SOP

CaptureProximity works in conjunction with the Deform operation and the 
CaptureRegion operation by assigning capture weights to points based on their 
distance to the Capture Regions.  The closer the point is to the centre line of
the Capture Region, the stronger the weight will be assigned.

The optional second input can be used to specify extra capture regions to 
process in addition to those in the Object hierarchy.

The location of the capture regions when capturing can be specified in two 
ways: either a capture frame or a capture pose is used. 
Capture frame indicates the frame at which capturing occurs and so 
the relative positions of Capture Regions and objects at that frame
determine how the points of the geometry are captured.  Capture
pose is a time independent arrangement of capture regions (and bones)
and is encoded in capture transform parameters of the
capture regions and bones (see Bone and CaptureRegion for details).  
A preferable method is to use capture pose. 

This operation does will not visibly change the geometry (except to possibly
add point colors for feedback).  To actually change the geometry by animating
the Capture Regions, append a Deform operation.

Typically one or more Capture Regions are placed in an object (usually via 
bones) and named "cregion".  The object is then read into a Proximity Capture 
through the object's hierarchy.  The object is then deformed using the Deform
operation in conjunction with the output from this operation.

Note: When a hip file is loaded, all of the  associated capture regions are 
      evaluated at the capture frame (unless "Use Capture Pose" is turned on).
      Keyframes must be set to position the 
      capture regions properly at the capture frame.  Otherwise, the geometry 
      will be weighted incorrectly upon subsequent file loads.

Parameters:
Group                       - Point group to capture
Capture
    Hierarchy               - Top of the object hierarchy traversed for the
                              Capture Region operations
    Extra Regions           - The list of paths to extra bone objects or capture
                              regions to be used separated by spaces. This list
                              is appended to what the Hierarchy parameter
                              specifies.
    Region SOP              - Specifies the geometry in which to find the
                              Capture Regions
    Traverse into subnets   - If turned on, when traversing the hierarchy for
                              capture regions, also traverse inside object
                              subnets.
    Create Relative Skeleton Root Path - If on, then the internal cregion paths
			      are generated with a skeleton path prefix that is
			      relative to this sop. If off, then the prefix is
			      determined by the longest common object path
			      prefix out of all the capture region paths.
    Use Capture Pose	    - If turned on, the capture parameters of
			      bones and capture regions are used to capture
			      points. This means that the arrangement of
			      bones and the shapes of capture regions
			      are capture frame independent. The capture
			      pose can be viewed by choosing "Settings >
			      Objects > Kinematic Override: capture" from
			      the menu.
    Capture Frame           - Frame number at which to compute the capture 
                              weighting.  This frame will cook slower than 
                              other frames due to the weighting computation.
    Cook at                 - Specifies how often this operation should cook
Weighting
    Weighting Method        - Specifies whether capture regions captured by a 
                              point need to be connected by their objects
    Weight From             - Weight from either the point location or surface
                              location (for NURBS or Bezier surfaces)
    Drop off                - Specifies the strength of the capturing. Larger 
                              values will usually mean that more points are 
                              captured.
    Max. Influences         - Specifies the maximum number of capture regions 
                              that any point will be captured to
    Normalize Weights       - Adjusts the capture weights so they add
                              up to one for every point.  This makes
                              the paint tools easier to use.  For backwards 
                              compatability, this should be changed to off.
    Destroy Existing Weights - Destroy any existing capture weights
    Blend Factor            - If destroy existing weights is off, then this
                              parameter determines the blend factor of the 
                              created capture weights with the existing ones.
Coloring
    Point Coloring          - Adds point color attributes to show the weighting 
                              of the points. The color of each point will be a 
                              blend of the colors of its captured regions.
    Zero Weight Point Color - Color used for points with zero weight

    Force Recapture         - Forces the operation to recapture immediately

See also: Deform, CaptureRegion(cregion), Capture, CaptureEdit, CapturePaint
