JViews 5.5 Graph Layout Release Notes

This document describes the main changes that have been made to the JViews Graph Layout module since version 5.0.

Incompatibilities
General Changes
Library Changes

New Packages

• ilog.views.graphlayout.recursive

New Interfaces and Classes

• ilog.views.graphlayout.IlvAutoLayoutHandler
• ilog.views.graphlayout.hierarchical.IlvSwimLaneConstraint
• ilog.views.graphlayout.labellayout.IlvLabelMovementPolicy
• ilog.views.graphlayout.labellayout.annealing.IlvObstacleOffsetInterface
• ilog.views.graphlayout.labellayout.annealing.IlvOverlappingLabelMovementPolicy
• ilog.views.graphlayout.recursive.IlvRecursiveLayout
• ilog.views.graphlayout.recursive.IlvRecursiveLayoutGrapherProperty
• ilog.views.graphlayout.recursive.IlvRecursiveLayoutProvider
• ilog.views.graphlayout.recursive.IlvRecursiveLayoutReport
• ilog.views.graphlayout.recursive.IlvRecursiveMultipleLayout
• ilog.views.graphlayout.recursive.IlvSubgraphCorrectionBarycenterFixed
• ilog.views.graphlayout.recursive.IlvSubgraphCorrectionBoundsFixed
• ilog.views.graphlayout.recursive.IlvSubgraphCorrectionInterface

Modified Classes

• ilog.views.graphlayout.GraphModelEvent
• ilog.views.graphlayout.IlvClipLinkConnector
• ilog.views.graphlayout.IlvDefaultLayoutProvider
• ilog.views.graphlayout.IlvGraphLayout
• ilog.views.graphlayout.IlvGraphLayoutException
• ilog.views.graphlayout.IlvGraphLayoutUtil
• ilog.views.graphlayout.IlvGraphModel
• ilog.views.graphlayout.IlvGrapherAdapter
• ilog.views.graphlayout.IlvRelativeLinkConnector
• ilog.views.graphlayout.bus.IlvBusLayout
• ilog.views.graphlayout.circular.IlvCircularLayout
• ilog.views.graphlayout.grid.IlvGridLayout
• ilog.views.graphlayout.hierarchical.IlvHierarchicalLayout
• ilog.views.graphlayout.hierarchical.IlvNodeGroup
• ilog.views.graphlayout.labellayout.IlvDefaultLabelingModel
• ilog.views.graphlayout.labellayout.IlvLabelingModel
• ilog.views.graphlayout.labellayout.LabelingModelEvent
• ilog.views.graphlayout.labellayout.annealing.IlvAnnealingLabelLayout
• ilog.views.graphlayout.labellayout.annealing.IlvAnnealingPointLabelDescriptor
• ilog.views.graphlayout.labellayout.annealing.IlvAnnealingPolylineLabelDescriptor
• ilog.views.graphlayout.link.IlvLinkLayout
• ilog.views.graphlayout.link.longlink.IlvLongLinkLayout
• ilog.views.graphlayout.link.shortlink.IlvShortLinkLayout
• ilog.views.graphlayout.multiple.IlvMultipleLayout

• Recursive Layout Applet
• Link Bundle Applet
• Link Crossing Applet

Incompatibilities

• Some deprecated methods and classes of JViews 5.0 have been removed; check the JViews 5.0 Reference Manual for alternatives in each case.
• ilog.views.graphlayout.IlvGrapherAdapter
  • The class IlvGrapherAdapter no longer implements the interface ManagerContentsChangedListener. Therefore, the method contentsChanged has been removed.

• ilog.views.graphlayout.labellayout.IlvDefaultLabelingModel
  • The class no longer implements the ManagerContentChangedListener interface. Therefore, the method contentsChanged has been removed.
  • It is no longer recommended to override isLabel or isObstacle. If necessary, please override isDefaultLabelClass or isDefaultObstacleClass instead.
  • The full layer notification is now enabled by default.

General Changes

• Simplified handling of recursive layout of nested graphs with the new IlvRecursiveLayout class.
• Hierarchical Layout improvements:

  • Swimlane constraints.
  • Fork shape of orthogonal links.
  • Improved support for "fixed" nodes in incremental layout.
  • Speed improvements.

• Improved support for "fixed" ("pinned") connection points of grapher links. The following layout algorithms now allow you to "pin" connection points either globally or per-link and are able to preserve connections specified using "grapher pins" (IlvGrapherPin):

  • IlvLinkLayout
  • IlvShortLinkLayout
  • IlvLongLinkLayout
  • IlvHierarchicalLayout

• Short Link Layout improvements:

  • Improved quality of the incremental mode: automatic detection of links whose origin or destination node have been moved or resized.
  • Improved support of "thick" links: the link width is taken into account for the computation of link to node crossings.
  • Improved support of "fixed" links: the algorithm now avoids overlaps of the connection points of nonfixed links with the connection points of "fixed" links.
  • Improved support of "self-links": more uniform distribution of self-links to the four sides of nodes. Two-bend self-links can now be bundled together like any other link.
  • Customization using a Node Side Filter is now always strictly respected (if necessary, orthogonal links with up to four bends are created).

• Improved customization of offsets and movement policies in the Annealing Label Layout.
• Circular Layout improvements: a new optional mode for specifying the clustering using subgraphs, taking into account both normal and intergraph links while preserving the initial position of the subgraphs.
• Improved customization of Bus Layout and Grid Layout. (Control is now provided over the number of nodes per level or row or column.)
• Improved, finer-grained graph event mechanism.

Library Changes

Deprecated Classes and Methods

For details about methods that have been deprecated, see this.

New Packages

ilog.views.graphlayout.recursive

The Recursive Layout class is not really a layout algorithm but rather a facility to traverse a nested graph containing subgraphs and perform layouts recursively for each subgraph.

New Interfaces and Classes

ilog.views.graphlayout.IlvAutoLayoutHandler

An interface used to perform a layout automatically again following a structural or geometric change of the graph.

ilog.views.graphlayout.hierarchical.IlvSwimLaneConstraint

The class IlvSwimLaneConstraint is a constraint that forces a group of nodes to be placed in the same column or row.

ilog.views.graphlayout.labellayout.IlvLabelMovementPolicy

An interface used to define the policies when a label is allowed to be moved by the label layout algorithm.

ilog.views.graphlayout.labellayout.annealing.IlvObstacleOffsetInterface

An interface used to select specific mimimal offsets between certain label/obstacle pairs.

ilog.views.graphlayout.labellayout.annealing.IlvOverlappingLabelMovementPolicy

A label movement policy that allows a label to be moved by the label layout algorithm only if the label initially overlaps other labels or obstacles.

ilog.views.graphlayout.recursive.IlvRecursiveLayout

The main class for the Recursive Layout algorithm.

ilog.views.graphlayout.recursive.IlvRecursiveLayoutGrapherProperty

The class IlvRecursiveLayoutGrapherProperty allows you to store the global settings of an instance of IlvRecursiveLayout as a named property in the grapher.

ilog.views.graphlayout.recursive.IlvRecursiveLayoutProvider

The internal layout provider used by the Recursive Layout in internal provider mode.

ilog.views.graphlayout.recursive.IlvRecursiveLayoutReport

The class used to store information about the behavior of the Recursive Layout algorithm.

ilog.views.graphlayout.recursive.IlvRecursiveMultipleLayout

The main class for the Recursive Multiple Layout algorithm.

ilog.views.graphlayout.recursive.IlvSubgraphCorrectionBarycenterFixed

This subgraph correction strategy keeps the barycenter of a subgraph fixed during recursive layout.

ilog.views.graphlayout.recursive.IlvSubgraphCorrectionBoundsFixed

This subgraph correction strategy keeps the bounds of a subgraph fixed during recursive layout.

ilog.views.graphlayout.recursive.IlvSubgraphCorrectionInterface

An interface used to define corrections of a subgraph after the layout of the subgraph was performed.

Modified Classes

ilog.views.graphlayout.GraphModelEvent

• Overview of new features:
  • Now provides the node or link that causes the event and distinct event types for more precise kinds of events.
• New methods:
  • getNodeOrLink(): Returns the node or link that causes the event.
  • setNodeOrLink(Object): Sets the node or link that causes the event.
  • isAdjustmentEnd(): Returns true if this event is the end of a series of modifications.
  • setAdjustmentEnd(boolean): Changes the adjustment end flag of the event.
• New fields:
  • LINK_ADDED: The bit mask of the type of the event when an link has been added.
  • LINK_GEOMETRY_CHANGED: The bit mask of the type of the event when a link has been reshaped.
  • LINK_REMOVED: The bit mask of the type of the event when an link has been removed.
  • NODE_ADDED: The bit mask of the type of the event when a node has been added.
  • NODE_GEOMETRY_CHANGED: The bit mask of the type of the event when a node has been moved or resized.
  • NODE_REMOVED: The bit mask of the type of the event when a node has been removed.

ilog.views.graphlayout.IlvClipLinkConnector

• Overview of new features:
  • Now can be attached not only to a node, but also to individual links.
• New constructors:
  • IlvClipLinkConnector(IlvLinkImage, boolean): Creates an IlvClipLinkConnector attached to the origin or destination of the link link.

ilog.views.graphlayout.IlvDefaultLayoutProvider

• Overview of new features:
  • The preferred layout can now be specified in a recursive way.
• New methods:
  • setPreferredLayout(IlvGraphModel, IlvGraphLayout, boolean, boolean): Sets the layout instances to be used for laying out graphModel.

ilog.views.graphlayout.IlvGraphLayout

• Overview of new features:
  • The recursive layout is now performed using the new IlvRecursiveLayout class. This provides an improved customization of the recursive layout process.
  • The "autolayout" mechanism, previously supported only by link layout, is now a generic parameter of all layouts and can be customized using the new interface IlvAutoLayoutHandler.
  • User property objects can be stored on a layout instance.
• New methods:
  • getAutoLayoutHandler(): Returns the autolayout handler.
  • setAutoLayoutHandler(IlvAutoLayoutHandler): Sets the autolayout handler.
  • getLayout(Object): Returns the layout instance for a subgraph of the nested graph encapsulated by the graph model of this layout instance.
  • getLayoutRegion(): Returns a copy of the rectangle that defines the layout region, as specified using the methods setLayoutRegion(IlvManagerView, IlvRect), setLayoutRegion(IlvManagerView), or setLayoutRegion(IlvRect).
  • getProperty(String): Returns the value of a property of the layout instance.
  • setProperty(IlvGraphModel, Object, String, Object): Sets the value of a property for a node or a link, using a given graph model.
  • setProperty(String, Object): Sets the value of a property for the layout instance.
  • getProperty(IlvGraphModel, Object, String): Returns the value of a property of the layout instance.
  • getRecursiveLayout(): Returns the instance of Recursive Layout that is used to perform this layout recursively when you call performLayout(boolean, boolean, boolean) with the traverse flag set to true.
  • isAutoLayout(): Returns true if the autolayout mode is enabled.
  • setAutoLayout(boolean): Enables the autolayout mode.
  • performAutoLayout(): Performs the layout again following a structural or geometric change of the graph.
  • performSublayout(Object, IlvGraphLayout, boolean, boolean): Starts the input layout algorithm.

ilog.views.graphlayout.IlvGraphLayoutException

• Overview of new features:
  • Layout exceptions can now be "chained". This is useful internally, with the benefit for users of an improved management of exceptions during recursive layouts.
• New methods:
  • getNext(): Returns the next exception in an exception chain.
  • setNext(IlvGraphLayoutException): Sets the next exception in an exception chain.

ilog.views.graphlayout.IlvGraphLayoutUtil

• Overview of new features:
  • New utility particularily convenient for recursive layouts.
• New methods:
  • EnsureAppropriateLinks(IlvGraphModel, IlvLayoutProvider): Ensures that the link and link connector classes used in a nested IlvGrapher hierarchy are appropriate for the layout algorithm that are delivered by the input provider.

ilog.views.graphlayout.IlvGraphModel

• Overview of new features:
  • Improved, finer-grain model event mechanism. Now takes into account distinct cases such as node addition, node removal, link reshaping and so on.
• New methods:
  • afterAttach(IlvGraphLayout): Notifies the graph model that it has been attached to a layout.
  • afterDetach(IlvGraphLayout): Notifies the graph model that it has been detached from a layout.
  • fireGraphModelEvent(Object, int, boolean): Notifies the graph-model-event listeners that nodes or links have been added or removed, or that their geometry has changed (nodes or links were moved or reshaped).
  • getLayout(IlvLayoutProvider, Object): Returns the layout instance for a subgraph of the nested graph encapsulated by this graph model.
  • getOriginatingLayout(): Returns the layout that created this model internally because an IlvGrapher got directly attached.
  • hasPinnedConnectionPoint(Object, boolean): Returns true if the connection point of link on the origin or destination node is "pinned", and false otherwise.
  • isInternalGraphModelChecking(): Returns true if the extended checking of internally created graph models is enabled.
  • setInternalGraphModelChecking(boolean): Enables or disables the extended checking of internally created graph models, e.g., the grapher adapter that is internally created inside IlvGraphLayout.attach(IlvGrapher).
  • performLayout(IlvLayoutProvider, IlvGraphLayout, boolean, boolean, boolean): Applies layout instances recursively to this graph model.

ilog.views.graphlayout.IlvGrapherAdapter

• Overview of new features:
  • Improved, finer-grain model event mechanism. Now takes into account distinct cases such as node addition, node removal, link reshaping and so on. Improved control over the way model events are raised for layer additions and removals.
• New methods:
  • getLayersCount(): Returns the number of manager layers to be taken into account during the layout.
  • getLayoutPropertyPrefix(IlvGraphLayout): Returns the property name of the input layout, if it was most recently stored as named property, or null, if the layout was never stored.
  • getPreferredLayoutPropertyPrefix(): Returns the property name of the preferred layout, or null, if no preferred layout was stored.
  • setPreferredLayoutPropertyPrefix(String): Sets the property name of the preferred layout.
  • hasPinnedConnectionPoint(Object, boolean): Returns true if the connection point of link on the origin or destination node is connected to a grapher pin, and false otherwise.
  • isFullLayerNotification(): Returns true if adding or removing a layer sends a separate event for each object contained in the layer.
  • setFullLayerNotification(boolean): Sets whether adding or removing a layer fires just one or many graph model events.
  • isLayerAdded(IlvManagerLayer): Returns true if the manager layer is one of the layers to be taken into account during the layout.

ilog.views.graphlayout.IlvRelativeLinkConnector

• Overview of new features:
  • Now can be attached not only to a node, but also to individual links.
  • For links that have not been connected using connectLink, the connection points are now computed using the same default rules as those used by IlvLinkImage when no link connector is attached to a node. In the previous releases, the center of the bounding box of the node was returned in this case.
• New constructors:
  • IlvRelativeLinkConnector(IlvLinkImage, boolean): Creates an IlvRelativeLinkConnector attached to the origin or destination of the link link.
• New methods:
  • disconnectLink(IlvLinkImage, boolean): Disconnects a link from the link connector.
  • disconnectAllLinks(): Disconnects all the links connected to the link connector.

ilog.views.graphlayout.bus.IlvBusLayout

• Overview of new features:
  • Improved customization: it is now possible to specify the maximum number of nodes per level and to obtain the automatic adjustment of the shape of the bus line to the total width of the nodes.
• New methods:
  • getMaxNumberOfNodesPerLevel(): Returns the maximum number of nodes per level.
  • setMaxNumberOfNodesPerLevel(int): Sets the maximum number of nodes per level.
  • isBusWidthAdjustingEnabled(): Returns true if the adjustment of the bus width to the total width of the nodes is enabled.
  • setBusWidthAdjustingEnabled(boolean): Enables the adjustment of the bus width to the total width of the nodes.

ilog.views.graphlayout.circular.IlvCircularLayout

• Overview of new features:
  • Provides a new optional mode for specifying the clustering. The nodes and links of a cluster can now be contained by subgraphs. In this mode, the layout places the nodes of each cluster on a circle, while taking into account crossings of both normal and intergraph links. Notice that in this mode the layout preserves the initial position of the clusters.
• New methods:
  • getClusteringMode(): Returns the current clustering mode.
  • setClusteringMode(int): Sets the clustering mode.
  • getMaxNumberOfPermutations(): Returns the maximal number of permutations tested for a cluster of more than 7 nodes.
  • setMaxNumberOfPermutations(int): Sets the maximal number of permutations tested for a cluster of more than 7 nodes.
• New fields:
  • BY_CLUSTER_IDS: Clustering by cluster ids mode.
  • BY_SUBGRAPHS: Clustering by subgraphs mode.

ilog.views.graphlayout.grid.IlvGridLayout

• Overview of new features:
  • Improved customization: it is now possible to specify the maximum number of nodes per row or column.
• New methods:
  • getMaxNumberOfNodesPerRowOrColumn(): Returns the maximum number of nodes per row in TILE_TO_ROWS mode or the maximum number of nodes per column in TILE_TO_COLUMNS mode.
  • setMaxNumberOfNodesPerRowOrColumn(int): Sets the maximum number of nodes per row in TILE_TO_ROWS mode or the maximum number of nodes per column in TILE_TO_COLUMNS mode.

ilog.views.graphlayout.hierarchical.IlvHierarchicalLayout

• Overview of new features:
  • Swimlane constraints: Swimlanes are rectangular areas parallel to the edge flow direction, that is, orthogonal to the level areas. A swimlane constraint forces nodes to be placed within the swimlane rectangle.
  • Fork shape of orthogonal links, if a bundle of links starts or ends at the same point.
  • Connection point modes: the connection points of links can be declared free (the old behavior) or fixed. If the connection points are fixed, the layout algorithm does not move the connection points and ignores the connector style. The connection points of links connected to IlvGrapherPin objects handled by an IlvPinLinkConnector are considered as fixed and, hence, are not moved. This makes it much easier to specify fixed connection points using grapher pins.
  • Node movement mode for incremental layout: During incremental layout, the nodes can be declared free (old behavior) or fixed (selective in the x or y direction). If the nodes are fixed, they don't move but are considered by the incremental layout. If all nodes are fixed, then only the links are routed. The hierarchical layout acts as a link routing algorithm in this case. If only some nodes are fixed, node overlaps may occur when the nonfixed nodes don't fit in the free space between fixed nodes.
  • Various speed improvements for the crossing reduction phase: The crossing reduction mechanism can be controlled by many more expert options. In particular, there is a "quick and ugly" mode that sets all expert options so that the layout is performed very fast.
• New methods:
  • getDestinationPointMode(Object): Returns the destination point mode of an individual link.
  • setDestinationPointMode(Object, int): Sets the mode for the connection point on an individual link on the destination node.
  • getEastNumberOfPorts(Object): Returns the number of relative ports on the east side of a node.
  • setEastNumberOfPorts(Object, int): Sets the number of relative ports on the east side of a node.
  • getGlobalDestinationPointMode(): Returns the global mode for the connection points of the links on the destination nodes.
  • setGlobalDestinationPointMode(int): Sets the global mode for the connection point of the links on the destination nodes.
  • getGlobalIncrementalNodeMovementMode(): Returns the node movement mode used during incremental layout.
  • setGlobalIncrementalNodeMovementMode(int): Sets the node movement mode used during incremental layout.
  • getGlobalOriginPointMode(): Returns the global mode for the connection points of the links on the origin nodes.
  • setGlobalOriginPointMode(int): Sets the global mode for the connection point of the links on the origin nodes.
  • getIncrementalNodeMovementMode(Object): Returns the movement mode of an individual node used during incremental layout.
  • setIncrementalNodeMovementMode(Object, int): Sets the movement mode of an individual node used during incremental layout.
  • isIntergraphConnectivityMode(): Returns true if the intergraph link connectivity is considered for the partitioning of the layout into levels.
  • setIntergraphConnectivityMode(boolean): Sets whether the intergraph link connectivity is considered for the partitioning of the layout into levels.
  • getMinForkSegmentLength(): Returns the minimal length of the start or end segment of links if a fork shape is used for these links.
  • setMinForkSegmentLength(float): Sets the minimal length of the start or end segment of links if a fork shape is used for these links.
  • getNorthNumberOfPorts(Object): Returns the number of relative ports on the north side of a node.
  • setNorthNumberOfPorts(Object, int): Sets the number of relative ports on the north side of a node.
  • getNumberOfLinkCrossingSweeps(): Returns the number of layer sweeps to remove link crossings.
  • setNumberOfLinkCrossingSweeps(int): Sets the number of layer sweeps to remove link crossings.
  • getOriginPointMode(Object): Returns the origin point mode of an individual link.
  • setOriginPointMode(Object, int): Sets the mode for the connection point on an individual link on the origin node.
  • getPreferredForkAxisLength(): Returns the preferred length of the axis of a fork shape.
  • setPreferredForkAxisLength(float): Sets the preferred length of the axis of a fork shape.
  • getSouthNumberOfPorts(Object): Returns the number of relative ports on the south side of a node.
  • setSouthNumberOfPorts(Object, int): Sets the number of relative ports on the south side of a node.
  • getWestNumberOfPorts(Object): Returns the number of relative ports on the west side of a node.
  • setWestNumberOfPorts(Object, int): Sets the number of relative ports on the west side of a node.
  • isBacktrackCrossingReductionEnabled(): Returns true if the backtrack mechanism of the link crossing reduction phase is enabled.
  • setBacktrackCrossingReductionEnabled(boolean): Enables or disables the backtrack mechanism of the link crossing reduction phase.
  • isFromFork(): Returns true if the fork shape is enabled for links that start at the same source point.
  • setFromFork(boolean): Sets whether a fork shape is create for links that start at the same source point.
  • isLinkCrossingFineTuningEnabled(): Returns true if the link crossing fine tuning phase is enabled.
  • setLinkCrossingFineTuningEnabled(boolean): Enables or disables the link crossing fine tuning phase.
  • isLinkStraighteningEnabled(): Returns true if the link straightening phase is enabled.
  • setLinkStraighteningEnabled(boolean): Enables or disables the link straightening phase.
  • isMedianCrossingValueEnabled(): Returns true if the median crossing value is used during crossing reduction.
  • setMedianCrossingValueEnabled(boolean): Sets whether the median crossing value is used during crossing reduction.
  • isNeighborLinksAligned(): Returns true if links between neighbored nodes of the same level are aligned so that they are parallel.
  • setNeighborLinksAligned(boolean): Sets whether links between neighbored nodes of the same level are aligned so that they are strictly horizontal or vertical.
  • isToFork(): Returns true if the fork shape is enabled for links that end at the same target point.
  • setToFork(boolean): Sets whether a fork shape is create for links that end at the same target point.
• New fields:
  • FIXED_IN_X_MODE: Fixed movement mode for the x direction.
  • FIXED_IN_Y_MODE: Fixed movement mode for the y direction.
  • FIXED_MODE: Fixed movement mode.
  • FREE_MODE: Free movement mode.
  • MIXED_MODE: Mixed movement mode.

ilog.views.graphlayout.hierarchical.IlvNodeGroup

• New constructors:
  • IlvNodeGroup(): Creates a new IlvNodeGroup.

ilog.views.graphlayout.labellayout.IlvDefaultLabelingModel

• Overview of new features:
  • If the default labeling model is used, you no longer need to call cleanLabel and cleanObstacle whenever a label or obstacle is removed while a layout is attached. This class notifies the attached layouts, which perform the cleanup automatically.
• Incompatibilities:
  • The class no longer implements the ManagerContentChangedListener interface. Therefore, the method contentsChanged has been removed.
  • It is not anymore recommended to override isLabel or isObstacle. If necessary, please override isDefaultLabelClass isDefaultObstacleClass instead.
  • The full layer notification is now enabled by default.
• New methods:
  • createLabelingModel(Object): Creates a new IlvDefaultLabelingModel for a subgraph.
  • getLayersCount(): Returns the number of manager layers to be taken into account during the label layout.
  • isDefaultLabelClass(Object): Returns true if the class of the object is the default labeling class.
  • isDefaultObstacleClass(Object): Returns true if the class of the object is the default obstacle class.
  • isLayerAdded(IlvManagerLayer): Returns true if the manager layer is one of the layers to be taken into account during the layout.
• Modified methods:
  • isFullLayerNotification(): The method is now final.
• Removed methods:
  • contentsChanged: The class no longer implements the ManagerContentsChangedListener interface.

ilog.views.graphlayout.labellayout.IlvLabelingModel

• New methods:
  • createLabelingModel(Object): Creates a new labeling model for a subgraph.
  • fireLabelingModelEvent(Object, int, boolean): Notifies the labeling-model-event listeners that labels or obstacles have been added or removed, or that their geometry has changed (labels or obstacles were moved or resized).

ilog.views.graphlayout.labellayout.LabelingModelEvent

• Overview of new features:
  • Improved, finer-grain model event mechanism. Now takes into account distinct cases such as label or obstacle addition, removal or resizing.
• New fields:
  • LABEL_ADDED: The bit mask of the type of the event when a label has been added.
  • LABEL_GEOMETRY_CHANGED: The bit mask of the type of the event when a label has been moved or resized.
  • LABEL_REMOVED: The bit mask of the type of the event when a label has been removed.
  • OBSTACLE_ADDED: The bit mask of the type of the event when an obstacle has been added.
  • OBSTACLE_GEOMETRY_CHANGED: The bit mask of the type of the event when an obstacle has been moved or resized.
  • OBSTACLE_REMOVED: The bit mask of the type of the event when an obstacle has been removed.

ilog.views.graphlayout.labellayout.annealing.IlvAnnealingLabelLayout

• Overview of new features:
  • The layout automatically detects situations where the layout quality cannot improve anymore. Hence, the layout runs faster in these situations.
  • Obstacle offsets can now be specified per label/obstacle pair via the obstacle interface.
  • Labels can be set to fixed via the label movement policy.
• New methods:
  • getAutoLayoutHandler(): Returns the autolayout handler.
  • setAutoLayoutHandler(IlvAutoLayoutHandler): Sets the autolayout handler.
  • getLabelMovementPolicy(): Returns the label movement policy used during layout.
  • setLabelMovementPolicy(IlvLabelMovementPolicy): Allows you to install a label movement policy, that is, an object that allows or prohibits that a label is moved by the layout algorithm.
  • getMinImprovementPercentageToContinue(): Returns the minimal required percentage the layout needs to improve over a couple of rounds before the layout algorithm stops.
  • setMinImprovementPercentageToContinue(float): Sets the minimal required percentage the layout needs to improve over a couple of rounds before the layout algorithm stops.
  • getNumberIterationsForMinImprovement(): Returns the number of iterations performed to reach the minimal required percentage of layout quality improvment.
  • setNumberIterationsForMinImprovement(int): Sets the number of iterations performed to reach the minimal required percentage of layout quality improvment specified by setMinImprovementPercentageToContinue.
  • getObstacleOffsetInterface(): Returns the obstacle offset interface used during layout.
  • setObstacleOffsetInterface(IlvObstacleOffsetInterface): Allows you to install an obstacle offset interface, that is, an object that allows to select specific mimimal offsets between certain label/obstacle pairs.

ilog.views.graphlayout.labellayout.annealing.IlvAnnealingPointLabelDescriptor

• Overview of new features:
  • Improved customization with many new parameters.
• New constructors:
  • IlvAnnealingPointLabelDescriptor(): Creates a new empty instance of a point label descriptor.
• New methods:
  • setHalfHeight(float): Sets the half height of the path around the reference point.
  • setHalfWidth(float): Sets the half width of the path around the reference point.
  • setMaxDistFromPath(float): Sets the maximal distance from the location on the path.
  • setPreferredDirection(int): Sets the preferred direction where the label is placed relative to the reference point or related obstacle.
  • setPreferredDistFromPath(float): Sets the preferred distance from the location on the path.
  • setReferencePoint(IlvPoint): Sets the reference point of the label.
  • setRelatedObstacle(Object): Sets the obstacle that is related to the label.
  • setShape(int): Sets the shape of the allowed area around the reference point or related obstacle.

• Modified methods:
  • getReferencePoint: It returns now a copy of the reference point.
  • The following methods are now final:
    • getRelatedObstacle
    • getReferencePoint
    • getHalfWidth
    • getHalfHeight
    • getPreferredDistFromPath
    • getPreferredDirection

ilog.views.graphlayout.labellayout.annealing.IlvAnnealingPolylineLabelDescriptor

• Overview of new features:
  • The "preferred percentage from start" can now be specified to indicate the preferred position of the label relative to the polyline length. This allows more control than the anchor. The anchor specifications are internally translated into preferred percentages.
• New constructors:
  • IlvAnnealingPolylineLabelDescriptor(): Creates a new empty instance of a polyline label descriptor.
  • IlvAnnealingPolylineLabelDescriptor(Object, Object, IlvPoint[], float, float, float, float, float, float, int, int, int, float, float, float, float): Creates a new instance of a polyline label descriptor.
• New methods:
  • getPreferredPercentageFromStart(): Returns the percentage relative to the length of the polyline that defines the preferred position for the label.
  • setPreferredPercentageFromStart(float): Sets the percentage relative to the length of the polyline that defines the preferred position for the label.
  • setAllowedSide(int): Sets the allowed side where the label is placed.
  • setAnchor(int): Sets the anchor of the label.
  • setBottomOverlap(float): Sets the amount the label can overlap the related obstacle or reference polyline at the bottom side of the label.
  • setLeftOverlap(float): Sets the amount the label can overlap the related obstacle or reference polyline at the left side of the label.
  • setLineWidth(float): Sets the line width of the polyline given by the reference points.
  • setMaxDistFromPath(float): Sets the maximal distance from the location on the path.
  • setMaxPercentageFromStart(float): Sets the percentage relative to the length of the polyline that defines the end point of the area of the polyline that should be used for the label.
  • setMinPercentageFromStart(float): Sets the percentage relative to the length of the polyline that defines the start point of the area of the polyline that should be used for the label.
  • setPreferredDistFromPath(float): Sets the preferred distance from the location on the path.
  • setPreferredSide(int): Sets the preferred side where the label is placed.
  • setReferencePoints(IlvPoint[]): Sets the reference points that define the polyline where the label must be placed.
  • setRelatedObstacle(Object): Sets the obstacle that is related to the label.
  • setRelatedObstacleSource(Object): Sets the source node if the related obstacle is a link.
  • setRelatedObstacleTarget(Object): Sets the target node if the related obstacle is a link.
  • setRightOverlap(float): Sets the amount the label can overlap the related obstacle or reference polyline at the right side of the label.
  • setSideAssociation(int): Returns the side association of the label.
  • setTopOverlap(float): Sets the amount the label can overlap the related obstacle or reference polyline at the top side of the label.

• Modified methods:
  • getReferencePoints: It returns now a copy of the reference points.
  • The following methods are now final:
    • getRelatedObstacle
    • getRelatedObstacleSource
    • getRelatedObstacleTarget
    • getReferencePoints
    • getLineWidth
    • getAnchor
    • getMinPercentageFromStart
    • getMaxPercentageFromStart
    • getTopOverlap
    • getBottomOverlap
    • getLeftOverlap
    • getRightOverlap
    • getPreferredSide
    • getAllowedSide
    • getSideAssociation
    • getPreferredDistFromPath
    • getMaxDistFromPath

ilog.views.graphlayout.link.IlvLinkLayout

• Overview of new features:
  • Connection point modes: the connection points of links can be declared free (the old behavior) or fixed. If the connection points are fixed, the layout algorithm does not move the connection points. The connection points of links connected to IlvGrapherPin objects handled by an IlvPinLinkConnector are considered as fixed and, hence, are not moved. This makes it much easier to specify fixed connection points using grapher pins.
• New methods:
  • getDestinationPointMode(Object): Returns the destination point mode of an individual link.
  • setDestinationPointMode(Object, int): Sets the mode for the connection point on an individual link on the destination node.
  • getGlobalDestinationPointMode(): Returns the global mode for the connection points of the links on the destination nodes.
  • setGlobalDestinationPointMode(int): Sets the global mode for the connection point of the links on the destination nodes.
  • getGlobalOriginPointMode(): Returns the global mode for the connection points of the links on the origin nodes.
  • setGlobalOriginPointMode(int): Sets the global mode for the connection point of the links on the origin nodes.
  • getOriginPointMode(Object): Returns the origin point mode of an individual link.
  • setOriginPointMode(Object, int): Sets the mode for the connection point on an individual link on the origin node.
• New fields:
  • FIXED_MODE: Fixed connection point mode.
  • FREE_MODE: Free connection point mode.
  • MIXED_MODE: Mixed connection point mode.

ilog.views.graphlayout.link.longlink.IlvLongLinkLayout

• Overview of new features:
  • Connection point modes: the connection points of links can be declared free (the old behavior) or fixed. If the connection points are fixed, the layout algorithm does not move the connection points. The connection points of links connected to IlvGrapherPin objects handled by an IlvPinLinkConnector are considered as fixed and, hence, are not moved. This makes it much easier to specify fixed connection points using grapher pins.
• New methods:
  • getDestinationPointMode(Object): Returns the destination point mode of an individual link.
  • setDestinationPointMode(Object, int): Sets the mode for the connection point on an individual link on the destination node.
  • getGlobalDestinationPointMode(): Returns the global mode for the connection points of the links on the destination nodes.
  • setGlobalDestinationPointMode(int): Sets the global mode for the connection point of the links on the destination nodes.
  • getGlobalOriginPointMode(): Returns the global mode for the connection points of the links on the origin nodes.
  • setGlobalOriginPointMode(int): Sets the global mode for the connection point of the links on the origin nodes.
  • getOriginPointMode(Object): Returns the origin point mode of an individual link.
  • setOriginPointMode(Object, int): Sets the mode for the connection point on an individual link on the origin node.
• New fields:
  • FIXED_MODE: Fixed connection point mode.
  • FREE_MODE: Free connection point mode.
  • MIXED_MODE: Mixed connection point mode.

ilog.views.graphlayout.link.shortlink.IlvShortLinkLayout

• Overview of new features:
  • Connection point modes: the connection points of links can be declared free (the old behavior) or fixed. If the connection points are fixed, the layout algorithm does not move the connection points. The connection points of links connected to IlvGrapherPin objects handled by an IlvPinLinkConnector are considered as fixed and, hence, are not moved. This makes it much easier to specify fixed connection points using grapher pins.
  • Customization using a Node Side Filter is now always strictly respected, for any combination of allowed sides, while previously it was considered as a preference. If necessary, the algorithm now creates orthogonal links with up to four bends, instead of three previously.
  • Improved quality of the incremental mode: links whose origin or destination node has been moved or resized are now automatically detected, such that new optimal shapes can be computed for them freely instead of preserving the current shape. This improves the quality of the layout.
  • Improved support of "thick" links: the width of the links is now also taken into consideration during the detection of link to node crossings. This improves the quality of the layout when thick links are used.
  • Improved support of "fixed" links: the algorithm now not only tries to avoid crossings between fixed and nonfixed links, but also avoids overlaps of the connection points of nonfixed links with the connection points of "fixed" links.
  • Improved support of self-links: the distribution of self-links to the four sides of nodes is now more uniform (no longer always on the same side). Two-bend self-links can now be bundled together like any other link.
• New methods:
  • getDestinationPointMode(Object): Returns the destination point mode of an individual link.
  • setDestinationPointMode(Object, int): Sets the mode for the connection point on an individual link on the destination node.
  • getGlobalDestinationPointMode(): Returns the global mode for the connection points of the links on the destination nodes.
  • setGlobalDestinationPointMode(int): Sets the global mode for the connection point of the links on the destination nodes.
  • getGlobalOriginPointMode(): Returns the global mode for the connection points of the links on the origin nodes.
  • setGlobalOriginPointMode(int): Sets the global mode for the connection point of the links on the origin nodes.
  • getOriginPointMode(Object): Returns the origin point mode of an individual link.
  • setOriginPointMode(Object, int): Sets the mode for the connection point on an individual link on the origin node.
• Modified methods:
  • getBypassDistance(): The default value returned by the method is now a negative value. If the bypass distance is strictly negative, the value of the minFinalSegmentLength parameter (see getMinFinalSegmentLength()) is used as the bypass distance. This allows the automatic adjustment of the bypass distance according to the current value of the minFinalSegmentLength parameter. This behavior is suitable in most cases. However, you can specify a non-negative value in order to override the default behavior.
• New fields:
  • FIXED_MODE: Fixed connection point mode.
  • FREE_MODE: Free connection point mode.
  • MIXED_MODE: Mixed connection point mode.

ilog.views.graphlayout.multiple.IlvMultipleLayout

• New methods:
  • isFirstGraphLayoutActive(): Returns whether the first graph layout is active.
  • setFirstGraphLayoutActive(boolean): Sets whether the first graph layout is active.
  • isLabelLayoutActive(): Returns whether the label layout is active.
  • setLabelLayoutActive(boolean): Sets whether the label layout is active.
  • isSecondGraphLayoutActive(): Returns whether the second graph layout is active.
  • setSecondGraphLayoutActive(boolean): Sets whether the second graph layout is active.

Changes in Composer

• Composer, the JViews Editor, has been rewritten on top of Application Framework, providing to Composer users a very flexible way to customize it using the Application Framework settings API.
• Improved ergonomy and layout customization for recursive layouts of nested graphs. There are now two modes: same layout style in the entire nesting, and individual layout styles per nested graph. In individual layout style mode, you can select which subgraph is currently inspected by double-clicking on the subgraph.
• Saving layout parameters has more options. Besides saving parameters of current layouts, it is now possible to save all parameters of all layouts.
• An experimental "sloppy" autolayout mechanism has been added.

New Examples

• This example is located in directory <installdir>/demos/layoutSamples/RecursiveLayout. It demonstrates the usage of the new class IlvRecursiveLayout that simplifies the recursive layout of nested graphers.

Link Bundle Applet

• This example is located in directory <installdir>/demos/layoutSamples/LinkBundle. It demonstrates how to organize and automatically update straight multiple links in bundles without overlaps.

Link Crossing Applet

• This example is located in directory <installdir>/demos/layoutSamples/LinkCrossing. It demonstrates how to display nice link crossings with tunnel or bridge shapes at the crossings.