gumbo.graphic.space
Interface GraphicSpaceRoot

All Superinterfaces:
Delegatable, Graphic, SpaceNode
All Known Implementing Classes:
AbstractGraphicSpaceRoot

public interface GraphicSpaceRoot
extends SpaceNode, Delegatable

A space node used by graphic spaces as the root of a space tree. By implementing Delegatable, the client can navigate through the tree to its root and up to its graphic space delegator. By disallowing use of a transform node as the root the absolute reference space is assured to be reachable. TODO: Is this class needed, especially Delegatable?

Version:
$Revision: 1.2 $
Author:
Jon Barrilleaux (jonb@jmbaai.com) of JMB and Associates Inc.

Method Summary
 java.lang.Object getDelegator()
          Gets the delegator of this delegate, as set by initDelegator().
 TreeNode getGraphicSpaceTree()
          Gets the delegate tree node for this delegator's spatial geometry tree.
 Delegatable initDelegator(java.lang.Object delegator)
          Used by delegators and serialization to initialize this delegate's delegator reference.
 
Methods inherited from interface gumbo.graphic.Graphic
getGraphic
 
Methods inherited from interface gumbo.util.Delegatable
isDelegatorInited
 

Method Detail

getGraphicSpaceTree

public TreeNode getGraphicSpaceTree()
Description copied from interface: SpaceNode
Gets the delegate tree node for this delegator's spatial geometry tree.

Specified by:
getGraphicSpaceTree in interface SpaceNode
Returns:
Reference to the delegate. Never null.
Throws:
java.lang.IllegalStateException - The tree node parent is not null.

initDelegator

public Delegatable initDelegator(java.lang.Object delegator)
Description copied from interface: Delegatable
Used by delegators and serialization to initialize this delegate's delegator reference. Re-initialization with the same value is allowed. Throws an exception if initialization fails for any reason.

Specified by:
initDelegator in interface Delegatable
Parameters:
delegator - Reference to the delegator. If self-delegation is allowed and the delegator is null, this object is the delegator (which facilitates inline construction).
Returns:
Reference to this delegatable (which facilitates inline construction).
Throws:
java.lang.IllegalArgumentException - Delegator is null.

getDelegator

public java.lang.Object getDelegator()
Description copied from interface: Delegatable
Gets the delegator of this delegate, as set by initDelegator(). Throws an exception if isDelegatorInited() is false.

Specified by:
getDelegator in interface Delegatable
Returns:
The graphic space delegator (GraphicSpace). Never null.