Geografic-Information-System/gui/wxpython/docs/wxGUI.Nviz.html

<h2>DESCRIPTION</h2>

Note: <b>wxNviz is currently under development. Not
all functionality is implemented.</b>

<p>
<b>wxNviz</b> is a <em><a href="wxGUI.html">wxGUI</a></em> <b>3D view
mode</b> which allows users to realistically render multiple
<em>surfaces</em> (raster data) in a 3D space, optionally using
thematic coloring, draping 2D <em>vector</em> data over the surfaces,
displaying 3D vector data in the space, and visualization
of <em>volume</em> data (3D raster data).

<p>
To start the wxGUI 3D view mode, choose '3D view' from the map
toolbar.
<p>
wxNviz is emphasized on the ease and speed of viewer positioning and
provided flexibility for using a wide range of data. A low resolution
surface or wire grid (optional) provides real-time viewer positioning
capabilities. Coarse and fine resolution controls allow the user to
further refine drawing speed and detail as needed. Continuous scaling
of elevation provides the ability to use various data types for the
vertical dimension.

<p>
For each session of wxNviz, you might want the same set of 2D/3D
raster and vector data, view parameters, or other attributes. For
consistency between sessions, you can store this information in the
GRASS <em>workspace</em> file (gxw). Workspace contains information to
restore "state" of the system in 2D and if wxNviz is enabled also in
the 3D display mode.

<h2>3D View Toolbar</h2>

<center>
<br><img src="wxGUI_nviz_toolbar.jpg" border="1"><br><br>
</center>

<dl>
  <dt><img src="icons/grass2/3d-view.png">&nbsp;
    <em>Switch to view page</em></dt>
  <dd>Switch 3D Layer Manager Toolbox's page to the <b>view</b>
  control page.</dd>
  <dt><img src="icons/grass2/3d-raster.png">&nbsp;
    <em>Switch to surface page</em></dt>
  <dd>Switch 3D Layer Manager Toolbox's page to the <b>surface</b>
  control page (data properties).</dd>
  <dt><img src="icons/grass2/3d-vector.png">&nbsp;
    <em>Switch to vector page</em></dt>
  <dd>Switch 3D Layer Manager Toolbox's page to the <b>vector</b>
  control page (data properties).</dd>
  <dt><img src="icons/grass2/3d-volume.png">&nbsp;
    <em>Switch to volume page</em></dt>
  <dd>Switch 3D Layer Manager Toolbox's page to the <b>volume</b>
  control page (data properties).</dd>
  <dt><img src="icons/grass2/3d-light.png">&nbsp;
    <em>Switch to light page</em></dt>
  <dd>Switch 3D Layer Manager Toolbox's page to the <b>light</b>
  control page (appearance).</dd>
  <dt><img src="icons/grass2/3d-fringe.png">&nbsp;
    <em>Switch to fringe page</em></dt>
  <dd>Switch 3D Layer Manager Toolbox's page to the <b>fringe</b>
  control page (appearance).</dd>
  <dt><img src="icons/grass2/settings.png">&nbsp;
    <em>Show 3D view mode settings</em></dt>
  <dd>Show dialog with settings for wxGUI 3D view mode. The user
  settings can be stored in wxGUI settings file.</dd>
  <dt><img src="icons/grass2/help.png">&nbsp;
    <em>Show help</em></dt>
  <dd>Show this help.</dd>
  <dt><img src="icons/grass2/quit.png">&nbsp;
    <em>Quit</em></dt>
  <dd>Quit 3D view mode and switch map display to the 2D view
  mode.</dd>
</dl>

<h2>3D View Layer Manager Toolbox</h2>

The 3D view toolbox is integrated in the Layer Manager. The toolbox
has several tabs:

<ul>
  <li><b>View</b> for view controling,</li>
  <li><b>Data</b> for data properties,</li>
  <li><b>Appearance</b> for appearance settings (lighting, fringes, ...).</li>
</ul>

<h3>View</h3>

You can use this panel to set the <em>position, direction, and
  perspective</em> of the view. The position box shows a puck with a
  direction line pointing to the center. The direction line indicates
  the look direction (azimuth). You click and drag the puck to change
  the current eye position. The box annotations are North, South,
  East, and West. You can also set exact position using <em>Look
  at</em> choice control.

<center>
  <br><img src="wxGUI_nviz_tools_view.jpg" border="1"><br><br>
</center>

You can adjust the viewer's height above the scene, angle of view or
twist value to rotate the scene about the horizontal axis. An angle of
0 is flat. The scene rotates between -90 and 90 degrees.

<p>
You can also adjusts the vertical exaggeration of the surface. As an
example, if the easting and northing are in meters and the elevation
in feet, a vertical exaggeration of 0.305 would produce a true
(unexaggerated) surface.
  
<p>
<em>Reset</em> returns all current settings to their default values.

<h3>Data properties - Surface</h3>

Each active raster map layer from the current layer tree is displayed
as surface in the 3D space. Separate raster data or constants can be
used for various attributes of the surface:

<ul>
  <li><b>topography</b> - raster map or constant values used as elevation (z
    values) for the current surface.</li>
  <li><b>color</b> - raster map or constant color to drape over the current
    surface. This option is useful for draping imagery such as aerial
    photography over a DEM.</li>
  <li><b>mask</b> - raster map that controls the areas displayed from
    the current surface.</li>
  <li><b>transparency</b> - raster map or constant value that controls
    the transparency of the current surface. The default is completely
    opaque. Range from 0 (opaque) to 255 (transparent).</li>
  <li><b>shininess</b> - raster map or constant value that controls
    the shininess (reflectivity) of the current surface. Range from 0 to
    255.</li>
  <li><b>emission</b> - raster map or constant value that controls the
    light emitted from the current surface. Range from 0 to 255.</li>
</ul>

This panel controls how loaded surfaces are drawn. The top half of the
panel has options to set, unset or modify attributes of the current
surface. The bottom half has drawing style options, masking or
changing surface position in the space.

<center>
  <br><img src="wxGUI_nviz_tools_surface.jpg" border="1"><br><br>
</center>

Surface can be drawn as a wire mesh or using filled polygons (most
realistic). You can set draw <b>mode</b> to <em>coarse</em> (fast
display mode), <em>fine</em> (draws surface as filled polygons with
fine resolution) or <em>both</em> (which combines coarse and fine
mode). Additionally set coarse <b>style</b> to <em>wire</em> to draw
the surface as wire mesh (you can also choose color of the wire)
or <em>surface</em> to draw the surface using coarse resolution filled
polygons. This is a low resolution version of the polygon surface
style.

E.g. surface is drawn as a wire mesh if you set <b>mode</b>
to <em>coarse</em> and <b>style</b> to <em>wire</em>. Note that it
differs from the mesh drawn in fast display mode because hidden lines
are not drawn. To draw the surface using filled polygons, but with
wire mesh draped over it, choose <b>mode</b> <em>both</em>
and <b>style</b> <em>wire</em>.

Beside mode and style you can also choose style of <b>shading</b> used
for the surface. <em>Gouraud</em> style draws the surfaces with a
smooth shading to blend individual cell colors together, <em>flat</em>
draws the surfaces with flat shading with one color for every two
cells. The surface appears faceted.

<p>
To set given draw settings for all loaded surfaces press button "All".

<h3>Data properties - Vector</h3>

2D vector data can be draped on the selected surfaces with various
markers to represent point data; you can use attribute of vector
features to determine size, color, shape of glyph.

3D vector data including volumes (closed group of faces with one
kernel inside) is also supported.
This panel controls how loaded 2D or 3D vector data are drawn.

<p>
You can define the width (in pixels) of the line features, the color
used for lines or point markers.

<center>
  <br><img src="wxGUI_nviz_tools_vector.jpg" border="1"><br><br>
</center>

If vector map is 2D you can display vector features as flat at a
specified elevation or drape it over a surface(s) at a specified
height. Use the height control to set the flat elevation or the drape
height above the surface(s).

<p>
For display purposes, it is better to set the height slightly above
the surface. If the height is set at zero, portions of the vector may
disappear into the surface(s).

<p>
For 2D/3D vector points you can also set the size of the markers and
the width (in pixels) of the line used to draw the point markers (only
applies to wire-frame markers). Currently are implemented these
markers:

<ul>
  <li><b>x</b> sets the current points markers to a 2D "X",</li>
  <li><b>sphere</b> - solid 3D sphere,</li>
  <li><b>diamond</b> - solid 3D diamond,</li>
  <li><b>cube</b> - solid 3D cube,</li>
  <li><b>box</b> - hollow 3D cube,</li>
  <li><b>gyroscope</b> - hollow 3D sphere,</li>
  <li><b>asterisk</b> - 3D line-star.</li>
</ul>
 
<h3>Data properties - Volume</h3>

Volumes can be displayed either as isosurfaces or slices. Various
attributes of the isosurface can be defined, similarly to surface
attributes:

<ul>
  <li><b>level</b> - reference isosurface level (height in map
  units).</li>
  <li><b>color</b> - raster map or constant color to drape over the
  current volume.</li>
  <li><b>mask</b> - raster map that controls the areas displayed from
    the current volume.</li>
  <li><b>transparency</b> - raster map or constant value that controls
    the transparency of the current volume. The default is completely
    opaque. Range from 0 (opaque) to 255 (transparent).</li>
  <li><b>shininess</b> - raster map or constant value that controls
    the shininess (reflectivity) of the current volume. Range from 0 to
    255.</li>
  <li><b>emission</b> - raster map or constant value that controls the
    light emitted from the current volume. Range from 0 to 255.</li>
</ul>

<p>
This panel controls how loaded volumes are drawn. Volume can be drawn
in two different modes: <b>isosurface</b> or <b>slice</b>. The top
part of the panel has drawing style options. The middle part has
controls to add, delete, move up/down selected isosurface or
slices. The bottom part has options to set, unset or modify attributes
of the current isosurface or slice.

<center>
  <br><img src="wxGUI_nviz_tools_volume.jpg" border="1"><br><br>
</center>

Similarly to surface panel you can define draw <b>shading</b>
- <em>gouraud</em> (draws the volumes with a smooth shading to blend
individual cell colors together) and <em>flat</em> (draws the volumes
with flat shading with one color for every two cells. The volume
appears faceted). As mentioned above currently are supported two
visualization modes:

<ul>
  <li><b>isosurface</b> - the levels of values for drawing the
  volume(s) as isosurfaces,</li>
  <li>and <b>slice</b> - the levels of values for drawing the volume
  as cross-sections.</li>
</ul>

<h2>Settings</h2>

This panel has controls which allows user to set default surface,
vector and volume data attributes. You can also modify default view
parameters, or to set the background color of the Map Display Window
(the default color is white).


<h2>To be implement</h2>

<ul>
  <li>Improve intuitive navigation (mouse, fly mode)</li>
  <li>Animation capabilities</li>
  <li>Arbitrary cutting planes</li>
  <li>Labels, decoration, etc.</li>
  <li>Scripting capabilities</li>
  <li>Better workspace support (view settings, lighting)
  <li>Surface - mask by zero/elevation, more interactive positioning</li>
  <li>Vector points - implement display mode flat/surface for 2D points</li>
  <li>Volume - slice draw mode</li>
  <li>...</li>
</ul>

<p>
<b>Please note that wxNviz is under active development and
distributed as &quot;Experimental Prototype&quot;.</b>

<h2>SEE ALSO</h2>

<em>
  <a href="wxGUI.html">wxGUI</a>
</em>

<p>
Other wxGUI components:<br>
<em>
  <a href="wxGUI.Vector_Digitizer.html">Vector Digitizer</a><br>
  <a href="wxGUI.Attribute_Table_Manager.html">Attribute Table Manager</a><br>
  <a href="wxGUI.Modeler.html">Graphical Modeler</a><br>
  <a href="wxGUI.GCP_Manager.html">Manage Ground Control Points</a><br>
</em>

<p>
See also <a href="http://grass.osgeo.org/wiki/WxNVIZ">wiki</a> page.
<br><br>

Command-line module <em><a href="nviz_cmd.html">nviz_cmd</a></em>.
<br><br>

Original <a href="nviz.html">TCL/TK-based</a> Nviz.

<h2>AUTHORS</h2>

Martin
Landa, <a href="http://grass.osgeo.org/wiki/WxNviz_GSoC_2008">Google
Summer of Code 2008</a> (mentor: Michael Barton)
and <a href="http://grass.osgeo.org/wiki/WxNviz_GSoC_2010">Google
Summer of Code 2010</a> (mentor: Helena Mitasova)

<p>
<i>$Date$</i>