edu.umd.cs.jazz
Class ZRoot

java.lang.Object
  |
  +--edu.umd.cs.jazz.ZSceneGraphObject
        |
        +--edu.umd.cs.jazz.ZNode
              |
              +--edu.umd.cs.jazz.ZGroup
                    |
                    +--edu.umd.cs.jazz.ZRoot

All Implemented Interfaces:

java.lang.Cloneable, java.io.Serializable, ZSerializable

public class ZRoot

extends ZGroup

implements java.io.Serializable

ZRoot extends ZNode overiding several methods of ZNode to ensure that ZRoot is always in the root position of a Scenegraph. Every scenegraph begins with a ZRoot which serves as the root of the entire scenegraph tree. Each scenegraph has exactly one root.

Warning: Serialized and ZSerialized objects of this class will not be compatible with future Jazz releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Jazz. A future release of Jazz will provide support for long term persistence.

Author:

Ben Bederson, Britt McAlister

See Also:

Serialized Form

Fields inherited from class edu.umd.cs.jazz.ZGroup

children, childrenFindable_DEFAULT, childrenPickable_DEFAULT, hasOneChild_DEFAULT

Fields inherited from class edu.umd.cs.jazz.ZNode

findable_DEFAULT, pickable_DEFAULT, savable_DEFAULT, selectable_DEFAULT

Fields inherited from class edu.umd.cs.jazz.ZSceneGraphObject

bounds, listenerList, volatileBounds, volatileBounds_DEFAULT

Constructor Summary

ZRoot()

Method Summary

ZRenderContext	getCurrentRenderContext() Return current render context.
void	setCurrentRenderContext(ZRenderContext renderContext) Set the current render context.
protected void	setParent(ZNode parent) Overrides ZNode.setParent() to throw an exception if an attempt to set the parent of a ZRoot is made.

Methods inherited from class edu.umd.cs.jazz.ZGroup

addChild, addChildImpl, addChildren, addGroupListener, childAddedNotification, childRemovedNotification, computeBounds, dump, duplicateObject, extract, findNodes, getChild, getChildren, getChildrenFindable, getChildrenIterator, getChildrenPickable, getChildrenReference, getNumChildren, getShallowBounds, getVolatileBounds, hasOneChild, indexOf, insertAbove, iterator, lower, lowerTo, pick, raise, raiseTo, removeAllChildren, removeChild, removeChild, removeChild, removeChildImpl, removeGroupListener, removeNodeListener, render, setChildrenFindable, setChildrenPickable, setHasOneChild, setState, trimToSize, updateHasNodeListener, updateVolatility, writeObject, writeObjectRecurse

Methods inherited from class edu.umd.cs.jazz.ZNode

addClientProperty, addNodeListener, editor, getClientProperty, getGlobalBounds, getGlobalToLocalTransform, getLocalToGlobalTransform, getParent, getRoot, globalToLocal, globalToLocal, hasNodeListener, isAncestorOf, isDescendentOf, isFindable, isPickable, isSavable, isSelectable, localToGlobal, localToGlobal, lower, lowerTo, percolateEventUpSceneGraph, putClientProperty, raise, raiseTo, remove, repaint, repaint, repaint, reparent, replaceWith, setEditorFactory, setFindable, setParent, setPickable, setSavable, setSelectable, updateBounds, updateObjectReferences, writeReplace

Methods inherited from class edu.umd.cs.jazz.ZSceneGraphObject

addMouseListener, addMouseMotionListener, clone, fireEvent, fireMouseEvent, getBounds, getBoundsReference, getListenerList, hasLisenerOfType, hasMouseListener, processMouseEvent, removeEventListener, removeMouseListener, removeMouseMotionListener, reshape, setBounds, setVolatileBounds

Methods inherited from class java.lang.Object

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

Constructor Detail

ZRoot

public ZRoot()

Method Detail

setCurrentRenderContext

public void setCurrentRenderContext(ZRenderContext renderContext)

Set the current render context. This is meant to be used by context-sensitive objects to determine the render context while computing bounds, etc.

Parameters:

renderContext - The new render context.

getCurrentRenderContext

public ZRenderContext getCurrentRenderContext()

Return current render context. During a render, this contains the active render context. During other times, it contains the render context to be used for computing bounds by context-sensitive objects.

Returns:

the render context

setParent

protected void setParent(ZNode parent)
                  throws java.lang.RuntimeException

Overrides ZNode.setParent() to throw an exception if an attempt to set the parent of a ZRoot is made.

Parameters:

parent - parameter is not used.