home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 31 / CDASC_31_1996_juillet_aout.iso / vrac / aprtrak.zip / README / MAPFIX.TXT < prev    next >
Text File  |  1995-07-20  |  12KB  |  251 lines
  1. MAPFIX.txt  Ver 1.4        NOTES  ABOUT  USING  MAPFIX
  2.  
  3.  
  4. MAPFIXxx.bas/exe is a very versitile program for drawing, building and
  5. fixing APRS maps.  This file consists of a lot of text removed from the
  6. program to give room for more routines.  Each time you run a new version
  7. of MAPFIX, be sure to look at the first help screen for any changes.
  8.  
  9. MAKEMAPS.BAS is a very handy program written by Jack Cavenaugh KB4XF which 
  10. automates the process for extracting 32 to 64 mile APRS maps directly in
  11. one step from the 2,000,000 CD ROM.  Then you can use MAPFIX alt-SCRUNCH
  12. command and other aids to get points below 3000.  This is better than the
  13. built in MAPFIX alt-USGS process which takes many steps.  See MAPS-CD.txt.
  14.  
  15. USGSMAP1.bas/exe  Is a revision by W4NMK of MAKEMAPS so that it can work
  16. with data files downloaded via the internet instead of from an attached
  17. CD ROM.  The internet address for these maps is:
  18.  
  19.      http;//edcftp.cr.usgs.gov/pub/data/DLG/2M/{area of interest}
  20.               /{transportation/hydrographic/political/railroads}/
  21.  
  22.  
  23.  
  24. OVERVIEW OF MAPFIX:
  25.  
  26. MAPFIX can build and edit APRS maps in a variety of ways:
  27.  
  28.    FREE-HAND: Good for filling in roads, but hard to make roads exact
  29.    CDROM:     Gets points from 2,000,000:1 and 100,000:1 USGS CD ROM.
  30.               Both generate Mbytes worth of points that take a lot of
  31.               time to filter down to a useable APRS size!
  32.    TABLET:    Connect a digitizer tablet and draw! BEST METHOD!
  33.    GPS DATA:  Replay any APRS GPS track history file and DRAW map lines
  34.               over the track
  35.    CONVERSION:Change origin or scale on-line (old function of MAPCNVRT.bas)
  36.    IMPORTING: Import features from other maps with auto-point conversion!
  37.  
  38.    Although MAPFIX is very versitile, manipulating points with a TEXT
  39.    EDITOR is still useful for whole scale rearranging of points and
  40.    features in a map file.
  41.  
  42.    MAPFIX uses the normal yellow APRS cursor, and a White MapPoint which
  43.    marks the next point to be processed.  ALT Keys allow you to MOVE the
  44.    MapPoint to the cursor, ADD a new point at the cursor, or DELETE the
  45.    MapPoint.  The G key will GO to the MapPoint and conversly, F will
  46.    FIND the point nearest the cursor.
  47.  
  48.    CAUTION, THIS PROGRAM IS NOT PERFECT... KEEP BACKUPS!  Do a little
  49.             at a time!
  50.  
  51.  
  52. BOUNDARY BOXES AND ORIGINS DISPLAY:  First, you will notice that MAPFIX
  53. draws a few permanent and temporary boxes and markers on the map as follows:
  54.  
  55. YELLOW ORIGIN:  The 0,0 point for pixels
  56.  
  57. YELLOW BOX:     MAX values.  Extending from the ORIGIN to the right and
  58.                 down to show the maximum values for X (2048) and Y (1024)
  59.  
  60. PURPLE BOX:     Temporary display of MAX values at different PPD scales.              
  61.                 Use the BOX (B) command to test other PPD values. 
  62.  
  63. WHITE BOX:      The RANGE limit around the center of the map.  This is
  64.                 used by APRS and the MAPLIST.xxx file for deciding when
  65.                 to load this particular map.  The WHOLE screen must fit
  66.                 within this white box, before the map is loaded for use.
  67.                 DOES NOT affect any map points or data. (only the RANGE
  68.                 listed in MAPLIST.xxx is actually used by APRS).
  69.  
  70.  
  71. WHITE CROSS:    The MAP CENTER as to be listed in MAPLIST.xxx along with
  72.                 the RANGE for APRS to know when to load this map.  Does
  73.                 NOT affect any map points or data.  Only the CENTER
  74.                 listed in MAPLIST.xxx is actually used by APRS).
  75.  
  76. WHITE CIRCLE CURSOR:  Marks the current MAP POINT for editing...
  77.  
  78. APRS YELLOW CURSOR:   Simply a pointer for all functions.
  79.                
  80.  
  81. ----------------------------------------------------------------------------
  82. HERE IS THE BASIC HELP SCREEN FOR MAPFIX:
  83.  
  84.  
  85.  OPERATIONS          MAP FUNCTIONS         POINT FUNCTIONS     LABEL COMMANDS
  86.  
  87.  H - HELP SCREENS    @C- Change CENTER     @A - ADD point      S - SHOW labels
  88.  D - map DIRECTORY   @R- set map RANGE     @D - DELETE point  @L - add a LABEL
  89. ^S - SAVE MAP!!!     @T- TRIM border Pts   @K - Kill feature   L - LABELS off
  90. ^L - LOAD NEW map    @I- IMPORT from map   @M - MOVE point     K - KILL Label
  91. @G - GPS Overlay     ^O- OVERLAY a map     @N - NEW feature
  92.  C = CLEAR Sngle Pts  M- show MAPLIST      ^C - CHANGE Color
  93.  Q - QUIT             O- OTHER map bordrs       
  94.  
  95.  
  96.  DISPLAY COMMANDS     POINTER MOVEMENTS   USGS CD ROM CMDS  DIGITIZER/MOUSE
  97.  
  98.  SPACE to draw map    N- Next Feature     B- BOX PPD area   @O- OPEN COMMS
  99.  ARROWS  (shft)       P- Prev Feature     U- USGS overlay   @B- BEGIN new line
  100.  PgUP/DN (ctrl)       G- Go to Pointer    T- Test Scruncher F1- MOVE cursor
  101.  HOME to Cursor       F- Find point      @S- SCRUNCH file        vice ADD pt
  102.  HOME(shft) to Orign ^F- Find another    @U- USGS Load!     F3,4,6,7,8,10,
  103.  END to map center    R- RESET to 1st Pt @J- JOIN lines     F1,2shftd=11,12
  104.                      ^R- REDRAW on/off                        HOTKYS begin Ln
  105.                      ^A- AUTOCENTER on/off                  F9- Init Mouse
  106.                      +/- move Pointer
  107.  
  108.  F1 Temporarily re-defines Digitizer point to move cursor vice ADD point
  109.  F2 Convert Origin to new point and/or Pix/per/deg
  110.  F3 (SHFT) Save mapfile in COMPRESSED format
  111.  F4 (SHFT) Save mapfile in ASCII format
  112.  F5 Slows GPS Overlay so you can see chronology of replayed points
  113.  F8 (shft) Adds MARKER to map.  Useful for re-calibrating MOUSE
  114.  F9 Initialize Microsoft serial port mouse
  115.  
  116.  
  117. ------------------------------------------------------------------------------
  118.  
  119.  
  120. MOUSE MODES:
  121.  
  122.  CURSOR: Use F9 to open appropriate MOUSE port (must be MICROSOFT SERIAL
  123.          MOUSE).  Left button is ALT-ADD and right button is FIND command.
  124.  
  125.  POOR-MANS-MOUSE DIGITIZER:  Use alt-O to OPEN COMM port and READ MOUSE.txt
  126.  
  127.  
  128.  
  129.  
  130. HELP PAGE 2:
  131.  
  132.    1. Ken Swaggart has refined his tools for converting 100,000 USGS data to
  133.       the same format used by MAPFIXER for 2,000,000 data.  See CDROM.txt.
  134.  
  135.    2. MAPFIXER uses the smaller VGA fonts and alternate screen for the map
  136.       and HELP screens.  Therefore it will NO LONGER run on CGA screens
  137.  
  138.    With MAPFIX.bas, you can modify features by moving, adding or deleting
  139.    Points or Killing whole features, ie: roads, rivers, borders, etc.
  140.  
  141.    If the MapPointer and FeatureName get out of sequence, the RESET command
  142.    may fix them, but you should save the file immediately and check it with
  143.    an editor.
  144.  
  145.  
  146.    The TRIM command is sort of the converse of IMPORT.  It will TRIM all
  147.    points outside of the white RANGE box.  It keeps at least one point
  148.    of each line outside of the box, and may need a little clean up at the
  149.    edges.
  150.  
  151.    The MAPLIST command shows your MAPLIST.map file; and the OTHER MAPS
  152.    command shows all MAP borders so you can see how your new map fits in.
  153.    You may use F3 and F4 keys to select smaller or larger map borders to
  154.    draw.
  155.  
  156.  
  157. HELP PAGE 3:        Using GPS Track History Files to draw maps!"
  158.  
  159.  
  160.    To aid in creating accurate maps, W7KKE in Calif wrote a module to
  161.    overlay GPS Track Histories into MAPFIX.  Use this to build and fix
  162.    your own maps!
  163.  
  164.    After you have loaded your map, type alt-G (GPS Track History') and
  165.    enter the history filename.  This will overlay the track history file.
  166.    You may then use the normal MAPFIX.bas routines to move map segments
  167.    and add so that the map will agree with the GPS data contained in the
  168.    track history file.  This is especially useful with the history files
  169.    saved by a laptop during mobile GPS operations.
  170.  
  171.    CAUTION:  Since GPS data is only accurate to 100 yards due to the
  172.    effects of Selective Availability, I would avoid using GPS data
  173.    explicitely below about the 2 mile range.  For this reason, I make
  174.    the size of the GPS positions expand below the 2 mile range to roughly
  175.    approximate the size of the 100 yard error circle.
  176.  
  177.    Note that you can START a NEW map from scratch by just typing NEW
  178.    instread of a MAP filename when starting up the program.
  179.  
  180.  
  181. PAGE 4 INSTRUCTIONS FOR USING A DIGITIZER:
  182.  
  183.    MAPFIX.bas can also accept the serial data from a digitizer tablet or
  184.    table thanks again to W7KKE.  THIS IS THE MOST ACCURRATE WAY TO BUILD
  185.    MAPS!
  186.  
  187.    To use a digitizer, first you must hit the ALT-O command to open the
  188.    COMM PORT for the digitizer.  This command also lets you test the
  189.    digitizer while testing the alignment of the map on the digitizer
  190.    surface.  It then prompts you to identify the upper left and lower
  191.    right corners of the map, in order to calibrate the digitizer to the
  192.    latitude, longitude and scale of the map.  From this point on, the
  193.    0 button on the digitizer mouse, or the PEN is the same as the ALT-A
  194.    ADD command.  Points will be added AFTER the current map point.  To
  195.    start a new map feature, you must first move the cursor to the new
  196.    starting point, before using the ALT-N NEW command.  There are 3 ways
  197.    to move the cursr:
  198.       1) arrow keys
  199.       2) fourth button on a 4 button mouse
  200.       3) press F1 and then use the mouse or Pen (once for each press of
  201.          F1).  OR you may use the alt-B BEGIN command which does NOT
  202.          require the cursor to be moved first.
  203.  
  204.    To speed up the screen during editing, MAPFIX does not erase and re-
  205.    draw the entire map after each new point, but only draws the new line
  206.    segment.  While editing points, the old line remains until you draw a
  207.    new map.            
  208.  
  209.    Use CTRL-R to toggle on and off the RE-DRAW feature.  With RE-DRAW off,
  210.    you can rapidly DELETE points, but you cannot see the effect of the
  211.    deletion until you hit SPACE to redraw the map.  Hitting space turns
  212.    REDRAW back on.  The new ^AUTO CENTER command will force a re-draw of
  213.    the map whenever the MAPPOINT moves off the screen.  Very useful when
  214.    stepping through the points with the +/- key.
  215.  
  216. DIGITIZER HOT KEYS:  F4, F6, F7, F8, F10, shftF1, shftF2
  217.    These keys begin a new line of the appropriate color without having to
  218.    enter a feature name and select a color.  This makes it much easier
  219.    for one handed operation while using the other hand on the digitizer.
  220.  
  221. KILL COMMAND:  Move the cursor to the yellow dot just after a label, and
  222.    then press the K Key to kill the label.  You may need to zoom in some
  223.    in order to get close enough to the label.
  224.  
  225. CLEAR COMMAND:  This C command will scan the entire map file and eliminate 
  226.    any 0 length lines.  THese are seen on the map as lines with one end at 
  227.    the map origin.
  228.  
  229. IMPORT COMMAND:  Using the IMPORT command, you can IMPORT features from 
  230.    many smaller maps into one larger map, or you can take points out of 
  231.    adjacent maps and put them into yours.  Only the points that fit within 
  232.    the current WHITE center-&-range BORDER will be imported.
  233.  
  234. OVERLAY COMMAND:  The OVERLAY command allows you to temporarly overlay 
  235.    map features from one map onto the current map.  This is only temporary, 
  236.    but allows you to compare maps, or to sketch over data from one map into 
  237.    another.  Useful for fixing bigger maps from smaller ones without having
  238.    to bring in all of the detail points.  The format of this command is 
  239.    identical to the @IMPORT command, except that points are only displayed, 
  240.    not added to existing map.
  241.  
  242. COMPRESS MAP:  The SHIFT F3 and F4 commands will COMPRESS and UNCOMPRESS
  243.    an APRS map by about 50%.  This saves disk space by storing X-Y values 
  244.    as binary values vice ASCII BCD.  To make this work, map X-Y values must 
  245.    be less than 2048 for X and 1024 for Y.  No negatives.  To help you 
  246.    choose a map origin and PPD scale, the display boxes have been modified.
  247.    Always keep a copy of the original map file with an extension of .ORG.
  248.    Since the normal ZIP process also compresses by the same amount, there
  249.    is no advantage to compression for DISTRIBUTION, but only for disk
  250.    space, for example for an 8088 laptop floppy system.
  251.