official documentation

  1. x3dom.org
  2. documentation
  3. Developer API

Class: GeoLocation

X3D: 3.3
Component: Geospatial
Status:
experimental

Quick Links

➨ Fields
➨ Properties

.nodeTypes. GeoLocation

The GeoLocation node provides the ability to geo-reference any standard X3D model. That is, to take an ordinary X3D model, contained within the children 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.

HTML Encoding and Default Values⤴

<GeoLocation bboxCenter='0,0,0' bboxColor='1, 1, 0' bboxDisplay='false' bboxMargin='0.01' bboxSize='-1,-1,-1' children='X3DChildNode' geoCoords='0,0,0' geoOrigin='x3dom.nodeTypes.GeoOrigin' geoSystem='['GD','WE']' metadata='X3DMetadataObject' render='true' visible='true' ></GeoLocation>

Inheritance⤴


Constructor⤴

GeoLocation(ctx)⤴

Constructor for GeoLocation

Parameters:
Name Type Argument Default Description
ctx Object <optional>
 null context object, containing initial settings like namespace

Fields⤴

These are the X3D / X3DOM fields of this node. Values should usually be received / set as strings via DOM functions (i.e., using setAttribute("myFieldName", "myFieldValue") and getAttribute("myFieldName")).
Name Type Default Value Range Inheritance Standard Description
bboxCenter SFVec3f 0,0,0 [-inf, inf] X3DBoundedObject Center of the bounding box
bboxColor SFColor 1, 1, 0 X3DBoundedObject Color of the bounding box
bboxDisplay SFVec3f false X3DBoundedObject Flag to enable display of the bounding box
bboxMargin SFFloat 0.01 [-inf, inf] X3DBoundedObject Size of additional margin around the bounding box scaled up by the diameter.
bboxSize SFVec3f -1,-1,-1 [0, inf] or -1 X3DBoundedObject Size of the bounding box
children MFNode X3DChildNode X3DGroupingNode Grouping nodes have a field that contains a list of children nodes. Each grouping node defines a coordinate space for its children. This coordinate space is relative to the coordinate space of the node of which the group node is a child. Such a node is called a parent node. This means that transformations accumulate down the scene graph hierarchy.
geoCoords SFVec3d 0,0,0 The geometry of the nodes in children is to be specified in units of metres in X3D coordinates relative to the location specified by the geoCoords field. The geoCoords field can be used to dynamically update the geospatial location of the model.
geoOrigin SFNode GeoOrigin The geoOrigin field is used to specify a local coordinate frame for extended precision.
geoSystem MFString ['GD','WE'] {["GD", ...], ["UTM", ...], ["GC", ...]} The geoSystem field is used to define the spatial reference frame.
metadata SFNode X3DMetadataObject X3DNode Field to add metadata information
render SFBool true X3DBoundedObject Flag to enable/disable rendering
visible SFBool true X3DBoundedObject Flag to enable/disable rendering, alias for render