ilog.views.hypergraph.crossing

Interface IlvCrossingGraphic

All Known Implementing Classes:

IlvAbstractCrossingGraphic, IlvBridgeCrossings, IlvTunnelCrossings

public interface IlvCrossingGraphic

An interface to be implemented by the crossing graphic object used in IlvCrossingAwareObject. Crossing aware objects are typically links and hyperedges, i.e. graphic objects that consist of a set of line segments.

Notice: the crossing graphic of an object is not necessarily in the same grapher as the object. However, the methods defined in this interface get the transformation used to draw the object as input parameter, which is not necessarily the same transformation used to draw this crossing graphic.

Since:

JViews 8.1

See Also:

IlvCrossingAwareObject.getCrossingGraphic(), IlvSegmentedHyperEdge.setCrossingGraphic(ilog.views.IlvGraphic, int)

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.
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.
void	crossingChanged() This method is called whenever a crossing related to this crossing graphic has changed.
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.

Method Detail

addCrossingBound

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.

drawCrossing

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

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.

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.

crossingChanged

void crossingChanged()

This method is called whenever a crossing related to this crossing graphic has changed. Typically, you can use this to invalidate internal data structures such as a cache for the bounding box of the object.