home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / utility / misc / newpop.lzh / NewPop-4.0 / .newpoprc < prev    next >
Encoding:
Text File  |  1991-04-27  |  13.3 KB  |  307 lines
  1. #
  2. #  Default .newpoprc file for NewPop v4.0.
  3. #  Started: Fri Jan 18 20:44:29 1991 Loren J. Rittle
  4. #  Last Update: Wed Apr 24 01:00:26 1991 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. #  Some people didn't figure this out in the first release:
  30. #  You can and are supposed to edit this file to taste, it will be
  31. #  read in at startup time and overrides all hard coded values in
  32. #  the NewPop binary.  This allows people without C compilers to
  33. #  modify how NewPop works.  Some people thought that it was somehow
  34. #  used at compile time...  Nope, it is only looked at at runtime.
  35. #
  36. #  Only changes to the [hard coded] defaults need be listed here, in any
  37. #  order.  If you received this .newpoprc file in its original form
  38. #  (as you are supposed too!), then all settings listed in this file ARE
  39. #  the hard coded defaults and can be safely removed.  It only takes a
  40. #  little time to read this file at startup time, so why not keep every
  41. #  option listed here...
  42. #
  43. #  Comment lines must start with a pound sign.  Option names can appear
  44. #  in any case.  Blank lines are permitted.  Any amount of white space
  45. #  may precede option names and the pound sign of a comment line.  Also,
  46. #  any amount of white space may trail an option's value.  A comment
  47. #  may start after an option's value appears (There must be a bit of
  48. #  white space after the value and before the pound sign).
  49. #  Finally, note that some options have no meaning if other
  50. #  options are turned off, it is not an error to set a value
  51. #  for an option that is turned off.  For example, WEWANTWINDOWDRAG
  52. #  is meaningless if NEWPOPLITE is set to TRUE, and BLANKERPRIORITY
  53. #  has no meaning if NICENEWPOP is set to FALSE, etc.
  54. #
  55. #  Boolean options must be set to ON, OFF, TRUE or FALSE (in any case).
  56. #  Boolean options are: NICENEWPOP  NEWPOPLITE  WEWANTWINDOWDRAG  LOCK
  57. #  HIDEWBINFO  BACKDROPWINDOW  WIMPYCLOCK
  58. #
  59. #  Integer options must be in decimal with no intra-number spaces.
  60. #  Integer options are: MAXSCSIUSAGE  SCSIIOMONWIDTH  CPULOADMONWIDTH
  61. #  MEMORYMONWIDTH  GAPBETWEEN3  GAPBETWEEN2  GAPBETWEEN  FONTSIZE
  62. #  STARTYOFFSET  MAXTEXTWIDTH  STARTXOFFSET  WINDOWHEIGHT  TIMEOUT
  63. #  POPKEY  BLANKERPRIORITY  ULC  LLC  LRC  URC  INSTANTKEY  DEFEATKEY
  64. #
  65. #  Strings options must begin and end with double quote marks.
  66. #  String options are: SCSITASKNAME  FONTNAME  COMMAND PASSWORD
  67. #  No double quotes or newlines are allowed in strings, but spaces
  68. #  are allowed.
  69. #
  70. #  PS: Comments are parsed fast, so don't delete these comments!
  71. #  Or, if you must, save a backup of this file and strip the
  72. #  comments out of the copy that will be used (i.e the one
  73. #  in the s: directory). - LJR
  74. #
  75. #  The only comment from the source code that you all must see:
  76. # *    LJR recoded the entire thing to allow dynamic (at startup
  77. # *        time) configuration instead of hardcoded compile time
  78. # *        configuration.  This added many (2.5K) bytes!  Why did I
  79. # *        do it?  Because my public asked for it.  Will I ever get
  80. # *        a pizza out of this deal? YOW 1/27/90.
  81. #
  82.  
  83.  
  84. #  If NICENEWPOP is set to TRUE then we use a detached task, with a
  85. #  priority of BLANKERPRIORITY [default -20], method for drawing the Q*X
  86. #  pattern.  We give it a boost to priority 10 once every second, so it
  87. #  will keep moving, even if other user tasks are hogging the system, most
  88. #  likely with good reason.  This will lessen the overhead the NewPop
  89. #  blanker imposes upon the system, but the Q*X will look like it is
  90. #  running on a Mac, PC or UNIX box if CPU-bound tasks (with a priority
  91. #  greater than BLANKERPRIORITY) are running. :-)
  92. #
  93. #  With NICENEWPOP set to FALSE, the graphic code will run under the
  94. #  NewPop process.  With an '030 Amiga the overhead for updating the
  95. #  Q*X lines is very small and you should not need this as NewPop
  96. #  tries to be nice to the system by only changing one line per
  97. #  1/60 of a second anyways.  BLANKERPRIORITY is unused in this
  98. #  configuration.
  99.  
  100. NICENEWPOP        TRUE
  101. BLANKERPRIORITY        -20
  102.  
  103.  
  104. #  John, this option is for you!
  105. #  NEWPOPLITE, if TRUE, makes a small, features wise,
  106. #  version on newpop.  Leaves only timed screen blanking,
  107. #  instant-blanking, defeat-blanking and popcli features.
  108. #  A few local people wanted this. :-)
  109. #
  110. #  Note you now need to set POPKEY to 0 to turn the PopCli feature
  111. #  off.  In the past, NEWPOPLITE would do this by default.
  112.  
  113. NEWPOPLITE        FALSE
  114.  
  115.  
  116. #  TIMEOUT is the time, in seconds, before the screen blanker kicks in.
  117. #  Set TIMEOUT to 0 to disable the timed screen blanking feature.
  118.  
  119. TIMEOUT            180
  120.  
  121.  
  122. #  INSTANTKEY and DEFEATKEY control which key, if any, invokes the
  123. #  instant-blanking and defeat-blanking features.
  124. #  Tap the INSTANTKEY (while holding down the left Amiga key)
  125. #  once to turn on instant-blanking and then again to turn it off (i.e.
  126. #  it acts as a toggle).  Defeat-blanking will always be turned off
  127. #  when the INSTANTKEY is hit.  The above works the same for DEFEATKEY.
  128. #  Any mouse move whatsoever, resets all blanking features to what they
  129. #  should be based upon the current pointer position...
  130. #  
  131. #  Note that to be compatible with past releases of NewPop, INSTANTKEY and
  132. #  DEFEATKEY are off by default.  Set them to some non-zero value to enable
  133. #  instant/defeat blanking hot keys.  Note the raw key code for F1 is 80 and
  134. #  F2's code is 81.  NewPop will not check to make sure that there are no
  135. #  conflicts between your choices for POPKEY, INSTANTKEY and DEFEATKEY, but
  136. #  no harm will come if they overlap.
  137.  
  138. INSTANTKEY        0   # 0 means OFF!  To be compatible with old
  139.                 # releases, the default is off!
  140.                 # I use F1 - code 80
  141. DEFEATKEY        0   # See above.  You must manually change 0 to 81
  142.                 # (or whatever) to turn the feature on.
  143.                 # I use F2 - code 81
  144.  
  145.  
  146. #  Aris B. and John C., these options are for you!
  147. #  ULC, LLC, LRC, URC tell NewPop what to do when the mouse
  148. #  pointer enters the respectively; upper left, lower left, lower
  149. #  right and upper right corners of the screen.  0 means do nothing,
  150. #  1 means instant-blank, 2 means defeat-blank.
  151. #
  152. #  Using these options one can turn off all pointer related
  153. #  instant- and defeat-blanking by setting them all to 0.
  154. #  As shipped, NewPop v3.x functions as v3.[0-2] did, i.e., the lower
  155. #  right corner invokes defeat-blanking and the upper right corner
  156. #  invokes instant-blanking.
  157.  
  158. ULC            0
  159. LLC            0
  160. LRC            2
  161. URC            1
  162.  
  163.  
  164. #  POPKEY defines the raw key code needed with left Amiga in order to pop
  165. #  a cli.  Be default, escape (Raw Key Code 69) is the POPKEY.  COMMAND is
  166. #  the command string NewPop will execute upon seeing the pop key.
  167. #  Set POPKEY to 0 to turn off the PopCli feature.  Of course, COMMAND is
  168. #  never used if POPKEY is set to 0.
  169.  
  170. POPKEY            69
  171. COMMAND            "NEWCLI >NIL:"
  172.  
  173.  
  174. #  MEMORYMONWIDTH is the number of pixels wide the memory monitor (the
  175. #  far left one) should be.  GAPBETWEEN3 is the number of pixels between
  176. #  the end of the disk I/O monitor and the start of the memory meter.
  177. #  Set MEMORYMONWIDTH to 0 to turn the memory meter off.  With no memory
  178. #  monitor, GAPBETWEEN3 is set (by NewPop) to 0 also.  Note the memory
  179. #  monitor is off by default to stay compatible with older releases.
  180.  
  181. MEMORYMONWIDTH        0    # 100 -are good values...
  182. GAPBETWEEN3        0    # 16  /
  183.  
  184.  
  185. #  SCSITASKNAME is the name of the task to monitor SCSI I/O for.
  186. #  Warning:  this feature might not work with all SCSI device drivers,
  187. #  all I can say is that if you have any problem, don't use this feature!
  188. #  gvpscsi.device is the GVP Impact II controller SCSI device driver name.
  189. #  scsidev.device is the GVP Impact I device driver name.
  190. #  "SCSI bus handler" is the name of the A3000 device driver.  Don't use
  191. #  scsi.device!
  192. #
  193. #  MAXSCSIUSAGE should be set to the maximum number of times the named
  194. #  device will be dispatched per second under the heaviest of SCSI I/O
  195. #  loads.  80 worked good for my GVP '030 based non-DMA GVP Impact I
  196. #  system.  55 works good for my GVP '030 based DMA GVP Impact II system.
  197. #  I have no idea what is good for other systems.  DMA based controllers
  198. #  would, I would guess, be better off with a smaller MAXSCSIUSAGE value
  199. #  as less task switching would, in theory at least, be needed to
  200. #  transfer data over the SCSI bus.
  201. #
  202. #  Note: I added a bit of debugging code to find this value by trial and
  203. #  error.  You can perform the same trial and error method by running
  204. #  NewPop, if the I/O graph never peaks then lower MAXSCSIUSAGE.  If it
  205. #  peaks to often then raise MAXSCSIUSAGE.
  206. #
  207. #  SCSIIOMONWIDTH is the number of pixels wide the SCSI I/O monitor (the
  208. #  middle one) should be.  GAPBETWEEN2 is the number of pixels between
  209. #  the end of the CPU load monitor and the start of SCSI I/O monitor.
  210. #  Set SCSIIOMONWIDTH to 0 to turn the SCSI I/O monitor off.  GAPBETWEEN2
  211. #  is set to 0 (by NewPop), if the SCSI I/O monitor is turned off.
  212.  
  213. SCSITASKNAME        "gvpscsi.device"
  214. MAXSCSIUSAGE        55
  215. SCSIIOMONWIDTH        100
  216. GAPBETWEEN2        16
  217.  
  218.  
  219. #  CPULOADMONWIDTH is the number of pixels wide the CPU load monitor
  220. #  (the far right one) should be.  GAPBETWEEN is the number of pixels
  221. #  between the time and the start of the load monitor.  Set CPULOADMONWIDTH
  222. #  to 0 to turn off the CPU load monitor.  GAPBETWEEN is also set to 0
  223. #  (by NewPop), if the CPULOADMONWIDTH monitor is turned off.
  224.  
  225. CPULOADMONWIDTH        100
  226. GAPBETWEEN        16
  227.  
  228.  
  229. #  FONTNAME is the name of the font to use for the title bar clock at size
  230. #  FONTSIZE.  Note that you must add '.font' to the name.
  231. #
  232. #  STARTYOFFSET is how far down the baseline of the date should be from
  233. #  the top of the window.  If FONTNAME, FONTSIZE or WINDOWHEIGHT is
  234. #  changed then play with this number until the date looks right :-).
  235. #  It should be about:
  236. #  WINDOWHEIGHT - ((WINDOWHEIGHT - font_height_in_pixels(not FONTSIZE!))/2).
  237. #  For example ``Helvetica'' size 9 is 6 pixels high!  Go figure.
  238. #
  239. #  MAXTEXTWIDTH is the maximum value that the TextLength function
  240. #  can return for all possible dates!  For fixed fonts
  241. #  MAXTEXTWIDTH is just horizontal_character_size_in_pixels * 24.
  242. #  Newpop supports proportional fonts, you just have to do
  243. #  a little leg work to figure this number out for them. 
  244. #  To find this number, run CalcTextWidth (included) and answer
  245. #  the questions it asks, this parameter will pop out! :-)
  246. #
  247. #  If WIMPYCLOCK is set to TRUE, then a 12 hour clock is displayed,
  248. #  else a 24 clock is used.
  249. #
  250. #  Set MAXTEXTWIDTH to 0 to turn off the titlebar clock.
  251.  
  252. FONTNAME        "Helvetica.font"
  253. FONTSIZE        9
  254. MAXTEXTWIDTH        107
  255. STARTYOFFSET        7
  256. WIMPYCLOCK        FALSE
  257.  
  258.  
  259. #  STARTXOFFSET is the distance from the right edge of the titlebar
  260. #  window to the right edge of the workbench screen.  56 leaves both
  261. #  screen gadgets uncovered under 1.3 and below.
  262. #  Change if more gadgets are ever added to WBScreen, or
  263. #  in 2.0's case, you may actually want to lower this number!
  264. #
  265. #  WINDOWHEIGHT should, most likely, be the (real WB) titlebar height - 3.
  266. #  I know under 2.0 that all bets are off as to it's real height,
  267. #  thus for now it is hard coded.  Once I get 2.0, all this
  268. #  will be fixed up.  Be careful setting this! (Should be 8, for
  269. #  standard 1.3 and below system)
  270. #
  271. #  BACKDROPWINDOW tells NewPop whether or not a BACKDROPWINDOW window
  272. #  should be used for the titlebar window.  The default is TRUE to stay
  273. #  compatible with past releases, plus I like it that way :-).
  274. #
  275. #  Set WEWANTWINDOWDRAG to TRUE if you want to be able to move the 
  276. #  titlebar clock window in the standard click drag release way.
  277. #  If FALSE, the window stays put when clicked!  NewPop's clock, etc
  278. #  was designed to be a titlebar clock, but some people might
  279. #  want this feature...
  280. #
  281. #  The boolean option HIDEWBINFO allows one to specify whether or not the
  282. #  space after `Workbench Screen' up to the start of the titlebar monitors
  283. #  should always be covered by NewPop's titlebar window, thus hiding those
  284. #  nasty WB memory free statements.  The default is off to stay compatible
  285. #  with NewPop v3.x.
  286.  
  287. STARTXOFFSET        56
  288. WINDOWHEIGHT        8
  289. BACKDROPWINDOW        TRUE
  290. WEWANTWINDOWDRAG    FALSE
  291. #HIDEWBINFO        FALSE #not yet implemented
  292.  
  293.  
  294. #  If LOCK is set to TRUE then PASSWORD refers to the only word which
  295. #  NewPop will accept to stop blanking.  "Amiga" is the default password.
  296. #  Note that the case of the password is important.
  297. #
  298. #  If LOCK is set to FALSE then no protection to stop people from
  299. #  unblanking is implemented and PASSWORD is ignored.
  300. #
  301. #  The req.library must be present for this to work!  If not present,
  302. #  then all LOCK related stuff *will* *not* function, but it will not
  303. #  function gracefully :-).
  304.  
  305. LOCK            FALSE
  306. PASSWORD        "Amiga"
  307.