m.nviz.script(1grass) | GRASS GIS User's Manual | m.nviz.script(1grass) |
m.nviz.script - Creates fly-through script to run in NVIZ.
miscellaneous, graphics, raster, raster3d, vector, visualization
m.nviz.script
m.nviz.script --help
m.nviz.script [-fckoe] input=name
output=name [name=string]
[route=east,north[,east,north,...]]
dist=float ht=float frames=integer
[start=integer] [--overwrite] [--help]
[--verbose] [--quiet] [--ui]
The m.nviz.script 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 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 Keyframe Animation panel for fine tuning or editing.
The script generated by m.nviz.script can be run from the NVIZ command line (nviz script=script_name) or after NVIZ is started by selecting Scripting->Play Script.
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:
g.region raster=elevation.dem d.rast elevation.dem m.nviz.script -k input=elevation.dem output=nviz.script dist=2400 ht=1220 frames=1000
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:
nviz elevation=elevation.dem script=nviz.script.nvscr
The user must select at least four key-frame locations (points) otherwise an error is generated.
If the GRASS region is changed the m.nviz.script command must be re-run.
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.
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 dist= parameter or increase the current region.
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 m.nviz.script is run. Alternatively, the user can run
nviz with a previuosly saved state and the m.nviz.script generated
script:
nviz state=saved.state script=nviz.script.nvscr
Running the script generated by m.nviz.script 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.
wxGUI 3D viewer (NVIZ)
Bob Covill
Available at: m.nviz.script source code (history)
Accessed: Sunday Jan 22 07:37:20 2023
Main index | Miscellaneous index | Topics index | Keywords index | Graphical index | Full index
© 2003-2023 GRASS Development Team, GRASS GIS 8.2.1 Reference Manual
GRASS 8.2.1 |