Package org.web3d.x3d.sai.Geospatial

Interface GeoProximitySensor

All Superinterfaces:
X3DChildNode, X3DEnvironmentalSensorNode, X3DNode, X3DSensorNode
All Known Implementing Classes:
GeoProximitySensorObject
public interface GeoProximitySensor
extends X3DEnvironmentalSensorNode
GeoProximitySensor generates events when the viewer enters, exits and moves within a region of space (defined by a box).

X3D node tooltip: (X3D version 3.2 or later) [X3DEnvironmentalSensorNode] GeoProximitySensor generates events when the viewer enters, exits and moves within a region of space (defined by a box).
Package hint: This interface is defined by the X3D Java Language Binding Specification for the Scene Authoring Interface (SAI).
See Also:
SAI Java Specification: TODO, X3D Abstract Specification: GeoProximitySensor, X3D Tooltips: GeoProximitySensor, X3D Scene Authoring Hints

  • Method Summary

    Modifier and Type Method Description
    double[] getCenter()
    Provide array of 3-tuple double results from inputOutput SFVec3d field named center.
    float[] getCenterOfRotation()
    Provide array of 3-tuple float results unit axis, angle (in radians) from outputOnly SFVec3f field named centerOfRotation_changed.
    boolean getEnabled()
    Provide boolean value from inputOutput SFBool field named enabled.
    double getEnterTime()
    Provide double value in seconds from outputOnly SFTime field named enterTime.
    double getExitTime()
    Provide double value in seconds from outputOnly SFTime field named exitTime.
    double[] getGeoCenter()
    Provide array of 3-tuple double results from inputOutput SFVec3d field named geoCenter.
    double[] getGeoCoord()
    Provide array of 3-tuple double results from outputOnly SFVec3d field named geoCoord_changed.
    GeoOrigin getGeoOrigin()
    Provide GeoOrigin instance (using a properly typed node) (deprecated node, optional) from initializeOnly SFNode field geoOrigin.
    java.lang.String[] getGeoSystem()
    Provide array of String results from initializeOnly MFString field named geoSystem.
    boolean getIsActive()
    Provide boolean value from outputOnly SFBool field named isActive.
    X3DMetadataObject getMetadata()
    Provide X3DMetadataObject instance (using a properly typed node) from inputOutput SFNode field metadata.
    float[] getOrientation()
    Provide array of 4-tuple float results unit axis, angle (in radians) from outputOnly SFRotation field named orientation_changed.
    float[] getPosition()
    Provide array of 3-tuple float results from outputOnly SFVec3f field named position_changed.
    float[] getSize()
    Provide array of 3-tuple float results within allowed range of [0,infinity) from initializeOnly SFVec3f field named size.
    GeoProximitySensor setCenter​(double[] newValue)
    Accessor method to assign 3-tuple double array to inputOutput SFVec3d field named center.
    GeoProximitySensor setEnabled​(boolean newValue)
    Accessor method to assign boolean value to inputOutput SFBool field named enabled.
    GeoProximitySensor setGeoCenter​(double[] newValue)
    Accessor method to assign 3-tuple double array to inputOutput SFVec3d field named geoCenter.
    GeoProximitySensor setGeoOrigin​(GeoOrigin newValue)
    Accessor method to assign GeoOrigin instance (using a properly typed node) to initializeOnly SFNode field geoOrigin.
    GeoProximitySensor setGeoSystem​(java.lang.String[] newValue)
    Accessor method to assign String array to initializeOnly MFString field named geoSystem.
    GeoProximitySensor setMetadata​(X3DMetadataObject newValue)
    Accessor method to assign X3DMetadataObject instance (using a properly typed node) to inputOutput SFNode field metadata.
    GeoProximitySensor setSize​(float[] newValue)
    Accessor method to assign 3-tuple float array to initializeOnly SFVec3f field named size.

  • Method Details

    • getCenter

      double[] getCenter()
      Provide array of 3-tuple double results from inputOutput SFVec3d field named center.

      Tooltip: (starting with v3.3) Position offset from origin of local coordinate system. *
      Returns:
      value of center field

    • setCenter

      GeoProximitySensor setCenter​(double[] newValue)
      Accessor method to assign 3-tuple double array to inputOutput SFVec3d field named center.

      Tooltip: (starting with v3.3) Position offset from origin of local coordinate system. *
      Parameters:
      newValue - is new value for the center field.
      Returns:
      GeoProximitySensor - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

    • getCenterOfRotation

      float[] getCenterOfRotation()
      Provide array of 3-tuple float results unit axis, angle (in radians) from outputOnly SFVec3f field named centerOfRotation_changed.

      Tooltip: Sends changed centerOfRotation values, likely caused by user interaction.
      • Warning: it is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
      Returns:
      value of centerOfRotation_changed field

    • getEnabled

      boolean getEnabled()
      Provide boolean value from inputOutput SFBool field named enabled.

      Tooltip: Enables/disables node operation. *
      Specified by:
      getEnabled in interface X3DEnvironmentalSensorNode
      Specified by:
      getEnabled in interface X3DSensorNode
      Returns:
      value of enabled field

    • setEnabled

      GeoProximitySensor setEnabled​(boolean newValue)
      Accessor method to assign boolean value to inputOutput SFBool field named enabled.

      Tooltip: Enables/disables node operation. *
      Specified by:
      setEnabled in interface X3DEnvironmentalSensorNode
      Specified by:
      setEnabled in interface X3DSensorNode
      Parameters:
      newValue - is new value for the enabled field.
      Returns:
      GeoProximitySensor - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

    • getEnterTime

      double getEnterTime()
      Provide double value in seconds from outputOnly SFTime field named enterTime.

      Tooltip: Time event generated when user's camera enters the box.
      • Warning: it is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
      Returns:
      value of enterTime field

    • getExitTime

      double getExitTime()
      Provide double value in seconds from outputOnly SFTime field named exitTime.

      Tooltip: Time event generated when user's camera exits the box.
      • Warning: it is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
      Returns:
      value of exitTime field

    • getGeoCenter

      double[] getGeoCenter()
      Provide array of 3-tuple double results from inputOutput SFVec3d field named geoCenter.

      Tooltip: (deprecated as of v3.3) Position offset from origin of local coordinate system.
      Returns:
      value of geoCenter field

    • setGeoCenter

      GeoProximitySensor setGeoCenter​(double[] newValue)
      Accessor method to assign 3-tuple double array to inputOutput SFVec3d field named geoCenter.

      Tooltip: (deprecated as of v3.3) Position offset from origin of local coordinate system.
      Parameters:
      newValue - is new value for the geoCenter field.
      Returns:
      GeoProximitySensor - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

    • getGeoCoord

      double[] getGeoCoord()
      Provide array of 3-tuple double results from outputOnly SFVec3d field named geoCoord_changed.

      Tooltip: Sends geospatial coordinates of viewer's position corresponding to world position returned by position_changed.
      Returns:
      value of geoCoord_changed field

    • getGeoOrigin

      GeoOrigin getGeoOrigin()
      Provide GeoOrigin instance (using a properly typed node) (deprecated node, optional) from initializeOnly SFNode field geoOrigin.
      Returns:
      value of geoOrigin field

    • setGeoOrigin

      GeoProximitySensor setGeoOrigin​(GeoOrigin newValue)
      Accessor method to assign GeoOrigin instance (using a properly typed node) to initializeOnly SFNode field geoOrigin.
      Parameters:
      newValue - is new value for the geoOrigin field.
      Returns:
      GeoProximitySensor - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

    • getGeoSystem

      java.lang.String[] getGeoSystem()
      Provide array of String results from initializeOnly MFString field named geoSystem.

      Tooltip: 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.
      Returns:
      value of geoSystem field

    • setGeoSystem

      GeoProximitySensor setGeoSystem​(java.lang.String[] newValue)
      Accessor method to assign String array to initializeOnly MFString field named geoSystem.

      Tooltip: 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.
      Parameters:
      newValue - is new value for the geoSystem field.
      Returns:
      GeoProximitySensor - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

    • getIsActive

      boolean getIsActive()
      Provide boolean value from outputOnly SFBool field named isActive.

      Tooltip: isActive true/false events are sent as viewer enters/exits Proximity box. isActive=true when viewer enters Proximity box, isActive=false when viewer exits Proximity box.
      • Warning: it is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
      Specified by:
      getIsActive in interface X3DEnvironmentalSensorNode
      Specified by:
      getIsActive in interface X3DSensorNode
      Returns:
      value of isActive field

    • getMetadata

      X3DMetadataObject getMetadata()
      Provide X3DMetadataObject instance (using a properly typed node) from inputOutput SFNode field metadata.

      Tooltip: [X3DMetadataObject] Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
      Specified by:
      getMetadata in interface X3DChildNode
      Specified by:
      getMetadata in interface X3DEnvironmentalSensorNode
      Specified by:
      getMetadata in interface X3DNode
      Specified by:
      getMetadata in interface X3DSensorNode
      Returns:
      value of metadata field
      See Also:
      X3D Scene Authoring Hints: Metadata Nodes

    • setMetadata

      GeoProximitySensor setMetadata​(X3DMetadataObject newValue)
      Accessor method to assign X3DMetadataObject instance (using a properly typed node) to inputOutput SFNode field metadata.

      Tooltip: [X3DMetadataObject] Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
      Specified by:
      setMetadata in interface X3DChildNode
      Specified by:
      setMetadata in interface X3DEnvironmentalSensorNode
      Specified by:
      setMetadata in interface X3DNode
      Specified by:
      setMetadata in interface X3DSensorNode
      Parameters:
      newValue - is new value for the metadata field.
      Returns:
      GeoProximitySensor - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).
      See Also:
      X3D Scene Authoring Hints: Metadata Nodes

    • getOrientation

      float[] getOrientation()
      Provide array of 4-tuple float results unit axis, angle (in radians) from outputOnly SFRotation field named orientation_changed.

      Tooltip: Sends rotation event relative to center.
      • Warning: it is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
      Returns:
      value of orientation_changed field

    • getPosition

      float[] getPosition()
      Provide array of 3-tuple float results from outputOnly SFVec3f field named position_changed.

      Tooltip: Sends translation event relative to center.
      • Warning: it is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
      Returns:
      value of position_changed field

    • getSize

      float[] getSize()
      Provide array of 3-tuple float results within allowed range of [0,infinity) from initializeOnly SFVec3f field named size.

      Tooltip: [0,+infinity) size of Proximity box.
      • Hint: size 0 0 0 is same as enabled false.
      Specified by:
      getSize in interface X3DEnvironmentalSensorNode
      Returns:
      value of size field

    • setSize

      GeoProximitySensor setSize​(float[] newValue)
      Accessor method to assign 3-tuple float array to initializeOnly SFVec3f field named size.

      Tooltip: [0,+infinity) size of Proximity box.
      • Hint: size 0 0 0 is same as enabled false.
      Specified by:
      setSize in interface X3DEnvironmentalSensorNode
      Parameters:
      newValue - is new value for the size field.
      Returns:
      GeoProximitySensor - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).