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, available graphics monitors.  The user
       can run	this  program  either  interactively  (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 moni-
       tor)

       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 command actually runs two com-
	      mands, to both start and select whatever 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 (automati-
       cally) _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 program.  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 (auto-
	      matically) _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 select-
	      ing  the	monitor  for  output using option 3. Only
	      running monitors can be selected for graphics  out-
	      put.  Once the user has _s_e_l_e_c_t_e_d a monitor for out-
	      put, no other user can use this monitor for  graph-
	      ics  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 voluntarily 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 moni-
       tors both in systems using multiple monitors and  in  sys-
       tems 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 Laboratory,

       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)
