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



NNAAMMEE
       dd..tteexxtt  -  Draws  text  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..tteexxtt
       dd..tteexxtt hheellpp
       dd..tteexxtt [ssiizzee==_v_a_l_u_e] [ccoolloorr==_n_a_m_e] [lliinnee==_v_a_l_u_e]

DDEESSCCRRIIPPTTIIOONN
       _d_._t_e_x_t draws text in  the  active  display  frame  on  the
       graphics  monitor.   Text can be provided through standard
       input or redirected from a file (using the  UNIX  redirec-
       tion mechanism).

   PPaarraammeetteerrss::
       ssiizzee==_v_a_l_u_e
	      Height  of  letters,  stated  as	a  percent of the
	      available display frame height.

	      Options: 0 - 100

	      Default: 5

       ccoolloorr==_n_a_m_e
	      Sets display text color to _n_a_m_e.

	      Options: red, orange, yellow, green, blue,  indigo,
	      violet, gray, white, and black

	      Default: _g_r_a_y

       lliinnee==_v_a_l_u_e
	      The  screen  line number on which the first line of
	      text will be drawn.

	      (Line 1 is at the top of the active display frame.)

	      Options: 1 - 1000

	      Default: 1

       In  addition  to the options provided on the command line,
       colors,	text  size,  font  type,  and  boldness,  can  be
       adjusted with commands in the standard input (i.e., if the
       user invokes _d_._t_e_x_t without options on the  command  line,
       and  then  assigns values to these options on lines within
       the standard input).  In this case, the user also sees the
       standard GRASS parser interface.

   CCoommmmaannddss::
       .C _c_o_l_o_r
	      (where _c_o_l_o_r is one of the available colors) causes
	      text appearing on subsequent lines to be	drawn  in
	      that color.

       ..SS  _s_i_z_e
	      (where  _s_i_z_e  is a percentage within the range 0 to
	      100) adjusts text size.  Note that  a  size  of  10
	      would allow 10 lines to be drawn in the active dis-
	      play frame, 5 would allow the drawing of 20  lines,
	      and 50 would allow the drawing of 2 lines.



       ..FF _f_o_n_t
	      (where  _f_o_n_t is one of the fonts known by the GRASS
	      program _d_._f_o_n_t) manipulates the font  type.  Avail-
	      able fonts are listed in the GRASS manual entry for
	      _d_._f_o_n_t.  The default font type used (if unspecified
	      by  the  user)  is  _r_o_m_a_n_s.   Run  the  GRASS macro
	      _s_h_o_w_._f_o_n_t_s_._s_h to see what these fonts look like.

       ..BB 11   stipulates that following text be printed in  bboolldd.
	      This command means _b_o_l_d _o_n.

       ..BB 00   turns  _b_o_l_d  _o_f_f	of  all  text  appearing on lines
	      beneath it.  (_B_o_l_d  _o_f_f  is  used  by  default,  if
	      unspecified by the user.)


EEXXAAMMPPLLEE
       The following command will print the short phrase "This is
       a test of d.text" in the active display	frame  using  the
       color  yellow,  in  bold,  and using 4/100'ths (4%) of the
       active frame's vertical space per line:



       dd..tteexxtt 11 This is a test of d.text

       The user presses _c_o_n_t_r_o_l_-_d (the "ctrl" and  "d"	keys)  to
       end input to _d_._t_e_x_t (equal to EOF).

NNOOTTEESS
       Note  that the GRASS command _d_._t_i_t_l_e creates map TITLEs in
       a format suitable for input to _d_._t_e_x_t.


       _d_._t_e_x_t needs escape sequences  that  can  be  used  within
       lines to change colors, boldness, and perhaps size.

SSEEEE AALLSSOO
       _d_._f_o_n_t

       _d_._t_i_t_l_e

       _s_h_o_w_._f_o_n_t_s_._s_h

       _d_._t_e_x_t_._f_r_e_e_t_y_p_e

       _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_5_/_1_3 _0_7_:_4_1_:_5_9 _$



GRASS 5.0						d.text(1)
