SoVRMLGeoLocation Class Reference
[GeoVRML 1.1 Nodes]
Used to georeference models.
More...
#include <Inventor/geo/SoVRMLGeoLocation.h>
Public Member Functions | |
| virtual SoType | getTypeId () const |
| SoVRMLGeoLocation () | |
Static Public Member Functions | |
| static SoType | getClassTypeId () |
Public Attributes | |
| SoSFNode | geoOrigin |
| SoSFVec3d | geoCoords |
| SoMFString | geoSystem |
Detailed Description
Used to georeference models.
The SoVRMLGeoLocation allows to place a non-georeferenced model at its correct geospatial location.
VRML X3D SPECIFICATION
- This section describes the expected behavior of the node in a conforming X3D / VRML97 browser application. In some cases, the application is responsible for implementing portions of the expected behavior. Open Inventor viewer classes and IVF classes implement some of the application behaviors.
This section may reference portions of the X3D specification that are not present in this help file. The complete X3D spec is available at http://www.web3d.org .
The SoVRMLGeoLocation node provides the ability to geo-reference any standard X3D model. That is, to take an ordinary X3D model, contained within the children field of the node, and to specify its geospatial location. This node is a grouping node that can be thought of as a Transform node. However, the GeoLocation node specifies an absolute location, not a relative one, so content developers should not nest GeoLocation nodes within each other. The geoOrigin field is used to specify a local coordinate frame for extended precision as described in 25.2.5 Dealing with high-precision coordinates. The geoSystem field is used to define the spatial reference frame and is described in 25.2.3 Specifying a spatial reference frame. The geometry of the nodes in children is to be specified in units of meters in X3D coordinates relative to the location specified by the geoCoords field. The geoCoords field should be provided in the format described in 25.2.3 Specifying a spatial reference frame. The geoCoords field can be used to dynamically update the geospatial location of the model.
FILE FORMAT/DEFAULT
- VRMLGeoLocation {
| children | [] |
| geoCoords | 0 0 0 |
| metadata | NULL |
| geoOrigin | NULL |
| geoSystem | ["GD","WE"] |
| bboxCenter | 0 0 0 |
| bboxSize | -1 -1 -1 |
ACTION BEHAVIOR
- SoGLRenderAction, SoRayPickAction, SoGetBoundingBoxAction, SoCallbackAction, SoGetMatrixAction, SoGetPrimitiveCount
EVENTS
- Deprecated:
-
Deprecated since Open Inventor 9500
The VRML API is no longer supported. See section http://oivdoc95.vsg3d.com/content/compatibility-notes-4#Deprecation of the Reference Manual. - GC: Earth-fixed Geocentric with respect to the WGS84 ellipsoid.
- GD: Geodetic spatial reference frame.
An optional second string may be used to specify the ellipsoid using one of the ellipsoid codes that are defined in X3D. If no ellipsoid is specified, then "WE" is assumed (the WGS84 ellipsoid). - UTM: Universal Transverse Mercator
One further required argument must be supplied for UTM in order to specify the zone number (1..60). This is given in the form "Z<n>", where "<n>" is the zone number. An optional argument of "S" may be supplied in order to specify that the coordinates are in the southern hemisphere (otherwise, northern hemisphere will be assumed). - Inventor/geo/SoVRMLGeoLocation.h
eventIn
| SoMFNode | addChildren |
| SoMFNode | removeChildren |
| SoMFNode | set_children |
| SoSFNode | set_metadata |
eventOut
| SoMFNode | children_changed |
| SoSFNode | metadata_changed |
Constructor & Destructor Documentation
| SoVRMLGeoLocation::SoVRMLGeoLocation | ( | ) |
Constructor.
Member Function Documentation
| static SoType SoVRMLGeoLocation::getClassTypeId | ( | ) | [static] |
Returns the type identifier for this class.
Reimplemented from SoVRMLGroup.
| virtual SoType SoVRMLGeoLocation::getTypeId | ( | ) | const [virtual] |
Returns the type identifier for this specific instance.
Reimplemented from SoVRMLGroup.
Member Data Documentation
Geospatial coordinate used for translation.
An SoVRMLGeoOrigin node specifying the origin of the local coordinate system.
Defines the spatial reference frame.
Valid values are:
The documentation for this class was generated from the following file: