Class PickTool
- Direct Known Subclasses:
PickCanvas
The pick mode specifies the detail level of picking before the PickResult is returned:
- PickTool.BOUNDS - Pick using the bounds of the pickable nodes. The PickResult returned will contain the SceneGraphPath to the picked Node.
- PickTool.GEOMETRY will pick using the geometry of the pickable nodes. The PickResult returned will contain the SceneGraphPath to the picked Node. Geometry nodes in the scene must have the ALLOW_INTERSECT capability set for this mode.
- PickTool.GEOMETRY_INTERSECT_INFO -is the same as GEOMETRY, but the the PickResult will also include information on each intersection of the pick shape with the geometry. The intersection information includes the sub-primitive picked (that is, the point, line, triangle or quad), the closest vertex to the center of the pick shape, and the intersection's coordinate, normal, color and texture coordinates. To allow this information to be generated, Shape3D and Morph nodes must have the ALLOW_GEOMETRY_READ capability set and GeometryArrays must have the ALLOW_FORMAT_READ, ALLOW_COUNT_READ, and ALLOW_COORDINATE_READ capabilities set, plus the ALLOW_COORDINATE_INDEX_READ capability for indexed geometry. To inquire the intersection color, normal or texture coordinates the corresponding READ capability bits must be set on the GeometryArray.
The utility method
PickTool.setCapabilities(Node, int)
can be used before the scene graph is
made live to set the
capabilities of Shape3D, Morph or Geometry
nodes to allow picking.
A PickResult from a lower level of detail pick can be used to inquire more detailed information if the capibility bits are set. This can be used to filter the PickResults before the more computationally intensive intersection processing. For example, the application can do a BOUNDS pick and then selectively inquire intersections on some of the PickResults. This will save the effort of doing intersection computation on the other PickResults. However, inquiring the intersections from a GEOMETRY pick will make the intersection computation happen twice, use GEOMETRY_INTERSECT_INFO if you want to inquire the intersection information on all the PickResults.
When using pickAllSorted or pickClosest methods, the picks will be sorted by the distance from the start point of the pick shape to the intersection point.
Morph nodes cannot be picked using the displayed geometry in GEOMETRY_INTERSECT_INFO mode due to limitations in the current Java3D core API (the current geometry of the the Morph cannot be inquired). Instead they are picked using the geometry at index 0 in the Morph, this limitation may be eliminated in a future release of Java3D.
If the pick shape is a PickBounds, the pick result will contain only the scene graph path, even if the mode is GEOMETRY_INTERSECT_INFO.
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final int
Use this mode to pick by bounds and get basic information on the pick.static final int
Use this mode to pick by geometry and get basic information on the pick.static final int
Use this mode to pick by geometry and save information about the intersections (intersected primitive, intersection point and closest vertex).static final int
Flag to pass tosetCapabilities(Node, int)
to set the Node's capabilities to allow inquiry of the intersection coordinate information.
static final int
Flag to pass tosetCapabilities(Node, int)
to set the Node's capabilities to allow inquiry of all intersection information.
static final int
Flag to pass tosetCapabilities(Node, int)
to set the Node's capabilities to allow intersection tests, but not inquire information about the intersections (use for GEOMETRY mode).
protected boolean
-
Constructor Summary
ConstructorsConstructorDescriptionConstructor with BranchGroup to be picked.Constructor with the Locale to be picked. -
Method Summary
Modifier and TypeMethodDescriptionReturns the BranchGroup to be picked if the tool was initialized with a BranchGroup, null otherwise.Returns the Locale to be picked if the tool was initialized with a Locale, null otherwise.int
getMode()
Gets the picking detail mode.Returns the PickShape for this object.javax.vecmath.Point3d
Returns the start postion used for distance measurement.pickAll()
Selects all the nodes that intersect the PickShape.Select all the nodes that intersect the PickShape, returned sorted.pickAny()
Select one of the nodes that intersect the PickShapeSelect the closest node that intersects the PickShape.Deprecated.This method does nothing other than return its input parameter.static void
setCapabilities
(Node node, int level) Sets the capabilities on the Node and it's components to allow picking at the specified detail level.void
setMode
(int mode) Sets the picking detail mode.void
Sets the pick shape to a user-provided PickShape objectvoid
setShapeBounds
(Bounds bounds, javax.vecmath.Point3d startPt) Sets the pick shape to use a user-provided Bounds objectvoid
setShapeConeRay
(javax.vecmath.Point3d start, javax.vecmath.Vector3d dir, double angle) Sets the pick shape to an infinite PickCone.void
setShapeConeSegment
(javax.vecmath.Point3d start, javax.vecmath.Point3d end, double angle) Sets the pick shape to a capped PickConevoid
setShapeCylinderRay
(javax.vecmath.Point3d start, javax.vecmath.Vector3d dir, double radius) Sets the pick shape to an infinite PickCylinder.void
setShapeCylinderSegment
(javax.vecmath.Point3d start, javax.vecmath.Point3d end, double radius) Sets the pick shape to a capped PickCylindervoid
setShapeRay
(javax.vecmath.Point3d start, javax.vecmath.Vector3d dir) Sets the pick shape to a PickRay.void
setShapeSegment
(javax.vecmath.Point3d start, javax.vecmath.Point3d end) Sets the pick shape to a PickSegment.
-
Field Details
-
userDefineShape
protected boolean userDefineShape -
BOUNDS
public static final int BOUNDSUse this mode to pick by bounds and get basic information on the pick.- See Also:
-
GEOMETRY
public static final int GEOMETRYUse this mode to pick by geometry and get basic information on the pick.- See Also:
-
GEOMETRY_INTERSECT_INFO
public static final int GEOMETRY_INTERSECT_INFOUse this mode to pick by geometry and save information about the intersections (intersected primitive, intersection point and closest vertex).- See Also:
-
INTERSECT_TEST
public static final int INTERSECT_TESTFlag to pass tosetCapabilities(Node, int)
to set the Node's capabilities to allow intersection tests, but not inquire information about the intersections (use for GEOMETRY mode).
-
INTERSECT_COORD
public static final int INTERSECT_COORDFlag to pass tosetCapabilities(Node, int)
to set the Node's capabilities to allow inquiry of the intersection coordinate information.
-
INTERSECT_FULL
public static final int INTERSECT_FULLFlag to pass tosetCapabilities(Node, int)
to set the Node's capabilities to allow inquiry of all intersection information.
-
-
Constructor Details
-
PickTool
Constructor with BranchGroup to be picked. -
PickTool
Constructor with the Locale to be picked.
-
-
Method Details
-
getBranchGroup
Returns the BranchGroup to be picked if the tool was initialized with a BranchGroup, null otherwise. -
getLocale
Returns the Locale to be picked if the tool was initialized with a Locale, null otherwise. -
setBranchGroup
Deprecated.This method does nothing other than return its input parameter. -
setCapabilities
Sets the capabilities on the Node and it's components to allow picking at the specified detail level.Note that by default all com.sun.j3d.utils.geometry.Primitive objects with the same parameters share their geometry (e.g., you can have 50 spheres in your scene, but the geometry is stored only once). Therefore the capabilities of the geometry are also shared, and once a shared node is live, the capabilities cannot be changed. To assign capabilities to Primitives with the same parameters, either set the capabilities before the primitive is set live, or specify the Primitive.GEOMETRY_NOT_SHARED constructor parameter when creating the primitive.
- Parameters:
node
- The node to modifylevel
- The capability level, must be one of INTERSECT_TEST, INTERSECT_COORD or INTERSECT_FULL- Throws:
IllegalArgumentException
- if Node is not a Shape3D or Morph or if the flag value is not valid.RestrictedAccessException
- if the node is part of a live or compiled scene graph.
-
setShape
Sets the pick shape to a user-provided PickShape object- Parameters:
ps
- The pick shape to pick against.startPt
- The start point to use for distance calculations
-
setShapeBounds
Sets the pick shape to use a user-provided Bounds object- Parameters:
bounds
- The bounds to pick against.startPt
- The start point to use for distance calculations
-
setMode
public void setMode(int mode) Sets the picking detail mode. The default is BOUNDS.- Parameters:
mode
- One of BOUNDS, GEOMETRY, GEOMETRY_INTERSECT_INFO, or- Throws:
IllegalArgumentException
- if mode is not a legal value
-
getMode
public int getMode()Gets the picking detail mode. -
setShapeRay
public void setShapeRay(javax.vecmath.Point3d start, javax.vecmath.Vector3d dir) Sets the pick shape to a PickRay.- Parameters:
start
- The start of the raydir
- The direction of the ray
-
setShapeSegment
public void setShapeSegment(javax.vecmath.Point3d start, javax.vecmath.Point3d end) Sets the pick shape to a PickSegment.- Parameters:
start
- The start of the segment p @param end The end of the segment
-
setShapeCylinderSegment
public void setShapeCylinderSegment(javax.vecmath.Point3d start, javax.vecmath.Point3d end, double radius) Sets the pick shape to a capped PickCylinder- Parameters:
start
- The start of axis of the cylinderend
- The end of the axis of the cylinderradius
- The radius of the cylinder
-
setShapeCylinderRay
public void setShapeCylinderRay(javax.vecmath.Point3d start, javax.vecmath.Vector3d dir, double radius) Sets the pick shape to an infinite PickCylinder.- Parameters:
start
- The start of axis of the cylinderdir
- The direction of the axis of the cylinderradius
- The radius of the cylinder
-
setShapeConeSegment
public void setShapeConeSegment(javax.vecmath.Point3d start, javax.vecmath.Point3d end, double angle) Sets the pick shape to a capped PickCone- Parameters:
start
- The start of axis of the coneend
- The end of the axis of the coneangle
- The angle of the cone
-
setShapeConeRay
public void setShapeConeRay(javax.vecmath.Point3d start, javax.vecmath.Vector3d dir, double angle) Sets the pick shape to an infinite PickCone.- Parameters:
start
- The start of axis of the conedir
- The direction of the axis of the coneangle
- The angle of the cone
-
getPickShape
Returns the PickShape for this object. -
getStartPosition
public javax.vecmath.Point3d getStartPosition()Returns the start postion used for distance measurement. -
pickAll
Selects all the nodes that intersect the PickShape.- Returns:
- An array of
PickResult
objects which will contain information about the picked instances.null
if nothing was picked.
-
pickAny
Select one of the nodes that intersect the PickShape- Returns:
- A
PickResult
object which will contain information about the picked instance.null
if nothing was picked.
-
pickAllSorted
Select all the nodes that intersect the PickShape, returned sorted. The "closest" object will be returned first. See note above to see how "closest" is determined.- Returns:
- An array of
PickResult
objects which will contain information about the picked instances.null
if nothing was picked.
-
pickClosest
Select the closest node that intersects the PickShape. See note above to see how "closest" is determined.- Returns:
- A
PickResult
object which will contain information about the picked instance.null
if nothing was picked.
-