    -------------------------------------------------------------------------
    INTRODUCTION
    -------------------------------------------------------------------------

    Many 'trashcans' using 'APPWINDOWS' or 'APPICONS' usually have only
    one picture associated with them: a trashcan!.  'Nebula' is the
    first ANIMATED TRASHCAN!  You can provide your own picture, animation
    & sounds!  Try the 'Nebula' example for some space action!  'Nebula'
    will sit on your WORKBENCH screen, just doing it's thing, until
    you drop an icon on it!  'Nebula' is easy to use!  For best results,
    use your own animation.  How about a true spiralling black hole
    instead of a 'static' picture of one!  'Nebula' will play the sound
    associated with the animation when the file is deleted!


    -------------------------------------------------------------------------
    FEATURES
    -------------------------------------------------------------------------

    --------------------------
    Standard features include:
    --------------------------
    o - Multitasks.
    o - Uses standard INTUITION interfaces.
    o - Adjusts to different WORKBENCH environments.


    -------------------------
    Special features include:
    -------------------------
    o - Uses the 'SOFTCONFIG' environment.


    -------------------------
    Program features include:
    -------------------------
    o - Allows three different styles of 'trashcans': static, alternating
        & animated.
    o - Use your own picture or animation (animbrush).  Nebula will
        adjust the size of the 'trashcan' to match those of the
        picture or animation specified.  For INTERLACED screens, you
        should double the height of the supplied animations.
    o - 'Nebula' will playback the sound file associated with the
        picture on animation when a file or directory is deleted.
    o - Uses an 'APPWINDOW' interface: drag the icon for any file or
        directory you want to delete onto the 'trashcan'.
    o - Optional deletion of icons along with the file or directory.
    o - Forced deletion of files and directories (ignores the protection
        flags).
    o - Optional confirmation for file or directory deletion.
    o - Dynamically move the 'trashcan' anywhere on the WORKBENCH
        screen.


    -------------------------------------------------------------------------
    USING NEBULA
    -------------------------------------------------------------------------

    ----------------
    Getting Started:
    ----------------
    You can start 'Nebula' from one of the supplied icons, or from the
    CLI/ Shell using:

    >Run Nebula

    ... you will be prompted from the 'trashcan' to load.

    (Please refer to the online help file for more information.)


    --------
    Options:
    --------
    The following options are available from the CLI/ Shell.

    -d ............... Don't delete the file(s)/ directory(s) icon(s).
    -n ............... Don't confirm file(s)/ directory(s) deletion.
    -f ............... Force file(s)/ directory(s) deletion.
    -x<value> ........ Window (trashcan's) X screen position.
    -y<value> ........ Window (trashcan's) Y screen position.

    (For information on 'TOOLTYPES' please refer to the online help file.)


    ----------------
    Pull-Down Menus:
    ----------------

    Project Menu:
    -------------
    About ............ Program credits & info.
    Quit ............. Exit 'Nebula'.


    Delete Menu:
    ------------
    Delete Icons ..... Delete icons with file(s)/ directory(s).
    No Confirmation .. Don't confirm file/ directory deletion.
    Force Deletion ... Force deletion of 'protected' files.


    Special Menu:
    -------------
    Move Trashcan .... Move 'trashcan' anywhere on the screen.


    -------------
    The Trashcan:
    -------------
    The 'trashcan' consists of two components:

    1) The picture/ anim brush.
    2) The optional sound file.

    The picture can either be an IFF brush or an ANIMBRUSH.  The sound
    should be in the standard 8SVX format (raw sound files should not
    be used!).

    To delete a file or directory, drag -n- drop the icon for the file/
    directory onto the 'trashcan'.


    -----------------------
    The Picture/ AnimBrush:
    -----------------------
    If you use a picture (an IFF brush), you will only have a static
    'trashcan'.

    To create an animated 'trashcan', first create an animation using
    DpaintIII ECA (ie.,), then use 'Anim/AnimBrush/Pick up..' to
    'pick up' the animation.  Now, use the 'Anim/AnimBrush/Save..'
    option to save the animation (in the AnimBrush format) to disk.
    One special note: The first frame of the animation will only be
    displayed when a file or directory is in the process of being
    deleted; all other frames, frames 2-END will be repeated continuously
    thereby creating the animation.

    If your animation only has two frames, then the 'trashcan' will
    alternate between two static images.  The first frame will only be
    displayed when a file or directory is in the process of being
    deleted: the second frame will otherwise be displayed.

    If the graphic image is too large, you could notice a degredation
    in system speed/ performance.

    The picture/ animation is not optional.


    --------------
    Adding Sounds:
    --------------
    'Nebula' will play, if available, the sound associated with the
    picture/ animation whenever a file or directory is in the process
    of being deleted.  The sound file should have the same name as the
    picture/ animation with the '.snd' suffix attached.  For example:

    DH0:Nebula/Trashcans/Nebula.anbr      (The animated 'trashcan'.)
    DH0:Nebula/Trashcans/Nebula.anbr.snd  (The deletion sound.)

    The sound file is optional.


    ---------
    Requires:
    ---------
    'Nebula' needs the AmigaDOS 'DELETE' command to be present in your
    current c: path or directory to work properly.


    -----------------------
    Software Configuration:
    -----------------------
    The following variables (flags) are used:

    SCREEN TO FRONT
    USE PUBLIC SCREEN

    (Please refer to the help file(s) for 'SoftConfig' for more information.)


    -------------------------------------------------------------------------
    FOR ADVANCED USERS
    -------------------------------------------------------------------------

    ---------
    Graphics:
    ---------
    Create your own graphics or animbrush to use as the 'trashcan'.
    The animation should be saved in an ANIMBRUSH format.  Other
    ANIM formats are not supported.  Deluxe PaintIII and above can
    create, modify and save ANIMBRUSHES.  Deluxe Paint is ECA.


    -----------
    Final Note:
    -----------
    'FKEY' can be used to 'launch' this program via pre-determined
    keystroke(s).


    -------------------------------------------------------------------------
    CREDITS
    -------------------------------------------------------------------------

    This program was designed and coded by Michael Thomas Hurt  of
    MIKE HURT SOFTWARE!, coded in & compiled using Blitz Basic 2.0
    available from Acid Software.

    Software testing was done using:

      o - Amiga 500 : AmigaDOS 2.1, GVP HD 500+ w/ 2MEGS.

      o - Amiga 2000: AmigaDOS 2.1, Microbotics VXL030 w/MMU,
          Microbotics VXLRAM 2MEGS, Microbotics 8-UP! 4MEGS,
          GVP Series II hard card w/ 100MEG HD.

      o - Amiga 3000: AmigaDOS 2.1, 6MEGS.

      o - Amiga 4000: AmigaDOS 3.0


    -------------------------------------------------------------------------
    PROGRAM HISTORY
    -------------------------------------------------------------------------

    v1.0    07/26/1995    Original program.