<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>GRASS GIS: r.out.vrml</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="grassdocs.css" type="text/css">
</head>
<body bgcolor="white">
<img src="grass_logo.png" alt="GRASS logo"><hr align=center size=6 noshade>
<h2>NAME</h2>
<em><b>r.out.vrml</b></em> - Export a raster map to the Virtual Reality Modeling Language (VRML)
<h2>KEYWORDS</h2>
raster, export, VRML
<h2>SYNOPSIS</h2>
<b>r.out.vrml</b><br>
<b>r.out.vrml help</b><br>
<b>r.out.vrml</b> <b>elev</b>=<em>string</em> [<b>color</b>=<em>string</em>] [<b>exag</b>=<em>float</em>] <b>output</b>=<em>string</em> [--<b>verbose</b>] [--<b>quiet</b>]
<h3>Parameters:</h3>
<DL>
<DT><b>elev</b>=<em>string</em></DT>
<DD>Name of elevation map</DD>
<DT><b>color</b>=<em>string</em></DT>
<DD>Name of color file</DD>
<DT><b>exag</b>=<em>float</em></DT>
<DD>Vertical exaggeration</DD>
<DD>Default: <em>1.0</em></DD>
<DT><b>output</b>=<em>string</em></DT>
<DD>Name for new VRML file</DD>
</DL>
<H2>DESCRIPTION</H2>
This module exports a GRASS raster map to the Virtual Reality Modeling
Language (VRML) format for 3D visualization.
<P>
This version only outputs raster maps in VRML 1.0 format.
The newer VRML 2.0 format will be more efficient for geographic
applications, as it introduces an "ElevationGrid" node so that
only the elevation points will have to be written instead
of the whole geometry. The vast majority of VRML viewers
currently only support VRML 1.0.
If the extension "wrl" (world) is not present in the he
<em>output</em> parameter, it will be added.
<H2>WARNING</H2>
VRML is not well suited for large geometrys which can result from even
a small geographic region. Most viewers seem to bog down with more
than 12,000 polygons, depending on your hardware & specific
viewer. Each grid cell results in two polygons, so a reasonable size
region would be something less than about 75x75. For improved
performance and smaller file size, leave off a color map. Since VRML
is ascii text, gzip works very well to significantly compress file
size.<p>
<H2>NOTE</H2>
This is a preliminary release of "<em>r.out.vrml</em>".
For further information about VRML and available viewers for various platforms, see:<p>
<a href="http://www.w3.org/MarkUp/VRML/">VRML Virtual Reality Modeling Language</a>
<H2>BUGS:</H2>
Currently the region is transformed to a unit size, so real geographic
location is lost. Side effects when working in a lat-lon location are
that besides general distortion due to projection, a very small
exaggeration factor (on order of .001) must be used to compensate for
vertical units expected to be the same as map units.
<H2>TODO</H2>
Update to the more modern <a href="http://www.geovrml.org">GeoVRML format</a>,
or probably better the next generation
<a href="http://www.web3d.org">X3D format</a>.
See also the <a href="http://www.xj3d.org">Xj3D project</a>.
<P>
Future plans for this module are to allow draping of sites objects and
vector maps and using the new sites format available in floating
point GRASS to embed WWW links into site objects. It will also be
upgraded to support VRML 2.0 and will allow entering multiple preset
"views" using the existing GRASS 3d_view file format.<p>
Other possible additions:
<ul>
<li> Allow animation of elevation, color, or sites based on
user interaction.
<li> Degradation of the raster to produce TINs for improved
performance.
</ul>
<H2>AUTHOR</H2>
Bill Brown, US Army Construction Engineering Research Laboratory
<p>
<i>Last changed: $Date: 2006-12-13 17:10:28 +0100 (Wed, 13 Dec 2006) $</i>
<HR>
<P><a href="index.html">Main index</a> - <a href="raster.html">raster index</a> - <a href="full_index.html">Full index</a></P>
<P>© 2003-2008 <a href="http://grass.osgeo.org">GRASS Development Team</a></p>
</body>
</html>
