Class SoGeoLocation

All Implemented Interfaces:
SafeDisposable

public class SoGeoLocation extends SoTransformation
Used to georeference models. The SoGeoLocation allows to place a non-georeferenced model at its correct location in geospatial coordinates.

The SoGeoLocation node provides the ability to geo-reference any models. That is, to take an ordinary model, 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 geoSystem field is used to define the spatial reference frame and is described in 25.2.3 Specifying a spatial reference frame. 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:

GeoLocation {

    geoCoords 0 0 0
    geoSystem ["GD","WE"]
}

Action behavior:

SoGLRenderAction, SoRayPickAction, SoGetBoundingBoxAction, SoCallbackAction, SoGetMatrixAction, SoGetPrimitiveCount

  • Field Details

    • geoCoords

      public final SoSFVec3d geoCoords
      Geospatial coordinate used for translation.
    • geoSystem

      public final SoMFString geoSystem
      Defines the spatial reference frame.
      Valid values are:
      • 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 used. 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 "Zn", 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).
  • Constructor Details

    • SoGeoLocation

      public SoGeoLocation()
      Creates a geoLocation node with default settings.