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



NNAAMMEE
       dd..ddiissppllaayy - A menu-driven, highly interactive display pro-
       gram for viewing 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 monitor and prepare final map products for print-
       ing.  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  subse-
       quent  _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 environment.	 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 flex-
       ibility 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 colors, 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 portion 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  geo-
       graphic	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 gener-
       ated by _d_._d_i_s_p_l_a_y to the graphics commands that	the  cur-
       rent 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	"monitor", 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 termi-
       nal 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  $GIS-
       BASE/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 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_2 _$



GRASS 5.0					     d.display(1)
