1r.out.vrml(1) GRASS GIS User's Manual r.out.vrml(1)
2
6 r.out.vrml - Exports a raster map to the Virtual Reality Modeling Lan‐
7 guage (VRML).
8
10 raster, export, output, VRML
11
13 r.out.vrml
14 r.out.vrml --help
15 r.out.vrml elevation=name [color=name] [exaggeration=float] out‐
16 put=name [--overwrite] [--help] [--verbose] [--quiet] [--ui]
17 Flags:
19 --overwrite
20 Allow output files to overwrite existing files
21 --help
23 Print usage summary
24 --verbose
26 Verbose module output
27 --quiet
29 Quiet module output
30 --ui
32 Force launching GUI dialog
33 Parameters:
35 elevation=name [required]
36 Name of input elevation raster map
37 color=name
39 Name of input color map
40 exaggeration=float
42 Vertical exaggeration
43 Default: 1.0
44 output=name [required]
46 Name for output VRML file
47
49 This module exports a GRASS raster map to the Virtual Reality Modeling
50 Language (VRML) format for 3D visualization.
51 This version only outputs raster maps in VRML 1.0 format. The newer
53 VRML 2.0 format will be more efficient for geographic applications, as
54 it introduces an "ElevationGrid" node so that only the elevation points
55 will have to be written instead of the whole geometry. The vast major‐
56 ity of VRML viewers currently only support VRML 1.0. If the extension
57 "wrl" (world) is not present in the he output parameter, it will be
58 added.
59
61 VRML is not well suited for large geometrys which can result from even
62 a small geographic region. Most viewers seem to bog down with more
63 than 12,000 polygons, depending on your hardware & specific viewer.
64 Each grid cell results in two polygons, so a reasonable size region
65 would be something less than about 75x75. For improved performance and
66 smaller file size, leave off a color map. Since VRML is ascii text,
67 gzip works very well to significantly compress file size.
68
70 This is a preliminary release of "r.out.vrml". For further information
71 about VRML and available viewers for various platforms, see:
72 VRML Virtual Reality Modeling Language
74
76 Currently the region is transformed to a unit size, so real geographic
77 location is lost. Side effects when working in a lat-lon location are
78 that besides general distortion due to projection, a very small exag‐
79 geration factor (on order of .001) must be used to compensate for ver‐
80 tical units expected to be the same as map units.
81
83 Update to the more modern GeoVRML format, or probably better the next
84 generation X3D format. See also the Xj3D project.
85 Future plans for this module are to allow draping of sites objects and
87 vector maps and using the new sites format available in floating point
88 GRASS to embed WWW links into site objects. It will also be upgraded to
89 support VRML 2.0 and will allow entering multiple preset "views" using
90 the existing GRASS 3d_view file format.
91 Other possible additions:
93 • Allow animation of elevation, color, or sites based on user in‐
95 teraction.
96 • Degradation of the raster to produce TINs for improved perfor‐
98 mance.
99
101 Bill Brown, US Army Construction Engineering Research Laboratory
102
104 Available at: r.out.vrml source code (history)
105 Accessed: Saturday Jan 21 21:14:59 2023
107 Main index | Raster index | Topics index | Keywords index | Graphical
109 index | Full index
110 © 2003-2023 GRASS Development Team, GRASS GIS 8.2.1 Reference Manual
112GRASS 8.2.1 r.out.vrml(1)