TYPE: CHOP
TITLE: Object CHOP

This CHOP compares two objects and returns information on their relative
positions and orientations. The information that can be output is:

~c(
                Position - The displacement from the reference object to
                           target object.
                Rotation - The orientation difference from the reference
                           object to the target object.
                 Bearing - The rotation necessary for the reference object
                           to be facing the target object.
    Single Bearing Angle - An angle representing where the target object 
                           is relative to the reference object. Zero
                           degrees is directly in front, 90 degrees is
                           beside and 180 degrees is behind. 
                Distance - The distance between the two objects.
Inverse Square Distance  - The inverse squared distance between the two
                           objects, useful for modeling electric forces,
                           audio dropoff and gravity.
   Position and Rotation - Both Position and Rotation information.
   Full Transform	 - Position, Rotation, and Scale information.
~c)

The optional two inputs allow you to compare raw points with objects or each
other. The inputs are expected to have three channels containing XYZ points.
These inputs replace the target and/or reference objects. Object and points
can be compared with each other, but "Rotation" mode will always return zero.

There are no local variables.

Parameters
Object
    Target Object     - The object that is being compared to
			the reference object.
    Name              - Specify the target using a string.
    Reference Object  - The object that acts as the basis for
			the comparison.
    Name              - Specify the reference using a string.
    Compute           - The information to output from the
			objects, as listed above.
    Rotate Order      - The rotation order to use for
			"Rotation" or "Bearing" computation.
    Bearing Reference - Bearing requires a direction to use
			as a reference base.
    Bearing Vector    - An arbitrary base direction for     /bearingx y z
			the bearing calculation.
    Point Scope       - When one of the optional point inputs
			is connected, this determines which
			channels represent X, Y and Z.

Channel
    Channel Names   - Sets how the output channels are named. A : is 
		      placed in the channel name where / is in the path.
	Channel Name         - Only use the name of the channel.
	Target and Channel Names - Include the name of the target with
			       the channel name, separated by a colon (:).
	Reference and Channel Names - Include the name of the reference with
			       the channel name, separated by a colon (:).

    Channel Range   - Indicates how much of the channel to fetch.
	Use Full Animation Range - All of the animated range.
	Use Current Frame        - Only the sample at the 
				   current frame.
	Use Start/End            - Specify the range below.

    Start           - The start time of the desired interval    /start
		      of the object path.
    End             - The end time of the desired interval      /end
		      of the object path.
    Extend Left     - The left extend conditions.
    Extend Right    - The right extend conditions.
    Default Value   - The default value for extend conditions.  /defval

See also: Handle
