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



NNAAMMEE
       dd..mmoonn - To establish and control use of a graphics display monitor.
       _(_G_R_A_S_S _D_i_s_p_l_a_y _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       dd..mmoonn
       dd..mmoonn hheellpp
       dd..mmoonn [--llLLpprrss] [ssttaarrtt==_n_a_m_e] [ssttoopp==_n_a_m_e] [sseelleecctt==_n_a_m_e] [uunnlloocckk==_n_a_m_e]

DDEESSCCRRIIPPTTIIOONN
       The  GRASS  program _d_._m_o_n allows the user to start, select, list, query
       the status of, release control of, stop, and unlock control of,	avail-
       able  graphics monitors.  The user can run this program either interac-
       tively (through a series of menus), or non-interactively by typing  the
       name  of the monitor to start, stop, select, or unlock, and any desired
       flags on the command line.



   FFllaaggss::
       --ll     List all monitors

       --LL     List all monitors (with current status)

       --pp     Print name of currently selected monitor

       --rr     Release currently selected monitor

       --ss     Do not automatically select when starting


   PPaarraammeetteerrss::
       ssttaarrtt==_n_a_m_e
	      Name of graphics monitor to start

       ssttoopp==_n_a_m_e
	      Name of graphics monitor to stop

       sseelleecctt==_n_a_m_e
	      Name of graphics monitor to select

       uunnlloocckk==_n_a_m_e
	      Name of graphics monitor to unlock

       When the user enters the command  dd..mmoonn	without  specifying  parameter
       values, the below menu appears on the screen:

			       MONITOR MENU
       Making sure that the graphics monitor is running:

	 1	- Start a graphics monitor
		(also automatically selects this monitor)
	 2	- Stop a graphics monitor

       Choosing a graphics monitor for your graphics:

	 3	- Select a graphics device for output
		(currently selected monitor:  name)
	 4	- Release control of the graphics driver
		(let someone else use it)
		(option 4 appears only after selection of a monitor)

       RETURN	quit

       These parameters perform the following functions:

	      SSttaarrtt aa MMoonniittoorr..
	      In  order  to  display  on-screen  GRASS graphics, the user must
	      _s_t_a_r_t and _s_e_l_e_c_t a graphics monitor.  By default, the _s_t_a_r_t com-
	      mand  actually runs two commands, to both start and select what-
	      ever monitor is named by the user. (The user can get a  list  of
	      available  monitors  by setting the -l or -L flag on the command
	      line.)


       When a  monitor	is  _s_t_a_r_t_e_d,  it  is  therefore  also  (automatically)
       _s_e_l_e_c_t_e_d  for  output,  unless the _-_s flag is set by the user; the user
       can also explictly _s_e_l_e_c_t a monitor that  has  been  started  (see  (3)
       below).	 After	a  monitor  is	started, a blank graphics frame should
       appear on whatever terminal the user is using to display graphics.


       The desired monitor should be started once and need  not  be  restarted
       unless it is stopped (option _2) for some reason. A monitor may continue
       to run for any length of time, even when no GRASS session is being run.
       The monitor program runs in the background.

	      SSttoopp aa MMoonniittoorr..
	      Sometimes  the monitor program needs to be stopped (terminated).
	      Choosing option 2 will terminate a user-specified  monitor  pro-
	      gram.   A  graphics  monitor  has two different types of status:
	      monitor program _n_o_t _r_u_n_n_i_n_g, and	monitor  _r_u_n_n_i_n_g.   A  monitor
	      that has been started and/or selected will be listed as running;
	      a monitor that has been stopped (or not started) will be	listed
	      as  not running.	The -L (list status) flag will list the status
	      of each monitor connected to the system.

	      SSeelleecctt aa MMoonniittoorr..
	      When the user _s_t_a_r_t_s  a  monitor,  it  is  also  (automatically)
	      _s_e_l_e_c_t_e_d	for  graphics output unless the user sets the _-_s flag.
	      In order to use (direct graphics output to) a monitor, the  user
	      must  _s_e_l_e_c_t that monitor for use, either by simply starting the
	      monitor without the -s flag or by explictly selecting the  moni-
	      tor  for	output	using  option  3. Only running monitors can be
	      selected for graphics output.  Once the user has _s_e_l_e_c_t_e_d a mon-
	      itor for output, no other user can use this monitor for graphics
	      output until the monitor driver is either _r_e_l_e_a_s_e_d (by the user)
	      or _u_n_l_o_c_k_e_d (by any user on the system).


       The  user can run multiple graphics monitors by simply starting each of
       the graphics monitors drivers he wishes to direct output to.

	      RReelleeaassee aa MMoonniittoorr..

	       Once a user has _s_e_l_e_c_t_e_d a monitor for graphics output,	it  is
	      locked for use by that user until either: (1) the user voluntar-
	      ily releases control of the monitor for use by  another  (option
	      4),  or (2) another GRASS user _u_n_l_o_c_k_s the user's control of the
	      monitor.	Menu option 4 appears  only  to  the  person  who  has
	      selected	the  monitor (since only that user can release control
	      of his selected graphics monitor.) If  another  user  wishes  to
	      _u_n_l_o_c_k  the  user's  control  of the monitor, that user must run
	      _d_._m_o_n from the command line and set the uunnlloocckk==_n_a_m_e parameter.

       You may choose multiple options within the  _d_._m_o_n  program.   To  leave
       (exit) the _d_._m_o_n menu, press the  key.

NNOOTTEESS
       The  _d_._m_o_n  program  can  regulate control of graphics monitors both in
       systems using multiple monitors and in systems using a single  graphics
       monitor.

SSEEEE AALLSSOO
       _d_._e_r_a_s_e

       _d_._f_r_a_m_e

       _m_o_n_i_t_o_r_c_a_p

AAUUTTHHOORR
       Michael	Shapiro,  U.S.	Army Construction Engineering Research Labora-
       tory,

       Full 24bit support by Roberto Flor, ITC-Irst, Trento, Italy

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_2_/_0_4_/_0_9 _0_0_:_3_1_:_2_6 _$



GRASS 5.0							      d.mon(1)
