Class SoGeoElevationGrid
- java.lang.Object
-
- All Implemented Interfaces:
SafeDisposable
public class SoGeoElevationGrid extends SoIndexedFaceSet
Specifies a uniform grid of elevation values within some spatial reference frame. TheSoGeoElevationGrid
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. ThegeoSystem
field is used to define the spatial reference frame and is described in 25.2.3 Specifying a spatial reference frame. ThegeoGridOrigin
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. Theheight
array containsxDimension
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. When thegeoSystem
is "GD",xSpacing
refers to the number of degrees of longitude between adjacent height values andzSpacing
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 andzSpacing
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). TheyScale
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:
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class com.openinventor.inventor.nodes.SoShape
SoShape.ShapeTypes
-
Nested classes/interfaces inherited from class com.openinventor.inventor.nodes.SoNode
SoNode.RenderModes
-
Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor
Inventor.ConstructorCommand
-
-
Field Summary
Fields Modifier and Type Field Description SoSFVec3f
geoGridOrigin
Specifies the geographic coordinate for the south-west corner (bottom-left) of the dataset.SoMFString
geoSystem
Defines the spatial reference frame.SoMFFloat
height
Theheight
array containsxDimension
*zDimension
floating point values that represent elevation above the ellipsoid or the geoid, as appropriate.SoSFInt32
xDimension
Number of X values in the grid.SoSFFloat
xSpacing
Spacing between X values.SoSFFloat
yScale
The yScale value can be used to produce a vertical exaggeration of the data when it is displayed.SoSFInt32
zDimension
Number of Z values in the grid.SoSFFloat
zSpacing
Spacing between Z values.-
Fields inherited from class com.openinventor.inventor.nodes.SoIndexedFaceSet
SO_END_FACE_INDEX
-
Fields inherited from class com.openinventor.inventor.nodes.SoIndexedShape
coordIndex, materialIndex, normalIndex, tangentIndex, textureCoordIndex
-
Fields inherited from class com.openinventor.inventor.nodes.SoVertexShape
vertexProperty
-
Fields inherited from class com.openinventor.inventor.nodes.SoShape
boundingBoxIgnoring
-
Fields inherited from class com.openinventor.inventor.Inventor
VERBOSE_LEVEL, ZeroHandle
-
-
Constructor Summary
Constructors Constructor Description SoGeoElevationGrid()
Constructor.
-
Method Summary
-
Methods inherited from class com.openinventor.inventor.nodes.SoVertexShape
getNormalCache, getTangentCache
-
Methods inherited from class com.openinventor.inventor.nodes.SoShape
getShapeType, isPrimitiveRestartAvailable, isPrimitiveRestartAvailable
-
Methods inherited from class com.openinventor.inventor.nodes.SoNode
affectsState, callback, copy, copy, distribute, doAction, getAlternateRep, getBoundingBox, getByName, getMatrix, getPrimitiveCount, getRenderEngineMode, getRenderUnitID, GLRender, GLRenderBelowPath, GLRenderInPath, GLRenderOffPath, grabEventsCleanup, grabEventsSetup, handleEvent, isBoundingBoxIgnoring, isOverride, pick, rayPick, search, setOverride, touch, write
-
Methods inherited from class com.openinventor.inventor.fields.SoFieldContainer
copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults
-
Methods inherited from class com.openinventor.inventor.misc.SoBase
dispose, getName, isDisposable, isSynchronizable, setName, setSynchronizable
-
Methods inherited from class com.openinventor.inventor.Inventor
getNativeResourceHandle
-
-
-
-
Field Detail
-
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
Theheight
array containsxDimension
*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 thegeoSystem
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.
-
-