XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX ANI XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

               A powerful multifunctional animator (HP48)

Our primary aim is to explain the use of ANI to a normal HP48 user. Examples
in this package only demonstrate the power of ANI which itself is a very small
tool for generating very fast and exciting graphic animations. You should load
ANI.zip to your PC since examples in it are different from other animations in
this section.

Speed and direction of the moving pictures are controlled by the arrow keys.
UParrow speeds up, DOWNarrow slows down. NXT is the Stand-by key. With a fast
double-click on NXT one gets the pictures in single steps (scrobe). ANI can
operates in two modes. In the alternating picture mode the grobs change at a
fixed place. In the moving mode, the grobs move over the screen from left to
right or conversely. CANCEL or Backspace abort. The moving direction can be
reversed by pressing RIGHTarrow or any other not yet mentioned key. In either
mode, one or two programs for sounds or other events may be added as described
below and demonstrated by the examples in this package. ANI does not use PICT
nor does it affect any flag or the stack.

ANI has two error-proof list arguments as follows: 

Level 2: a list of at least two grobs of size not greater then 131 x 64.

Level 1: a parameter list { x y ... z } of minimal size 3. The reals or zints
         x,y are the pixel coordinates of the left upper corner of the grobs.
         In alternating mode, x,y are fixed, in moving mode, x,y are the start
         coordinates of the moving pictures. Only x will change its value.
         z may have the values ... -3, -2, -1, 0, 1, 2, 3 ... Put z=0 for the
         alternating picture mode. If z is positive, the grobs move from left
         to right like in HORSE. The absolute value of z is just the picture
         jump. E.g., in ORBIT is z=1 to mean a minimal jump. For negative z,
         grobs move from right to left like in DINO; the moving direction may
         be changed by a key. Dots in the parameter list denote either nothing
         or one or two additional actions or its names, e.g., sounds. The 1st
         evaluates right after the display of the 1st grob. A 2nd action right
         after all other grobs appear on the screen. See the examples below.
       
The examples are SysRPL programs for economy reason only. They generate the 2
argument lists and prepare the screen. All this can be done in UsrRPL as well.
Grob lists or somtimes the whole program are compressed in the examples. To
run them, the BZ-decompressor BZU is included in the package. 

BOY is essentially << GROBLIST { 87 28 Sound 0 } ANI >>. That means the grobs
alternate in fixed position at 87,28 (the left upper grob corner), and just a
single (kick) sound at the begin of each grob cycle.

GIRL is essentially << GROBLIST { 0 0 0} ANI >> which means grobs alternate on
full screen (corner position 0,0). Here the whole program is compressed since
it generates the huge list of eight 131x35 grobs from smaller grob elements.

DINO is essentially << GROBLIST { 4 0 Sound1 Action2 -3 } ANI >>. In addition,
first the screen is prepared by blanking it and writing "Time for breakfast"
on top. Action2 generates a second sound and displays each time it appears on
the screen also the sun&palm picture. This is necessary to ensure that after
the Dino walked over this picture the picture reappears. Here z = -3 means a
start move from right to left with pixel jump 3.

ORBIT is essentially << GROBLIST { 2 1 Action 1 } >>. Here Action is a "sun
displayer". The sun cannot be implanted at the begin but must be regenerated
during earth rotation to see it again after the earth moved on and ceases to
cover it. The GROBLIST steams from hpcalc.org and consist of 15 earth screen
shots of size 64x64 each. In the whole 8 KB uncompressed or 5 KB compressed. 
Anybody who has the patience to complete it to 24 screen shots (the rotation
angle made in 1 hour) is invited to do so. Please mail to me if successfull. 
--------------------------------------------------
 Wolfgang Rautenberg, raut@math.fu-berlin.de  www.math.fu-berlin.de/usr/raut 
      The program ANI (360 bytes, CRC 6B8D) is copyrighted and may not
               be used or transmitted for commercial purposes 

HINT FOR EXPERTs. ANI has 8 nulllams. Most usefull to programmers are Lam4 and
Lam5 (current x- and y-coordinate of moving grob, x is a real, y a bint). All
nulllams may be used in additional programs. In the moving grob mode, ABUFF is
enlarged to size 393x64, with window corner at pixel position 131,0.