Note: This document is for an older version of GRASS GIS that is outdated. You should upgrade, and read the current manual page.

NAME

KEYWORDS

SYNOPSIS

Flags:

-i

Interactively select route

-f

Full render -- Save images

-c

Fly at constant elevation (ht)

-k

Include command in the script to output a KeyFrame file

-o

Render images off-screen

-e

Enable vector and sites drawing

--verbose

Verbose module output

--quiet

Quiet module output

Parameters:

input=name

Name of input raster map

output=name

Name of output script

name=string

Prefix of output images (default = NVIZ)

route=east,north[,east,north,...]

Route coordinates (east,north)

dist=float

Camera layback distance (in map units)

ht=float

Camera height above terrain

frames=integer

Number of frames

start=integer

Start frame number (default=0)

DESCRIPTION

The script generated by d.nviz can be run from the NVIZ command line (nviz script=script_name) or after NVIZ is started by selecting Scripting->Play Script.

OPTIONS

Flags:

-i

Intercative mode

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.

-f

Full render

The script will draw all loaded NVIZ data and save scene to PPM image.

-c

Flay at constant elevation

With this flag the camera will be set to an elevation given by the ht= parameter. The default is to fly at ht= above the topography (i.e. camera height = elevation + ht)

-k

Output KeyFrame file

Generate a KeyFrame file that can be loaded from the NVIZ Keyframe Animation panel. The KeyFrame file is automatically assigned the script name with a .kanimator extension.

-o

Render the animation in an off-screen context

-e

Enable vector and sites drawing

Parameters:

input

The name of the GRASS raster map with elevation data.

This should be the same file that will be loaded in NVIZ.

output

The name of the NVIZ script to create.

name

The prefix for output images if running in full render mode (-f).

The defulat preifix is NVIZ (eg. NVIZ0000.ppm).

dist

The distance of the camera behind the center of view.

ht

The height of the camera above the center of view.

If the the -c flag is set, the height represents the actual camera height.

frames

The number of frames in the animation.

start

The starting frame number (default = 0).

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.

route

The comma separated geographic coordinates for keyframe locations.

The interactive flag (-i) overrides this option.

EXAMPLE

g.region rast=elevation.dem
d.rast elevation.dem
d.nviz -ik input=elevation.dem output=nviz.script dist=2400 ht=1220 frames=1000

nviz elevation=elevation.dem script=nviz.script.nvscr

NOTES / HINTS

If the GRASS region is changed the d.nviz 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.

Loading the script into NVIZ

nviz state=saved.state script=nviz.script.nvscr

Keyframe animator script

SEE ALSO

AUTHOR

Last changed: $Date: 2011-11-08 03:23:06 -0800 (Tue, 08 Nov 2011) $

Main index - display index - Full index

© 2003-2014 GRASS Development Team