official documentation

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

Class: GeoTransform

X3D: 3.3
Component: Geospatial
Status:
fully implemented

Quick Links

➨ Fields
➨ Properties

.nodeTypes. GeoTransform

The GeoTransform node is a grouping node that defines a coordinate system for its children to support the translation and orientation of geometry built using GeoCoordinate nodes within the local world coordinate system. The X-Z plane of a GeoTransform coordinate system is tangent to the ellipsoid of the spatial reference frame at the location specified by the geoCenter field.

HTML Encoding and Default Values⤴

<GeoTransform bboxCenter='0,0,0' bboxColor='1, 1, 0' bboxDisplay='false' bboxMargin='0.01' bboxSize='-1,-1,-1' children='X3DChildNode' geoCenter='0,0,0' geoOrigin='x3dom.nodeTypes.Transform' geoSystem='['GD','WE']' globalGeoOrigin='false' metadata='X3DMetadataObject' render='true' rotation='0,0,1,0' scale='1,1,1' scaleOrientation='0,0,1,0' translation='0,0,0' visible='true' ></GeoTransform>

Inheritance⤴


Constructor⤴

GeoTransform(ctx)⤴

Constructor for GeoTransform

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.
geoCenter SFVec3d 0,0,0 The geoCenter field specifies, in the spatial reference frame specified by the geoSystem field, the location at which the local coordinate system is centered.
geoOrigin SFNode Transform 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.
globalGeoOrigin SFBool false The globalGeoOrigin field specifies whether a GeoOrigin should be applied to child nodes. The default is false which means that GeoOrigin nodes are expected to have been provided to child nodes. A true value means that GeoOrigin nodes are expected to have been omitted from child nodes. In this case, the GeoOrigin of the GeoTransform is applied to the child nodes as if GeoOrigin nodes had been provided to child nodes. A true value in combination with provided GeoOrigin in child nodes leads to undefined behaviour.
metadata SFNode X3DMetadataObject X3DNode Field to add metadata information
render SFBool true X3DBoundedObject Flag to enable/disable rendering
rotation SFRotation 0,0,1,0 Defines the rotation component of the transformation.
scale SFVec3f 1,1,1 Defines the scale component of the transformation.
scaleOrientation SFRotation 0,0,1,0 The scaleOrientation specifies a rotation of the coordinate system before the scale (to specify scales in arbitrary orientations). The scaleOrientation applies only to the scale operation.
translation SFVec3f 0,0,0 The translation field specifies a translation to the coordinate system.
visible SFBool true X3DBoundedObject Flag to enable/disable rendering, alias for render