g2d.graph

Class IOPEdge

java.lang.Object

g2d.jlambda.Identifiable

g2d.jlambda.Attributable

g2d.glyph.Glyphish

g2d.graph.GraphItem

g2d.graph.IOPEdge

All Implemented Interfaces:

java.awt.event.KeyListener, java.awt.event.MouseListener, java.awt.event.MouseMotionListener, java.util.EventListener

public class IOPEdge
extends GraphItem

An edge object for IOPGraph. Edges are defined by their source and sink given as IOPNodes. These two nodes are given at object construction time and must be non-null.

An edge manifests itself as a spline and two arrow heads. Similar to the implementation of IOPNode, these glyphish things are instantiated at construction time and remain non-null. The interface of this class allows then to change the appearance of the edge, which will propagate into changing the sub-glyphs accordingly.

Since:

August 2004

Author:

Ben Funnell, Linda (rewriting and more documentation), Ian genericized it in January 2007. Added the option for DotRendering in February 2013.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	BOLD Style of a bold line (twice current stroke width) for this edge.
protected java.awt.Color	color
static java.lang.String	DASHED Style of a dashed line for this edge.
protected g2d.graph.xdotparser.visitor.xDotEdge	dotRendering
static java.lang.String	DOTTED Style of a dotted line for this edge.
static java.lang.String	INVIS Style of a invisible line for this edge.
static java.lang.String	LHEAD
static java.lang.String	LTAIL
protected IOPNode	sink
static java.lang.String	SOLID Style of a solid line for this edge.
protected IOPNode	source
static java.lang.String	SPECIFIC Style of a width-specified line line for this edge.
protected Spline	spline

Fields inherited from class g2d.graph.GraphItem

antiAliased, COMPARATOR, gid, glyphList, HIGHLIGHT, HIGHLIGHT_OFFSET, highlighted

Fields inherited from class g2d.glyph.Glyphish

DEBUG

Constructor Summary

Constructors

Constructor and Description
IOPEdge(IOPEdge clone, IOPNode newSource, IOPNode newSink) Constructs a new edge cloning the given edge with the new endpoints of given nodes.
IOPEdge(IOPNode source, IOPNode sink) Constructs a bare edge (no arrow heads) between two given nodes.
IOPEdge(IOPNode source, IOPNode sink, java.awt.Color c) Constructs a bare edge (no arrow heads) between two given nodes with the given color.

Method Summary

Modifier and Type	Method and Description
boolean	__intersects(java.awt.geom.Rectangle2D rect)
static java.awt.BasicStroke	createStroke(java.lang.String style, float strokeWidth)
void	dehighlight() Revert highlighting to previous state (if any).
double	distanceTo(java.awt.geom.Point2D p) Calculate distance from this edge to given point.
boolean	equals(java.lang.Object o) Two edges are equal if their source and sink nodes are equal.
java.awt.Color	getColor() Obtain current color of edge.
java.util.List<java.awt.geom.Point2D>	getPoints() Get the list of points that define end points and spline.
IOPNode	getSink() Obtain sink node of this edge.
IOPNode	getSource() Obtain source node of this edge.
float	getStrokeWidth() Obtain current stroke width.
java.lang.String	getStyle() Obtain String describing current style.
int	hashCode() Overriding method to comply with equals(Object).
void	highlight() Highlight this edge by drawing it in HIGHLIGHT color defined in GraphItem.
boolean	isDoubleEnded() Query current setting of being double ended (i.e., having two arrow heads, one at each end).
protected void	resetRendering(g2d.graph.xdotparser.visitor.xDotEdge info)
void	setColor(java.awt.Color c) Set color of edge to given value.
void	setDotLayout(java.lang.String _draw_, java.lang.String _ldraw_, java.lang.String _hdraw_, java.lang.String _tdraw_, java.lang.String _hldraw_, java.lang.String _tldraw_, double graphHeight)
void	setDoubleEnded(boolean value) Set whether this edge has arrow heads on both ends or not.
protected void	setRendering(g2d.graph.xdotparser.visitor.xDotEdge info)
void	setStrokeWidth(float width) Set current stroke width to the given value.
void	setStyle(java.lang.String style) Set current style to one described by given String.
java.lang.String	toDotString()
java.lang.String	toString() The String representation conforming to DOT format of edges, for example: "20 -> 4".
void	updatePoints(java.util.List<java.awt.geom.Point2D> points, java.awt.geom.Point2D arrowTipSource, java.awt.geom.Point2D arrowTipSink) Update the curve of this edge using given list of points.

Methods inherited from class g2d.graph.GraphItem

getBounds, gid, inside, intersects, isHighlighted, isSelected, paint, setSelected, transform

Methods inherited from class g2d.glyph.Glyphish

keyPressed, keyReleased, keyTyped, mouseClicked, mouseDragged, mouseEntered, mouseExited, mouseMoved, mousePressed, mouseReleased, rotate, rotate, scale, setKeyAction, setMouseAction, shear, translate, unsetMouseAction

Methods inherited from class g2d.jlambda.Attributable

_getAttribute, _setAttribute, getAttribute, getAttributeAsBoolean, getAttributeAsByte, getAttributeAsChar, getAttributeAsClosure, getAttributeAsDouble, getAttributeAsFloat, getAttributeAsInt, getAttributeAsShort, getAttributeAsString, getKeys, getStaticAttribute, getStaticKeys, isAttribute, isStaticAttribute, removeAllAttributes, removeAllStaticAttributes, removeAttribute, removeStaticAttribute, setAttribute, setStaticAttribute, showAttributes, showAttributes

Methods inherited from class g2d.jlambda.Identifiable

getObject, getUID, setUID, setUID, unsetUID, unsetUID

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

dotRendering

protected g2d.graph.xdotparser.visitor.xDotEdge dotRendering

source

protected IOPNode source

sink

protected IOPNode sink

spline

protected Spline spline

color

protected java.awt.Color color

SOLID

public static final java.lang.String SOLID

Style of a solid line for this edge.

See Also:

setStyle(java.lang.String), Constant Field Values

DASHED

public static final java.lang.String DASHED

Style of a dashed line for this edge.

See Also:

setStyle(java.lang.String), Constant Field Values

DOTTED

public static final java.lang.String DOTTED

Style of a dotted line for this edge.

See Also:

setStyle(java.lang.String), Constant Field Values

BOLD

public static final java.lang.String BOLD

Style of a bold line (twice current stroke width) for this edge.

See Also:

setStyle(java.lang.String), Constant Field Values

INVIS

public static final java.lang.String INVIS

Style of a invisible line for this edge.

See Also:

setStyle(java.lang.String), Constant Field Values

SPECIFIC

public static final java.lang.String SPECIFIC

Style of a width-specified line line for this edge.

See Also:

setStyle(java.lang.String), Constant Field Values

LTAIL

public static final java.lang.String LTAIL

See Also:

Constant Field Values

LHEAD

public static final java.lang.String LHEAD

See Also:

Constant Field Values

Constructor Detail

IOPEdge

public IOPEdge(IOPNode source,
               IOPNode sink)

Constructs a bare edge (no arrow heads) between two given nodes. If not changing appearance of this edge using e.g. updatePoints(java.util.List<java.awt.geom.Point2D>, java.awt.geom.Point2D, java.awt.geom.Point2D), this will be a straight line between the center points of the two nodes.

Parameters:

source - IOPNode that is source (or start/tail) of this edge

sink - IOPNode that is sink (or end/head) of this edge

IOPEdge

public IOPEdge(IOPNode source,
               IOPNode sink,
               java.awt.Color c)

Constructs a bare edge (no arrow heads) between two given nodes with the given color. If not changing appearance of this edge using e.g. updatePoints(java.util.List<java.awt.geom.Point2D>, java.awt.geom.Point2D, java.awt.geom.Point2D), this will be a straight line between the center points of the two nodes.

Parameters:

source - IOPNode that is source (or start/tail) of this edge

sink - IOPNode that is sink (or end/head) of this edge

c - Color of this edge

IOPEdge

public IOPEdge(IOPEdge clone,
               IOPNode newSource,
               IOPNode newSink)

Constructs a new edge cloning the given edge with the new endpoints of given nodes. The resulting edge has the same color, stroke width, style, and points defining spline and arrow heads. It also inherits all attributes from the clone.

Parameters:

clone - IOPEdge to be cloned

newSource - IOPNode used as the new source node of this edge

newSink - IOPNode used as the new sink of this edge

Method Detail

__intersects

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

getSource

public IOPNode getSource()

Obtain source node of this edge.

Returns:

IOPNode that is the source of this edge

getSink

public IOPNode getSink()

Obtain sink node of this edge.

Returns:

IOPNode that is the sink of this edge

setRendering

protected void setRendering(g2d.graph.xdotparser.visitor.xDotEdge info)

resetRendering

protected void resetRendering(g2d.graph.xdotparser.visitor.xDotEdge info)

setDotLayout

public void setDotLayout(java.lang.String _draw_,
                         java.lang.String _ldraw_,
                         java.lang.String _hdraw_,
                         java.lang.String _tdraw_,
                         java.lang.String _hldraw_,
                         java.lang.String _tldraw_,
                         double graphHeight)

updatePoints

public void updatePoints(java.util.List<java.awt.geom.Point2D> points,
                         java.awt.geom.Point2D arrowTipSource,
                         java.awt.geom.Point2D arrowTipSink)

Update the curve of this edge using given list of points. The list must have at least 2 points. Throws an exception if given points are null or the list is less than 2 points long.

The two points given denote the arrow tips of arrows at start and end of edge, respectively. If any of these is null then no arrow at that part of edge is drawn.

Parameters:

points - Ordered list of 3n+1 points to be used to define the cubic curve segments of the edge

arrowTipSource - Point2D of arrow tip at start of edge (if any)

arrowTipSink - Point2D of arrow tip at end of edge (if any)

getPoints

public java.util.List<java.awt.geom.Point2D> getPoints()

Get the list of points that define end points and spline. The first list item refers to the arrow tip of the source and the second list item refers to the arrow tip of the sink. Both can be null . The rest of the list are the points of the spline, if they exist.

Returns:

List of points defining curve of this edge. At least length 2, although the first two list items could each be null

getColor

public java.awt.Color getColor()

Obtain current color of edge.

Returns:

Color of edge

See Also:

setColor(java.awt.Color)

setColor

public void setColor(java.awt.Color c)

Set color of edge to given value.

Note, to have change take effect visually need to issue repainting of container.

Parameters:

c - Color used for edge

See Also:

getColor()

setDoubleEnded

public void setDoubleEnded(boolean value)

Set whether this edge has arrow heads on both ends or not. May override current setting, which is also influenced by the updatePoints(java.util.List<java.awt.geom.Point2D>, java.awt.geom.Point2D, java.awt.geom.Point2D) method. In case of overriding the setting with true, the angle of the arrow head at the source is estimated by the first line segment of the edge.

Parameters:

value - Boolean denoting whether this edge has two arrow heads or not

isDoubleEnded

public boolean isDoubleEnded()

Query current setting of being double ended (i.e., having two arrow heads, one at each end).

Returns:

true if this edge shows two arrow heads and false otherwise.

getStyle

public java.lang.String getStyle()

Obtain String describing current style.

Returns:

String describing current style

See Also:

setStyle(java.lang.String), SOLID, DASHED, DOTTED, BOLD, INVIS

setStyle

public void setStyle(java.lang.String style)

Set current style to one described by given String.

Note, to have change take effect visually need to issue repainting of container.

Parameters:

style - String describing style

See Also:

getStyle(), SOLID, DASHED, DOTTED, BOLD, INVIS, SPECIFIC

getStrokeWidth

public float getStrokeWidth()

Obtain current stroke width.

Returns:

current stroke width as a float

See Also:

setStrokeWidth(float)

setStrokeWidth

public void setStrokeWidth(float width)

Set current stroke width to the given value.

Note, to have change take effect visually need to issue repainting of container.

Parameters:

width - Value of stroke width

See Also:

getStrokeWidth()

createStroke

public static java.awt.BasicStroke createStroke(java.lang.String style,
                                                float strokeWidth)

distanceTo

public double distanceTo(java.awt.geom.Point2D p)

Calculate distance from this edge to given point. Uses approximate distance to spline representing the line in the arrow and neglects the arrow head.

Specified by:

distanceTo in class GraphItem

Parameters:

p - Point to compute distance to

Returns:

distance to point

highlight

public void highlight()

Highlight this edge by drawing it in HIGHLIGHT color defined in GraphItem.

Overrides:

highlight in class GraphItem

dehighlight

public void dehighlight()

Revert highlighting to previous state (if any).

Overrides:

dehighlight in class GraphItem

toString

public java.lang.String toString()

The String representation conforming to DOT format of edges, for example: "20 -> 4".

Overrides:

toString in class java.lang.Object

Returns:

String representation of edge conforming to DOT format

hashCode

public int hashCode()

Overriding method to comply with equals(Object).

Overrides:

hashCode in class java.lang.Object

Returns:

hash value of this IOPNode

equals

public boolean equals(java.lang.Object o)

Two edges are equal if their source and sink nodes are equal.

Overrides:

equals in class java.lang.Object

Parameters:

o - Object to test equality with this IOPEdge

Returns:

true if this IOPEdge is equal to given Object, false otherwise

See Also:

Object.equals(java.lang.Object)

toDotString

public java.lang.String toDotString()