home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS - Coast to Coast / simteldosarchivecoasttocoast2.iso / turbo_c / mapper17.doc < prev    next >
Text File  |  1994-03-07  |  5KB  |  92 lines
  1.  
  2.                              The Mapper Program
  3.  
  4.                                  Version 1.7
  5.  
  6.                               22 November 1988
  7.  
  8.  
  9.          I was interested in techniques  for producing maps, and  found
  10.       the article by William D. Johnston in the May and June 1979  Byte
  11.       Magazine.    This   two  part  article   provided  an   excellent
  12.       introduction and source  code in Basic  Language.   His code  was
  13.       restricted to the algorithms and  did not get involved with  user
  14.       interface.  To evaluate his algorithms and try out the displays I
  15.       coded the program and a simple interface in Turbo-C Version  1.5.
  16.       The program in its current form is highly based on Mr. Johnston's
  17.       algorithms and provides no significant additional capabilities.
  18.  
  19.       I also found  a high resolution database  called the Micro  World
  20.       Data Bank II (MWDBII).   This database was  1 megabyte in  length
  21.       and good down  to minutes  of a degree.   See the  C source  code
  22.       comments for availability.
  23.  
  24.       To run the  program and receive  help you  use the DOS  common
  25.       method of the question option "/?".  Just type "mapper/?" and the
  26.       following usage help will be displayed:
  27.  
  28.               Usage: mapper [/bcdgilmrsx]
  29.  
  30.                 /b   Boundaries Off
  31.                 /c   Countries On
  32.                 /dn  Database ('MWDBII' Default)
  33.                 /g   Grid lines On
  34.                 /i   Islands Off
  35.                 /l   Lakes Off
  36.                 /mn  Map Resolution (5 Default)
  37.                 /r   Rivers On
  38.                 /s   States On
  39.                 /x   Colors On
  40.  
  41.               Defaults to Boundaries and Islands On
  42.  
  43.       The defaults are what I thought should be fairly common.  The map
  44.       database has  5 resolutions,  and can  be selected  with the  'm'
  45.       option.  5 is the  lowest resolution and 1  is the greatest.   If
  46.       you have several different databases  you can use the 'd'  option
  47.       and provide the path and filename (128 Characters max).  The  'm'
  48.       and 'd' options  should be placed at  the end.   They can be  put
  49.       anywhere  but  it's  a  little  easier  at  the  end.    Example:
  50.       mapper/glrsm1.  If you use the option in the middle you will need
  51.       to put a  space between it  and the  remaining options.  Example:
  52.       mapper/glddata /rs.  These are the most foolproof methods.  Note:
  53.       The level 5 database included doesn't really use the options yet.
  54.       The program works as advertised on level 1. There are some errors
  55.       with the database as you'll see.  I've converted the database  to
  56.       ASCII, and am working on cleaning up the errors and redundancies.
  57.  
  58.          A little about the speed of the result.  The program is  quite
  59.       slow on an 8088 without a math coprocessor, and speed is  getting
  60.       acceptable on  an 80286.   The  C language  standard uses  double
  61.       precision math.    This is  a  waste  with the  current  database
  62.       resolution.  An integer version  of the math routines would  sure
  63.       speed up  the program  quite  a bit.    The mapper  program  uses
  64.       Turbo-C auto detect  of a  math coprocessor  and graphics  device
  65.       type (CGA, EGA, and VGA).
  66.  
  67.          If you want to quit the  plotting on the screen, just hit  any
  68.       key and the bell will  sound and exit you back  to DOS.  You  can
  69.       also use Control-C to get out.
  70.  
  71.          The C program  lists three sources  for the  Micro World  Data
  72.       Bank II database.  The  database is 1 Megabyte (800K  Compressed)
  73.       and is just too much data for reasonable downloading.   To see if
  74.       the program  would  be  useful  for you  I  included  a  level  5
  75.       resolution map (the lowest resolution).  This particular database
  76.       has all  the data  thrown together  so the  command line  options
  77.       aren't fully functional.  They  become functional at about  level
  78.       3 I believe.
  79.  
  80.          This program was tested  on a PC XT  Clone, 640K, and NSI  EGA
  81.       board.  Also a Zenith Z-248 with 512k and CGA was tested.   Other
  82.       configurations will need to be tested.
  83.  
  84.       Due to  the  grid  method used,  it  shouldn't  be used  with  an
  85.       Azimuthal Equidistant map.   You can  try it once  to see what  I
  86.       mean.  There's lots of room for improvements, "Handle It!".
  87.  
  88.       Thanks to Mr. Johnston for his article and algorithms.
  89.  
  90.       USMail: Steve R. Sampson, Box 45668, Tinker AFB, Oklahoma, 73145
  91.       Compuserve: 75136,626  Unix: sampson@killer.dallas.tx
  92.