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.ZBasicVisualComponent
                    |
                    +--edu.umd.cs.jazz.component.ZShape
                          |
                          +--edu.umd.cs.jazz.component.ZCoordList
                                |
                                +--edu.umd.cs.jazz.component.ZPolyline

All Implemented Interfaces:

java.lang.Cloneable, java.io.Serializable, ZAppearance, ZFillColor, ZFillPaint, ZPenColor, ZPenPaint, ZSerializable, ZStroke

public class ZPolyline

extends ZCoordList

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.

Author:

Benjamin B. Bederson

, Jesse Grosjean

See Also:

Serialized Form

ARROW_NONE

public static final int ARROW_NONE

See Also:

Constant Field Values

ARROW_FIRST

public static final int ARROW_FIRST

See Also:

Constant Field Values

ARROW_LAST

public static final int ARROW_LAST

See Also:

Constant Field Values

ARROW_BOTH

public static final int ARROW_BOTH

See Also:

Constant Field Values

ARROW_CLOSED

public static final int ARROW_CLOSED

See Also:

Constant Field Values

ARROW_OPEN

public static final int ARROW_OPEN

See Also:

Constant Field Values

ZPolyline

public ZPolyline()

Constructs a new ZPolyline with no points.

ZPolyline

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

Constructs a new ZPolyline with no points.

ZPolyline

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

Constructs a new ZPolyline with two points.

ZPolyline

public ZPolyline(double x,
                 double y)

Constructs a new ZPolyline with a single point.

ZPolyline

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

Constructs a new ZPolyline with a two points

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.

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.

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.

setArrowHeadType

public void setArrowHeadType(int aht)

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

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:

index - The index of the new point.

setCoords

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

Set the coords of this polygon.

Overrides:

setCoords in class ZCoordList

setCoords

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

Set the coords of this polygon.

Overrides:

setCoords in class ZCoordList

setCoords

public void setCoords(java.awt.geom.Point2D[] points)

Set the coords of this polygon.

Overrides:

setCoords in class ZCoordList

lineTo

public void lineTo(double x,
                   double y)

Return the append the given vertex onto the end of the list of points that define this polygon.

Overrides:

lineTo in class ZCoordList

setPenWidth

public void setPenWidth(double width)

The arrow head shape depends on the ZPolyline's pen width, so when the pen width changes the arrow heads must be updated.

Specified by:

setPenWidth in interface ZStroke

Overrides:

setPenWidth in class ZBasicVisualComponent

Parameters:

width - the pen width.

See Also:

ZBasicVisualComponent.setAbsPenWidth(double)

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 ZShape

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 ZShape

pick

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

Description copied from class: ZShape

Returns true if the specified rectangle is on the polygon.

Overrides:

pick in class ZShape

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.