home *** CD-ROM | disk | FTP | other *** search
/ World of A1200 / World_Of_A1200.iso / programs / system / newpop-4.1 / .newpoprc next >
Text File  |  1995-02-27  |  12KB  |  256 lines
  1. #
  2. #  Default .newpoprc file for NewPop-4.1.
  3. #  Started: Fri Jan 18 20:44:29 1991 Loren J. Rittle
  4. #  Last Update: Sun Apr 18 21:56:04 1993 Loren J. Rittle
  5. #
  6. #  NewPop searches for this file at startup time in the
  7. #  following directories, in order:  Current Directory, S: Directory.
  8. #  If found, NewPop processes the file and then starts running unless
  9. #  any parse error whatsoever occurs!  These setting override compile
  10. #  time options.  Command line options are now considered obsolete
  11. #  and are no longer used.
  12. #
  13. #  All error messages are of the form:
  14. #  NewPop: parse error on line 112 of .newpoprc
  15. #
  16. #  It is up to you (in this release) to determine the exact error
  17. #  on the given line.  A parse error could be as simple as a
  18. #  bad value or misspelled keyword.  Or, it could be as complex
  19. #  as a value out of range.  Basically, there are limits on
  20. #  what values NewPop is willing to accept for a given integer
  21. #  parameter and NewPop does a sanity check on the values in this
  22. #  configuration file.  If it is out of range you get the generic
  23. #  error message stating which line has the error.  Also of note,
  24. #  strings have a maximum length, if your string exceeds the length
  25. #  the you get the generic error message.  This will be fixed in the
  26. #  future, perhaps.  Or it *could* be a bug in NewPop's parser :-).
  27. #
  28. #  Random notes:
  29. #  Only changes to the defaults need be listed here, in any order.
  30. #  Comment lines must start with a pound sign.  Option names can appear
  31. #  in any case.  Blank lines are permitted.  Any amount of white space
  32. #  may precede option names and the pound sign of a comment line.  Also,
  33. #  any amount of white space may trail an option's value.  A comment
  34. #  may start after an option's value appears (There must be a bit of
  35. #  white space after the value and before the pound sign).
  36. #  Finally, note that some options have no meaning if other
  37. #  options are turned off, it is not an error to set a value
  38. #  for an option that is turned off.  For example, WEWANTWINDOWDRAG
  39. #  is meaningless if NEWPOPLITE is set to TRUE, and BLANKERPRIORITY
  40. #  has no meaning if NICENEWPOP is set to FALSE, etc.
  41. #
  42. #  Boolean options must be set to ON, OFF, TRUE or FALSE (in any case).
  43. #  Boolean options are: NICENEWPOP  NEWPOPLITE  WEWANTWINDOWDRAG
  44. #
  45. #  Integer options must be in decimal with no intra-number spaces.
  46. #  Integer options are: MAXSCSIUSAGE  SCSIIOMONWIDTH  CPULOADMONWIDTH
  47. #  GAPBETWEEN2  GAPBETWEEN  FONTSIZE  STARTYOFFSET  MAXTEXTWIDTH
  48. #  STARTXOFFSET  WINDOWHEIGHT  TIMEOUT  POPKEY  BLANKERPRIORITY
  49. #
  50. #  Strings options must begin and end with double quote marks.
  51. #  String options are: SCSITASKNAME  FONTNAME  COMMAND
  52. #  No double quotes or newlines are allowed in strings, but spaces
  53. #  are allowed.
  54. #
  55. #  Feature Bug: This information should be in a .info file.
  56. #        If anyone looks into this and fixes it, please
  57. #        send changes back to me.  Thanks. - LJR
  58. #
  59. #  PS: Comments are parsed fast, so don't delete these comments!
  60. #  Or, if you must, save a backup of this file and strip the
  61. #  comments out of the copy that will be used (i.e the one
  62. #  in the s: directory). - LJR
  63.  
  64. #  If NICENEWPOP is set to TRUE then we use a detached task, with a
  65. #  priority of BLANKERPRIORITY [default -20], method for drawing the Q*X
  66. #  pattern.  We give it a boost to priority 10 once every second, so it
  67. #  will keep moving, even if other user tasks are hogging the system, most
  68. #  likely with good reason.  This will lessen the overhead NewPop imposes
  69. #  upon the system, but the Q*X will look like it is running on a Mac, PC
  70. #  or UNIX box if CPU-bound tasks (with a priority greater than
  71. #  BLANKERPRIORITY) are running. :-)
  72. #  With NICENEWPOP set to FALSE, the graphic code will run under the
  73. #  NewPop process.  With an '030 Amiga the overhead for updating the
  74. #  Q*X lines is very small and you should not need this as NewPop
  75. #  tries to be nice to the system by only changing one line per
  76. #  1/60 of a second anyways.
  77. NICENEWPOP        TRUE
  78.  
  79. #  NEWPOPLITE, if TRUE, makes a small, features wise,
  80. #  version on newpop.  Leaves only timed screen blanking,
  81. #  instant-blanking, defeat-blanking and popcli features.
  82. #  A few local people wanted this. :-)
  83. #  Note you now need to set POPKEY to 0 to turn PopCli feature
  84. #  off.  In the past, NEWPOPLITE would to this by default.
  85. NEWPOPLITE        FALSE
  86.  
  87. #  Set WEWANTWINDOWDRAG to TRUE if you want to be able to move the 
  88. #  titlebar clock window in the standard click drag release way.
  89. #  If left commented the window stays put when clicked!  NewPop's
  90. #  clock was designed to be a titlebar clock, but some people might
  91. #  want this feature...
  92. WEWANTWINDOWDRAG    FALSE
  93.  
  94. #  SCSITASKNAME is the name of the task to monitor disk I/O for.
  95. #  Warning:  this feature might not work with all SCSI device drivers,
  96. #  all I can say is that if you have any problem, don't use this feature!
  97. #  gvpscsi.device is the GVP Impact II controller SCSI device driver name.
  98. #  scsidev.device is the GVP Impact I device driver name.
  99. #  scsi.device is the name I think Commodore uses for their device drivers.
  100. #  To turn this feature off, set SCSITASKNAME to some junk task name
  101. #  that never occurs on your machine.  E.g. "hjadgfjhasdgfjhagdjh" :-)
  102. SCSITASKNAME        "scsi.device"
  103.  
  104. #  Font to use for the title bar clock.
  105. FONTNAME        "CGTriumvirate.font"
  106.  
  107. #  The default command string to execute upon pop.
  108. # for a standard system...
  109. COMMAND        "NEWCLI >NIL:"
  110. # for a system running WShell...
  111. #COMMAND            "newwsh cmd yow"
  112.  
  113. #  MAXSCSIUSAGE should be set to the maximum number of times the named
  114. #  device will be dispatched per second under the heaviest of SCSI I/O
  115. #  loads.  80 worked good for my GVP '030 based non-DMA GVP Impact I
  116. #  system.  55 works good for my GVP '030 based DMA GVP Impact II system.
  117. #  I have no idea what is good for other systems.  DMA based controllers
  118. #  would, I would guess, be better off with a smaller MAXSCSIUSAGE value
  119. #  as less task switching would (should in theory at least, right?) be
  120. #  needed to transfer data over the SCSI bus. 
  121. #  Note: I added a bit of debugging code to find this value by trial and
  122. #  error.  You can perform the same trial and error method by running
  123. #  NewPop, if the I/O graph never peaks then lower MAXSCSIUSAGE.  If it
  124. #  peaks to often then raise MAXSCSIUSAGE.
  125. MAXSCSIUSAGE        55
  126.  
  127. #  Number of pixels wide the disk I/O monitor (the left one) should be.
  128. SCSIIOMONWIDTH        100
  129. #SCSIIOMONWIDTH        0
  130.  
  131. #  Number of pixels wide the CPU load monitor (the right one) should be.
  132. CPULOADMONWIDTH        100
  133.  
  134. #  Number of pixels between end of CPU load monitor and
  135. #  start of disk I/O monitor.
  136. GAPBETWEEN2        16
  137. #GAPBETWEEN2        0
  138.  
  139. #  Number of pixels between time and start of load monitor.
  140. GAPBETWEEN        16
  141.  
  142. #  Size of font to use for title bar clock.
  143. FONTSIZE        15
  144.  
  145. #  STARTYOFFSET is how far down the baseline of the date should be from
  146. #  the top of the window.  If FONTNAME, FONTSIZE or WINDOWHEIGHT is
  147. #  changed then play with this number until the date looks right :-).
  148. #  It should be about:
  149. #  WINDOWHEIGHT - ((WINDOWHEIGHT - font_height_in_pixels(not FONTSIZE!))/2).
  150. #  For exmaple ``Helvetica'' size 9 is 6 pixels high! Go figure.
  151. STARTYOFFSET        11
  152.  
  153. #  This is the maximum value that the TextLength function
  154. #  can return for all possible dates!  For fixed fonts
  155. #  MAXTEXTWIDTH is just horizontal_character_size_in_pixels * 24.
  156. #  Newpop supports proportional fonts, you just have to do
  157. #  a little leg work to figure this number out for them. 
  158. #  Hint: most well designed proportional fonts use a
  159. #  standard size for all numbers (Knuth, MF), thus this should
  160. #  be easy to calculate for a well designed proportional
  161. #  font.  Helvetica.font (size 9) as distributed by Commodore
  162. #  is well designed.  Helvetica.font (size 9) as distributed
  163. #  by Gold Disk is not well designed, all the numbers have
  164. #  a different length, thus the date will jump about every
  165. #  second as it is updated, not pretty, not my or Commodore's
  166. #  fault.
  167. #  Install the nice Commodore fonts from the Extras disk from
  168. #  1.3 (maybe 1.2 also), or else good luck to you (and be sure
  169. #  to recalculate MAXTEXTWIDTH :-).
  170. #  PS: Nothing bad will happen if this number is too small,
  171. #  text will just flow off the end of the window.
  172. #  OK, OK, OK:  Instead of you doing the grunt work, I have
  173. #  supplied - ``CalcTextWidth.c'' - which will determine the
  174. #  MAXTEXTWIDTH value for a given font and size.
  175. #  To find this number, run CalcTextWidth and answer the
  176. #  questions it asks, this parameter will pop out! :-)
  177. MAXTEXTWIDTH        160
  178.  
  179. #  Change if more gadgets are ever added to WBScreen, or
  180. #  in 2.0's case, you may actually want to lower this number!
  181. #  STARTXOFFSET is the distance from the right edge of the titlebar
  182. #  window to the right edge of the workbench screen.
  183. # for a pre 2.0 system
  184. #STARTXOFFSET        56
  185. # for a 2.0 system
  186. STARTXOFFSET        24
  187.  
  188. #  Should most likely be the (real WB) titlebar height - 3.
  189. #  I know under 2.0 all bets are off as to it's real height,
  190. #  thus for now it is hard coded.  Once I get 2.0, all this
  191. #  will be fixed up.  Be careful setting this! (Should be 8, for
  192. #  standard 1.3 and below system)
  193. WINDOWHEIGHT        15
  194.  
  195. #  Time (in seconds) before the screen blanker kicks in.
  196. TIMEOUT            180
  197.  
  198. #  The default key (69 is Escape) needed with left Amiga in order to pop.
  199. POPKEY            69
  200.  
  201. #  BLANKERPRIORITY is the priority to run the Q*X graphics code at.
  202. #  This is only used if NICENEWPOP is set to TRUE.
  203. BLANKERPRIORITY        -20
  204.  
  205. #  Aris B. and John C., these options are for you!
  206. #  ULC, LLC, LRC, URC tell NewPop what to do when the mouse
  207. #  pointer enters the respectively; upper left, lower left, lower
  208. #  right and upper right corners of the screen.  0 means do nothing,
  209. #  1 means instant-blank, 2 means defeat-blank.
  210. #  Using these options one can turn off instant- and defeat-blanking
  211. #  by setting them all to 0.
  212. ULC            0
  213. LLC            0
  214. LRC            2
  215. URC            1
  216.  
  217. #  INSTANTKEY and DEFEATKEY control which key, if any, invokes the
  218. #  instant-blanking and defeat-blanking features.
  219. #  Tap the INSTANTKEY (while holding down the left Amiga key)
  220. #  once to turn on instant-blanking and then again to turn it off (i.e.
  221. #  it acts as a toggle).  Defeat-blanking will always be turned off
  222. #  when the INSTANTKEY is hit.  The above works the same for DEFEATKEY.
  223. #  Any mouse move whatsoever, resets all blanking features to what they
  224. #  should be based upon pointer position...
  225. #  
  226. #  Note INSTANTKEY and DEFEATKEY are off by default.  Set them to
  227. #  some non-zero value to enable instant/defeat blanking hot keys.
  228. #  Note the raw key code for F1 is 80 and F2's code is 81.
  229. #  NewPop will not check to make sure that there are no conflicts
  230. #  between your choices for POPKEY, INSTANTKEY and DEFEATKEY, but
  231. #  no harm will come if they overlap.
  232. #INSTANTKEY        0
  233. #DEFEATKEY        0
  234. INSTANTKEY        80
  235. DEFEATKEY        81
  236.  
  237. #  If LOCK is set to true then PASSWORD refers to the only word which
  238. #  NewPop will accept to stop blanking.  "Amiga" is the default password.
  239. #  The req.library must be present for this to work!  If not present,
  240. #  then all LOCK related stuff *will* *not* function, but not function
  241. #  gracefully :-).
  242. LOCK            FALSE
  243. PASSWORD        "Amiga"
  244.  
  245. #  MEMORYMONWIDTH is the number of pixels wide the memory monitor (the
  246. #  far left one) should be.  GAPBETWEEN3 is the number of pixels between
  247. #  the end of the disk I/O monitor and the start of the memory meter.
  248. #  Set MEMORYMONWIDTH to 0 to turn the memory meter off.  With no memory
  249. #  monitor GAPBETWEEN3 should be set to 0 also, but no harm will come if
  250. #  it is not.  Note the memory monitor is off by default to stay
  251. #  compatible with older releases.
  252. #MEMORYMONWIDTH        0    # 100 -are good values...
  253. #GAPBETWEEN3        0    # 16  /
  254. MEMORYMONWIDTH        100    # 100 -are good values...
  255. GAPBETWEEN3        30    # 16  /
  256.