******************************************************************************
*                                                                            *
*                             Animation Document                             *
*                                                                            *
*                     Belongs To The Scripti Collection                      *
*                                                                            *
*                         By Jan Van Overbeke, 3-DEE                         *
*                                                                            *
*      Read The Doc On The Scripti Collection For More Info About Rights     *
*                                                                            *
******************************************************************************

------------------------------------------------------------------------------
                                    WHAT?
------------------------------------------------------------------------------
With these scripts, you can create HAM8-animations, and save them as OpCode-8.
I myself, don't use these scripts, because I find them dangerous. If something
wrong has occured, ADPro won't tell us what happened. This is a serious
problem when you have 100 frames, which means you waited for 100 images to be
loaded and saved for nothing.

These were the last scripts, so I was a bit lazy, and left the OpCode-feature
out. Not a bad thought, as I say you can't trust these scripts. I repeat: it is
better to create your animations without AREXX.


------------------------------------------------------------------------------
                             AddFrameToAnim.rexx
------------------------------------------------------------------------------
To add your images to the animation, and that counts for all of them EXCEPT
THE LAST ONE, use this script.

I repeat: ALL FRAMES EXCEPT THE LAST ONE !!!!!!!

Useage:
    rx rexx:AddFrameToAnim.rexx <filename> <anim>

If no path is entered for the anim, a path will be added, according to the
image's filename.



------------------------------------------------------------------------------
                            AddLastFrameToAnim.rexx
------------------------------------------------------------------------------
Same description as the previous, but, ONLY USE THE LAST FRAME !!!

I repeat: ONLY USE THE LAST FRAME.

Useage:
    rx rexx:AddLastFrameToAnim.rexx <filename> <anim>

Same no-path-feature as above.



------------------------------------------------------------------------------
                              ExtractFrames.rexx
------------------------------------------------------------------------------
Will extract a number of images from an animation.

Useage:
    rx rexx:ExtractFrames.rexx <anim> <start> <end> <step> <mode>

Where:
    <anim>:  your OpCode-5 or OpCode-8 animfile.
    <start>: first frame-number to extract, where to start FROM.
    <end>:   last frame-number to extract, where to END.
    <step>:  extract each <step>.
    <mode>:  RAW to save as 24Bit
             IMAGE to save as an IFF (if possible (!) )

Example:
    ram:anim is a 10-frame OpCode-5 animation.

    rx rexx:ExtractFrames.rexx ram:anim 1 10 1 IMAGE

        will extract all frames and saves them as IFF.

    rx rexx:ExtractFrames.rexx ram:anim 1 10 2 RAW

        will extract from frame 1 to 10 by 2 steps and saves them as 24bit.
        frames 1 3 5 7 and 9 will be extracted.


------------------------------------------------------------------------------
                                  THE END
------------------------------------------------------------------------------



Jan Van Overbeke.