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



NNAAMMEE
       dd..ddiissppllaayy - A menu-driven, highly interactive display program for view-
       ing maps and producing final map products
       _(_G_R_A_S_S _D_i_s_p_l_a_y _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       dd..ddiissppllaayy

DDEESSCCRRIIPPTTIIOONN
       The GRASS program _d_._d_i_s_p_l_a_y is used to display maps on a graphics moni-
       tor  and  prepare  final map products for printing.  It is advisable to
       first run _d_._e_r_a_s_e before each run of _d_._d_i_s_p_l_a_y to  prepare  the	screen
       for graphics.


       After  invoking the command dd..ddiissppllaayy, the DISPLAY MAIN MENU appears on
       the monitor.  Options  in  this	and  subsequent  _d_._d_i_s_p_l_a_y  menus  are
       selected  through  use  of  the pointing device (mouse). When the mouse
       cursor is over the desired menu selection, the user simply presses  any
       button on the mouse.


       _d_._d_i_s_p_l_a_y  is  a  macro	that allows the user to access a wide range of
       GRASS display functions in a menu-driven and highly  interactive  envi-
       ronment.   Most	of the functions accessible through _d_._d_i_s_p_l_a_y can also
       be run independently of one another by running the GRASS  display  (_d_.)
       commands listed in the SEE ALSO section, below. However, in many cases,
       these other _d_. commands give the  user  greater	flexibility  and  make
       available  more options than are available through the _d_._d_i_s_p_l_a_y menus.
       For example, the _d_._d_i_s_p_l_a_y _l_a_b_e_l file option runs the  _d_._l_a_b_e_l  command
       using  defaults.  Users	running _d_._l_a_b_e_l directly from the command line
       have the choice of stipulating specific label background and text  col-
       ors,  as  well  as  text sizes and font types.  Users running the _l_a_b_e_l
       file option through _d_._d_i_s_p_l_a_y cannot specify  these  options;  instead,
       default values are used (see _d_._l_a_b_e_l for default values used).


       The  _d_._d_i_s_p_l_a_y tool is best learned by playing with its options.  Refer
       to the individual _d_. and other commands in the SEE ALSO section	for  a
       detailed examination of these functions.

NNOOTTEESS
       The  user  can also modify the current region settings from the DISPLAY
       MAIN MENU.  Using the mouse, the user can choose to _z_o_o_m in on  a  por-
       tion  of  the displayed raster map layer to create a smaller geographic
       region.	Once the user has defined the corners of this area  using  the
       mouse,  the  smaller  area is enlarged and replotted on the screen. The
       user can similarly choose to _z_o_o_m out. In this case, the user uses  the
       mouse to encompass that portion of the reduced map that the user wishes
       to make the current geographic region and display in the center of  the
       screen.	The  larger  map is then replotted and displayed. Finally, the
       user can enter geographic coordinates for the region's corners from the
       keyboard  using	the  GRASS command _g_._r_e_g_i_o_n. This is done by selecting
       the _t_y_p_e coordinates option.


       The main menu also offers the user the option of hiding the  main  menu
       for ten seconds (_h_i_d_e _m_e_n_u _f_o_r _1_0 _s_e_c_o_n_d_s).


       The  _d_._d_i_s_p_l_a_y  command must be run in conjunction with a program which
       converts the GRASS graphics commands  generated	by  _d_._d_i_s_p_l_a_y  to  the
       graphics commands that the current device understands. This device will
       almost always be a graphics  monitor.  On  most	systems  the  user  is
       required  to start up this other program separately from (and prior to)
       _d_._d_i_s_p_l_a_y.  In such cases, a locally-defined  program,  usually	"moni-
       tor",  is  used	(see  your  GRASS  manager). (For example, on MASSCOMP
       machines, the _d_._m_o_n program must be running in the  foreground  on  the
       graphics  monitor.   On	SUN machines, the _d_._m_o_n program can be started
       from any terminal and run in the background.)


       _d_._d_i_s_p_l_a_y sends program output to the current graphics frame  (set,  by
       default, to the full graphics screen unless modified by the user).  You
       can use _d_._f_r_a_m_e to create and choose a smaller  display	frame  on  the
       graphics monitor for use by _d_._d_i_s_p_l_a_y.


       See  the  GRASS	macro  _3_d_._v_i_e_w_._s_h stored under $GISBASE/scripts for an
       example of how you can create a	_d_._d_i_s_p_l_a_y-like	macro  using  a  shell
       script.

SSEEEE AALLSSOO
       See  _3_d_._v_i_e_w_._s_h or _s_l_i_d_e_._s_h_o_w_._s_h under $GISBASE/scripts for examples of
       _d_._d_i_s_p_l_a_y-like macros.


       _d_._3_d _d_._c_o_l_o_r_m_o_d_e _d_._c_o_l_o_r_s  _d_._f_r_a_m_e  _d_._l_a_b_e_l  _d_._l_e_g_e_n_d  _d_._m_e_a_s_u_r_e  _d_._m_o_n
       _d_._r_a_s_t _d_._s_c_a_l_e _d_._s_i_t_e_s _d_._v_e_c_t _d_._z_o_o_m _g_._r_e_g_i_o_n _d_._m_e_n_u _v_._d_i_g_i_t

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_1_/_2_5 _0_5_:_4_5_:_3_2 _$



GRASS 5.0							  d.display(1)
