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 northing, and (optionally) speci-
	      fies 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	place-
	      ment 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 avail-
	      able:


       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 reg-
	      ular 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  per-
	      missible 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 highlight 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 unspecified 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  background.   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 per-
	      missible color names.)

       OOPPAAQQUUEE TTOO VVEECCTTOORRSS:
	      _y_e_s_|_n_o.	This  field  only has meaning if a background color is
	      selected.  _y_e_s will prevent vector lines from entering the back-
	      ground.	_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)
