home *** CD-ROM | disk | FTP | other *** search
/ Aminet 10 / aminetcdnumber101996.iso / Aminet / util / misc / mhsutil5.lha / Nebula / Manual < prev    next >
Text File  |  1995-09-25  |  8KB  |  227 lines
  1.     -------------------------------------------------------------------------
  2.     INTRODUCTION
  3.     -------------------------------------------------------------------------
  4.  
  5.     Many 'trashcans' using 'APPWINDOWS' or 'APPICONS' usually have only
  6.     one picture associated with them: a trashcan!.  'Nebula' is the
  7.     first ANIMATED TRASHCAN!  You can provide your own picture, animation
  8.     & sounds!  Try the 'Nebula' example for some space action!  'Nebula'
  9.     will sit on your WORKBENCH screen, just doing it's thing, until
  10.     you drop an icon on it!  'Nebula' is easy to use!  For best results,
  11.     use your own animation.  How about a true spiralling black hole
  12.     instead of a 'static' picture of one!  'Nebula' will play the sound
  13.     associated with the animation when the file is deleted!
  14.  
  15.  
  16.     -------------------------------------------------------------------------
  17.     FEATURES
  18.     -------------------------------------------------------------------------
  19.  
  20.     --------------------------
  21.     Standard features include:
  22.     --------------------------
  23.     o - Multitasks.
  24.     o - Uses standard INTUITION interfaces.
  25.     o - Adjusts to different WORKBENCH environments.
  26.  
  27.  
  28.     -------------------------
  29.     Special features include:
  30.     -------------------------
  31.     o - Uses the 'SOFTCONFIG' environment.
  32.  
  33.  
  34.     -------------------------
  35.     Program features include:
  36.     -------------------------
  37.     o - Allows three different styles of 'trashcans': static, alternating
  38.         & animated.
  39.     o - Use your own picture or animation (animbrush).  Nebula will
  40.         adjust the size of the 'trashcan' to match those of the
  41.         picture or animation specified.  For INTERLACED screens, you
  42.         should double the height of the supplied animations.
  43.     o - 'Nebula' will playback the sound file associated with the
  44.         picture on animation when a file or directory is deleted.
  45.     o - Uses an 'APPWINDOW' interface: drag the icon for any file or
  46.         directory you want to delete onto the 'trashcan'.
  47.     o - Optional deletion of icons along with the file or directory.
  48.     o - Forced deletion of files and directories (ignores the protection
  49.         flags).
  50.     o - Optional confirmation for file or directory deletion.
  51.     o - Dynamically move the 'trashcan' anywhere on the WORKBENCH
  52.         screen.
  53.  
  54.  
  55.     -------------------------------------------------------------------------
  56.     USING NEBULA
  57.     -------------------------------------------------------------------------
  58.  
  59.     ----------------
  60.     Getting Started:
  61.     ----------------
  62.     You can start 'Nebula' from one of the supplied icons, or from the
  63.     CLI/ Shell using:
  64.  
  65.     >Run Nebula
  66.  
  67.     ... you will be prompted from the 'trashcan' to load.
  68.  
  69.     (Please refer to the online help file for more information.)
  70.  
  71.  
  72.     --------
  73.     Options:
  74.     --------
  75.     The following options are available from the CLI/ Shell.
  76.  
  77.     -d ............... Don't delete the file(s)/ directory(s) icon(s).
  78.     -n ............... Don't confirm file(s)/ directory(s) deletion.
  79.     -f ............... Force file(s)/ directory(s) deletion.
  80.     -x<value> ........ Window (trashcan's) X screen position.
  81.     -y<value> ........ Window (trashcan's) Y screen position.
  82.  
  83.     (For information on 'TOOLTYPES' please refer to the online help file.)
  84.  
  85.  
  86.     ----------------
  87.     Pull-Down Menus:
  88.     ----------------
  89.  
  90.     Project Menu:
  91.     -------------
  92.     About ............ Program credits & info.
  93.     Quit ............. Exit 'Nebula'.
  94.  
  95.  
  96.     Delete Menu:
  97.     ------------
  98.     Delete Icons ..... Delete icons with file(s)/ directory(s).
  99.     No Confirmation .. Don't confirm file/ directory deletion.
  100.     Force Deletion ... Force deletion of 'protected' files.
  101.  
  102.  
  103.     Special Menu:
  104.     -------------
  105.     Move Trashcan .... Move 'trashcan' anywhere on the screen.
  106.  
  107.  
  108.     -------------
  109.     The Trashcan:
  110.     -------------
  111.     The 'trashcan' consists of two components:
  112.  
  113.     1) The picture/ anim brush.
  114.     2) The optional sound file.
  115.  
  116.     The picture can either be an IFF brush or an ANIMBRUSH.  The sound
  117.     should be in the standard 8SVX format (raw sound files should not
  118.     be used!).
  119.  
  120.     To delete a file or directory, drag -n- drop the icon for the file/
  121.     directory onto the 'trashcan'.
  122.  
  123.  
  124.     -----------------------
  125.     The Picture/ AnimBrush:
  126.     -----------------------
  127.     If you use a picture (an IFF brush), you will only have a static
  128.     'trashcan'.
  129.  
  130.     To create an animated 'trashcan', first create an animation using
  131.     DpaintIII ©ECA (ie.,), then use 'Anim/AnimBrush/Pick up..' to
  132.     'pick up' the animation.  Now, use the 'Anim/AnimBrush/Save..'
  133.     option to save the animation (in the AnimBrush format) to disk.
  134.     One special note: The first frame of the animation will only be
  135.     displayed when a file or directory is in the process of being
  136.     deleted; all other frames, frames 2-END will be repeated continuously
  137.     thereby creating the animation.
  138.  
  139.     If your animation only has two frames, then the 'trashcan' will
  140.     alternate between two static images.  The first frame will only be
  141.     displayed when a file or directory is in the process of being
  142.     deleted: the second frame will otherwise be displayed.
  143.  
  144.     If the graphic image is too large, you could notice a degredation
  145.     in system speed/ performance.
  146.  
  147.     The picture/ animation is not optional.
  148.  
  149.  
  150.     --------------
  151.     Adding Sounds:
  152.     --------------
  153.     'Nebula' will play, if available, the sound associated with the
  154.     picture/ animation whenever a file or directory is in the process
  155.     of being deleted.  The sound file should have the same name as the
  156.     picture/ animation with the '.snd' suffix attached.  For example:
  157.  
  158.     DH0:Nebula/Trashcans/Nebula.anbr      (The animated 'trashcan'.)
  159.     DH0:Nebula/Trashcans/Nebula.anbr.snd  (The deletion sound.)
  160.  
  161.     The sound file is optional.
  162.  
  163.  
  164.     ---------
  165.     Requires:
  166.     ---------
  167.     'Nebula' needs the AmigaDOS 'DELETE' command to be present in your
  168.     current c: path or directory to work properly.
  169.  
  170.  
  171.     -----------------------
  172.     Software Configuration:
  173.     -----------------------
  174.     The following variables (flags) are used:
  175.  
  176.     SCREEN TO FRONT
  177.     USE PUBLIC SCREEN
  178.  
  179.     (Please refer to the help file(s) for 'SoftConfig' for more information.)
  180.  
  181.  
  182.     -------------------------------------------------------------------------
  183.     FOR ADVANCED USERS
  184.     -------------------------------------------------------------------------
  185.  
  186.     ---------
  187.     Graphics:
  188.     ---------
  189.     Create your own graphics or animbrush to use as the 'trashcan'.
  190.     The animation should be saved in an ANIMBRUSH format.  Other
  191.     ANIM formats are not supported.  Deluxe PaintIII and above can
  192.     create, modify and save ANIMBRUSHES.  Deluxe Paint is ©ECA.
  193.  
  194.  
  195.     -----------
  196.     Final Note:
  197.     -----------
  198.     'FKEY' can be used to 'launch' this program via pre-determined
  199.     keystroke(s).
  200.  
  201.  
  202.     -------------------------------------------------------------------------
  203.     CREDITS
  204.     -------------------------------------------------------------------------
  205.  
  206.     This program was designed and coded by Michael Thomas Hurt  of
  207.     MIKE HURT SOFTWARE!, coded in & compiled using Blitz Basic 2.0
  208.     available from Acid Software.
  209.  
  210.     Software testing was done using:
  211.  
  212.       o - Amiga 500 : AmigaDOS 2.1, GVP HD 500+ w/ 2MEGS.
  213.  
  214.       o - Amiga 2000: AmigaDOS 2.1, Microbotics VXL030 w/MMU,
  215.           Microbotics VXLRAM 2MEGS, Microbotics 8-UP! 4MEGS,
  216.           GVP Series II hard card w/ 100MEG HD.
  217.  
  218.       o - Amiga 3000: AmigaDOS 2.1, 6MEGS.
  219.  
  220.       o - Amiga 4000: AmigaDOS 3.0
  221.  
  222.  
  223.     -------------------------------------------------------------------------
  224.     PROGRAM HISTORY
  225.     -------------------------------------------------------------------------
  226.  
  227.     v1.0    07/26/1995    Original program.