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 interactively 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 specify 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, gothgrt, and gothgbt.  The
	      user can view these available 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 whatever 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 anywhere in the
       active display frame, even in areas lying outside of the  current  geo-
       graphic 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 Labora-
       tory

       _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)
