GeoPositionInterpolator
Overview
GeoPositionInterpolator animates objects within a geographic coordinate system. GeoPositionInterpolator can contain a GeoOrigin node.
The GeoPositionInterpolator node belongs to the Geospatial component and requires at least level 1, its default container field is children. It is available from X3D version 3.0 or higher.
Hierarchy
1
2
3
4
+ X3DNode
+ X3DChildNode
+ X3DInterpolatorNode
+ GeoPositionInterpolator
Fields
SFNode [in, out] metadata NULL [X3DMetadataObject]
Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
Hint
SFNode [ ] geoOrigin NULL [GeoOrigin] (deprecated)
Single contained GeoOrigin node that can specify a local coordinate frame for extended precision.
Hint
Warning
- XML validation requires placement as first child node following contained metadata nodes (if any).
MFString [ ] geoSystem [ “GD”, “WE” ]
Identifies spatial reference frame: Geodetic (GD), Geocentric (GC), Universal Transverse Mercator (UTM). Supported values: “GD” “UTM” or “GC” followed by additional quoted string parameters as appropriate for the type.
Hints
- X3D Architecture 25.2.2 Spatial reference frames
- X3D Architecture 25.2.4 Specifying geospatial coordinates
- UTM is Universal Transverse Mercator coordinate system
Warning
- Deprecated values are GDC (replaced by GD) and GCC (replaced by GC).
SFFloat [in] set_fraction (-∞,∞)
set_fraction selects input key for corresponding keyValue output.
Hint
- set_fraction values are typically in same range interval as values in the key array. Response to an input set_fraction value less than minimum is equivalent to minimum key, and response to an input set_fraction value greater than maximum is equivalent to maximum key.
Warning
- It is an error to define this transient inputOnly field in an X3D file, instead only use it a destination for ROUTE events.
MFFloat [in, out] key [ ] (-∞,∞)
Definition values for linear-interpolation function input intervals, listed in non-decreasing order and corresponding to a value in the keyValue array.
Hint
- Typical interval for values in key array is within range of 0 to 1, but larger intervals can be defined with arbitrary bounds.
Warnings
- Number of keys must match number of keyValues!
- Values in key array shall be monotonically non-decreasing, meaning that each value is greater than or equal to the preceding value.
MFVec3d [in, out] keyValue [ ]
Output values for linear interpolation, each corresponding to an input-fraction value in the key array.
Hint
Warning
- Number of keys must match number of keyValues!
SFVec3f [out] value_changed
Linearly interpolated output value determined by current key time and corresponding keyValue pair.
Hint
- X3D players might not send unchanging intermediate values, thus avoiding excessive superfluous events that have no effect.
Warning
- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
SFVec3d [out] geovalue_changed
Interpolated coordinate in the geographic coordinate system specified by geoSystem
Hint
Warnings
- Requires X3D
profile='Full'or else include<component name='Geospatial' level='1'/> - It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
Advice
Hints
- Typical input connection is ROUTE someTimeSensorDEF.fraction_changed TO thisInterpolatorDEF.set_fraction
- Typical output connection is ROUTE thisInterpolatorDEF.value_changed TO someDestinationNodeDEF.set_someAttribute.
- X3D for Advanced Modeling (X3D4AM) slideset
Warning
- Requires X3D
profile='Full'or else include<component name='Geospatial' level='1'/>