Package com.openinventor.inventor.geo

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 Detail

      • 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 Detail

      • SoGeoLocation

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