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



NNAAMMEE
       dd..tteexxtt  -  Draws text in the active display frame on the graphics moni-
       tor.
       _(_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 redirection 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 appear-
	      ing 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 display 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. Available 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 .B 1 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  Labora-
       tory

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