home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / program / hourmaker / !!ReadMe
Encoding:
Text File  |  1993-09-20  |  3.3 KB  |  70 lines
  1. HourMaker
  2. =========
  3.  
  4. Custom Hourglass Module Creator
  5. by Simon Heys
  6.  
  7.  
  8. !HourMaker
  9. ==========
  10. This desktop application creates hourglass modules similar to the one
  11. present in every Archimedes machine. It creates the module by taking a
  12. source sprite file containing the animation frames (which needn't be an
  13. hourglass!), converting it to pointer data and attaching it to a machine
  14. code module which is controlled by optional * commands (see below).
  15.  
  16. Before creating a module, it is necessary to create a sprite file containing
  17. the animation frames. Each frame must be the same size, to a maximum of
  18. 32x32 pixels, and must be defined in either mode 1 or mode 8. A frame must
  19. have the name 'ptr_<frame number>'. The first frame may have a palette which
  20. will then be used as the palette for every frame, but if one is not present
  21. the default mode 1 palette is used instead. A number of example sprite files
  22. are included in the HourSprite directory. Their respective modules are in
  23. the HourModule directory.
  24.  
  25. Here is how to create a module, using as an example the 'Bi-Plane' sprite
  26. file (from the HourSprite directory):
  27.   
  28.   Load the !HourMaker application and click on its icon. The main control
  29.   window appears. Drag the 'Bi-Plane' sprite file icon to this window. Its
  30.   filename appears at the top of the window and information about the frames
  31.   appears at the bottom of the window. You may like to alter the module title
  32.   which helps to identify which animation is currently loaded. Using the arrows, 
  33.   set the 'Delay between frames' to 1 50th/sec. De-select 'Include *Animate
  34.   command in module' and select 'Middle' as the hourglass centre. Click the
  35.   Menu button of the mouse and select the 'Create module' option. When the module
  36.   has been created, go to the 'Save module' sub-menu and type in the filename
  37.   of the module, 'Bi-Plane' in this example. Drag the module icon to the
  38.   required directory viewer, and the module is saved.
  39.   
  40.   To test the module, first load it by double-clicking on its icon. Go to the
  41.   command line and type either 'Hourglass On' or 'HourFade On'. The mouse 
  42.   pointer should become a bi-plane with rotating propeller. To switch off the 
  43.   pointer, type either 'Hourglass Off' or 'HourFade Off'. The Bi-Plane animation
  44.   was designed to be used in modes with the same size pixels as mode 1.
  45.   
  46.   The module uses mouse pointer 3 for its animation and may slow down the
  47.   computer considerably, depending on the length of delay between frames.
  48.   
  49.   The commands provided by the module are:
  50.     
  51.     *Hourglass On       Switches the pointer animation on
  52.     *Hourglass Off      Switches the pointer animation off
  53.     
  54.   Optional commands:
  55.     
  56.     *HourFade On        As *Hourglass On, but fades the pointer on from black
  57.     *HourFade Off       Fades the animated pointer off to black
  58.     *Animate On         Allows animation by switching each of the four mouse
  59.                         pointers on in turn (see !HourDemo for example)
  60.     *Animate Off        Switches the animation off
  61.     
  62. !HourDemo
  63. =========
  64. This program demonstrates all the commands of modules created with !HourMaker.
  65.  
  66. To use it, simply double-click on its icon. Ensure that no other hourglass
  67. animation modules are loaded first. The program will tell you about a
  68. particular command and then will demonstrate its effect when you click the
  69. mouse.
  70.