TYPE: CHOP
TITLE: Transform CHOP

This CHOP takes translate, rotate, and/or scale channels and transforms
them using the transform parameters in the CHOP. It can be used to change the
position and orientation of an object; convert a set of transform channels with
a certain transform order into an equivalent set of channels with a different
transform order; and change the direction, starting point and scale of motion
capture data.

At present, only one transform format exists: the transform defined by 12
channels (tx ty tz, rx ry rz, sx sy sz, px py pz) and a transform order.

The Transform CHOP expects the input channels to have names that end in
the above names. Examples are:

~c(
    tx ty tz rx ....    (what you would get from a Fetch CHOP)
    geo1:tx geo1:ty geo1:tz geo1:rx ....
    headtx heaty headtz headrx
~c)


The above defines a transformation matrix, which is then multiplied by the
transform matrix defined on the Transform page, and output as
translate/rotate/etc channels.

To affect only one set of channels coming into the CHOP, use the Scope
parameter.

Parameters
Transform
    Overview - This page defines the matrix used to transform the channels.
		The parameters used to create this matrix are Transform Order,
		Rotate Order, and the Translate, Rotate, Scale and Pivot
		parameters.
    Output Channels   - Currently there is only one output type, 
                        the transformed input channels.
    Matrix Operation  - The input channels can be pre or post
                        multiplied by the transformation.
    Use Rotation Hint - Supply approximate starting values
                        for the rotation channels.

Input
    Overview - This page defines what the incoming channels' transform order is
	       assumed to be. Using the incoming channels and the transform
	       order here, a matrix for the incoming channels is built. It is
	       then multiplied by the transformation matrix defined by the
	       Transform page.  Any missing translation, rotation or scale
	       channels will default to zero (or one in the case of scale).
    Transform Order  - The transform order of the input channels.
    Rotate Order     - The rotation order of the input rotations.

Local Variables
    I   - The current index.

See also: PreTransform
