AnimBrush (Anim Menu)

An animbrush is a special kind of custom brush. It is actually a mini
animation that you can position within a larger screen animation.  This
gives you the ability to create complex movements and effects by simply
drawing with an animated brush.  As you draw with an animbrush, it cycles
through its individual frames.  There are two ways to create an animbrush,
using the `Metamorph` feature or by using the animbrush submenu functions:


LOAD      The "Load Animbrush" requester is displayed. 

          When an animbrush created from a palette different than that of
          the current picture is loaded, the picture palette remains in
          place.  The palette of the animbrush can be used by choosing the
          Palette -> `Use Brush Palette` option from the Color Menu.

SAVE      The "Save Animbrush" requester is displayed.  This requester works
          like the "Save Picture" requester.

     SEE -> `Load Picture` for details on how to use the file requester.

PICK UP   This works like the Brush Selector tool. However, you will be 
          cutting out an area from multiple frames. It is the movement 
          within this area, over successive frames, that will define the
          action of the animbrush. You specify the area you want to cut
          out by dragging out a rectangle. The same conventions used for
          defining regular custom brushes apply; using the left button
          copies the defined area & the right button cuts out (& removes)
          the defined area. A requester will appear. This lets you specify
          the number of frames to cut the animbrush from, starting with 
          the current frame. 

          When painting with an animbrush, all of its frames are cycled
          through as you paint.  Normally, this cycling occurs only on the
          current frame.  Holding down any Alt key will cause the
          individual frames of the animbrush to be painted on successive
          animation frames. This is known as AnimPainting.

          DEMONSTRATION AVAILABLE ->    `AnimBrush_PickUp.sdemo`

SETTINGS  Displays the Animbrush Settings requester:

     SEE ->    `Animbrush.pic`

         DEMONSTRATION AVAILABLE ->    `AnimBrush_Settings.sdemo`

     NUMBER OF CELS      shows you the number of animbrush cels.

     DURATION            the rate at which the animbrush cycles through 
                         its cels.

     CURRENT             sets the starting brush cel used when painting.
    
     DIRECTION           specifies forward, backward, or ping-pong flipping 
                         through the cels of the animbrush as you paint.
        
     7 & 8 KEYS          (along the top of the keyboard; not the Numeric
                         Keypad) allow you to step forward and backward
                         through the cels of the animbrush.  Shift-7 steps
                         to the first animbrush cel and Shift-8 steps to
                         the last cel.

     USE                 Makes the last Animbrush "picked up" the current 
                         brush. This lets you use the last animbrush after
                         having picked up a regular brush.

     FREE                Gets rid of the animbrush and releases all memory
                         associated with it.