[GRASS-SVN] r48533 - grass/trunk/misc/m.nviz.script
svn_grass at osgeo.org
svn_grass at osgeo.org
Wed Sep 28 07:56:37 EDT 2011
Author: hamish
Date: 2011-09-28 04:56:37 -0700 (Wed, 28 Sep 2011)
New Revision: 48533
Added:
grass/trunk/misc/m.nviz.script/m.nviz.script.html
Removed:
grass/trunk/misc/m.nviz.script/d.nviz.html
Modified:
grass/trunk/misc/m.nviz.script/Makefile
grass/trunk/misc/m.nviz.script/main.c
Log:
rename d.nviz as m.nviz.script part 2 (placeholder for wx replacement)
Modified: grass/trunk/misc/m.nviz.script/Makefile
===================================================================
--- grass/trunk/misc/m.nviz.script/Makefile 2011-09-28 11:52:26 UTC (rev 48532)
+++ grass/trunk/misc/m.nviz.script/Makefile 2011-09-28 11:56:37 UTC (rev 48533)
@@ -1,6 +1,6 @@
MODULE_TOPDIR = ../..
-PGM = d.nviz
+PGM = m.nviz.script
LIBES = $(DISPLAYLIB) $(RASTERLIB) $(GISLIB) $(MATHLIB)
DEPENDENCIES = $(DISPLAYDEP) $(RASTERDEP) $(GISDEP)
Deleted: grass/trunk/misc/m.nviz.script/d.nviz.html
===================================================================
--- grass/trunk/misc/m.nviz.script/d.nviz.html 2011-09-28 11:52:26 UTC (rev 48532)
+++ grass/trunk/misc/m.nviz.script/d.nviz.html 2011-09-28 11:56:37 UTC (rev 48533)
@@ -1,146 +0,0 @@
-<H2>DESCRIPTION</H2>
-
-The <EM>d.nviz</EM> program allows the user to easily create a script
-that can be run in NVIZ to fly through a terrain.
-
-The NVIZ flight path can be chosen interactively from the GRASS
-monitor (<EM>-i</EM>) or supplied on the command line as comma
-separated coordinates. The program optionally allows a KeyFrame
-file to created (after running the script). This KeyFrame file can
-be loaded into the <EM>Keyframe Animation</EM> panel for fine
-tuning or editing.
-
-<p>
-The script generated by <EM>d.nviz</EM> can be run from the NVIZ
-command line (nviz script=script_name) or after NVIZ is started by
-selecting <EM>Scripting->Play Script</EM>.
-
-<H2>OPTIONS</H2>
-
-<H3>Flags:</H3>
-<DL>
-<DT><B>-i</B>
-<DD>Intercative mode
-<DD>The user selects the camera path from the GRASS monitor by
- clicking the left mouse button along the route. Click the
- right mouse button to finish.
-<DT><B>-f</B>
-<DD>Full render
-<DD>The script will draw all loaded NVIZ data and save scene to PPM image.
-<DT><B>-c</B>
-<DD>Flay at constant elevation
-<DD>With this flag the camera will be set to an elevation given by the
- <EM>ht=</EM> parameter. The default is to fly at <EM>ht=</EM>
- above the topography (i.e. camera height = elevation + ht)
-<DT><B>-k</B>
-<DD>Output KeyFrame file
-<DD>Generate a KeyFrame file that can be loaded from the NVIZ
- <EM>Keyframe Animation</EM> panel. The KeyFrame file is
- automatically assigned the script name with a
- <EM>.kanimator</EM> extension.
-<DT><B>-o</B>
-<DD>Render the animation in an off-screen context
-<DT><B>-e</B>
-<DD>Enable vector and sites drawing
-</DL>
-
-
-<H3>Parameters:</H3>
-<DL>
-<DT><B>input</B>
-<DD>The name of the GRASS raster map with elevation data.
-<DD>This should be the same file that will be loaded in NVIZ.
-
-<DT><B>output</B>
-<DD>The name of the NVIZ script to create.
-
-<DT><B>name</B>
-<DD>The prefix for output images if running in full render mode (<EM>-f</EM>).
-<DD>The defulat preifix is NVIZ (eg. NVIZ0000.ppm).
-
-<DT><B>dist</B>
-<DD>The distance of the camera behind the center of view.
-
-<DT><B>ht</B>
-<DD>The height of the camera above the center of view.
-<DD>If the the <EM>-c</EM> flag is set, the height represents the actual camera height.
-
-<DT><B>frames</B>
-<DD>The number of frames in the animation.
-
-<DT><B>start</B>
-<DD>The starting frame number (default = 0).
-<DD> This option may be useful in full render mode when creating an
-animation in sections. For example the user may wish to start at frame
-number 2000.
-
-<DT><B>route</B>
-<DD>The comma separated geographic coordinates for keyframe locations.
-<DD>The interactive flag (<EM>-i</EM>) overrides this option.
-
-</DL>
-
-<H2>EXAMPLE</H2>
-To interactively create an NVIZ animation from raster elev.rast with
-500 frames and the camera set to 50 meters above and 250 meters behind
-the scene, run the following:
-
-<div class="code"><pre>
-g.region rast=elevation.dem
-d.rast elevation.dem
-d.nviz -ik input=elevation.dem output=nviz.script dist=2400 ht=1220 frames=1000
-</pre></div>
-In the above the example the user is prompted to select the route from the GRASS monitor.
-The output script, 'nviz.script.nvscr', can then be run in NVIZ:
-<div class="code"><pre>
-nviz elevation=elevation.dem script=nviz.script.nvscr
-</pre></div>
-
-<H2>NOTES / HINTS</H2>
-The user must select at least four key-frame locations (points)
- otherwise an error is generated.
-<p>
-If the GRASS region is changed the <EM>d.nviz</EM> command must be re-run.
-<p>
-The current GRASS region and the user supplied parameters are included
-as a comment at the top of the output script. This information can be
-used to easily re-create the animation.
-<p>
-The camera position is calculated backwards from the supplied
-position(s). It is possible that the camera position will lie outside
-the current window, in which case a non-fatal error is generated
-(Error: selected point is outside region). This error can result in
-jerky movements during the animation. To correct this problem reduce
-the <EM>dist=</EM> parameter or increase the current region.
-
-<h3>Loading the script into NVIZ</h3>
-
-The user can run the script at arbitrary resolution. To re-run it at
-higher spatial resolution or different settings, the user first loads
-the surface and sets the resolution, lighting, etc. Then internally
-the script generated by <em>d.nviz</em> is run. Alternatively, the
-user can run nviz with a previuosly saved state and the
-<em>d.nviz</em> generated script:
-
-<div class="code"><pre>
-nviz state=saved.state script=nviz.script.nvscr
-</pre></div>
-
-<h3>Keyframe animator script</h3>
-Running the script generated by d.nviz within NVIZ, a new script for
-kanimator (keyframe animator) is created. The kanimator panel offers
-fine tuning of the speed (frame rate) as well as editing individual
-frames or inserting new frames. This new kanimator script has to be
-loaded from the Kanimator panel in NVIZ. In the Kanimator panel there
-are Save and Load button which allow the user to save and re-load a
-kanimator script. Once loaded, the key frames will appear in the GUI
-and can then be edited there.
-
-<H2>SEE ALSO</H2>
-
-<EM><A HREF="nviz.html">nviz</A></EM>
-
-<H2>AUTHOR</H2>
-
-<A HREF="mailto:bcovill at tekmap.ns.ca">Bob Covill</A>
-<p><i>Last changed: $Date$</i>
Copied: grass/trunk/misc/m.nviz.script/m.nviz.script.html (from rev 48532, grass/trunk/misc/m.nviz.script/d.nviz.html)
===================================================================
--- grass/trunk/misc/m.nviz.script/m.nviz.script.html (rev 0)
+++ grass/trunk/misc/m.nviz.script/m.nviz.script.html 2011-09-28 11:56:37 UTC (rev 48533)
@@ -0,0 +1,146 @@
+<H2>DESCRIPTION</H2>
+
+The <EM>m.nviz.script</EM> program allows the user to easily create a script
+that can be run in NVIZ to fly through a terrain.
+
+The NVIZ flight path can be chosen interactively from the GRASS
+monitor (<EM>-i</EM>) or supplied on the command line as comma
+separated coordinates. The program optionally allows a KeyFrame
+file to created (after running the script). This KeyFrame file can
+be loaded into the <EM>Keyframe Animation</EM> panel for fine
+tuning or editing.
+
+<p>
+The script generated by <EM>m.nviz.script</EM> can be run from the NVIZ
+command line (nviz script=script_name) or after NVIZ is started by
+selecting <EM>Scripting->Play Script</EM>.
+
+<H2>OPTIONS</H2>
+
+<H3>Flags:</H3>
+<DL>
+<DT><B>-i</B>
+<DD>Intercative mode
+<DD>The user selects the camera path from the GRASS monitor by
+ clicking the left mouse button along the route. Click the
+ right mouse button to finish.
+<DT><B>-f</B>
+<DD>Full render
+<DD>The script will draw all loaded NVIZ data and save scene to PPM image.
+<DT><B>-c</B>
+<DD>Flay at constant elevation
+<DD>With this flag the camera will be set to an elevation given by the
+ <EM>ht=</EM> parameter. The default is to fly at <EM>ht=</EM>
+ above the topography (i.e. camera height = elevation + ht)
+<DT><B>-k</B>
+<DD>Output KeyFrame file
+<DD>Generate a KeyFrame file that can be loaded from the NVIZ
+ <EM>Keyframe Animation</EM> panel. The KeyFrame file is
+ automatically assigned the script name with a
+ <EM>.kanimator</EM> extension.
+<DT><B>-o</B>
+<DD>Render the animation in an off-screen context
+<DT><B>-e</B>
+<DD>Enable vector and sites drawing
+</DL>
+
+
+<H3>Parameters:</H3>
+<DL>
+<DT><B>input</B>
+<DD>The name of the GRASS raster map with elevation data.
+<DD>This should be the same file that will be loaded in NVIZ.
+
+<DT><B>output</B>
+<DD>The name of the NVIZ script to create.
+
+<DT><B>name</B>
+<DD>The prefix for output images if running in full render mode (<EM>-f</EM>).
+<DD>The defulat preifix is NVIZ (eg. NVIZ0000.ppm).
+
+<DT><B>dist</B>
+<DD>The distance of the camera behind the center of view.
+
+<DT><B>ht</B>
+<DD>The height of the camera above the center of view.
+<DD>If the the <EM>-c</EM> flag is set, the height represents the actual camera height.
+
+<DT><B>frames</B>
+<DD>The number of frames in the animation.
+
+<DT><B>start</B>
+<DD>The starting frame number (default = 0).
+<DD> This option may be useful in full render mode when creating an
+animation in sections. For example the user may wish to start at frame
+number 2000.
+
+<DT><B>route</B>
+<DD>The comma separated geographic coordinates for keyframe locations.
+<DD>The interactive flag (<EM>-i</EM>) overrides this option.
+
+</DL>
+
+<H2>EXAMPLE</H2>
+To interactively create an NVIZ animation from raster elev.rast with
+500 frames and the camera set to 50 meters above and 250 meters behind
+the scene, run the following:
+
+<div class="code"><pre>
+g.region rast=elevation.dem
+d.rast elevation.dem
+m.nviz.script -ik input=elevation.dem output=nviz.script dist=2400 ht=1220 frames=1000
+</pre></div>
+In the above the example the user is prompted to select the route from the GRASS monitor.
+The output script, 'nviz.script.nvscr', can then be run in NVIZ:
+<div class="code"><pre>
+nviz elevation=elevation.dem script=nviz.script.nvscr
+</pre></div>
+
+<H2>NOTES / HINTS</H2>
+The user must select at least four key-frame locations (points)
+ otherwise an error is generated.
+<p>
+If the GRASS region is changed the <EM>m.nviz.script</EM> command must be re-run.
+<p>
+The current GRASS region and the user supplied parameters are included
+as a comment at the top of the output script. This information can be
+used to easily re-create the animation.
+<p>
+The camera position is calculated backwards from the supplied
+position(s). It is possible that the camera position will lie outside
+the current window, in which case a non-fatal error is generated
+(Error: selected point is outside region). This error can result in
+jerky movements during the animation. To correct this problem reduce
+the <EM>dist=</EM> parameter or increase the current region.
+
+<h3>Loading the script into NVIZ</h3>
+
+The user can run the script at arbitrary resolution. To re-run it at
+higher spatial resolution or different settings, the user first loads
+the surface and sets the resolution, lighting, etc. Then internally
+the script generated by <em>m.nviz.script</em> is run. Alternatively, the
+user can run nviz with a previuosly saved state and the
+<em>m.nviz.script</em> generated script:
+
+<div class="code"><pre>
+nviz state=saved.state script=nviz.script.nvscr
+</pre></div>
+
+<h3>Keyframe animator script</h3>
+Running the script generated by <em>m.nviz.script</em> within NVIZ, a new script for
+kanimator (keyframe animator) is created. The kanimator panel offers
+fine tuning of the speed (frame rate) as well as editing individual
+frames or inserting new frames. This new kanimator script has to be
+loaded from the Kanimator panel in NVIZ. In the Kanimator panel there
+are Save and Load button which allow the user to save and re-load a
+kanimator script. Once loaded, the key frames will appear in the GUI
+and can then be edited there.
+
+<H2>SEE ALSO</H2>
+
+<EM><A HREF="nviz.html">nviz</A></EM>
+
+<H2>AUTHOR</H2>
+
+<A HREF="mailto:bcovill at tekmap.ns.ca">Bob Covill</A>
+<p><i>Last changed: $Date$</i>
Modified: grass/trunk/misc/m.nviz.script/main.c
===================================================================
--- grass/trunk/misc/m.nviz.script/main.c 2011-09-28 11:52:26 UTC (rev 48532)
+++ grass/trunk/misc/m.nviz.script/main.c 2011-09-28 11:56:37 UTC (rev 48533)
@@ -1,7 +1,7 @@
/****************************************************************************
*
- * MODULE: d.nviz
+ * MODULE: m.nviz.script (nee d.nviz)
* AUTHOR(S): Bob Covill <bcovill at tekmap.ns.ca>
* PURPOSE: interactively create fly-through script for NVIZ
* Functions:
More information about the grass-commit
mailing list