org.j3d.aviatrix3d.picking
Interface CustomPickTarget

All Superinterfaces:

PickTarget

All Known Implementing Classes:

Billboard, LODGroup

public interface CustomPickTarget
extends PickTarget

Marker interface for all grouping objects that wish to interact with the picking system, but provide some sort of customised handling.

This interface is used by programmers that require fairly complex implementation logic at the point of picking (eg a billboarded object that should be pickable from any direction, even though it is represented as a plane facing the current viewpoint location).

Implementor Requirements

• The methods must be re-entrant as they can be called from multiple places at once. For example, multiple pipes rendering the same object on different screens simultaneously.
• All state must be maintained within this class but it should not directly do picking from the provided PickRequest object. That object is provided so that the implementation may make some calculations about where the picking object is currently located in the local space and other items that may be useful, such as the picking type. The bounds of the object will not be tested first before this method is called. The implementor can use the request object to do that testing and return the appropriate list of children.

Implementor Guidelines

Version:

$Revision: 1.3 $

Author:

Justin Couch

Field Summary

Fields inherited from interface org.j3d.aviatrix3d.picking.PickTarget

CUSTOM_PICK_TYPE, GROUP_PICK_TYPE, LEAF_PICK_TYPE, SINGLE_PICK_TYPE

Method Summary

void	pickChildren(PickInstructions output, javax.vecmath.Matrix4f vworldTx, PickRequest req) This node is being subjected to picking, so process the provided data and return the instructions on the list of available children and any transformation information to the system.

Methods inherited from interface org.j3d.aviatrix3d.picking.PickTarget

checkPickMask, getPickableBounds, getPickTargetType

Method Detail

pickChildren

void pickChildren(PickInstructions output,
                  javax.vecmath.Matrix4f vworldTx,
                  PickRequest req)

This node is being subjected to picking, so process the provided data and return the instructions on the list of available children and any transformation information to the system.

Parameters:

output - Fill in the results of the picking evaluation here

vworldTx - The transformation from the root of the scene to this node according to the current traversal path

req - The picking request made of this object