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