1d.mon(1)                    GRASS GIS User's Manual                   d.mon(1)
2
3
4

NAME

6       d.mon  - Controls graphics display monitors from the command line.
7

KEYWORDS

9       display, graphics, monitors
10

SYNOPSIS

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

DESCRIPTION

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)
113       selected  for  output,  unless the -s flag is set by the user; the user
114       can 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
130       (direct graphics output to) a monitor, the user must select that  moni‐
131       tor  for use, either by simply starting the monitor without the -s flag
132       or by explicitly selecting the monitor for output. Only  running  moni‐
133       tors 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

NOTES

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

EXAMPLES

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

SEE ALSO

184        d.erase, d.redraw, d.rast, d.vect, d.frame
185
186       See also list of variables for rendering, display drivers
187

AUTHOR

189       Martin  Landa,  OSGeoREL,  Czech  Technical University in Prague, Czech
190       Republic
191

SOURCE CODE

193       Available at: d.mon source code (history)
194
195       Main index | Display index | Topics index | Keywords index |  Graphical
196       index | Full index
197
198       © 2003-2020 GRASS Development Team, GRASS GIS 7.8.5 Reference Manual
199
200
201
202GRASS 7.8.5                                                           d.mon(1)
Impressum