home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 1 / HamRadio.cdr / misc / geo42 / geoclock.doc < prev    next >
Text File  |  1990-06-20  |  68KB  |  1,233 lines
  1.  
  2.  
  3.  
  4.                                         - 1 -
  5.      Joseph R. Ahlgren           GEOCLOCK version 4.2                   90/06/20
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.            Universal Version of Geographic Clock Program
  27.  
  28.            Copyright 1988,1989,1990 (C) Joseph R. Ahlgren
  29.  
  30.            GEOCLOCK is a registered Trademark
  31.  
  32.            Version 4.2    90/06/09
  33.  
  34.            GEOCLK42.ZIP - EGA/VGA/800x600 version
  35.            GEOMNO42.ZIP - CGA/HGC/MCGA/ATT400/PC3270 version
  36.  
  37.            Computer Bulletin Board -  703-241-7980
  38.  
  39.  
  40.  
  41.                               Joseph R. Ahlgren
  42.                               2218 N. Tuckahoe St
  43.                               Arlington, VA  22205-1946
  44.  
  45.  
  46.                                         - 2 -
  47.      Joseph R. Ahlgren           GEOCLOCK version 4.2                   90/06/20
  48.  
  49.  
  50.  
  51.  
  52.                                   Table Of Contents
  53.  
  54.      A.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  55.  
  56.      B.    Getting Started . . . . . . . . . . . . . . . . . . . . . . . . .   3
  57.           B.1.  EGA/VGA/SVGA version (GEOCLK)  . . . . . . . . . . . . . . .   3
  58.           B.2.  CGA/HGC/MCGA/ATT400/PC3270 version (GEOMNO)  . . . . . . . .   4
  59.           B.3.  Mouse  . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  60.           B.4.  Preparing the registered version . . . . . . . . . . . . . .   5
  61.           B.5.  Upgrading from version 2.x . . . . . . . . . . . . . . . . .   6
  62.  
  63.      C.    Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  64.           C.1.  Single key functions . . . . . . . . . . . . . . . . . . . .   7
  65.           C.2.  Commands . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  66.           C.3.  Command line parameters  . . . . . . . . . . . . . . . . . .  12
  67.  
  68.      D.    Customizing . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  69.           D.1.  Time zone data . . . . . . . . . . . . . . . . . . . . . . .  12
  70.           D.2.  Cities in GEOCLOCK.DAT and GEO<n>.DAT  . . . . . . . . . . .  13
  71.           D.3.  Default parameters in GECONFIG.DAT . . . . . . . . . . . . .  13
  72.  
  73.      E.    Functions for registered users only . . . . . . . . . . . . . . .  13
  74.           E.1.  Zoom . . . . . . . . . . . . . . . . . . . . . . . . . . . .  14
  75.           E.2.  Distance . . . . . . . . . . . . . . . . . . . . . . . . . .  14
  76.           E.3.  Time display for cities  . . . . . . . . . . . . . . . . . .  14
  77.  
  78.      F.    Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  15
  79.           F.1.  GEOCLKnn.ZIP . . . . . . . . . . . . . . . . . . . . . . . .  15
  80.           F.2.  GEOMNOnn.ZIP . . . . . . . . . . . . . . . . . . . . . . . .  15
  81.  
  82.      G.    Technical Information . . . . . . . . . . . . . . . . . . . . . .  15
  83.           G.1.  Ephemeris Data . . . . . . . . . . . . . . . . . . . . . . .  15
  84.           G.2.  Use of Color . . . . . . . . . . . . . . . . . . . . . . . .  17
  85.           G.3.  Software structure . . . . . . . . . . . . . . . . . . . . .  17
  86.           G.4.  Map Generation System  . . . . . . . . . . . . . . . . . . .  18
  87.  
  88.      H.    HAM add-in. . . . . . . . . . . . . . . . . . . . . . . . . . . .  18
  89.  
  90.      I.    Bulletin Board  . . . . . . . . . . . . . . . . . . . . . . . . .  19
  91.  
  92.      J.    Upgrades and Enhancements for Registered Users  . . . . . . . . .  19
  93.  
  94.      K.    Registration and License  . . . . . . . . . . . . . . . . . . . .  20
  95.  
  96.  
  97.                                         - 3 -
  98.      Joseph R. Ahlgren           GEOCLOCK version 4.2                   90/06/20
  99.  
  100.  
  101.      A.  Introduction
  102.  
  103.           GEOCLOCK shows the current time (based on the system clock) with a map
  104.      of the earth.  The current sun position is displayed and the part of the
  105.      earth in sunlight is highlighted.  This display is automatically updated
  106.      every 1 second (for an 8 MHz AT with an 80287) to 20 seconds (for a 5 MHz
  107.      PC without an 8087).  Local sunrise, sunset, and the sun's azimuth and
  108.      elevation are also displayed.  A variety of map backgrounds and other
  109.      options are available.  A graphics adapter and a hard disk are required to
  110.      run GEOCLOCK.  GEOCLOCK is primarily an EGA/VGA/SVGA program, although CGA,
  111.      hercules, MCGA, AT&T 640x400, and PC3270 are supported with some
  112.      limitations.
  113.  
  114.         GEOCLOCK is distributed as SHAREWARE.  If you use and enjoy the product,
  115.      you must register and obtain a license for the program.  The license
  116.      includes a few extra features and more maps.  See section K.  The
  117.      unregistered version of the program may be distributed freely, provided
  118.      that the entire unmodified ZIP file is included and no fee is charged other
  119.      than a nominal amount for media and handling.  A version with special
  120.      features for HAM operators is also available.  See section H.
  121.  
  122.      B.    Getting Started
  123.  
  124.           GEOCLOCK requires a hard disk, a minimum of 200K available RAM (up to
  125.      250K to use VGA and 800x600 modes), and a graphics adapter and monitor.
  126.  
  127.           There are two versions of GEOCLOCK.  The first is contained in
  128.      GEOCLK42.ZIP and is designed to support computers with a 256k EGA, VGA, or
  129.      super VGA boards with a compatible color monitor.  The second requires both
  130.      GEOMNO42.ZIP and GEOCLK42.ZIP and is designed to support CGA, Hercules,
  131.      MCGA, AT&T 640x400, and PC3270 graphics, all in the highest resolution
  132.      monochrome mode available for that card.  To get the program running, do
  133.      the following:
  134.           1.  Un-ZIP GEOCLK42.ZIP (and GEOMNO42.ZIP if required) to the
  135.      directory you will run from.  It is best to have a directory dedicated to
  136.      GEOCLOCK.
  137.           2.  Set up the program for your graphics adapter.  Section B.1
  138.      describes the set up procedure for the EGA, VGA, and super VGA (800x600)
  139.      adapters.  Section B.2 describes the set up procedure for the CGA,
  140.      Hercules, MCGA, PC3270, and AT&T 640x400 adapters.
  141.           3.  Customize GEOCLOCK for your location.  Much customization is
  142.      possible, and is described in detail in sections D and E.  Before you start
  143.      running GEOCLOCK, you should edit (using any text editor) the GECONFIG.DAT
  144.      file to specify your local time zone.  The value in the initial file
  145.      specifies the Eastern US time zone.  You should change the PCZONE command
  146.      at the end of GECONFIG.DAT to specify your time zone.
  147.           4.  If you are a registered user, you need to run the REGISTER program
  148.      to enable the special features.  You may also want to use a mouse - see
  149.      section B.3.
  150.           5.  Run the program.  Just enter GEOCLK (for EGA, VGA, and SVGA) or
  151.      GEOMNO (for the other adapters) and the program will start.  Function Key 1
  152.      will provide help, and Escape will terminate the program.
  153.  
  154.      B.1.  EGA/VGA/SVGA version (GEOCLK)
  155.  
  156.  
  157.                                         - 4 -
  158.      Joseph R. Ahlgren           GEOCLOCK version 4.2                   90/06/20
  159.  
  160.  
  161.           The EGA/VGA/SVGA version of GEOCLOCK requires an EGA, VGA, super VGA
  162.      (800x600) or close compatible with at least 256k memory, and an EGA, VGA,
  163.      or multiscanning color monitor.  The program uses 640x350, 640x480, and
  164.      800x600 16 color graphics.  The distribution GEOCLK42.ZIP file contains all
  165.      the required programs and data bases.  The main program file is named
  166.      GEOCLK.EXE.  It will automatically determine whether or not you have a math
  167.      co-processor (8087,80287, 80387), and use it if you do, or emulate it if
  168.      you do not.  If you have a normal EGA, the program is already configured
  169.      properly.  If you have a VGA or SVGA, you will need to follow one of the
  170.      procedures below:
  171.  
  172.           1.  Set up for VGA or 640x480x16 EGA.  To enable 640x480 display, you
  173.      must include the VGA statement in the GECONFIG.DAT file.  This statement
  174.      tells GEOCLOCK that you have a 640x480 display and how to enter that
  175.      display mode.  You will find a commented out VGA statement at the end of
  176.      the GECONFIG.DAT file.  Simply use any text editor to remove the "REM " at
  177.      the beginning of the VGA statement, so that the "V" is in column one.  If
  178.      you have a 640x480x16 EGA, you will need to contact your adapter supplier
  179.      to determine the appropriate parameters for the VGA statement.  See section
  180.      C.2 for a fuller explanation.  You might also want to add the SHOWVGA
  181.      statement to GECONFIG.DAT.  This will automatically convert EGA maps to VGA
  182.      format.
  183.  
  184.           2.  Set up for super VGA (800x600x16).  To enable 800x600 display, you
  185.      must include the SVGA statement in the GECONFIG.DAT file.  This statement
  186.      tells GEOCLOCK that you have a 800x600 display and how to enter that
  187.      display mode.  You will find several commented out SVGA statements at the
  188.      end of the GECONFIG.DAT file, corresponding to the several adapters that
  189.      support this graphics mode.  Simply use any text editor to remove the "REM"
  190.      at the beginning of the appropriate SVGA statement, so that the "S" is in
  191.      column one.  If your adapter is not listed, you will need to contact your
  192.      adapter supplier to determine the appropriate parameters for the SVGA
  193.      statement.  (Tell your supplier than you need the decimal values for the
  194.      registers to enter the 800x600x16 mode using INT 10).  See section C.2 for
  195.      a fuller explanation.  It is not necessary to include a VGA statement in
  196.      addition to the SVGA statement unless your adapter does not use the
  197.      standard command to enter the 640x480x16 mode.
  198.  
  199.      B.2.  CGA/HGC/MCGA/ATT400/PC3270 version (GEOMNO)
  200.  
  201.           This version of GEOCLOCK is compatible with a wide variety of graphics
  202.      boards, including all those two color modes supported by the Turbo Pascal
  203.      5.0 GRAPH unit.  In particular, 640x200 CGA, 720x348 HGC, 640x480 MCGA,
  204.      640x400 ATT, and 720x350 PC3270 mode are supported.  The 640x350 EGA
  205.      monochrome mode is NOT supported (this is a four color mode), although the
  206.      EGA emulation of HGC is supported provided your EGA board permits this. 
  207.      The distribution GEOMNO42.ZIP and GEOCLK42.ZIP files contain all the
  208.      required programs and data bases.  
  209.  
  210.           After Un-ZIPping the program, the files configuring the system for
  211.      your graphics adapter must be built.  The installation program GEOCONVT
  212.      builds these files, installs the proper drivers, and converts the maps to
  213.      the required format.  This program is started by:
  214.  
  215.           GEOCONVT <board type> [map file spec] [switches]
  216.  
  217.  
  218.                                         - 5 -
  219.      Joseph R. Ahlgren           GEOCLOCK version 4.2                   90/06/20
  220.  
  221.  
  222.      where board type is CGA, HGC, MCG, ATT, or 327.  The [map file spec]
  223.      specifies which map files are to be converted to the format for your
  224.      adapter.  If omitted, MAP*.EGA is assumed.  The switches are zero or more
  225.      of /D (which specifies that files not required for your particular adapter
  226.      are to be deleted) and /C (which specifies that map files are to be
  227.      converted, but no other conversions are to be done).  By default, neither
  228.      option is selected.  Specifying /D saves space on your disk, but be sure
  229.      that you have kept a backup or the original ZIP file before selecting this
  230.      option.  You should specify /C is you have already configured GEOMNO and
  231.      only need to convert a new map file.  For the initial setup, I recommend:
  232.  
  233.           GEOCONVT CGA    (or whatever adapter is appropriate)
  234.  
  235.      without any options.  You can do a    del map*.ega     to eliminate the
  236.      unneeded EGA map files after you are sure that everything is working
  237.      properly.
  238.  
  239.      B.3.  Mouse
  240.  
  241.           Several GEOCLOCK functions require a graphics cursor for input.  These
  242.      operate from both a mouse and the keyboard.  To use the mouse, the INT 33
  243.      driver must be loaded.  This driver, which comes with most mice, is usually
  244.      called MOUSE.COM or MOUSE.SYS.  The mouse buttons and functions are
  245.      emulated on the keyboard as follows:
  246.  
  247.          Left Mouse Button           Control (CTRL) and Page-Up keys
  248.          Center Mouse Button         Escape (ESC) Key
  249.          Right Mouse Button          Alternate (ALT) and Page-Down keys
  250.          Mouse Motion                Arrow and Shift-Arrow keys
  251.  
  252.           All the keyboard equivalents work whether or not a mouse is available. 
  253.      In particular, the arrow keys may be used to finely position the cursor
  254.      after the mouse has moved the cursor to the vicinity of the desired point,
  255.      and the Escape key can be used if your mouse does not have a center button.
  256.  
  257.      B.4.  Preparing the registered version
  258.  
  259.           The registered version of GEOCLOCK includes an INSTALL batch file to
  260.      aid in setting up GEOCLOCK on your hard disk.  The batch file un-Zips all
  261.      the required files (include map files), converts the maps as required, and
  262.      runs the REGISTER program which enables the special features such as Zoom,
  263.      Distance, and city time display that are available only to registered
  264.      users.  If you do not wish to use this batch file, follow these steps:
  265.           a.  Create a directory for GEOCLOCK on your hard disk, and switch to
  266.      it.  Copy the PKUNZIP.EXE program from the distribution disk to this
  267.      directory.
  268.           b.  Un-Zip the GEOCLOCK program by entering PKUNZIP A:GEOCLK42 .  If
  269.      you are using the MNO version, also enter PKUNZIP A:GEOMNO42 .
  270.           c.  Un-ZIP all the map files by entering PKUNZIP A:MAP* .  If you
  271.      received multiple disks, you should repeat this command for every disk.
  272.           d.  If you are using a VGA or 800x600, enter PKUNZIP A:VGA* .  If you
  273.      are using an 800x600, also enter PKUNZIP SVGA* .
  274.           e.  Un-Zip the GEODATA file.
  275.           f.  If you are using the MNO version, enter GEOCONVT <code>, where
  276.      code is CGA, HGC, MCG, ATT, or 327 as appropriate.  This converts all the
  277.      maps to the proper MNO format.
  278.  
  279.  
  280.                                         - 6 -
  281.      Joseph R. Ahlgren           GEOCLOCK version 4.2                   90/06/20
  282.  
  283.  
  284.           g.  Copy the REGISTER.EXE file to the hard disk and enter REGISTER . 
  285.      This enables the special features.
  286.           h.  Finally, use the TED editor to customize the configuration.  Enter
  287.      TED GECONFIG.DAT .  Change the PCZONE command to your time zone.  If you
  288.      have a VGA or 800x600, add the VGA command.  If you have an 800x600, also
  289.      add the SVGA command.
  290.  
  291.      B.5.  Upgrading from version 2.x
  292.  
  293.           Version 4.x contains many new features which require changes in some
  294.      of the 2.x files for optimum operation.  3.x files do not require any
  295.      conversion.  Existing 2.x data files will work but cannot take advantage of
  296.      these new features.  The conversion process effects four types of files.
  297.             a.  MAP<n>.EGA.  This only effects the EGA/VGA version of GEOCLOCK. 
  298.      The map format was changed to reduce the sizes of the map files.  While
  299.      GEOCLOCK 4.x will display both file formats, processing of the new format
  300.      is faster.  The program CVTMAP.EXE, available on the GEOCLOCK bulletin
  301.      board, will convert the old to new format.  To convert your existing maps,
  302.      follow this procedure:
  303.          DEL *.BAK
  304.          COPY MAP*.EGA MAP*.BAK
  305.          CVTMAP MAP*.BAK *.EGA
  306.          DEL *.BAK
  307.             b.  GECONFIG.DAT.  This file was required only for GEOMNO in version
  308.      2.x.  In version 4, this file optionally contains a list of command line
  309.      parameters (one per line).  In addition, two new commands are of particular
  310.      interest: ZONE, which defines time zone characteristics; and PCZONE, which
  311.      defines which time zone the PC's local clock is in.  The GECONFIG.DAT file
  312.      provided should be used until you feel the need to change it.  GEOCONVT
  313.      appends any existing GECONFIG.DAT file (including the one provided in
  314.      GEOMNOnn.ZIP) to the one it produces while setting up GEOMNO.  See section
  315.      D.
  316.             c.  GEOCLOCK.DAT and GEO<n>.DAT.  The format of these files has been
  317.      enhanced to take advantage of the time zone data.  The old first line,
  318.      which specifies the displayed zone and its relationship to the PC clock, is
  319.      now optional.  If it is omitted, it is assumed that PC local time is to be
  320.      displayed, as specified by the PCZONE command.  If a zone code is named,
  321.      that is the local time displayed.  On the subsequent lines, for registered
  322.      users, the time offset (specified by +n or -n after the !) may be specified
  323.      as <space><zone code> or <space>*<zone code>, in which case the city time
  324.      is displayed in the time zone specified by the zone code.  If * is
  325.      included, the time zone name is also displayed.  See section D.
  326.             d.  *.BGI files must be replaced with new versions, since version 4
  327.      was compiled under Turbo Pascal 5.0.  These are included in GEOMNOnn.ZIP.  
  328.  
  329.      C.    Operation
  330.  
  331.           To run GEOCLOCK, simply enter "GEOCLK" or "GEOMNO".  The initial
  332.      display is built, and then this display is updated continuously.  The
  333.      program recognizes a variety of functions while running.  Each of these is
  334.      activated by pressing a letter key.  These functions are summarized below. 
  335.  
  336.  
  337.      C.1.  Single key functions
  338.  
  339.  
  340.                                         - 7 -
  341.      Joseph R. Ahlgren           GEOCLOCK version 4.2                   90/06/20
  342.  
  343.  
  344.             Function Key 1 - activates the help system.  The first screen is a
  345.      menu listing all the GEOCLOCK parameters and keys.  Select a menu item by
  346.      pressing the indicated letter displays additional information.  You exit
  347.      the additional information screen and display the main menu by pressing any
  348.      key.  You exit the help system and return to GEOCLOCK display or parameter
  349.      entry by pressing any non-letter key.
  350.  
  351.             F - speed up the rate of change of time per display update. A prompt
  352.      asks for the number of hours (possibly fractional or negative) for the
  353.      displayed clock to be incremented during each cycle, e.g., 0.25 for 15
  354.      minutes every 1 to 20 second cycle.
  355.  
  356.             U - set the interval between screen updates.  A prompt asks for the
  357.      update interval in seconds.  When this value is entered, the display is
  358.      immediately drawn.  Subsequently, the screen in updated at the specified
  359.      interval and synchronized with the clock.  Thus, if 15 is specified, the
  360.      screen will be updated at 0, 15, 30, and 45 seconds past the minute.  If
  361.      your computer is not fast enough to achieve the specified interval, the
  362.      smallest integer multiple of this interval which works will be used.
  363.  
  364.             T - change the display time according to prompts in yy/mm/dd
  365.      hh:mm:ss format.  This does not change the system clock.  Any missing data
  366.      will revert to the current local time.  Thus "///12:0:0" sets the time to
  367.      today at 12 noon, while 88 01 01 0 0 0 sets the time to midnight, January
  368.      1, 1988.  All times in GEOCLOCK use the 24 hour format.  If you are using
  369.      the pop-up window in the EGA version, you can use the cursor keys to edit
  370.      the time, use ENTER to accept the new time, or escape to reject the new
  371.      time.
  372.  
  373.             R - restore the display time to the current time, and the display
  374.      update rate to real time.  R undoes F, T, and U.
  375.  
  376.             P - allows changes to the command line parameters.  These commands
  377.      are listed in section C.2 below.  Entering "?" or "HELP" at the prompt will
  378.      activate the help system.
  379.  
  380.             S - select a map.  When this key is pressed, a list of available
  381.      maps is displayed with their coordinates, title, and North-South distance. 
  382.      The highlighted line corresponds to the current map.  The cursor keys can
  383.      be used to scroll through this list.  When the <ENTER> key is pressed, the
  384.      highlighted map will be displayed.  By pressing T, the maps will be sorted
  385.      by title, while N sorts by map number and S sorts by map size.  Some very
  386.      early GEOCLOCK maps did not have titles.  If you have any of these maps,
  387.      the FIXMAP program, available on the GEOCLOCK RBBS (703-241-7980) will add
  388.      the proper titles.
  389.  
  390.             X - return to DOS.
  391.  
  392.             Escape - return to DOS.
  393.  
  394.      C.2.  Commands
  395.  
  396.             GEOCLOCK allows several command line parameters which control the
  397.      display.  These parameters may also be entered in response to prompts from
  398.      the "p" function above, included on the DOS command line, included in the
  399.      GECONFIG.DAT file, or included in a GEO*.DAT file.  Some of these commands
  400.  
  401.  
  402.                                         - 8 -
  403.      Joseph R. Ahlgren           GEOCLOCK version 4.2                   90/06/20
  404.  
  405.  
  406.      take parameters.  When entered on the command line, there can be no spaces
  407.      or commas in the command (e.g., LINE15 is OK, but LINE 15 is not).  When
  408.      contained in a file, commas and spaces are ignored.  If you want an
  409.      imbedded space or other mark (e.g. Washington, DC) you can enclose the
  410.      parameter in quote marks (e.g., "Washington, DC").  Latitude and longitudes
  411.      can be entered as decimal degrees (e.g., -14.35) or in degrees, minutes,
  412.      seconds, heading format (e.g., 14d21mW or "14 21 00 W").  Note that S
  413.      indicates south, not seconds.
  414.  
  415.           Below is a list of all the GEOCLOCK commands.  The DCGE column
  416.      indicates any restrictions on the command.  "D" (default) indicates that
  417.      this command is the initial condition of GEOCLOCK when it is started.  "C"
  418.      (Command Line) indicates that the command may be included on the GEOCLOCK
  419.      command line.  "G" (Global) indicates the command remains in effect until
  420.      overridden by another command (otherwise the effect of the command is
  421.      automatically removed when the displayed map is changed).  Finally, "E"
  422.      (EGA or better) indicates that the command has effect only in the
  423.      EGA/VGA/SVGA (GEOCLK) version.
  424.  
  425.      command   DCGE comments
  426.      ?         ---- displays list of commands.
  427.      HELP      ---- displays list of commands.
  428.      REM       ---- remark.  The rest of the parameter is ignored.
  429.      MAP       -C-- MAP (without a number) brings up the map selection menu,
  430.                     similar to the "S" command.  This may be entered on the
  431.                     command line or in the GECONFIG.DAT file, in which case the
  432.                     map selection menu will be displayed before the program
  433.                     starts.
  434.      MAPn      -CG- displays appropriate map.  Map1 is the default.  The
  435.                     GEO*.ZIP files include two maps.  MAP1 is a rectilinear
  436.                     projection of the entire Earth.  MAP2 is a map of the 48
  437.                     states.  MAP2000, which is a North Polar projection map. 
  438.                     Other maps are available as detailed in section K.
  439.      NOMAP     -CG- does not display any background map.
  440.      SCREEN    -CGE Forces EGA maps to be handled using both screen buffers in
  441.                     the EGA adapter.  In this mode, screen updates are smooth,
  442.                     but the sun symbol is a dark crossed circle and the display
  443.                     is updated less often than in the NOSCR mode.
  444.      NOSCR     DCGE This command forces EGA maps to be handled the same way VGA
  445.                     and SVGA maps are handled.
  446.      SHOWVGA   -CGE This command causes all EGA maps to be automatically
  447.                     expanded (by duplicating some rows) to VGA resolution and
  448.                     displayed as VGA maps.  This does not change the map
  449.                     resolution, but does change the text and sunlight
  450.                     resolution.
  451.      SHOWSVGA  -CGE This command causes all EGA and VGA maps to be automatically
  452.                     expanded (by duplicating some rows and pixels within rows)
  453.                     to SVGA resolution and displayed as SVGA maps.  This does
  454.                     not change the map resolution, but does change the text and
  455.                     sunlight resolution.
  456.      VGA       -CGE This enables VGA display.  If this command is not included
  457.                     in the GECONFIG.DAT file, VGA maps may not be displayed.  If
  458.                     you do not have a true VGA (for example, an EGA that
  459.                     supports 640x480x16), you may need to use the form
  460.                     VGAa/b/c/d.  The arguments indicate decimal the values to be
  461.                     loaded into the AX, BX, CX, and DX registers before the call
  462.  
  463.  
  464.                                         - 9 -
  465.      Joseph R. Ahlgren           GEOCLOCK version 4.2                   90/06/20
  466.  
  467.  
  468.                     to INT 10 to enter VGA mode.  Check with your display
  469.                     adapter supplier if you are not sure of the correct
  470.                     parameters to use.  DO NOT include this command unless you
  471.                     have a 640x480 EGA, a VGA, or super VGA adapter and a VGA or
  472.                     multisync monitor: your monitor may be damaged if it does
  473.                     not support the vertical and horizontal frequencies
  474.                     generated by the VGA.
  475.      SVGA      -CGE SVGAa/b/c/d enables SVGA (800x600) display.  If this command
  476.                     is not included in the GECONFIG.DAT file, SVGA maps may not
  477.                     be displayed.  The arguments indicate the values to be
  478.                     loaded into the AX, BX, CX, and DX registers before the call
  479.                     to INT 10 to enter SVGA mode.  For the Paradise SVGA, the
  480.                     parameters are optional: SVGA88/0/0/0 is assumed.  Check
  481.                     with you display adapter supplier if you are not sure of the
  482.                     correct parameters to use.  (Tell your supplier than you
  483.                     need the decimal values for the registers to enter the
  484.                     800x600x16 mode using INT 10).  DO NOT include this command
  485.                     unless you have a super VGA adapter and a multisync monitor:
  486.                     your monitor may be damaged if it does not support the
  487.                     vertical and horizontal frequencies generated by the SVGA.
  488.      MARK      -CG- displays markers for the cities in geo*.dat.  See section
  489.                     D.3
  490.      NOMARK    DCG- does not display city markers or city names.
  491.      NOCITY    DCG- does not display city names for the cities in geo*.dat.
  492.      CITY      -CG- displays city names.
  493.      QUIET     DCG- does not beep on screen update.
  494.      SOUND     -CG- beeps each time the screen is updated.
  495.      NOLINE    DCG- does not display any latitude/longitude lines.
  496.      LINEnn    -CG- displays latitude/longitude lines every nn degrees, unless
  497.                     that would result in more than 40 lines.  If nn is 0 or
  498.                     missing, the current latitude and longitude line intervals
  499.                     are not changed but lines are enabled, and thus LINE undoes
  500.                     NOLINE.
  501.      TLINCnn   -CG- same as LINEnn, except only affects Latitude lines.
  502.      GLINCnn   -CG- same as LINEnn, except only affects Longitude lines.
  503.      TLSPECnn  -CG- displays one latitude line at nn.
  504.      GLSPECnn  -CG- displays one longitude line at nn.  Up to 20 TLSPEC and
  505.                     GLSPEC lines may be specified.
  506.  
  507.      CLINE     DCG- removes all TLSPEC and GLSPEC lines.
  508.      HIDELL    DCG- does not label latitude/longitude lines
  509.      SHOWLL    DCG- labels latitude/longitude lines
  510.      DRAWLINE  ---- DRAWLINE lat1 long1 lat2 long2 color   draws a line between
  511.                     (lat1,long1) and (lat2,long2) on the current map.  The
  512.                     command operates only when contained in a GEO*.DAT file that
  513.                     is processed for the map.  Color is the color in which the
  514.                     line will be drawn.  See section G.2 for an explanation of
  515.                     the use of color.  If omitted, color defaults to 5 (yellow).
  516.                     Example: DRAWLINE 38.9 -77.0 34.0 -118.3 0 draws a line
  517.                     between Washington DC and Los Angeles in color 0.
  518.      DRAWCIRCLE---- DRAWCIRCLE latcenter longcenter latrad longrad color   
  519.                     draws an ellipse centered at (latcenter,longcenter) and with
  520.                     latitude (vertical) radius latrad and with longitude
  521.                     (horizontal) radius longrad.  The command operates on when
  522.                     contained in a GEO*.DAT file that is processed for the map. 
  523.                     Color is the color in which the line will be drawn.  See
  524.  
  525.  
  526.                                         - 10 -
  527.      Joseph R. Ahlgren           GEOCLOCK version 4.2                   90/06/20
  528.  
  529.  
  530.                     section G.2 for an explanation of the use of color.  If
  531.                     omitted, color defaults to 5, which is displayed as yellow. 
  532.                     Example:  DRAWCIRCLE  38.9  -77.0  10 20 6 draws an oval
  533.                     centered on Washington DC that is 10 degrees from the center
  534.                     to the northernmost point, and 20 degrees from the center to
  535.                     the easternmost point, and in color 6.
  536.      INCLUDE   ---- When contained in a GEO*.DAT file, INCLUDE <file>  suspends
  537.                     reading from the file being processed, and processes all
  538.                     commands in the <file>.  When all commands in that file have
  539.                     been processed, reading resumes from the original file. 
  540.                     INCLUDE may be nested up to ten levels.  Include may also be
  541.                     used in response to the "P" command.  In this case, the
  542.                     named file will be included at the end of the GEOn.DAT file
  543.                     for the map currently displayed.  The effect of this command
  544.                     will be negated when a new map is selected or a new file is
  545.                     specified with INCLUDE.
  546.      NORM      -CG- highlights sunlit area.
  547.      REV       -CG- highlights area not sunlit (appropriate for LCD displays)
  548.      LIGHT     -CG- highlights entire screen, and does not show sun symbol.
  549.      DARK      -CG- highlights no area, and does not show sun symbol.
  550.      FLICKER   -CGE This command forces GEOCLOCK to bypass the video BIOS and
  551.                     issue changes to the video memory start address and palette
  552.                     directly to the video hardware.  This is necessary to
  553.                     prevent flickering or blinking of the display on some
  554.                     graphics adapters.
  555.      NOBLINK   -CGE This command prevents the markers from blinking on the
  556.                     "D"istance screen on some graphics adapters.  You may want
  557.                     to use the MCOLOR command with NOBLINK to improve marker
  558.                     readability.
  559.      MCOLOR    -CGE MCOLORxxyy sets the colors of the Markers on the "D"istance
  560.                     screen.  Marker 1 is set to xx, and Marker 2 is set to yy. 
  561.                     For example, MCOLOR5962 sets Marker 1 to 59 (bright cyan)
  562.                     and Marker 2 to 62 (yellow).
  563.      SHOWCH    DCGE display screens as they are built.
  564.      HIDECH    -CGE displays screens only after they are completed.  Not
  565.                     compatible with SCREEN.
  566.      PS2BUG    -CGE use if, with SHOWCH set, the display goes blank during
  567.                     GEOCLOCK operation or after GEOCLOCK termination.  This
  568.                     works around an error in the PS/2 VGA BIOS.
  569.      NORAM     DCGE use if map display is trashed.  This option adds
  570.                     approximately 25K to the memory required to execute GEOCLK.
  571.      USERAM    -CGE use if there is insufficient RAM to run GEOCLOCK.  This
  572.                     option moves the disk buffer to an area within the VIDEO
  573.                     RAM.  Some EGA boards, including the ATI EGA wonder, are not
  574.                     compatible with the DMA-s of some computers, and this option
  575.                     will cause the display to be trashed or will cause disk
  576.                     errors.  USERAM is also not compatible with the VGA and
  577.                     SVGA, and may lead to map display errors.
  578.      SHOWMN    -CG- displays the map number and name in the upper right hand
  579.                     corner.  This data may overlap the latitude/longitude
  580.                     display.
  581.      HIDEMN    DCG- does not display map name and number.
  582.      FULL      DCG- displays local location, time, and full ephemeris data.
  583.      SUN       -CG- displays location, time, and sunrise/sunset data
  584.      TIME      -CG- displays local date and time at bottom of screen.
  585.      NONE      -CG- displays no text data at the bottom of the screen.
  586.  
  587.  
  588.                                         - 11 -
  589.      Joseph R. Ahlgren           GEOCLOCK version 4.2                   90/06/20
  590.  
  591.  
  592.      SUNANGLEx -CGE sets the elevation angle of the sun used to compute sunrise
  593.                     and set.  The default is -0.8333 degree, corresponding to
  594.                     the sun just breaking the horizon considering refraction
  595.                     effects.  SUNANGLE-6.0 sets this angle to -6 degrees, which
  596.                     defines civil sunrise and set.  -12 is Nautical sunrise and
  597.                     sunset, while -18 is Astronomical sunrise and sunset.  This
  598.                     parameter does not effect the terminator line calculations.
  599.      SUNLIGHTn -CGE specifies the sun's elevation angle for the terminator.  The
  600.                     default is 0, which corresponds to the geometric terminator. 
  601.                     0.8333 corresponds to  apparent sunrise and sunset, when the
  602.                     edge of the sun is just visible.
  603.      TWILIGHTn -CGE specifies the  sun's  elevation angle  for  the twilight
  604.                     terminator.  The default is 0.  -6.00 corresponds to civil
  605.                     twilight, -12 corresponds to nautical twilight, and -18
  606.                     corresponds to astronomical twilight.  If this angle is
  607.                     greater than or equal to the SUNLIGHT parameter, the
  608.                     twilight area is not displayed.  
  609.      TLMASKn   -CGE the fraction (in 16ths) of halftoning for twilight display. 
  610.                     8 is the default, which gives 1/2 light and 1/2 dark for the 
  611.                     twilight area.  You may have to experiment with this value
  612.                     to get the best display for your monitor.
  613.      HAMDB     ---E loads the HAM call sign data base from file the named file. 
  614.                     Only the first occurrence of this command in a GEOCLOCK
  615.                     execution is effective (i.e., the data base will not be
  616.                     reloaded or changed).  The HAM data base and other required
  617.                     files are an extra cost option in GEOCLOCK.  See section H.
  618.      HAM       -GCE activates the HAM features.  See section H.
  619.      NOHAM     -CGE deactivates the HAM features.  See section H.
  620.      SHOWMONTH -GC- displays the month name rather than number.  This command
  621.                     can be followed by 12 character strings, which  specify the
  622.                     names of the months.  The default names are the standard 3
  623.                     character English abbreviations:
  624.                     SHOWMONTH JAN FEB MAR APR MAY JUN JUL AUG SEP OCT NOV DEC
  625.      NOMONTH   DGC- displays month number rather than name
  626.      SHOWDAY   -GC- displays the day of the week.  This command can be followed
  627.                     by 7 character strings, which specify the names of the days
  628.                     of the week.  The default names are the standard 3 character 
  629.                     English abbreviations:
  630.                     SHOWDAY SUN MON TUE WED THU FRI SAT
  631.      NODAY     DCG- does not display the day of the week.
  632.      SHOWSEC   DCG- displays seconds.
  633.      NOSEC     -CG- does not display seconds.
  634.      YEAR4     -CG- displays 4 digit years (e.g., 1990)
  635.      YEAR2     DCG- displays 2 digit years (e.g., 90)
  636.      ZONE      --G- defines a time zone.  See section D.2.
  637.      PCZONE    --G- defines the time zone the PC's clock is in.  See D.2.
  638.      EQUINOX   -CG- allows the exact GMT of an equinox to be specified (e.g.,
  639.                     EQUINOX 88/09/22 17:29).  This data is used to calibrate the
  640.                     sun position calculation to improve the accuracy near the
  641.                     equinoxes (while degrading it far from the equinoxes). 
  642.                     Personally, I do not think this is a very good idea, but I
  643.                     am tired of defending my position.  The current system
  644.                     computes equinoxes within a few minutes.
  645.      CSET      --GE allows the screen colors to be changed interactively.
  646.      COLOR     -CGE COLORnxxyy changes screen color without interaction.  "n"
  647.                     specifies the feature number (0- 7) to be changed.  Feature
  648.  
  649.  
  650.                                         - 12 -
  651.      Joseph R. Ahlgren           GEOCLOCK version 4.2                   90/06/20
  652.  
  653.  
  654.                     number n will display color xx, and feature n+8 will display
  655.                     color yy.  Thus COLOR56262 will cause feature numbers 5 and
  656.                     13 to display as 62 (bright yellow).  See Section G.2 for a
  657.                     explanation of how color is used in GEOCLOCK.
  658.      FAST      -CG- Forces GEOCLOCK to use a faster but slightly less accurate
  659.                     algorithm for drawing the sunlit area.  This is the default
  660.                     for systems without an 80x87.
  661.      SLOW      -CG- Forces GEOCLOCK to use the high accuracy algorithm for
  662.                     drawing the sunlit area.  This is the default for systems
  663.                     with an 80x87.  On systems with an 80x87, the difference in
  664.                     speed between SLOW and FAST is negligible, while on those
  665.                     systems without an 80x87, FAST is approximately twice the
  666.                     speed of SLOW.  These options do not effect polar projection
  667.                     or azimuthal-equidistance maps.
  668.  
  669.      C.3.  Command line parameters
  670.  
  671.           Any of the commands (other than ZONE, PCZONE, CSET, DRAWLINE,
  672.      DRAWCIRCLE, HAMDB, and INCLUDE) in section C.2 above may be entered on the
  673.      command line that invokes GEOCLOCK.  These commands will be in effect when
  674.      GEOCLOCK begins, and override commands placed in the GECONFIG.DAT file.
  675.  
  676.      D.    Customizing
  677.  
  678.           After the program has been extracted and is operating, you may wish to
  679.      customize it for your computer.  The primary way to customize the program
  680.      is through some special text files.  These files can be customized with any
  681.      text editor.  GECONFIG.DAT describes your graphics system, defines the time
  682.      zones, and gives the default setting for the program.  The GEOCLOCK.DAT and
  683.      GEO<n>.DAT files specify the cities and time zones to be displayed with
  684.      each map.  Sample GECONFIG.DAT and GEOCLOCK.DAT files are provided with the
  685.      program, and you examine these examples to help you prepare your own custom
  686.      versions.
  687.  
  688.      D.1.  Time zone data
  689.  
  690.           Time zones are user defined in GEOCLOCK.  Each zone (e.g., Eastern) is
  691.      specified by giving its code name (e.g., ET), the names of summer and
  692.      standard times (e.g., EDT and EST), the number of hours the time is ahead
  693.      of GMT (e.g., -4 and -5), and the times between which summer time is in
  694.      effect (e.g., ****88/04/24 8:00:00 GMT and 88/10/30 8:00:00 GMT).  The
  695.      zones are referenced by their code names, and thus the zone data need only
  696.      be updated once per year (sometime during the winter) and in only one place
  697.      (where the zones are specified).  It is most convenient to include the zone
  698.      specifications in the GECONFIG.DAT file.  If the ZONE commands are not for
  699.      the correct year, GEOCLOCK will automatically update them by changing each
  700.      date to the closest date in the correct year which falls on the same day of
  701.      the week.  For example, 89/10/29 would change to 90/10/28, since both days
  702.      fall on Sunday.  This update is not necessarily correct, and I recommend
  703.      that the ZONE commands be kept current.
  704.  
  705.          The ZONE command takes 7 parameters: 1) a code name for the time zone
  706.      (referenced by PCZONE, and GEO<n>.DAT files), 2) the name of the standard
  707.      time, 3) the number of hours standard time is ahead of GMT (thus negative
  708.      for US locations), 4) the name of the summer (daylight) time, 5) the number
  709.      of hours summer time is ahead of GMT, 6) the date and time (GMT) to switch
  710.  
  711.  
  712.                                         - 13 -
  713.      Joseph R. Ahlgren           GEOCLOCK version 4.2                   90/06/20
  714.  
  715.  
  716.      from standard to summer time, in the format yy/mm/dd:hh:mm:ss, with
  717.      trailing data optional (e.g., 88/10/30:8), 7) the date and time (GMT) to
  718.      switch from summer time to standard time.  If a zone does not change during
  719.      the year, the last four parameters may be omitted.  This command is best
  720.      used in the GECONFIG.DAT file.
  721.  
  722.           The PCZONE command sets the relationship between the local time on the
  723.      PC's clock and GMT, i.e., declares which time zone the PC's clock is in. 
  724.      It takes one parameter - a time zone code, as defined in the ZONE command. 
  725.      This command is best used in the GECONFIG.DAT file, and it must follow the
  726.      ZONE command that it references.
  727.  
  728.  
  729.  
  730.      D.2.  Cities in GEOCLOCK.DAT and GEO<n>.DAT
  731.  
  732.           Cities may be overlaid on the maps.  They are specified in GEO<n>.DAT
  733.      files.  For map number n (e.g., 2, the 48 states map), these cities are
  734.      read from GEOn.DAT (e.g., GEO2.DAT) if that file exists.  If the file does
  735.      not exist, cities are read from GEOCLOCK.DAT.
  736.           The first entry in a GEO<n>.DAT file specifies the time zone code to
  737.      be used for the standard time display.  It consists of a line with a single
  738.      zone code.  If this line is omitted, the code for PCZONE is used. 
  739.      Ordinarily, this code should match the time zone code for the first city in
  740.      the file.
  741.           Following this time zone entry, command line parameters may be
  742.      optionally included.  The command line parameters will be processed after
  743.      both the command line and the GECONFIG.DAT file parameters, and thus will
  744.      override entries there.  The command REM may be used to add comments to the
  745.      file.  
  746.           Subsequent entries in the file specify the name and locations of
  747.      cities to be displayed.  Each entry consists of the latitude, longitude,
  748.      and name of the city.  Latitude and longitude may be in degrees and
  749.      fractions (e.g., -15.35), with North and East positive, or degrees-minutes-
  750.      seconds (e.g., 15d35S), with N S E and W specifying direction.  Most US
  751.      locations have positive latitude and negative longitude.  The first city
  752.      specified is used for calculating the sunrise, sunset, and the azimuth and
  753.      elevation angles for the sun.
  754.  
  755.      D.3.  Default parameters in GECONFIG.DAT
  756.  
  757.           The GECONFIG.DAT file may be used to specify default setting and time
  758.      information.  If you are using GEOMNO, the first four lines must be as
  759.      written by the GEOCONVT program.  They give specification data for your
  760.      graphics system.  Subsequent lines contain command line parameters.  There
  761.      should be no leading spaces on these subsequent lines.  This file is
  762.      processed BEFORE the command line parameters are executed, so the command
  763.      line will override parameters specified here.  If you have a VGA or
  764.      800x600, the VGA and SVGA commands should be in GECONFIG.DAT.
  765.  
  766.      E.    Functions for registered users only
  767.  
  768.           The following functions are available to registered users only.  See
  769.      section K for details on how to register.
  770.  
  771.      E.1.  Zoom
  772.  
  773.  
  774.                                         - 14 -
  775.      Joseph R. Ahlgren           GEOCLOCK version 4.2                   90/06/20
  776.  
  777.  
  778.  
  779.           This function allows the user to change the map background using the
  780.      cursor.  A mouse or the arrow keys can be used.  To invoke the function,
  781.      press the letter Z.  The screen will be stabilize without any time or
  782.      sunlight information, and an Iron-Cross type cursor will appear.  Use the
  783.      mouse and/or arrow keys (shift-arrows move 8 times faster than non-shifted
  784.      arrows) to locate a position on the map.  Each press of the right or left
  785.      button on the mouse, or CONTROL or ALTERNATE keys, or Page-Up or Page-Down
  786.      keys on the keyboard, will switch to a new map containing that point.  The
  787.      left button "zooms in" while the right button "zooms out."  The cursor will
  788.      remain at the specified latitude/longitude during the switch.  When the
  789.      desired map is displayed, press the middle button or the ESCAPE key to
  790.      return to time display.
  791.  
  792.      E.2.  Distance and Azimuth
  793.  
  794.             This function provides a display of the coordinates of three
  795.      selected points, and the distances between them, as controlled by a mouse
  796.      or the keyboard.  The function is invoked by pressing the letter D.  Point
  797.      1 is selected by the left button of the mouse or the CONTROL key or Page-Up
  798.      key on the keyboard.  Point 2 is selected by the right button or the
  799.      ALTERNATE key or the Page-Down key.  Point 3 is the current cursor
  800.      position.  To return to the time display, press the middle button or
  801.      ESCAPE.  To maintain smooth cursor movement, the distance and coordinate
  802.      displays are updated only when the cursor is not moving.  Pressing the "."
  803.      key will display coordinates in degrees and fractions, while the "'" key
  804.      will display coordinates is degrees, minutes, and seconds.  Pressing "A"
  805.      will display the azimuth between the two points (the azimuth at the first
  806.      toward the second, and the azimuth at the second toward the first, with
  807.      North 0 and East 90) and the distance in kilometers, while pressing "D"
  808.      will display the distance between the points in miles and kilometers.
  809.  
  810.      E.3.  Time display for cities
  811.  
  812.           For registered users only, additional control over city placement,
  813.      color, size, and local time display is possible.  All are marked by
  814.      characters appearing after an exclamation point (!) on a city line in
  815.      GEO<n>.DAT.  This new data consists of an optional string of  characters as
  816.      follows:
  817.  
  818.           A - show city name Above mark
  819.           B - show city name Below mark
  820.           L - show city name Left of mark
  821.           R - show city name Right of mark (if none of above specified, use
  822.      best)
  823.           Y - show city name in color 5 (Yellow by default)
  824.           E - show city name in 8x14 font (8x8 by default)
  825.           number - show city name in color number (e.g., 6 shows city name in
  826.      color 6).
  827.  
  828.           After these optional codes, the line may be optionally followed by a
  829.      space and a time zone code.  If included, this specifies that the local
  830.      time for that city is to be displayed to the right of the city name.  If a
  831.      "*" is included, the name of the time zone will be displayed in addition to
  832.      the time.  For example:
  833.  
  834.  
  835.                                         - 15 -
  836.      Joseph R. Ahlgren           GEOCLOCK version 4.2                   90/06/20
  837.  
  838.  
  839.                        ET
  840.         38.90   -77.02  Washington !E
  841.         42.65   -73.75  Albany NY !Y
  842.         35.08  -106.65  Albuquerque NM ! *MT
  843.         42.28   -83.75  Ann Arbor MI !A
  844.         33.75   -84.39  Atlanta GA 
  845.         44.30   -69.76  Augusta ME 
  846.         33.52   -86.81  Birmingham AL ! CT
  847.         46.80  -100.78  Bismarck ND !B *CT
  848.  
  849.      F.    Files
  850.  
  851.      F.1.  GEOCLKnn.ZIP
  852.  
  853.          GEOCLOCK.DOC   This file.
  854.          GEOCLOCK.DAT   An example of a customization file for GEOCLOCK.  See
  855.      section B.3 for the details of the contents of this file.
  856.          GECONFIG.DAT   A starter for the configuration file for GEOCLOCK.  See
  857.      section D for details.
  858.          GEOCLK.EXE     GEOCLOCK version for EGA, VGA, and super VGA.
  859.          MAP1.EGA       EGA database for MAP1 (world).
  860.          MAP2.EGA       EGA database for MAP2 (48 states).
  861.          MAP2000.EGA    EGA database for MAP2000 (North Polar Projection).
  862.          MAILER.        Printer file to aid registration.
  863.  
  864.      Two other ZIP files are available to support GEOCLK for the VGA and SVGA. 
  865.      VGA1-2.ZIP contains MAP4001 (VGA world) and MAP4002 (VGA 48 states). 
  866.      SVGA1-2.ZIP contains MAP6149 (SVGA world) and MAP6002 (SVGA 48 states).
  867.  
  868.      F.2.  GEOMNOnn.ZIP
  869.  
  870.          README.MNO     Instructions for setup of GEOMNO.
  871.          GEOMNO.EXE     GEOCLOCK version for two color graphics.
  872.          GEOCONVT.EXE   Installation program to select drivers and font files,
  873.      write configuration file, and convert maps to specific graphics format. 
  874.      See section B.2 for instructions on the operation of this program.
  875.          *.BGI          Various graphics drivers (Turbo Pascal 5.0).
  876.          *.FON          Various font files.
  877.  
  878.      G.    Technical Information
  879.  
  880.      G.1.  Ephemeris Data and Accuracy.
  881.  
  882.          The ephemeris data in GEOCLOCK was derived by fitting two twelfth order
  883.      polynomials to data from "Interactive Computer Ephemeris" (ICE).  One
  884.      polynomial computes the sun's latitude, while the other computes the sun's
  885.      longitude at noon GMT.  Both assume a 365.242199 day year.  They were made
  886.      by a least squares fit to 400 points around 1990 data.  In this interval,
  887.      the maximum and RMS latitude errors are 0.016845 and 0.004049 degrees,
  888.      while the maximum and RMS longitude errors are 0.059805 and 0.016630
  889.      degrees.  The fit has been tested against 1986 sun rise and set data, and
  890.      with 1985 through 2000 spring equinox times, and is within a few minutes in
  891.      time, but obviously there are no guarantees of the accuracy.  ICE is
  892.      available on many astronomy bulletin boards, or from:
  893.  
  894.                Nautical Almanac Office
  895.  
  896.  
  897.                                         - 16 -
  898.      Joseph R. Ahlgren           GEOCLOCK version 4.2                   90/06/20
  899.  
  900.  
  901.                Code FA
  902.                U. S. Naval Observatory
  903.                Washington, DC 20392
  904.  
  905.          The terminator is shown as the locations where the sun's center,
  906.      ignoring atmospheric effects, is a specified angle above the horizon.  For
  907.      the default value of 0 degrees, the sunrise occurs earlier and the sunset
  908.      occurs later than the terminator indicates.  The sun rise and sun set times
  909.      are also computed as the times that the sun's center is a specified angle
  910.      above or below the horizon.  The default value, -0.8333, corresponds to
  911.      civil sun rise and set, where the visible edge of the sun just breaks the
  912.      horizon.
  913.  
  914.           Some future version of GEOCLOCK may include the moon, planets, and
  915.      artificial satellites.  This requires a few pascal routines that I just do
  916.      not have the time to develope.  If anyone can help me with the routines
  917.      below I will be grateful.
  918.  
  919.  
  920.      {Global Variables that are set by other software }
  921.      var
  922.        JulianDate: real;  {Julian Date/Time, 
  923.                            with 89/01/01 0:0:0 GMT = 16072.0000}
  924.        SunZenithLatitude: real;  {geographic latitude of the sun at JulianDate}
  925.        SunZenithLongitude: real; {geographic longitude of the sun at JulianDate}
  926.      {Special Types}
  927.      type
  928.        ObjectType =    
  929.      (Moon,Mercury,Venus,Mars,Jupiter,Saturn,Uranus,Neptune,Pluto);
  930.        ElementType = record
  931.          SatelliteName:       string;
  932.          EpochTime:           real {JulianDate/Time};
  933.          Inclination:         real {degrees};
  934.          RAofNode:            real {Degrees};
  935.          Eccentricity:        real {dimensionless};
  936.          ArgOfPerigee:        real {degrees};
  937.          MeanAnomaly:         real {degrees};
  938.          MeanMotion;          real {revolutions/day};
  939.          DecayRate:           real {revolutions/day/day};
  940.          EpochRev:            integer {dimensionless};
  941.          SemiMajorAxis:       real {kilometers};
  942.          end;
  943.      procedure SkyPosition( ObjectID: ObjectType;
  944.                           var ZenithLatitude, ZenithLongitude: real);
  945.      { returns the earth (not sun) latitude and longitude (not right
  946.      ascension and declination) where the specified object is at Zenith.}
  947.  
  948.      procedure CalculateSatellitePosition( var Elements: ElementType;
  949.                                            var Lat,Long,Alt: real);
  950.       {Calculates the earth centered latitude, longitude, and altitude
  951.        of the satellite described by "Elements" at time JulianDate.
  952.        Lat" and "Long" are in degrees (East longitude positive), and "Alt"
  953.        is in kilometers}
  954.  
  955.  
  956.      G.2.  Use of Color
  957.  
  958.  
  959.                                         - 17 -
  960.      Joseph R. Ahlgren           GEOCLOCK version 4.2                   90/06/20
  961.  
  962.  
  963.  
  964.           The EGA graphics adapter provides for the simultaneous display of 16
  965.      colors from a palette of 64.  Most programs use the default palette, which
  966.      roughly corresponds to the colors provided by the CGA in text mode.  The
  967.      EGA/VGA/SVGA version of GEOCLOCK does not use this standard palette.  The
  968.      16 numbers specifying a color from the color palette are used to represent
  969.      16 features displayed by GEOCLOCK.  The use of the 16 feature numbers is as
  970.      follows: 
  971.  
  972.          feature       use            feature+8        use
  973.  
  974.             0    Political Bdy (dark)    8       Political Bdy (light)
  975.             1    Water (dark)            9       Water (light)
  976.             2    Land (dark)            10       Land (light)
  977.             3    Land/Water Bdy (dark)  11       Land/Water Bdy (light)
  978.             4    Text Background (dark) 12       Text Background (light)
  979.             5    Aux Text Color (dark)  13       Aux Text and Sun (light)
  980.             6    Lat/Long Lines (dark)  14       Lat/Long Lines (light)
  981.             7    Frame and Text         15       Frame and Text
  982.  
  983.            The actual colors displayed are determined by the formula:
  984.       color value = B + 2*G + 4*R + 8*b + 16*g + 32*r, where   
  985.             B  = bright blue              b = dim blue
  986.             G  = bright green             g = dim green
  987.             R  = bright red               r = dim red
  988.  
  989.           Some typical colors are:
  990.         name              RGBrgb      color value
  991.  
  992.         black             ------         0
  993.         white             RGBrgb        63
  994.         dark blue         -----b         8
  995.         blue              --B---         1
  996.         light blue        --Brgb        57
  997.         dark green        ----g-        16
  998.         green             -G----         2
  999.         light green       -G-rgb        58
  1000.         brown             R---g-        20
  1001.         light yellow      RG-rgb        62      
  1002.         red               R-----         4
  1003.         bright red        R--rgb        60
  1004.  
  1005.      G.3.  Software structure
  1006.  
  1007.           GEOCLOCK is written entirely in Turbo Pascal version 5.0, except for
  1008.      the mouse interface routines and a few inline sections required for speed. 
  1009.      It has approximately 9000 lines of source code.  It uses 8 byte reals for
  1010.      most calculations, and thus relies on the 80x87 emulation package for
  1011.      systems without a math co-processor.  The EGA/VGA/SVGA version uses a
  1012.      custom graphics package which provides access to special hardware features
  1013.      (such as independent control of screen planes, disk I/O directly to the
  1014.      video memory, fast fill, and preserving the graphics memory during text
  1015.      display) that are not available in the EGAVGA.BGI driver.  The monochrome
  1016.      version uses the GRAPH unit, and builds a screen image in RAM before
  1017.      copying the image in its entirety to video memory.  The GRAPH unit
  1018.      functions other than PUTIMAGE are not used except for a few special
  1019.  
  1020.  
  1021.                                         - 18 -
  1022.      Joseph R. Ahlgren           GEOCLOCK version 4.2                   90/06/20
  1023.  
  1024.  
  1025.      applications, such as drawing the graphics cursor, and updating the
  1026.      position and distance displays in the distance function.
  1027.  
  1028.      G.4.  Map Generation System
  1029.  
  1030.           The maps used for the GEOCLOCK program were produced by a custom data
  1031.      base and software system.  This system consists of a highly compressed
  1032.      vectorized map data base and a set of programs to convert the data into
  1033.      custom maps.  The data base is a PC conversion of World Data Bank II.  It
  1034.      contains approximately 5.7 million vectors covering coastlines, islands,
  1035.      lakes, rivers, and similar geologic features, together with political
  1036.      boundary data.  It covers the entire earth, and included features are
  1037.      accurate to approximately 600 meters.  World Data Bank II was converted to
  1038.      this custom PC format by an ad hoc program which took advantage of specific
  1039.      features of both data bases.  In its operational form, the PC data base
  1040.      uses approximately 0.84 bytes per vector, and in archival form takes
  1041.      approximately 0.5 bytes per vector.  The data base is therefore easily
  1042.      stored and manipulated on an AT class PC.
  1043.  
  1044.           Custom maps are generated by using two programs.  The first, MAPGEN,
  1045.      reads the appropriate parts of the map data base and produces separation
  1046.      files of the required feature data as EGA, VGA, or 800x600 raster images. 
  1047.      Rectangular, polar, azimuthal-equidistant, and Lambert projections may be
  1048.      used in forming these separation files.  Depending on complexity and scale,
  1049.      this process takes between 30 and 300 seconds on an AT with a co-processor. 
  1050.      The second, MOVIE, allows the user to process the separation files to
  1051.      select the features and colors for the final map, including filling areas. 
  1052.      This program also writes the map in a rasterized compressed format with
  1053.      headers and trailers so that it may be easily used as background data for
  1054.      other programs (for example, the GEOCLOCK program).
  1055.  
  1056.           Both these programs, and the converted data base, are proprietary and
  1057.      not yet available to the general public.  World Data Bank II is available
  1058.      from National Technical Information Center, Springfield, VA, for about
  1059.      $1000 on 5 reels of tape.
  1060.  
  1061.      H.    HAM add-in.
  1062.  
  1063.           An add-in package is available to provide special functions for HAM
  1064.      radio operators.  These functions include:
  1065.  
  1066.      Azimuthal-Equidistant (Great Circle) maps
  1067.      Twilight and terminator, or D and F layer illumination, display
  1068.      User Maintainable call sign data base.
  1069.      Remote station location
  1070.      short and long great circle path
  1071.      short and long path azimuth and range
  1072.      remote station (reciprocal) azimuth
  1073.      UTC, local, and remote station local time
  1074.      DXCC and WAE designations
  1075.      CQ and ITU zones
  1076.      Continent, area, and location names
  1077.  
  1078.           The package has three major components: a custom Azimuthal-Equidistant
  1079.      map centered on your HAM station; a call sign data base, and a utility
  1080.  
  1081.  
  1082.                                         - 19 -
  1083.      Joseph R. Ahlgren           GEOCLOCK version 4.2                   90/06/20
  1084.  
  1085.  
  1086.      program to process the text call sign data base into the GEOCLOCK form.
  1087.      GEOCLOCK uses this data base to overlay HAM data on the custom map.
  1088.  
  1089.           The HAM package is available to registered GEOCLOCK users for $30,
  1090.      which includes your custom map.  Be sure to specify your GEOCLOCK
  1091.      registration number (or registration fee), and the latitude, longitude, and
  1092.      call sign of your station when ordering.  The HAM data base was developed
  1093.      by Eric Scace (K3NA), who was also invaluable in the design of the GEOCLOCK
  1094.      interface to the HAM functions.
  1095.  
  1096.      I.    Bulletin Board
  1097.  
  1098.          A free Remote Bulletin Board System (RBBS) provides support for users
  1099.      of the GEOCLOCK sunlight clock program.  It always has the latest and
  1100.      untainted version of GEOCLOCK available for downloading.  In addition, it
  1101.      provides a forum for all interested parties for program and information
  1102.      exchange concerning GEOCLOCK, high quality graphics for the IBM PC, high
  1103.      quality mapping for the IBM PC, and Turbo Pascal.  Information on potential
  1104.      applications and needs is as important as information on techniques and
  1105.      software.  The board is intended to help identify and solve real problems.
  1106.          Registered GEOCLOCK users have access to certain special files and
  1107.      higher access limits.  HAM package owners also have access to the latest
  1108.      version of the HAM data base.  Please have your registration number handy
  1109.      when you log on for the first time.  Except for these special files, the
  1110.      messages and files on the board are available to everyone.
  1111.          I also solicit comments and suggestions.  I am especially interested in
  1112.      including position and phase data for the moon and perhaps other planets.
  1113.          The RBBS number is 703-241-7980.  This is a Washington DC metro area
  1114.      number.
  1115.  
  1116.      J.    Upgrades and Enhancements for Registered Users
  1117.  
  1118.          The GEOCLOCK bulletin board always has the latest version of GEOCLOCK,
  1119.      and a variety of extra map files and utilities available.  In addition,
  1120.      many other bulletin boards and shareware distribution services carry the
  1121.      latest version of GEOCLOCK.  Registered users may obtain the latest version
  1122.      from any of these sources.  When a new version is released, replace the
  1123.      files you originally received with the new versions.  The REGISTER program,
  1124.      supplied on your distribution disks, must be rerun to enable the special
  1125.      features such as ZOOM and DISTANCE that are available only to registered
  1126.      users.  If you have customized any of the GE*.DAT files, you may want to
  1127.      use the old versions of these files, or to edit the new versions to reflect
  1128.      your specific requirements.
  1129.  
  1130.      K.    Registration and License
  1131.  
  1132.          The GEOCLOCK program is distributed as Shareware.  This means that
  1133.      prospective users may use the program for a short evaluation period before
  1134.      deciding whether to purchase it.  A license must be obtained to use any
  1135.      copy after this evaluation period.  By sending $30 to the address below,
  1136.      you will receive a single copy license, the latest version of the program,
  1137.      a registration program which will enable a few special features in the
  1138.      GEOCLOCK program not available in the evaluation version (see section E), a
  1139.      file with the name, latitude, and longitude of many world cities for
  1140.      building GEOCLOCK.DAT files, a "starter set" of GEO*.DAT files, and 28
  1141.      maps.
  1142.  
  1143.  
  1144.                                         - 20 -
  1145.      Joseph R. Ahlgren           GEOCLOCK version 4.2                   90/06/20
  1146.  
  1147.  
  1148.  
  1149.           The prices for the GEOCLOCK program are:
  1150.  
  1151.            1 copy              $30
  1152.            2-9 copies          $25/license
  1153.            10-20 copies        $20/license
  1154.            21-40 copies        $15/license
  1155.            site license        $600 for unlimited use at a single site.
  1156.  
  1157.           The multi unit prices assume that the purchaser will produce the
  1158.      authorized copies from a single master copy.
  1159.  
  1160.           GEOCLOCK is normally shipped on two 360K 5.25" floppy disks.  It is
  1161.      available on a 720K 3.5" floppy disk for an additional $5.00.  
  1162.  
  1163.           For an additional $20, a set of at least 15 supplemental maps will be
  1164.      included, and the next major release of the program will be mailed when it
  1165.      becomes available.  All these items are available for downloading at no
  1166.      charge from the GEOCLOCK support RBBS.  See section I.
  1167.  
  1168.           An add-in package for HAM operators is available for an additional
  1169.      $30.  This package includes a custom azimuthal-equidistant map centered on
  1170.      you HAM station, and a data base containing key call sign information.  Be
  1171.      sure to specify your call sign and station lat/long.  See section H for
  1172.      more details.
  1173.  
  1174.           Please add $5.00 for shipping and handling for destinations outside
  1175.      the US and Canada.  Cash or checks in US funds draw on US banks only.
  1176.  
  1177.           The file MAILER can be printed to give both a registration form and an
  1178.      envelope.
  1179.  
  1180.           Additional custom maps can be produced from my existing database for
  1181.      $30 per map.  Simply specify the latitude and longitude of the center
  1182.      point, and the north to south distance on the map (the map will be scaled
  1183.      so that distances and azimuths are correct in the center of the map), or
  1184.      the latitude and longitudes of the corner points.  Custom maps based on
  1185.      user supplied feature data or other projections (the GEOCLOCK program only
  1186.      uses flat rectangular, polar, and azimuthal-equidistant projections, but
  1187.      Lambert and perspective projections are available) are possible but must be
  1188.      negotiated on a case-by-case basis.
  1189.  
  1190.  
  1191.                                         - 21 -
  1192.      Joseph R. Ahlgren           GEOCLOCK version 4.2                   90/06/20
  1193.  
  1194.  
  1195.                                     Maps included with registration:
  1196.  
  1197.      MAP1    World                     MAP2    48 States
  1198.      MAP3    Eastern US                MAP4    SouthWestern US
  1199.      MAP5    Western Europe            MAP6    Alaska
  1200.      MAP7    New York City Area        MAP8    Finer Scale NYC
  1201.      MAP9    SouthEastern US           MAP10   NorthWestern US
  1202.      MAP11   Chicago Area              MAP12   Texas
  1203.      MAP13   Washington DC             MAP14   Carolinas
  1204.      MAP15   Pennsylvania              MAP16   New England
  1205.      MAP17   Central America           MAP18   South America
  1206.      MAP19   Africa                    MAP20   Australia
  1207.      MAP21   India                     MAP22   Middle East
  1208.      MAP23   Micronesia                MAP24   Japan
  1209.      MAP25   China                     MAP2000 North Polar Map           
  1210.      MAP2001 North Polar Map 45        MAP2002 South Polar Map
  1211.      MAP4001 VGA world                 MAP4002 VGA 48 states
  1212.      MAP6149 SVGA world                MAP6002 SVGA 48 states
  1213.  
  1214.                                     Maps included with optional supplemental
  1215.      disk:
  1216.  
  1217.      MAP26   North Central Europe      MAP27   Western Europe
  1218.      MAP28   North Central Europe      MAP30   San Francisco Area
  1219.      MAP31   USSR                      MAP32   North Atlantic
  1220.      MAP33   Scandinavia               MAP34   Highlands and Islands
  1221.      MAP35   Southern California       MAP37   Southern California
  1222.      MAP38   Sierra Nevada             MAP54   Canada
  1223.      MAP71   The Aegean Sea            MAP77   Silicon Valley
  1224.      MAP92   British Isles             MAP100  Switzerland
  1225.      MAP104  Prince William Sound      MAP131  Mexico
  1226.      MAP149  World Version 3  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.                                Joseph R. Ahlgren
  1232.                               2218 N. Tuckahoe St
  1233.                               Arlington, VA  22205-1946