1d.mon(1) GRASS GIS User's Manual d.mon(1)
2
3
4
6 d.mon - Controls graphics display monitors from the command line.
7
9 display, graphics, monitors
10
12 d.mon
13 d.mon --help
14 d.mon [-lpcgsrtux] [start=string] [stop=string] [select=string]
15 [width=value] [height=value] [resolution=value] [bgcolor=name]
16 [output=name] [--overwrite] [--help] [--verbose] [--quiet] [--ui]
17
18 Flags:
19 -l
20 List running monitors and exit
21
22 -p
23 Print name of currently selected monitor and exit
24
25 -c
26 Print commands for currently selected monitor and exit
27
28 -g
29 Print path to support files of currently selected monitor and exit
30
31 -s
32 Do not automatically select when starting
33
34 -r
35 Release and stop currently selected monitor and exit
36
37 -t
38 Disable true colors
39
40 -u
41 Open output file in update mode
42 Requires --overwrite flag
43
44 -x
45 Launch light-weight wx monitor without toolbars and statusbar
46 Requires ’start=wx0-7’
47
48 --overwrite
49 Allow output files to overwrite existing files
50
51 --help
52 Print usage summary
53
54 --verbose
55 Verbose module output
56
57 --quiet
58 Quiet module output
59
60 --ui
61 Force launching GUI dialog
62
63 Parameters:
64 start=string
65 Name of monitor to start
66 Options: wx0, wx1, wx2, wx3, wx4, wx5, wx6, wx7, png, ps, html,
67 cairo
68
69 stop=string
70 Name of monitor to stop
71 Options: wx0, wx1, wx2, wx3, wx4, wx5, wx6, wx7, png, ps, html,
72 cairo
73
74 select=string
75 Name of monitor to select
76 Options: wx0, wx1, wx2, wx3, wx4, wx5, wx6, wx7, png, ps, html,
77 cairo
78
79 width=value
80 Width for display monitor if not set by GRASS_RENDER_WIDTH
81 Default value: 720
82
83 height=value
84 Height for display monitor if not set by GRASS_RENDER_HEIGHT
85 Default value: 480
86
87 resolution=value
88 Dimensions of display monitor versus current size
89 Example: resolution=2 enlarge display monitor twice to 1280x960
90
91 bgcolor=name
92 Background color
93 Either a standard color name, R:G:B triplet, or "none"
94 Default: white
95
96 output=name
97 Name for output file (when starting new monitor)
98 Ignored for ’wx’ monitors
99
101 d.mon allows the user to start, select, list, release, and stop avail‐
102 able graphics monitors.
103
104 Starting a monitor
105 In order to display on-screen GRASS graphics, the user must start and
106 select a graphics monitor. By default, the start command actually runs
107 two commands, to both start and select whatever monitor is named by the
108 user. The user can get a list of running monitors by setting the -l
109 flag on the command line. Note that some monitor drivers use environ‐
110 ment variables or the specific driver documentation.
111
112 When a monitor is started, it is therefore also (automatically) se‐
113 lected for output, unless the -s flag is set by the user; the user can
114 also explicitly select a monitor that has been started.
115
116 The desired monitor should be started once and need not be restarted
117 unless it is stopped for some reason. A monitor may continue to run for
118 any length of time, even when no GRASS session is being run.
119
120 Stopping a monitor
121 A graphics monitor has two different types of status: monitor program
122 not running, and monitor running. A monitor that has been started
123 and/or selected will be listed as running; a monitor that has been
124 stopped (or not started) will be listed as not running. The -l flag
125 will list all currently running monitors.
126
127 Selecting a monitor
128 When the user starts a monitor, it is also (automatically) selected for
129 graphics output unless the user sets the -s flag. In order to use (di‐
130 rect graphics output to) a monitor, the user must select that monitor
131 for use, either by simply starting the monitor without the -s flag or
132 by explicitly selecting the monitor for output. Only running monitors
133 can be selected for graphics output.
134
135 The user can run multiple graphics monitors by simply starting each of
136 the graphics monitors the user wishes to direct output to.
137
138 Releasing (unselecting) a monitor
139 Currently selected a monitor can be released by -r flag.
140
142 d.mon is designed for interactive use. If non-interactive use is needed
143 (e.g., in a script) set GRASS_RENDER_IMMEDIATE=png (or =cairo) and use
144 the related environment variables to control output size etc.
145
147 wx0 monitor
148 To start the interactive wxGUI map display, run
149 d.mon start=wx0
150 Figure: The initialization of display monitor wx0 All subsequently dis‐
151 played data will be rendered on monitor wx0.
152 g.region raster=elevation -p
153 d.rast map=elevation
154 Figure: The display wx0 showing an elevation raster map
155
156 CAIRO file renderer monitor
157 A CAIRO monitor can be started (and selected) by
158 d.mon start=cairo output=out.pdf
159 From this moment on all displayed data will be rendered into file out‐
160 put.pdf.
161
162 List running monitors
163 To list the currently running monitors, use
164 d.mon -l
165 List of running monitors:
166 wx0
167 cairo
168
169 Show currently selected monitor
170 To identify the currently selected monitor, use
171 d.mon -p
172 cairo
173
174 Switching between monitors
175 To switch back to interactive display mode, here to an earlier started
176 and still running wxGUI monitor, use
177 d.mon select=wx0
178
179 Stopping a monitor
180 To close the wxGUI monitor, run
181 d.mon stop=wx0
182
184 d.erase, d.redraw, d.rast, d.vect, d.frame
185
186 See also list of variables for rendering, display drivers
187
189 Martin Landa, OSGeoREL, Czech Technical University in Prague, Czech Re‐
190 public
191
193 Available at: d.mon source code (history)
194
195 Accessed: Saturday Jan 21 21:14:11 2023
196
197 Main index | Display index | Topics index | Keywords index | Graphical
198 index | Full index
199
200 © 2003-2023 GRASS Development Team, GRASS GIS 8.2.1 Reference Manual
201
202
203
204GRASS 8.2.1 d.mon(1)