PickableGeometry Class

Creates an object representing a pickable geometry behavior. The behavior is identical to a geometry behavior except that an event occurs whenever the mouse pointer is "in" the geometry.

Applets typically use the event returned by the getPickEvent method to set an event handler or to create a reactive behavior with the until or untilNotify method.

When the pick event occurs, the event data is a PairObject object. The first element is a Point3Bvr object representing the intersection point, and the second element is a Vector3Bvr object that is a time-varying vector. The vector gives the model-coordinate offset to the point that is in the plane perpendicular to the viewing direction (from the camera's image plane), and is under the two-dimensional mouse's location.

PickableGeometry Methods

getGeometryBvr Retrieves the GeometryBvr object.

getPickEvent Creates an event for the pickable geometry behavior.

PickableGeometry Creates a pickable GeometryBvr object.

getGeometryBvr

PickableGeometry Class

Retrieves the GeometryBvr object.

Syntax

public GeometryBvr getGeometryBvr( );

Return Value

Returns the GeometryBvr object.

getPickEvent

PickableGeometry Class

Creates an event for the pickable geometry behavior.

Syntax

public DXMEvent getPickEvent( );

Return Value

Returns a DXMEvent object. Its data is a PairObject. The first member is the intersection point that is in the plane perpendicular to the viewing direction and is under the mouse. The second member is a time-varying vector that gives the model-coordinate offset to the intersection point. Each sample taken while the mouse is over the object returns a new point and a new time-varying vector. Each time-varying vector tracks the mouse, relative to the associated intersection point.

Remarks

Use this event to set an event handler or create a reactive behavior with the until or untilNotify method.

PickableGeometry

PickableGeometry Class

Creates a pickable GeometryBvr object.

Syntax

public PickableGeometry( GeometryBvr geo );

Parameters

geo
New instance of a GeometryBvr that is pickable.