1d.mon(1) Grass User's Manual d.mon(1)
2
6 d.mon - To establish and control use of a graphics display monitor.
7
9 display
10
12 d.mon
13 d.mon help
14 d.mon [-lLprs] [start=string] [stop=string] [select=string]
15 [unlock=string] [--verbose] [--quiet]
16 Flags:
18 -l
19 List all monitors
20 -L
22 List all monitors (with current status)
23 -p
25 Print name of currently selected monitor
26 -r
28 Release currently selected monitor
29 -s
31 Do not automatically select when starting
32 --verbose
34 Verbose module output
35 --quiet
37 Quiet module output
38 Parameters:
40 start=string
41 Name of graphics monitor to start
42 stop=string
44 Name of graphics monitor to stop
45 select=string
47 Name of graphics monitor to select
48 unlock=string
50 Name of graphics monitor to unlock
51
53 d.mon allows the user to start, select, list, query the status of,
54 release control of, stop, and unlock control of, available graphics
55 monitors. The user can run this program either interactively (through
56 a series of menus), or non-interactively by typing the name of the mon‐
57 itor to start, stop, select, or unlock, and any desired flags on the
58 command line.
59 These parameters perform the following functions:
61 1 Start a Monitor.
63 In order to display on-screen GRASS graphics, the user must
64 start and select a graphics monitor. By default, the start com‐
65 mand actually runs two commands, to both start and select what‐
66 ever monitor is named by the user. (The user can get a list of
67 available monitors by setting the -l or -L flag on the command
68 line.) Note that some monitor drivers use environment variables
69 or the specific driver documentation.
70 When a monitor is started, it is therefore also (automatically)
72 selected for output, unless the -s flag is set by the user; the user
73 can also explictly select a monitor that has been started (see (3)
74 below). After a monitor is started, a blank graphics frame should
75 appear on whatever terminal the user is using to display graphics.
76 The desired monitor should be started once and need not be restarted
78 unless it is stopped (option 2) for some reason. A monitor may continue
79 to run for any length of time, even when no GRASS session is being run.
80 The monitor program runs in the background.
81 2 Stop a Monitor.
83 Sometimes the monitor program needs to be stopped (terminated).
84 Choosing option 2 will terminate a user-specified monitor pro‐
85 gram. A graphics monitor has two different types of status:
86 monitor program not running, and monitor running. A monitor
87 that has been started and/or selected will be listed as running;
88 a monitor that has been stopped (or not started) will be listed
89 as not running. The -L (list status) flag will list the status
90 of each monitor connected to the system.
91 3 Select a Monitor.
93 When the user starts a monitor, it is also (automatically)
94 selected for graphics output unless the user sets the -s flag.
95 In order to use (direct graphics output to) a monitor, the user
96 must select that monitor for use, either by simply starting the
97 monitor without the -s flag or by explictly selecting the moni‐
98 tor for output using option 3. Only running monitors can be
99 selected for graphics output. Once the user has selected a mon‐
100 itor for output, no other user can use this monitor for graphics
101 output until the monitor driver is either released (by the user)
102 or unlocked (by any user on the system).
103 The user can run multiple graphics monitors by simply starting each of
105 the graphics monitors drivers he wishes to direct output to.
106 4 Release a Monitor.
108 Once a user has selected a monitor for graphics output, it is
109 locked for use by that user until either: (1) the user voluntar‐
110 ily releases control of the monitor for use by another (option
111 4), or (2) another GRASS user unlocks the user's control of the
112 monitor. Menu option 4 appears only to the person who has
113 selected the monitor (since only that user can release control
114 of his selected graphics monitor.) If another user wishes to
115 unlock the user's control of the monitor, that user must run
116 d.mon from the command line and set the unlock=name parameter.
117 You may choose multiple options within the d.mon program.
119
121 The d.mon program can regulate control of graphics monitors both in
122 systems using multiple monitors and in systems using a single graphics
123 monitor. To increase the number of monitors available to each user, the
124 ASCII file $GISBASE/etc/monitorcap needs to be modified.
125
127 d.erase
128 pngdriver
129 xdriver
130 variables list
131
133 Michael Shapiro, U.S. Army Construction Engineering Research Labora‐
134 tory,
135 Full 24bit support by Roberto Flor, ITC-Irst, Trento, Italy
136 Code cleanup by Glynn Clements
137 Last changed: $Date: 2007-08-16 13:28:48 +0200 (Thu, 16 Aug 2007) $
139 Full index
141 © 2003-2008 GRASS Development Team
143GRASS 6.3.0 d.mon(1)