[GRASS-SVN] r39243 - grass/branches/develbranch_6/gui/wxpython/docs
svn_grass at osgeo.org
svn_grass at osgeo.org
Fri Sep 18 01:10:45 EDT 2009
Author: cmbarton
Date: 2009-09-18 01:10:43 -0400 (Fri, 18 Sep 2009)
New Revision: 39243
Modified:
grass/branches/develbranch_6/gui/wxpython/docs/wxGUI.html
Log:
Additional updates and corrections.
Modified: grass/branches/develbranch_6/gui/wxpython/docs/wxGUI.html
===================================================================
--- grass/branches/develbranch_6/gui/wxpython/docs/wxGUI.html 2009-09-18 03:21:46 UTC (rev 39242)
+++ grass/branches/develbranch_6/gui/wxpython/docs/wxGUI.html 2009-09-18 05:10:43 UTC (rev 39243)
@@ -8,7 +8,7 @@
typing at GRASS command line prompt
<div class="code"><pre>
- g.gui -u wxpython
+ g.gui -u wxpython&
</pre></div>
or define in your <tt>.grassrc6</tt> file 'GRASS_GUI' variable
@@ -42,24 +42,26 @@
The GUI is composed by <em>two</em> main components:
<ul>
- <li><b>Layer Manager</b> which allows users to run different GRASS
- modules from menu, includes map layer management, integrated
+ <li>The <b>Layer Manager</b> includes map layer management, integrated
command-line prompt, and command output window tab.</li>
- <li><b>Map Display Window</b> which integrates basic tools for
- zooming, panning, data querying, decorations (north arrows,
- barscale, etc.). The user is allowed to start various map display
- instances during one session. The Layer Manager registers Map
- Display Windows using different tabs.</li>
+ <li>The <b>Map Display Window</b> integrates basic tools for
+ zooming, panning, data querying, and map elements (north arrows,
+ barscale, etc.). Each display window is associated with its own
+ set of map layers in the layer manager. The user may start multiple map
+ displays during a session. The map layers for each display are grouped
+ under different tabs in the Layer Manager.</li>
</ul>
<h3>Layer Manager</h3>
-The <em>Layer Manager</em> provides an interactive graphical interface to GRASS
-commands. It includes a set of pull-down menus for all GRASS GIS
-functions (analysis, file I/O, GIS configuration and management), the
-toolbar to manage display map layers, a layer tree frame in which map layers
-to display are organized, command output window tab, and interactive
-command line prompt.
+The <em>Layer Manager</em> provides an interactive graphical interface for
+creating and managing GRASS displays. There is a toolbar to manage displayed
+map layers, a layer tree frame in which map layers for display are organized,
+a command output window tab, and interactive command line prompt. On Linux
+and Windows platforms, the layer manager also has a menu bar with a set of
+pull-down menus for all GRASS GIS functions (analysis, file I/O, GIS
+configuration and management); on a Mac, the GRASS functions menu is at the
+top of the screen.
<center>
<br><img src="wxGUI_layer_manager.jpg" border="1"><br><br>
@@ -73,11 +75,10 @@
<p>
Map layers are listed in the window frame below the toolbar. Layers can
-include raster and vector maps, text, map decorations (scale and
-north arrow, and grids), and commands (where any GRASS command can be
-written). Layers are displayed as arranged in the layer tree: the
-bottom layer is displayed first and the top layer is displayed last, as if
-the layers were a series of stacked overlays.
+include raster and vector maps, vector labels, and commands (where any
+GRASS command can be written). Layers are displayed as arranged in the layer
+tree: the bottom layer is displayed first and the top layer is displayed
+last, as if the layers were a series of stacked overlays.
<p>
The check box to the left of each layer makes it active or inactive
@@ -88,16 +89,18 @@
sessions, restoring all layers and their display options.
<p>
-Right mouse click on a layer opens a dropdown menu with options to
-remove or rename the layer (g.remove, g.rename),
-change its display properties (d.rast and d.vect options such as color, symbol, etc.),
-show its metadata (r.info, v.info) or attributes, if applicable.
+A right mouse click on a layer or left clicking the button to the right of
+the layer opens a dropdown menu with options to remove or rename the layer
+(g.remove, g.rename), change its display properties (d.rast and d.vect
+options such as color, symbol, etc.), show its metadata (r.info, v.info) or
+attributes, if applicable.
<p>
-Left mouse double click on a layer opens GUI for its display options (d.rast, d.vect).
+A left mouse double click on a layer opens GUI for its display options
+These options are those for the d.* command for each layer type (d.rast,
+d.vect, or d.grid, for example).
<h4>Layer Manager Toolbar</h4>
-New and old icons and explanation of their functionality:
<dl>
<dt><img src="icons/grass2/monitor-create.png">
@@ -105,7 +108,7 @@
<dd>Opens a new map display and creates empty layer tree tab in Layer Manager.</dd>
<dt><img src="icons/grass2/create.png">
-<em>Creates new workspace file</em></dt>
+<em>Create new workspace file</em></dt>
<dd>Removes all layers in the layer tree and creates a new, empty tree
where new layers can be added.</dd>
@@ -130,7 +133,7 @@
<dt><img src="icons/grass2/layer-shaded-relief-add.png">
<em>Add various raster-based map layers</em></dt>
-<dd>opens a dropdown menu that allows user to select to:<br>
+<dd>Opens a dropdown menu that allows user to select to:<br>
<ul>
<li><dt><img src="icons/grass2/layer-shaded-relief-add.png">
@@ -139,16 +142,17 @@
see <em><a href="d.shadedmap.html">d.shadedmap</a></em></li>
<li><dt><img src="icons/grass2/layer-rgb-add.png">
<em>Add RGB raster layer</em></dt>
- <dd>Combines and displays three raster maps defined as red, green, and blue
- channels, see <em><a href="d.rgb.html">d.rgb</a></em>.</dd></li>
+ <dd>Combines and displays three raster maps defined as red, green,
+ and blue channels to create an RGB color map,
+ see <em><a href="d.rgb.html">d.rgb</a></em>.</dd></li>
<li><dt><img src="icons/grass2/layer-his-add.png">
<em>Add HIS raster layer</em></dt>
<dd>Combines and displays two or three raster maps defined as hue,
- intensity, and (optionally) saturation channels,
+ intensity, and (optionally) saturation channels to create a color map,
see <em><a href="d.his.html">d.his</a></em>.</dd></li>
<li><dt><img src="icons/grass2/layer-cell-cats-add.png">
<em>Add raster arrows layer</em></dt>
- <dd>Adds map of raster cells with directional arrows drawn. Arrow
+ <dd>Adds map of raster cells with directional arrows drawn. Arrow
direction and length are determined by separate aspect/directional map
and (optional) slope/intensity map,
see <em><a href="d.rast.arrow.html">d.rast.arrow</a></em>.</dd></li>
@@ -165,7 +169,7 @@
<dt><img src="icons/grass2/layer-vector-thematic-add.png">
<em>Add various vector-based map layers </em></dt>
-<dd>opens a dropdown menu that allows user to select to:<br>
+<dd>Opens a dropdown menu that allows user to select to:<br>
<ul>
<li><dt><img src="icons/grass2/layer-vector-thematic-add.png">
@@ -214,7 +218,7 @@
<dt><img src="icons/grass2/layer-grid-add.png">
<em>Add grid or vector labels overlay</em></dt>
-<dd>opens a dropdown menu that allows user to select to:<br>
+<dd>Opens a dropdown menu that allows user to select to:<br>
<ul>
<li><dt><img src="icons/grass2/layer-grid-add.png">
@@ -224,17 +228,17 @@
<li><dt><img src="icons/grass2/layer-label-add.png">
<em>Add labels layer for vector objects (from existing labels file)</em></dt>
- <dd>Add raster text layer from a labels file for vector objects
- created with the <em><a href="v.label.html">v.label</a></em> module
- (accessed from button in options panel). A labels file can also be
- created with a text editor, see <em><a href="d.labels.html">d.labels</a></em>.</dd></li>
+ <dd>Add a layer of text from a labels file for vector objects
+ created with the <em><a href="v.label.html">v.label</a></em> module.
+ A labels file can also be created with a text editor,
+ see <em><a href="d.labels.html">d.labels</a></em>.</dd></li>
- <li><dt><img src="icons/grass2/layer-grid-add.png">
+ <li><dt><img src="icons/grass/module-d.geodesic.gif">
<em>Add geodesic line layer</em></dt>
<dd>Add layer to display geodesic line for latitude/longitude locations only,
see <em><a href="d.geodesic.html">d.geodesic</a></em></dd></li>
- <li><dt><img src="icons/grass2/layer-grid-add.png">
+ <li><dt><img src="icons/grass/module-d.geodesic.gif">
<em>Add rhumbline layer</em>
<dd>Add layer to display rhumblines (for latitude/longitude locations only),
see <em><a href="d.rhumbline.html">d.rhumbline</a></em>.</dd></li>
@@ -276,23 +280,30 @@
<h3>Map Display Window</h3>
-This component includes toolbar area (set of toolbars), map canvas
-where a map composition is displayed, and the statusbar.
+The map display window includes toolbar that can be docked and undocked from
+the window, a map canvas where a map composition of one or more layers is
+displayed, and a statusbar with information about the geographic region of
+the maps displayed.
<center>
<br><img src="wxGUI_map_display.jpg" alt="Map Display Window"><br><br>
</center>
-Each Map Display Window has a unique layer tree and region
-setting. The window contains a toolbar with buttons to manage the map
-in the display (zoom and pan), providing tools for query and distance
-measurement, and exporting or printing the display.
+Each Map Display Window has a unique layer tree (in the layer manager)
+and geographic <em>region</em> setting. At the top of the window is a
+toolbar with buttons to manage the map in the display (render, erase, zoom
+and pan), for query and and analysis (distance measurement, profile,
+and histogram creation), to overlay map elements onto the display (scale,
+north arrow, legend, and custom text), and to export or print the display.
<p>
-In the statusbar can be displayed the geographic coordinates under the
-cursor, current geographical region extent, computational region
-(including graphical visualization in map display), map display
-geometry (number of rows, columns, resolution) and map scale.
+In the statusbar, the user can choose to display the geographic coordinates
+under the cursor, current geographical region extent, computational region
+(including graphical visualization in map display), map display geometry
+(number of rows, columns, resolution) and map scale. Checking the
+<em>render</em> button in the statusbar will cause the map display to update
+automatically any time a map is added to, removed from, or changed in its
+layer tree.
<p>
It is important to note that zooming in any display will
@@ -308,18 +319,18 @@
<dt><img src="icons/grass2/show.png">
<em>Display map</em></dt>
-<dd>Displays all active layers from layer tree at current resolution
-and region extents for that map display window.</dd>
+<dd>Displays all active layers from layer tree and re-renders for display
+any layers that have changed since the last time the display was updated,
+including layers added or removed.</dd>
<dt><img src="icons/grass2/layer-redraw.png">
<em>Re-render map</em></dt>
-<dd>Resets the region to the display resolution and extent and forces
-re-display and re-rendering all active layers.</dd>
+<dd>Re-renders all active layers regardless of whether they have changed
+or not.</dd>
<dt><img src="icons/grass2/erase.png">
<em>Erase display</em></dt>
-<dd>Erases the currently selected map display to a white background;
-also removes all frames,
+<dd>Erases the currently selected map display to a white background.
see <em><a href="d.erase.html">d.erase</a>, <a href="d.frame.html">d.frame
-e</a></em>.</dd>
@@ -329,14 +340,16 @@
<dt><img src="icons/grass2/info.png">
<em>Query raster/vector maps</em></dt>
-<dd>opens a dropdown menu that allows user to select to:<br>
+<dd>Opens a dropdown menu that allows user to select to:<br>
<ul>
<li><dd>Query selected raster, RGB raster (all three map channels will be
queried), or vector map(s) using the mouse. Map(s) must be selected
before query. Vector charts and thematic vector maps cannot be
queried. The results of the query will be displayed in the console window,
see <em><a href="r.what.html">r.what</a>, <a href="v.what.html">v.what</a></em>.</dd></li>
- <li><dd>Query vector map in edit mode</dd></li>
+ <li><dd>Query selected vector map in edit mode. The results of the query
+ will be displayed in a form that permits editing of the queried vector
+ attributes.</dd></li>
</ul>
<dt><img src="icons/grass2/pan.png">
@@ -380,7 +393,7 @@
<dt><img src="icons/grass2/zoom-more.png">
<em>Zoom options</em></dt>
-<dd>opens a dropdown menu that allows user to:<br>
+<dd>Opens a dropdown menu that allows user to:<br>
<ul>
<li>Zoom to match the extents of a selected map</li>
<li>Zoom to match the computational region (set with <em>g.region</em>)</li>
@@ -394,7 +407,7 @@
<dt><img src="icons/grass2/layer-raster-analyze.png">
<em>Analyze menu</em></dt>
-<dd>opens a dropdown menu with:<br>
+<dd>Opens a dropdown menu with:<br>
<ul>
<li> <dt><img src="icons/grass2/measure-length.png">
@@ -409,7 +422,8 @@
<em>Profile tool</em></dt>
<dd>Interactively create profile of a raster map. Profile transect is
drawn with the mouse in map display. The profile may be of the
- displayed map or a different map,
+ displayed map or a different map. Up to three maps can be profiled
+ simultaneously,
see <em><a href="gm_profile.html">Profile Tool help page</a></em>.</dd></li>
<li><dt><img src="icons/grass2/layer-raster-histogram.png">
@@ -418,7 +432,7 @@
see <em><a href="d.histogram.html">d.histogram</a></em>.</dd></li>
</ul>
-<dt><img src="icons/grass2/element-add.png">
+<dt><img src="icons/grass2/overlay-add.png">
<em>Add overlay</em></dt>
<dd>opens a dropdown menu that allows user to:<br>
@@ -444,15 +458,36 @@
</ul>
<dt><img src="icons/grass2/map-export.png">
- <em>Save display to PNG file</em></dt>
+ <em>Save display to graphic file</em></dt>
<dd>Save the visible image in map display to different raster graphic formats.</dd>
<dt><img src="icons/grass2/print.png">
<em>Print map</em></dt>
-<dd>Prints map on the UNIX <i>lpr</i> printer or PostScript device;
+<dd>Prints map on system native printer or PostScript device;
saves visible map display (including PostScript text and labels) to PDF
-or EPS file. Requires <tt>ghostscript</tt> for all output except EPS.</dd>
+or EPS file.</dd>
+<br>
+<dt><em>Map display mode</em></dt>
+<dd>Opens a dropdown menu for selecting different display mode<br>
+ <ul>
+ <li><dt><em>2D view mode</em></dt>
+ <dd>Normal GIS display. All active layers are composited and displayed
+ in 2D mode.</dd></li>
+
+ <li><dt><em>3D view mode</em></dt>
+ <dd>Experimental replacement for NVIZ. Displays all active layers in
+ 3D perspective using OpenGL. A new control panel opens to manage the
+ 3D view. 3D view can be zoomed, panned, rotated, and tilted. The
+ vertical exaggeration of rasters and 3D vectors can be set. Various
+ color and lighten settings are possible. Not yet functional for
+ Windows platforms</dd></li>
+
+ <li><dt><em>Digitize mode</em></dt>
+ <dd>Puts display into vector digitizing mode and opens a new digitizing
+ toolbar. The user can digitize a new map or edit an existing
+ map. Not yet functional for Windows platforms</dd></li>
+ </ul>
</dl>
<h2>CONFIGURATION</h2>
@@ -484,9 +519,8 @@
<h2>AUTHORS</h2>
-Head developer: Martin Landa, FBK-irst, Trento, Italy<br><br>
-
-Michael Barton,<br>
+Michael Barton, Arizona State University, USA<br>
+Martin Landa, FBK-irst, Trento, Italy<br>
Daniel Calvelo Aros,<br>
Jachym Cepicky
More information about the grass-commit
mailing list