home *** CD-ROM | disk | FTP | other *** search
/ The Best of Mecomp Multimedia 1 / Mecomp-CD.iso / amiga / tools / system / dashboard / dashboard.doc < prev    next >
Text File  |  1993-03-26  |  7KB  |  166 lines
  1.  
  2.  
  3.  
  4.                             The DASHBOARD
  5.                         Clock/Memory/CPU Gauge
  6.  
  7.                          by Marat Fayzullin
  8.  
  9.                        version 1.7   3/25/1993
  10.                           Copyright by FMS   
  11.  
  12.  
  13.  
  14. 1. Description
  15.  
  16.    The Dashboard is the combination of well known PerfMeter-alike
  17. utilities, clocks and RAM gauges. Its window can be opened on any
  18. public screen and displays:
  19.  
  20.               1. Current time
  21.               2. Amounts of chip, fast and total memory.
  22.               4. CPU activity.
  23.               5. Graphs of these parameters
  24.  
  25.    Here is the picture of Dashboard window:
  26.    
  27.               [*]-------------------------[#]
  28.               |[------------] [-----][-----]|
  29.               || 1          | | 3   || 4   ||
  30.               ||     -----  | [-----][-----]|
  31.               ||    /     \ |   CPU    RAM  |
  32.               ||----       -|               |
  33.               ||            | F ******==6===|
  34.               ||            | C *******=5===|
  35.               |[------------]               |
  36.               || 2 CHIP RAM |     TIME  7   |
  37.               |[------------][Feb 6 6:45:23]|
  38.               [-----------------------------]
  39.  
  40.    1. Graph of selected parameter
  41.    2. Switch selecting the parameter to graph:
  42.       CPU Idle/CPU Usage/Chip RAM/Fast RAM/Total RAM/CPU Switch
  43.    3. Gauge of CPU activity
  44.    4. Gauge of RAM usage
  45.    5. Bar showing the usage of chip RAM
  46.    6. Bar showing the usage of fast RAM
  47.    7. Current time
  48.  
  49.    Dashboard can be run either from Workbench or from CLI (you don't need
  50. to use RUN command in the last case) and only works under AmigaDOS 2 and
  51. higher. If something is wrong, Dashboard doesn't start. There are several
  52. tooltypes which can be used:
  53.  
  54. 2. History:
  55. * Version1.7 *
  56.  Changes: 1. Finally, I completely got rid of those standard
  57.              C time functions. They produced wrong results and
  58.              constantly accessed TZ variable in the environment
  59.              causing a lot of complaints. DashBoard 1.7 uses
  60.              time functions from Dos.Library which are faster,
  61.              give correct time and don't mess up with environment.
  62.              Nevertheless, I left TIME=ON/OFF tooltype for the
  63.              sake of compatibility. TIME SHOULD WORK FINE NOW!
  64.           2. Both DashBoard and DashBoardJr have the version
  65.              strings now. You can check it if you type:
  66.                           version DashBoard
  67.           3. I found that GadToolsBox needs Utility.library to
  68.              be opened. Why? I don't know, the generated code
  69.              doesn't call any functions from this library, but
  70.              now I open it to be sure that everything is OK.
  71.           4. Code became little more effective.
  72.  
  73. * Version 1.6 *
  74.  Changes: 1. Previous versions of DashBoard didn't open GadTools
  75.              library with OpenLibrary() call. Yes, I know, it
  76.              is terrible bug, such things should never happen...
  77.              Anyway, it is fixed in v1.6! Thanks to Kari E Linden
  78.              who reported this problem. 
  79.           2. There was a problem with default font. DashBoard is
  80.              supposed to display all information in topaz8, no
  81.              matter what default font is. In fact, previous versions
  82.              displayed some of things using the default font and when
  83.              it was something like times24...entire thing screwed
  84.              up or (in the best case) just looked ugly. This problem
  85.              was reported by Heikki Kantola.
  86.  
  87. * Version 1.5 *
  88.    Wasn't distributed. The only difference from v.1.4 is the GRAPH
  89. tooltype allowing to choose the parameter to be plotted on startup.
  90. This addition was suggested by Mickey Everts.
  91.  
  92. * Version 1.4 *
  93.    The weird thing appeared when DashBoard 1.2 was run with SnoopDos:
  94. On every refresh cycle DashBoard CD'ed to ENV: directory and then back
  95. to the current directory. This problem was found by Mickey Everts and
  96. (as I found later) caused by standard time() and ctime() C functions
  97. used to get current time from the system. Because I don't see any
  98. other way to get current time not hacking AmigaDOS' guts (which usually
  99. means eventual incompatibility with other DOS versions), I added special
  100. tooltype TIME=ON/OFF which turns time display on and off (obviously).
  101. For those who don't use SnoopDos, default ON value strongly recommended. 
  102.   Another problem was that DashBoard didn't display LOCAL time (well,
  103. I'm not sure if this was a problem, my clock was ok, but I concluded it
  104. from what Eric Lavitsky reported). DashBoard 1.4 should work right,
  105. although I can't check it. My A2000 runs DOS 2.04 which handles these
  106. things differently from DOS 3.
  107.   Cut down version called DashBoardJr is now included in the archive.
  108. This version draws graphs only. It doesn't display gauges and all other
  109. stuff. 
  110.  
  111. * Version 1.3 *
  112.    Wasn't distributed.
  113.  
  114. * Version 1.2 *
  115.    The first distributed version.
  116.  
  117. 3. Tooltypes:
  118.  
  119.    X=<XCoordinate>        - Coordinates of the window
  120.    Y=<YCoordinate>          ( default - 0,0 )
  121.    SCREEN=<PubScrName>    - Name of public screen to open window on
  122.    PRIORITY=<Priority>    - Priority of Dashboard between -10 and +10
  123.                             ( default - 0 )
  124.    REFRESH=<Time>         - Window refresh period expressed in 0.1
  125.                             portions of second between 1 and 100
  126.                             ( default - 10 i.e. 1 second ) 
  127.    TIME=ON/OFF/YES/NO     - Turns on/off the time display
  128.                             ( default is ON )
  129.    GRAPH=IDLE/USAGE/      - Selects the parameter to be plotted on
  130.          CHIPRAM/FASTRAM/   startup ( default is IDLE ) 
  131.          TOTALRAM/SWITCH
  132.  
  133. 4. Thanks, Copyright, Self-advertisement, Address, etc...
  134.  
  135.    Lots of thanks to Juha Tuominen from Digital Design, whose Perfmeter
  136. served as a prototype for some subroutines of Dashboard. It was Perfmeter
  137. that made me write Dashboard, mainly to find out how these things work.
  138.    Thanks to Mickey Everts who pointed out the problem with Snoopdos and
  139. made several other important suggestions.  
  140.    Dashboard is freely distributable as long as you keep executable file
  141. and this documentation together. If you like it and/or want to support
  142. the author, send $5 - $25 to the address given below. Bug reports, flames,
  143. suggestions, etc. can be sent to the same address:
  144.  
  145.                            Marat Fayzullin
  146.                      8770 Cloudleap Court Apt#24
  147.                          Columbia,  MD 21045
  148.                                  USA
  149.  
  150.               Internet E-Mail address: fms@wam.umd.edu
  151.  
  152.    Look for other great programs written by FMS (it is me, but as much
  153. as I know there are other things using this abbreviation):
  154.  
  155.           WBGames   - Set of tiny games which can be opened on
  156.                       any public screen. Current version 1.7
  157.                       includes Tetris, Columns, 15, MineSweeper,
  158.                       Sokoban and BoulderDash.
  159.           Protector - Login program like AmiStation. Supports
  160.                       multiple users and keeps log of logins.
  161. -------------------------------------------------------------------------- 
  162.                                                      Marat Fayzullin
  163.   MS-DOS: Just say NO!                                  3/25/1993
  164.                                                      fms@wam.umd.edu      
  165. --------------------------------------------------------------------------
  166.