ps.map(1)		      Grass User's Manual		     ps.map(1)



NNAAMMEE
       ppss..mmaapp  - Hardcopy PostScript map output utility.
       _(_G_R_A_S_S _H_a_r_d_c_o_p_y _P_o_s_t_S_c_r_i_p_t _O_u_t_p_u_t _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       ppss..mmaapp
       ppss..mmaapp hheellpp
       ppss..mmaapp [--rr] [iinnppuutt==_n_a_m_e] [ssccaallee==_m_a_p_s_c_a_l_e] [ccooppiieess==_n] oouuttppuutt==_n_a_m_e

DDEESSCCRRIIPPTTIIOONN
       _p_s_._m_a_p  produces an output file containing a PostScript program to pro-
       duce hardcopy map products on your system's PostScript  output  device.
       Output  can  include  a raster map, any number of vector overlays, site
       data, text labels, and other spatial data.


       This program has 2 distincts modes of operation.  The command-line mode
       requires  the user to prepare a file of mapping instructions describing
       the various spatial and textual information to be printed prior to run-
       ning  _p_s_._m_a_p.   The  interactive mode (i.e., no command-line arguments)
       will prompt the user for items to be mapped and does  not  require  the
       user  to  prepare  a file of instructions (some options are not used in
       interactive mode).


       The command line flag is:

       --rr     Rotate plot 90 degrees.




       The command-line parameters are:

       iinnppuutt==_n_a_m_e
	      File containing mapping  instructions.   (or  enter  iinnppuutt==--  to
	      enter  from  keyboard).	These  instructions  are  described in
	      detail below.

       ssccaallee==_m_a_p_s_c_a_l_e
	      Scale of the output map,	e.g. 1:25000
	      Default:	1 panel


       This parameter is provided as a convenience.  It is  identical  to  the
       _s_c_a_l_e mapping instruction described below.

       oouuttppuutt==_n_a_m_e
	      Name of output the file to contain the PostScript program.




       Note:  the  user must select a PostScript output device using _p_s_._s_e_l_e_c_t
       before running _p_s_._m_a_p.



MMAAPPPPIINNGG IINNSSTTRRUUCCTTIIOONNSS
       The mapping instructions allow the user to specify various spatial data
       to  be  plotted.  These instructions are normally prepared in a regular
       text file using a system editor.  Some  instructions  are  single  line
       instructions while others are multiple line. Multiple line instructions
       consist of the main instruction followed by a subsection of one or more
       additional instructions.


       Instructions  that may be included in the subsection under several dif-
       ferent main instructions are:

       wwhheerree _x _y
	      The top left corner of the bounding box of the item to be  plot-
	      ted  is  located	_x inches from the left edge of the paper and _y
	      inches from the top edge of the paper. If  _x  is	less  than  or
	      equal to zero, the default horizontal location is used.  If _y is
	      less than or equal to zero, the  default	vertical  location  is
	      used.

       ffoonntt _f_o_n_t _n_a_m_e
	      The name of the PostScript font.	The default is _H_e_l_v_e_t_i_c_a.

       ffoonnttssiizzee _f_o_n_t _s_i_z_e
	      The  size  of  the PostScript font in 1/72 inch.	The default is
	      10.



ccoolloorrttaabbllee
       Prints the color table for the raster map layer anywhere on the page.
       USAGE:	 ccoolloorrttaabbllee [y|n]
	    wwhheerree x y
	    wwiiddtthh table width
	    hheeiigghhtt table height (FP legend only)
	    ccoollss table columns
	    ffoonntt font name
	    ffoonnttssiizzee font size
	    ccoolloorr text color
	    nnooddaattaa [y|n]
	    eenndd
	The color table will display the colors for each raster map layer cat-
       egory  value  and  the  category label.	To get a color table, you must
       have previously requested a raster map layer.  The default location for
       the  colortable	is immediately below any other map legend information,
       starting at the left margin.  The default text color is	black.	 Omit-
       ting  the  ccoolloorrttaabbllee  instruction  would result in no color table. For
       floating point legends wwiiddtthh is width of color  band  only.  hheeiigghhtt  is
       used only for floating point legend.


       NNoottee:   Be  careful about asking for color tables for raster map layers
       which have many categories, such as elevation.  This  could  result  in
       the printing of an extremely long color table!!!!!


       Another	issue  is  that the color table only includes categories which
       have a label. If there are only a few categories, you can use r.support
       to  manually  add  labels. If there are too many categories to do this,
       you could write a script to add dummy labels to the cats file

       (//<;mapset>;/cats/<;mapname>;).


       This example would print a color table immediately below any other  map
       legend information, starting at the left margin.
       EXAMPLE:
	    ccoolloorrttaabbllee y




ccoommmmeennttss
       Prints comments anywhere on the page.
       USAGE:	 ccoommmmeennttss commentfile
	    wwhheerree x y
	    ffoonntt font name
	    ffoonnttssiizzee font size
	    ccoolloorr text color
	    eenndd
	 The default location is immediately below the last item item printed,
       starting at the left margin.  The default text color is black.


       This example prints in blue whatever is in the file _v_e_g_._c_o_m_m_e_n_t_s start-
       ing  at	1.5 inches from the left edge of the page and 7.25 inches from
       the top of the page, using a 15/72 inch Helvetica Bold font.
       EXAMPLE:
	    rraasstteerr vegetation
	    ccoommmmeennttss veg.comments
	    wwhheerree 1.5 7.25
	    ffoonntt Helvetica Bold
	    ffoonnttssiizzee 15
	    ccoolloorr blue
	    eenndd
	Presumably, the file _v_e_g_._c_o_m_m_e_n_t_s contain comments pertaining  to  the
       raster map layer _v_e_g_e_t_a_t_i_o_n, such as "This map was created by classify-
       ing a LANDSAT TM image".



ccooppiieess
       Specifies the number of copies to be printed.
       USAGE:	 ccooppiieess n
	Each page will be printed n times.



eeppss
       Places EPS (Encapsulated PostScript) pictures on the output map.
       USAGE:	 eeppss east north
	    eeppss x% y%
	    eeppssffiillee EPS file
	    ssccaallee #
	    rroottaattee #
	    mmaasskkeedd [y|n]
	    eenndd
	The EPS picture location is entered in the main  instruction  line  by
       giving  either  the map coordinates or by using percentages of the geo-
       graphic region.	The user must specify full EPS file path eeppssffiillee.  The
       user  may  also	specify  the  ssccaallee  of the icon (default is 1.0), the
       rroottaattee i.e. rotation in degrees (default is 0) and whether the point is
       to be mmaasskkeedd by the current mask. (See manual entry for _r_._m_a_s_k
	for more information on the mask.)


       This  example  would  place  a  EPS  file  ./epsf/logo.eps at the point
       (E456000 N7890000).  This picture would be rotated  20  degrees	clock-
       wise,  3  times bigger than in original file and would not be masked by
       the current mask.
       EXAMPLE:
	    eeppss 456000 7890000
	    eeppssffiillee ./epsf/logo.eps
	    ssccaallee 3
	    rroottaattee 20
	    mmaasskkeedd n
	    eenndd
	Of course, multiple EPS  pictures  may	be  drawn  with  multiple  _e_p_s
       instructions.



ggrreeyyrraasstt
       Selects a raster map layer for output in shades of grey.
       USAGE:	 ggrreeyyrraasstt mapname|_l_i_s_t
	For each _p_s_._m_a_p run, only one raster map layer can be requested (using
       either the _g_r_e_y_r_a_s_t or the _r_a_s_t_e_r instruction).



ggrriidd
       Overlays a coordinate grid onto the output map.
       USAGE:	 ggrriidd spacing
	    ccoolloorr color
	    nnuummbbeerrss # [color]
	    ffoonntt font name
	    ffoonnttssiizzee font size
	    eenndd
	The ssppaacciinngg of the grid is given (in the geographic coordinate	system
       units) on the main instruction line.  The subsection instructions allow
       the user to specify the ccoolloorr of the  grid  lines,  whether  coordinate
       nnuummbbeerrss	should	appear	on  the  grid lines, and if they should appear
       every grid line (1), every other grid line (2), etc.,  and  what  color
       the  numbers should be.	The defaults are black grid lines, unnumbered.


       This example would overlay a green grid with a spacing of 10000	meters
       (for a metered database, like UTM) onto the output map.	Alternate grid
       lines would be numbered with red numbers.
       EXAMPLE:
	    ggrriidd 10000
	    ccoolloorr green
	    nnuummbbeerrss 2 red
	    eenndd




ggrroouupp
       Selects an RGB imagery group for output.
       USAGE:	 ggrroouupp _g_r_o_u_p_n_a_m_e
	This is similar to _r_a_s_t_e_r,  except  that  it  uses  an	imagery  group
       instead	of a raster map layer. The group must contain three raster map
       layers, comprising the red, green and blue bands of the image.



hheeaaddeerr
       Prints the map header above the map.
       USAGE:	 hheeaaddeerr
	    ffiillee header file
	    ffoonntt font name
	    ffoonnttssiizzee font size
	    ccoolloorr text color
	    eenndd
	If the _h_e_a_d_e_r instruction or the _f_i_l_e sub-instruction is  absent,  the
       header will consist of the map TITLE and location, each centered on the
       page above the map.  The default text color is black.


       This example prints (in red) whatever is in the	file  _s_o_i_l_s_._h_d_r  above
       the map, using a 20/72 inch Courier font.
       EXAMPLE:
	    hheeaaddeerr
	    ffiillee soils.hdr
	    ffoonntt Courier
	    ffoonnttssiizzee 20
	    ccoolloorr red
	    eenndd




llaabbeellss
       Selects a labels file for output (see manual entry for _p_._l_a_b_e_l_s _)_.
       USAGE:	 llaabbeellss  labelfile|_l_i_s_t
	    ffoonntt font name
	    eenndd



       NOTE:  ps.map  can  read  new  option 'ROTATE:' from labels file, which
       specifies counter clockwise rotation in degrees.


       This example would paint labels from the labels file called _t_o_w_n_._n_a_m_e_s.
       Presumably,  these labels would indicate the names of towns on the map.
       EXAMPLE:
	    llaabbeellss town.names




lliinnee
       Draws lines on the output map.
       USAGE:	 lliinnee east north east north
	    lliinnee x% y% x% y%
	    ccoolloorr color
	    wwiiddtthh #
	    mmaasskkeedd [y|n]
	    eenndd
	The beginning and ending points of the line are entered  on  the  main
       instruction.   These points can be defined either by map coordinates or
       by using percentages of the geographic region.  The user may also spec-
       ify  line  ccoolloorr,  wwiiddtthh  in  pixels  (accepts decimal points [floating
       points] as well as integers), and if the line is to be  mmaasskkeedd  by  the
       current mask. (See manual entry for _r_._m_a_s_k
	for more information on the mask.)


       This example would draw a yellow line from the point x=10% y=80% to the
       point x=30% y=70%. This line would be 2 pixels wide  and  would	appear
       even if there is a mask.
       EXAMPLE:
	    lliinnee 10% 80% 30% 70%
	    ccoolloorr yellow
	    wwiiddtthh 2
	    mmaasskkeedd n
	    eenndd
	 Of  course,  multiple	lines may be drawn with multiple _l_i_n_e instruc-
       tions.



mmaappiinnffoo
       Prints the portion of the map legend containing	the  scale,  grid  and
       region information, on or below the map.
       USAGE:	 mmaappiinnffoo
	    wwhheerree x y
	    ffoonntt font name
	    ffoonnttssiizzee font size
	    ccoolloorr text color
	    eenndd
	 The  default  location  is immediately below the map, starting at the
       left edge of the map.  The default text color is black.


       This example prints (in brown) the scale, grid and  region  information
       immediately below the map and starting 1.5 inches from the left edge of
       the page, using a 12/72 inch Courier font.
       EXAMPLE:
	    mmaappiinnffoo
	    wwhheerree 1.5 0
	    ffoonntt Courier
	    ffoonnttssiizzee 12
	    ccoolloorr brown
	    eenndd




mmaapplloocc
       Positions the map on the page.
       USAGE:	 mmaapplloocc  x y [width height]
	The upper left corner of the map will be positioned _x inches from  the
       left  edge of the page and _y inches from the top of the page.  If _w_i_d_t_h
       and _h_e_i_g_h_t (in inches) are present, the map will be rescaled, if neces-
       sary, to fit.


       This example positions the upper left corner of the map 2.0 inches from
       the left edge and 3.5 inches from the top edge of the map.
       EXAMPLE:
	    mmaapplloocc 2.0 3.5




oouuttlliinnee
       Outlines the areas of a raster map layer with a specified color.
       USAGE:	 oouuttlliinnee
	    ccoolloorr  color
	    wwiiddtthh  width of line in pixels
	    eenndd
	Distinct areas of the raster map will be  separated  from  each  other
       visually  by  drawing  a  border  (or  outline)	in the specified ccoolloorr
       (default: black). For wwiiddtthh the program accepts decimal points  [float-
       ing  points] as well as integers.  Note: it is important the user enter
       the instruction eenndd even if a color is not chosen.  (It is  hoped  that
       in  the	future	the outline of a different raster map layer other than
       the one currently being painted may be placed on the map.)


       This example would outline the category areas of the _s_o_i_l_s  raster  map
       layer in grey.
       EXAMPLE:
	    rraasstteerr soils
	    oouuttlliinnee
	    ccoolloorr grey
	    wwiiddtthh 2
	    eenndd




ppooiinntt
       Places additional points or icons on the output map.
       USAGE:	 ppooiinntt east north
	    ppooiinntt x% y%
	    ccoolloorr color
	    iiccoonn iconfile|_l_i_s_t
	    ssiizzee #
	    mmaasskkeedd [y|n]
	    eenndd
	 The  point location is entered in the main instruction line by giving
       either the map coordinates or by using percentages  of  the  geographic
       region.	The user may also specify the point ccoolloorr, the iiccoonn file to be
       used to represent the point location (see  the  the  manual  entry  for
       _p_s_._i_c_o_n	_s_), the ssiizzee of the icon as a multiple of the size of the pat-
       tern in the icon file (default is 1.0, aprroximately equivalent to a 10
       point  character), and whether the point is to be mmaasskkeedd by the current
       mask. (See manual entry for _r_._m_a_s_k
	for more information on the mask.)


       This example would place a purple diamond (from icon file  _d_i_a_m_o_n_d)  at
       the  point (E456000 N7890000).  This diamond would be the approximately
       the size of a 15 point character and would not be masked by the current
       mask.
       EXAMPLE:
	    ppooiinntt 456000 7890000
	    ccoolloorr purple
	    iiccoonn diamond
	    ssiizzee 1.5
	    mmaasskkeedd n
	    eenndd
	 Of  course, multiple points may be drawn with multiple _p_o_i_n_t instruc-
       tions.



ppssffiillee
       Copies a file containing PostScript commands into the output file.


       NNoottee:: _p_s_._m_a_p will not search for this file.  The user must  be  in  the
       correct	directory  or specify the full path on the ppssffiillee instruction.
       (Note to /bin/csh users: ~ won't work with this instruction).
       USAGE:	 ppssffiillee filename
	This example copies the file "logo.ps" into the output file.
       EXAMPLE:
	    ppssffiillee logo.ps




rraasstteerr
       Selects a raster map layer for output.
       USAGE:	 rraasstteerr mapname|_l_i_s_t
	For each _p_s_._m_a_p run, only one raster map layer (or set	of  layers  or
       imagery	group;	see below) can be requested. If no raster map layer is
       requested, a completely white map will be produced. It can be useful to
       select  no  raster map layer in order to provide a white background for
       vector images.


       Note that an imagery group selected with the _g_r_o_u_p option, or a set  of
       three raster layers selected with the _r_g_b option, count as a raster map
       layer for the purposes of the preceding paragraph.


       This example would paint a map of the raster map layer _s_o_i_l_s.
       EXAMPLE:
	    rraasstteerr soils




rreeaadd
       Provides _p_s_._m_a_p with a previously prepared input stream.
       USAGE:	 rreeaadd previously prepared UNIX file
	Mapping instructions can be placed into a file and read into _p_s_._m_a_p_.


       NNoottee:: _p_s_._m_a_p will not search for this file.  The user must  be  in  the
       correct	directory  or  specify	the full path on the rreeaadd instruction.
       (Note to /bin/csh users: ~ won't work with this instruction).


       This example reads the UNIX file _p_m_a_p_._r_o_a_d_s into _p_s_._m_a_p.  This file may
       contain	all  the  _p_s_._m_a_p instructions for placing the vector map layer
       _r_o_a_d_s onto the output map.
       EXAMPLE:
	    rreeaadd pmap.roads
	The user may have created this file because this vector map  layer  is
       particularly useful for many _p_s_._m_a_p outputs.  By using the rreeaadd option,
       the user need not enter all the input for the vveeccttoorr  instruction,  but
       simply rreeaadd the previously prepared file with the correct instructions.



rreeccttaannggllee
       Draws rectangle on the output map.
       USAGE:	 rreeccttaannggllee east north east north
	    rreeccttaannggllee x% y% x% y%
	    ccoolloorr color
	    ffccoolloorr fill color
	    wwiiddtthh #
	    mmaasskkeedd [y|n]
	    eenndd
	The two corners of the rectangle are entered on the main  instruction.
       These  points can be defined either by map coordinates or by using per-
       centages of the geographic region.  The	user  may  also  specify  line
       ccoolloorr,  fill  color  ffccoolloorr,  wwiiddtthh  in	pixels (accepts decimal points
       [floating points] as well as integers), and if the rectangle is	to  be
       mmaasskkeedd by the current mask. (See manual entry for _r_._m_a_s_k
	for more information on the mask.)


       This  example  would  draw  a yellow rectangle filled by green from the
       point x=10% y=80% to the point x=30% y=70%. This line would be 2 pixels
       wide and would appear even if there is a mask.
       EXAMPLE:
	    rreeccttaannggllee 10% 80% 30% 70%
	    ccoolloorr yellow
	    ffccoolloorr green
	    wwiiddtthh 2
	    mmaasskkeedd n
	    eenndd
	 Of  course,  multiple rectangles may be drawn with multiple _r_e_c_t_a_n_g_l_e
       instructions.



rreeggiioonn
       Places the outline of a smaller geographic region on the output.
       USAGE:	 rreeggiioonn regionfile|_l_i_s_t
	    ccoolloorr color
	    wwiiddtthh #
	    eenndd
	Geographic region settings are created and saved using _g_._r_e_g_i_o_n .  The
       _p_s_._m_a_p _r_e_g_i_o_n option can be used to show an outline of a smaller region
       which was printed on a separate run of  _p_s_._m_a_p  on  other  user-created
       maps.


       The  user  can  specify the ccoolloorr and the wwiiddtthh in pixel units (accepts
       decimal points [floating points] as well as integers) of  the  outline.
       The default is a black border of one pixel width.


       This  example  would  place a white outline, 2 pixels wide, of the geo-
       graphic region called _f_i_r_e_._z_o_n_e_s onto the output map.  This  geographic
       region would have been created and saved using _g_._r_e_g_i_o_n .
       EXAMPLE:
	    rreeggiioonn fire.zones
	    ccoolloorr white
	    wwiiddtthh 2
	    eenndd




rrggbb
       Selects three raster map layers for output as an RGB color image.
       USAGE:	 rrggbb _r_e_d _g_r_e_e_n _b_l_u_e
	This is similar to _r_a_s_t_e_r, except that it uses three raster map layers
       instead of a single layer. The three layers  are  composed  to  form  a
       color image, similar to _d_._r_g_b.


       For  each  layer, only one of the components of the layer's color table
       is used: the red component for the red layer, and  so  on.   This  will
       give  the  desired  result if all of the layers have a grey-scale color
       table, or if each layer's color table uses the hue appropriate  to  the
       layer.



ssccaallee
       Selects a scale for the output map.
       USAGE:	 ssccaallee _s_c_a_l_e
	The scale can be selected either as:

	a relative ratio, e.g. 1:25000;

	an absolute width of the printed map, e.g. 10 inches;

	the number of printed paper panels, e.g. 3 panels
	      _._I (at the present time, only 1 panel is supported);

	the number of miles per inch, e.g. 1 inch equals 4 miles.


       This example would set the scale of the map to 1 unit = 25000 units.
       EXAMPLE:
	    ssccaallee 1:25000




sseettccoolloorr
       Overrides  the  color  assigned to one or more categories of the raster
       map layer.
       USAGE:	 sseettccoolloorr cat(s) color
	This example would set the color for  categories  2,5  and  8  of  the
       raster  map layer _w_a_t_e_r_s_h_e_d_s to white and category 10 to green.	(NNOOTTEE:
       no spaces are inserted between the category values.)
       EXAMPLE:
	    rraasstteerr watersheds
	    sseettccoolloorr 2,5,8 white
	    sseettccoolloorr 10 green
	Of course, _s_e_t_c_o_l_o_r can be requested more than once  to  override  the
       default color for additional categories.  More than one category can be
       changed for each request by listing all the category  values  separated
       by commas (but with no spaces).



ssiitteess
       Selects sites data to be placed on the output map (see manual entry for
       _s_._m_e_n_u ).
       USAGE:	 ssiitteess sitemap|_l_i_s_t
	    ccoolloorr color
	    iiccoonn iconfile|_l_i_s_t
	    eeppss epsfile
	    ssiizzee #
	    ssiizzee__aatttt #
	    rroottaattee #
	    ddeesscc [y|n]
	    ffoonntt font name
	    eenndd
	The user may specify the the ccoolloorr of the sites (see section on  NAMED
       COLORS  below); the iiccoonn to be used to represent the presence of a site
       (see the manual entry for _p_._i_c_o_n_s );  the  eeppss  Encapsulate  Postscript
       file  to  be  used to represent the presence of a site; If $$ is used in
       EPS file path it is replaced by category number.  the ssiizzee of the  icon
       (number	of  times  larger  than  the size it is in the icon file); the
       ssiizzee__aatttt number of attribute used for size (if used size  is  equal  to
       size  *	attribute_value); the rroottaattee in degrees for clockwise rotation
       for EPS files; and whether or not the ddeessccription associated with  each
       site  is  also to be printed.  If the ddeessccription is to be printed, the
       ffoonntt name may be specified.  The size of the font  is  proportional  to
       the  icon  ssiizzee.   This example would paint a sites map with blue wind-
       mills (from an icon file created by the user using  the	_p_._i_c_o_n_s  GRASS
       command)  placed  at all windmill locations (from a sites list).  These
       windmills would be two times larger than the size of the  icon  in  the
       icon file and have descriptions from the sites list file printed beside
       them.
       EXAMPLE:
	    ssiitteess windmills
	    ccoolloorr blue
	    iiccoonn windmill
	    ssiizzee 2
	    ddeesscc y
	    eenndd




tteexxtt
       Places text on the map.
       USAGE:	 tteexxtt  east north text
	    tteexxtt  x% y% text
	    ffoonntt fontname
	    ccoolloorr color|none
	    wwiiddtthh #
	    hhccoolloorr color|none
	    hhwwiiddtthh #
	    bbaacckkggrroouunndd color|none
	    bboorrddeerr color|none
	    ssiizzee #
	    rreeff reference point
	    xxooffffsseett #
	    yyooffffsseett #
	    ooppaaqquuee [y|n]
	    eenndd
	The user specifies where the text will	be  placed  by	providing  map
       coordinates or percentages of the geographic region map.  The text fol-
       lows these coordinates on the same instruction  line.   More  than  one
       line  of  text  can be specified by notating the end of a line with 00ffRR
       ((ee..gg.. UUSSAA00EERRLL))..


       The user can then specify various text features:


       ffoonntt:: cyrilc gothgbt gothgrt gothitt greekc greekcs greekp greeks ital-
       icc  italiccs  italict  romanc  romancs	romand	romans	romant scriptc
       scripts (The default font is romans);


       ccoolloorr (see NAMED COLORS);


       wwiiddtthh of the lines used to  draw  the  text  to	make  thicker  letters
       (accepts decimal points [floating points] as well as integers);


       ssiizzee  as  the  vertical	height	of the letters in meters on the ground
       (text size will grow or shrink depending on the scale at which the  map
       is painted);


       the  highlight  color  (hhccoolloorr)	and  the  width of the highlight color
       (hhwwiiddtthh);


       the text-enclosing-box bbaacckkggrroouunndd color; the text box bboorrddeerr color;


       rreeff..  This reference point specifies the text handle - what part of the
       text should be placed on the location specified by the map coordinates.
       Reference points can refer to: [lower|upper|center] [left|right|center]
       of the text to be printed;


       yyooffffsseett,  which provides finer placement of text by shifting the text a
       vertical distance in pixels from the  specified	north.	 The  vertical
       offset will shift the location to the south if positive, north if nega-
       tive;


       xxooffffsseett, which shifts the text a horizontal distance in pixels from the
       specified  east	The  horizontal offset will shift the location east if
       positive, west if negative;


       whether or not the text should be ooppaaqquuee to vectors.   Entering	nnoo  to
       the  opaque  option  will  allow  the  user to see any vectors which go
       through the text's background box.  Otherwise, they  will  end  at  the
       box's edge.




       This  example  would place the text _S_P_E_A_R_F_I_S_H _L_A_N_D _C_O_V_E_R at the coordi-
       nates E650000 N7365000. The text would be a total of 3 pixels  wide  (2
       pixels  of  red	text  and 1 pixel black highlight), have a white back-
       ground enclosed in a red box, and be 500 meters	in  size.   The  lower
       right  corner  of  the text would be centered over the coordinates pro-
       vided.  All vectors on the map would stop at the border of this text.
       EXAMPLE:
	    tteexxtt 650000 7365000 SPEARFISH LAND COVER
	    ffoonntt romand
	    ccoolloorr red
	    wwiiddtthh 2
	    hhccoolloorr black
	    hhwwiiddtthh 1
	    bbaacckkggrroouunndd white
	    bboorrddeerr red
	    ssiizzee 500
	    rreeff lower left
	    ooppaaqquuee y
	    eenndd




vveeccttoorr
       Selects a vector map layer for output.
       USAGE:	 vveeccttoorr vectormap|_l_i_s_t
	    ccoolloorr color
	    aaccoolloorr r g b
	    wwiiddtthh #
	    ccwwiiddtthh #
	    hhccoolloorr color
	    hhwwiiddtthh #
	    ooffffsseett #
	    ccooffffsseett #
	    rreeff left|right
	    mmaasskkeedd [y|n]
	    ssttyyllee  0-9
	    lliinnee__ccaatt #
	    llaabbeell label
	    llppooss 0|1-20
	    ppaatt name
	    ppwwiiddtthh #
	    ssccaallee #0
	    eenndd
	The user can specify:


       ccoolloorr - color of the vector lines or area boundaries;


       aaccoolloorr - the area color. If acolor is used areas are plotted instead of
       lines  (accepts	3 integers from 0 to 255 for red, green and blue sepa-
       rated by spaces). This color is also used by pattern until  overwritten
       in pattern file;


       wwiiddtthh  -  width	of  the  vectors  lines  or  area boundaries in pixels
       (accepts decimal points [floating points] as well as integers);


       ccwwiiddtthh - width of the vectors lines. If cwidth is used  then  width  of
       line is equal to cwidth * category value and width is used in legend;


       hhccoolloorr - the highlight color for the vector lines;


       hhwwiiddtthh - the width of the highlight color in pixels;


       ooffffsseett  (experimental)  -  offset  for  the vectors lines in pixels for
       plotting parallel lines in distance equal to offset  (accepts  positive
       or negative decimal points);


       ccooffffsseett	(experimental)	-  offset for the vectors lines. If coffset is
       used then offset of line is equal to coffset * category value and  off-
       set is used in legend;


       rreeff (experimental) - line justification.


       mmaasskkeedd  -  whether  or  not the raster map layer is to be masked by the
       current mask (see manual entry _r_._m_a_s_k
	for more information on the mask);


       ssttyyllee - the line style allows the vectors to  be  dashed  in  different
       patterns.   This is done by typing a series of numbers (0's and 1's) in
       a desired sequence or pattern.  Blanks  and  non-digit  characters  are
       recognized  as  0's.  Using  0 would allow the colors of the raster map
       layer (or the background color if no raster map layer was selected)  to
       show through;


       lliinnee__ccaatt - which category should be plotted (default is all);


       llaabbeell - for description in vlegend. Default is: map(mapset);


       llppooss  -	position  vector  is plotted in legend. If lpos is 0 then this
       vector is omitted in legend. If more vectors used the  same  lpos  then
       their  symbols in legend are merged and label for first vector is used.


       ppaatt - full path to pattern file. Pattern file contains header and  sim-
       ple  PS	commands.   It	is similar to EPS but more limited, that means
       that each pattern file is EPS file but EPS files are not  usually  use-
       full  as  pattern  files because contain restricted commands. Color and
       width of patterns is set by aaccoolloorr and ppwwiiddtthh until it  is  overwritten
       in  pattern file. Currently the only way to create pattern file is text
       editor. Example of pattern file:
       %!PS-Adobe-2.0 EPSF-1.2
       %%BoundingBox: 0 0 10 10
       newpath
       5 0 moveto
       5 10 lineto
       stroke



       ssccaallee - pattern scale


       ppwwiiddtthh - pattern line width, width is used by pattern until  the  width
       is overwritten in pattern file.






       This  example  would paint a map of the vector map layer named _s_t_r_e_a_m_s.
       These streams would be a total of 3 pixels wide (the inner  two	pixels
       blue  and  the  outer  highlight  pixel white).	The map would not show
       streams outside of the current mask. Only streams of category 2 will be
       plotted.  In legend appeares label 'Streams - category 2'.
       EXAMPLE:
	    vveeccttoorr streams
	    ccoolloorr blue
	    wwiiddtthh 2
	    hhccoolloorr white
	    hhwwiiddtthh 1
	    mmaasskkeedd y
	    lliinnee__ccaatt 2
	    llaabbeell Streams - category 2
	    eenndd




vveerrbboossee
       Changes the amount of talking _p_s_._m_a_p will do.
       USAGE: vveerrbboossee [0|1|2]
	 A higher value implies more chatter.  The default is 2.  This example
       sets the amount of chatter to a minimum.
       EXAMPLE:
	    vveerrbboossee 0




vvlleeggeenndd
       Prints the portion of the map legend containing the vector information,
       on or below the map.
       USAGE:	 vvlleeggeenndd
	    wwhheerree x y
	    ffoonntt font name
	    ffoonnttssiizzee font size
	    eenndd
	 The  default  location is immediately below the legend containing the
       scale, grid and region information, starting at the left  edge  of  the
       map.   If  the _w_h_e_r_e instruction is present and _y is less than or equal
       to zero, the vector legend will be  positioned  immediately  below  the
       map, starting _x inches from the left edge of the page.


       This  example  prints  the  vector legend immediately below the map and
       starting 4.5 inches from the left edge of the page, using a 12/72  inch
       Helvetica font.
       EXAMPLE:
	    vvlleeggeenndd
	    wwhheerree 4.5 0
	    ffoonntt Courier
	    ffoonnttssiizzee 12
	    eenndd




eenndd
       Terminates input and begin painting the map.
       USAGE:	 eenndd




NNAAMMEEDD CCOOLLOORRSS
       The following are the colors that are accepted by _p_s_._m_a_p:

       aqua
       black
       blue
       brown
       cyan
       gray
       green
       grey
       indigo
       magenta
       orange
       purple
       red
       violet
       white
       yellow


EEXXAAMMPPLLEE ppss..mmaapp IINNPPUUTT FFIILLEE
       The  following is an example of a _p_s_._m_a_p script file. The file has been
       named _s_p_e_a_r_._s_o_i_l_s.  For the purposes of illustration, the  file	is  in
       two columns.  This script file can be entered at the command line:
	 ppss..mmaapp iinnppuutt==_s_p_e_a_r_._s_o_i_l_s oouuttppuutt==_s_o_i_l_s_._p_s


       rraasstteerr soils
       vveeccttoorr roads
	  wwiiddtthh 2
	  ssttyyllee 0011
	  ccoolloorr 1 black
	  ccoolloorr 2 red
	  mmaasskkeedd n
	  eenndd
       llaabbeellss town.names
       rreeggiioonn subregion
	  ccoolloorr white
	  wwiiddtthh 2
	  eenndd
       ggrriidd 10000
	  ccoolloorr green
	  nnuummbbeerrss 2 red
	  eenndd
       oouuttlliinnee
	  ccoolloorr black
	  eenndd
       ccoolloorrttaabbllee y
       ccoommmmeennttss soil.cmt
	  ffoonntt Helvetica
	  eenndd
       ssccaallee 1:25000
       sseettccoolloorr 6,8,9 white
       sseettccoolloorr 10 green
       vvlleeggeenndd
	   wwhheerree 4.5 0
	   eenndd
       tteexxtt 608000.00 3476004.73 SPEARFISH SOILS MAP
	   ccoolloorr red
	   wwiiddtthh 2
	   hhccoolloorr black
	   hhwwiiddtthh 1
	   bbaacckkggrroouunndd white
	   bboorrddeerr red
	   ssiizzee 500
	   rreeff lower left
	   ooppaaqquuee y
	   eenndd
       lliinnee 606969.73 3423092.91 616969.73 3423092.91
	   ccoolloorr yellow
	   wwiiddtthh 2
	   ooppaaqquuee yes
	   eenndd
       ppooiinntt 40% 60%
	   ccoolloorr purple
	   iiccoonn diamond
	   ssiizzee 2
	   mmaasskkeedd n
	   eenndd
       eenndd



IINNTTEERRAACCTTIIVVEE MMOODDEE
       If  the	user  simply  enters  _p_s_._m_a_p  without arguments, then a simple
       prompting session occurs.  Some, but not  all  of  the  non-interactive
       requests are available at this level.

NNOOTTEESS
       The  user  can  specify	negative  values  for position of EPS-files in
       ps.map to move them outside the current region (to position a  barscale
       or other legend entries).

SSEEEE AALLSSOO
	_p_s_._i_c_o_n

	_p_s_._s_e_l_e_c_t

AAUUTTHHOORR
       Paul Carlson, USDA, SCS, NHQ-CGIS

       Modifications: Radim Blazek, Glynn Clements

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_3_/_0_2_/_1_3 _2_0_:_1_7_:_3_2 _$



GRASS 5.0							     ps.map(1)
