edu.umd.cs.jazz.component
Class ZPolyline

java.lang.Object
  |
  +--edu.umd.cs.jazz.ZSceneGraphObject
        |
        +--edu.umd.cs.jazz.ZVisualComponent
              |
              +--edu.umd.cs.jazz.component.ZCoordList
                    |
                    +--edu.umd.cs.jazz.component.ZPolyline

All Implemented Interfaces:

java.lang.Cloneable, java.io.Serializable, ZAppearance, ZPenColor, ZSerializable, ZStroke

public class ZPolyline

extends ZCoordList

implements java.io.Serializable

ZPolyline is a visual component that represents a line with one or more segments.

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.

See Also:

Serialized Form

Field Summary

static int	ARROW_BOTH
static int	ARROW_CLOSED
static int	ARROW_FIRST
static int	ARROW_LAST
static int	ARROW_NONE
static int	ARROW_OPEN

Fields inherited from class edu.umd.cs.jazz.component.ZCoordList

absPenWidth, closed, DEFAULT_ABS_PEN_WIDTH, DEFAULT_CLOSED, DEFAULT_PEN_COLOR, DEFAULT_PEN_WIDTH, empty, np, path, penColor, penWidth, stroke, tmpBounds, xp, yp

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

bounds, volatileBounds, volatileBounds_DEFAULT

Constructor Summary

ZPolyline()
Constructs a new ZPolyline with no points.

ZPolyline(double[] xp, double[] yp)
Constructs a new ZPolyline from an array of points.

ZPolyline(double x, double y)
Constructs a new ZPolyline with a single point.

ZPolyline(double x1, double y1, double x2, double y2)
Constructs a new ZPolyline with a two points

ZPolyline(java.awt.geom.Point2D pt)
Constructs a new ZPolyline with a single point.

ZPolyline(java.awt.geom.Point2D pt1, java.awt.geom.Point2D pt2)
Constructs a new ZPolyline with two points.

Method Summary

void	add(double x, double y) Add a point to the end of this polyline.
void	add(double x, double y, int index) Add a point to the specified part of this coordinate list.
protected java.awt.geom.GeneralPath	computeArrowHead(int ah, java.awt.geom.Point2D p1, java.awt.geom.Point2D p2) Calculate the points used to represent the arrowhead.
protected void	computeBounds() Notifies this object that it has changed and that it should update its notion of its bounding box.
protected java.lang.Object	duplicateObject() Returns a clone of this object.
int	getArrowHead() Get the arrowhead type used by this ZPolyline.
boolean	pick(java.awt.geom.Rectangle2D rect, ZSceneGraphPath path) Returns true if the specified rectangle is on the polyline.
protected void	removeArrowHead(int ah) Remove one or both arrowheads from the polyline.
void	render(ZRenderContext renderContext) Renders this object.
void	setArrowHead(int ah) Set arrowheads for this polyline.
void	setArrowHeadType(int aht) Set arrowHeads for this polyline to a certain style: open, closed, etc
protected void	setCoords(boolean updateArrowHeads, double[] xp, double[] yp) Set the coordinates of this polyline.
void	setCoords(double[] xp, double[] yp) Set the coordinates of this polyline.
void	setCoords(java.awt.geom.Point2D pt1, java.awt.geom.Point2D pt2) Set the coordinates of this polyline to two points.
protected boolean	updateArrowHeads() Updates the internal representation of the arrowheads to reflect the current state of the polyline.

Methods inherited from class edu.umd.cs.jazz.component.ZCoordList

add, add, ensureSpace, getAbsPenWidth, getNumberPoints, getPath, getPenColor, getPenWidth, getStroke, getXCoords, getYCoords, isClosed, setAbsPenWidth, setClosed, setPenColor, setPenWidth, setState, setStroke, trimToSize, updatePath, writeObject

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

addParent, getParents, getRoot, paint, pickBounds, removeParent, repaint, repaint, updateBounds, updateObjectReferences, updateParentBounds, updateVolatility, writeObjectRecurse

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

clone, dump, getBounds, getBoundsReference, getVolatileBounds, reshape, setBounds, setVolatileBounds

Methods inherited from class java.lang.Object

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

Field Detail

ARROW_NONE

public static final int ARROW_NONE

ARROW_FIRST

public static final int ARROW_FIRST

ARROW_LAST

public static final int ARROW_LAST

ARROW_BOTH

public static final int ARROW_BOTH

ARROW_CLOSED

public static final int ARROW_CLOSED

ARROW_OPEN

public static final int ARROW_OPEN

Constructor Detail

ZPolyline

public ZPolyline()

Constructs a new ZPolyline with no points.

ZPolyline

public ZPolyline(java.awt.geom.Point2D pt)

Constructs a new ZPolyline with a single point.

Parameters:

pt - Initial point

ZPolyline

public ZPolyline(java.awt.geom.Point2D pt1,
                 java.awt.geom.Point2D pt2)

Constructs a new ZPolyline with two points.

Parameters:

pt1 - First point

pt2 - Second point

ZPolyline

public ZPolyline(double x,
                 double y)

Constructs a new ZPolyline with a single point.

Parameters:

x,y - Initial point

ZPolyline

public ZPolyline(double x1,
                 double y1,
                 double x2,
                 double y2)

Constructs a new ZPolyline with a two points

Parameters:

x,y - First point

x,y - Second point

ZPolyline

public ZPolyline(double[] xp,
                 double[] yp)

Constructs a new ZPolyline from an array of points. The xp, yp parameters are stored within this polyline, so the caller must not modify them after passing them in.

Parameters:

xp - Array of X points

yp - Array of Y points

Method Detail

duplicateObject

protected java.lang.Object duplicateObject()

Returns a clone of this object.

Overrides:

duplicateObject in class ZCoordList

See Also:

ZSceneGraphObject.duplicateObject()

removeArrowHead

protected void removeArrowHead(int ah)

Remove one or both arrowheads from the polyline.

Parameters:

ah - ARROW_FIRST, ARROW_LAST or ARROW_BOTH

getArrowHead

public int getArrowHead()

Get the arrowhead type used by this ZPolyline. ArrowHead is one of ARROW_NONE, ARROW_FIRST, ARROW_LAST, ARROW_BOTH.

setArrowHead

public void setArrowHead(int ah)

Set arrowheads for this polyline.

Parameters:

ah - ArrowHead Specification, such as ARROW_FIRST, ARROW_LAST, ARROW_BOTH, ARROW_NONE.

setArrowHeadType

public void setArrowHeadType(int aht)

Set arrowHeads for this polyline to a certain style: open, closed, etc

Parameters:

ah - ArrowHead type, such as ARROW_OPEN OR ARROW_CLOSED.

add

public void add(double x,
                double y)

Add a point to the end of this polyline.

Overrides:

add in class ZCoordList

Parameters:

x,y - The new point

add

public void add(double x,
                double y,
                int index)

Add a point to the specified part of this coordinate list. Specifying an index of 0 puts the point at the beginning of the list. Specifying an index greater than the number of points in the coordinate list puts the point at the end of the list of points.

Overrides:

add in class ZCoordList

Parameters:

x,y - The new point

index - The index of the new point.

setCoords

public void setCoords(double[] xp,
                      double[] yp)

Set the coordinates of this polyline. The specified points completely replace the previous points in this polyline.

Overrides:

setCoords in class ZCoordList

Parameters:

xp - An array of the X coordinates of the new points.

yp - An array of the Y coordinates of the new points.

setCoords

public void setCoords(java.awt.geom.Point2D pt1,
                      java.awt.geom.Point2D pt2)

Set the coordinates of this polyline to two points.

Parameters:

pt1 - The first point of the polyline

pt2 - The second first point of the polyline

setCoords

protected void setCoords(boolean updateArrowHeads,
                         double[] xp,
                         double[] yp)

Set the coordinates of this polyline. The specified points completely replace the previous points in this polyline.

Parameters:

xp - An array of the X coordinates of the new points.

yp - An array of the Y coordinates of the new points.

updateArrowHeads - Updates the internal representation of the arrowheads.

render

public void render(ZRenderContext renderContext)

Renders this object.

The transform, clip, and composite will be set appropriately when this object is rendered. It is up to this object to restore the transform, clip, and composite of the Graphics2D if this node changes any of them. However, the color, font, and stroke are unspecified by Jazz. This object should set those things if they are used, but they do not need to be restored.

Overrides:

render in class ZVisualComponent

Parameters:

renderContext - The graphics context to paint into.

computeBounds

protected void computeBounds()

Notifies this object that it has changed and that it should update its notion of its bounding box. Note that this should not be called directly. Instead, it is called by updateBounds when needed.

Overrides:

computeBounds in class ZCoordList

pick

public boolean pick(java.awt.geom.Rectangle2D rect,
                    ZSceneGraphPath path)

Returns true if the specified rectangle is on the polyline.

Overrides:

pick in class ZVisualComponent

Parameters:

rect - Pick rectangle of object coordinates.

path - The path through the scenegraph to the picked node. Modified by this call.

Returns:

True if rectangle overlaps object.

See Also:

ZDrawingSurface.pick(int, int)

updateArrowHeads

protected boolean updateArrowHeads()

Updates the internal representation of the arrowheads to reflect the current state of the polyline. This should be called whenever the polyline has changed.

Returns:

True if arrowheads were actually computed resulting in possible bounds changes

computeArrowHead

protected java.awt.geom.GeneralPath computeArrowHead(int ah,
                                                     java.awt.geom.Point2D p1,
                                                     java.awt.geom.Point2D p2)

Calculate the points used to represent the arrowhead. We use a simple algorithm that just starts at p2, backs up to p1 a bit (as represented with p3), and goes to either side by rotating (p3-p2) +/- 90 degrees.