Club Amiga de Montreal - CAM/CAM_CD_1.iso/files/500.lha/NewPop_v3.0/.newpoprc

Text File | 1991-04-08 | 10KB | 216 lines

#
#  Default .newpoprc file.
#  Started: Fri Jan 18 20:44:29 1991 Loren J. Rittle
#  Last Update: Mon Jan 28 18:27:37 1991 Loren J. Rittle
#
#  NewPop searches for this file at startup time in the
#  following directories, in order:  Current Directory, S: Directory.
#  If found, NewPop processes the file and then starts running unless
#  any parse error whatsoever occurs!  These setting override compile
#  time options.  Command line options are now considered obsolete
#  and are no longer used.
#
#  All error messages are of the form:
#  NewPop: parse error on line 112 of .newpoprc
#
#  It is up to you (in this release) to determine the exact error
#  on the given line.  A parse error could be as simple as a
#  bad value or misspelled keyword.  Or, it could be as complex
#  as a value out of range.  Basically, there are limits on
#  what values NewPop is willing to accept for a given integer
#  parameter and NewPop does a sanity check on the values in this
#  configuration file.  If it is out of range you get the generic
#  error message stating which line has the error.  Also of note,
#  strings have a maximum length, if your string exceeds the length
#  the you get the generic error message.  This will be fixed in the
#  future, perhaps.  Or it *could* be a bug in NewPop's parser :-).
#
#  Random notes:
#  Only changes to the defaults need be listed here, in any order.
#  Comment lines must start with a pound sign.  Option names can appear
#  in any case.  Blank lines are permitted.  Any amount of white space
#  may precede option names and the pound sign of a comment line.  Also,
#  any amount of white space may trail an option's value.  A comment
#  may start after an option's value appears (There must be a bit of
#  white space after the value and before the pound sign).
#  Finally, note that some options have no meaning if other
#  options are turned off, it is not an error to set a value
#  for an option that is turned off.  For example, WEWANTWINDOWDRAG
#  is meaningless if NEWPOPLITE is set to TRUE, and BLANKERPRIORITY
#  has no meaning if NICENEWPOP is set to FALSE, etc.
#
#  Boolean options must be set to ON, OFF, TRUE or FALSE (in any case).
#  Boolean options are: NICENEWPOP  NEWPOPLITE  WEWANTWINDOWDRAG
#
#  Integer options must be in decimal with no intra-number spaces.
#  Integer options are: MAXSCSIUSAGE  SCSIIOMONWIDTH  CPULOADMONWIDTH
#  GAPBETWEEN2  GAPBETWEEN  FONTSIZE  STARTYOFFSET  MAXTEXTWIDTH
#  STARTXOFFSET  WINDOWHEIGHT  TIMEOUT  POPKEY  BLANKERPRIORITY
#
#  Strings options must begin and end with double quote marks.
#  String options are: SCSITASKNAME  FONTNAME  COMMAND
#  No double quotes or newlines are allowed in strings, but spaces
#  are allowed.
#
#  Feature Bug: This information should be in a .info file.
#        If anyone looks into this and fixes it, please
#        send changes back to me.  Thanks. - LJR
#
#  PS: Comments are parsed fast, so don't delete these comments!
#  Or, if you must, save a backup of this file and strip the
#  comments out of the copy that will be used (i.e the one
#  in the s: directory). - LJR
#
#  The only comment from the source code that you all must see:
# *    LJR recoded the entire thing to allow dynamic (at startup
# *        time) configuration instead of hardcoded compile time
# *        configuration.  This added many (2.5K) bytes!  Why did I
# *        do it?  Because my public asked for it.  Will I ever get
# *        a pizza out of this deal? YOW 1/27/90.
#

#  If NICENEWPOP is set to TRUE then we use a detached task, with a
#  priority of BLANKERPRIORITY [default -20], method for drawing the Q*X
#  pattern.  We give it a boost to priority 10 once every second, so it
#  will keep moving, even if ot her user tasks are hogging the system, most
#  likely with good reason.  This will lessen the overhead NewPop imposes
#  upon the system, but the Q*X will look like it is running on a Mac, PC
#  or UNIX box if CPU-bound tasks (with a priority greater than
#  BLANKERPRIORITY) are running. :-)
#  With NICENEWPOP set to FALSE, the graphic code will run under the
#  NewPop process.  With an '030 Amiga the overhead for updating the
#  Q*X lines is very small and you should not need this as NewPop
#  tries to be nice to the system by only changing one line per
#  1/60 of a second anyways.
NICENEWPOP        TRUE

#  NEWPOPLITE, if TRUE, makes a small, features wise,
#  version on newpop.  Leaves only timed screen blanking,
#  instant-blanking, defeat-blanking and popcli features.
#  A few local people wanted this. :-)
#  Note you now need to set POPKEY to 0 to turn PopCli feature
#  off.  In the past, NEWPOPLITE would to this by default.
NEWPOPLITE        FALSE

#  Set WEWANTWINDOWDRAG to TRUE if you want to be able to move the
#  titlebar clock window in the standard click drag release way.
#  If left commented the window stays put when clicked!  NewPop's
#  clock was designed to be a titlebar clock, but some people might
#  want this feature...
WEWANTWINDOWDRAG    FALSE

#  SCSITASKNAME is the name of the task to monitor disk I/O for.
#  Warning:  this feature might not work with all SCSI device drivers,
#  all I can say is that if you have any problem, don't use this feature!
#  gvpscsi.device is the GVP Impact II controller SCSI device driver name.
#  scsidev.device is the GVP Impact I device driver name.
#  scsi.device is the name I think Commodore uses for their device drivers.
#  To turn this feature off, set SCSITASKNAME to some junk task name
#  that never occurs on your machine.  E.g. "hjadgfjhasdgfjhagdjh" :-)
SCSITASKNAME        "gvpscsi.device"

#  Font to use for the title bar clock.
FONTNAME        "Helvetica.font"

#  The default command string to execute upon pop.
COMMAND            "NEWCLI >NIL:"

#  MAXSCSIUSAGE should be set to the maximum number of times the named
#  device will be dispatched per second under the heaviest of SCSI I/O
#  loads.  80 worked good for my GVP '030 based non-DMA GVP Impact I
#  system.  55 works good for my GVP '030 based DMA GVP Impact II system.
#  I have no idea what is good for other systems.  DMA based controllers
#  would, I would guess, be better off with a smaller MAXSCSIUSAGE value
#  as less task switching would (should in theory at least, right?) be
#  needed to transfer data over the SCSI bus.
#  Note: I added a bit of debugging code to find this value by trial and
#  error.  You can perform the same trial and error method by running
#  NewPop, if the I/O graph never peaks then lower MAXSCSIUSAGE.  If it
#  peaks to often then raise MAXSCSIUSAGE.
MAXSCSIUSAGE        55

#  Number of pixels wide the disk I/O monitor (the left one) should be.
SCSIIOMONWIDTH        100

#  Number of pixels wide the CPU load monitor (the right one) should be.
CPULOADMONWIDTH        100

#  Number of pixels between end of CPU load monitor and
#  start of disk I/O monitor.
GAPBETWEEN2        16

#  Number of pixels between time and start of load monitor.
GAPBETWEEN        16

#  Size of font to use for title bar clock.
FONTSIZE        9

#  STARTYOFFSET is how far down the baseline of the date should be from
#  the top of the window.  If FONTNAME, FONTSIZE or WINDOWHEIGHT is
#  changed then play with this number until the date looks right :-).
#  It should be about:
#  WINDOWHEIGHT - ((WINDOWHEIGHT - font_height_in_pixels(not FONTSIZE!))/2).
#  For exmaple ``Helvetica'' size 9 is 6 pixels high! Go figure.
STARTYOFFSET        7

#  This is the maximum value that the TextLength function
#  can return for all possible dates!  For fixed fonts
#  MAXTEXTWIDTH is just horizontal_character_size_in_pixels * 24.
#  Newpop supports proportional fonts, you just have to do
#  a little leg work to figure this number out for them.
#  Hint: most well designed proportional fonts use a
#  standard size for all numbers (Knuth, MF), thus this should
#  be easy to calculate for a well designed proportional
#  font.  Helvetica.font (size 9) as distributed by Commodore
#  is well designed.  Helvetica.font (size 9) as distributed
#  by Gold Disk is not well designed, all the numbers have
#  a different length, thus the date will jump about every
#  second as it is updated, not pretty, not my or Commodore's
#  fault.
#  Install the nice Commodore fonts from the Extras disk from
#  1.3 (maybe 1.2 also), or else good luck to you (and be sure
#  to recalculate MAXTEXTWIDTH :-).
#  PS: Nothing bad will happen if this number is too small,
#  text will just flow off the end of the window.
#  OK, OK, OK:  Instead of you doing the grunt work, I have
#  supplied - ``CalcTextWidth.c'' - which will determine the
#  MAXTEXTWIDTH value for a given font and size.
#  To find this number, run CalcTextWidth and answer the
#  questions it asks, this parameter will pop out! :-)
MAXTEXTWIDTH        107

#  Change if more gadgets are ever added to WBScreen, or
#  in 2.0's case, you may actually want to lower this number!
#  STARTXOFFSET is the distance from the right edge of the titlebar
#  window to the right edge of the workbench screen.
STARTXOFFSET        56

#  Should most likely be the (real WB) titlebar height - 3.
#  I know under 2.0 all bets are off as to it's real height,
#  thus for now it is hard coded.  Once I get 2.0, all this
#  will be fixed up.  Be careful setting this! (Should be 8, for
#  standard 1.3 and below system)
WINDOWHEIGHT        8

#  Time (in seconds) before the screen blanker kicks in.
TIMEOUT            180

#  The default key (69 is Escape) needed with left Amiga in order to pop.
POPKEY            69

#  BLANKERPRIORITY is the priority to run the Q*X graphics code at.
#  This is only used if NICENEWPOP is set to TRUE.
BLANKERPRIORITY        -20

#  Aris B. and John C., these options are for you!
#  ULC, LLC, LRC, URC tell NewPop what to do when the mouse
#  pointer enters the respectively; upper left, lower left, lower
#  right and upper right corners of the screen.  0 means do nothing,
#  1 means autoblank, 2 means defeatblank.
#  Using these options one can turn off auto and defeat-blanking
#  by setting them all to 0.
ULC 0
LLC 0
LRC 2
URC 1