

   mapper plotting software:
      by Russell A. Ambroziak, Ph. D.  
      Reston, Virginia,  Phone 703-648-6168

   command line options:

   /e = EGA
   /v = VGA 640x480x16 colors
   /s = VGA 320x200x256 colors
   /y = Extended VGA 640x400x256 colors
   /x = Extended VGA 640x480x256 colors

   /l [path][file_name].[file_type] = output '.LAB' file of points
   /o [path][file_name].[file_type] = output run information file
   /a [path][file_name] = automatic map load on start

	/grid [sample rate] = outputs 'grid.lab' entry for a grid of points
   /r creates a '.MPR' file with ranges of data for all files then stops
   /h help -- prints this message

   Any path name for data search can by added also, e.g. D:\DATA or
   \MAPPER\DATA\MAP
*

cursor mode options:

   All Maps
      (G)raph Data Points   -- see 'graph.c' for instructions
      (L)ocate Vectors      -- labels line if '*.atr' file exists
      (S)earch for nearest point -- find and labels points if available
     e(x)it to picture      -- lists '*.lbl' files of points if any
   Color Filled Maps All Modes
      (k)ey                 -- plots a small key on right side of screen
      (K)ey                 -- plots a large key on right side of screen
      (N)ame all            -- prints polygon name at all label points
      (P)aint area          -- fills a polygon with color entered and
                               makes entry in '*.lab' file if /l option on
   Color Filled Maps Modes 'X', 'Y' and 'S' Only
      (n)ame 1              -- labels polygon at cursor location
      (p)aint mark          -- makes entry in '*.lab' file if /l option on
      (R)emove lines        -- removes polygon boundaries
      (E)dit colors         -- changes map color and gives color info
      (C)olor table output  -- outputs color table
      (f)lash               -- makes color flash white then return
      (D)arker              -- makes map fill colors darker but not lines
      (B)righter            -- makes map fill colors brighter but not lines



*





The following is the format of a map file.  All comments (which are not part of
the file) are in [square brackets].

p  0.5   18.3  -66.44  10.0

     [  The 1st line has a character and 4 numbers             ]
     [  char is projection                                     ]
     [     p = plate carree or x-y projection (recomended)     ]
     [     a = Albers equal area                               ]
     [     s = polarstereographic                              ]
     [     S = sinusoidal                                      ]
     [     m = Mercator                                        ]
     [  0.5 is pixel size of center pixel in kilometers        ]
     [ 18.3 is latitude of center pixel                        ]
     [-66.4 is longitude of center pixel                       ]
     [ 10.0 is a number of no use but it must be there         ]


*




begin_color                  [  You can define up to 16 VGA    ]
     black    =   0   0   0  [  (or EGA) colors here for use   ]
     d_grey   =  46  46  46  [  in line work.  The format is   ]
     l_grey   = 128 128 128  [  a color name, =, then a red,   ]
     white    = 255 255 255  [  green, and blue color value.   ]
     buff     = 105  90  75  [                                 ]
     l_buff   = 130 111  93  [                                 ]
     brown    =  96  28  14  [                                 ]
     red      = 255   0   0  [                                 ]
     orange   = 255 128   0  [                                 ]
     yellow   = 160 160   0  [                                 ]
     green    =   0 200   0  [                                 ]
     d_green  =   0 120   0  [                                 ]
     vd_green =   0  72   0  [                                 ]
     blue     =  30  60 255  [                                 ]
     d_blue   =   0  20  60  [                                 ]
     magenta  = 255   0 255  [                                 ]
end_color                    [  this must be here to mark end  ]
*

menu_background = d_grey     [  The pull down menu can be made ]
           text = l_grey     [  any color but something must   ]
      highlight = white      [  be given for each item.        ]
     background = buff       [  This is the blank screen color.]
      graticule = l_buff     [                                 ]
        lat/lon = d_grey     [                                 ]
          black = black      [                                 ]
















*
begin_vector 
  geology = 2 ON
    east_geo  3.0 0.0 d_grey 
    west_geo  3.0 0.0 d_grey

[ A list of the vector filenames must be given with group      ]
[ names.  You can have up to 25 groups and up to 25 vectors in ]
[ a group.  The group names are used while the program is      ]
[ running to identify vectors for plotting or labeling.  Each  ]
[ group name is followed by '=', the number of vectors in the  ]
[ group and the word 'ON' of 'OFF' to tell wheter to plot it   ]
[ the first time through.                                      ]
[                                                              ]
[ Each vector name is followed by a maximum pixel size, a      ]
[ minimum pixel size and the color (from above) to plot the    ]
[ vector.  In this example we are going to color in geologic   ]
[ formations so the first vectors (lines) to be plotted are    ]
[ the polygons defining the formations on the map.  They will  ]
[ be plotted when the pixel size is less than 3 km.            ]




*
     fillin_IHS = 1
          geology.blb      3.0   0.0
  2  0.66 234  0.90 Thqdp
  3  0.61 234  0.80 Tgp
  1  0.83 254  0.33 TKgqm
  4  0.81 234  0.50 Thdap
end

[ This entry tells how to fill in the polygons.  It must be    ]
[ located after the polygons are plotted and before other lines]
[ are plotted.  The file 'geology.blb' was made from a file    ]
[ called 'geology.lab' which was made using this program and   ]
[ the /l option, and the cursor mode 'P' option, e.g.          ]
[     mapper /l geology.lab                                    ]
[ then running 'makeblb geology' on the '.lab' file to make    ]
[ the .blb file.                                               ]
[                                                              ]
[  The numbers give the pixel sizes to plot the fill.  The next]
[  1 to 240 lines are polygon fill values (used with the 'P'   ]
[  option in cursor mode) followed by intensity (0-1.0), hue   ]
[ (1-255) and saturation (0-1.0).  Use the cursor mode 'E'     ]
[ option to set and chose these colors.                        ]
*
pattern
     15
     2 * * * 2 * * *
     * 2 * * 2 * * 2
     * * 2 * 2 * 2 *
     * * * 2 2 2 * *
     2 2 2 2 2 2 2 2
     * * * 2 2 2 * *
     * * 2 * 2 * 2 *
     * 2 * * 2 * * 2
     16
     9 * * * 9 * * *
     * 9 * 9 * * * *
     * * 9 * * * * *
     * 9 * 9 * * * *
     9 * * * 9 * * *
     * * * * * * * *
     * * * * * * * *
     * * * * * * * *
end
[ This entry tells how to pattern selected colors with one of  ]
[ the 16 overlay colors.  It must be located just after the    ]
[ color definitions.  This put a l_grey pattern in color 15 and]
[ a yellow pattern in color 16.                                ]
*
begin_names
   Epithermal_Qtz = OFF  pr_25e.loc  3.0 0.0 blue
        ...........     
        ...*****...
        ..*.....*..
        .*.......*.           [ the map and identify them you  ]
        .*.......*.           [ can use the names option.  You ]
        .*.......*.           [ can have up to 25 icons.  This ]
        .*.......*.           [ one draws a blue circle at each] 
        .*.......*.           [ point in file 'pr_25e.loc'.    ]
        ..*.....*..           [  If you wish to plot icons on  ] 
        ...*****...           [ The file contains 2 points as  ]
        ...........           [ follows:                       ]
[ Boulder field_Topographic_high 42.39267 -70.80325 stn2_14.lbl]
[ Fine_sediment_mixed_with_gravel 42.38796 -70.81313 stn3*.lbl ]
[ If there is an image file the label is given after the       ]
[ location.  It can be a single image or a group of images as  ]
[ is the case with the 2nd entry.  All .lbl files starting with]
[ 'stn3' will be available to be viewed.  You must use the /a  ]
[ command line option with a saved map if you are going to view]
[ images.                                                      ]


*




   Low-Sulfide_Au = OFF  d:\prico\pr_36a.loc 3.0  0.0 white
        .....*.....
        .....*.....
        ....*.*....
        ....*.*....
        ...*...*...
        ...*...*...
        ..*.....*..
        ..*.....*..
        .*.......*.
        .*********.
        ...........
end_names
[ You can have up to 25 of these icons.  This is a white       ]
[ triangel.  The field must contain 121 entries (11,11).       ]
[ Periods are ignored and * are plotted on the map.  The icon  ]
[ is centere over its center point (6,6) of [5][5] in c.       ]


*

   faults = 3 ON
       eastf   10.0 0.0 black
       centf   10.0 0.0 black
       westf   10.0 0.0 black
    roads = 1 OFF
       road   100.0 0.0 green
  streams = 1 OFF
       stream 100.0 0.0 blue

end_vector

[  More vectors and an 'end_vector' statement                  ]











*
#