NAME¶
m.nviz.image - Creates a 3D rendering of GIS data.
Renders surfaces (raster data), 2D/3D vector data, and volumes (3D raster data)
in 3D.
KEYWORDS¶
visualization, raster, vector, raster3d
SYNOPSIS¶
m.nviz.image
m.nviz.image help
m.nviz.image [-
a]
[
elevation_map=
name[,
name,...]] [
elevation_value=
value[,
value,...]]
[
color_map=
name[,
name,...]]
[
color=
name[,
name,...]]
[
mask_map=
name[,
name,...]] [
transparency_map=
name[,
name,...]]
[
transparency_value=
value[,
value,...]]
[
shininess_map=
name[,
name,...]]
[
shininess_value=
value[,
value,...]]
[
emission_map=
name[,
name,...]]
[
emission_value=
value[,
value,...]]
[
mode=
string[,
string,...]]
[
resolution_fine=
value[,
value,...]]
[
resolution_coarse=
value[,
value,...]]
[
style=
string[,
string,...]]
[
shading=
string[,
string,...]]
[
wire_color=
name[,
name,...]]
[
surface_position=
x,y,z[,
x,y,z,...]]
[
vline=
name[,
name,...]]
[
vline_width=
value[,
value,...]]
[
vline_color=
name[,
name,...]]
[
vline_mode=
string[,
string,...]]
[
vline_height=
value[,
value,...]]
[
vline_position=
x,y,z[,
x,y,z,...]]
[
vpoint=
name[,
name,...]]
[
vpoint_size=
value[,
value,...]]
[
vpoint_width=
value[,
value,...]]
[
vpoint_color=
name[,
name,...]]
[
vpoint_marker=
string[,
string,...]]
[
vpoint_position=
x,y,z[,
x,y,z,...]]
[
volume=
name[,
name,...]]
[
volume_mode=
string[,
string,...]]
[
volume_shading=
string[,
string,...]]
[
volume_position=
x,y,z[,
x,y,z,...]]
[
volume_resolution=
value[,
value,...]]
[
isosurf_level=
volume:value[,
volume:value,...]]
[
bgcolor=
name] [
position=
x,y]
[
height=
value] [
perspective=
value]
[
twist=
value] [
zexag=
value]
[
light_position=
x,y,z] [
light_color=
name]
[
light_brightness=
integer]
[
light_ambient=
integer] [
fringe=
string[,
string,...]] [
fringe_color=
name] [
fringe_elevation=
integer]
output=
name format=
string
size=
width,height [--
verbose] [--
quiet]
Flags:¶
- -a
-
Use draw mode for all loaded surfaces
- --verbose
-
Verbose module output
- --quiet
-
Quiet module output
Parameters:¶
- elevation_map=name[,name,...]
-
Name of raster map(s) for elevation
- elevation_value=value[,value,...]
-
Elevation value(s)
- color_map=name[,name,...]
-
Name of raster map(s) for color
- color=name[,name,...]
-
Color value(s)
Either a standard color name or R:G:B triplet
- mask_map=name[,name,...]
-
Name of raster map(s) for mask
- transparency_map=name[,name,...]
-
Name of raster map(s) for transparency
- transparency_value=value[,value,...]
-
Transparency value(s)
Options: 0-255
- shininess_map=name[,name,...]
-
Name of raster map(s) for shininess
- shininess_value=value[,value,...]
-
Shininess value(s)
Options: 0-255
- emission_map=name[,name,...]
-
Name of raster map(s) for emission
- emission_value=value[,value,...]
-
Emission value(s)
Options: 0-255
- mode=string[,string,...]
-
Draw mode
Options: coarse,fine,both
Default: fine
- resolution_fine=value[,value,...]
-
Fine resolution
Default: 6
- resolution_coarse=value[,value,...]
-
Coarse resolution
Default: 9
- style=string[,string,...]
-
Draw style
Options: wire,surface
Default: surface
- shading=string[,string,...]
-
Shading
Options: flat,gouraud
Default: gouraud
- wire_color=name[,name,...]
-
Wire color
Either a standard color name or R:G:B triplet
Default: 136:136:136
- surface_position=x,y,z[,x,y,z,...]
-
Surface position
Default: 0,0,0
- vline=name[,name,...]
-
Name of line vector overlay map(s)
- vline_width=value[,value,...]
-
Vector line width
Options: 1-100
Default: 2
- vline_color=name[,name,...]
-
Vector line color
Either a standard color name or R:G:B triplet
Default: blue
- vline_mode=string[,string,...]
-
Vector line display mode
Options: surface,flat
Default: surface
- vline_height=value[,value,...]
-
Vector line height
Options: 0-1000
Default: 0
- vline_position=x,y,z[,x,y,z,...]
-
Vector lines position
Default: 0,0,0
- vpoint=name[,name,...]
-
Name of point vector overlay map(s)
- vpoint_size=value[,value,...]
-
Icon size
Options: 1-1000
Default: 100
- vpoint_width=value[,value,...]
-
Icon width
Options: 1-1000
Default: 2
- vpoint_color=name[,name,...]
-
Icon color
Either a standard color name or R:G:B triplet
Default: blue
- vpoint_marker=string[,string,...]
-
Icon marker
Options: x,sphere,diamond,cube,box,gyro,aster,histogram
Default: sphere
- vpoint_position=x,y,z[,x,y,z,...]
-
Vector points position
Default: 0,0,0
- volume=name[,name,...]
-
Name of input raster3d map(s)
- volume_mode=string[,string,...]
-
Volume draw mode
Options: isosurface,slice
Default: isosurface
- volume_shading=string[,string,...]
-
Volume shading
Options: flat,gouraud
Default: gouraud
- volume_position=x,y,z[,x,y,z,...]
-
Volume position
Default: 0,0,0
- volume_resolution=value[,value,...]
-
Volume resolution
Default: 3
- isosurf_level=volume:value[,volume:value,...]
-
Isosurface level
- bgcolor=name
-
Background color
Either a standard GRASS color, R:G:B triplet, or "none"
Default: white
- position=x,y
-
Viewpoint position (x,y model coordinates)
Default: 0.84,0.16
- height=value
-
Viewpoint height (in map units)
- perspective=value
-
Viewpoint field of view (in degrees)
Options: 1-100
Default: 40
- twist=value
-
Viewpoint twist angle (in degrees)
Options: -180-180
Default: 0
- zexag=value
-
Vertical exaggeration
- light_position=x,y,z
-
Light position (x,y,z model coordinates)
Default: 0.68,-0.68,0.80
- light_color=name
-
Light color
Either a standard color name or R:G:B triplet
Default: white
- light_brightness=integer
-
Light brightness
Options: 0-100
Default: 80
- light_ambient=integer
-
Light ambient
Options: 0-100
Default: 20
- fringe=string[,string,...]
-
Fringe edges
Options: nw,ne,sw,se
nw: North-West edge
ne: North-East edge
sw: South-West edge
se: South-East edge
- fringe_color=name
-
Fringe color
Either a standard color name or R:G:B triplet
Default: grey
- fringe_elevation=integer
-
Fringe elevation
Default: 55
- output=name
-
Name for output image file (without extension)
- format=string
-
Graphics file format
Options: ppm,tif
Default: ppm
- size=width,height
-
Size (width, height) of output image
Default: 640,480
DESCRIPTION¶
m.nviz.image allows users to realistically render multiple
surfaces (raster data) in a 3D space, optionally using thematic
coloring, draping 2D
vector data over the surfaces, displaying 3D
vector data in the space, and visualization of
volume data (3D raster
data) from the command line.
EXAMPLE¶
Render elevation map in a 3D space.
g.region rast=elevation
m.nviz.image elevation_map=elevation output=elev perspective=15
SEE ALSO¶
wxGUI 3D view mode
AUTHOR¶
Martin Landa (Google Summer of Code 2008/2010)
Last changed: $Date: 2011-11-08 10:42:51 +0100 (Tue, 08 Nov 2011) $
Full index
© 2003-2011 GRASS Development Team