d.label(1)	       Grass User's Manual	       d.label(1)



NNAAMMEE
       dd..llaabbeell	-  Creates and displays text labels in the active
       display frame on the graphics monitor.
       _(_G_R_A_S_S _D_i_s_p_l_a_y _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       dd..llaabbeell
       dd..llaabbeell hheellpp
       dd..llaabbeell	[ssiizzee==_v_a_l_u_e]  [bbaacckkccoolloorr==_n_a_m_e]	 [tteexxttccoolloorr==_n_a_m_e]
       [ffoonntt==_n_a_m_e]

DDEESSCCRRIIPPTTIIOONN
       _d_._l_a_b_e_l	allows the user to create and display text labels
       in the active frame on the graphics monitor.  It  interac-
       tively  requests  that  the  user type in text and use the
       pointing device (mouse) to identify where this text is  to
       be  placed  within  the active graphics frame. The program
       will prompt the user for  label	size,  background  color,
       text color, and text font type, if the user fails to spec-
       ify these values on the command line.  Program prompts use
       the standard GRASS parser interface.

   PPaarraammeetteerrss::
       ssiizzee==_v_a_l_u_e
	      Sets  the  label text size to the specified number.
	      Values are stated as  a  percentage  of  the  frame
	      height;  e.g.,  a size of 10 will make each line of
	      text equal to one-tenth the height of  the  display
	      frame.
	      Options: 0-1000
	      Default: 10

       bbaacckkccoolloorr==_n_a_m_e
	      Sets  the color of the label background to the _n_a_m_e
	      stated.
	      Options: red, orange, yellow, green, blue,  indigo,
	      violet, gray, white, and black.
	      Default: _b_l_a_c_k

       tteexxttccoolloorr==_n_a_m_e
	      Sets  the  color	of  the  label	text  to the _n_a_m_e
	      stated.
	      Options: same as for _b_a_c_k_c_o_l_o_r.
	      Default: _w_h_i_t_e

       ffoonntt==_n_a_m_e
	      Sets the font type used for  the	label's  text  to
	      _n_a_m_e.

	      Options:	romand,  romanp, romant, romans, scriptc,
	      scripts, romancs, italicc, italiccs, gothitt, goth-
	      grt,  and  gothgbt.  The user can view these avail-
	      able fonts by running _s_h_o_w_._f_o_n_t_s_._s_h.
	      Default: _r_o_m_a_n_s (Roman simplex font type), or what-
	      ever  font the user has set the font type to before
	      entering _d_._l_a_b_e_l.


NNOOTTEESS
       This program will allow the user to  display  labels  any-
       where  in  the  active  display frame, even in areas lying
       outside of the current geographic region.


       _d_._l_a_b_e_l will only allow the user to type in  one  line  of
       text.   The fully interactive program _d_._l_a_b_e_l_s can be used
       to create text labels having as many as four lines.


       _d_._l_a_b_e_l does not create paint labels files displayable  by
       _d_._p_a_i_n_t_._l_a_b_e_l_s -- _d_._l_a_b_e_l_s does.  These programs should be
       integrated in future GRASS releases.

BBUUGGSS
       If the user is running GRASS under X Windows, and the user
       enters  a  text	label  longer  than  80 characters (i.e.,
       allows text to wrap onto a second line),  X  Windows  will
       stop  the  user's  GRASS graphics monitor without throwing
       the user out of GRASS.  If this happens, the  user  should
       simply restart a graphics monitor, using _d_._m_o_n.

SSEEEE AALLSSOO
       _d_._d_i_s_p_l_a_y

       _d_._f_o_n_t

       _d_._l_a_b_e_l_s

       _d_._l_e_g_e_n_d

       _d_._m_o_n

       _d_._p_a_i_n_t_._l_a_b_e_l_s

       _d_._r_a_s_t

       _d_._s_c_a_l_e

       _d_._t_e_x_t

       _d_._t_i_t_l_e

       _d_._w_h_e_r_e

       _s_h_o_w_._f_o_n_t_s_._s_h

       _p_a_r_s_e_r

AAUUTTHHOORR
       James   Westervelt,  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					       d.label(1)
