p.labels(1)	       Grass User's Manual	      p.labels(1)



NNAAMMEE
       pp..llaabbeellss  - Create labels for hardcopy maps.
       _(_G_R_A_S_S _H_a_r_d_c_o_p_y _O_u_t_p_u_t _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       pp..llaabbeellss

DDEESSCCRRIIPPTTIIOONN
       This  module  allows  the  user to create or modify labels
       files.  These  labels  files,  which  are  stored  in  the
       database,  define text information for printing with _p_._m_a_p
       and for graphics display with _d_._p_a_i_n_t_._l_a_b_e_l_s.  Each  label
       has  components	which determine the text, the location of
       the text on the image, its size, and  the  background  for
       the text.


       The interface is a screen-oriented input/edit layout. Each
       label is entered with a single screen.  After  filling  in
       the  required information (described below), the user hits
       to accept the label and start a new one.  After	the  last
       label  has been accepted, the user then hists the one more
       time (on an empty label screen) to  exit  the  module  and
       save the labels.



SSCCRREEEENN LLAAYYOOUUTT
       The screen layout for the labels looks like this:

       ----------------------------------------------------------------------
       PAINT   LABELS:	  labelfile		    new    labels
       [1]

       TEXT:	_________________________________________________
       SKIP: no__
	     _________________________________________________
	     _________________________________________________
	     _________________________________________________


       LOCATION:  EAST: ___________________  OFFSET: _________
		 NORTH: ___________________  OFFSET: _________
	     PLACEMENT: center_____________

       FONT:		  standard___________
       TEXT SIZE:	  500______
       TEXT COLOR:	  black______________  WIDTH: 1________
       HIGHLIGHT COLOR:   none_______________  WIDTH: 0________

       BACKGROUND COLOR:  white______________
       BORDER COLOR:	  black______________
       OPAQUE TO VECTORS: yes______

		     AFTER COMPLETING ALL ANSWERS, HIT	<ESC>  TO
       CONTINUE
				   (OR <Ctrl-C> TO CANCEL)
       ----------------------------------------------------------------------

       The label information that must be provided is:

       TTEEXXTT:  Up to four lines of text.  Lines in  multiple  line
	      labels will appear one above the next.

       SSKKIIPP:  yes|no.  If _n_o, label will be printed.  If _y_e_s, the
	      label will be retained in the file but not printed.

       LLOOCCAATTIIOONN:
	      Determines  where  the  text will be located on the
	      image.  The user specifies  the  easting	and  nor-
	      thing,  and  (optionally)  specifies a vertical and
	      horizontal offset  (in  printer  pixels)	from  the
	      specified  easting/northing.  (The  vertical offset
	      will shift the location to the south  if	positive,
	      north if negative. The horizontal offset will shift
	      the location east if positive, west  if  negative.)
	      These offsets are provided to allow finer placement
	      of labels.

       PPLLAACCEEMMEENNTT:
	      Determines which part of the  label  to  which  the
	      location	refers.  If placement is unspecified, the
	      label is	centered  (_c_e_n_t_e_r),  by  default.   Label
	      placement may be specified as:

		   lower left	  (lower left corner of the text)
		   lower  right    (lower  right  corner  of  the
	      text)
		   lower center   (bottom center of the text)

		   upper left	  (upper left corner of the text)
		   upper  right    (upper  right  corner  of  the
	      text)
		   upper center   (top center of the text)

		   center    (center of the text)


       FFOONNTT:  This specifies the font to use. The following fonts
	      are available:


       cyrilc  gothgbt	gothgrt  gothitt  greekc  greekcs  greekp
       greeks  italicc	italiccs  italict  romanc  romancs romand
       romans romant scriptc scripts


       The word _s_t_a_n_d_a_r_d can be used to specify the default  font
       (which is _r_o_m_a_n_s).

       TTEEXXTT SSIIZZEE:
	      This  determines	the size of the letters. The size
	      specifies the vertical height  of  the  letters  in
	      meters on the ground. Thus text will grow or shrink
	      depending on the scale at which the map  is  drawn.
	      The  default  text  size,  if none is specified, is
	      _5_0_0.

       TTEEXXTT CCOOLLOORR:
	      This selects the text color.  If	unspecified,  the
	      label's  text  is  drawn in _b_l_a_c_k, by default.  The
	      text color can be specified in one of four ways:

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

	      As  red,	green, blue percentages.  for example: .5
	      .4 .7
	      (This form is not supported by _d_._p_a_i_n_t_._l_a_b_e_l_s.)

	      By printer color number to get  the  exact  printer
	      color.
	      (This form is not supported by _d_._p_a_i_n_t_._l_a_b_e_l_s.)

	      Specify _n_o_n_e to suppress the lettering.


       WWIIDDTTHH: This  determines the line thickness of the letters.
	      The normal text width should be set to  1.   Larger
	      numbers	can   be  used	to  simulate  bold  face.
	      (_d_._p_a_i_n_t_._l_a_b_e_l_s ignores this value and always  uses
	      1.   _1 is also the default width to which the width
	      is set by _p_a_i_n_t, if none is specified by the user.)

       HHIIGGHHLLIIGGHHTT CCOOLLOORR:
	      The  text  can  be  highlighted in another color so
	      that it appears to be in two colors.  The  text  is
	      drawn  first  in	this color at a wider line width,
	      and then redrawn in the text color at  the  regular
	      line  width.  No highlight color (_n_o_n_e) is used, by
	      default, if unspecified by the  user.   To  specify
	      use of no highlight color, specify _n_o_n_e.	(See TEXT
	      COLOR above for a list of permissible color names.)

       HHIIGGHHLLIIGGHHTT WWIIDDTTHH:
	      Specifies  how far from the text lines (in units of
	      pixels) the highlight  color  should  extend.   The
	      default highlight width is set to _0 (i.e., no high-
	      light color).

       BBAACCKKGGRROOUUNNDD CCOOLLOORR:
	      Text may be boxed in a solid color by specifying	a
	      background  color.  Specify _n_o_n_e for no background.
	      The default background color setting,  if  unspeci-
	      fied  by the user, is _w_h_i_t_e.  (See TEXT COLOR above
	      for a list of permissible color names.)

       BBOORRDDEERR CCOOLLOORR:
	      Select a color for  the  border  around  the  back-
	      ground.	Specify _n_o_n_e to suppress the border.  The
	      default  border  color  used,  if  unspecified,  is
	      _b_l_a_c_k.  (See TEXT COLOR above for a list of permis-
	      sible color names.)

       OOPPAAQQUUEE TTOO VVEECCTTOORRSS:
	      _y_e_s_|_n_o.  This field only has  meaning  if  a  back-
	      ground  color is selected.  _y_e_s will prevent vector
	      lines from entering the background.  _n_o will  allow
	      vector  lines to enter the background.  The default
	      setting, if unspecified by the user, is _y_e_s.


SSEEEE AALLSSOO
       _p_._m_a_p

       _p_._s_e_l_e_c_t

       _p_._i_c_o_n_s

       _d_._p_a_i_n_t_._l_a_b_e_l_s

AAUUTTHHOORR
       Michael	 Shapiro,   U.S.Army   Construction   Engineering
       Research Laboratory

       _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_3 _$



GRASS 5.0					      p.labels(1)
