home *** CD-ROM | disk | FTP | other *** search
/ Aminet 18 / aminetcdnumber181997.iso / Aminet / dev / gui / gauge.readme < prev    next >
Encoding:
Text File  |  1997-03-02  |  2.7 KB  |  69 lines
  1. Short:  Create a progress requester, as in the AUISG
  2. Author: Olaf `Olsen' Barthel <olsen@sourcery.han.de>
  3. Type:   dev/gui
  4.  
  5.    PURPOSE
  6.     The "Amiga User Interface Style Guide" contains an example of how
  7.     a progress requester should look like (page 29), but this example
  8.     has no "teeth". It is just a visual cue, you still have to implement
  9.     the requester yourself. Around Christmas Day, the issue was brought
  10.     up in comp.sys.amiga.programmer how to program these progress
  11.     requesters. This is my attempt at solving the problem.
  12.  
  13.    GOALS
  14.     - The progress requester should be entirely self-contained and
  15.       reentrant.
  16.     - It should be simple to find out if the user has hit the
  17.       "Stop" button.
  18.     - Creation and management of the requester should follow a
  19.       familiar model.
  20.     - The display should be font sensitive.
  21.  
  22.    IMPLEMENTATION
  23.     The implementation consists of a set of BOOPSI objects, which are
  24.     linked together, plus a display element for the gauge. This is
  25.     similar to how Intuition builds system requesters and has the
  26.     advantage of delegating the work load of refreshing and maintaining
  27.     the display to Intuition. The application to create the display
  28.     just has to listen for the user to hit the "Stop" button, it need
  29.     not worry about housekeeping work.
  30.  
  31.     The gauge creation code is reentrant, it was written with SAS/C
  32.     in mind. The only compiler dependant part is the custom class
  33.     dispatcher. You must initialize IntuitionBase, GfxBase,
  34.     UtilityBase and SysBase for the gauge code to work.
  35.  
  36.    COPYRIGHT AND USAGE RESTRICTIONS
  37.     This implementation is Copyright © 1997 by Olaf `Olsen' Barthel.
  38.     It is freely distributable. I place no restrictions on its usage.
  39.     You may use this code in commercial software or shareware programs
  40.     without having to pay royalties to me. An acknowledgement would
  41.     still be nice, though :^) If you find bugs in the code or make
  42.     enhancements, please notify me. I would like to keep this code
  43.     updated, so everyone will be able to take advantage of it.
  44.  
  45.     My electronic mail address:
  46.  
  47.         olsen@sourcery.han.de
  48.  
  49.     My postal address:
  50.  
  51.         Olaf Barthel
  52.         Brabeckstrasse 35
  53.         D-30559 Hannover
  54.         Federal Republic of Germany
  55.  
  56.  
  57. ============================= Archive contents =============================
  58.  
  59. Original  Packed Ratio    Date     Time    Name
  60. -------- ------- ----- --------- --------  -------------
  61.    36361   11153 69.3% 26-Jan-97 19:40:34  gauge.c
  62.    11647    3915 66.3% 26-Jan-97 19:47:28  gauge.doc
  63.     1270     537 57.7% 26-Jan-97 18:58:40  gauge.h
  64.      205     128 37.5% 26-Jan-97 18:54:44  smakefile
  65.    12148    6257 48.4% 26-Jan-97 19:41:48  test
  66.     1631     764 53.1% 26-Jan-97 19:01:38  test.c
  67. -------- ------- ----- --------- --------
  68.    63262   22754 64.0% 27-Jan-97 01:27:28   6 files
  69.