[GRASSweb-list]bob: web/gdp/nviz nviz_panel_sdiff.html,NONE,1.1 nviz_quit.html,NONE,1.1 nviz_panel_sites.html,1.1,1.2 nviz_panel_surf.html,1.1,1.2 nviz_panel_vect.html,1.1,1.2 nviz_panel_what.html,1.1,1.2 nviz_script.html,1.1,1.2 nviz_startup.html,1.1,1.2

Fri Mar 26 11:07:27 EST 2004

Author: bob

Update of /grassrepository/web/gdp/nviz
In directory doto:/tmp/cvs-serv31543

Modified Files:
	nviz_panel_sites.html nviz_panel_surf.html 
	nviz_panel_vect.html nviz_panel_what.html nviz_script.html 
	nviz_startup.html nviz_state.html nviz_toc.html 
Added Files:
	nviz_panel_sdiff.html nviz_quit.html 
Log Message:
New NVIZ Documentation

--- NEW FILE: nviz_panel_sdiff.html ---
<html>

<head>
   <DEFANGED_meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
   <DEFANGED_meta name="GENERATOR" content="Mozilla/4.76 [de] (X11; U; Linux 2.2.16 i686) [Netscape]">
   <title>GRASS 5.0 Tutorial for nviz</title>
</head>

<body bgcolor="#FFFFFF" link="#0000DF" vlink="#006000">

<h1><DEFANGED_IMG src="grass.smlogo.gif">NVIZ Reference Manual</h1>
<hr width="100%" align=center size=4 noshade>
<p>
<a href="nviz_toc.html">CONTENTS</a>
</p>

<h2>Scaled Difference Panel</h2>


<p>The <strong>Scaled Difference</strong> panel lets you exaggerate the distance between multiple surfaces. This exaggeration does not effect the surface properties and intersection points.</p>

<DEFANGED_IMG src="nvimg/panel/scale_diff.gif" alt="Scaled Difference Panel" width="288" height="126">

<h3>OPTIONS</h3>

<dl>

<dt> <strong>Reference Surface</strong></dt>
<dd>Shows the name(s) of all the loaded surfaces. Use this menu to select the reference surface. 
<br><br></dd>

<dt> <strong>Exag</strong></dt>
<dd>Sets the exaggeration difference between the reference and other surfaces.
<br><br></dd>

<dt> <strong>None</strong></dt>
<dd>Turns off the scaled difference and unselects the reference surface.
<br><br></dd>

<dt> <strong>Close</strong></dt>
<dd>Closes the <strong>Scaled Difference</strong> panel.
<br><br></dd>

</dl>


</body>
</html>
--- NEW FILE: nviz_quit.html ---
<html>

<head>
   <DEFANGED_meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
   <DEFANGED_meta name="GENERATOR" content="Mozilla/4.76 [de] (X11; U; Linux 2.2.16 i686) [Netscape]">
   <title>GRASS 5.0 Tutorial for nviz</title>
</head>
<body bgcolor="#FFFFFF" link="#0000DF" vlink="#006000">

<h1><DEFANGED_IMG src="grass.smlogo.gif">NVIZ Reference Manual</h1>
<hr width="100%" align=center size=4 noshade>
<p>
<a href="nviz_toc.html">CONTENTS</a>
</p>


<h2>Reset</h2>

<p>Resets <strong>NVIZ</strong> to default values.</p> 

<h2>Quit</h2>

<p>Exits the program and closes all <strong>NVIZ</strong> windows.</p> 

</body>
</html>
Index: nviz_panel_sites.html
===================================================================
RCS file: /grassrepository/web/gdp/nviz/nviz_panel_sites.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- nviz_panel_sites.html	23 Jul 2002 08:44:18 -0000	1.1
+++ nviz_panel_sites.html	26 Mar 2004 16:07:25 -0000	1.2
@@ -1,61 +1,85 @@
 <html>
+
 <head>
    <DEFANGED_meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
    <DEFANGED_meta name="GENERATOR" content="Mozilla/4.76 [de] (X11; U; Linux 2.2.16 i686) [Netscape]">
-<title>GRASS 5.0 Tutorial for nviz</title>
- </head>
+   <title>GRASS 5.0 Tutorial for nviz</title>
+</head>
+
 <body bgcolor="#FFFFFF" link="#0000DF" vlink="#006000">
 
-<P>
-<A HREF="nviz_toc.html">INDEX</A>
-</P>
+<h1><DEFANGED_IMG src="grass.smlogo.gif">NVIZ Reference Manual</h1>
+<hr width="100%" align=center size=4 noshade>
+<p>
+<a href="nviz_toc.html">CONTENTS</a>
+</p>
 
-<h3>NVIZ - Sites</h3>
-</A> <P>
+<h2>Sites Panel</h2>
 
-Use <A HREF="#SiteP">Site</A> panel options to manage sites to be
-drawn.  After options are set, click on <strong>Sites</em></strong> in
-the <em>Movement</em></strong> panel to see the results.  <p>
 
-<h3>
-<DEFANGED_IMG SRC="nvimg/panel/sites.gif"> <A NAME="SiteP">Site Panel</A> 
-</h3>  <P>
+<p>The <strong>Sites</strong> panel controls how sites files are displayed.</p>
 
-<strong>New: </em></strong> Load a new site file. This button pops up
-a <strong>File Browser</em></strong>window (see below) which allows
-the selection of a new site file.  <p>
+<DEFANGED_IMG src="nvimg/panel/sites.gif" alt="Sites Panel" width="294" height="202">
 
-<strong>Delete: </em></strong>Delete current site file.  <p>
+<h3>OPTIONS</h3>
 
-<strong>Current: </em></strong>displays name of currently selected
-site file.  Pressing the left mouse button over the name causes a menu
-of all available site files to appear. A new current site can be
-selected from this menu.  <p>
+<dl>
 
-<strong>Site Size:</em></strong> Select size of site markers using
-slider or type in a value in text entry box.  <p>
+<dt> <strong>Current</strong></dt>
+<dd>Shows the name(s) of all the loaded sites files. You can use this menu to select a new current sites file.<br><br></dd>
 
-<strong>Line Width:</em></strong> Width (in pixels) to draw site
-lines.  <p>
+<dt> <strong>New</strong></dt>
+<dd>Loads a new sites file. 
+<br><br></dd>
 
-<strong>use X: </em></strong>Use an X to mark site locations.  <p>
+<dt> <strong>Delete</strong></dt>
+<dd>Deletes (unload) the current sites file.
+<br><br></dd>
 
-<strong>use sphere: </em></strong>Use an sphere to mark site
-locations.  <p>
+<dt> <strong>Site Size</strong></dt>
+<dd>Sets the size of the current sites file markers.
+<br><br></dd>
 
-<strong>use diamond: </em></strong>Use an diamond to mark site
-locations.  <p>
+<dt> <strong>Line Width</strong></dt>
+<dd>Sets the width (in pixels) of the line used to draw the site markers. This option only applies to the <strong>use X</strong> site marker.<br><br></dd>
 
-<strong>3D Sites: </em></strong>Use third field of sites as z value
-for marker position. (When selected file is a 3d site file.)  <p>
+</dl>
+<p>
+There are three site markers available for displaying sites files.
+</p>
 
-<strong>color:</em></strong> Use a <em>Select Color
-</em></strong>popup (see below) select color used to for drawing
-current site file.  <p>
+<dl>
+<dd>
+<dl>
+<dt> <strong>use X</strong></dt>
+<dd>Sets the current sites file markers to an X.<br><br></dd>
 
-<strong>Display on surfaces: </em></strong>A list of toggle buttons
-for each available surface. Current site will be drawn on each of the
-surfaces whose button is activated.  <P>
+<dt> <strong>use sphere</strong></dt>
+<dd>Sets the current sites file markers to a solid sphere.<br><br></dd>
 
-</BODY>
-</HTML>
\ No newline at end of file
+<dt> <strong>use diamond</strong></dt>
+<dd>Sets the current sites file markers to a solid diamond.<br><br></dd>
+</dl></dd>
+
+<dt><strong>3D Sites</strong></dt>
+<dd>Displays the site markers at an elevation obtained from the Z dimension of the 3D sites file. Your selected sites file must be in a <strong>GRASS</strong> 3D sites format for this option to work.<br><br></dd>
+
+<dt><strong>Display on surface(s)</strong></dt>
+<dd>Draws the current sites file draped over the selected surface(s). 
+A list of available surfaces appears directly below <strong>Display on surface(s)</strong>. 
+<br><br></dd>
+
+<dt><strong>Color</strong></dt>
+<dd>Sets the color of the current sites file markers.<br><br></dd>
+
+<dt><strong>Draw Current</strong></dt>
+<dd>Draws the current sites file.<br><br></dd>
+
+<dt><strong>Close</strong></dt>
+<dd>Closes the <strong>Sites</strong> panel.<br><br></dd>
+
+</dl>
+
+
+</body>
+</html>
\ No newline at end of file

Index: nviz_panel_surf.html
===================================================================
RCS file: /grassrepository/web/gdp/nviz/nviz_panel_surf.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- nviz_panel_surf.html	23 Jul 2002 08:44:18 -0000	1.1
+++ nviz_panel_surf.html	26 Mar 2004 16:07:25 -0000	1.2
@@ -1,138 +1,180 @@
 <html>
+
 <head>
    <DEFANGED_meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
    <DEFANGED_meta name="GENERATOR" content="Mozilla/4.76 [de] (X11; U; Linux 2.2.16 i686) [Netscape]">
-<title>GRASS 5.0 Tutorial for nviz</title>
- </head>
+   <title>GRASS 5.0 Tutorial for nviz</title>
+</head>
+
 <body bgcolor="#FFFFFF" link="#0000DF" vlink="#006000">
 
-<P>
-<A HREF="nviz_toc.html">INDEX</A>
-</P>
+<h1><DEFANGED_IMG src="grass.smlogo.gif">NVIZ Reference Manual</h1>
+<hr width="100%" align=center size=4 noshade>
+<p>
+<a href="nviz_toc.html">CONTENTS</a>
+</p>
 
-<h3>NVIZ - Surfaces</h3>
-</A><p>
+<h2>Surface Panel</h2>
 
-Use <A HREF="#SurfaceP">Surface</A> panel options to manage surfaces
-to be drawn.  The top half of the panel contains options for drawing
-style. The bottom half is used to add and delete surfaces and change
-attributes on the current surface.  After options are set, click on
-<em>Surface</em></strong> in the <em>Movement</em></strong> panel to
-see the results.  <p>
+<p>The <strong>Surface</strong> panel controls how loaded surfaces are drawn. The top half of the panel has drawing style options. The bottom half has options to add, delete, select, and change attributes of the current surface.</p> 
 
-<h3>
-<DEFANGED_IMG SRC="nvimg/panel/surf.gif"> <A NAME="SurfaceP">Surface Panel</A>
-</h3>
+<DEFANGED_IMG src="nvimg/panel/surf.gif" alt="Surface Panel" width="292" height="238">
 
-<DL>
+<h3>OPTIONS</h3>
 
-<DT> <B>Grid Resolution</B>
-<DD> sets number of cells between grid lines when drawing wire grids
-(in both <em>fast display mode</em></strong> and
-<em>Draw</em></strong> mode).  A larger grid resolution number
-produces a more sparse grid.  <p>
+<dl>
 
-<DT> <B>Poly Resolution</B>
-<DD> sets number of cells to be used as dimensions of each polygon
-drawn when drawing polygons.  Each drawn polygon actually represents
-(Poly Res x Poly Res) cells.  <p>
+<dt> <strong>Surface Style</strong></dt>
+<dd>Sets the style for drawing the final surface.
+<br><br></dd>
 
-<DT> <B>Current Surface Only</B>
-<DD> Option changes effect currently selected surface only.  <P>
+<dd> 
+	<dl>
+	<dt> <strong>Wire</strong></dt>
+	<dd>Draws the surface as a wire mesh.  
+	This differs from the mesh drawn in <strong><em>fast display mode</em></strong>
+	(see <strong>Grid Style</strong>) because hidden lines are not drawn.
+	<br><br></dd>
+	<dt> <strong>Polygon</strong></dt>
+	<dd>Draws the surface using filled polygons (most realistic).
+	<br><br></dd> 
+	<dt> <strong>Wire/Poly</strong></dt>
+	<dd>Draws the surface using filled polygons, but with wire mesh draped over it.
+	<br><br></dd> 
+	</dl>
+</dd>
 
-<DT> <B>All Surfaces</B>
-<DD> Option changes effect all surfaces.  <P>
+<dt> <strong>Grid Style</strong></dt>
+<dd>Sets the style for drawing the <strong><em>fast display mode</em></strong> surface.
+<br><br></dd>
+<dd> 
+	<dl>
+	<dt> <strong>Wire</strong></dt>
+	<dd>Draws the grid (<strong><em>fast display mode</em></strong>) as a wire mesh.  
+	<br><br></dd>
+	<dt> <strong>Coarse Surface</strong></dt>
+	<dd>Draws the grid (<strong><em>fast display mode</em></strong>) using coarse resolution filled polygons. 
+	This is a low resolution version of the <em>Polygon</em>
+	surface style. The decimation factor is set from the 
+	<em>Grid Resolution</em> (see above).
+	<br><br></dd> 
+	</dl>
+</dd>
 
-<DT> <B>Surface Style</B>
-<DD> 
-	<DL>
-	<DT> <B>Polygon</B>
-	<DD> draw surface using filled polygons (most realistic). 
+<dt><strong>Shading</strong></dt>
+<dd>Sets the style of shading used for the surface.
+<br><br></dd>
+<dd> 
+	<dl>
+	<dt> <strong>Gouraud</strong></dt>
+	<dd>Draws the surfaces with a smooth shading to blend 
+	individual cell colors together.<br><br></dd>
+	<dt><strong>Flat</strong></dt>
+	<dd>Draws the surfaces with flat shading with one color for every two cells. The surface appears faceted.<br><br></dd>
+	</dl>
+</dd> 
 
-	<DT> <B>Wire</B>
-	<DD> draw surface with a wire mesh.  This differs from the
-	mesh drawn in <em>fast display mode</em></strong> in that hidden lines
-	are not drawn.
 
-	<DT> <B>Wire/Poly</B>
-	<DD> draw surface as polygons, but with wire mesh draped over it. 
-</DL> <P>
+<dt> <strong>Grid Resolution</strong></dt>
+<dd>Sets the resolution of the coarse surface (default) or wire mesh. 
+To switch between coarse surface and wire mesh select <strong>Grid Style</strong> (see below).
+<br><br></dd>
 
-<DT> <B>Shading</B>
-<DD> 
-<DL>
-	<DT> <B>Gouraud</B>
-	<DD> smooth shade surface to blend individual cell colors together.
+<dt> <strong>Polygon Resolution</strong></dt>
+<dd>Sets the resolution of the final surface. 
+The resolution is a function of the current <strong>GRASS</strong> region. 
+For example, a resolution of 1 draws every raster cell in the current region.
+<br><br></dd>
 
-	<DT> <B>Flat</B>
-	<DD> Surfaces are drawn with flat shading. One color for each
-	of the two triangles that form a cell. The surface will appear faceted.
-</DL> <P>
+<dt> <strong>Current Surface Only</strong></dt>
+<dd>Applies resolution changes to the currently selected surface only.
+<br><br></dd>
 
-<DT> <B>Current</B>
-<DD> displays name of currently selected surface. Pressing the left
-mouse button over the name causes a menu of all available surfaces to
-appear. A new current surface can be selected from this menu.  <P>
+<dt> <strong>All Surfaces</strong></dt>
+<dd>Applies resolution changes to all loaded surfaces.<br><br></dd>
 
-<DT> <B>New</B>
-<DD> Load a new surface. This button pops up a <strong>Change
-Attribute </em></strong>window (see below) which allows the selection
-of a new map or constant for a surface.  <P>
 
-<DT> <B>Delete</B>
-<DD> Delete current surface. This merely unloads surface data. <em>
-nviz </em></strong> will not change any files that exist in your
-<strong>GRASS</em></strong> database.  <p>
+<dt> <strong>Current</strong></dt>
+<dd>Shows the name(s) of all the loaded surfaces. You can use this menu to select a new current surface.<br><br></dd>
 
-<DT> <B>No Zeros</B>
-<DD> do not draw surface where elevation data values are zero. The
-second <em>No Zeros </em></strong>toggle causes areas where the color
-values are zero not to be drawn.  <p>
+<dt> <strong>New</strong></dt>
+<dd>Loads a new surface or surface constant. 
+<br><br></dd>
 
-<DT> <B>Wire Color</B>
-<DD> Select a wire color for current surface with a <strong>Select
-Color </em></strong>popup (see below).  <p>
+<dt> <strong>Delete</strong></dt>
+<dd> Deletes (unload) the current surface.
+<br><br></dd>
 
-<DT> <B>Position</B>
-<DD> change x, y, and z position of current surface using
-<strong>Position Surface </em></strong>popup window (see below).  <p>
 
-<DT> <B>Draw Current</B>
-<DD> render only the current surface using the given rendering
-parameters.  <P>
+<dt> <strong>Surface Attribute</strong></dt>
+<dd> You can use this menu to control the attributes of the current surface.
+<br><br></dd>
 
-</DL> <P>
 
-The rest of the buttons on this panel control attributes of the
-current surface.  The current value of that attribute appears to the
-right of the attribute button. Clicking on an attribute button pops up
-a <em>Change Attribute </em></strong>window (see below) which allows
-the selection of a new map or constant for that attribute.  <p>
-<DL>
+<dd>
+	<dl>
+	<dt> <strong>topography</strong></dt>
+	<dd>Loads a new raster or constant value to use as elevation (z values) for the current surface.
+	<br><br></dd>
 
-<DT> <B>Topography</B>
-<DD> Map or constant which controls elevation (z values) of surface.
-<p>
+	<dt> <strong>color</strong></dt>
+	<dd>Loads a raster or constant color to drape over the current surface.
+	This option is useful for draping imagery such as aerial photography over a DEM.
+	<br><br></dd>
 
-<DT> <B>Color</B>
-<DD> Map or constant which controls surface color.  <p>
+	<dt> <strong>mask</strong></dt>
+	<dd>Loads a raster or constant that controls the areas displayed from the current surface.
+	<br><br></dd>
 
-<DT> <B>Mask</B>
-<DD> Map or constant which controls which areas of surface are drawn.
-<p>
+	<dt> <strong>transparency</strong></dt>
+	<dd>Loads a raster or constant that controls the transparency of the current surface.
+	The default is completely opaque.
+	<br><br></dd>
 
-<DT> <B>Transparency</B>
-<DD> Map or constant which controls transparency level of surface (all
-opaque is default).  <p>
+	<dt> <strong>shininess</strong></dt>
+	<dd>Loads a raster or constant that controls the shininess (reflectivity) of the current surface.
+	<br><br></dd>
 
-<DT> <B>Shininess</B>
-<DD> Map or constant which controls shininess (reflectivity) of
-surface material.  <p>
+	<dt> <strong>emission</strong></dt>
+	<dd>Loads a raster or constant that controls the light emitted from the current surface.
+	<br><br></dd>
+	</dl>
+</dd>
 
-<DT> <B>Emission</B>
-<DD> Map or constant which controls light emitted from surface.  <p>
+<dt> <strong>Wire Color</strong></dt>
+<dd>Sets a wire color for the current surface.
+The color can be a constant or set from the current surface color.
+<br><br></dd>
 
-</DL> <P>
+<dt> <strong>Position</strong></dt>
+<dd>Changes the x, y, and z position of the current surface.
+<br><br></dd>
 
-</BODY>
-</HTML>
+
+<dt> <strong>Mask Zeros by</strong></dt>
+<dd>Masks the current surface where elevation or color values are equal to zero.
+<br><br></dd>
+
+<dd>
+	<dl>
+	<dt> <strong>Elevation</strong></dt>
+	<dd>Masks elevation values equal to zero. The second <strong>No Zeros</strong> masks color values equal to zero.
+	<br><br></dd>
+	<dt> <strong>Color</strong></dt>
+	<dd>Masks color values equal to zero.
+	<br><br></dd>
+	</dl>
+</dd>
+
+<dt> <strong>Draw Current</strong></dt>
+<dd>Draws the current surface.
+<br><br></dd>
+
+<dt> <strong>Close</strong></dt>
+<dd>Closes the <strong>Surface</strong> panel.
+<br><br></dd>
+
+</dl> 
+
+</body>
+</html>

Index: nviz_panel_vect.html
===================================================================
RCS file: /grassrepository/web/gdp/nviz/nviz_panel_vect.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- nviz_panel_vect.html	23 Jul 2002 08:44:18 -0000	1.1
+++ nviz_panel_vect.html	26 Mar 2004 16:07:25 -0000	1.2
@@ -1,48 +1,79 @@
 <html>
+
 <head>
    <DEFANGED_meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
    <DEFANGED_meta name="GENERATOR" content="Mozilla/4.76 [de] (X11; U; Linux 2.2.16 i686) [Netscape]">
-<title>GRASS 5.0 Tutorial for nviz</title>
- </head>
+   <title>GRASS 5.0 Tutorial for nviz</title>
+</head>
+
 <body bgcolor="#FFFFFF" link="#0000DF" vlink="#006000">
 
-<P>
-<A HREF="nviz_toc.html">INDEX</A>
-</P>
+<h1><DEFANGED_IMG src="grass.smlogo.gif">NVIZ Reference Manual</h1>
+<hr width="100%" align=center size=4 noshade>
+<p>
+<a href="nviz_toc.html">CONTENTS</a>
+</p>
 
-<h3>NVIZ - Vectors</h3>
-</A> <P>
+<h2>Vector Panel</h2>
 
-Use <A HREF="#VectorP">Vector</A> panel options to manage vectors to
-be drawn.  After options are set, click on
-<strong>Vectors</em></strong> in the <em>Movement</em></strong> panel
-to see the results.  <p>
+<p>The <strong>Vector</strong> panel controls how vectors are displayed.
+</p> 
 
-<h3>
-<DEFANGED_IMG SRC="nvimg/panel/vect.gif"> <A NAME="VectorP">Vector Panel</A>
-</h3>  <P>
+<DEFANGED_IMG src="nvimg/panel/vect.gif" alt="Vector Panel" width="291" height="193">
 
-<strong>New: </em></strong> Load a new vector file. This button pops
-up a <strong>File Browser</em></strong> window (see below) which allows
-the selection of a new vector file.  <p>
+<h3>OPTIONS</h3>
 
-<strong>Delete: </em></strong>Delete current vector file.  <p>
+<dl>
+<dt> <strong>Current:</strong></dt>
+<dd>Shows the name(s) of all the loaded vectors. You can use this menu to select a new current vector.<br><br></dd>
 
-<strong>Current: </em></strong>displays name of currently selected
-vector file.  Pressing the left mouse button over the name causes a
-menu of all available vector files to appear. A new current vector can
-be selected from this menu.  <p>
+<dt> <strong>New</strong></dt>
+<dd>Loads a new vector file. 
+<br><br></dd>
 
-<strong>Line Width:</em></strong> Width (in pixels) to draw vector
-lines.  <p>
+<dt> <strong>Delete</strong></dt>
+<dd>Deletes (unload) the current vector.
+<br><br></dd>
 
-<strong>Color:</em></strong> Use a <em>Select Color
-</em></strong>popup (see below) select color used to for drawing
-current vector file.  <p>
+<dt> <strong>Line Width</strong></dt>
+<dd>Sets the width (in pixels) of the current vector.
+<br><br></dd>
 
-<strong>Display on surfaces: </em></strong>A list of toggle buttons for each 
-available surface. Current vector will be drawn on each of the surfaces 
-whose button is activated.  <P>
+<dt> <strong>Color</strong></dt>
+<dd>Sets the color of the current vector.
+<br><br></dd>
 
-</BODY>
-</HTML>
\ No newline at end of file
+</dl>
+
+<p>
+You can display a vector flat at a specified elevation or drape it over a surface(s) at a specified height.
+Use the <strong>Vect. Z</strong> scale to set the flat elevation or the drape height above the surface(s).
+</p>
+
+<dl>
+<dt> <strong>Display Flat</strong></dt>
+<dd>Draws the current vector on a flat plane at the elevation set by 
+the <strong>Vect. Z</strong> scale.
+<br><br></dd>
+
+<dt> <strong>Display on surface(s)</strong></dt>
+<dd>Draws the current vector draped over the selected surface(s) at the height set by the
+<strong>Vect. Z</strong> scale. 
+A list of available surfaces appears directly below <strong>Display on surface(s)</strong>. Use this list to select the surfaces for draping the vectors over.
+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).
+<br><br></dd>
+
+
+<dt> <strong>Vect. Z</strong></dt>
+<dd>Sets either the flat elevation or the drape height above the surface(s) (depending on which option is selected).<br><br></dd>
+
+<dt> <strong>Draw Current</strong></dt>
+<dd>Draws the current vector file.<br><br></dd>
+
+<dt> <strong>Close</strong></dt>
+<dd>Closes the <strong>Vector</strong> panel.<br><br></dd>
+
+</dl>
+
+</body>
+</html>
\ No newline at end of file

Index: nviz_panel_what.html
===================================================================
RCS file: /grassrepository/web/gdp/nviz/nviz_panel_what.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- nviz_panel_what.html	23 Jul 2002 08:44:18 -0000	1.1
+++ nviz_panel_what.html	26 Mar 2004 16:07:25 -0000	1.2
@@ -1,42 +1,127 @@
 <html>
+
 <head>
    <DEFANGED_meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
    <DEFANGED_meta name="GENERATOR" content="Mozilla/4.76 [de] (X11; U; Linux 2.2.16 i686) [Netscape]">
-<title>GRASS 5.0 Tutorial for nviz</title>
- </head>
+   <title>GRASS 5.0 Tutorial for nviz</title>
+</head>
+
 <body bgcolor="#FFFFFF" link="#0000DF" vlink="#006000">
 
-<P>
-<A HREF="nviz_toc.html">INDEX</A>
-</P>
+<h1><DEFANGED_IMG src="grass.smlogo.gif">NVIZ Reference Manual</h1>
+<hr width="100%" align=center size=4 noshade>
+<p>
+<a href="nviz_toc.html">CONTENTS</a>
+</p>
 
-<H3>NVIZ - What's Here</H3>
-</A> <P>
+<h2>What's Here Panel</h2>
 
-The <A HREF="#WhatsP">What's Here</A> panel operates like the
-<strong>GRASS</em></strong> program <em>d.what.rast</em></strong>, you
-use the mouse to mark spots on the surface that you would like more
-information about.  After clicking on the surface, data prints to the
-text box in the panel.  First, the name of the surface clicked on is
-printed then the geographical coordinates.  Next, elevation is
-bi-linearly interpolated from the current polygon resolution and this
-is printed (setting the resolution to 1 will produce the most accurate
-elevation). xy distance from previous and xyz distance from previous
-are straight line distances, whereas distance along surface and
-distance along exag surface are computed as the length of a path
-draped across the surface.  Each time you select a point, a marker is
-drawn on the surface at the point selected with a line connecting it
-to the previous point.  To stop selecting points toggle the
-<strong>What's here?</em></strong> button.  <p>
+<p>The <strong>What's Here</strong> panel lets you interactively query surfaces, vectors and sites displayed in the <strong>NVIZ</strong> viewer.
+Query results appear in the <strong>What's Here</strong> text box.
+You can also pipe results directly to a text file.
+Query points appear in the <strong>NVIZ</strong> viewer as icons.
+</p>
 
-<H3>
-<DEFANGED_IMG SRC="nvimg/panel/whats.gif"> <A NAME="WhatsP">What's Here Panel</A>
-</H3> <P>
+<DEFANGED_IMG src="nvimg/panel/whats.gif" alt="What's Here Panel" width="292" height="284">
 
-<strong>Separate</em></strong> places a separating line at current
-text position.  <p>
+<h3>OPTIONS</h3>
 
-<strong>Clear</em></strong> clears text window.  <p>
+<dl>
+<dt> <strong>What's Here?</strong></dt>
+<dd>Turns the <strong>What's Here</strong> interactive query on and off.
+<br><br></dd>
 
-</BODY>
-</HTML>
\ No newline at end of file
+<dt> <strong>Attributes</strong></dt>
+<dd>Lets you select optional output query attributes. 
+<br><br>
+<DEFANGED_IMG src="nvimg/panel/whats_options.gif" alt="What's Here Options" width="143" height="182">
+<br><br></dd>
+<dd> 
+	<dl>
+	<dt> <strong>Map Name</strong></dt>
+	<dd>Names the query map (surface) used.
+	<br><br></dd>
+	<dt> <strong>Easting</strong></dt>
+	<dd>Provides the easting of the query point.
+	<br><br></dd> 
+	<dt> <strong>Northing</strong></dt>
+	<dd>Provides the northing of the query point.
+	<br><br></dd> 
+	<dt> <strong>Elevation</strong></dt>
+	<dd>Provides the elevation of the query point.
+	<br><br></dd>
+	<dt> <strong>Color Category</strong></dt>
+	<dd>Provides the surface color (as RGB) of the query point.
+	<br><br></dd>
+	<dt> <strong>XY Dist from Prev</strong></dt>
+	<dd>Provides the horizontal distance (XY) between the current and the previous query points.
+	<br><br></dd>
+	<dt> <strong>XYZ Dist from Prev</strong></dt>
+	<dd>Provides the actual distance (XYZ) between the current and the previous query points.
+	<br><br></dd>
+	<dt> <strong>Dist Along Surface</strong></dt>
+	<dd>Provides the overland (draped) distance between the current and the previous query points.
+	If selected, a line draws between the current and the previous query points.
+	<br><br></dd>
+	<dt> <strong>Dist Along Exag Surface</strong></dt>
+	<dd>Provides the overland (draped) distance between the current and the previous query points using vertically exaggerated elevations. The vertical exaggeration used in this calculation comes from the surface <strong>zexag</strong> value. If selected, a line draws between the current and the previous query points.
+	<br><br></dd>
+	<dt> <strong>Postgres</strong></dt>
+	<dd>Queries the selected (g.select.pg) database based on results from the current query point.
+	<br><br></dd>
+</dl></dd>
+
+<dt> <strong>Reset</strong></dt>
+<dd>Adds a horizontal line to the query output.
+<br><br></dd>
+
+<dt> <strong>Clear</strong></dt>
+<dd>Clears the <strong>What's Here</strong> panel text box (query results).
+<br><br></dd>
+
+
+<dt> <strong>Query vector</strong></dt>
+<dd>Uses the query results from selected vector (see Query map) to query a selected (g.select.pg) Postgres database.
+<br><br></dd>
+
+<dt> <strong>Query sites</strong></dt>
+<dd>Uses the query results from selected sites file (see Query map) to query a selected (g.select.pg) Postgres database.
+<br><br></dd>
+
+<dt> <strong>Query map</strong></dt>
+<dd>Selects the file (vector or sites) to use for the Postgres query. If you select <strong>Query vector</strong>, provide a vector file name. If you select <strong>Query sites</strong>, provide a sites file name.
+<br><br></dd>
+
+<dt> <strong>PG Table</strong></dt>
+<dd>Enter the name of the Postgres table. The table must be in the currently selected Postgres database.
+<br><br></dd>
+
+<dt> <strong>key col</strong></dt>
+<dd>Enter the name of the column in the Postgres table. The column must be in the currently selected table.
+<br><br></dd>
+
+<dt> <strong>Xcol</strong></dt>
+<dd>Enter the name of the easting column in the selected Postgres table. Use only with the <strong>Query sites</strong> option.
+<br><br></dd>
+
+<dt> <strong>Ycol</strong></dt>
+<dd>Enter the name of the northing column in the selected Postgres table. Use only with the <strong>Query sites</strong> option.
+<br><br></dd>
+
+<dt> <strong>Dist</strong></dt>
+<dd>Enter the radius from the selected query point to search the Postgres <strong>Xcol</strong> and <strong>Ycol</strong>. In other words, return all of the database records within the set distance from the selected point.
+<br><br></dd>
+
+<dt> <strong>Pipe to</strong></dt>
+<dd>Outputs query results to a user defined text file.
+<br><br></dd>
+
+<dt> <strong>Close</strong></dt>
+<dd>Closes the <strong>What's Here</strong> panel.
+<br><br></dd>
+
+</dl>
+
+
+</body>
+</html>
\ No newline at end of file

Index: nviz_script.html
===================================================================
RCS file: /grassrepository/web/gdp/nviz/nviz_script.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- nviz_script.html	23 Jul 2002 08:44:18 -0000	1.1
+++ nviz_script.html	26 Mar 2004 16:07:25 -0000	1.2
@@ -1,572 +1,39 @@
 <html>
+
 <head>
    <DEFANGED_meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
    <DEFANGED_meta name="GENERATOR" content="Mozilla/4.76 [de] (X11; U; Linux 2.2.16 i686) [Netscape]">
-<title>GRASS 5.0 Tutorial for nviz</title>
- </head>
-<body bgcolor="#FFFFFF" link="#0000DF" vlink="#006000">
-
-<P>
-<A HREF="nviz_toc.html">INDEX</A>
-</P>
-
-<H3>Scripting</H3>
-</A> <P>
-
-<H4>NVIZ - Introduction</H4> <P>
-
-Sometimes it is desirable to automatically generate arbitrarily
-complicated changes to Nviz when creating an animation.  The tools
-presented so far allow the user to create camera movement as well as
-add custom animation channels (e.g. the cut plane channel) to the
-key frame animator.  However, the user would be required to add several
-complex channels to the key frame animator to capture the most general
-behavior.  The purpose of the scripting environment is to allow the
-user to develop a one-time script file which can handle arbitrarily
-complex changes to the Nviz environment.  Script files are extremely
-application dependent and, in general, will not be usable with other
-applications.  However, they are the most convenient mechanism for
-capturing specific behavior quickly.  <P>
-
-Scripting is controlled by the commands provided in the scripting
-pulldown menu (see <A HREF="#ScriptPulldown">figure</A> below).  By
-default, when scripting has been activated every user event in Nviz is
-recorded and output to a script saved as a text file.  This script
-file may be played back in Nviz by using the <I>Play Script</I> option
-in the menu.  Thus, most scripts are simply a carbon copy of the user
-performing certain actions.  Scripting can become more powerful,
-however, by adding loops around a sequence of script events, or by
-using higher-level tools.  The more advanced features of scripting are
-described in the <A HREF="#ScriptTools">Script Tools</A> section below.
-The next section is devoted to describing basic scripting.  Be sure to
-read this section carefully as the discussion of advanced features
-assumes the knowledge of this material.
-<P>
-
-<H3>
-<DEFANGED_IMG SRC="nvimg/work/script_pulldown.gif">
-<A NAME="ScriptPulldown"> Script Pulldown Menu</A>
-</H3>
-
-<H4>Basic Scripting</H4> <P>
-
-Basic scripting entails designating a script file, turning scripting
-on and off, and sending commands directly to the script.  Before doing
-anything with scripting it is necessary to designate a script file.
-This is done by selecting the <I>Scriptfile</I> option in the script
-pulldown menu.  The user is queried for a file to use as the new
-script file.  If the designated file already exists then scripting
-will overwrite the old contents of the file.
-<P>
-
-Once a script file has been selected, scripting is turned on and off by
-selecting the <I>On</I> radio button in the scripting menu.  The status
-of this radio button indicates whether or not scripting is active.  As
-soon as scripting becomes active, literally everything the user does
-is recorded in the script file.  Since this can lead to extremely large
-script files, it is suggested that scripting be turned on only when the
-next few user events are critical to the script.  When you are
-finished adding commands to the script, select <I>Close Script</I> to
-close the script file.
-<P>
-
-To make the script files somewhat more legible and useful, two
-additional commands are available in basic scripting: <I>Add Script
-Line</I> and <I>Add Script Cmd</I>.  The difference between these two
-commands is subtle but important.  We will delay a discussion of the
-differences between these two commands for now.  For our purposes, the
-difference between these two commands is as follows: <I>Add Script
-Line</I> adds a command directly to the script being written and will
-not affect the state of Nviz; <I>Add Script Cmd</I> adds a command to
-the script which <B>will</B> affect the state of Nviz.  A script in
-Nviz is really a Tcl script with a slightly specialized format.
-Hence, legal script commands are things like comments marked with the
-<B>#</B> character, expressions like <B>set i [expr $i + 1]</B>, and
-so on.  <I>Add Script Line</I> is intended to add commands which
-directly affect the Tcl code in the script.  Thus comments can be
-added making scripts more readable, variables may be accessed, and
-conditionals may be inserted allowing the script to select different
-execution paths depending on script variables.  Commands added by
-<I>Add Script Cmd</I> may also be Tcl commands.  However, these
-commands are executed directly in the Nviz environment and affect the
-current state of Nviz directly (but <B>do not</B> affect the state of
-the script).  Thus commands like <B>Nsurf10001 set_att topo
-y90o.1</B>, which will set the topology attribute of a particular
-surface to a particular file, are meaningful commands to add.
- <P>
-
-The combination of <I>Add Script Line</I> and <I>Add Script Cmd</I>
-provide the most general tools for controlling script files short of
-directly editing the text of a script.  It is expected that these
-commands will rarely be used.  However, <I>Add Script Line</I> in
-particular is useful for placing comments to separate distinct
-portions of a script and make the overall script file more readable.
- <P>
-
-<H4>
-<A NAME="ScriptTools">Script Tools</A>
-</H4>
- <P>
-
-The <I>Script Tools</I> menu selection pops up the script tools menu
-which provides higher level script manipulation facilities.  It is
-possible to do everything a script tool does by using <I>Add Script
-Line</I> and <I>Add Script Cmd</I> described above.  However, the
-script tools are much more convenient and should be used instead.
-Currently, there are three types of tool covering the five selections
-in the script tool popup.  <I>Open Loop</I> and <I>Close Loop</I>
-allow iteration using a numeric loop variable.  <I>Open File
-Seq. Loop</I> and <I>Close File Seq. Loop</I> allow iteration over a
-series of files.  Finally, the <I>File Sequence Tool</I> allows very
-general iteration over a variety of attributes associated with
-surface, vector and site maps.  Be sure that scripting has been turned
-on (by selecting <I>On</I>) before using a script tool.  The <I>File
-Sequence Tool</I> does not necessarily require scripting to be on, but
-for now we assume scripting has been activated.
-<P>
-
-<H5><I>Open and Close Loop</I></H5> <P>
-
-The simplest tool is the <I>Open/Close Loop</I> pair.  This tool
-defines a loop variable given the name <B>lpX</B> where X is the
-current loop being defined (starting with 1).  The loop variable is
-iterated over a numeric range as specified by the user.  The user may
-add commands (using <I>Add Script Line</I>) which reference the loop
-variable.  The most general functionality provided by this tool is the
-ability to repeat some script activity a specified number of times.
-<P>
-
-A simple <I>Open/Close Loop</I> is created as follows:
-<UL>
-<LI> Select <I>Open Loop</I> from the script tools menu.
-<LI> Fill in numeric values for "Loop Start Value", "Loop End Value"
-and "Loop Increment Value" in the resulting popup (see <A HREF="#SimpLoopP">
-figure</A> below), and press "Accept".
-<LI> Continue scripting as usual adding all activities over which you
-wish to iterate.
-<LI> Close the loop by selecting <I>Close Loop</I> from the script
-tools menu.
-</UL>
- <P>
-
-<H5>
-<A NAME="SimpLoopP">
-<DEFANGED_IMG SRC="nvimg/work/SimpLoop.gif"> Simple Loop Popup
-</A>
-</H5> <P>
-
-Note that simple loops may be nested by repeating the above process
-from within a simple loop.  Each additional loop uses the same naming
-scheme, thus the outer loop will be <B>lp1</B>, the first nested loop
-is <B>lp2</B> and so on.  Internally a stack of loop names is
-maintained so that selecting <I>Close Loop</I> closes the most
-recently opened loop.
- <P>
-
-<H5><I>Open and Close File Seq. Loop</I></H5> <P>
-
-Simple open/close loops work well when looping behavior is relatively
-simple.  However, simple loops are restricted to iterating over
-numeric values.  A common scenario is for some map object in the scene
-to display a sequence of map files.  That is, we need to be able to
-iterate over lists of files.  The <I>Open/Close File Seq. Loop</I>
-pair provide this functionality.  This tool, when activated, forces
-any mapBrowser activities within the scope of the loop to use the
-current loop iteration value rather than the value entered by the user
-when the script is created.  Creating a file loop is slightly awkward
-but follows these basic steps:
-
-<UL>
-<LI> Select <I>Open File Seq. Loop</I> from the script tools menu.
-<LI> Select a sequence of files using the Map Browser tool (see
-<A HREF="#FBrowseP">figure</A> below), and press "Done".
-<LI> Continue scripting as usual adding all activities over which you
-wish to iterate.
-<LI> If you wish to apply the file sequence to a particular map,
-modify the appropriate map as if you were loading a file from the file
-sequence (see the <A HREF="#FileSeqEx">example</A> below).
-<LI> Close the loop by selecting <I>Close File Seq. Loop</I> from the
-script tools menu.
-</UL>
- <P>
-
-<H5>
-<A NAME="FBrowseP">
-<DEFANGED_IMG SRC="nvimg/work/FBrowse.gif"> File Sequence Loop Popup
-</A>
-</H5>
- <P>
-
-Like simple loops, file sequence loops may be nested as well as mixed
-with simple loops (make sure that you use the appropriate "Close"
-button however!).  File sequence loops use a naming scheme similar to
-simple loops.  File sequence iteration values can be accessed using
-the variable <B>lseqX</B> where X starts at 1 for the first loop and
-increments by 2 for consecutive loops (thus the next loop is 3, then
-5, and so on).  <P>
-
-To help clarify how the file sequence loop value can automatically be
-used by map browser activities, consider the following explicit
-example:
- <P>
-
-<A NAME="FileSeqEx"></A>
-Suppose we want the topology of a surface map to sequence over a list
-of files (for example, the four file sequence shown in the map browser
-image above).  We can use the file sequence loop tool to do this as
-follows: 
-<OL>
-<LI> Turn on scripting as usual.
-<LI> Set up the state of Nviz just prior to iterating over the list of
-files.  This includes loading the surface we wish to modify during
-the loop. 
-<LI> Open the file sequence loop with <I>Open File Seq. Loop</I>.
-<LI> Select the list of files we wish to iterate over as above.
-<LI> Load some arbitrary file into the topology attribute of the
-surface we wish to modify in the loop.
-<LI> Close the file sequence loop with <I>Close File Seq. Loop</I>.
-</OL>
- <P>
-
-When the script event corresponding to changing topology (step 5
-above) is replayed in Nviz, the current value of the file sequence
-loop is used instead of the value supplied during script creation.
-Thus, during each iteration of the loop the topology attribute is set
-to the current value of the file sequence loop.
- <P>
-
-Be aware that the file sequence loop affects <B>all</B> map browser
-activities within the scope of the loop.  Thus <B>any</B> script
-events added within the scope of a loop which also require a map
-browser will have their value replaced during script playback with the
-current value of the file loop.  
- <P>
-
-<H5><I>File Sequence Tool</I></H5> <P>
-
-<H5><B>Introduction</B></H5> <P>
-
-The final script tool, the <I>File Sequence Tool</I>, is the most
-complicated but also the most flexible.  This tool is designed to
-allow iteration over several attributes of several maps in Nviz.
-Unlike the two previous tools, the <I>File Sequence Tool</I> is
-capable of automatically producing a stand-alone script file which can
-be played back within Nviz.  <P>
-
-Creating a script using the <I>File Sequence Tool</I> consists of two
-major steps: creating a state file, and creating a file sequence.
-State files were discussed in the appropriate section above.  For the
-purposes of scripting, the <I>File Sequence Tool</I> can use a state
-file as a basis for the script it creates.  Usually, the user sets up
-Nviz in a configuration just prior to the beginning of file iteration
-and saves the state of Nviz.  The script created by the <I>File
-Sequence Tool</I> can then load this state file automatically before
-performing file iteration.  The <A HREF="#FSToolEx">example</A> below
-should help clarify these activities.  For now, let us take a detailed
-look at the <I>File Sequence Tool</I> control window. <P>
-
-The <I>File Sequence Tool</I> control window is activated by selecting
-<I>File Sequence Tool</I> from the script tools popup:
- <P>
-
-<H5>
-<A NAME="FSToolImg"></A>
-<DEFANGED_IMG SRC="nvimg/work/FSTool.gif"> File Sequence Tool Window
-</H5>
- <P>
-
-The <I>File Sequence Tool</I> operates on the concept of
-<B>fields</B>.  A field identifies some attribute of a surface,
-vector, or site map which will be modified during an animation.  The
-lower area of the <I>File Sequence Tool</I> is used to display all the
-fields currently set.  In the example above, a single field is defined
-which modifies the topography attribute of a surface in Nviz.  The
-buttons under <I>Fields:</I> are used to manipulate the current list
-of fields.  Pressing <I>Add</I> will create a new field.  Pressing
-<I>Delete</I> will allow the user to delete one of the fields.  The
-<I>State:</I> button is used to determine the state file which the
-current fields will use a basis for script creation.
- <P>
-
-Before we discuss how to add fields, it is important to understand
-what types of fields may be added and how they may be changed.  As
-mentioned before, a field identifies some attribute of a surface,
-vector or site map that we wish to change during each frame of an
-animation.  For surfaces, we can modify the attributes topography,
-color, mask, transparency, shininess, and emission.  For vectors and
-sites, we can only modify the current file.  Furthermore, there are at
-least three simple ways we can change a field inbetween frames: we can
-load a new file in the place of the current file; we can <I>unset</I>
-the field so that it has no value; and we can leave the field
-unchanged.  The <I>File Sequence Tool</I> supports all of the
-attributes we have listed plus the three simplest ways of changing
-these attributes inbetween frames.  
- <P>
-
-<H5><B>Adding Fields</B></H5> <P>
-
-Adding a field is a two step process: the user must decide which
-attribute of which surface, vector or site to modify; and the user
-must specify the list of changes to the selected attribute.  Pressing
-the <I>Add</I> button creates the following popup:
- <P>
-
-<H5>
-<DEFANGED_IMG SRC="nvimg/work/AddField.gif">
-Add Button Popup</H5> <P>
-
-<I>Field Type:</I> refers to the type of map object this field will
-modify.  Valid selections are <I>Surface</I>, <I>Vector</I> or
-<I>Site</I>.  <I>Field Attribute:</I> refers to what attribute of the
-given type the new field will modify.  For surfaces, valid selections
-are <I>Topography</I>, <I>Color</I>, <I>Mask</I>, <I>Transparency</I>,
-<I>Shininess</I>, and <I>Emission</I>.  For vectors or sites, the only
-valid selections is <I>File</I>.  <I>Set From:</I> refers to a
-surface, vector or site file in the <B>current</B> session of Nviz
-which will be used as the placeholder for changes in the new field.
-When a script is created, the <I>Set From</I> map object has the
-specified attribute changed according to the new field.  Thus, the
-<I>Set From</I> map object should also be stored in the state file
-used by this file sequence.
- <P>
-
-After selecting an appropriate type, attribute and source map object,
-clicking <I>Accept</I> creates the file browser popup:
- <P>
-
-<H5>
-<DEFANGED_IMG SRC="nvimg/work/FSToolBrowse.gif">
-Field File List Popup</H5> <P>
-
-Normally, the file browser will have no selected files.  However, for
-the sake of illustration we have already selected a few files in the
-image above.  The <B>MAPSETS</B> and <B>FILES</B> lists operate just
-as in the <I>Open/Close File Seq. Loop</I> tool above.  When a file is
-selected, its name is copied to the file list on the far right.  File
-names may be entered explicitly in the type-in field on the top.  The
-list of files on the far right indicates the sequence of changes the
-current field will undergo when a script is created.  Recall that the
-<I>File Sequence Tool</I> supports three mechanisms for changing a
-field between frames: load a new file, unset the field, or leave the
-field alone.  Selecting a file from the <B>FILES</B> list corresponds
-to loading a new file inbetween frames.  By pressing the <I>Blank</I>
-button, the field is directed to unset the field for the next frame.
-This is indicated by storing <I>-- blank --</I> as the next file in
-the file list.  By pressing the <I>Previous</I> button, the field is
-directed to make no changes to the field and use the setting for the
-previous frame.  This is indicated by storing <I>(NO CHANGE) ***</I>
-where <I>***</I> is the previous entry in the file list.
- <P>
-
-For example, in the image above the file list changes can be described
-as follows:
-<OL>
-<LI> <I>a1.masked at helena</I> is loaded.
-<LI> Nothing is changed for frame 2.
-<LI> The current field is <I>unset</I> and will not be displayed.
-<LI> <I>a3.masked at helena</I> is loaded.
-<LI> <I>as.2m100 at helena</I> is loaded.
-</OL>
- <P>
-
-The <I>Remove</I> button removes the selected file entry from the file
-list.  The <I>Done</I> button is used to indicate that you are
-finished creating the file sequence for the current field.  Clicking
-<I>Cancel</I> will backup to the <I>Add Button Popup</I>.  Clicking
-<I>Cancel</I> on the <I>Add Button Popup</I> will cancel the creation
-of a new field.
- <P>
-
-The file sequence for a particular field may be changed even after it
-has been added to the field list.  Each field in the <I>File Sequence
-Tool Window</I> contains a button which indicates the type of map
-object this field modifies (see the <A HREF="#FSToolImg">image</A>
-above).  Clicking this button pops up the file browser as above except
-that the list of files is initialized to the current file list for the
-selected field.
- <P>
-
-<H5><B>Saving Fields</B></H5> <P>
-
-A particular configuration of fields can be saved for later editing by
-using the <I>Load Fields...</I> and <I>Save Fields...</I> options
-under the <I>Options:</I> heading.  <I>Save Fields...</I> will save
-all of the current field configurations plus the name of the
-associated state file for later user.  Conversely, <I>Load
-Fields...</I> will load a configuration of fields.  Note that, in
-order to edit a group of fields in a different Nviz session, it will
-be necessary to re-load the state of Nviz that existed when the
-original fields were created.  This is necessary so that the map
-objects which the original fields referenced will be present in the
-system if these fields are changed.
- <P>
-
-<H5><B>Building a Script</B></H5> <P>
-
-Once the user has created all the necessary fields for a particular
-script, it is possible to create a playable script file.  There are
-two ways script information can be created: script information can be
-written to a script currently being created, or a separate,
-stand-alone script can be created.  In either case, the script code
-created will only create the changes indicated by the given fields
-over the given number of frames.  Extra code, such as code necessary
-for rendering and saving images after each frame, must be added
-separately.  Since adding image saving code is a frequent activity, a
-comment is added to the code produced by the <I>File Sequence Tool</I>
-to aid the user in determining where to add code.
- <P>
-
-Clicking <I>Add To Script</I> will add code to the current active
-script which will invoke the changes indicated by the field files.
-Make sure that scripting has been turned on (see above) before using
-this option.
- <P>
-
-Clicking <I>Build Script...</I> will build a stand-alone script file.
-Stand-alone scripts first load the state file, then the field changes
-are executed as specified by the field descriptions.  As usual, code
-must be added to the script to render images and save them to files.
- <P>
-
-<H5><B>Example</B></H5> <P>
-
-The following step-by-step example should help clarify the creation of
-a script using the <I>File Sequence Tool</I>.
- <P>
-
-<!-- Create an example of file tool scripting here -->
-<A NAME="FSToolEx"></A>
-
-For this example, we will specify one surface with a vector and site
-file overlayed on top of it.  At each frame, we will change the
-topography and color attributes of the surface, and the overlay files
-for the sites map.  This animation will be a stand-alone animation.
-Recall that creating an animation with the <I>File Seq. Tool</I>
-requires two major steps: creating a state file and creating the field
-specifications.  Since we will need all the appropriate maps loaded
-into Nviz before we can create the field specifications, we will go
-ahead and create the state file first:
- <P>
+   <title>GRASS 5.0 Tutorial for nviz</title>
+</head>
 
-<OL>
-<LI> Start up Nviz with "nviz -q".
-<LI> Add the surface "y90o.1 at helena" by pressing <I>New</I> on the
-surface panel.
-<LI> Position the camera so that the surface is in full view.
-<LI> Add the vector map "shore.ascii at helena" by pressing <I>New</I> on
-the vector panel.
-<LI> Set the vector map so that it overlays the surface we added in
-step 2 above.
-<LI> Add the sites map "y90mo.1 at helena" by pressing <I>New</I> on the
-sites panel.
-<LI> Set the sites map so that it overlays the surface we added in step
-2 above.
-<LI> Set an appropriate size for the sites map.
-<LI> Save the state of Nviz by selecting <I>Save State...</I> from the
-<I>File</I> menu and choosing an appropriate name.
-</OL>
- <P>
+<body bgcolor="#FFFFFF" link="#0000DF" vlink="#006000">
 
-At this point, we have established the state of Nviz before our
-animation will begin.  State files provide a convenient encapsulation
-of the state of Nviz just prior to beginning animation.  In fact, we
-may alter state files independently of the scripts which require them
-as long as we do not change the map objects required by each script.
-This allows users to modify such features as colors, positioning, line
-sizes, lighting, etc. without having to remake scripts.
- <P>
+<h1><DEFANGED_IMG src="grass.smlogo.gif">NVIZ Reference Manual</h1>
+<hr width="100%" align=center size=4 noshade>
+<p>
+<a href="nviz_toc.html">CONTENTS</a>
+</p>
 
-The next step is to set up the frame changes for the animation.  We
-will require three fields: one to modify surface topography, one to
-modify surface color, and one to modify the sites source file.  For
-the sake of brevity, our animation will only be five frames long.  We
-can create the field changes as follows:
- <P>
+<h2>Scripting</h2>
 
-<OL>
-<LI> Load the script tools by selecting <I>Script Tools</I> under the
-<I>Scripting</I> menu.
-<LI> Press the <I>File Sequence Tool</I> button on the script tools
-popup.
-<LI> Press the <I>Add</I> button under <I>Fields:</I> in the <I>File
-Sequence Tool</I>.
-<LI> Be sure that <I>Field Type:</I> is set to <I>Surface</I>,
-<I>Field Attribute:</I> is set to <I>Topography</I> and <I>Set
-From:</I> is set to "y90o.1 at helena", then press <I>Accept</I>.
-<LI> In the file browser popup, select the sequence of files:
-<UL>
-<LI> y90o.1 at helena
-<LI> y90o.2 at helena
-<LI> y90o.3 at helena
-<LI> y90o.4 at helena
-<LI> y90o.5 at helena
-</UL>
-and click <I>Done</I>.
-<LI> We have just created the five frame changes for the topography
-attribute.  Repeat steps 4 and 5 except set <I>Field Attribute:</I> to
-<I>Color</I>.  This creates the five frame changes for the color attribute.
-<LI> Repeat steps 4 and 5 except set <I>Field Type:</I> to <I>Site</I>.
-In the file browser popup , select the sequence of files:
-<UL>
-<LI> y90mo.1 at helena
-<LI> y90mo.2 at helena
-<LI> y90mo.3 at helena
-<LI> y90mo.4 at helena
-<LI> y90mo.5 at helena
-</UL>
-<LI> Finally, set the state file to the file you saved in state
-creation above.  State file is set by pressing the <I>State File:</I>
-button under <I>Fields:</I>.
-</OL>
- <P>
 
-At this point, the <I>File Sequence Tool</I> display should look
-something like the following:
- <P>
+<h3>NVIZ - Introduction</h3>
+<P><strong>NOTE:</strong> The scripting tools are still under developemnt. A number of the functions in these menus are not yet fully functional.
+</p>
 
-<H5>
-<DEFANGED_IMG SRC="nvimg/work/FSToolExample.gif">
-File Sequence Tool Example</H5>
- <P>
+<p>The scripting environment lets you develop a one-time script file that can handle 
+complex changes to the <strong>NVIZ</strong> environment.</p>
 
-It may be wise to save your progress up to this point by clicking
-<I>Save Fields...</I> and choosing an appropriate file name.  Saving
-the fields configuration is also a convenient way to use the same
-state file with different fields settings.  For example, we could
-later modify our fields settings above by changing the list of files
-used in the frame sequence, adding new fields, etc.
- <P>
+<p>Scripting is controlled by the commands provided in the scripting
+pulldown menu.  A script
+file can be played back in Nviz by using the <em>Play Script</em> option
+in the menu.  Scripting can become more powerful,
+however, by adding loops around a sequence of script events, or by
+using higher-level tools.  
+</p>
 
-Since we are generating a stand-alone script, press the <I>Build
-Script...</I> button and choose an appropriate file name for the new
-script.  We will now edit the script so that it will render each frame
-after the field changes have been made.  Load the script file into
-your favorite editor and do the following:
- <P>
 
-<OL>
-<LI> Find the line with the comment "# Put image saving code here".
-It is after this line that we will add commands to render frames.
-<LI> Add the following four lines after the comment <B>exactly</B> as
-they appear here:
-<PRE>
-     SendScriptLine "Nsurf_draw_all"
-     SendScriptLine "Nvect_draw_all"
-     SendScriptLine "Nsite_draw_all"
-     after 1000
-</PRE>
-<LI> Re-save the script file.
-</OL>
- <P>
 
-The four lines we have added are instructions to Nviz to render the
-all surface, vector and site files, then wait approximately one second
-before going on to the next frame.  The <I>SendScriptLine</I> command
-is described in the next section.  At this point, the script is purely
-stand-alone and can be played from within nviz.  To play the script
-select <I>Play Script</I> from the <I>Scripting</I> menu and choose
-the script file you saved above.  After a brief bit of initialization,
-the script will execute the field changes we specified above.
 
-</BODY>
-</HTML>
+</body>
+</html>

Index: nviz_startup.html
===================================================================
RCS file: /grassrepository/web/gdp/nviz/nviz_startup.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- nviz_startup.html	23 Jul 2002 08:44:18 -0000	1.1
+++ nviz_startup.html	26 Mar 2004 16:07:25 -0000	1.2
@@ -1,44 +1,71 @@
 <html>
+
 <head>
    <DEFANGED_meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
    <DEFANGED_meta name="GENERATOR" content="Mozilla/4.76 [de] (X11; U; Linux 2.2.16 i686) [Netscape]">
-<title>GRASS 5.0 Tutorial for nviz</title>
- </head>
+<title>NVIZ Manual</title>
+</head>
+
 <body bgcolor="#FFFFFF" link="#0000DF" vlink="#006000">
 
-<P>
-<A HREF="nviz_toc.html">INDEX</A>
-</P>
+<h1><DEFANGED_IMG src="grass.smlogo.gif">NVIZ Reference Manual</h1>
+<hr width="100%" align=center size=4 noshade>
+<p>
+<a href="nviz_toc.html">CONTENTS</a>
+</p>
 
-<h3>NVIZ - Startup</h3>
-</A> <P>
+<h2>Startup</h2>
 
-The syntax for starting the program is: <p>      
+<p>The syntax for starting <strong>NVIZ</strong> is:</p> 
 
-<strong>nviz [-q]
-[elevation=</strong><em>name[,name,...]</em><strong>]
-[vector=</strong><em>name[,name,...]</em><strong>]
-[sites=</strong><em>name[,name,...]</em><strong>]</strong>
+<p><strong><em>nviz [-q]
+[elevation=name[,name,...]] [vector=name[,name,...]] [sites=name[,name,...]] [state=name] [script=name]</em></strong></p>
 
-<P> <STRONG>-q </STRONG> Quickstart.  Skip over <STRONG>GRASS</STRONG>
-parsing and immediately start nviz.
+<h3>Flag:</h3> 
 
-<p> <strong>elevation</strong> (optional) name of a
-<strong>GRASS</strong> raster file (or files) to use as elevation
+<dl>
+<dt><strong>-q</strong></dt>
+<dd>Quickstart. Skips <strong>GRASS</strong>
+parsing and immediately starts <strong>NVIZ</strong>.</dd>
+</dl>
 
-<p> <strong>vector</strong> (optional) name of a
-<strong>GRASS</em></strong> vector file (or files).
+<h3>Parameters</h3>
+<dl>
+<dt><strong>elevation</strong></dt>
+<dd>Enter the name of a <strong>GRASS</strong> raster file(s) to load as elevation.
+</dd>
 
-<p> <strong>sites</strong> (optional) name of a
-<strong>GRASS</em></strong> sites list file (or files).
- <P>
+<dt><strong>vector</strong></dt>
+<dd>Enter the name of a <strong>GRASS</strong> vector file(s) to load.
+</dd>
 
-If the user types <em>nviz</em></strong> on the command line without
-any arguments, the program will prompt the user for the arguments.
-<p>
+<dt><strong>sites</strong></dt>
+<dd>Enter name of a <strong>GRASS</strong> sites file(s) to load.
+</dd>
 
-</BODY>
-</HTML>
+<dt><strong>state</strong></dt>
+<dd>Enter the name of a previously saved <strong>NVIZ</strong> state file. 
+</dd>
 
+<dt><strong>script</strong></dt>
+<dd>Enter the name of <strong>NVIZ</strong> script file to execute. 
+</dd>
+</dl>
 
+<p>If you type <strong><em>nviz</em></strong> on the command line without
+any arguments, the program prompts you for the arguments.</p>
 
+<p>After startup, you have two windows:
+<ul>
+<li>The <strong>NVIZ</strong> viewer (the main window that displays the scene)</li>
+<li>The <strong>Controls</strong> window (where you can change and set display options)</li>
+</ul>
+</p>
+
+<p>
+By default, the <strong>Controls</strong> window always appears with the <a href="nviz_panel_move.html"><strong>Movement</strong> panel</a> open.
+All other panels open below the <strong>Movement</strong> panel.
+</p>
+
+</body>
+</html>
\ No newline at end of file

Index: nviz_state.html
===================================================================
RCS file: /grassrepository/web/gdp/nviz/nviz_state.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- nviz_state.html	23 Jul 2002 08:44:18 -0000	1.1
+++ nviz_state.html	26 Mar 2004 16:07:25 -0000	1.2
@@ -1,43 +1,43 @@
 <html>
+
 <head>
    <DEFANGED_meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
    <DEFANGED_meta name="GENERATOR" content="Mozilla/4.76 [de] (X11; U; Linux 2.2.16 i686) [Netscape]">
-<title>GRASS 5.0 Tutorial for nviz</title>
- </head>
+   <title>GRASS 5.0 Tutorial for nviz</title>
+</head>
 <body bgcolor="#FFFFFF" link="#0000DF" vlink="#006000">
 
-<P>
-<A HREF="nviz_toc.html">INDEX</A>
-</P>
+<h1><DEFANGED_IMG src="grass.smlogo.gif">NVIZ Reference Manual</h1>
+<hr width="100%" align=center size=4 noshade>
+<p>
+<a href="nviz_toc.html">CONTENTS</a>
+</p>
 
-<H3>NVIZ - Nviz State</H3>
-</A> <P>
 
-It is often desirable and convenient to save some configuration of
-Nviz for use in other applications.  For example, each session of Nviz
-might require the same set of maps or other attributes.  To allow
-persistence between sessions, Nviz provides tools for saving and
-loading the current "state" of the system.  These tools are accessed
-using the <I>Load State</I> and <I>Save State</I> options under the
-<I>File</I> menu.  <P>
+<h2>State</h2>
 
-<I>Save State</I> records the current status of Nviz, including all
-current maps, color settings, camera viewpoint, and so on into a user
-designated file.  This state file may then be reloaded at a later time
-and will restore the state of Nviz.  <I>Load State</I> queries the
-user for a state file to load and modifies the state of Nviz according
-to the state file.  Note that <I>Load State</I> does not erase the
-current state of Nviz when loading a new state.  Instead, the current
-state is augmented according to the contents of the state file.  Since
-this can sometimes cause unexpected results, it is best to either
-restart Nviz or manually reset the state of Nviz before loading a
-state file.  <P>
+<p>For each session of <strong>NVIZ</strong>, you might want the same set of maps,
+view parameters, or other attributes.  
+For consistency between sessions, <strong>NVIZ</strong> provides tools for saving and
+loading the current &#034;state&#034; of the system.  To access these tools, on the <strong>File</strong> menu, use <strong>Load State</strong> and <strong>Save State</strong>.</p> 
 
-State files are particularly useful when creating scripts for animation
-(see <A HREF="#ScriptingP">scripting</A> below).  In particular, a
-predefined Nviz state can be loaded automatically into a script by
-turning on scripting and performing the activity of loading the new
-state.  <P>
 
-</BODY>
-</HTML>
\ No newline at end of file
+<DEFANGED_IMG src="nvimg/panel/file_menu.gif" alt="File Menu" width="302" height="323">
+
+<h2>Load State</h2>
+<p>
+Loads a previously saved <strong>NVIZ</strong> state file. The <strong>Controls</strong> window settings change to the newly loaded state.
+You can also load an <strong>NVIZ</strong> state file at startup using the &#034;state=&#034;
+<a href="nviz_startup.html">command line option</a>.
+</p>
+
+
+<h2>Save State</h2>
+<p>
+Records the current status of <strong>NVIZ</strong>, including all
+current maps, color settings, and camera viewpoint into a user
+defined file.
+</p>  
+
+</body>
+</html>
\ No newline at end of file

Index: nviz_toc.html
===================================================================
RCS file: /grassrepository/web/gdp/nviz/nviz_toc.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- nviz_toc.html	23 Jul 2002 08:44:18 -0000	1.1
+++ nviz_toc.html	26 Mar 2004 16:07:25 -0000	1.2
@@ -1,46 +1,70 @@
 <html>
+
 <head>
-   <DEFANGED_meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
-   <DEFANGED_meta name="GENERATOR" content="Mozilla/4.76 [de] (X11; U; Linux 2.2.16 i686) [Netscape]">
-<title>GRASS 5.0 Tutorial for nviz</title>
- </head>
+<DEFANGED_meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+<DEFANGED_meta name="GENERATOR" content="Mozilla/4.76 [de] (X11; U; Linux 2.2.16 i686) [Netscape]">
+<title>NVIZ Reference Manual - Table of Contents</title>
+</head>
+
 <body bgcolor="#FFFFFF" link="#0000DF" vlink="#006000">
 
+<h1><DEFANGED_IMG src="grass.smlogo.gif">NVIZ Reference Manual</h1>
+<hr width="100%" align=center size=4 noshade>
 
-<h1>
-<a href="http://www.geog.uni-hannover.de/grass/"><DEFANGED_IMG SRC="grass.smlogo.gif"></a>
-NVIZ Tutorial 
-</h1><p>
+<h2>CONTENTS</h2> 
 
-<H3>Contents</H3>  <P>
+<h3>Introduction</h3>
+<ul>
+<li><a href="nviz_desc.html">Description</a></li>
+<li><a href="nviz_startup.html">Startup</a></li>
+</ul>
 
-<MENU>
-<LI> <A HREF="nviz_desc.html">Description</A>
-<LI> <A HREF="nviz_general.html">General Notes</A>
-<LI> <A HREF="nviz_startup.html">Startup</A>
-<LI> Panels
-<MENU>
-<LI> <A HREF="nviz_panel_move.html">Movement</A>
-<LI> <A HREF="nviz_panel_lights.html">Lights</A>
-<LI> <A HREF="nviz_panel_surf.html">Surfaces</A>
-<LI> <A HREF="nviz_panel_vect.html">Vectors</A>
-<LI> <A HREF="nviz_panel_site.html">Sites</A>
-<LI> <A HREF="nviz_panel_color.html">Background Color</A>
-<LI> <A HREF="nviz_panel_cplane.html">Cut planes</A>
-<LI> <A HREF="nviz_panel_anim.html">Basic Animation</A>
-<LI> <A HREF="nviz_panel_what.html">What's Here</A>
-<LI> <A HREF="nviz_panel_dsf.html">Mkdspf</A>
-</MENU>
-<LI> <A HREF="nviz_misc.html">Miscellaneous</A>
-<LI> Advanced Features
-<MENU>
-<LI> <A HREF="nviz_state.html">Nviz State</A>
-<LI> <A HREF="nviz_anim.html">Key frame Animation</A>
-<LI> <A HREF="nviz_script.html">Scripting</A>
-</MENU>
-<LI> <A HREF="nviz_hints.html">Hints</A>
-<LI> <A HREF="nviz_credit.html">Credits/Inquiries</A>
-</MENU>
+<h3>Controls</h3>
+<ul>
+<li>File
+<ul>
+<li><a href="nviz_state.html">Load State</a></li>
+<li><a href="nviz_state.html">Save State</a></li>
+<li><a href="nviz_3dsetting.html">Load 3d Settings</a></li>
+<li><a href="nviz_3dsetting.html">Save 3d Settings</a></li>
+<li><a href="nviz_image.html">Image Dump</a></li>
+<li><a href="nviz_quit.html">Reset</a></li>
+<li><a href="nviz_quit.html">Quit</a></li>
+</ul></li>
+<li>Panel
+<ul>
+<li> <a href="nviz_panel_move.html">Movement</a></li>
+<li> <a href="nviz_panel_surf.html">Surface</a></li>
+<li> <a href="nviz_panel_vect.html">Vector</a></li>
+<li> <a href="nviz_panel_sites.html">Sites</a></li>
+<li> <a href="nviz_panel_lights.html">Lighting</a></li>
+<li> <a href="nviz_panel_color.html">Color</a></li>
+<li> <a href="nviz_panel_cplane.html">Cutting Planes</a></li>
+<li> <a href="nviz_panel_anim.html">Animation</a></li>
+<li> <a href="nviz_panel_kanim.html">Keyframe Animation</a></li>
+<li> <a href="nviz_panel_what.html">What's Here?</a></li>
+<li> <a href="nviz_panel_dsf.html">Mkdspf</a></li>
+<li> <a href="nviz_panel_sdiff.html">Scaled Difference</a></li>
+<li> <a href="nviz_panel_labels.html">Label</a></li>
+<li> <a href="nviz_panel_scale.html">Scale</a></li>
+<li> <a href="nviz_panel_pos.html">Position</a></li>
+</ul></li>
+<li>Scripting
+<ul>
+<li><a href="nviz_script.html">On</a></li>
+<li><a href="nviz_script.html">Scriptfile</a></li>
+<li><a href="nviz_script.html">Script Tools</a></li>
+<li><a href="nviz_script.html">Add Script Line</a></li>
+<li><a href="nviz_script.html">Add Script Cmd</a></li>
+<li><a href="nviz_script.html">Play Script</a></li>
+<li><a href="nviz_script.html">Close Script</a></li>
+</ul></li>
+<li>Help<br></li>
 
-</BODY>
-</HTML>
\ No newline at end of file
+<li> <a href="nviz_hints.html">Hints</a></li>
+<li> <a href="nviz_credit.html">Credits/Inquiries</a></li>
+<li> <a href="bugs_todo.html">NVIZ Bugs / ToDo</a></li>
+</ul>
+
+</body>
+</html>



