1r.out.vrml(1)                 Grass User's Manual                r.out.vrml(1)
2
3
4

NAME

6       r.out.vrml  - Exports a raster map to the Virtual Reality Modeling Lan‐
7       guage (VRML).
8

KEYWORDS

10       raster, export, output, VRML
11

SYNOPSIS

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
18   Flags:
19       --overwrite
20           Allow output files to overwrite existing files
21
22       --help
23           Print usage summary
24
25       --verbose
26           Verbose module output
27
28       --quiet
29           Quiet module output
30
31       --ui
32           Force launching GUI dialog
33
34   Parameters:
35       elevation=name [required]
36           Name of input elevation raster map
37
38       color=name
39           Name of input color map
40
41       exaggeration=float
42           Vertical exaggeration
43           Default: 1.0
44
45       output=name [required]
46           Name for output VRML file
47

DESCRIPTION

49       This  module exports a GRASS raster map to the Virtual Reality Modeling
50       Language (VRML) format for 3D visualization.
51
52       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

WARNING

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

NOTE

70       This is a preliminary release of "r.out.vrml".  For further information
71       about VRML and available viewers for various platforms, see:
72
73       VRML Virtual Reality Modeling Language
74

BUGS:

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

TODO

83       Update  to  the more modern GeoVRML format, or probably better the next
84       generation X3D format.  See also the Xj3D project.
85
86       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
92       Other possible additions:
93
94           ·   Allow animation of elevation, color, or  sites  based  on  user
95               interaction.
96
97           ·   Degradation  of the raster to produce TINs for improved perfor‐
98               mance.
99

AUTHOR

101       Bill Brown, US Army Construction Engineering Research Laboratory
102

SOURCE CODE

104       Available at: r.out.vrml source code (history)
105
106       Main index | Raster index | Topics index | Keywords index  |  Graphical
107       index | Full index
108
109       © 2003-2019 GRASS Development Team, GRASS GIS 7.8.2 Reference Manual
110
111
112
113GRASS 7.8.2                                                      r.out.vrml(1)
Impressum