Post

GeoOrigin

GeoOrigin

Overview

GeoOrigin specifies local geospatial coordinate system for parent node, enabling increased geographic precision during scene rendering (by mitigating potential floating-point roundoff errors). GeoOrigin can be contained by other Geospatial component nodes, typically via DEF/USE to ensure consistency.

The GeoOrigin node belongs to the Geospatial component and requires at least level 1, its default container field is geoOrigin. It is available from X3D version 3.0 or higher.

Hierarchy

1
2
+ X3DNode
  + GeoOrigin

Fields

SFNode [in, out] metadata NULL [X3DMetadataObject]

Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.

Hint

MFString [ ] geoSystem [ “GD”, “WE” ]

Identifies spatial reference frame: Geodetic (GD), Geocentric (GC), Universal Transverse Mercator (UTM). Supported values: “GD” “UTM” or “GC” followed by additional quoted string parameters as appropriate for the type.

Hints

Warning

  • Deprecated values are GDC (replaced by GD) and GCC (replaced by GC).

SFVec3d [in, out] geoCoords 0 0 0 (-∞,∞)

Defines absolute geographic location (and implicit local coordinate frame).

Hint

Warning

  • Requires X3D profile='Full' or else include <component name='Geospatial' level='1'/>

SFBool [ ] rotateYUp FALSE

Whether to rotate coordinates of nodes using this GeoOrigin so that local-up direction aligns with VRML Y axis rotateYUp false means local up-direction is relative to planet surface rotateYUp true allows proper operation of NavigationInfo modes FLY, WALK.

Advice

Hints

Warnings

  • Requires X3D profile='Full' or else include <component name='Geospatial' level='1'/>
  • GeoOrigin is deprecated, discouraged and not legal in X3D v3.3. GeoOrigin can be ignored in X3D v3.2 and below.
  • XML validation requires placement as first child node following contained metadata nodes (if any).

See Also

This post is licensed under CC BY 4.0 by the author.