ilog.views.hypergraph.crossing

Class IlvBridgeCrossings

java.lang.Object

ilog.views.IlvGraphic

ilog.views.hypergraph.crossing.IlvAbstractCrossingGraphic

ilog.views.hypergraph.crossing.IlvBridgeCrossings

All Implemented Interfaces:

IlvCrossingGraphic, IlvPersistentObject, IlvBlinkingObject, IlvBaseTextDirectionInterface, Transferable, Serializable

public class IlvBridgeCrossings
extends IlvAbstractCrossingGraphic

An IlvBridgeCrossings is an auxiliary graphic object that is used in combination with an IlvSegmentedHyperEdge. The bridge crossing graphic draws the bridge shapes of the hyperedge crossings. It must be in a manager layer that is above all layers that contain hyperedges. Normally, the IlvSegmentedHyperEdge take care of this automatically.

Notice that each hyperedge needs its own crossing graphic. It cannot be shared among hyperedges. A new tunnel crossing graphic is automatically installed at a segmented hyperedge when the crossing mode is enabled.

Since:

JViews 8.1

See Also:

IlvSegmentedHyperEdge, IlvCrossingAwareObject.getCrossingGraphic(), Serialized Form

Constructor Summary

Constructors

Constructor and Description
IlvBridgeCrossings(IlvBridgeCrossings source) Creates a new IlvBridgeCrossings by copying an existing one.
IlvBridgeCrossings(IlvInputStream stream) Reads the object from an IlvInputStream.
IlvBridgeCrossings(IlvSegmentedHyperEdge edge) Creates a new IlvBridgeCrossings.

Method Summary

Modifier and Type	Method and Description
void	addCrossingBound(IlvRect boundingRect, IlvTransformer t, IlvCrossingAwareObject obj1, IlvCrossingAwareObject obj2, IlvPoint p0, IlvPoint p1, IlvPoint p2, IlvPoint p3, double startGap, double endGap, double normalGap) Adds the bound of the crossing to the input bounding rectangle.
protected IlvRect	calcBoundingBox(IlvTransformer t) Calculate the bounding rectangle of the object.
boolean	containsAtCrossing(IlvPoint p, IlvPoint tp, IlvTransformer t, IlvCrossingAwareObject obj1, IlvCrossingAwareObject obj2, IlvPoint p0, IlvPoint p1, IlvPoint p2, IlvPoint p3, double startGap, double endGap, double normalGap) Tests if a point lies within the drawing of a crossing.
IlvGraphic	copy() Copies the crossing graphic.
void	drawCrossing(Graphics dst, IlvTransformer t, IlvCrossingAwareObject obj1, IlvCrossingAwareObject obj2, IlvPoint p0, IlvPoint p1, IlvPoint p2, IlvPoint p3, double startGap, double endGap, double normalGap) Draws the crossing between the input objects.
double	getBridgeLengthFactor() Returns the bridge length factor.
void	setBridgeLengthFactor(double factor) Sets the bridge length factor.
void	write(IlvOutputStream stream) Writes the object to an IlvOutputStream.
boolean	zoomable() Returns true if the object is zoomable; otherwise it returns false.

Methods inherited from class ilog.views.hypergraph.crossing.IlvAbstractCrossingGraphic

applyTransform, boundingBox, calcBoundingBoxOfLink, contains, crossingChanged, draw, getBoundingBoxCacheSize, getRelatedObject, isInsideCalcBoundingBoxOfLink, setBoundingBoxCacheSize, setGraphicBag, setRelatedObject

Methods inherited from class ilog.views.IlvGraphic

addActionListener, addNamedPropertyListener, allViewsRemoved, baseTextDirectionChanged, blinkingStateOn, boundingBox, callDraw, componentOrientationChanged, getAndAssociateObjectInteractor, getBaseTextDirection, getBlinkingAction, getBlinkingObjectOwner, getBlinkingOffPeriod, getBlinkingOnPeriod, getCenter, getComponentOrientation, getDefaultInteractor, getGraphicBag, GetGraphicObject, getIntersectionWithOutline, getLocale, getName, getNamedProperty, getObjectInteractor, getPopupMenu, getPopupMenu, getPopupMenuName, getProperty, getResolvedBaseTextDirection, getToolTipBaseTextDirection, getToolTipText, getToolTipText, getTopLevelGraphicBag, getTransferData, getTransferDataFlavors, getULocale, getZOrderIndex, hasProperty, inside, intersects, invalidateBBoxCache, invalidateBidiCache, isBaseTextDirectionSensitive, isComponentOrientationSensitive, isDataFlavorSupported, isEditable, isInApplyToObject, isLocaleSensitive, isMovable, isPersistent, isSelectable, isVisible, localeChanged, makeSelection, move, move, moveResize, needsViewNotification, notifyObjectInteractorToManager, processActionEvent, reDraw, registerBlinkingResource, removeActionListener, removeNamedProperty, removeNamedPropertyListener, removeProperty, replaceProperty, resize, rotate, scale, setBackground, setBaseTextDirection, setBaseTextDirectionDuringConstruction, setBlinkingAction, setBlinkingOffPeriod, setBlinkingOnPeriod, setEditable, setFillOn, setForeground, setInApplyToObject, setMovable, setName, setNamedProperty, setNameImpl, setObjectInteractor, setPopupMenu, setPopupMenuName, setProperty, setSelectable, setStrokeOn, setToolTipBaseTextDirection, setToolTipText, setVisible, setZOrderIndex, toString, translate, updateNeedsViewNotification, usesBidiMarkers, viewAddedOrRemoved

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvBridgeCrossings

public IlvBridgeCrossings(IlvSegmentedHyperEdge edge)

Creates a new IlvBridgeCrossings.

Parameters:

edge - The hyperedge this object belongs to.

IlvBridgeCrossings

public IlvBridgeCrossings(IlvBridgeCrossings source)

Creates a new IlvBridgeCrossings by copying an existing one. It does not copy the reference to the link this object belongs to.

Parameters:

source - The origin object for the copy.

IlvBridgeCrossings

public IlvBridgeCrossings(IlvInputStream stream)
                   throws IlvReadFileException

Reads the object from an IlvInputStream.

Parameters:

stream - The input stream.

Throws:

IlvReadFileException - if the format is not correct.

Method Detail

copy

public IlvGraphic copy()

Copies the crossing graphic. It does not copy the reference to the link this object belongs to.

Specified by:

copy in class IlvGraphic

Returns:

A copy of the object.

See Also:

IlvGraphic

setBridgeLengthFactor

public void setBridgeLengthFactor(double factor)

Sets the bridge length factor. The length of the bridge is calculated from the link width multiplied by the bridge length factor. The default factor is 3.

See Also:

getBridgeLengthFactor()

getBridgeLengthFactor

public final double getBridgeLengthFactor()

Returns the bridge length factor.

See Also:

setBridgeLengthFactor(double)

drawCrossing

public void drawCrossing(Graphics dst,
                         IlvTransformer t,
                         IlvCrossingAwareObject obj1,
                         IlvCrossingAwareObject obj2,
                         IlvPoint p0,
                         IlvPoint p1,
                         IlvPoint p2,
                         IlvPoint p3,
                         double startGap,
                         double endGap,
                         double normalGap)

Draws the crossing between the input objects. The input points and gaps are transformed by the input transformer.

Parameters:

dst - The destination Graphics.

t - The transformation used to draw the first object.

obj1 - The first object, which is the object containing this crossing graphic.

obj2 - The second object.

p0 - The point before the start point of the crossing picture inside the first object.

p1 - The start point of the crossing picture inside the first object.

p2 - The end point of the crossing picture inside the first object.

p3 - The point after the end point of the crossing picture inside the first object.

startGap - The real gap between start point and the crossing.

endGap - The real gap between end point and the crossing.

normalGap - The desired normal gap at the crossing. The start gap and end gap may be smaller than the normal gap.

containsAtCrossing

public boolean containsAtCrossing(IlvPoint p,
                                  IlvPoint tp,
                                  IlvTransformer t,
                                  IlvCrossingAwareObject obj1,
                                  IlvCrossingAwareObject obj2,
                                  IlvPoint p0,
                                  IlvPoint p1,
                                  IlvPoint p2,
                                  IlvPoint p3,
                                  double startGap,
                                  double endGap,
                                  double normalGap)

Tests if a point lies within the drawing of a crossing. The input points and gaps are transformed by the input transformer.

Specified by:

containsAtCrossing in interface IlvCrossingGraphic

Overrides:

containsAtCrossing in class IlvAbstractCrossingGraphic

Parameters:

p - The point to be tested. This point is untransformed.

tp - The point p transformed by the transformer t.

t - The transformation used to draw the first object.

obj1 - The first object, which is the object containing this crossing graphic.

obj2 - The second object.

p0 - The point before the start point of the crossing picture inside the first object.

p1 - The start point of the crossing picture inside the first object.

p2 - The end point of the crossing picture inside the first object.

p3 - The point after the end point of the crossing picture inside the first object.

startGap - The real gap between start point and the crossing.

endGap - The real gap between end point and the crossing.

normalGap - The desired normal gap at the crossing. The start gap and end gap may be smaller than the normal gap.

calcBoundingBox

protected IlvRect calcBoundingBox(IlvTransformer t)

Calculate the bounding rectangle of the object. This is called by IlvAbstractCrossingGraphic.boundingBox(ilog.views.IlvTransformer) when the bounding box for the input transformer is not internally cached.

Overrides:

calcBoundingBox in class IlvAbstractCrossingGraphic

Parameters:

t - The transformer to draw the related object.

Returns:

A freshly allocated rectangle.

See Also:

IlvAbstractCrossingGraphic.boundingBox(ilog.views.IlvTransformer), IlvAbstractCrossingGraphic.setBoundingBoxCacheSize(int)

addCrossingBound

public void addCrossingBound(IlvRect boundingRect,
                             IlvTransformer t,
                             IlvCrossingAwareObject obj1,
                             IlvCrossingAwareObject obj2,
                             IlvPoint p0,
                             IlvPoint p1,
                             IlvPoint p2,
                             IlvPoint p3,
                             double startGap,
                             double endGap,
                             double normalGap)

Adds the bound of the crossing to the input bounding rectangle. The input points and gaps are transformed by the input transformer.

Parameters:

boundingRect - The bounding rectangle containing the result.

t - The transformation used to draw the first object.

obj1 - The first object, which is the object containing this crossing graphic.

obj2 - The second object.

p0 - The point before the start point of the crossing picture inside the first object.

p1 - The start point of the crossing picture inside the first object.

p2 - The end point of the crossing picture inside the first object.

p3 - The point after the end point of the crossing picture inside the first object.

startGap - The real gap between start point and the crossing.

endGap - The real gap between end point and the crossing.

normalGap - The desired normal gap at the crossing. The start gap and end gap may be smaller than the normal gap.

zoomable

public boolean zoomable()

Returns true if the object is zoomable; otherwise it returns false. The object is zoomable if the related hyperedge is zoomable, has a nonzero line width, and the gap is zoomable.

Overrides:

zoomable in class IlvAbstractCrossingGraphic

See Also:

IlvSegmentedHyperEdge.isGapZoomable()

write

public void write(IlvOutputStream stream)
           throws IOException

Writes the object to an IlvOutputStream. You should not call this method directly; instead, you should use the write methods of the manager.

Specified by:

write in interface IlvPersistentObject

Overrides:

write in class IlvAbstractCrossingGraphic

Parameters:

stream - The output stream.

Throws:

IOException - thrown when an exception occurs during the write operation for this object.