Package com.openinventor.inventor.geo

Class SoGeoElevationGrid

java.lang.Object
com.openinventor.inventor.Inventor
com.openinventor.inventor.misc.SoBase
com.openinventor.inventor.fields.SoFieldContainer
com.openinventor.inventor.nodes.SoNode
com.openinventor.inventor.nodes.SoShape
com.openinventor.inventor.nodes.SoVertexShape
com.openinventor.inventor.nodes.SoIndexedShape
com.openinventor.inventor.nodes.SoIndexedFaceSet
com.openinventor.inventor.geo.SoGeoElevationGrid
All Implemented Interfaces:
SafeDisposable
public class SoGeoElevationGrid extends SoIndexedFaceSet
Specifies a uniform grid of elevation values within some spatial reference frame. The SoGeoElevationGrid allows to create terrain models for local or large areas (automatically introduces correct degree of earth curvature).

The SoGeoElevationGrid node specifies a uniform grid of elevation values within some spatial reference frame. These are then transparently transformed into a geocentric, curved-earth representation. For example, this would allow a geographer to create a height field where all coordinates are specified in terms of latitude, longitude, and elevation. The geoSystem field is used to define the spatial reference frame and is described in 25.2.3 Specifying a spatial reference frame. The geoGridOrigin field specifies the geographic coordinate for the south-west corner (bottom-left) of the dataset. This value should be specified as described in 25.2.4 Specifying geospatial coordinates. The height array contains xDimensionzDimension floating point values that represent elevation above the ellipsoid or the geoid, as appropriate. These values are given in row-major order from west to east, south to north. When the geoSystem is "GD", xSpacing refers to the number of degrees of longitude between adjacent height values and zSpacing refers to the number of degrees of latitude between vertical height values. When the geoSystem is "UTM", xSpacing refers to the number of eastings (meters) between adjacent height values and zSpacing refers to the number of northings (meters) between vertical height values. EXAMPLE If xDimension = n and the grid spans d units horizontally, the xSpacing value should be set to: d / (n-1). The yScale value can be used to produce a vertical exaggeration of the data when it is displayed. By default, this value is 1.0 (no exaggeration). If this value is set greater than 1.0, all heights will appear larger than actual.

File format/default:

GeoElevationGrid {

    yScale 1.0
    geoGridOrigin 0 0 0
    geoSystem ["GD","WE"]
    height []
    xDimension 0
    xSpacing 1.0
    zDimension 0
    zSpacing 1.0
}

Action behavior:

SoGLRenderAction

  • Field Details

    • yScale

      public final SoSFFloat yScale
      The yScale value can be used to produce a vertical exaggeration of the data when it is displayed. By default, this value is 1.0 (no exaggeration). If this value is set greater than 1.0, all heights will appear larger than actual.

    • geoGridOrigin

      public final SoSFVec3f geoGridOrigin
      Specifies the geographic coordinate for the south-west corner (bottom-left) of the dataset.

    • 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).

    • height

      public final SoMFFloat height
      The height array contains xDimension * zDimension floating point values that represent elevation above the ellipsoid or the geoid, as appropriate. These values are given in row-major order from west to east, south to north.

    • xDimension

      public final SoSFInt32 xDimension
      Number of X values in the grid.

    • xSpacing

      public final SoSFFloat xSpacing
      Spacing between X values.
      When the geoSystem is "GD", xSpacing refers to the number of degrees of longitude between adjacent height values. When the geoSystem is "UTM", xSpacing refers to the number of eastings (meters) between adjacent height values.

    • zDimension

      public final SoSFInt32 zDimension
      Number of Z values in the grid.

    • zSpacing

      public final SoSFFloat zSpacing
      Spacing between Z values.
      When the geoSystem is "GD", zSpacing refers to the number of degrees of latitude between vertical height values. When the geoSystem is "UTM", zSpacing refers to the number of northings (meters) between vertical height values.

  • Constructor Details

    • SoGeoElevationGrid

      public SoGeoElevationGrid()
      Constructor.