Package org.web3d.x3d.sai.Picking

Interface PrimitivePickSensor

All Superinterfaces:
X3DChildNode, X3DNode, X3DPickSensorNode, X3DSensorNode
All Known Implementing Classes:
PrimitivePickSensor
public interface PrimitivePickSensor extends X3DPickSensorNode
If a non-uniform scale is applied to the pick sensor, correct results may require level 3 support.

Warning: this is an abstract interface that cannot be instantiated as a concrete object. Java programmers typically only need to use concrete objects provided by the org.web3d.x3d.jsail classes. PrimitivePickSensor node tooltip: (X3D version 3.2 or later) [X3DPickSensorNode] PrimitivePickSensor tests picking intersections using one of the basic primitive shapes specified in the pickingGeometry field [Cone|Cylinder|Sphere|Box] against the pickTarget geometry.
  • Warning: boolean fields used to control visibility of primitive pickingGeometry subsections are ignored when evaluating picking intersections. Example: a Cylinder without end caps is still treated as an enclosed Cylinder.
  • Hint: Sorting is defined based on the primitive type as follows. For Cone, the closest picked primitive is defined to be that closest to the vertex point. For Cylinder, Box, and Sphere, the closest picked primitive is defined to be that closest to the center.
  • Hint: picking is performed between rendered frames of the event model. An author sets up the picking request in one frame by placing a LinePickSensor in the desired location. At the start of the next frame, any picking intersections are reported by the pick sensor.
  • Hint: picking notification is performed at the start of the frame for all enabled pick sensors once all other sensors are processed.
  • Hint: event timing details are explained in X3D Specification 4.4.8.3 Execution model https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS /Part01/concepts.html#ExecutionModel
  • Warning: order of contained nodes is significant, single pickingGeometry node must precede pickTarget node array.
  • Hint: Box, Cone, Cylinder or Sphere can be used for pickingGeometry node.

Package hint: This interface is defined by the X3D Java Language Binding Specification for the Scene Authoring Interface (SAI).
See Also: