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



NNAAMMEE
       dd..ttiittllee	 -  Outputs  a TITLE for a raster map layer in a form suitable
       for display by _d_._t_e_x_t.
       _(_G_R_A_S_S _D_i_s_p_l_a_y _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       dd..ttiittllee
       dd..ttiittllee hheellpp
       dd..ttiittllee [--ff] mmaapp==_n_a_m_e [ccoolloorr==_n_a_m_e] [ssiizzee==_v_a_l_u_e]

DDEESSCCRRIIPPTTIIOONN
       _d_._t_i_t_l_e generates to standard output a string  which  can  be  used  by
       _d_._t_e_x_t to draw a TITLE for the raster map layer _n_a_m_e in the active dis-
       play frame on the graphics monitor.  Output created by _d_._t_i_t_l_e  can  be
       redirected  into  a  file, or piped directly into _d_._t_e_x_t to display the
       map TITLE created by _d_._t_i_t_l_e.  The map TITLE created will  include  the
       map  layer's  name,  TITLE,  MAPSET,  LOCATION_NAME,  geographic region
       boundary coordinates, and cell resolution.


       The user can state program arguments on the command line, or type  sim-
       ply  dd..ttiittllee  on the command line. In the latter case, the program will
       prompt the user for the parameter values and  flag  setting  using  the
       standard GRASS parser interface.

   FFllaagg::
       --ff     Displays a fancier TITLE.


   PPaarraammeetteerrss::
       mmaapp==_n_a_m_e
	      Name of an existing raster map layer in the user's mapset search
	      path.

       ccoolloorr==_n_a_m_e
	      Sets the current color to the _n_a_m_e stated.
	      Options: red, orange, green, blue, indigo, violet, black, white,
	      gray, yellow, brown, and magenta
	      Default: _w_h_i_t_e

       ssiizzee==_v_a_l_u_e
	      Sets the text size as a percentage of the active display frame's
	      height, to _v_a_l_u_e. Floating point values can be used.
	      Options: 0 - 100
	      Default: 4.0


EEXXAAMMPPLLEE
       For example, a  user  wishing  to  create  a  suitable  TITLE  for  the
       Spearfish,  SD  _s_o_i_l_s map layer and to display this TITLE in the active
       display frame on the graphics monitor might type the following: dd..ttiittllee
       mmaapp==_s_o_i_l_s ccoolloorr==_r_e_d ssiizzee==_5 >> TTIITTLLEE..ffiillee dd..tteexxtt << TTIITTLLEE..ffiillee

       Alternately,  the  user might pipe _d_._t_i_t_l_e output directly into _d_._t_e_x_t:
       dd..ttiittllee mmaapp==_s_o_i_l_s ccoolloorr==_r_e_d ssiizzee==_5 | d.text



       A file created by _d_._t_i_t_l_e can be displayed  with  _d_._t_e_x_t.   Information
       contained in this file takes precedence over the _c_o_l_o_r and _s_i_z_e parame-
       ters for _d_._t_e_x_t.

NNOOTTEESS
       The text created with _d_._t_e_x_t will not necessarily fit within the active
       display	frame  on  the graphics monitor; the user should choose a text
       size appropriate to this frame.

SSEEEE AALLSSOO
       _d_._f_o_n_t

       _d_._t_e_x_t

       _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_3_/_1_0_/_1_2 _0_4_:_5_5_:_2_6 _$



GRASS 5.0							    d.title(1)
