javax.media.ding3d.utils.behaviors.vp
Class ViewPlatformBehavior

java.lang.Object
  extended by javax.media.ding3d.SceneGraphObject
      extended by javax.media.ding3d.Node
          extended by javax.media.ding3d.Leaf
              extended by javax.media.ding3d.Behavior
                  extended by javax.media.ding3d.utils.behaviors.vp.ViewPlatformBehavior
Direct Known Subclasses:
ViewPlatformAWTBehavior, WandViewBehavior

public abstract class ViewPlatformBehavior
extends Behavior

Abstract class for ViewPlatformBehaviors. A ViewPlatformBehavior must be added to the ViewingPlatform with the ViewingPlatform.addViewPlatformBehavior() method. The ViewPlatformBehavior will operate on the ViewPlatform transform (the TransformGroup return by ViewingPlatform.getViewPlatformTransform()).

Since:
Java 3D 1.2.1

Field Summary
 
Fields inherited from class javax.media.ding3d.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_LOCALE_READ, ALLOW_PARENT_READ, ALLOW_PICKABLE_READ, ALLOW_PICKABLE_WRITE, ENABLE_COLLISION_REPORTING, ENABLE_PICK_REPORTING
 
Constructor Summary
ViewPlatformBehavior()
           
 
Method Summary
 void getHomeTransform(Transform3D home)
          Returns the behaviors "home" transform.
 ViewingPlatform getViewingPlatform()
          Returns the ViewingPlatform for this behavior
 void goHome()
          Positions and reorients the ViewingPlatform to its "home" transform.
 void setHomeTransform(Transform3D home)
          Copies the given Transform3D into the "home" transform, used to position and reorient the ViewingPlatform to a known point of interest.
 void setViewingPlatform(ViewingPlatform vp)
          Sets the ViewingPlatform for this behavior.
 
Methods inherited from class javax.media.ding3d.Behavior
getEnable, getNumSchedulingIntervals, getSchedulingBoundingLeaf, getSchedulingBounds, getSchedulingInterval, initialize, postId, processStimulus, setEnable, setSchedulingBoundingLeaf, setSchedulingBounds, setSchedulingInterval, updateNodeReferences
 
Methods inherited from class javax.media.ding3d.Node
cloneNode, cloneTree, cloneTree, cloneTree, cloneTree, cloneTree, cloneTree, duplicateNode, getBounds, getBoundsAutoCompute, getCollidable, getLocale, getLocalToVworld, getLocalToVworld, getParent, getPickable, setBounds, setBoundsAutoCompute, setCollidable, setPickable
 
Methods inherited from class javax.media.ding3d.SceneGraphObject
clearCapability, clearCapabilityIsFrequent, getCapability, getCapabilityIsFrequent, getName, getUserData, isCompiled, isLive, setCapability, setCapabilityIsFrequent, setName, setUserData, toString
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

ViewPlatformBehavior

public ViewPlatformBehavior()
Method Detail

setViewingPlatform

public void setViewingPlatform(ViewingPlatform vp)
Sets the ViewingPlatform for this behavior. This method is called by the ViewingPlatform. If a sub-calls overrides this method, it must call super.setViewingPlatform(vp).

NOTE: Applications should not call this method.

Parameters:
vp - the target ViewingPlatform for this behavior

getViewingPlatform

public ViewingPlatform getViewingPlatform()
Returns the ViewingPlatform for this behavior

Returns:
the ViewingPlatform for this behavior

setHomeTransform

public void setHomeTransform(Transform3D home)
Copies the given Transform3D into the "home" transform, used to position and reorient the ViewingPlatform to a known point of interest.

Parameters:
home - source transform to be copied
Since:
Java 3D 1.3

getHomeTransform

public void getHomeTransform(Transform3D home)
Returns the behaviors "home" transform.

Parameters:
home - transform to be returned
Since:
Java 3D 1.3

goHome

public void goHome()
Positions and reorients the ViewingPlatform to its "home" transform.

Since:
Java 3D 1.3