ilog.views.hypergraph.edgeconnector

Class IlvHyperEdgeClippingConnector

java.lang.Object

ilog.views.IlvGraphic

ilog.views.hypergraph.edgeconnector.IlvHyperEdgeConnector

ilog.views.hypergraph.edgeconnector.IlvHyperEdgeConnectorWithCache

ilog.views.hypergraph.edgeconnector.IlvHyperEdgeClippingConnector

All Implemented Interfaces:

IlvPersistentObject, IlvBlinkingObject, IlvBaseTextDirectionInterface, Transferable, Serializable

public class IlvHyperEdgeClippingConnector
extends IlvHyperEdgeConnectorWithCache

The hyperedge clipping connector connects the hyperedge ends to the border of a node. The hyperedge end can be moved to any point inside the node, but the real connection point is the obtained by clipping the end segment of the hyperedge at the node border, if the node is one of the standard graphic objects. This is useful if the hyperedges have arrowheads that should be drawn exactly at the node border and the shape of the node is nonrectangular, for example a triangle, circle, or polygon.

It can clip at the border of the following objects:

• All rectangular objects that fill the bounding box completely.
• All objects that implement the IlvShapePath interface.
• IlvPolygon
• IlvEllipse
• IlvArc
• IlvRectangle
• IlvSpline with a small border line width and smoothness larger than zero. It does not work with IlvGraphicUtil.COMPATIBLE_SMOOTHNESS. If the line width is very large, rounding errors will become visible.
• IlvGeneralPathwith a stroke width of 0.

All other objects are clipped against their bounding box.

This connector can be attached to a node or to a hyperedge (see IlvHyperEdgeConnector.attach(ilog.views.IlvGraphic, boolean)). This connector does not display any visible part, therefore it does not act like a graphic object and should never be added to a grapher. It is purely a computation mechanism.

Since:

JViews 8.0

See Also:

IlvHyperEdge, IlvHyperEdgePinConnector, Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class ilog.views.hypergraph.edgeconnector.IlvHyperEdgeConnector

IlvHyperEdgeConnector.HyperEdgeConnectorProperty

Field Summary

Fields inherited from class ilog.views.hypergraph.edgeconnector.IlvHyperEdgeConnector

IN_BACK, IN_FIXED_LAYER, IN_FRONT, IN_NODE_LAYER

Constructor Summary

Constructors

Constructor and Description
IlvHyperEdgeClippingConnector() Creates an empty IlvHyperEdgeClippingConnector.
IlvHyperEdgeClippingConnector(IlvGraphic obj) Creates an IlvHyperEdgeClippingConnector attached to the input object, which can be a node or a hyperedge.
IlvHyperEdgeClippingConnector(IlvHyperEdgeClippingConnector source) Creates an IlvHyperEdgeClippingConnector by copying an existing one.
IlvHyperEdgeClippingConnector(IlvInputStream stream) Reads the object from an IlvInputStream.

Method Summary

Modifier and Type	Method and Description
protected IlvPoint	calcConnectionPoint(IlvHyperEdgeEnd end, IlvTransformer t) Calculate the connection point of the hyperedge end at the corresponding node.
IlvGraphic	copy() Copies the object.
IlvPoint	getClosestConnectionPoint(IlvHyperEdgeEnd end, IlvPoint p, IlvTransformer t) Returns the closest possible connection point of the hyperedge end at the corresponding node.
boolean	isClipToCenter() Sets true if all segments incident to the connector should point to the center of the node.
boolean	isGraphic() Returns whether the connector displays a visible part.
void	setClipToCenter(boolean enable) Sets whether all segments incident to the connector should point to the center of the node.
void	write(IlvOutputStream stream) Writes the property to the output stream.

Methods inherited from class ilog.views.hypergraph.edgeconnector.IlvHyperEdgeConnectorWithCache

actOnOwnerInserted, actOnOwnerRemoved, adjust, adjustAll, detachImpl, disconnect, getConnectionPoint

Methods inherited from class ilog.views.hypergraph.edgeconnector.IlvHyperEdgeConnector

actAfterLayerChanged, actAfterOwnerTransform, actOnOwnerRead, actOnRead, actOnWrite, allowRemoval, allowsConnectionPointMove, applyTransform, attach, attachImpl, boundingBox, calcBoundingBox, clearBoundingBoxCache, connect, connectionsZoomable, contains, detach, draw, Get, GetAttached, getFixedLayer, getLayerMode, GetLocal, getOwner, isConnectionPointMoveAllowed, move, moveResize, resize, rotate, scale, setConnectionPointMoveAllowed, setFixedLayer, setLayerMode, translate, zoomable

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, needsViewNotification, notifyObjectInteractorToManager, processActionEvent, reDraw, registerBlinkingResource, removeActionListener, removeNamedProperty, removeNamedPropertyListener, removeProperty, replaceProperty, setBackground, setBaseTextDirection, setBaseTextDirectionDuringConstruction, setBlinkingAction, setBlinkingOffPeriod, setBlinkingOnPeriod, setEditable, setFillOn, setForeground, setGraphicBag, setInApplyToObject, setMovable, setName, setNamedProperty, setNameImpl, setObjectInteractor, setPopupMenu, setPopupMenuName, setProperty, setSelectable, setStrokeOn, setToolTipBaseTextDirection, setToolTipText, setVisible, setZOrderIndex, toString, updateNeedsViewNotification, usesBidiMarkers, viewAddedOrRemoved

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvHyperEdgeClippingConnector

public IlvHyperEdgeClippingConnector()

Creates an empty IlvHyperEdgeClippingConnector. To attach the connector to a node or hyperedge, call IlvHyperEdgeConnector.attach(ilog.views.IlvGraphic, boolean).

IlvHyperEdgeClippingConnector

public IlvHyperEdgeClippingConnector(IlvGraphic obj)

Creates an IlvHyperEdgeClippingConnector attached to the input object, which can be a node or a hyperedge.

IlvHyperEdgeClippingConnector

public IlvHyperEdgeClippingConnector(IlvHyperEdgeClippingConnector source)

Creates an IlvHyperEdgeClippingConnector by copying an existing one.

Parameters:

source - The origin of the copy.

IlvHyperEdgeClippingConnector

public IlvHyperEdgeClippingConnector(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

write

public void write(IlvOutputStream stream)
           throws IOException

Writes the property to the output stream.

Specified by:

write in interface IlvPersistentObject

Overrides:

write in class IlvHyperEdgeConnector

Parameters:

stream - The output stream.

Throws:

IOException - standard IO error.

copy

public IlvGraphic copy()

Copies the object.

Specified by:

copy in class IlvGraphic

Returns:

A copy of the object.

See Also:

IlvGraphic

isGraphic

public boolean isGraphic()

Returns whether the connector displays a visible part. This connector never displays any visible part, therefore it always returns false.

Overrides:

isGraphic in class IlvHyperEdgeConnector

calcConnectionPoint

protected IlvPoint calcConnectionPoint(IlvHyperEdgeEnd end,
                                       IlvTransformer t)

Calculate the connection point of the hyperedge end at the corresponding node. This method cannot look up in the cache. It is used to fill the cache.

Specified by:

calcConnectionPoint in class IlvHyperEdgeConnectorWithCache

Parameters:

end - The hyperedge end.

t - The transformer used to draw the hyperedge.

Returns:

The connection point at the node in view coordinates

getClosestConnectionPoint

public IlvPoint getClosestConnectionPoint(IlvHyperEdgeEnd end,
                                          IlvPoint p,
                                          IlvTransformer t)

Returns the closest possible connection point of the hyperedge end at the corresponding node.

Specified by:

getClosestConnectionPoint in class IlvHyperEdgeConnector

Parameters:

end - The hyperedge end.

p - The proposed point in view coordinates.

t - The transformer used to draw the hyperedge.

Returns:

The closest connection point at the node in view coordinates.

setClipToCenter

public void setClipToCenter(boolean enable)

Sets whether all segments incident to the connector should point to the center of the node. If this is the case, the connection points are not movable within the node. This option is disabled by default. If the connector is attached to a node or hyperedge, you should use IlvManager.applyToObject(ilog.views.IlvGraphic, ilog.views.IlvApplyObject, java.lang.Object, boolean) on the node or hyperedge to change this option.

See Also:

isClipToCenter()

isClipToCenter

public boolean isClipToCenter()

Sets true if all segments incident to the connector should point to the center of the node.

See Also:

setClipToCenter(boolean)