This is the ras_track program, and some associated other programs,
files, and libraries.  The ras_track program is a 2D and 3D tracking
package, and the manual for it is on the 'net at

http://www.hammerhead.com/ras_track/ras_track.html


License

The license is a set of 12 pairs of numbers that go into the file

/usr/hammerhead/license/ras_track_key

To get a license, run 'ras_track' and it will print out a ID string.
Mail that to thad@hammerhead.com and I'll mail you a license.


Multipath data files

The ras_track program uses a binary file format, called 'multipath'
to store its motion data.  Included in this package are four
programs that read this data; you can use these programs to get the
useful information out of this datafile.  Alternatively, or in
addition, the multipath library is available to all who purchase
this program; for writing your own multipath programs.

A multipath file is made up of several named 'paths', or splines.
Each of these paths is made up of multiple 'tracks' and 'constants'.
The track is a named list of points over time; along with an
evaluation type associated with each point.

The four associated utility programs are mp_print, mp_eval,
prisms_camera, and track_to_sdl.  The mp_print program prints a path,
or all the paths of a file.  The mp_eval program can be used in a shell
file to evaluate a path at different frames within the sequence.  The
prisms_camera program should print out a text file that can be read
into prisms to position its camera.  The track_to_sdl program creates
ANIM SDL files for reading into Alias.

usage:  mp_print file.mp [path [track [track]]]
which:  prints a path, or all paths, from a mp file
where:  file.mp is the multipath file
        path    is the name of a path in the file
        track   is the name of a track in that path

usage:  mp_eval file.mp pathname trackname [time] [-a min -z max -s step]
which:  evaluates multipath files
where:  file.mp      is a multipath file
        pathname     is the name of the path
        file.mp      is the name of a track or constant
        time         is the time to evaluate the path
                     if no time value given, a constant is evaluated

usage:  mp_scale input.mp output.mp scalefactor [yscale]
which:  scales "x" and "y" tracks of multipath files
where:  input.mp     is the input multipath file
        output.mp    is the output multopath file
        factor       is the scale factor
        yscale       is the scale in y.  Default same as x

usage:  mp_xform input.mp output.mp [pathname [pathname...]][-all] [-tx val] [-ty val] [-sx val] [-sy val] [-rz val]
which:  transforms the x and y coordinates of paths in a multipath file
where:  input.mp     is the input multpath file
        output.mp    is the resulting, transformed multipath file
        -tx val      is an amount to offset in the x direction
        -ty val      is an amount to offset in the y direction
        -sx val      is an amount to scale in the x direction
        -sy val      is an amount to scale in the y direction
        -rz val      is an amount to rotate
        pathname     is the name of a path to transform, also works for roto pathnames
        -all         specifies that all paths with x and y tracks are transformed
        -add_time t  adds 't' to all time tracks
        -scale_time t scales time tracks by t
note: operations are performed in the order they are on the command line

usage:  mp_edit data.mp
which:  allows interactive editing of multipath information
where:	data.mp        is the multipath file that stores track information


