home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 199.lha / Dirk_v0.01 / dirk.doc < prev    next >
Encoding:
Text File  |  1988-12-28  |  5.5 KB  |  150 lines
  1.  
  2.     9/88
  3.  
  4.  
  5.     DIRK v0.01 -- Tune workbench colors to system performance
  6.  
  7.                          -----------------
  8.  
  9.                    Copyright (C) 1988 by Daniel Elbaum
  10.  
  11.          This software is freely redistributable provided that:
  12.          the three files which comprise it (dirk, dirk.c, dirk.doc)
  13.          remain intact; all copyright notices contained in any of
  14.          the aforementioned files remain intact; and no fee beyond
  15.          reasonable remuneration for collation and distribution be
  16.          charged for use and/or purveyance.
  17.  
  18.  
  19.                          -----------------
  20.  
  21. Syntax:
  22.     run dirk [-t|m] [-gN] [-bN] [-hN] [-lN] [-iN]] [+rN] [+gN] [+bN]
  23.  
  24. Parameters:
  25.  
  26.     Option   Default    Effect
  27.     ---------------------------------------------------------------------
  28.     -
  29.         t               track tasks only
  30.         m               track memory only
  31.         g        4      granularity of task mapping (small for few tasks)
  32.         b       14      background saturation
  33.         h       12      maximum detail saturation
  34.         l        8      minimum detail saturation
  35.         i      180      interval in ticks (60 or 50 per second)
  36.  
  37.     +
  38.         r        8      base value for red component of detail pen
  39.         g        8      base value for green component of detail pen
  40.         b        8      base value for blue component of detail pen
  41.  
  42.  
  43.     If you like the program, you may eventually want to start it from
  44.     your startup-sequence, so you might want to dirk around with
  45.     the options before deciding on a command line to use. Here
  46.     they are.
  47.  
  48.     The -t option enables task tracking only.  The background color
  49.     is not affected.
  50.  
  51.     The -m option complements the -t option; only memory tracking is
  52.     turned on.  The detail pen color is not affected.
  53.  
  54.     The following command line options require counts.  The valid
  55.     range of the count varies from option to option.  All color
  56.     counts should be between 0 and 15; other counts must be
  57.     between 0 and 65535.
  58.  
  59.     Granularity, set with -gN, is the sensitivity with which detail
  60.     pen color responds to the instantaneous number of ready tasks.
  61.     Workable values lie between 1 and 8.
  62.  
  63.     The background saturation argument, -bN, determines the brightness
  64.     of the screen, which remains constant as hue varies.  N is best
  65.     set between 4 and 14.
  66.  
  67.     Maximum detail saturation (-hN) is a limit on the brightness of
  68.     the detail pen.  A value of 8 to 14 (14 brighter) can keep
  69.     detail from glaring.  The valid range is 0-15.
  70.  
  71.     Minimum detail saturation, -lN (ell not one) is a floor on the
  72.     brightness of the pen, to maintain good contrast to the
  73.     background.  For a light background, l should be at least 8.
  74.  
  75.     The interval (-iN) is the number of ticks to wait between
  76.     data retrieval expeditions.  A tick is 1/60th of a second
  77.     in the US, and 1/50 in Europe.  If N is given as 0, the
  78.     research and reporting are done constantly, and system
  79.     performance slows slightly but noticeably.  180 corresponds
  80.     to ~3 seconds, and is probably a good functional maximum.
  81.  
  82.     The + arguments specify the detail pen's basic color.
  83.     As the number of tasks increases, the pen becomes dimmer,
  84.     and as the proportion of active tasks increases, the pen
  85.     becomes yellower.  -rN sets the red component (0-15),
  86.     -gN sets the green, and -bN sets the blue.  It's worth
  87.     experimenting to find a combination which provides good
  88.     contrast.
  89.  
  90.     It all sounds confusing but once you run the program
  91.     and see what it does, the meaning of the command line
  92.     options will hopefully fall into place.
  93.  
  94.                          -----------------
  95. Description:
  96.  
  97.     The purpose of this program is to present key system
  98.     information to the user without cluttering up the display.
  99.     The workbench background color changes from blue through
  100.     purple to red as the amount of free memory decreases.
  101.     The workbench detail color (the color of text and Workbench
  102.     window borders) changes from bright white to gray as the
  103.     number of system tasks increases.  Further, the yellow
  104.     content of this color is increased according to the number
  105.     of active tasks.
  106.  
  107.     On a newly-booted vanilla system, borders are white and the
  108.     background is close to the standard Workbench blue.  As
  109.     you use the system, calling up programs and creating files
  110.     on the RAMdisk, the screen takes on an increasingly reddish
  111.     hue.  When memory is nearly full, the background is completely
  112.     red.
  113.  
  114.     Similarly, as tasks are added, the borders dim slightly.
  115.     In other words, after you set up dmouse, conman, snipit,
  116.     or whatever to run in the background, the detail color
  117.     fades, eventually to grey.  If many background tasks are
  118.     active rather than just waiting around for an interrupt or
  119.     message, the grey will be tinted yellow.
  120.  
  121.     With dirk running in the background, you always have a rough
  122.     idea of how much memory is available and how busy the system
  123.     is, without hunting around for the window of your favorite
  124.     resource-tracking gizmo.
  125.  
  126.                          -----------------
  127.  
  128. Signature and self-promo:
  129.  
  130.     If you want to send me money for dirk, then by all means
  131.     do so--many projects are in progress and I need financing.
  132.     $5.00 is recommended.  Make checks payable to:
  133.  
  134.     Daniel Elbaum
  135.     Amaranth Software
  136.     4816 SE Bybee Blvd.
  137.     Portland, Ore. 97206
  138.  
  139.  
  140.     Send comments, suggestions, and flames to:
  141.  
  142.     Daniel Elbaum
  143.     Portland bbs: Amigaboard!, NAG
  144.     UUCP: ...!tektronix!reed!elbaum
  145.     ARPA: elbaum@reed.EDU
  146.  
  147.  
  148.  
  149.  
  150.