                         KANSAS Version 1.0
                   Copyright (c) 1989,1990  JC Garrison

I.  About KANSAS

      The purpose of this program is to provide detailed county road maps for
the state of Kansas.  A great deal of time and effort has gone into this
product to ensure that the county maps which are produced are accurate. 
However, some slight inaccuracies may occasionally occur (due to continuing
road construction, road closings or reroutings, etc).  For this reason, no
liability is claimed for this product.
      Essentially, the purpose of this program is to provide maps to guide the
intrepid traveler who likes to stray from the major highways and see the
state, rather than just driving through.  For optimum map quality, a high
resolution graphics screen driver is strongly recommended (hercules, EGA, MCGA
or VGA), although CGA drivers are supported.  Maps are generated and
customized by the user via a series of menus, and can be printed on either an
Epson (or compatible) dot matrix printer or a Hewlett-Packard (or compatible)
laser printer.  Detailed city street maps are NOT supported in this version of
KANSAS.
      Township/range boundaries, cities, major roads and minor roads can be
displayed with this program.  In addition, the ZOOM option allows the user to
magnify any portion of a map for viewing or printing.  The ZOOM option is
particularly valuable when a number of roads converge in a relatively small
area.  By using the ZOOM option to enlarge the portion of the map in question,
you should be able to tell which roads connect with one another.  However, it
should be noted that in the case of Limited Access Highways (mainly the
Interstate highways), minor roads frequently cross over or under the highway
without allowing access.  KANSAS Version 1.0 does not differentiate between
roads which cross (do not access) and those which intersect (do access)
Limited Access Highways.  As a general rule of thumb, Limited Access Highways
can be entered from other major roads (Interstate, US or State highways).


II.  Installation

      KANSAS can be run from either a floppy or hard disk, however, because of
the large number of county data files, a hard disk is recommended. To install
KANSAS, the following files must be present:

     KS.EXE - the main program
     KANSAS.DT - State map datafile
     SETUP.EXE - defines screen driver, printer, and line styles
     SETUP.KS - a datafile created by SETUP.EXE
     MANUAL.TXT - the manual describing the installation and use of KANSAS
     *.KDT - county datafiles.  There are 105 counties in Kansas (not all
counties are currently supported), and datafiles average approximately 5-10
Kbytes (each).  For full functionality, all files may be loaded into the
working directory.  However, if you wish to conserve disk space, load only
those county datafiles of interest.

Step 1:
      [floppy-drive system]-Copy the files listed above onto a floppy disk. 
            All files must be in the same directory.
      [hard-drive system]-Create a working directory using the DOS MD command 
            (for example, "md kansas" would create a directory called kansas). 
            Copy all files listed above into this new directory.
Step 2:
      Run the setup program by typing SETUP.  This is necessary for proper
      scaling of the maps on the screen and to the printer.
Step 3:
      In the setup program you will be asked for your screen driver.  The
      choices are CGA, mCGA, hercules, EGA, VGA or user defined.  Choose the
      screen driver for your system.  Should the maps be mis-proportioned
      (improper aspect ratio) on the screen when running KANSAS, the setup can
      be rerun, choosing a different screen driver.  The choice (USER DEFINED)
      should be used as a last resort, if none of the other drivers give the
      proper screen aspect ratio.  It allows you to specify the display
      resolution of your screen in order to determine the proper aspect ratio
      for the program.
Step 4:
      In the setup program you will be asked for your printer type.  The only
      choices currently supported are Epson dot matrix or Hewlett Packard
      laserjet printers (or the equivalent compatibles).
Step 5:
      In the setup program you will be asked for linestyle definitions for the
      maps.  Choose default settings the first time you use the program.  If
      at a later time you wish to customize your map line styles, you can
      rerun the setup program.  (Line styles can also be set within the
      program.)

At this point, KANSAS should be installed.  To run the program, type KANSAS.

III.  Getting Started

      When first starting KANSAS, an opening screen appears, followed by a
series of menu options.  Figure 1 below is a tree diagram of the nested menu
structure of KANSAS.


                          MAIN MENU
                              
             STATE                                   COUNTY
    Ŀ  
                                                              LEVEL 1

  CITIES      US     INTERSTATE                       COUNTY
           HIGHWAYS   HIGHWAYS                        OPTIONS

                                                        
                                                        
       Ĵ
                                                                LEVEL 2

     PRINT                   COUNTY                  COUNTY
                             NAMES                    MAPS
                                                        

                                                    COUNTIES
                                                   AVAILABLE
                                                        
                                                        
  Ĵ
                                                             LEVEL 3
                                                                  (PRIOR TO)
COUNTY   TOWNSHIP  TOWNS/   MAJOR     MINOR     USER            (MAP DISPLAY)
BORDER    /RANGE   CITIES  HIGHWAYS  HIGHWAYS  DEFINED  
                                                LINES   
                                                        
                                                        
                                                        
   Ŀ
                                                            LEVEL 3

COUNTY   TOWNSHIP  TOWNS/   MAJOR     MINOR    PRINT  ZOOM  CLEAR
BORDER    /RANGE   CITIES  HIGHWAYS  HIGHWAYS              SCREEN
                                                        
                                                        
   Ĵ           LEVEL 4
                                                  

COUNTY   TOWNSHIP  TOWNS/   MAJOR     MINOR    PRINT  CLEAR
BORDER    /RANGE   CITIES  HIGHWAYS  HIGHWAYS          ZOOM
                                                      WINDOW

      As can be seen, there are 4 levels of menus:
            1) the main menu, selecting between state maps or county options
            2) the county options menu
            3) the county map menu
            4) the zoom menu

LEVEL 1 - MAIN MENU

      The main menu offers 2 basic types of options, State maps or a variety
of county options.  The state maps are fixed format maps.  The only choices
are maps showing 1) the larger cities, 2) US highways, 3) interstate highways,
or 4) a combination of all 3.  Because of the limited resolution of most
computer monitors, and in order to prevent overlap, city positions are
displayed by numbers rather than by name (state map only).  A popup window
appears automatically in the State/Cities map in order to identify cities. 
This window can be closed using the <ESCAPE> key.  State maps can be printed,
but they cannot be enlarged or modified.
      The county options menu produces a map of the state, showing the
placement of all counties.  Counties are identified on the map by their
official 2-letter abbreviations (these abbreviations are the same as used by
the Kansas Dept of Motor Vehicles on car license tags).  The County Options
menu is displayed at the bottom of this screen.


LEVEL 2 - COUNTY OPTIONS

      There are 4 basic options in the County Options menu.

      1) The state map with the county overlay can be printed.

      2) A list of all counties and their official 2-letter abbreviations can
be shown.

      3) A specific county can be chosen for viewing.  Before choosing this
option be sure to find which 2-letter county code corresponds to the county of
interest (see county option 2).  When (3) is chosen, you are given a list of
counties to choose from.  This list is generated from the county data files in 
your directory, and the counties are listed by their 2-letter code (NOT by
their full names).  To choose a county from this list, type in the 2-letter
code.  This will place you in the County Map menu.

      NOTE:  If the county of interest was not found in this list, you should
      exit the program and check your program directory.  DO NOT rename any of
      the data files, as this may create inaccurate map display.

      4) You can exit back to the Main Menu.


LEVEL 3 - COUNTY MAPS

      After choosing the county of interest, you are initially offered 7
options in the County Map menu, and then after choosing the first map type for
display, the menu adds 2 more options.  County maps differ from the state map,
in that these maps are not fixed format.  Any one map type (e.g., major roads)
can be used as an overlay to a second map (e.g., cities), allowing a user-
defined composite map to be produced.  In addition, different linestyles are
available for roads, borders, and township/range demarcations.

      1) County outline.  With this option you can generate a map showing the
outline of the county (county borders) with a mileage scale bar.  The scale
bar is only generated when this option is chosen.

      NOTE: The first time a map is generated from the County Maps menu, the
      county outline is produced, regardless of whether the map choice was for
      township/range, major roads, minor roads or towns.  No scale bar is
      produced using these choices.  This was done intentionally, since in
      most cases the user will prefer to see the county borders.  To generate
      a map without the border, choose the clear screen option and then choose
      the map type (e.g., township/range, city or road).

      2) Township/range.  Choosing this option generates the township/range
overlay.  Basically, townships are tracts of land measuring 6 X 6 miles (a
typical township is 36 square miles).  The specific geographic position of the
township is demarcated by a series of North-South and East-West coordinates.

      3) Cities/towns.  This option places the cities and towns on the map. 
You are offered the choice of displaying the towns with or without labels
(e.g., with or without the name).

      4) Major roads.  Major roads (in the context of ALL roads in the county)
are considered roads which are paved and amenable to travel.  This includes
all Interstate, US and State highways, as well as a number of improved county
roads.  Roads can be displayed with or without their associated labels (e.g.,
route numbers).

      NOTE:  Road and town labels may overlap in some instances when viewed in
      CGA mode, due to the low graphics resolution of CGA drivers.

      5) Minor roads.  Minor roads are county maintained roads, often of
relatively poor quality (gravel or unpaved).  Most private roads are not
displayed.

      NOTE:  Placing town and road labels on your map in combination with
      minor roads may cause a "cluttered" appearance that is difficult to read
      (particularly in heavily populated counties with numerous small towns). 
      In these instances it is suggested that you print 2 maps, 1) a map of
      towns and major roads (and their labels) only, and 2) a map of towns,
      major roads and minor roads (without any labels).


      6) User-defined linestyles.  This option is only available prior to
choosing a map type to display, and is only found in the initial COUNTY MAPS
menu.  The user may define linestyles for:
            a) The county border
            b) Township/range lines
            c) Major roads
            d) Minor roads

Available linestyles include continuous, dots, dot-dash-dot or dashed.  Any of
these lines may be specified as thick or thin, giving a total of 8 different
possible choices.  The default values are:
            a) Thin, continuous lines for major and minor roads, and for the  
               county border.
            b) Thin, dashed lines for the Township/range lines.
These values were chosen to optimize the accuracy of the maps, but the user is
encouraged to experiment to find the linestyles he or she finds most
acceptable.  Once the user has defined the linestyles from the COUNTY MAPS
menu, these linestyles remain active until program termination.  To make the
user-defined linestyles permanent, use the setup program (see II.
Installation).

*     After displaying an initial map (choice 1-5), the COUNTY MAPS MENU
offers 3 additional options:

      7) Print.  The entire map from the screen can be printed.  When this
option is chosen, the name of the county will also be printed at the base of
the map.

      8) Clear screen.  Clearing the screen has several purposes.  Since the
initial map always displays the county border, the only way to display the
roads, towns and township/range maps without this border is to erase the
initial map.  Using this option also allows for relatively quick viewing of a
variety of different maps of a county.

      9) Zoom.  This option accesses the LEVEL 4 menu, which allows enlarged
views of any portion of the county map.  When this is option is chosen, a
corner marker (  ) appears within the map.  The purpose of this marker is to
mark the upper left corner of the region to be "zoomed".  This marker can be
moved to any position of the map using the arrow keys.  Once the desired upper
left corner position is reached, the <ENTER> key marks the position.  The
lower right corner marker (  ) appears at this time at the upper left corner
position.  Again, use the arrow keys, and move this marker to the desired
lower right position.  Press <ENTER> to mark this position.  At this time a
window will open to display the "zoomed" map region, and the ZOOM MENU (LEVEL
4) will appear.

      10) You can exit back to the COUNTY OPTIONS menu.


LEVEL 4 - ZOOM OPTIONS MENU

      The same basic options which were available in the COUNTY MAPS MENU are
also available in the ZOOM OPTIONS MENU, with a few minor differences.

      1) County outline. This option allows display of any of the county
border that is present in the chosen window.  Scale bars (mileage) are not
displayed.

      2) Township/range lines.  Same as in the COUNTY MAPS MENU.

      3) Cities/Towns.  Similar to the Cities/Towns option in the COUNTY MAPS
MENU, except for the labeling.  On a zoomed map, town names are linked to the
upper right portion of the town.  The names are only displayed when this
portion of the town (with some adjacent clear space to the right) appears
within the ZOOM window.

      4) Major Roads.  Similar to the Major Roads option in the COUNTY MAPS
MENU, except that the labels are automatically displayed.

      5) Minor Roads.  Same as in the COUNTY MAPS MENU.

      6) Clear Window.  Same as in the COUNTY MAPS MENU.

      7) Print.  Same as in the COUNTY MAPS MENU.

      8) Exit to the COUNTY MAPS MENU.


                        MORE ABOUT DISPLAY MONITORS
      The potential resolution of your display is the limiting factor in the
quality of the maps generated by KANSAS.  This program will attempt to
automatically determine the highest resolution that your display board is
capable of generating, and display the maps based on this resolution.  For
example, a CGA monitor displays color at 320 X 200, and monochrome at 640 X
200.  KANSAS will choose the 640 X 200 display as the default resolution. 
However, since there are numerous display boards on the market, many with
proprietary high-resolution displays, we cannot guarantee that KANSAS will
correctly choose the highest resolution in all cases (but it should work with
the major standards).
      This program has been tested using a number of standard video drivers,
including hercules, EGA, mCGA, VGA (640 X 480), and CGA.  While KANSAS Version
1.0 will run on a CGA display, this display adapter is not recommended because
of its low graphics resolution.  Other drivers have not been tested, including
the AT&T (640 X 400) or the high resolution "super-VGA" (800 X 600 or 1024 X
768) drivers.  It is possible that the print option may not function correctly
with the very high resolution VGA screen drivers, since printer data is
derived directly from the video image.  If problems arise using the "super-
VGA" mode, you may be able to correct the problems by setting your VGA driver
to the standard 640 X 480 resolution (see your video adapter manual to
determine if this is possible).

                        MORE ABOUT PRINTING
      At the current time KANSAS only supports 2 types of printers, 1) dot-
matrix printers that are Epson compatible or 2) Laser printers that are
Hewlett-Packard compatible.  These are the 2 most common types of graphics
printers on the market today.  In addition, the printers are only supported
through port LPT1 (parallel port number 1).  If your printer is connected via
LPT2 or one of the COM ports (e.g., serial ports), you may be able to redirect
the printer output to these ports using the DOS "MODE" command.  See your DOS
manual for details on using the mode command.
      The quality of the printout is dependent on the resolution of the screen
used for image display.  The reason for this is that each pixel (point) on the
screen is directly transferred to a corresponding position on the printout. 
In the case of relatively low resolution monitors (CGA), there are fewer data
points to transfer, thus producing a smaller printout.  In addition, most of
the older standards (CGA, Hercules and EGA) do not produce a 1:1 screen aspect
ratio (VGA does produce a 1:1 aspect ratio).  Images on screens without a 1:1
screen aspect ratio will produce misproportioned printouts unless the images
are first "corrected".  When using one of these display types, KANSAS will
"correct" the image by redisplaying the screen image using the PRINTER aspect
ratio prior to printing.  At this time the screen image may look elongate. 
After printing is complete, the screen image will return to its proper SCREEN
aspect ratio.

      NOTE: When using a CGA display (NOT RECOMMENDED), printouts from the
      KANSAS MENU print option are usually smaller than most users would find
      acceptable, due to the small number of datapoints which are printed.  A
      better quality printout can be obtained using the DOS graphics program. 
      This can be accomplished by loading the DOS program "GRAPHICS.COM" prior
      to loading KANSAS.  The DOS graphics program is a RAM-resident program
      designed to send graphics screen images to the printer.  Once the DOS
      graphics program has been loaded, load KANSAS and proceed as usual. 
      When printing an image, however, use <SHIFT><PRINT SCREEN> instead of
      the KANSAS print option.  For more information on the DOS graphics
      program, see your DOS manual.

                       MAPS (COUNTIES) CURRENTLY SUPPORTED

      As of 12-20-89 the following counties are supported by KANSAS:

AN - ANDERSON                 GO - GOVE                     PL - PHILLIPS
AT - ATCHISON                 HG - HODGEMAN                 RL - RILEY
BB - BOURBON                  JF - JEFFERSON                RO - ROOKS
CA - CLARK                    JO - JOHNSON                  RS - RUSSELL
CK - CHEROKEE                 LC - LINCOLN                  SA - SALINE
CM - COMANCHE                 LE - LANE                     SC - SCOTT
DG - DOUGLAS                  LG - LOGAN                    SG - SEDGWICK
DP - DONIPHAN                 LN - LINN                     SH - SHERMAN
EL - ELLIS                    LV - LEAVENWORTH              SN - SHAWNEE
EW - ELLSWORTH                MC - MITCHELL                 TR - TREGO
FR - FRANKLIN                 MI - MIAMI                    WB - WABAUNSEE
GH - GRAHAM                   OB - OSBORNE                  WY - WYANDOTTE

      Additional counties are being added to this list on a regular basis
(approximately 1-2 counties per week, on the average).  A list of maps
currently available can be obtained by sending a stamped, self-addressed
envelope to the address listed under registration (below).

                             PRODUCT REGISTRATION

      The version of KANSAS which is distributed through non-retail sources
(version 1.0) is a fully functional version of the program.  It may be freely
copied, with the following provision.  Only a selected number of county data
files (10 representative files) may be freely copied and distributed.  The
county data files which may be freely copied and distributed are listed below:

      BB.KDT - BOURBON              LN.KDT - LINN
      EL.KDT - ELLIS                MI.KDT - MIAMI
      GO.KDT - GOVE                 RS.KDT - RUSSELL
      JF.KDT - JEFFERSON            SA.KDT - SALINE
      JO.KDT - JOHNSON              TR.KDT - TREGO

Counties other than those listed above may not be distributed, under any
circumstances.  Registered users will be sent a complete set of currently
supported county data files, and will also be entitled to one free data file
upgrade.  There are currently 36 counties which are supported (see list of
supported files above) and more counties are being added on a regular basis. 
Registered users will receive these 36 data files (or however many more are
currently available) upon registration.  The registered user may request one
(1) county data file upgrade of all currently available data files at no cost. 
Additional data file upgrades (registered users) will cost $5, to cover
shipping and handling.  The user may opt to wait until all Kansas counties are
supported before upgrading, or may upgrade any time before (send for a list of
current counties available to determine when to upgrade).  Currently, counties
are being added in a sequence roughly based on 1) county population and 2) the
number of Interstate and US highways bisecting the county.  If you need a
specific county map which is not presently supported, write the author (JC
Garrison) and that county will be given a higher priority for early
completion, although a specific completion date will not be guaranteed (no
charge for this service).

      To register KANSAS version 1.0, please:

      1) Send $25 to:

            JC Garrison
            6533 Cottonwood
            Shawnee, Ks  66216

      2) Specify 3 1/2" or 5 1/4" diskettes





                  <<Custom map services available>>