d.rast.labels(1)	      Grass User's Manual	      d.rast.labels(1)



NNAAMMEE
       dd..rraasstt..llaabbeellss  -  Labels  raster cells using the attribute value or the
       category value.
       _(_G_R_A_S_S _D_i_s_p_l_a_y _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       dd..rraasstt..llaabbeellss

       dd..rraasstt..llaabbeellss [[--ssmmvv]]  mmaapp==_n_a_m_e  [aattttrr==string|cat|coords]  [ssiizzee==_n_u_m_b_e_r]
       [ccoolloorr==_c_o_l_o_r_n_a_m_e] [bbaacckkggrr==_c_o_l_o_r_n_a_m_e] [bboorrddeerr==_c_o_l_o_r_n_a_m_e] [ffoonntt==_f_o_n_t_n_a_m_e]

DDEESSCCRRIIPPTTIIOONN
       _d_._r_a_s_t_._l_a_b_e_l_s performs automated placement of labels for a GRASS _r_a_s_t_e_r
       _m_a_p  on	the  current  graphics monitor.  Labels can be chosen from the
       category value (numerical), a string attribute, or the labels positions
       coordinates.  The default uses the first string attribute. The user may
       select the color and sizing of the labels. Labels are only drawn within
       the current region.


       This  program  can  be  run non-interactively or interactively.	If the
       user gives the name of a GRASS _r_a_s_t_e_r _m_a_p and  (optionally)  any  other
       parameters,  the  command will be run non-interactively.  Any parameter
       left unspecified will be set to its default value (see below). Alterna-
       tively,	the  user  can	type  _d_._r_a_s_t_._l_a_b_e_l_s at the command line and be
       prompted for the parameter  values  using  the  standard  GRASS	_p_a_r_s_e_r
       interface.

   PPaarraammeetteerrss::
       --ss     save support sites file


       --mm     mark labels on the map

       --vv     Verbose output


   PPaarraammeetteerrss::
       mmaapp==_n_a_m_e
	      Name  of	a  GRASS  _r_a_s_t_e_r  _m_a_p map in the user's current mapset
	      search path.

       aattttrr==string|cat|coords
	      Type of attribute to use for the label.

	      Default: _s_t_r_i_n_g _a_t_t_r option is set to _s_t_r_i_n_g, _c_a_t or _c_o_o_r_d_s.

	      Default: _s_t_r_i_n_g

       ssiizzee==_n_u_m_b_e_r
	      The size of letters in pixels.

	      Default: _1_0

       ccoolloorr==_c_o_l_o_r_n_a_m_e
	      The GRASS _c_o_l_o_r_n_a_m_e to use for the label text.

	      Options: red,  orange,  yellow,  green,  blue,  indigo,  violet,
	      magenta, brown, gray, white or black

	      Default: _w_h_i_t_e

       bbaacckkggrr==_c_o_l_o_r_n_a_m_e
	      Color to use for text box background.

	      Options: grey, red, white, magenta, brown, blue, indigo, yellow,
	      black, orange, green, violet, none

	      Default: none

       bboorrddeerr==_c_o_l_o_r_n_a_m_e
	      Color to use for text box border.

	      Options: grey, red, white, magenta, brown, blue, indigo, yellow,
	      black, orange, green, violet, none

	      Default: none

       ffoonntt==_f_o_n_t_n_a_m_e
	      The GRASS _f_o_n_t_n_a_m_e to use for the label.

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

	      Default: _r_o_m_a_n_s


SSEEEE AALLSSOO
       _d_._s_i_t_e_s

       _d_._s_i_t_e_._l_a_b_e_l_s

       _d_._v_e_c_t_._l_a_b_e_l_s

       _d_._r_a_s_t

       _g_._r_e_g_i_o_n

       _p_a_r_s_e_r

AAUUTTHHOORR
       Markus Neteler, based on d.vect.labels and r.poly




       _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.rast.labels(1)
