com.sun.j3d.utils.behaviors.keyboard
Class KeyNavigatorBehavior

java.lang.Object
  |
  +--javax.media.j3d.SceneGraphObject
        |
        +--javax.media.j3d.Node
              |
              +--javax.media.j3d.Leaf
                    |
                    +--javax.media.j3d.Behavior
                          |
                          +--com.sun.j3d.utils.behaviors.keyboard.KeyNavigatorBehavior

All Implemented Interfaces:

java.util.EventListener, java.awt.event.KeyListener

public class KeyNavigatorBehavior

extends Behavior

implements java.awt.event.KeyListener

This class is a simple behavior that invokes the KeyNavigator to modify the view platform transform.

Fields inherited from class javax.media.j3d.Node

ALLOW_AUTO_COMPUTE_BOUNDS_READ, ALLOW_AUTO_COMPUTE_BOUNDS_WRITE, ALLOW_BOUNDS_READ, ALLOW_BOUNDS_WRITE, ALLOW_COLLIDABLE_READ, ALLOW_COLLIDABLE_WRITE, ALLOW_LOCAL_TO_VWORLD_READ, ALLOW_PICKABLE_READ, ALLOW_PICKABLE_WRITE, ENABLE_COLLISION_REPORTING, ENABLE_PICK_REPORTING

Constructor Summary

KeyNavigatorBehavior(java.awt.Component c, TransformGroup targetTG)
Constructs a key navigator behavior that uses AWT listeners and behavior posts rather than WakeupOnAWTEvent.

KeyNavigatorBehavior(TransformGroup targetTG)
Constructs a new key navigator behavior node that operates on the specified transform group.

Method Summary

void	addListener(java.awt.Component c) Adds this behavior as a KeyListener to the specified component.
void	initialize() Override Behavior's initialize method to setup wakeup criteria.
void	keyPressed(java.awt.event.KeyEvent evt)
void	keyReleased(java.awt.event.KeyEvent evt)
void	keyTyped(java.awt.event.KeyEvent evt)
void	processStimulus(java.util.Enumeration criteria) Override Behavior's stimulus method to handle the event.

Methods inherited from class javax.media.j3d.Behavior

getEnable, getSchedulingBoundingLeaf, getSchedulingBounds, getView, postId, setEnable, setSchedulingBoundingLeaf, setSchedulingBounds, updateNodeReferences, wakeupOn

Methods inherited from class javax.media.j3d.Node

cloneNode, cloneTree, cloneTree, cloneTree, cloneTree, cloneTree, cloneTree, duplicateNode, getBounds, getBoundsAutoCompute, getCollidable, getLocalToVworld, getLocalToVworld, getParent, getPickable, setBounds, setBoundsAutoCompute, setCollidable, setPickable

Methods inherited from class javax.media.j3d.SceneGraphObject

clearCapability, duplicateSceneGraphObject, getCapability, getUserData, isCompiled, isLive, setCapability, setUserData

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

KeyNavigatorBehavior

public KeyNavigatorBehavior(TransformGroup targetTG)

Constructs a new key navigator behavior node that operates on the specified transform group.

Parameters:

targetTG - the target transform group

KeyNavigatorBehavior

public KeyNavigatorBehavior(java.awt.Component c,
                            TransformGroup targetTG)

Constructs a key navigator behavior that uses AWT listeners and behavior posts rather than WakeupOnAWTEvent. The behavior is added to the specified Component and works on the given TransformGroup. A null component can be passed to specify the behavior should use listeners. Components can then be added to the behavior with the addListener(Component c) method.

Parameters:

c - The component to add the KeyListener to.

targetTG - The target transform group.

Since:

Java 3D 1.2.1

Method Detail

initialize

public void initialize()

Override Behavior's initialize method to setup wakeup criteria.

Overrides:

initialize in class Behavior

processStimulus

public void processStimulus(java.util.Enumeration criteria)

Override Behavior's stimulus method to handle the event.

Overrides:

processStimulus in class Behavior

Following copied from class: javax.media.j3d.Behavior

Parameters:

criteria - an enumeration of triggered wakeup criteria for this behavior

addListener

public void addListener(java.awt.Component c)

Adds this behavior as a KeyListener to the specified component. This method can only be called if the behavior was created with one of the constructors that takes a Component as a parameter.

Parameters:

c - The component to add the KeyListener to.

Throws:

java.lang.IllegalStateException - if the behavior was not created as a listener

Since:

Java 3D 1.2.1

keyPressed

public void keyPressed(java.awt.event.KeyEvent evt)

Specified by:

keyPressed in interface java.awt.event.KeyListener

keyReleased

public void keyReleased(java.awt.event.KeyEvent evt)

Specified by:

keyReleased in interface java.awt.event.KeyListener

keyTyped

public void keyTyped(java.awt.event.KeyEvent evt)

Specified by:

keyTyped in interface java.awt.event.KeyListener