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

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


============================= Archive contents =============================

Original  Packed Ratio    Date     Time    Name
-------- ------- ----- --------- --------  -------------
    3329    1529 54.0% 30-Mar-95 14:10:54 +IIUtilities.Readme
    3284    1346 59.0% 19-Jan-95 02:50:04 +ImTotal
    8444    5102 39.5% 03-Feb-95 13:19:00 +Jitter
    1527     792 48.1% 30-Mar-95 14:13:12 +Jitter.ReadMe
    1235     583 52.7% 14-Jan-95 04:29:28 +ReduceFrames
    4314    1540 64.3% 19-Jan-95 03:35:06 +ShowStage
    6945    2812 59.5% 14-Jan-95 08:36:58 +StageFrames
    3745    1584 57.7% 14-Jan-95 08:38:36 +StageLengthen
    3662    1464 60.0% 18-Jan-95 02:04:38 +StageScale
    3253    1435 55.8% 14-Jan-95 08:36:46 +StageShift
     642     169 73.6% 18-Jan-95 23:45:36 +staging
   18708    9265 50.4% 04-Feb-95 23:02:44 +Stars
    8700    3756 56.8% 30-Mar-95 14:11:04 +Stars.ReadMe
    3329    1529 54.0% 30-Mar-95 14:17:32  IIUtilities13.Readme
-------- ------- ----- --------- --------
   71117   32906 53.7% 01-Apr-95 13:25:26   14 files