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] oouutt--
       ppuutt==_n_a_m_e

DDEESSCCRRIIPPTTIIOONN
       _p_s_._m_a_p produces an output  file	containing  a  PostScript
       program	to produce 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 com-
       mand-line mode requires the user to prepare a file of map-
       ping instructions describing the various spatial and  tex-
       tual  information  to  be printed prior to running _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  instruc-
	      tions 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 iden-
       tical 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 nor-
       mally prepared in a regular text file using a system  edi-
       tor.  Some instructions are single line instructions while
       others are multiple line. Multiple line instructions  con-
       sist  of  the main instruction followed by a subsection of
       one or more additional instructions.


       Instructions that may be included in the subsection  under
       several different main instructions are:

       wwhheerree _x _y
	      The top left corner of the bounding box of the item
	      to be plotted 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  loca-
	      tion 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
	    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 category 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, start-
       ing  at the left margin.  The default text color is black.
       Omitting the ccoolloorrttaabbllee instruction  would  result  in  no
       color  table.  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!!!!!


       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  starting 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 per-
       taining to the raster map layer _v_e_g_e_t_a_t_i_o_n, such as  "This
       map was created by classifying 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 out-
       put 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  instruc-
       tion line by giving either the map coordinates or by using
       percentages of  the  geographic	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 clockwise, 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  multi-
       ple _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 coor-
       dinate 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  con-
       tain  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 loca-
       tion, 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  indi-
       cate 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 geo-
       graphic region.	The user may  also  specify  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  pix-
       els 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
       instructions.



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, start-
       ing 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 necessary, 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  pro-
       gram  accepts  decimal points [floating 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  percent-
       ages  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 pattern in the icon file (default is 1.0,  aprroxi-
       mately  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 charac-
       ter 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 instructions.



ppssffiillee
       Copies a file containing PostScript commands into the out-
       put 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 pre-
       viously 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  percentages	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 sepa-
       rate 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 geographic 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
	      _(_a_t _t_h_e _p_r_e_s_e_n_t _t_i_m_e_, _o_n_l_y _1 _p_a_n_e_l _i_s _s_u_p_p_o_r_t_e_d_)_;

	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 sec-
       tion on NAMED COLORS below); the iiccoonn to be used to repre-
       sent  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 windmills (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  pro-
       viding  map  coordinates  or percentages of the geographic
       region map.  The text follows  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 italicc  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  high-
       light color (hhwwiiddtthh);


       the text-enclosing-box bbaacckkggrroouunndd color; the text box bboorr--
       ddeerr 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  shift-
       ing the text a vertical distance in pixels from the speci-
       fied north.  The vertical offset will shift  the  location
       to the south if positive, north if negative;


       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  coordinates  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 background enclosed in a
       red box, and be 500 meters in size.  The lower right  cor-
       ner  of	the  text  would be centered over the coordinates
       provided.  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
	    eenndd

       The user can specify:


       ccoolloorr - color of the vector lines or area boundaries;


       aaccoolloorr - the area color. If acolor is used areas are plot-
       ted instead of lines (accepts 3 integers from 0 to 255 for
       red, green and blue separated by spaces);


       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 offset 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.




       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 plot-
       ted.  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  con-
       taining	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_2_/_0_1_/_2_5 _0_5_:_4_5_:_3_4 _$



GRASS 5.0						ps.map(1)
