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 display 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,  geo-
       graphic	region boundary coordinates, and cell resolution.


       The user can state program arguments on the command  line,
       or  type simply 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: 15.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 parameters 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 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.title(1)
