Post

GeoTouchSensor

Posted Updated
By CREATE3000 3 min read

Overview

GeoTouchSensor returns geographic coordinates for the object being selected. GeoTouchSensor can contain a GeoOrigin node.

The GeoTouchSensor 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
5
6

+ X3DNode
  + X3DChildNode
    + X3DSensorNode
      + X3DPointingDeviceSensorNode
        + X3DTouchSensorNode
          + GeoTouchSensor

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

SFString [in, out] description “”

Author-provided prose that describes intended purpose of this node.

Hints

  • Include space characters since a description is not a DEF identifier. Write short phrases that make descriptions clear and readable.
  • Many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as & for & ampersand character, or " for “ quotation-mark character).

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 (G D), Geocentric (GC), Universal Transverse Mercator (UTM). Supported values: “GD” “UTM” or “GC” followed by additional quoted string parameters as appropriate for the type.

Hints

Warning

  • Deprecated values are GDC (replaced by GD) and GCC (replaced by GC).

SFBool [in, out] enabled TRUE

Enables/disables node operation.

SFVec2f [out] hitTexCoord_changed

Output event containing texture coordinates of surface at the hitGeoCoordinate.

Warning

  • It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.

SFVec3f [out] hitNormal_changed

Output event containing surface normal vector at the hitGeoCoordinate.

Warning

  • It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.

SFVec3f [out] hitPoint_changed

Output event containing 3D point on surface of underlying geometry, given in geometry coordinates (not geographic coordinates).

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] hitGeoCoord_changed

Output event containing 3D point on surface of underlying geometry, given in GeoTouchSensor’s local coordinate system.

Warning

  • It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.

SFBool [out] isOver

Is pointing device over sensor’s geometry?.

Warning

  • It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.

SFBool [out] isActive

Select geometry by activating the pointing device (for example, clicking the mouse) to generate isActive events. Output event isActive=true is sent when geometry is selected (for example, when primary mouse button is pressed), output event isActive=false is sent when geometry is deselected (for example, when primary mouse button is released).

Warning

  • It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.

SFTime [out] touchTime

Time event generated when touched.

Hint

  • touchTime event is generated when following three conditions are all met: (a) pointing device was pointing towards geometry when initially activated (isActive=true), (b) pointing device is currently pointing towards the geometry (isOver=true), and (c) pointing device selection is deactivated/deselected by user (isActive=false event is also generated).

Warning

  • 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

Warning

  • Requires X3D profile='Full' or else include <component name='Geospatial' level='1'/>

See Also

Geospatial

components, Geospatial
GeoTouchSensor Geospatial
This post is licensed under CC BY 4.0 by the author.