edu.umd.cs.jazz.component
Class ZPolyline

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

public class ZPolyline

extends ZVisualComponent

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

Field Summary

static int	ARRAY_INC
static int	ARROW_BOTH
static int	ARROW_FIRST
static int	ARROW_LAST
static int	ARROW_NONE
protected int	arrowHead
protected int	cap
static java.awt.Color	DEFAULT_PEN_COLOR
static float	DEFAULT_PEN_WIDTH
protected boolean	empty
protected java.awt.geom.GeneralPath	firstArrowHead
protected int	join
protected java.awt.geom.GeneralPath	lastArrowHead
protected int	np
protected java.awt.geom.GeneralPath	path
protected java.awt.Color	penColor
protected float	penWidth
protected float[]	xp
protected float[]	yp

Fields inherited from class edu.umd.cs.jazz.scenegraph.ZVisualComponent

cacheVolatile, findable, findable_DEFAULT, isVolatile, localBounds, localBoundsDirty, parent, pickable, pickable_DEFAULT, selected

Constructor Summary

ZPolyline()
Constructs a new Polyline with no points.

ZPolyline(float[] xp, float[] yp)
Constructs a new Polyline.

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

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

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

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

ZPolyline(ZPolyline poly)
Constructs a new ZPolyline that is a duplicate of the reference polyline, i.e., a "copy constructor"

Method Summary

void	add(float x, float y) Add a point to the end of this polyline.
void	add(java.awt.geom.Point2D pt) Add a point to the end of this polyline.
java.lang.Object	clone() Duplicates the current ZPolyline by using the copy constructor.
protected java.awt.geom.GeneralPath	computeArrowHead(java.awt.geom.Point2D p1, java.awt.geom.Point2D p2) Calculate the points used to represent the arrowhead.
protected void	computeLocalBounds() Notifies this object that it has changed and that it should update its notion of its bounding box.
int	getArrowHead()
int	getNumberPoints() Get the number of points in this polyline.
java.awt.Color	getPenColor()
float	getPenWidth()
float[]	getXCoords() Get an array of the X coordinates of the points in this polyline.
float[]	getYCoords() Get an array of the Y coordinates of the points in this polyline.
void	paint(ZRenderContext renderContext) Paints this object.
boolean	pick(java.awt.geom.Rectangle2D rect) Returns true if the specified rectangle is on the polyline.
void	setArrowHead(int ah)
void	setCoords(float[] xp, float[] yp) Set the coordinates of this polyline.
void	setPenColor(java.awt.Color color)
void	setPenWidth(float width)
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	trimToSize() Trims the capacity of the arrays that store the polyline points to the actual number of points.
protected void	updateArrowHeads() Updates the internal representation of the arrowheads to reflect the current state of the polyline.
void	writeObject(ZObjectOutputStream out) Write out all of this object's state.

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

damage, damage, findNode, findVisualComponent, getLocalBounds, getParent, isFindable, isPickable, isSelected, isVolatile, pickBounds, select, select, setFindable, setParent, setPickable, setSelected, setVisualComponent, setVolatile, toString, unselect, updateBounds, updateChildBounds, updateLocalBounds, updateVolatility, writeObjectRecurse

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, 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

DEFAULT_PEN_COLOR

public static final java.awt.Color DEFAULT_PEN_COLOR

DEFAULT_PEN_WIDTH

public static final float DEFAULT_PEN_WIDTH

ARRAY_INC

public static final int ARRAY_INC

penColor

protected java.awt.Color penColor

penWidth

protected float penWidth

empty

protected boolean empty

path

protected java.awt.geom.GeneralPath path

xp

protected float[] xp

yp

protected float[] yp

np

protected int np

cap

protected int cap

join

protected int join

arrowHead

protected int arrowHead

firstArrowHead

protected java.awt.geom.GeneralPath firstArrowHead

lastArrowHead

protected java.awt.geom.GeneralPath lastArrowHead

Constructor Detail

ZPolyline

public ZPolyline()

Constructs a new Polyline with no points.

ZPolyline

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

Constructs a new Polyline with a single point.

Parameters:

pt - Initial point

ZPolyline

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

Constructs a new Polyline with two points.

Parameters:

pt1 - First point

pt2 - Second point

ZPolyline

public ZPolyline(float x,
                 float y)

Constructs a new Polyline with a single point.

Parameters:

x,y - Initial point

ZPolyline

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

Constructs a new Polyline with a two points

Parameters:

x,y - First point

x,y - Second point

ZPolyline

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

Constructs a new Polyline. 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

ZPolyline

public ZPolyline(ZPolyline poly)

Constructs a new ZPolyline that is a duplicate of the reference polyline, i.e., a "copy constructor"

Parameters:

poly - Reference polyline

Method Detail

clone

public java.lang.Object clone()

Duplicates the current ZPolyline by using the copy constructor. See the copy constructor comments for complete information about what is duplicated.

Overrides:

clone in class ZVisualComponent

See Also:

ZPolyline(ZPolyline)

getPenWidth

public float getPenWidth()

setPenWidth

public void setPenWidth(float width)

getPenColor

public java.awt.Color getPenColor()

setPenColor

public void setPenColor(java.awt.Color color)

getArrowHead

public int getArrowHead()

setArrowHead

public void setArrowHead(int ah)

add

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

Add a point to the end of this polyline.

Parameters:

pt - The new point

add

public void add(float x,
                float y)

Add a point to the end of this polyline.

Parameters:

x,y - The new point

setCoords

public void setCoords(float[] xp,
                      float[] 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.

getXCoords

public float[] getXCoords()

Get an array of the X coordinates of the points in this polyline. Note that the array may be larger than the actual number of points in this polyline. See getNumberPoints() to get the actual number of points in the polyline.

Returns:

Array of X coordinates of points.

getYCoords

public float[] getYCoords()

Get an array of the Y coordinates of the points in this polyline. Note that the array may be larger than the actual number of points in this polyline. See getNumberPoints() to get the actual number of points in the polyline.

Returns:

Array of Y coordinates of points.

getNumberPoints

public int getNumberPoints()

Get the number of points in this polyline.

Returns:

the number of points in this polyline

trimToSize

public void trimToSize()

Trims the capacity of the arrays that store the polyline points to the actual number of points. Normally, the polyline arrays can be slightly larger than the number of points in the polyline. An application can use this operation to minimize the storage of a polyline.

See Also:

getXCoords(), getYCoords(), getNumberPoints()

paint

public void paint(ZRenderContext renderContext)

Paints this object.

Parameters:

g2 - The graphics context to paint into.

Overrides:

paint in class ZVisualComponent

computeLocalBounds

protected void computeLocalBounds()

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:

computeLocalBounds in class ZVisualComponent

See Also:

ZNode.getGlobalBounds()

pick

public boolean pick(java.awt.geom.Rectangle2D rect)

Returns true if the specified rectangle is on the polyline.

Parameters:

rect - Pick rectangle of object coordinates.

Returns:

True if rectangle overlaps object.

Overrides:

pick in class ZVisualComponent

updateArrowHeads

protected void 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.

computeArrowHead

protected java.awt.geom.GeneralPath computeArrowHead(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. BBB 12/98: There is a bug with Sun's JDK1.2 where if we create a Shape of zero area (due to the two points being equal, and then add them to another shape (as we do when we compute the local bounds), then the JDK will hang at run time. And so, we check to make sure the points aren't equal.

writeObject

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

Write out all of this object's state.

Parameters:

out - The stream that this object writes into

Overrides:

writeObject in class ZVisualComponent

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.

Parameters:

fieldType - The fully qualified type of the field

fieldName - The name of the field

fieldValue - The value of the field

Overrides:

setState in class ZVisualComponent