JViews Graph Layout Module 6.0 Release Notes

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

Incompatibilities
General Changes
Library Changes
New Packages

• ilog.views.animation

New Interfaces and Classes in Existing Packages

• ilog.views.graphlayout.IlvGraphLayoutUtil.FreeLinkConnectorFactory
• ilog.views.graphlayout.link.shortlink.IlvShortLinkLayoutNodeProperty

Modified Classes

• ilog.views.graphlayout.IlvGraphLayout
• ilog.views.graphlayout.IlvGraphLayoutUtil
• ilog.views.graphlayout.IlvInappropriateLinkException
• ilog.views.graphlayout.circular.IlvCircularLayout
• ilog.views.graphlayout.labellayout.annealing.IlvAnnealingLabelDescriptor
• ilog.views.graphlayout.link.shortlink.IlvShortLinkLayout
• ilog.views.graphlayout.recursive.IlvRecursiveLayout
• ilog.views.graphlayout.tree.IlvTreeLayout
• ilog.views.graphlayout.uniformlengthedges.IlvUniformLengthEdgesLayout

Incompatibilities

• The return type of the method IlvCircularLayout.getRootClusterIds() has changed from java.lang.Enumeration to IlvClusterId[].

General Changes

• The Graph Layout module is now contained in the Diagrammer product.
• A new License Manager called Java License Manager 2.0 (JLM) has been introduced. For more information about JLM, see Using License Keys.
• Tree layout: improved customization of the alternatig radial mode.
• Uniform Length Edges layout: improved stability of the positions for repeated layouts.
• Short Link layout: improved customization of the connection points of the links, new finer-grain options for the incremental layout, new mode avoiding strictly the overlap of links with nodes.
• Recursive layout: it is now easier possible to propagate layout parameters to sublayouts.
• The animation package that was previously only part of a graph layout demo has been consolidated into the new package ilog.views.animation.
• All link connectors previously located in the package ilog.views.graphlayout have been moved to the package ilog.views.linkconnector. Some of the link connectors have been replaced by new versions:
  • IlvRelativeLinkConnector has been replaced by IlvFreeLinkConnector
  • IlvClipLinkConnector has been replaced by IlvClippingLinkConnector
  The old versions still exist as deprecated classes.

Library Changes

New Packages

ilog.views.animation

This package contains utilities to show animated transitions between two states of a JViews manager.

New Interfaces and Classes

ilog.views.graphlayout.IlvGraphLayoutUtil.FreeLinkConnectorFactory

A factory to create a link connector of class IlvFreeLinkConnector for a node. This is used by SDM.

ilog.views.graphlayout.link.shortlink.IlvShortLinkLayoutNodeProperty

The class IlvShortLinkLayoutNodeProperty allows you to store the settings of an instance of IlvShortLinkLayout for an individual node as a named property in the node.

Modified Classes

ilog.views.graphlayout.IlvGraphLayout

• Modified behavior:
  • getLayoutRegion(): The method now returns null when no layout region has been specified.

ilog.views.graphlayout.IlvGraphLayoutUtil

• New methods:
  • EnsureAppropriateLinkConnectors(IlvGrapherAdapter, IlvGraphLayout, boolean, boolean, boolean): Ensures that all the link connectors attached to the nodes of an IlvGrapher are appropriate for a particular layout algorithm. A method with the same name existed previously. This new method allows to control the redraw by an additional parameter.
  • EnsureAppropriateLinkTypes(IlvGrapherAdapter, IlvGraphLayout, boolean, boolean, boolean, boolean): Ensures that all the links of the specified IlvGrapherAdapter are appropriate for a particular layout algorithm. A method with the same name existed previously. This new method allows to control the redraw by an additional parameter.
  • EnsureAppropriateLinks(IlvGraphModel, IlvLayoutProvider, boolean): Ensures that the link and link connector classes used in a nested IlvGrapher hierarchy are appropriate for the layout algorithms that are delivered by the input provider. A method with the same name existed previously. This new method allows to control the redraw by an additional parameter.
  • EnsureAppropriateLinks(IlvGraphLayout, boolean): Ensures that the link and link connector classes used in the graph attached to the input layout are appropriate for the input layout algorithm.
  • EnsureAppropriateLinks(IlvInappropriateLinkException, boolean): Ensures that the link and link connector classes used in an IlvGrapher are appropriate for a particular layout algorithm that has raised an IlvInappropriateLinkException. A method with the same name existed previously. This new method allows to control the redraw by an additional parameter.
  • GetFreeLinkConnectorFactory(): Returns the factory that is used to create link connectors of class IlvFreeLinkConnector during runs of any EnsureAppropriate methods. Used by SDM.
  • SetFreeLinkConnectorFactory(IlvGraphLayoutUtil.FreeLinkConnectorFactory): Allows to specify a factory to create link connectors of class IlvFreeLinkConnector. Used by SDM.

ilog.views.graphlayout.IlvInappropriateLinkException

• New field:
  • CANNOT_MOVE_PINNED_CONNECTION_POINT: The type of the exception when the connection point of a link cannot be moved because it is a pinned connection point.

ilog.views.graphlayout.circular.IlvCircularLayout

• New methods:
  • setRootClusterIds(IlvClusterId[]): Allows you to specify the root cluster for each connected component of the graph of clusters.

ilog.views.graphlayout.labellayout.annealing.IlvAnnealingLabelDescriptor

• New methods:
  • getTreatAs(): Returns how the label should be treated by the IlvLabelLayoutRenderer of the IlvSDMEngine.
  • setTreatAs(int): Sets how the label should be treated by the IlvLabelLayoutRenderer of the IlvSDMEngine.

ilog.views.graphlayout.link.shortlink.IlvShortLinkLayout

• Overview of new features:
  • It is now possible to ask the layout to strictly avoid that links overlap nodes. See setLinkOverlapNodesForbidden(boolean) and the other related methods.
  • It is now possible to customize the way the connection points of links are distributed along the node side, either globally for the entire graph, or for individual nodes. See setGlobalConnectorStyle(int) and the other related methods.
  • New finer-grain options for the incremental layout. See setIncrementalModifiedLinkReshapeMode(Object, int) and the other related methods.
• New methods:
  • createLayoutNodeProperty(String, IlvGraphic, boolean): Returns a new instance of IlvShortLinkLayoutNodeProperty that stores the parameter settings of this layout class for nodes.
  • getAuxiliaryLongLinkLayout(): Returns the instance of IlvLongLinkLayout that is used for avoiding overlaps between links and nodes when isLinkOverlapNodesForbidden returns true.
  • getConnectorStyle(Object): Returns the connector style of an individual node.
  • setConnectorStyle(Object, int): Sets the connector style of an individual node.
  • getEvenlySpacedPinsMarginRatio(): Returns the margin ratio for the evenly spaced pins connector style.
  • setEvenlySpacedPinsMarginRatio(float): Sets the margin ratio for the evenly spaced pins connector style.
  • getGlobalConnectorStyle(): Returns the global style of the connectors.
  • setGlobalConnectorStyle(int): Sets the global style of connectors.
  • getGlobalIncrementalModifiedLinkReshapeMode(): Returns the link reshape mode used during incremental layout for modified links.
  • setGlobalIncrementalModifiedLinkReshapeMode(int): Sets the link reshape mode used during incremental layout for modified links.
  • getGlobalIncrementalUnmodifiedLinkReshapeMode(): Returns the link reshape mode used during incremental layout for unmodified links.
  • setGlobalIncrementalUnmodifiedLinkReshapeMode(int): Sets the link reshape mode used during incremental layout for unmodified links.
  • getIncrementalModifiedLinkReshapeMode(Object): Returns the link reshape mode of an individual link used during incremental layout for modified links.
  • setIncrementalModifiedLinkReshapeMode(Object, int): Sets the link reshape mode of an individual link used during incremental layout for modified links.
  • getIncrementalUnmodifiedLinkReshapeMode(Object): Returns the link reshape mode of an individual link used during incremental layout for unmodified links.
  • setIncrementalUnmodifiedLinkReshapeMode(Object, int): Sets the link reshape mode of an individual link used during incremental layout for unmodified links.
  • isLinkOverlapNodesForbidden(): Returns true if the overlap of links with nodes is forbidden, and returns false otherwise.
  • setLinkOverlapNodesForbidden(boolean): Allows to ask the layout algorithm to avoid strictly to reshape links such that they overlap some nodes.


• New fields:
  • AUTOMATIC_PINS: Automatic connector pin option.
  • EVENLY_SPACED_PINS: Evenly spaced connector pin option.
  • FIXED_CONNECTION_POINTS_MODE: Fixed connection points mode.
  • FIXED_NODE_SIDES_MODE: Fixed node side mode.
  • FIXED_OFFSET_PINS: Fixed offset pin option.
  • FIXED_SHAPE_TYPE_MODE: Fixed shape type mode.

ilog.views.graphlayout.recursive.IlvRecursiveLayout

• Overview of new features:
  • It is now easier possible to propagate layout parameters to sublayouts. See the new methods.
• New methods:
  • propagateAndApply(String, Class, Object, Object[]): Propagates the application of a method (specified by the method name and the arguments) to all layouts of subgraphs in the attached nested graph.
  • propagateLayoutParameter(String, Class, int): Propagates a layout parameter to all layouts of subgraphs that support the parameter.
  • propagateLayoutParameter(String, Class, float): Propagates a layout parameter to all layouts of subgraphs that support the parameter.
  • propagateLayoutParameter(String, Class, boolean): Propagates a layout parameter to all layouts of subgraphs that support the parameter.
  • propagateLayoutParameter(String, Class, Object): Propagates a layout parameter to all layouts of subgraphs that support the parameter.
  • propagateLayoutParameter(String, Class, Object, int): Propagates a node or link layout parameter to all layouts of subgraphs that support the parameter and contain the node or link.
  • propagateLayoutParameter(String, Class, Object, boolean): Propagates a node or link layout parameter to all layouts of subgraphs that support the parameter and contain the node or link.
  • propagateLayoutParameter(String, Class, Object, Object): Propagates a node or link layout parameter to all layouts of subgraphs that support the parameter and contain the node or link.


• New fields:
  • PROPAGATE_CLASS_MISMATCH: Bitmask for the return code of the parameter propagation methods.
  • PROPAGATE_EXCEPTION: Bitmask for the return code of the parameter propagation methods.
  • PROPAGATE_PARAMETER_AMBIGUOUS: Bitmask for the return code of the parameter propagation methods.
  • PROPAGATE_PARAMETER_MISMATCH: Bitmask for the return code of the parameter propagation methods.
  • PROPAGATE_PARAMETER_SET: Bitmask for the return code of the parameter propagation methods.

ilog.views.graphlayout.tree.IlvTreeLayout

• Overview of new features:
  • In alternating radial mode, it is now possible to force all circular layers of nodes to the alternating arrangement, even if this does not improve the space usage.
• New methods:
  • isAllLevelsAlternating(): Returns true if at all levels, nodes are forced into alternating circular layers.
  • setAllLevelsAlternating(boolean): Enables whether at all levels, nodes are forced into alternating circular layers.
  • isCalcRoot(Object): Returns true if the input node was used as root during layout.
  • isSpecRoot(Object): Returns true if the input node was specified as root.

ilog.views.graphlayout.uniformlengthedges.IlvUniformLengthEdgesLayout

• Overview of new features:
  • This layout algorithm has been improved to avoid that the graph gets translated when applying the layout repeatedly.

Sample Changes

• The new Graph Layout Gallery shows all layout algorithms and many features. The sample can be found here.
• The new Link Bundle demo shows an experimental link bundling feature. The sample can be found here.