|
| |
|
| java.lang.Object
 javax.media.j3d.SceneGraphObject
javax.media.j3d.Node
javax.media.j3d.Group
javax.media.j3d.BranchGroup
com.sun.j3d.utils.universe.ViewingPlatform
| ViewingPlatform | | public class ViewingPlatform extends BranchGroup (Code) | | This class is used to set up the "view" side of a Java 3D scene graph.
The ViewingPlatform object contains a MultiTransformGroup node to allow
for a series of transforms to be linked together. To this structure
the ViewPlatform is added as well as any geometry to associate with this
view platform.
See Also: ViewPlatform |
| Constructor Summary | |
| public | ViewingPlatform()
Creates a default ViewingPlatform object. | | public | ViewingPlatform(int numTransforms)
Creates the ViewingPlatform object. |
| avatarRoot | | protected BranchGroup avatarRoot(Code) | | Used to keep track of added geometry. When geometry
is added for an avatar, an addChild to this BranchGroup
is performed.
|
| behaviors | | protected BranchGroup behaviors(Code) | | Used to keep track of behaviors.
since:
Java 3D 1.2.1 |
| mtg | | protected MultiTransformGroup mtg(Code) | | MultiTransformGroup that holds all TransformGroups between
the BranchGroup and the View object.
|
| platformGeometryRoot | | protected BranchGroup platformGeometryRoot(Code) | | Used to keep track of added geometry. When geometry
is added to the view platform, an addChild to this BranchGroup
is performed.
|
| universe | | protected SimpleUniverse universe(Code) | | The universe to which this viewing platform is attached
since:
Java 3D 1.3 |
| viewPlatform | | protected ViewPlatform viewPlatform(Code) | | Cached ViewPlatform associated with this ViewingPlatform object.
|
| viewerList | | protected Hashtable viewerList(Code) | | Table of the Viewer objects.
|
| ViewingPlatform | | public ViewingPlatform()(Code) | | Creates a default ViewingPlatform object. This consists of a
MultiTransfromGroup node with one transform and a ViewPlatform
object. The ViewPlatform is positioned at (0.0, 0.0, 0.0).
|
| ViewingPlatform | | public ViewingPlatform(int numTransforms)(Code) | | Creates the ViewingPlatform object. This consists of a
MultiTransfromGroup node with the specified number of transforms
(all initialized to the identity transform).
and a ViewPlatform object.
Parameters:
numTransforms - The number of transforms the MultiTransformGroupnode should contain. If this number is less than 1, 1 is assumed. |
| addViewPlatformBehavior | | void addViewPlatformBehavior(ViewPlatformBehavior behavior)(Code) | | Adds a new ViewPlatformBehavior to the ViewingPlatform
|
| addViewer | | void addViewer(Viewer viewer)(Code) | | When a ViewingPlatform is set by a Viewer, the ViewingPlatform
needs to be informed, via a call to this method. This will add
the Viewer to the ViewingPlatform's viewerList for use when
things such as the PlatformGeometry are changed and all Viewer
scene graphs need to be modified.
|
| getMultiTransformGroup | | public MultiTransformGroup getMultiTransformGroup()(Code) | | Returns the MultitransformGroup object for this
ViewingPlatform object.
The MultitransformGroup object. |
| getPlatformGeometry | | public PlatformGeometry getPlatformGeometry()(Code) | | Returns the PlatformGeometry associated with this ViewingPlatform
The PlatformGeometry associated with this ViewingPlatform |
| getUniverse | | public SimpleUniverse getUniverse()(Code) | | Returns the Universe to which this ViewingPlatform is attached
the Universe to which this ViewingPlatform is attached
since:
Java 3D 1.3 |
| getViewPlatform | | public ViewPlatform getViewPlatform()(Code) | | Returns the ViewPlatform node for this ViewingPlatform object.
The ViewPlatform node associated with this ViewingPlatformobject. |
| getViewPlatformBehavior | | ViewPlatformBehavior getViewPlatformBehavior(int index)(Code) | | Returns the ViewPlatformBehavior at the specified index
|
| getViewPlatformBehavior | | public ViewPlatformBehavior getViewPlatformBehavior()(Code) | | Returns the ViewPlatformBehavior
the ViewPlatformBehavior for the ViewingPlatform.Returns null if there is no ViewPlatformBehavior set.
since:
Java 3D 1.2.1 |
| getViewPlatformBehaviorCount | | int getViewPlatformBehaviorCount()(Code) | | Returns the number of ViewPlatformBehaviors on the ViewingPlatform
|
| getViewPlatformTransform | | public TransformGroup getViewPlatformTransform()(Code) | | Returns a reference to the "bottom most" transform in the
MultiTransformGroup that is above the ViewPlatform node.
The TransformGroup that is immediately above theViewPlatform object. |
| getViewers | | public Viewer[] getViewers()(Code) | | Returns the Viewers attached to this ViewingPlatform
the Viewers attached to this viewing platform
since:
Java 3D 1.3 |
| removeViewPlatformBehavior | | void removeViewPlatformBehavior(ViewPlatformBehavior behavior)(Code) | | Removes the specified ViewPlatformBehavior
|
| setAvatar | | void setAvatar(Viewer viewer, ViewerAvatar avatar)(Code) | | Adds the ViewerAvatar to the scene graph. An avatar (geometry)
can be associated with a Viewer object and displayed by Java 3D.
Parameters:
viewer - The viewer object to associate with this avatar.
Parameters:
avatar - The avatar to add to the scene graph. Passing innull removes any currently assigned avatar. |
| setNominalViewingTransform | | public void setNominalViewingTransform()(Code) | | Sets the nominal viewing distance in the ViewPlatform transform based
on the current field of view. If the ViewAttachPolicy is not the
default of View.NOMINAL_HEAD, then this method has no effect.
The ViewPlatform is moved back along Z so that objects at the origin
spanning the normalized X range of -1.0 to +1.0 can be fully viewed
across the width of the window. This is done by setting a translation
of 1/(tan(fieldOfView/2)) in the ViewPlatform transform.
If there is no Viewer object associated with this ViewingPlatform
object the default field of view of PI/4.0 is used.
NOTE: Support for multiple Viewer objects is not available. If
multiple viewers are attached to this ViewingPlatform than a
RuntimeException will be thrown.
|
| setPlatformGeometry | | public void setPlatformGeometry(PlatformGeometry pg)(Code) | | Assigns the geometry to associate with the ViewingPlatform.
PlatformGeometry is used to hold any geometry to be associated
with the ViewingPlatform. If the ViewingPlatform is to be the
inside of a car, for instance, than the PlatformGeometry could be
the dashboard of the car.
Parameters:
pg - The geometry to be associated with this ViewingPlatform.Passing in null has the effect of deleting any geometry associatedwith this ViewingPlatform. |
| setUniverse | | public void setUniverse(SimpleUniverse universe)(Code) | | Sets the Universe to which this ViewingPlatform is attached
Parameters:
universe - the Universe to which this ViewingPlatform is attached
since:
Java 3D 1.3 |
| setViewPlatform | | public void setViewPlatform(ViewPlatform vp)(Code) | | Sets the ViewPlatform node for this ViewingPlatform object.
Parameters:
vp - The ViewPlatform node to associate with this ViewingPlatformobject. |
| setViewPlatformBehavior | | public void setViewPlatformBehavior(ViewPlatformBehavior behavior)(Code) | | Sets the ViewPlatformBehavior which will operate on the ViewPlatform
transform (the TransformGroup returned by
ViewingPlatform.getViewPlatformTransform()). The ViewPlatformBehavior
may be set after the ViewingPlatform is setLive().
If a behavior is already present, it will be detached and it's
setViewingPlatform method will be called with a parameter of null.
Parameters:
behavior - The ViewPlatformBehavior to add to the ViewingPlatform.null will remove the ViewingPlatform behavior.
since:
Java 3D 1.2.1 |
| Fields inherited from javax.media.j3d.BranchGroup | final public static int ALLOW_DETACH(Code)(Java Doc)
|
|
|
|