RunAnim by Stuart "Bonez" MacLean (25/10/95).

          e-mail: smaclean@cs.strath.ac.uk

Instructions:

Disclaimer : The author of this program (Stuart MacLean)
cannot be held liable or responsible for any damage to
both software and hardware that is caused by usage of
this program. 

-I hate that bit but you have to cover your backside
 properly in the 1990's-

Copyright and Distrubtion : This program is public
domain and hence may not be sold for a propet without
the written consent of the author. Distribute it to
anyone you like on the condition you include this 
documentation with the program.

About RunAnim: This is an animation runner for AGA or 68020
processor based machines with two major differences. The
first is the coppermode. The point of this is
that people can watch small size animations on the
full screen. The second was to include a module player so
you can listen to your module while watching the animation.

Usage:- CLI>RunAnim <-c> <-r frames_per_second>
            <-w new_width> <-h new_height> iff_anim_filname
            <p61_filename>

The options

-c : The animation player can run in one of two modes.
     i) The standard anim format in which you see the
     animation playing normally its orginal screen
     mode.
     ii) The lovely hardware hitting copperlist screen
     mode which is the one you requested. The -c option
     will activate this mode otherwise it will play in
     normal mode.

N.B. The copper player will only work for colour anims
and not HAM ones.

-r frames_per_second : This is simply the option to
     control the frame rate.

-w new_width : I realised a problem with programs that
     save their anims of which although they may have
     a small picture e.g. 64*64 but which maybe drawn
     on a larger bitmap e.g. 320*256. So when it comes
     to rescaling it for running in copper mode it will
     scale the 320*256 bitmap instead of the 64*64
     picture. So the solution is for you to tell it the
     width to rescale to for playing in the coppermode.
     Without this the purpose of the coppermode for
     playing small scale animations might have been lost.
     Note this option only works for the coppermode player.

N.B. Rescaleing works from the top-left corner of the bitmap.

-h new_height : Exactly the same as the -w option but
     deals with the height.

The files

The first file to type in is the name along with path
directory, e.g. dh1:animations/fish.anim, of the
animation that you wish to view.

The second file name is optional and is the name of
a P61 module file. Unfortunately I didn't have any
protracker source code which worked well enough to play
the more complex modules. But as soon as I have a copy
I will compile it into this program and re-realise it.
The P61 Protracker to P61 Player format can be found
in the music appilication draw of aminet.


The program doesn't have an error detector but if the
animation doesn't load there is either not enough memory,
the name of the file is wrong, or that the animation file
is not of the write format - most likely.

History and About the Author:

This program was orginially to be a small utility for
my musician (Feekzoid "Big Boss Man") because he wanted
to watch animations and listen to his modules at the
sametime. So I started to write this program. As the program
went on I wanted to make it for everyone to use and also
keep it independent of any software libraries such iff.library
or iffparse.library and allow it to run completely on its
own. So I set about makeing this program with finding all
the depacking IFF ANIM alogrithims and then put it
together and checked it for bugs. Well it took about a month
to complete (I know that is a long time but I have been busy
with starting university again : 2nd year Computer Science
and Mathematics at Strathclyde Univeristy). For those of
you who have seen the Phoenix 2.0 (on aminet:demo/aga/Phoenix.lha
or I have been informed it is on CU Amiga CD for the November 1995
addition) I am still working on the Phoenix 3.0 which is
going to be 1000000% better.

Greetings to :

Feekzoid (Old Chum and Great Musician).
Shamus (Strange blonde haired person! That is as in Shamanitis).
Krom (He's a strong god! And do you believe in Krom? - Is not
      a recommended chat up line.)
Kris (T-total type story writer.)
Kenz (I look forward to meeting you sir! - Friend of Feekzoid).
John Hendirix (Thanks for the help with Phoenix).
Chris (Keep the texture map site going).
and other people whom I have met and chatted to on the internet.
I really need to get to one of those demo parties.  But I need
a demo - SHAMUS (finish the graphics PLEEEEEEEEAAAAAAASEE!!!)
At this moment I feel like Sandra Bullock's character from her
film The Net but a male version at that. 
...Greetings to Mother Tereisa, Jona of Arc, Bob, Cutty Sark,
Data, Commander Sinclair (I think B5 is better than Star Trek)
and God.

Special acknowledgments to Jarno Paananen of Sahara Surfers for
the creation and use of their P61 player code.

I better get to bed I have to be up at 6:00am tomorrow for
Uni.

So long and thanks for all the fish!!!

Bonez. e-mail at smaclean@cs.strath.ac.uk