com.openinventor.inventor.geo

Class SoVRMLGeoElevationGrid

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.vrmlnodes.SoVRMLGeometry

com.openinventor.inventor.vrmlnodes.SoVRMLGridShape

com.openinventor.inventor.vrmlnodes.SoVRMLElevationGrid

com.openinventor.inventor.geo.SoVRMLGeoElevationGrid

All Implemented Interfaces:

SafeDisposable

Deprecated.

As of Open Inventor 9500 See documentation for more details

public class SoVRMLGeoElevationGrid
extends SoVRMLElevationGrid

Specifies a uniform grid of elevation values within some spatial reference frame. The SoVRMLGeoElevationGrid allows to create terrain models for local or large areas (automatically introduces correct degree of earth curvature).

VRML X3D SPECIFICATION

This section describes the expected behavior of the node in a conforming X3D / VRML97 browser application. In some cases, the application is responsible for implementing portions of the expected behavior. Open Inventor viewer classes and IVF classes implement some of the application behaviors.

This section may reference portions of the X3D specification that are not present in this help file. The complete X3D spec is available at http://www.web3d.org.

The SoVRMLGeoElevationGrid 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 fields color, colorPerVertex, texCoord, normal, and normalPerVertex all have the same meaning as for ElevationGrid (see 13.3.4 ElevationGrid). The ccw, solid, and creaseAngle fields are described in 11.2.3 Common geometry fields. The geoOrigin field is used to specify a local coordinate frame for extended precision as described in 25.2.5 Dealing with high-precision coordinates. 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 (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. 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:

VRMLGeoElevationGrid {

color	NULL
metadata	NULL
normal	NULL
texCoord	NULL
yScale	1.0
ccw	true
colorPerVertex	true
creaseAngle	0
geoGridOrigin	0 0 0
geoOrigin	NULL
geoSystem	["GD","WE"]
height	[]
normalPerVertex	true
solid	true
xDimension	0
xSpacing	1.0
zDimension	0
zSpacing	1.0

}

Action behavior:

SoGLRenderAction

EVENTS

eventIn

SoMFFloat	set_height
SoSFNode	set_color
SoSFNode	set_normal
SoSFNode	set_texCoord
SoSFNode	set_metadata

eventOut

SoSFNode	color_changed
SoSFNode	normal_changed
SoSFNode	texCoord_changed
SoSFNode	metadata_changed

Deprecated since Open Inventor 9500
The VRML API is no longer supported. See section http://oivdoc95.vsg3d.com/content/compatibility-notes-4#Deprecation of the Reference Manual.

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.Inventor

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
SoSFVec3f	geoGridOrigin Deprecated. Specifies the geographic coordinate for the south-west corner (bottom-left) of the dataset.
SoSFNode	geoOrigin Deprecated. An SoVRMLGeoOrigin node specifying the origin of the local coordinate system.
SoMFString	geoSystem Deprecated. Defines the spatial reference frame.
SoSFFloat	yScale Deprecated. The yScale value can be used to produce a vertical exaggeration of the data when it is displayed.

Fields inherited from class com.openinventor.inventor.vrmlnodes.SoVRMLElevationGrid

ccw, creaseAngle, solid

Fields inherited from class com.openinventor.inventor.vrmlnodes.SoVRMLGridShape

color, colorPerVertex, height, normal, normalPerVertex, texCoord, xDimension, xSpacing, zDimension, zSpacing

Fields inherited from class com.openinventor.inventor.vrmlnodes.SoVRMLGeometry

metadata

Fields inherited from class com.openinventor.inventor.nodes.SoShape

boundingBoxIgnoring, LINES, POINTS, POLYGONS, TEXT

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and Description
SoVRMLGeoElevationGrid() Deprecated. Constructor.

Method Summary

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, 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, getEXTERNPROTO, getName, getPROTO, isDisposable, isSynchronizable, setName, setSynchronizable

Methods inherited from class com.openinventor.inventor.Inventor

getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

yScale

public final SoSFFloat yScale

Deprecated.

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

Deprecated.

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

geoSystem

public final SoMFString geoSystem

Deprecated.

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 using one of the ellipsoid codes that are defined in X3D. 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 "Z<n>", 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).

geoOrigin

public final SoSFNode geoOrigin

Deprecated.

An SoVRMLGeoOrigin node specifying the origin of the local coordinate system.

Constructor Detail

SoVRMLGeoElevationGrid

public SoVRMLGeoElevationGrid()

Deprecated.

Constructor.