home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 1 / HamRadio.cdr / misc / geoclk41 / geoclock.doc < prev    next >
Text File  |  1990-01-08  |  77KB  |  1,915 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.            Universal Version of Geographic Clock Program
  25.  
  26.            Copyright 1988,1989,1990 (C) Joseph R. Ahlgren
  27.  
  28.            GEOCLOCK is a registered Trademark
  29.  
  30.            Version 4.1    90/01/08
  31.  
  32.            GEOCLK41.ZIP - EGA/VGA/800x600 version
  33.            GEOMNO41.ZIP - CGA/HGC/MCGA/ATT400/PC3270 version
  34.  
  35.            Computer Bulletin Board -  703-241-7980
  36.  
  37.  
  38.  
  39.                               Joseph R. Ahlgren
  40.                               2218 N. Tuckahoe St
  41.                               Arlington, VA  22205-1946
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                                         - 1 -
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  74.  
  75.  
  76.  
  77.  
  78.                                   Table Of Contents
  79.  
  80.      A.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  81.  
  82.      B.    Getting Started . . . . . . . . . . . . . . . . . . . . . . . . .   3
  83.           B.1.  EGA/VGA/SVGA version (GEOCLK)  . . . . . . . . . . . . . . .   4
  84.           B.2.  CGA/HGC/MCGA/ATT400/PC3270 version (GEOMNO)  . . . . . . . .   4
  85.           B.3.  Mouse  . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  86.           B.4.  Preparing the registered version . . . . . . . . . . . . . .   6
  87.           B.5.  Upgrading from version 2.x . . . . . . . . . . . . . . . . .   6
  88.  
  89.      C.    Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  90.           C.1.  Single key functions . . . . . . . . . . . . . . . . . . . .   7
  91.           C.2.  Commands . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  92.           C.3.  Command line parameters  . . . . . . . . . . . . . . . . . .  14
  93.  
  94.      D.    Customizing . . . . . . . . . . . . . . . . . . . . . . . . . . .  15
  95.           D.1.  Time zone data . . . . . . . . . . . . . . . . . . . . . . .  15
  96.           D.2.  Cities in GEOCLOCK.DAT and GEO<n>.DAT  . . . . . . . . . . .  16
  97.           D.3.  Default parameters in GECONFIG.DAT . . . . . . . . . . . . .  16
  98.  
  99.      E.    Functions for registered users only . . . . . . . . . . . . . . .  16
  100.           E.1.  Zoom . . . . . . . . . . . . . . . . . . . . . . . . . . . .  17
  101.           E.2.  Distance . . . . . . . . . . . . . . . . . . . . . . . . . .  17
  102.           E.3.  Time display for cities  . . . . . . . . . . . . . . . . . .  17
  103.  
  104.      F.    Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  18
  105.           F.1.  GEOCLKnn.ZIP . . . . . . . . . . . . . . . . . . . . . . . .  18
  106.           F.2.  GEOMNOnn.ZIP . . . . . . . . . . . . . . . . . . . . . . . .  18
  107.  
  108.      G.    Technical Information . . . . . . . . . . . . . . . . . . . . . .  19
  109.           G.1.  Ephemeris Data . . . . . . . . . . . . . . . . . . . . . . .  19
  110.           G.2.  Use of Color . . . . . . . . . . . . . . . . . . . . . . . .  20
  111.           G.3.  Software structure . . . . . . . . . . . . . . . . . . . . .  21
  112.           G.4.  Map Generation System  . . . . . . . . . . . . . . . . . . .  22
  113.  
  114.      H.    Changes from previous versions  . . . . . . . . . . . . . . . . .  22
  115.  
  116.      I.    Bulletin Board  . . . . . . . . . . . . . . . . . . . . . . . . .  27
  117.  
  118.      J.    Upgrades and Enhancements for Registered Users  . . . . . . . . .  27
  119.  
  120.      K.    Registration and License  . . . . . . . . . . . . . . . . . . . .  27
  121.  
  122.  
  123.  
  124.  
  125.                                         - 2 -
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  140.  
  141.  
  142.      A.  Introduction
  143.  
  144.           GEOCLOCK shows the current time (based on the system clock) with a map
  145.      of the earth.  The current sun position is displayed with a crossed circle,
  146.      and the part of the earth in sunlight is highlighted.  This display is
  147.      automatically updated every 1 second (for an 8 MHz AT with an 80287) to 20
  148.      seconds (for a 5 MHz PC without an 8087).  Local sunrise, sunset, and the
  149.      sun's azimuth and elevation are also displayed.  A variety of map
  150.      backgrounds and other options are available.  A graphics adapter and a hard
  151.      disk are required to run GEOCLOCK.
  152.  
  153.         GEOCLOCK is distributed as SHAREWARE.  If you use and enjoy the product,
  154.      you must register and obtain a license for the program.  The license
  155.      includes a few extra features and more maps.  See section K.  The
  156.      unregistered version of the program may be distributed freely, provided
  157.      that the entire unmodified ZIP file is included and no fee is charged other
  158.      than a nominal amount for media and handling.
  159.  
  160.      B.    Getting Started
  161.  
  162.           GEOCLOCK requires a hard disk, a minimum of 180K available RAM (up to
  163.      250K to use VGA and 800x600 modes), and a graphics adapter and monitor.
  164.  
  165.           There are two versions of GEOCLOCK.  The first is contained in
  166.      GEOCLK41.ZIP and is designed to support computers with a 256k EGA, VGA, or
  167.      super VGA board with a compatible color monitor.  The second requires both
  168.      GEOMNO41.ZIP and GEOCLK41.ZIP and is designed to support CGA, Hercules,
  169.      MCGA, AT&T 640x400, and PC3270 graphics, all in the highest resolution
  170.      monochrome mode available for that card.  To get the program running, do
  171.      the following:
  172.           1.  Un-ZIP GEOCLK41.ZIP (and GEOMNO41.ZIP if required) to the
  173.      directory you will run from.  It is best to have a directory dedicated to
  174.      GEOCLOCK.
  175.           2.  Set up the program for your graphics adapter.  Section B.1
  176.      describes the set up procedure for the EGA, VGA, and super VGA (800x600)
  177.      adapters.  Section B.2 describes the set up procedure for the CGA,
  178.      Hercules, MCGA, PC3270, and AT&T 640x400 adapters.
  179.           3.  Customize GEOCLOCK for your location.  Much customization is
  180.      possible, and is described in detail in sections D and E.  Before you start
  181.      running GEOCLOCK, you should edit (using any text editor) the GECONFIG.DAT
  182.      file to specify your local time zone.  The value in the initial file
  183.      specifies the Eastern US time zone.  You should change the PCZONE command
  184.      at the end of GECONFIG.DAT to specify your time zone.
  185.           4.  If you are a registered user, you need to run the REGISTER program
  186.      to enable the special features.  You may also want to use a mouse - see
  187.      section B.3.
  188.  
  189.  
  190.  
  191.                                         - 3 -
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  206.  
  207.  
  208.           5.  Run the program.  Just enter GEOCLK (for EGA, VGA, and SVGA) or
  209.      GEOMNO (for the other adapters) and the program will start.  Function Key 1
  210.      will provide help, and Escape will terminate the program.
  211.  
  212.      B.1.  EGA/VGA/SVGA version (GEOCLK)
  213.  
  214.           The EGA/VGA/SVGA version of GEOCLOCK requires an EGA, VGA, super VGA
  215.      (800x600) or close compatible with at least 256k memory, and an EGA, VGA,
  216.      or multiscanning color monitor.  The program uses 640x350, 640x480, and
  217.      800x600 16 color graphics.  The distribution GEOCLK41.ZIP file contains all
  218.      the required programs and data bases.  The main program file is named
  219.      GEOCLK.EXE.  It will automatically determine whether or not you have a math
  220.      co-processor (8087,80287, 80387), and use it if you do, or emulate it if
  221.      you do not.  If you have a normal EGA, the program is already configured
  222.      properly.  If you have a VGA or SVGA, you will need to follow one of the
  223.      procedures below:
  224.  
  225.           1.  Set up for VGA or 640x480x16 EGA.  To enable 640x480 display, you
  226.      must include the VGA statement in the GECONFIG.DAT file.  This statement
  227.      tells GEOCLOCK that you have a 640x480 display and how to enter that
  228.      display mode.  You will find a commented out VGA statement at the end of
  229.      the GECONFIG.DAT file.  Simply use any text editor to remove the "REM " at
  230.      the beginning of the VGA statement, so that the "V" is in column one.  If
  231.      you have a 640x480x16 EGA, you will need to contact your adapter supplier
  232.      to determine the appropriate parameters for the VGA statement.  See section
  233.      C.2 for a fuller explanation.  You might also want to add the SHOWVGA
  234.      statement to GECONFIG.DAT.  This will automatically convert EGA maps to VGA
  235.      format.
  236.  
  237.           2.  Set up for super VGA (800x600x16).  To enable 800x600 display, you
  238.      must include the SVGA statement in the GECONFIG.DAT file.  This statement
  239.      tells GEOCLOCK that you have a 800x600 display and how to enter that
  240.      display mode.  You will find several commented out SVGA statements at the
  241.      end of the GECONFIG.DAT file, corresponding to the several adapters that
  242.      support this graphics mode.  Simply use any text editor to remove the "REM
  243.      " at the beginning of the appropriate SVGA statement, so that the "S" is in
  244.      column one.  If your adapter is not listed, you will need to contact your
  245.      adapter supplier to determine the appropriate parameters for the SVGA
  246.      statement.  See section C.2 for a fuller explanation.  It is not necessary
  247.      to include a VGA statement in addition to the SVGA statement unless your
  248.      adapter does not use the standard command to enter the 640x480x16 mode.
  249.  
  250.      B.2.  CGA/HGC/MCGA/ATT400/PC3270 version (GEOMNO)
  251.  
  252.           This version of GEOCLOCK is compatible with a wide variety of graphics
  253.      boards, including all those two color modes supported by the Turbo Pascal
  254.      5.0 GRAPH unit.  In particular, 640x200 CGA, 720x348 HGC, 640x480 MCGA,
  255.      640x400 ATT, and 720x350 PC3270 mode are supported.  The 640x350 EGA
  256.  
  257.                                         - 4 -
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  272.  
  273.  
  274.      monochrome mode is NOT supported (this is a four color mode), although the
  275.      EGA emulation of HGC is supported provided your EGA board permits this. 
  276.      The distribution GEOMNO41.ZIP and GEOCLK41.ZIP files contain all the
  277.      required programs and data bases.  
  278.  
  279.           After Un-ZIPping the program, the files configuring the system for
  280.      your graphics adapter must be built.  The installation program GEOCONVT
  281.      builds these files, installs the proper drivers, and converts the maps to
  282.      the required format.  This program in started by:
  283.  
  284.           GEOCONVT <board type> [map file spec] [switches]
  285.  
  286.      where board type is CGA, HGC, MCG, ATT, or 327.  The [map file spec]
  287.      specifies which map files are to be converted to the format for your
  288.      adapter.  If omitted, MAP*.EGA is assumed.  The switches are zero or more
  289.      of /D (which specifies that files not required for your particular adapter
  290.      are to be deleted) and /C (which specifies that map files are to be
  291.      converted, but no other conversions are to be done).  By default, neither
  292.      option is selected.  Specifying /D saves space on your disk, but be sure
  293.      that you have kept a backup or the original ZIP file before selecting this
  294.      option.  You should specify /C is you are already running GEOMNO and only
  295.      need to convert a new map file.  For the initial setup, I recommend:
  296.  
  297.           GEOCONVT CGA    (or whatever adapter is appropriate)
  298.  
  299.      without any options.  You can do a    del map*.ega     to eliminate the
  300.      unneeded EGA map files after you are sure that everything is working
  301.      properly.
  302.  
  303.      B.3.  Mouse
  304.  
  305.           Several GEOCLOCK functions require a graphics cursor for input.  These
  306.      operate from both a mouse and the keyboard.  To use the mouse, the INT 33
  307.      driver must be loaded.  This driver, which comes with most mice, is usually
  308.      called MOUSE.COM or MOUSE.SYS.  The mouse buttons and functions are
  309.      emulated on the keyboard as follows:
  310.  
  311.          Left Mouse Button           Control (CTRL) and Page-Up keys
  312.          Center Mouse Button         Escape (ESC) Key
  313.          Right Mouse Button          Alternate (ALT) and Page-Down keys
  314.          Mouse Motion                Arrow and Shift-Arrow keys
  315.  
  316.           All the keyboard equivalents work whether or not a mouse is available. 
  317.      In particular, the arrow keys may be used to finely position the cursor
  318.      after the mouse has moved the cursor to the vicinity of the desired point,
  319.      and the Escape key can be used if your mouse does not have a center button.
  320.  
  321.      B.4.  Preparing the registered version
  322.  
  323.                                         - 5 -
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  338.  
  339.  
  340.  
  341.           The registered version of GEOCLOCK includes an INSTALL batch file to
  342.      aid in setting up GEOCLOCK on your hard disk.  The batch file un-Zips all
  343.      the required files (include map files), converts the maps as required, and
  344.      runs the REGISTER program which enables the special features such as Zoom,
  345.      Distance, and city time display that are available only to registered
  346.      users.  If you do not wish to use this batch file, follow these steps:
  347.           a.  Create a directory for GEOCLOCK on your hard disk, and switch to
  348.      it.  Copy the PKUNZIP.EXE program from the distribution disk to this
  349.      directory.
  350.           b.  Un-Zip the GEOCLOCK program by entering PKUNZIP A:GEOCLK41 .  If
  351.      your are using the MNO version, also enter PKUNZIP A:GEOMNO41 .
  352.           c.  Un-ZIP all the map files by entering PKUNZIP A:MAP* .  If you
  353.      received multiple disks, you should repeat this command for every disk.
  354.           d.  If you are using a VGA or 800x600, enter PKUNZIP A:VGA* .  If you
  355.      are using an 800x600, also enter PKUNZIP SVGA* .
  356.           e.  Un-Zip the GEODATA file.
  357.           f.  If you are using the MNO version, enter GEOCONVT <code>, where
  358.      code is CGA, HGC, MCG, ATT, or 327 as appropriate.  This converts all the
  359.      maps to the proper MNO format.
  360.           g.  Copy the REGISTER.EXE file to the hard disk and enter REGISTER . 
  361.      This enables the special features.
  362.           h.  Finally, use the TED editor to customize the configuration.  Enter
  363.      TED GECONFIG.DAT .  Change the PCZONE command to your time zone.  If you
  364.      have a VGA or 800x600, add the VGA command.  If you have an 800x600, also
  365.      add the SVGA command.
  366.  
  367.      B.5.  Upgrading from version 2.x
  368.  
  369.           Version 4.x contains many new features which require changes in some
  370.      of the 2.x files for optimum operation.  3.x files do not require any
  371.      conversion.  Existing 2.x data files will work but cannot take advantage of
  372.      these new features.  The conversion process effects four types of files.
  373.             a.  MAP<n>.EGA.  This only effects the EGA/VGA version of GEOCLOCK. 
  374.      The map format was changed to reduce the sizes of the map files.  While
  375.      GEOCLOCK 4.x will display both file formats, processing of the new format
  376.      is faster.  The program CVTMAP.EXE, available on the GEOCLOCK bulletin
  377.      board, will convert the old to new format.  To convert your existing maps,
  378.      follow this procedure:
  379.          DEL *.BAK
  380.          COPY MAP*.EGA MAP*.BAK
  381.          CVTMAP MAP*.BAK *.EGA
  382.          DEL *.BAK
  383.             b.  GECONFIG.DAT.  This file was required only for GEOMNO in version
  384.      2.x.  In version 4, this file optionally contains a list of command line
  385.      parameters (one per line).  In addition, two new commands are of particular
  386.      interest: ZONE, which defines time zone characteristics; and PCZONE, which
  387.      defines which time zone the PC's local clock is in.  The GECONFIG.DAT file
  388.  
  389.                                         - 6 -
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  404.  
  405.  
  406.      provided should be used until you feel the need to change it.  GEOCONVT
  407.      appends any existing GECONFIG.DAT file (including the one provided in
  408.      GEOMNOnn.ZIP) to the one it produces while setting up GEOMNO.  See section
  409.      D.
  410.             c.  GEOCLOCK.DAT and GEO<n>.DAT.  The format of these files has been
  411.      enhanced to take advantage of the time zone data.  The old first line,
  412.      which specifies the displayed zone and its relationship to the PC clock, is
  413.      now optional.  If it is omitted, it is assumed that PC local time is to be
  414.      displayed, as specified by the PCZONE command.  If a zone code is named,
  415.      that is the local time displayed.  On the subsequent lines, for registered
  416.      users, the time offset (specified by +n or -n after the !) may be specified
  417.      as <space><zone code> or <space>*<zone code>, in which case the city time
  418.      is displayed in the time zone specified by the zone code.  If * is
  419.      included, the time zone name is also displayed.  See section D.
  420.             d.  *.BGI files must be replaced with new versions, since version 4
  421.      was compiled under Turbo Pascal 5.0.  These are included in GEOMNOnn.ZIP.  
  422.  
  423.      C.    Operation
  424.  
  425.           To run GEOCLOCK, simply enter "GEOCLK" or "GEOMNO".  The initial
  426.      display is built, and then this display is updated continuously.  The
  427.      program recognizes a variety of functions while running.  Each of these is
  428.      activated by pressing a letter key.  These functions are summarized below. 
  429.  
  430.  
  431.      C.1.  Single key functions
  432.  
  433.             Function Key 1 - activates the help system.  The first screen is a
  434.      menu listing all the GEOCLOCK parameters and keys.  Select a menu item by
  435.      pressing the indicated letter displays additional information.  You exit
  436.      the additional information screen and display the main menu by pressing any
  437.      key.  You exit the help system and return to GEOCLOCK display or parameter
  438.      entry by pressing any non-letter key.
  439.  
  440.             F - speed up the rate of change of time per display update. A prompt
  441.      asks for the number of hours (possibly fractional or negative) for the
  442.      displayed clock to be incremented during each cycle, e.g., 0.25 for 15
  443.      minutes every 1 to 20 second cycle.
  444.  
  445.             U - set the interval between screen updates.  A prompt asks for the
  446.      update interval in seconds.  When this value is entered, the display is
  447.      immediately drawn.  Subsequently, the screen in updated at the specified
  448.      interval and synchronized with the clock.  Thus, if 15 is specified, the
  449.      screen will be updated at 0, 15, 30, and 45 seconds past the minute.  If
  450.      your computer is not fast enough to achieve this update interval, the
  451.      smallest integer multiple of this interval which works will be used.
  452.  
  453.  
  454.  
  455.                                         - 7 -
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  470.  
  471.  
  472.             T - change the display time according to prompts in yy/mm/dd
  473.      hh:mm:ss format.  This does not change the system clock.  Any missing data
  474.      will revert to the current local time.  Thus "///12:0:0" sets the time to
  475.      today at 12 noon, while 88 01 01 0 0 0 sets the time to midnight, January
  476.      1, 1988.  All times in GEOCLOCK use the 24 hour format.
  477.  
  478.             R - restore the display time to the current time, and the display
  479.      update rate to real time.  R undoes F, T, and U.
  480.  
  481.             P - allows changes to the command line parameters.  These commands
  482.      are listed in section C.2 below.  Entering "?" or "HELP" at the prompt will
  483.      activate the help system.
  484.  
  485.             S - select a map.  When this key is pressed, a list of available
  486.      maps is displayed with their coordinates, title, and North-South distance. 
  487.      The highlighted line corresponds to the current map.  The cursor keys can
  488.      be used to scroll through this list.  When the <ENTER> key is pressed, the
  489.      highlighted map will be displayed.  Some very early GEOCLOCK maps did not
  490.      have titles.  If you have any of these maps, the FIXMAP program, available
  491.      on the GEOCLOCK RBBS (703-241-7980) will add the proper titles.
  492.  
  493.             X - return to DOS.
  494.  
  495.             Escape - return to DOS.
  496.  
  497.      C.2.  Commands
  498.  
  499.             GEOCLOCK allows several command line parameters which control the
  500.      display.  These parameters may also be entered in response to prompts from
  501.      the "p" function above, included on the DOS command line, included in the
  502.      GECONFIG.DAT file, or included in a GEO*.DAT file.  The DCGE column
  503.      indicates any restrictions on the command.  "D" indicates that this command
  504.      is the initial condition of GEOCLOCK when it is started.  "C" indicates
  505.      that the command may be included on the GEOCLOCK command line.  "G"
  506.      indicates the command remains in effect until overridden by another command
  507.      (otherwise the effect of the command is automatically removed when the
  508.      displayed map is changed).  Finally, "E" indicates that the command has
  509.      effect only in the EGA/VGA/SVGA (GEOCLK) version.
  510.                      
  511.  
  512.      command     DCGE  comments
  513.  
  514.      ?           ----  displays list of commands.
  515.                               
  516.  
  517.      HELP        ----  displays list of commands.
  518.                               
  519.  
  520.  
  521.                                         - 8 -
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  536.  
  537.  
  538.      REM         -C--  remark.  The rest of the parameter is ignored.
  539.  
  540.  
  541.      MAP         -C--  MAP (without a number) brings up the map selection menu,
  542.                        similar to the "S" command.  This may be entered on the
  543.                        command line or in the GECONFIG.DAT file, in which case
  544.                        the map selection menu will be displayed before the
  545.                        program starts.
  546.  
  547.      NOMAP       -CG-  does not display any background map.
  548.  
  549.  
  550.      MAPn        -CG-  displays appropriate map.  Map1 is the default.  The
  551.                        GEO*.ZIP files include two maps.  MAP1 is a rectilinear
  552.                        projection of the entire Earth.  MAP2 is a map of the 48
  553.                        states.  The EGA/VGA/SVGA version also includes MAP2000,
  554.                        which is a North Polar projection map.  Other maps are
  555.                        available as detailed in section K.  Polar projection
  556.                        maps work only with the EGA/VGA/SVGA version of GEOCLOCK.
  557.  
  558.      NOSCR       -C-E  This command forces EGA maps to be handled the same way
  559.                        VGA and SVGA maps are handled.  In particular, only one
  560.                        display frame is used, so the smooth animation is lost,
  561.                        but the display update is somewhat faster, and the yellow
  562.                        sun symbol rather than the dark crossed circle is used to
  563.                        indicate sun position.
  564.  
  565.      SHOWVGA     -C-E  This command causes all EGA maps to be automatically
  566.                        expanded (by duplicating some rows) to VGA resolution and
  567.                        displayed as VGA maps.  This does not change the map
  568.                        resolution, but does change the text and sunlight
  569.                        resolution.
  570.  
  571.      SHOWSVGA    -C-E  This command causes all EGA and VGA maps to be
  572.                        automatically expanded (by duplicating some rows and
  573.                        pixels within rows) to SVGA resolution and displayed as
  574.                        SVGA maps.  This does not change the map resolution, but
  575.                        does change the text and sunlight resolution.
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.                                         - 9 -
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  602.  
  603.  
  604.      VGAa/b/c/d  -C-E  This enables VGA display.  If this command is not
  605.                        included in the GECONFIG.DAT file, VGA maps may not be
  606.                        displayed.  The arguments indicate decimal the values to
  607.                        be loaded into the AX, BX, CX, and DX registers before
  608.                        the call to INT 10 to enter VGA mode.  For true VGAs, the
  609.                        parameters are optional: VGA18/0/0/0 is assumed.  Check
  610.                        with you display adapter supplier if you are not sure of
  611.                        the correct parameters to use.  DO NOT include this
  612.                        command unless you have a 640x480 EGA, a VGA, or super
  613.                        VGA adapter and a VGA or multisync monitor: your monitor
  614.                        may be damaged if it does not support the vertical and
  615.                        horizontal frequencies generated by the VGA.
  616.  
  617.      SVGAa/b/c/  -C-E  This enables SVGA (800x600) display.  If this command is
  618.      d                 not included in the GECONFIG.DAT file, SVGA maps may not
  619.                        be displayed.  The arguments indicate the values to be
  620.                        loaded into the AX, BX, CX, and DX registers before the
  621.                        call to INT 10 to enter SVGA mode.  For the Paradise
  622.                        SVGA, the parameters are optional: SVGA88/0/0/0 is
  623.                        assumed.  Check with you display adapter supplier if you
  624.                        are not sure of the correct parameters to use.  DO NOT
  625.                        include this command unless you have a super VGA adapter
  626.                        and a multisync monitor: your monitor may be damaged if
  627.                        it does not support the vertical and horizontal
  628.                        frequencies generated by the SVGA.
  629.  
  630.      MARK        -CG-  displays markers for the cities in geo*.dat.  See section
  631.                        D.3
  632.  
  633.      NOMARK      DCG-  does not display city markers or city names.
  634.  
  635.  
  636.      NOCITY      DCG-  does not display city names for the cities in geo*.dat.
  637.  
  638.  
  639.      CITY        -CG-  displays city names.
  640.  
  641.  
  642.      QUIET       DCG-  does not beep on screen update.
  643.  
  644.  
  645.      SOUND       -CG-  beeps each time the screen is updated.
  646.  
  647.  
  648.      NOLINE      DCG-  does not display any latitude/longitude lines.
  649.  
  650.  
  651.  
  652.  
  653.                                         - 10 -
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  668.  
  669.  
  670.      LINEnn      -CG-  displays latitude/longitude lines every nn degrees,
  671.                        unless that would result in more than 40 lines.  If nn is
  672.                        0 or missing, the current latitude and longitude line
  673.                        intervals are not changed but lines are enabled, and thus
  674.                        LINE undoes NOLINE.
  675.  
  676.      TLINCnn     -CG-  same as LINEnn, except only affects Latitude lines.
  677.  
  678.  
  679.      GLINCnn     -CG-  same as LINEnn, except only affects Longitude lines.
  680.  
  681.  
  682.      TLSPECnn    -CL-  displays one latitude line at nn.
  683.  
  684.  
  685.      GLSPECnn    -CL-  displays one longitude line at nn.  Up to 20 TLSPEC and
  686.                        GLSPEC lines may be specified.
  687.  
  688.  
  689.      CLINE       DCG-  removes all TLSPEC and GLSPEC lines.
  690.  
  691.  
  692.      HIDELL      DCG-  does not label latitude/longitude lines
  693.  
  694.  
  695.      SHOWLL      DCG-  labels latitude/longitude lines
  696.  
  697.  
  698.      DRAWLINE    --L-  This command draws a line between (lat1,long1) and
  699.      lat1 long1        (lat2,long2) on the current map.  All latitudes and
  700.      lat2 long2        longitudes are in degrees and fractions.  The command
  701.      color             operates on when contained in a GEO*.DAT file that is
  702.                        processed for the map.  Color is the color in which the
  703.                        line will be drawn.  See section G.2 for an explanation
  704.                        of the use of color.  If omitted, color defaults to 5,
  705.                        which is displayed as yellow.  Example:
  706.                        DRAWLINE 38.9 -77.0 34.0 -118.3 0
  707.                        draws a line between Washington DC and Los Angeles in
  708.                        color 0.
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.                                         - 11 -
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  734.  
  735.  
  736.      DRAWCIRCLE  --L-  This command draws an ellipse centered at
  737.      latcenter         (latcenter,longcenter) and with latitude (vertical)
  738.      longcenter        radius latcenter and with longitude (horizontal) radius
  739.      latradius         longcenter.  All latitudes and longitudes are in degrees
  740.      longradius        and fractions.  The command operates on when contained in
  741.      color             a GEO*.DAT file that is processed for the map.  Color is
  742.                        the color in which the line will be drawn.  See section
  743.                        G.2 for an explanation of the use of color.  If omitted,
  744.                        color defaults to 5, which is displayed as yellow. 
  745.                        Example:  DRAWCIRCLE  38.9  -77.0  10 20 6
  746.                        draws an oval centered on Washington DC that is 10
  747.                        degrees from the center to the northernmost point, and 20
  748.                        degrees from the center to the easternmost point, and in
  749.                        color 6.
  750.  
  751.      INCLUDE     ----  When contained in a GEO*.DAT file, this command suspends
  752.      <file>            reading from the file being processed, and processes all
  753.                        commands in the <file>.  When all commands in that file
  754.                        have been processed, reading resumes from the original
  755.                        file.  INCLUDE may be nested up to ten levels.  Include
  756.                        may also be used in response to the "P" command.  In this
  757.                        case, the named file will be included at the end of the
  758.                        GEOn.DAT file for the map currently displayed.  The
  759.                        effect of this command will be negated when a new map is
  760.                        selected or a new file is specified with INCLUDE.
  761.  
  762.      NORM        -CG-  highlights sunlit area.
  763.  
  764.  
  765.      REV         -CG-  highlights area not sunlit (appropriate for LCD displays)
  766.  
  767.  
  768.      LIGHT       -CG-  highlights entire screen, and does not show sun symbol.
  769.  
  770.  
  771.      DARK        -CG-  highlights no area, and does not show sun symbol.
  772.                  
  773.  
  774.      FLICKER     -C-E  This command forces GEOCLOCK to bypass the video BIOS and
  775.                        issue changes to the video memory start address and
  776.                        palette directly to the video hardware.  This is
  777.                        necessary to prevent flickering or blinking of the
  778.                        display on some graphics adapters.
  779.  
  780.      NOBLINK     -C-E  This command prevents the markers from blinking on the
  781.                        "D"istance screen.  You may want to use the MCOLOR
  782.                        command with NOBLINK to improve marker readability.
  783.  
  784.  
  785.                                         - 12 -
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  800.  
  801.  
  802.  
  803.      MCOLORxxyy  -C-E  MCOLOR sets the colors of the Markers on the "D"istance
  804.                        screen.  Marker 1 is set to xx, and Marker 2 is set to
  805.                        yy.  For example, MCOLOR5962 sets Marker 1 to 59 (bright
  806.                        cyan) and Marker 2 to 62 (yellow).
  807.  
  808.      SHOWCH      DCGE  display screens as they are built
  809.  
  810.      HIDECH      -CGE  displays screens only after they are completed.
  811.  
  812.      PS2BUG      -CGE   use if, with SHOWCH set, the display goes blank during
  813.                        GEOCLOCK operation or after GEOCLOCK termination.  This
  814.                        works around an error in the PS/2 VGA BIOS.
  815.  
  816.      NORAM       DCGE  use if map display is trashed.  This option adds
  817.                        approximately 25K to the memory required to execute
  818.                        GEOCLK.
  819.  
  820.      USERAM      -CGE  use if there is insufficient RAM to run GEOCLOCK.  This
  821.                        option moves the disk buffer to an area within the VIDEO
  822.                        RAM.  Some EGA boards, including the ATI EGA wonder, are
  823.                        not compatible with the DMA-s of some computers, and this
  824.                        option will cause the display to be trashed or will cause
  825.                        disk errors.  USERAM is also not compatible with the VGA
  826.                        and SVGA, and may lead to map display errors.
  827.  
  828.  
  829.      SHOWMN      -CG-  displays the map number and name in the upper right hand
  830.                        corner.  This data may overlap the latitude/longitude
  831.                        display.
  832.  
  833.      HIDEMN      DCG-  does not display map name and number.
  834.  
  835.  
  836.      FULL        DCG-  displays local location, time, and full ephemeris data.
  837.  
  838.  
  839.      SUN         -CG-  displays location, time, and sunrise/sunset data
  840.  
  841.  
  842.      TIME        -CG-  displays local date and time at bottom of screen.
  843.  
  844.  
  845.      NONE        -CG-  displays no text data.
  846.  
  847.  
  848.  
  849.  
  850.  
  851.                                         - 13 -
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  866.  
  867.  
  868.      SUNANGLEx   -CG-  sets the elevation angle of the sun used to compute
  869.                        sunrise and set.  The default is -0.8333 degree,
  870.                        corresponding to the sun just breaking the horizon
  871.                        considering refraction effects.  SUNANGLE-6.0 sets this
  872.                        angle to -6 degrees, which defines civil sunrise and set. 
  873.                        -12 is Nautical sunrise and sunset, while -18 is
  874.                        Astronomical sunrise and sunset.  This parameter does not
  875.                        effect the terminator line calculations.
  876.  
  877.      ZONE        --G-  defines a time zone.  See section D.2.
  878.  
  879.  
  880.      PCZONE      --G-  defines the time zone the PC's clock is in.  See D.2.
  881.  
  882.  
  883.      EQUINOX     -CG-  allows the exact GMT of an equinox to be specified (e.g.,
  884.                        EQUINOX 88/09/22 17:29).  This data is used to calibrate
  885.                        the sun position calculation to improve the accuracy near
  886.                        the equinoxes (while degrading it far from the
  887.                        equinoxes).  Personally, I do not think this is a very
  888.                        good idea, but I am tired of defending my position.  The
  889.                        current system computes equinoxes within a few minutes.
  890.  
  891.      CSET        --GE  allows the screen colors to be changed interactively.
  892.  
  893.      COLORnxxyy  -CGE  changes screen color without interaction.  "n" specifies
  894.                        the feature number (0- 7) to be changed.  Feature number
  895.                        n will display color xx, and feature n+8 will display
  896.                        color yy.  Thus COLOR56262 will cause feature numbers 5
  897.                        and 13 to display as 62 (bright yellow).  See Section G.2
  898.                        for a explanation of how color is used in GEOCLOCK.
  899.  
  900.      FAST        -CG-  Forces GEOCLOCK to use a faster but slightly less
  901.                        accurate algorithm for drawing the sunlit area.  This is
  902.                        the default for systems without an 80x87.
  903.  
  904.      SLOW        -CG-  Forces GEOCLOCK to use the high accuracy algorithm for
  905.                        drawing the sunlit area.  This is the default for systems
  906.                        with an 80x87.  On systems with an 80x87, the difference
  907.                        in speed between SLOW and FAST is negligible, while on
  908.                        those systems without an 80x87, FAST is approximately
  909.                        twice the speed of SLOW.  These options do not effect
  910.                        polar projection maps.
  911.                      
  912.  
  913.      C.3.  Command line parameters
  914.  
  915.  
  916.  
  917.                                         - 14 -
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  932.  
  933.  
  934.           Any of the commands (other than ZONE, PCZONE, CSET, DRAWLINE,
  935.      DRAWCIRCLE, and INCLUDE) in section C.2 above may be entered on the command
  936.      line that invokes GEOCLOCK.  These commands will be in effect when GEOCLOCK
  937.      begins, and override commands placed in the GECONFIG.DAT file.
  938.  
  939.      D.    Customizing
  940.  
  941.           After the program has been extracted and is operating, you may wish to
  942.      customize it for your computer.  The primary way to customize the program
  943.      is through some special text files.  These files can be customized with any
  944.      text editor.  GECONFIG.DAT describes your graphics system, defines the time
  945.      zones, and gives the default setting for the program.  The GEOCLOCK.DAT and
  946.      GEO<n>.DAT files specify the cities and time zones to be displayed with
  947.      each map.  Sample GECONFIG.DAT and GEOCLOCK.DAT files are provided with the
  948.      program, and you examine these examples to help you prepare your own custom
  949.      versions.
  950.  
  951.      D.1.  Time zone data
  952.  
  953.           Time zones are user defined in GEOCLOCK.  Each zone (e.g., Eastern) is
  954.      specified by giving its code name (e.g., ET), the names of summer and
  955.      standard times (e.g., EDT and EST), the number of hours the time is ahead
  956.      of GMT (e.g., -4 and -5), and the times between which summer time is in
  957.      effect (e.g., 88/04/24 8:00:00 GMT and 88/10/30 8:00:00 GMT).  The zones
  958.      are referenced by their code names, and thus the zone data need only be
  959.      updated once per year (sometime during the winter) and in only one place
  960.      (where the zones are specified).  It is most convenient to include the zone
  961.      specifications in the GECONFIG.DAT file.  If the ZONE commands are not for
  962.      the correct year, GEOCLOCK will automatically update them by changing each
  963.      date to the closest date in the correct year which falls on the same day of
  964.      the week.  For example, 89/10/29 would change to 90/10/28, since both days
  965.      fall on Sunday.  This update is not necessarily correct, and I recommend
  966.      that the ZONE commands be kept current.
  967.  
  968.          The ZONE command takes 7 parameters: 1) a code name for the time zone
  969.      (referenced by PCZONE, and GEO<n>.DAT files), 2) the name of the standard
  970.      time, 3) the number of hours standard time is ahead of GMT (thus negative
  971.      for US locations), 4) the name of the summer (daylight) time, 5) the number
  972.      of hours summer time is ahead of GMT, 6) the date and time (GMT) to switch
  973.      from standard to summer time, in the format yy/mm/dd:hh:mm:ss, with
  974.      trailing data optional (e.g., 88/10/30:8), 7) the date and time (GMT) to
  975.      switch from summer time to standard time.  If a zone does not change during
  976.      the year, the last four parameters may be omitted.  This command is best
  977.      used in the GECONFIG.DAT file.
  978.  
  979.           The PCZONE command sets the relationship between the local time on the
  980.      PC's clock and GMT, i.e., declares which time zone the PC's clock is in. 
  981.      It takes one parameter - a time zone code, as defined in the ZONE command. 
  982.  
  983.                                         - 15 -
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  998.  
  999.  
  1000.      This command is best used in the GECONFIG.DAT file, and it must follow the
  1001.      ZONE command that it references.
  1002.  
  1003.  
  1004.  
  1005.      D.2.  Cities in GEOCLOCK.DAT and GEO<n>.DAT
  1006.  
  1007.           Cities may be overlaid on the maps.  They are specified in GEO<n>.DAT
  1008.      files.  For map number n (e.g., 2, the 48 states map), these cities are
  1009.      read from GEOn.DAT (e.g., GEO2.DAT) if that file exists.  If the file does
  1010.      not exist, cities are read from GEOCLOCK.DAT.
  1011.           The first entry in a GEO<n>.DAT file specifies the time zone code to
  1012.      be used for the standard time display.  It consists of a line with a single
  1013.      zone code.  If this line is omitted, the code for PCZONE is used. 
  1014.      Ordinarily, this code should match the time zone code for the first city in
  1015.      the file.
  1016.           Following this time zone entry, command line parameters may be
  1017.      optionally included.  The command line parameters will be processed after
  1018.      both the command line and the GECONFIG.DAT file parameters, and thus will
  1019.      override entries there.  The command REM may be used to add comments to the
  1020.      file.  
  1021.           Subsequent entries in the file specify the name and locations of
  1022.      cities to be displayed.  Each entry consists of the latitude, longitude,
  1023.      and name of the city.  Latitude and longitude are in degrees and fractions
  1024.      (NOT degrees, minutes, and seconds), with North and East positive.  Thus,
  1025.      most US locations have positive latitude and negative longitude.  The first
  1026.      city specified is used for calculating the sunrise, sunset, and the azimuth
  1027.      and elevation angles for the sun.
  1028.  
  1029.      D.3.  Default parameters in GECONFIG.DAT
  1030.  
  1031.           The GECONFIG.DAT file may be used to specify default setting and time
  1032.      information.  If you are using GEOMNO, the first four lines must be as
  1033.      written by the GEOCONVT program.  They give specification data for your
  1034.      graphics system.  Subsequent lines contain command line parameters.  There
  1035.      should be no leading spaces on these subsequent lines.  This file is
  1036.      processed BEFORE the command line parameters are executed, so the command
  1037.      line will override parameters specified here.  If you have a VGA or
  1038.      800x600, the VGA and SVGA commands should be in GECONFIG.DAT.
  1039.  
  1040.      E.    Functions for registered users only
  1041.  
  1042.           The following functions are available to registered users only.  See
  1043.      section K for details on how to register.
  1044.  
  1045.      E.1.  Zoom
  1046.  
  1047.  
  1048.  
  1049.                                         - 16 -
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  1064.  
  1065.  
  1066.           This function allows the user to change the map background using the
  1067.      cursor.  A mouse or the arrow keys can be used.  To invoke the function,
  1068.      press the letter Z.  The screen will be stabilize without any time or
  1069.      sunlight information, and an Iron-Cross type cursor will appear.  Use the
  1070.      mouse and/or arrow keys (shift-arrows move 8 times faster than non-shifted
  1071.      arrows) to locate a position on the map.  Each press of the right or left
  1072.      button on the mouse, or CONTROL or ALTERNATE keys, or Page-Up or Page-Down
  1073.      keys on the keyboard, will switch to a new map containing that point.  The
  1074.      left button "zooms in" while the right button "zooms out."  The cursor will
  1075.      remain at the specified latitude/longitude during the switch.  When the
  1076.      desired map is displayed, press the middle button or the ESCAPE key to
  1077.      return to time display.  This function is available only to registered
  1078.      users.
  1079.  
  1080.      E.2.  Distance and Azimuth
  1081.  
  1082.             This function provides a display of the coordinates of three
  1083.      selected points, and the distances between them, as controlled by a mouse
  1084.      or the keyboard.  The function is invoked by pressing the letter D.  Point
  1085.      1 is selected by the left button of the mouse or the CONTROL key or Page-Up
  1086.      key on the keyboard.  Point 2 is selected by the right button or the
  1087.      ALTERNATE key or the Page-Down key.  Point 3 is the current cursor
  1088.      position.  To return to the time display, press the middle button or
  1089.      ESCAPE.  To maintain smooth cursor movement, the distance and coordinate
  1090.      displays are updated only when the cursor is not moving.  Pressing the "."
  1091.      key will display coordinates in degrees and fractions, while the "'" key
  1092.      will display coordinates is degrees, minutes, and seconds.  Pressing "A"
  1093.      will display the azimuth between the two points (the azimuth at the first
  1094.      toward the second, and the azimuth at the second toward the first, with
  1095.      North 0 and East 90) and the distance in kilometers, while pressing "D"
  1096.      will display the distance between the points in miles and kilometers. 
  1097.      These functions are available only to registered users.
  1098.  
  1099.      E.3.  Time display for cities
  1100.  
  1101.           For registered users only, additional control over city placement,
  1102.      color, size, and local time display is possible.  All are marked by
  1103.      characters appearing after an exclamation point (!) on a city line in
  1104.      GEO<n>.DAT.  This new data consists of an optional string of  characters as
  1105.      follows:
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.                                         - 17 -
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  1130.  
  1131.  
  1132.           A - show city name Above mark
  1133.           B - show city name Below mark
  1134.           L - show city name Left of mark
  1135.           R - show city name Right of mark (if none of above specified, use
  1136.      best)
  1137.           Y - show city name in color 5 (Yellow by default)
  1138.           E - show city name in 8x14 font (8x8 by default)
  1139.           number - show city name in color number (e.g., 6 shows city name in
  1140.      color 6).
  1141.  
  1142.           After these optional codes, the line may be optionally followed by a
  1143.      space and a time zone code.  If included, this specifies that the local
  1144.      time for that city is to be displayed to the right of the city name.  If a
  1145.      "*" is included, the name of the time zone will be displayed in addition to
  1146.      the time.  For example:
  1147.  
  1148.                        ET
  1149.         38.90   -77.02  Washington !E
  1150.         42.65   -73.75  Albany NY !Y
  1151.         35.08  -106.65  Albuquerque NM ! *MT
  1152.         42.28   -83.75  Ann Arbor MI !A
  1153.         33.75   -84.39  Atlanta GA 
  1154.         44.30   -69.76  Augusta ME 
  1155.         33.52   -86.81  Birmingham AL ! CT
  1156.         46.80  -100.78  Bismarck ND !B *CT
  1157.  
  1158.      F.    Files
  1159.  
  1160.      F.1.  GEOCLKnn.ZIP
  1161.  
  1162.          GEOCLOCK.DOC   This file.
  1163.          GEOCLOCK.DAT   An example of a customization file for GEOCLOCK.  See
  1164.      section B.3 for the details of the contents of this file.
  1165.          GECONFIG.DAT   A starter for the configuration file for GEOCLOCK.  See
  1166.      section D for details.
  1167.          GEOCLK.EXE     GEOCLOCK version for EGA, VGA, and super VGA.
  1168.          MAP1.EGA       EGA database for MAP1 (world).
  1169.          MAP2.EGA       EGA database for MAP2 (48 states).
  1170.          MAP2000.EGA    EGA database for MAP2000 (North Polar Projection).
  1171.          MAILER.        Printer file to aid registration.
  1172.  
  1173.      Two other ZIP files are available to support GEOCLK for the VGA and SVGA. 
  1174.      VGA1-2.ZIP contains MAP4001 (VGA world) and MAP4002 (VGA 48 states). 
  1175.      SVGA1-2.ZIP contains MAP6149 (SVGA world) and MAP6002 (SVGA 48 states).
  1176.  
  1177.      F.2.  GEOMNOnn.ZIP
  1178.  
  1179.          README.MNO     Instructions for setup of GEOMNO.
  1180.  
  1181.                                         - 18 -
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  1196.  
  1197.  
  1198.          GEOMNO.EXE     GEOCLOCK version for two color graphics.
  1199.          GEOCONVT.EXE   Installation program to select drivers and font files,
  1200.      write configuration file, and convert maps to specific graphics format. 
  1201.      See section B.2 for instructions on the operation of this program.
  1202.          *.BGI          Various graphics drivers (Turbo Pascal 5.0).
  1203.          *.FON          Various font files.
  1204.  
  1205.      G.    Technical Information
  1206.  
  1207.      G.1.  Ephemeris Data and Accuracy.
  1208.  
  1209.          The ephemeris data in GEOCLOCK was derived by fitting data from
  1210.      "Interactive Computer Ephemeris" (ICE) to two twelfth order polynomials. 
  1211.      One polynomial computes the sun's latitude, while the other computes the
  1212.      sun's longitude at noon GMT.  Both assume a 365.242199 day year.  They were
  1213.      made by a least squares fit to 400 points around 1989 data.  In this
  1214.      interval, the maximum and RMS latitude errors are 0.016845 and 0.004049
  1215.      degrees, while the maximum and RMS longitude errors are 0.059805 and
  1216.      0.016630 degrees.  The fit has been tested against 1986 sun rise and set
  1217.      data, and with 1985 through 2000 spring equinox times, and is within a few
  1218.      minutes in time, but obviously there are no guarantees of the accuracy. 
  1219.      ICE is available on many astronomy bulletin boards, or from:
  1220.  
  1221.                Nautical Almanac Office
  1222.                Code FA
  1223.                U. S. Naval Observatory
  1224.                Washington, DC 20392
  1225.  
  1226.          The terminator is shown as the locations where the horizon bisects the
  1227.      sun without regard to atmospheric effects, so the sunrise occurs earlier
  1228.      and the sunset occurs later than the terminator indicates.  The sun rise
  1229.      and sun set times are computed as the times that the sun's center is a
  1230.      specified angle above or below the horizon, without regard for atmospheric
  1231.      effects.  The default value, -0.8333, corresponds to civil sun rise and
  1232.      set, where the visible edge of the sun just breaks the horizon.
  1233.  
  1234.           Some future version of GEOCLOCK may include the moon, planets, and
  1235.      artificial satellites.  This requires a few pascal routines that I just do
  1236.      not have the time to develope.  If anyone can help me with the routines
  1237.      below I will be grateful.
  1238.  
  1239.  
  1240.      {Global Variables that are set by other software }
  1241.      var
  1242.        JulianDate: real;  {Julian Date/Time, 
  1243.                            with 89/01/01 0:0:0 GMT = 16072.0000}
  1244.        SunZenithLatitude: real;  {geographic latitude of the sun at JulianDate}
  1245.        SunZenithLongitude: real; {geographic longitude of the sun at JulianDate}
  1246.  
  1247.                                         - 19 -
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  1262.  
  1263.  
  1264.      {Special Types}
  1265.      type
  1266.        ObjectType =    
  1267.      (Moon,Mercury,Venus,Mars,Jupiter,Saturn,Uranus,Neptune,Pluto);
  1268.        ElementType = record
  1269.          SatelliteName:       string;
  1270.          EpochTime:           real {JulianDate/Time};
  1271.          Inclination:         real {degrees};
  1272.          RAofNode:            real {Degrees};
  1273.          Eccentricity:        real {dimensionless};
  1274.          ArgOfPerigee:        real {degrees};
  1275.          MeanAnomaly:         real {degrees};
  1276.          MeanMotion;          real {revolutions/day};
  1277.          DecayRate:           real {revolutions/day/day};
  1278.          EpochRev:            integer {dimensionless};
  1279.          SemiMajorAxis:       real {kilometers};
  1280.          end;
  1281.      procedure SkyPosition( ObjectID: ObjectType;
  1282.                           var ZenithLatitude, ZenithLongitude: real);
  1283.      { returns the earth (not sun) latitude and longitude (not right
  1284.      ascension and declination) where the specified object is at Zenith.}
  1285.  
  1286.      procedure CalculateSatellitePosition( var Elements: ElementType;
  1287.                                            var Lat,Long,Alt: real);
  1288.       {Calculates the earth centered latitude, longitude, and altitude
  1289.        of the satellite described by "Elements" at time JulianDate.
  1290.        Lat" and "Long" are in degrees (East longitude positive), and "Alt"
  1291.        is in kilometers}
  1292.  
  1293.  
  1294.      G.2.  Use of Color
  1295.  
  1296.           The EGA graphics adapter provides for the simultaneous display of 16
  1297.      colors from a palette of 64.  Most programs use the default palette, which
  1298.      roughly corresponds to the colors provided by the CGA in text mode.  The
  1299.      EGA/VGA/SVGA version of GEOCLOCK does not use this standard palette.  The
  1300.      16 numbers specifying a color from the color palette are used to represent
  1301.      16 features displayed by GEOCLOCK.  The use of the 16 feature numbers is as
  1302.      follows: 
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.                                         - 20 -
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  1328.  
  1329.  
  1330.          feature       use            feature+8        use
  1331.  
  1332.             0    Political Bdy (dark)    8       Political Bdy (light)
  1333.             1    Water (dark)            9       Water (light)
  1334.             2    Land (dark)            10       Land (light)
  1335.             3    Land/Water Bdy (dark)  11       Land/Water Bdy (light)
  1336.             4    Text Background (dark) 12       Text Background (light)
  1337.             5    Aux Text Color (dark)  13       Aux Text and Sun (light)
  1338.             6    Lat/Long Lines (dark)  14       Lat/Long Lines (light)
  1339.             7    Frame and Text         15       Frame and Text
  1340.  
  1341.            The actual colors displayed are determined by the formula:
  1342.       color value = B + 2*G + 4*R + 8*b + 16*g + 32*r, where   
  1343.             B  = bright blue              b = dim blue
  1344.             G  = bright green             g = dim green
  1345.             R  = bright red               r = dim red
  1346.  
  1347.           Some typical colors are:
  1348.         name              RGBrgb      color value
  1349.  
  1350.         black             ------         0
  1351.         white             RGBrgb        63
  1352.         dark blue         -----b         8
  1353.         blue              --B---         1
  1354.         light blue        --Brgb        57
  1355.         dark green        ----g-        16
  1356.         green             -G----         2
  1357.         light green       -G-rgb        58
  1358.         brown             R---g-        20
  1359.         light yellow      RG-rgb        62      
  1360.         red               R-----         4
  1361.         bright red        R--rgb        60
  1362.  
  1363.      G.3.  Software structure
  1364.  
  1365.           GEOCLOCK is written entirely in Turbo Pascal version 5.0, except for
  1366.      the mouse interface routines and a few inline sections required for speed. 
  1367.      It has approximately 7300 lines of source code.  It uses 8 byte reals for
  1368.      most calculations, and thus relies on the 80x87 emulation package for
  1369.      systems without a math co-processor.  The EGA/VGA/SVGA version uses a
  1370.      custom graphics package which provides access to special hardware features
  1371.      (such as independent control of screen planes, disk I/O directly to the
  1372.      video memory, fast fill, and preserving the graphics memory during text
  1373.      display) that are not available in the EGAVGA.BGI driver.  The monochrome
  1374.      version uses the GRAPH unit, and builds a screen image in RAM before
  1375.      copying the image in its entirety to video memory.  The GRAPH unit
  1376.      functions other than PUTIMAGE are not used except for a few special
  1377.  
  1378.  
  1379.                                         - 21 -
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  1394.  
  1395.  
  1396.      applications, such as drawing the graphics cursor, and updating the
  1397.      position and distance displays in the distance function.
  1398.  
  1399.      G.4.  Map Generation System
  1400.  
  1401.           The maps used for the GEOCLOCK program were produced by a custom data
  1402.      base and software system.  This system consists of a highly compressed
  1403.      vectorized map data base and a set of programs to convert the data into
  1404.      custom maps.  The data base is a PC conversion of World Data Bank II.  It
  1405.      contains approximately 5.7 million vectors covering coastlines, islands,
  1406.      lakes, rivers, and similar geologic features, together with political
  1407.      boundary data.  It covers the entire earth, and included features are
  1408.      accurate to approximately 600 meters.  World Data Bank II was converted to
  1409.      this custom PC format by an ad hoc program which took advantage of specific
  1410.      features of both data bases.  In its operational form, the PC data base
  1411.      uses approximately 0.84 bytes per data point, and in archival form takes
  1412.      approximately 0.5 bytes per data point.  The data base is therefore easily
  1413.      stored and manipulated on an AT class PC.
  1414.  
  1415.           Custom maps are generated by using two programs.  The first, MAPGEN,
  1416.      reads the appropriate parts of the map data base and produces separation
  1417.      files of the required feature data as EGA or VGA raster images. 
  1418.      Rectangular, polar, or Lambert projections may be used in forming these
  1419.      separation files.  Depending on complexity and scale, this process takes
  1420.      between 30 and 300 seconds on an AT with a co-processor.  The second,
  1421.      MOVIE, allows the user to process the separation files to select the
  1422.      features and colors for the final map, including filling areas.  This
  1423.      program also writes the map in a rasterized compressed format with headers
  1424.      and trailers so that it may be easily used as background data for other
  1425.      programs (for example, the GEOCLOCK program).
  1426.  
  1427.           Both these programs, and the converted data base, are proprietary and
  1428.      not yet available to the general public.  World Data Bank II is available
  1429.      from National Technical Information Center, Springfield, VA, for about
  1430.      $1000 on 5 reels of tape.
  1431.  
  1432.      H.    Changes from previous versions
  1433.  
  1434.      H.1.  Version 2.3 to version 2.4
  1435.  
  1436.           CSET, Zoom, and Distance functions were added.
  1437.           If GEO<n>.DAT exists, it is used for city and time zone information
  1438.      when displaying MAP<n>.EGA, otherwise GEOCLOCK.DAT is used, e.g., GEO2.DAT
  1439.      is used while displaying MAP2.EGA.
  1440.           If the system detects hardware incompatibility, a prompt for
  1441.      proceed/abort is given.  A few EGA boards, and apparently the IBM VGA
  1442.      board, are not properly detected by this program.  However, they do  appear
  1443.      to work.
  1444.  
  1445.                                         - 22 -
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  1460.  
  1461.  
  1462.  
  1463.      H.2.  Version 2.4 to version 2.5
  1464.  
  1465.           The two color graphics version of GEOCLOCK was made compatible with
  1466.      EGA version and will be distributed as GEOMNOnn.ZIP.
  1467.           Offset from local PC time to display time added.
  1468.           Latitude and Longitude Lines were added with the LINE parameter.  MAP1
  1469.      has been modified to remove the lines so that all maps are under the
  1470.      control of this feature.
  1471.           Graphics hardware detection software removed.  As opposed to most
  1472.      software changes, this "feature" has proven to be only an annoyance.  If
  1473.      you do not have proper graphics hardware to support the version, the
  1474.      results are unpredictable.  A fatal message is still issued if the version
  1475.      requires an 80x87 but your system does not have one. 
  1476.  
  1477.      H.3.  Version 2.5 to version 2.6
  1478.  
  1479.           Version 2.5 was not distributed correctly.  Version 2.6 corrects this
  1480.      error.  The version 2.5 code does not execute correctly on systems without
  1481.      a Numeric Co-Processor.
  1482.  
  1483.      H.4.  Version 2.6 to version 2.7
  1484.  
  1485.           The code which generates latitude and longitude lines was improved to
  1486.      give additional control over line colors.
  1487.           An option to label the latitude and longitude lines was added.  The
  1488.      latitude lines are drawn from North to South.
  1489.           The function "CSET" was added to the non-registered version of the
  1490.      program.
  1491.           The registration of the markers and the location names was improved
  1492.      for the EGA version.  Cities whose names would overlap cities already
  1493.      displayed are suppressed.
  1494.           The processing of Longitudes was generalized so that maps with 180
  1495.      degrees in as an interior longitude can be processed.  The processing for
  1496.      the zoom function was generalized to preserve cursor locations for these
  1497.      maps.
  1498.           The DARK and LIGHT options were added to the display control.
  1499.           The SHOWCH and HIDECH options were added.  The use of the display
  1500.      buffer was improved in the EGA version.     
  1501.           A function giving a help screen when function key F1 is pressed was
  1502.      added.
  1503.  
  1504.      H.5.  Version 2.7 to version 2.8
  1505.  
  1506.           The TIMEB command was added to display time and time zone name at the
  1507.      bottom of the screen.
  1508.           The COLOR command was added to change the palette without interacting
  1509.      with CSET.
  1510.  
  1511.                                         - 23 -
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  1526.  
  1527.  
  1528.           The implementation of city name was changed to allow longer city
  1529.      names.
  1530.           Users can control the position, font size, and color of city names
  1531.      (registered users only).  These features were extended to include the
  1532.      monochrome version.
  1533.           Local time for each city may be displayed (registered users only).    
  1534.  
  1535.           Precision of the cursor used for zoom and distance improved.
  1536.           The SHOWMN and HIDEMN commands were added to display the map name and
  1537.      number on screen.
  1538.           The PS2BUG command was added to help users work around a bug in the
  1539.      PS/2 VGA BIOS.  Some changes in screen handling were made to minimize the
  1540.      effect of this problem even when PS2BUG is not selected.
  1541.           The speed of the non-80x87 version was substantially improved
  1542.      (approximately 1/3 faster) by reorganizing the terminator line
  1543.      calculations.
  1544.  
  1545.      H.6.  Version 2.8 to version 3.0
  1546.  
  1547.           The handling of time zones was completely revised.  The GECONFIG.DAT
  1548.      file contains the descriptions of all world time zones, including the names
  1549.      of summer and standard times, their offsets from GMT, and the times of the
  1550.      year that summer time is in effect.  The GEO<n>.DAT file formats were make
  1551.      consistent with this standard.  Therefore, all time zone information can be
  1552.      concentrated in one place, and the GEO<n>.DAT files can refer to this
  1553.      information symbolically.  The old format is still accepted, but mixing the
  1554.      two is not recommended.
  1555.           The map file format, and the display palette, were changed to reduce
  1556.      map file size and drawing time.  The program CVTMAP was developed to
  1557.      convert the old map file format to the new map file format.  Conversion is
  1558.      not required but is recommended.
  1559.           A problem affecting the distance measuring function, and use of the
  1560.      mouse, for the hercules and ATT 400 versions was fixed.
  1561.           A problem which sometimes caused city name and time data to overwrite
  1562.      the legend data at the bottom of the screen was fixed.
  1563.           The control of the "zoom" feature was improved so that the left button
  1564.      "zooms-in" and the right button "zooms-out".
  1565.           A serious error in GEOCONVT affecting the MCGA mode was fixed.  That
  1566.      is problem was not noticed earlier tells me that the MCGA is not exactly
  1567.      widely used!
  1568.           The format of the GECONFIG.DAT file was extended so that the default
  1569.      command line parameters can be set and time zone characteristics can be
  1570.      defined.
  1571.           The separate versions for systems with and without math co-processors
  1572.      were eliminated.  The program automatically detects the math co-processor,
  1573.      and uses it or emulates it as appropriate.  This slows the program slightly
  1574.      but reduces the size of the distribution file dramatically.  The FAST and
  1575.  
  1576.  
  1577.                                         - 24 -
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  1592.  
  1593.  
  1594.      SLOW parameters were added to control the method used to draw the
  1595.      terminator (the FAST method is much faster on systems without an 80x87).
  1596.           The EQUINOX parameter was added to optionally improve the accuracy of
  1597.      GEOCLOCK near the equinoxes, although this degrades the overall accuracy of
  1598.      the program.
  1599.  
  1600.      H.7.  Version 3.0 to 3.1
  1601.  
  1602.           The NORAM and USERAM command line parameters were added, and the
  1603.      default was changed to NORAM.
  1604.           The calculation of sun rise and sun set times was improved, especially
  1605.      in areas in extreme latitudes.  The display uses "Dark all day" or "Light
  1606.      all day" when the sun never rises or sets.  The parameter SUNANGLE was
  1607.      added to allow the definition of sun rise and set to be changed.
  1608.           Support for polar projection maps was added to the EGA/VGA version. 
  1609.      It is not available in the MNO version.
  1610.           The response time for a key press during the generation of the next
  1611.      display frame was greatly decreased.  Except during a fill operation on the
  1612.      polar projection maps, the response to a key press should be less than 0.3
  1613.      seconds.
  1614.           A larger marker for the two fixed points in the distance function was
  1615.      incorporated, replacing the almost invisible symbols.
  1616.  
  1617.      H.8.  Version 3.1 to 3.2
  1618.  
  1619.           The accuracy of the sun position calculations was improved.  It is now
  1620.      within about 5 minutes (time) in both latitude and longitude for the rest
  1621.      of the 20th century.  Section G.1 gives details.
  1622.           The accuracy of the distance calculation was improved.  Distances are
  1623.      calculated on a sphere with the same volume as the Earth, i.e., with radius
  1624.      6371.22 kilometers.
  1625.           The control over latitude and longitude line placement was greatly
  1626.      enhanced with the addition of the GLINC, TLINC, GLSPEC, TLSPEC, and CLINE
  1627.      commands.  See section C.2.
  1628.           The symbols used in the distance function now blink.
  1629.           The help system was completely revised.  Pressing F1 or ? or "H"
  1630.      during GEOCLOCK display brings up a menu.  Selecting a menu item brings up
  1631.      more detailed information.
  1632.           The REM command was added to allow users to document their GEOn.DAT
  1633.      files, and commands will be processed from GEOCLOCK.DAT and GEOn.DAT files
  1634.      in addition to GECONFIG.DAT.
  1635.           A bug that sometimes caused ZOOM and DISTANCE to ignore cities in the
  1636.      GEOn.DAT files was fixed.
  1637.           The GEOCONVT program was improved to allow map file conversions,
  1638.      control file deletion and GECONFIG.DAT processing from the command line,
  1639.      and another MCGA problem was fixed.  The speed of the map conversion
  1640.      process was doubled.
  1641.  
  1642.  
  1643.                                         - 25 -
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  1658.  
  1659.  
  1660.      H.9.  Version 3.2 to 3.3
  1661.  
  1662.           The tab character is now treated as a space in the input files.
  1663.           The map select (S) function was added.
  1664.           The update interval (U) function was added.
  1665.  
  1666.      H.10. Version 3.3 to 3.4
  1667.  
  1668.           The DRAWLINE, DRAWCIRCLE, and INCLUDE commands were added.
  1669.           All files are opened for read-only, so all files used by GEOCLOCK can
  1670.      have the READ-ONLY attribute.  This simplifies the use of GEOCLOCK in
  1671.      networks.
  1672.           Command processing was changed so that the effects of commands in the
  1673.      GEOn.DAT files are local to MAPn.
  1674.           The speed of the "S" command was improved.
  1675.           The sun drawing system was changed so that the sun symbol is not
  1676.      displayed unless it is on the map being displayed.
  1677.           The ZONE commands are automatically updated when the year changes.
  1678.           The program assumes that the PC-s clock will remain in the time zone
  1679.      in effect at the time the program is started.
  1680.  
  1681.      H.11.  Version 3.4 to 4.0
  1682.  
  1683.           Support for the VGA 640x480 and SVGA 800x600 modes was added.  This
  1684.      includes the NOSCR, SHOWVGA, VGA, and SVGA commands.  The use of color was
  1685.      changed slightly to support these new modes.  The sun symbol was changed to
  1686.      a color 5 symbol in the VGA and SVGA modes, and in EGA mode when NOSCR is
  1687.      specified.  The NOSCR also solves the screen blinking problem found on some
  1688.      EGAs.
  1689.           An azimuth computation facility was added to the "D" function, as was
  1690.      the option of displaying coordinates in degrees and fractions.
  1691.           An option to sort the maps appearing in the "S" command was added. 
  1692.      The sort used also determines in what order maps will be selected when
  1693.      using the "Zoom" function.  
  1694.           The list of maps used by "S" and "Z" is written to a file, which
  1695.      greatly speeds up the first use of these functions.
  1696.           The INCLUDE function can be used as a "P" command.
  1697.           The Page-Up and Page-Down keys were added as synonyms for the left and
  1698.      right mouse buttons, and "Enter" was added as a synonym for the mouse
  1699.      center button.  Mouse handling was changed so that the INT33 mouse driver
  1700.      does not have to specifically support VGA and 800x600 to use these modes.
  1701.           Any color can be used for city names, rather than just colors 5 and 7.
  1702.           Support of the polar projection maps was added to the MNO version.
  1703.        
  1704.      H.12.  Version 4.0 to 4.1
  1705.  
  1706.           This was primarily a maintenance release for GEOCLOCK 4.0.  The
  1707.      FLICKER and NOBLINK directives were added to (I hope) finally end all the
  1708.  
  1709.                                         - 26 -
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  1724.  
  1725.  
  1726.      flicker problems.  Also, an error in GEOCONVT.EXE was fixed that
  1727.      occasionally caused maps to be incorrectly converted.
  1728.           The SHOWSVGA directive was added, similar to SHOWVGA.
  1729.           The processing speed for long GE*.DAT and INCLUDE files was greatly
  1730.      improved.
  1731.           The accuracy of the terminator line with using the FAST directive (the
  1732.      default for systems without a co-processor) was improved.  This is
  1733.      especially noticeable on small maps.
  1734.           The MAP directive was added to enable the map selection menu to be
  1735.      displayed when the program is first started.
  1736.           The MCOLOR directive was added to allow control over the color of the
  1737.      Markers with the distance function.
  1738.  
  1739.      I.    Bulletin Board
  1740.  
  1741.          A free Remote Bulletin Board System (RBBS) provides support for users
  1742.      of the GEOCLOCK sunlight clock program.  It always has the latest and
  1743.      untainted version of GEOCLOCK available for downloading.  In addition, it
  1744.      provides a forum for all interested parties for program and information
  1745.      exchange concerning GEOCLOCK, high quality graphics for the IBM PC, high
  1746.      quality mapping for the IBM PC, and Turbo Pascal.  Information on potential
  1747.      applications and needs is as important as information on techniques and
  1748.      software.  The board is intended to help identify and solve real problems.
  1749.          Registered GEOCLOCK users have access to certain special files and
  1750.      higher access limits.  Please have your registration number handy when you
  1751.      log on for the first time.  Otherwise, the messages and files on the board
  1752.      are available to everyone.
  1753.          I also solicit comments and suggestions.  I am especially interested in
  1754.      including position and phase data for the moon and perhaps other planets.
  1755.          The RBBS number is 703-241-7980.  This is a Washington DC metro area
  1756.      number.
  1757.  
  1758.      J.    Upgrades and Enhancements for Registered Users
  1759.  
  1760.          The GEOCLOCK bulletin board always has the latest version of GEOCLOCK,
  1761.      and a variety of extra map files and utilities available.  In addition,
  1762.      many other bulletin boards and shareware distribution services also carry
  1763.      the latest version of GEOCLOCK.  Registered users may obtain the latest
  1764.      version from any of these sources.  When a new version is released, replace
  1765.      the files you originally received with the new versions.  The REGISTER
  1766.      program, supplied on your distribution disks, must be rerun to enable the
  1767.      special features such as ZOOM and DISTANCE that are available only to
  1768.      registered users.  If you have customized any of the GE*.DAT files, you may
  1769.      want to use the old versions of these files, or to edit the new versions to
  1770.      reflect your specific requirements.
  1771.  
  1772.      K.    Registration and License
  1773.  
  1774.  
  1775.                                         - 27 -
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  1790.  
  1791.  
  1792.          The GEOCLOCK program is distributed as Shareware.  This means that
  1793.      prospective users may use the program for a short evaluation period before
  1794.      deciding whether to purchase it.  A license must be obtained to use any
  1795.      copy after this evaluation period.  By sending $30 to the address below, a
  1796.      user will receive a single copy license, the latest version of the program,
  1797.      a registration program which will enable a few special features in the
  1798.      GEOCLOCK program not available in the evaluation version (see section E), a
  1799.      file with the name, latitude, and longitude of many world cities for
  1800.      building GEOCLOCK.DAT files, a "starter set" of GEO*.DAT files, and 28
  1801.      maps.
  1802.  
  1803.           The prices for the GEOCLOCK program are:
  1804.  
  1805.            1 copy              $30
  1806.            2-9 copies          $25/license
  1807.            10-20 copies        $20/license
  1808.            21-40 copies        $15/license
  1809.            site license        $600 for unlimited use at a single site.
  1810.  
  1811.           These prices assume that the purchaser will produce the authorized
  1812.      copies from a single master copy.
  1813.  
  1814.           GEOCLOCK is normally shipped on two 360K 5.25" floppy disks.  It is
  1815.      available on a 720K 3.5" floppy disk for an additional $5.00.  
  1816.  
  1817.           For an additional $20, a set of at least 15 supplemental maps will be
  1818.      included, and the next major release of the program will be mailed when it
  1819.      becomes available.  All these items are available for downloading at no
  1820.      charge from the GEOCLOCK support RBBS.  See section I.
  1821.  
  1822.           Please add $5.00 for shipping and handling for destinations outside
  1823.      the US and Canada.  Cash or checks in US funds draw on US banks only.
  1824.  
  1825.           The file MAILER can be printed to give both a registration form and an
  1826.      envelope.
  1827.  
  1828.           Additional custom rectangular maps can be produced from my existing
  1829.      database for $30 per map.  Simply specify the latitude and longitude of the
  1830.      center point, and the north to south distance on the map (the map will be
  1831.      scaled so that distances and azimuths are correct in the center of the
  1832.      map), or the latitude and longitudes of the corner points.  Custom maps
  1833.      based on user supplied feature data or other projections (the GEOCLOCK
  1834.      program only uses flat rectangular and polar projections, but Lambert and
  1835.      perspective projections are available) are possible but must be negotiated
  1836.      on a case-by-case basis.
  1837.  
  1838.  
  1839.  
  1840.  
  1841.                                         - 28 -
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.      Joseph R. Ahlgren           GEOCLOCK version 4.1                   90/01/08
  1856.  
  1857.  
  1858.                                     Maps included with registration:
  1859.  
  1860.      MAP1    World                     MAP2    48 States
  1861.      MAP3    Eastern US                MAP4    SouthWestern US
  1862.      MAP5    Western Europe            MAP6    Alaska
  1863.      MAP7    New York City Area        MAP8    Finer Scale NYC
  1864.      MAP9    SouthEastern US           MAP10   NorthWestern US
  1865.      MAP11   Chicago Area              MAP12   Texas
  1866.      MAP13   Washington DC             MAP14   Carolinas
  1867.      MAP15   Pennsylvania              MAP16   New England
  1868.      MAP17   Central America           MAP18   South America
  1869.      MAP19   Africa                    MAP20   Australia
  1870.      MAP21   India                     MAP22   Middle East
  1871.      MAP23   Micronesia                MAP24   Japan
  1872.      MAP25   China                     MAP2000 North Polar Map           
  1873.      MAP2001 North Polar Map 45        MAP2002 South Polar Map
  1874.      MAP4001 VGA world                 MAP4002 VGA 48 states
  1875.      MAP6149 SVGA world                MAP6002 SVGA 48 states
  1876.  
  1877.                                     Maps included with optional supplemental
  1878.      disk:
  1879.  
  1880.      MAP26   North Central Europe      MAP27   Western Europe
  1881.      MAP28   North Central Europe      MAP30   San Francisco Area
  1882.      MAP31   USSR                      MAP32   North Atlantic
  1883.      MAP33   Scandinavia               MAP34   Highlands and Islands
  1884.      MAP35   Southern California       MAP37   Southern California
  1885.      MAP38   Sierra Nevada             MAP54   Canada
  1886.      MAP71   The Aegean Sea            MAP77   Silicon Valley
  1887.      MAP92   British Isles             MAP100  Switzerland
  1888.      MAP104  Prince William Sound      MAP131  Mexico
  1889.      MAP149  World Version 3  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.                                Joseph R. Ahlgren
  1895.                               2218 N. Tuckahoe St
  1896.                               Arlington, VA  22205-1946
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.                                         - 29 -
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.