## 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,...]] [isosurf_color_map=name[,name,...]] [isosurf_color_value=name[,name,...]] [isosurf_transparency_map=name[,name,...]] [isosurf_transparency_value=value[,value,...]] [isosurf_shininess_map=name[,name,...]] [isosurf_shininess_value=value[,value,...]] [slice=volume:axis[,volume:axis,...]] [slice_position=x1,x2,y1,y2,z1,z2[,x1,x2,y1,y2,z1,z2,...]] [slice_transparency=value[,value,...]] [bgcolor=name] [position=x,y] [height=value] [perspective=value] [twist=value] [zexag=value] [focus=x,y,z] [light_position=x,y,z] [light_color=name] [light_brightness=integer] [light_ambient=integer] [fringe=string[,string,...]] [fringe_color=name] [fringe_elevation=integer] [cplane=value[,value,...]] [cplane_position=x,y,z[,x,y,z,...]] [cplane_rotation=value[,value,...]] [cplane_tilt=value[,value,...]] [cplane_shading=string] [arrow_position=x,y] [arrow_size=value] [arrow_color=name] 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-10000
  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
isosurf_color_map=name[,name,...]
  Name of volume for isosurface color
isosurf_color_value=name[,name,...]
  Isosurface color
  Either a standard color name or R:G:B triplet
isosurf_transparency_map=name[,name,...]
  Name of 3D raster map(s) for isosurface transparency
isosurf_transparency_value=value[,value,...]
  Transparency value(s)for isosurfaces
  Options: 0-255
isosurf_shininess_map=name[,name,...]
  Name of 3D raster map(s) for shininess
isosurf_shininess_value=value[,value,...]
  Shininess value(s) for isosurfaces
  Options: 0-255
slice=volume:axis[,volume:axis,...]
  Volume slice parallel to given axis (x, y, z)
slice_position=x1,x2,y1,y2,z1,z2[,x1,x2,y1,y2,z1,z2,...]
  Volume slice position
  Default: 0,1,0,1,0,1
slice_transparency=value[,value,...]
  Volume slice transparency
  Options: 0-255
  Default: 0
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
focus=x,y,z
  Focus to point on surface (from SW corner in map units)
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
cplane=value[,value,...]
  Cutting plane index (0-5)
cplane_position=x,y,z[,x,y,z,...]
  Cutting plane x,y,z coordinates
  Default: 0,0,0
cplane_rotation=value[,value,...]
  Cutting plane rotation along the vertical axis
  Options: 0-360
  Default: 0
cplane_tilt=value[,value,...]
  Cutting plane tilt
  Options: 0-360
  Default: 0
cplane_shading=string
  Cutting plane color (between two surfaces)
  Options: clear,top,bottom,blend,shaded
  Default: clear
arrow_position=x,y
  Place north arrow at given position (in screen coordinates from bottom left corner)
arrow_size=value
  North arrow size (in map units)
arrow_color=name
  North arrow color
  Either a standard color name or R:G:B triplet
  Default: black
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 (mentor: Michael Barton) and Google Summer of Code 2010 (mentor: Helena Mitasova)
Anna Kratochvilova, Google Summer of Code 2011 (mentor: Martin Landa)

Last changed: $Date: 2013-02-15 23:04:18 +0100 (pá, 15 II 2013) $

Main index - misc index - Full index

© 2003-2014 GRASS Development Team