Short:        Utilities for use with Imagine. V1.3
Author:       IanSmith@moose.erie.net
Uploader:     IanSmith moose erie net
Type:         gfx/3d
Architecture: m68k-amigaos

Ian's Imagine Utilities: Version 1.3

These 8 utilities will perform usefull (I hope!) operations on Imagine
3.x staging or object files.  All files are ARexx scripts and have the
instructions in the headers except Stars and Jitter which are binaries.

Jitter        - Randomly disturb an objects points.  Like Lightwave.
                Works on all objects in a group and states.

StageFrames   - Increase or descrease the length of an animation
                and automagicly scale the actor bars.  Very useful
                for playback at faster rates or motion blurring.
 ReduceFrames - Used with StageFrames to determine how to reduce.

StageScale    - Increase or decrease every object's size in a scene
                and reposition them.  Used to reduce the rendering
                time for raytracing.

StageShift    - Put X blank frames at the beginning of an animation
                so you can merge two animations. (Needs ISL to merge)

StageLengthen - Add frames to an animation and/or lengthen actor
                bars to the new size.

ImTotal       - Read the IMRT hunk from Imagine's IFF files and
                display rendering time.  Will do wildcards and
                show total and average rendering time.

ShowStage     - Parse a staging file and list every object and brush
                loaded for the entire scene or a single frame.  Shows
                totals for points, lines, faces and bitmap pixels.

Stars         - Generate starfields quickly and easily.  It creates
                a spherical, cubical or torus shaped shell of stars
                with a variable thickness. Stars can be randomly shaped
                colored and sized and made from triangles, cubes or disks.

Send me e-mail if you have any suggestions or bug reports.  If you
make any changes or improvments please send me a copy.  Thanks!

Set the (S)cript bits on the ARexx files if you didn't un-archive
with -A.  (Use "Protect <file> +S") The ARexx scripts are...

ImTotal, ReduceFrames, ShowStage, StageFrames, StageLengthen, StageScale, 
and StageShift.

History
-------
V0.9   Inital release.
V1.0   Added Stars, ParticleStars, ReduceFrames and ShiftFrames.
V1.1   Now including rexxmathlib.library for the sqrt() function.
       You can now randomly vary the sphere size for the stars.
       Stars and ParticleStars write Imagine TDDD binaries now.
       Much smoother star distribution, no more gaps.
V1.2   Stars and Particles stars have been combined and written in
       C and no longer need rexxmathlib.  Stars is much faster, it
       can generate 200-400 stars/sec instead of 7 stars/sec. :-)
       Particle stars are now centered propperly.  Stars are spread
       evenly now. Added ImTotal and ShowStage scripts.
V1.3   Stars can now be made from disks with a user defined number of
       faces.  The stars are rotated to face the objects axis or a
       user defined point.  New torus shape.  Jitter is more random
       and rewritten in C.

See Also:  IITextures.lha - 8 textures for Amiga Imagine 3.x
                            Needs an 68020 or greater and FPU.
--
IanSmith@moose.erie.net (V1.3 : Feb-03-95)
Ian.Smith@f564.n2601.z1.fidonet.org <-- Backup