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 cate-
       gory 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 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, 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 spa-
       ces 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 coor-
       dinates 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 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)
