DESCRIPTION
d.mon allows the user to start, select, list, release, and
stop available graphics monitors.
Start a monitor
In order to display on-screen GRASS graphics, the user must
start and select a graphics monitor. By default,
the start command actually runs two commands, to both start and
select whatever monitor is named by the user. The user can get a list
of running monitors by setting the -l flag on the command
line. Note that some monitor drivers use environment
variables or the specific
driver documentation.
When a monitor is started, it is therefore also
(automatically) selected for output, unless the
-s flag is set by the user; the user can also
explicitly select a monitor that has been started.
The desired monitor should be started once and need not be restarted
unless it is stopped for some reason. A monitor may continue to run
for any length of time, even when no GRASS session is being run.
Stop a monitor
A graphics monitor has two different types of status: monitor
program not running, and monitor running. 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 flag will list all currently running monitors.
Select a monitor
When the user starts a monitor, it is also
(automatically) selected for graphics output unless the user
sets the -s flag. In order to use (direct graphics output to)
a monitor, the user must select that monitor for use, either
by simply starting the monitor without the -s flag or by
explicitly selecting the monitor for output. Only running monitors can
be selected for graphics output.
The user can run multiple graphics monitors by simply starting each of
the graphics monitors he wishes to direct output to.
Release a monitor
Currently selected a monitor can be released by -r
flag.
EXAMPLES
To start interactive wxGUI map
display
All data will be rendered on wx0 display. New monitor can be
started (and selected ) by
d.mon start=cairo output=out.pdf
To list running monitors
d.mon -l
List of running monitors:
wx0
cairo
To determine currently selected monitor
From this moment all data will be rendered into
file output.pdf. To switch back to interactive wxGUI monitor
To close this monitor
SEE ALSO
d.erase,
d.redraw,
d.rast,
d.vect
See also
list of variables,
display drivers
AUTHOR
Martin Landa, Czech Republic
Last changed: $Date$