com.openinventor.inventor.geo

Class SoGeoCoordinate

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

com.openinventor.inventor.geo.SoGeoCoordinate

All Implemented Interfaces:

SafeDisposable

public class SoGeoCoordinate
extends SoCoordinate3

Geographic coordinates node. The SoGeoCoordinate node allows applications to build geometry using geographic coordinates

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 SoGeoCoordinate node specifies a list of coordinates in a spatial reference frame. It can be used in place of an SoCoordinate3 node. The geoSystem field is used to define the spatial reference frame and is described in 25.2.3 Specifying a spatial reference frame. The point array is used to contain the actual geospatial coordinates and should be provided in a format consistent with that specified for the particular geoSystem (see above). The geospatial coordinates are transparently transformed into a geocentric, curved-earth representation. For example, this would allow a geographer to create a X3D world where all coordinates are specified in terms of latitude, longitude, and elevation.

File format/default:

GeoCoordinate {

point	[]
geoSystem	["GD","WE"]

}

Action behavior:

SoGLRenderAction, SoGetBoundingBoxAction, SoCallbackAction

Nested Class Summary

Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
SoMFString	geoSystem Defines the spatial reference frame.

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

point

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and Description
SoGeoCoordinate() Constructor.

Method Summary

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

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

Constructor Detail

SoGeoCoordinate

public SoGeoCoordinate()

Constructor.