edu.umd.cs.jazz
Class ZAnchorGroup

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

All Implemented Interfaces:

java.io.Serializable, ZSerializable

public class ZAnchorGroup

extends ZVisualGroup

implements ZSerializable, java.io.Serializable

ZAnchorGroup is a group that manages a hyperlink from the edit node below it. It references another node, or an area in space. It has methods to visually show that there is a link (typically used by an application when the user mouses over the visual component), and to follow a link.

ZAnchorGroup indicates the link with a visual component that can be defined by extending this class and overriding createLinkComponent. By default, it creates an arrow pointing to the destination of the link.

See Also:

Serialized Form

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

visualComponentPickable_DEFAULT

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

childrenFindable_DEFAULT, childrenPickable_DEFAULT, hasOneChild_DEFAULT

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

findable_DEFAULT, listenerList, pickable_DEFAULT, savable_DEFAULT

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

bounds, objRefTable, volatileBounds_DEFAULT

Constructor Summary

ZAnchorGroup()
Constructs a new ZAnchorGroup

ZAnchorGroup(ZNode child)
Constructs a new link group node with the specified node as a child of the new group.

Method Summary

java.lang.Object	clone() Duplicates the current node by using the copy constructor.
void	computeBounds() Trap computeBounds requests as it indicates that the anchor source has changed, and the visual link needs to be updated.
protected ZVisualComponent	createLinkComponent() Internal method to create the visual component that represents the link.
java.lang.String	dump() Generate a string that represents this object for debugging.
void	duplicateObject(ZAnchorGroup refNode) Copies all object information from the reference object into the current object.
void	finalize() Disposes of this anchor group when it is no longer used.
void	follow(ZCamera camera) Follow the link, animating the viewpoint in the specified camera to the link destination.
java.awt.geom.Rectangle2D	getDestBounds() Determine the bounds that are the destination of this link.
ZNode	getDestNode() Determine the node that is the destination of this link.
boolean	isVisible() Determine if the visual depiction of this link is currently visible.
void	setDestBounds(java.awt.geom.Rectangle2D bounds, ZCamera camera) Set the bounds destination of this link.
void	setDestNode(ZNode node, ZCamera camera) Set the node destination of this link.
void	setDestPt(java.awt.geom.Point2D pt) Set the destination point of the link for purposes of visually indicating the link.
void	setSrcPt(java.awt.geom.Point2D pt) Set the source point of the link for purposes of visually indicating the link.
void	setState(java.lang.String fieldType, java.lang.String fieldName, java.lang.Object fieldValue) Set some state of this object as it gets read back in.
void	setVisible(boolean visible, ZCamera camera) Specify whether the visual depiction of this link should be visible or not.
void	updateLinkComponent(ZCamera camera) Update the visual component that represents the link.
void	writeObject(ZObjectOutputStream out) Write out all of this object's state.
void	writeObjectRecurse(ZObjectOutputStream out) Specify which objects this object references in order to write out the scenegraph properly

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

duplicateObject, getBackVisualComponent, getBackVisualComponentBounds, getBackVisualComponentGlobalBounds, getFrontVisualComponent, getFrontVisualComponentBounds, getFrontVisualComponentGlobalBounds, isBackVisualComponentPickable, isFrontVisualComponentPickable, pick, render, setBackVisualComponent, setBackVisualComponentPickable, setFrontVisualComponent, setFrontVisualComponentPickable, updateVolatility

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

addChild, addGroupListener, duplicateObject, fireGroupEvent, getChild, getChildren, getChildrenFindable, getChildrenIterator, getChildrenPickable, getNumChildren, hasOneChild, indexOf, insertAbove, lower, lowerTo, raise, raiseTo, remove, removeChild, removeGroupListener, setChildrenFindable, setChildrenPickable, setHasOneChild, trimToSize

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

addClientProperty, addMouseListener, addMouseMotionListener, duplicateObject, editor, fireMouseEvent, getClientProperty, getGlobalBounds, getGlobalToLocalTransform, getLocalToGlobalTransform, getParent, getRoot, globalToLocal, globalToLocal, hasMouseListener, isAncestorOf, isDescendentOf, isFindable, isPickable, isSavable, localToGlobal, localToGlobal, lower, lowerTo, putClientProperty, raise, raiseTo, removeMouseListener, removeMouseMotionListener, repaint, repaint, reparent, replaceWith, setEditorFactory, setFindable, setParent, setPickable, setSavable, updateBounds, updateObjectReferences, writeReplace

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

duplicateObject, getBounds, getVolatileBounds, reshape, setVolatileBounds

Methods inherited from class java.lang.Object

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

Constructor Detail

ZAnchorGroup

public ZAnchorGroup()

Constructs a new ZAnchorGroup

ZAnchorGroup

public ZAnchorGroup(ZNode child)

Constructs a new link group node with the specified node as a child of the new group.

Parameters:

child - Child of the new group node.

Method Detail

duplicateObject

public void duplicateObject(ZAnchorGroup refNode)

Copies all object information from the reference object into the current object. This method is called from the clone method. All ZSceneGraphObjects objects contained by the object being duplicated are duplicated, except parents which are set to null. This results in the sub-tree rooted at this object being duplicated.

Parameters:

refNode - The reference node to copy

clone

public java.lang.Object clone()

Duplicates the current node by using the copy constructor. The portion of the reference node that is duplicated is that necessary to reuse the node in a new place within the scenegraph, but the new node is not inserted into any scenegraph. The node must be attached to a live scenegraph (a scenegraph that is currently visible) or be registered with a camera directly in order for it to be visible.

Overrides:

clone in class ZVisualGroup

Returns:

A copy of this node.

See Also:

ZNode.updateObjectReferences(edu.umd.cs.jazz.util.ZObjectReferenceTable)

finalize

public void finalize()

Disposes of this anchor group when it is no longer used.

Overrides:

finalize in class java.lang.Object

getDestNode

public ZNode getDestNode()

Determine the node that is the destination of this link.

Returns:

The destination node, or null if none.

setDestNode

public void setDestNode(ZNode node,
                        ZCamera camera)

Set the node destination of this link. Setting the link destination to be a node clears the bounds destination if there was one.

Parameters:

node - The node that is the destination of this link.

camera - The camera the link is going to be primarily viewed within. This is used to determine the appropriate visual display of the link.

See Also:

setDestBounds(java.awt.geom.Rectangle2D, edu.umd.cs.jazz.ZCamera)

getDestBounds

public java.awt.geom.Rectangle2D getDestBounds()

Determine the bounds that are the destination of this link.

Returns:

The destination bounds, or null if none.

setDestBounds

public void setDestBounds(java.awt.geom.Rectangle2D bounds,
                          ZCamera camera)

Set the bounds destination of this link. Setting the bounds destination to be a node clears the link destination if there was one.

Parameters:

bounds - The bounds (in global coordinates) that is the destination of this link.

camera - The camera the link is going to be primarily viewed within. This is used to determine the appropriate visual display of the link.

See Also:

setDestNode(edu.umd.cs.jazz.ZNode, edu.umd.cs.jazz.ZCamera)

computeBounds

public void computeBounds()

Trap computeBounds requests as it indicates that the anchor source has changed, and the visual link needs to be updated.

Overrides:

computeBounds in class ZVisualGroup

createLinkComponent

protected ZVisualComponent createLinkComponent()

Internal method to create the visual component that represents the link. Applications can change visual representation of a selected object by extending this class, and overriding this method.

Returns:

the visual component that represents the selection.

setSrcPt

public void setSrcPt(java.awt.geom.Point2D pt)

Set the source point of the link for purposes of visually indicating the link.

Parameters:

pt - The source point in global coordinates

setDestPt

public void setDestPt(java.awt.geom.Point2D pt)

Set the destination point of the link for purposes of visually indicating the link.

Parameters:

pt - The destination point in global coordinates

updateLinkComponent

public void updateLinkComponent(ZCamera camera)

Update the visual component that represents the link. This should be called whenever any internal state has changed that the visual link depends on.

Parameters:

camera - The camera the link is going to be primarily viewed within. This is used to determine the appropriate visual display of the link.

setVisible

public void setVisible(boolean visible,
                       ZCamera camera)

Specify whether the visual depiction of this link should be visible or not.

Parameters:

visible - True if the link should be shown, or false otherwise.

camera - The camera the link is going to be primarily viewed within. This is used to determine the appropriate visual display of the link.

isVisible

public boolean isVisible()

Determine if the visual depiction of this link is currently visible.

Returns:

True if the link is visible.

follow

public void follow(ZCamera camera)

Follow the link, animating the viewpoint in the specified camera to the link destination.

Parameters:

camera - The camera to animate

dump

public java.lang.String dump()

Generate a string that represents this object for debugging.

Overrides:

dump in class ZGroup

Returns:

the string that represents this object for debugging

See Also:

ZDebug.dump(edu.umd.cs.jazz.ZNode)

writeObject

public void writeObject(ZObjectOutputStream out)
                 throws java.io.IOException

Write out all of this object's state.

Specified by:

writeObject in interface ZSerializable

Overrides:

writeObject in class ZVisualGroup

Parameters:

out - The stream that this object writes into

writeObjectRecurse

public void writeObjectRecurse(ZObjectOutputStream out)
                        throws java.io.IOException

Specify which objects this object references in order to write out the scenegraph properly

Specified by:

writeObjectRecurse in interface ZSerializable

Overrides:

writeObjectRecurse in class ZVisualGroup

Parameters:

out - The stream that this object writes into

setState

public void setState(java.lang.String fieldType,
                     java.lang.String fieldName,
                     java.lang.Object fieldValue)

Set some state of this object as it gets read back in. After the object is created with its default no-arg constructor, this method will be called on the object once for each bit of state that was written out through calls to ZObjectOutputStream.writeState() within the writeObject method.

Specified by:

setState in interface ZSerializable

Overrides:

setState in class ZVisualGroup

Parameters:

fieldType - The fully qualified type of the field

fieldName - The name of the field

fieldValue - The value of the field