yFiles for JavaFX Release Notes

yFiles for JavaFX version 3.0 is the newest major release available. (See also the entire yFiles for JavaFX change log.)

Technical Requirements

  • Oracle JDK 1.8 (8u40) or higher is needed for software development with yFiles for JavaFX.
  • Oracle JRE 1.8 (8u40) or higher is needed to execute programs using yFiles for JavaFX.
  • A browser to view the HTML documentation.

yFiles for JavaFX 3.0 - Changes Since 2.0.0.1

Hide Description
Open in yEd LiveDownload
yFiles for JavaFX 3.0 Release Notes
New support for Sankey diagrams with thick edges
yFiles for JavaFX 3.0 Release Notes
New edge bundling support
yFiles for JavaFX 3.0 Release Notes
New support for port grouping

General

Package structure

All classes have been reorganized into a new package hierarchy.

  • Generally all classes that relate to the graph structure can be found in com.yworks.yfiles.graph now, styles, including the void styles, are in com.yworks.yfiles.graph.styles, label layout models are in com.yworks.yfiles.graph.labelmodels, port location models are in com.yworks.yfiles.graph.portlocationmodels.

  • All classes related to GraphControl can now be found in com.yworks.yfiles.view. The animation and export related classes have been moved to this package as well. Input-related classes (e.g. input modes and supporting types) can be found in com.yworks.yfiles.view.input.

  • Layout classes can be found in com.yworks.yfiles.layout and its respective sub-packages.

Functionality moved to interfaces or base classes

  • ICanvasContext: factory methods replace the removed class CanvasContext.

  • IInputModeContext: factory methods replace the removed class SimpleInputModeContext.

  • ILookup, IContextLookup and IContextLookupChainLink: factory methods were moved from the removed class Lookups.

  • IContextLookupChainLink: factory methods replace the removed properties HidingLookupChainLink, FactoryLookupChainLink and AddingLookupChainLink.

  • IEnumerable (previously Enumerable): factory methods replace the removed classes EmptyEnumerable, CompositeEnumerable and CompositeEnumerator.

  • IListEnumerable: factory methods replace the removed classes EmptyListEnumerable, ListEnumerable and ListEnumerableExtensions.

  • IEventRecognizer: factory methods replace the removed classes EventRecognizers, EventRecognizerExtensions, EventRecognizerCallback, Mouse2DEvents, Touch2DEvents and KeyEvents.

  • IArrow: contains static members of the class Arrow.

  • IAnimation: factory methods replace the removed classes EasedAnimation and ParallelAnimation.

    • Animations: factory methods replace the removed classes GeneralPathAnimation.

    • GraphAnimations: factory methods replace the removed classes LayoutMorpher, LayoutMorpherWrapper, EdgeAnimation, LabelAnimation, NodeAnimation and PortAnimation.

  • ICommand: contains members of the removed classes GraphCommands, ApplicationCommands, ComponentCommands and NavigationCommands.

  • IPortCandidateProvider: factory methods replace all existing implementations except AbstractPortCandidateProvider.

  • IEdgeReconnectionPortCandidateProvider: factory methods replace all implementations.

  • IHitTestable: contain members of removed class HitTestable.

  • IMarqueeTestable: contain members of removed class MarqueeTestable.

  • IVisibilityTest: contain members of removed class VisibilityTest.

  • ICanvasObjectDescriptor: contains members of the removed class CanvasObjectDescriptor.

  • IMapper: contains members of removed class Mappers.

  • IBoundsProvider: contains members of removed class BoundsProvider.

  • The following classes have been removed: OrientedRectangleExtensions, PointExtensions, RectangleExtensions, SizeExtensions, FoldingViewExtensions, GeomExtensions, GraphDecoratorExtensions, GraphExtensions, GroupedGraphExtensions, MapperRegistryExtensions, StripeExtensions, LookupExtensions, TableExtensions, ParseContextExtensions, WriteContextExtensions, RenderContextExtensions, RenderContextExtensions and XmlWriterExtensions. All methods of these classes are available on related interfaces as default methods.

  • GraphItemTypes: contains members of removed class GraphItemType.

  • Pen: contains members of removed class Pens.

  • DashStyle: contains members of removed class DashStyles.

Further general improvements

  • The naming of classes, members and parameters has been reviewed and now uses more consistent and intuitive names.

  • All methods that take a context parameter of type ICanvasContext, IRenderContext, IInputModeContext, IParseContext, IWriteContext, SnapContext, GraphSnapContext, or LabelSnapContext now have that parameter as their first parameter.

  • Some classes are now usable in try-with-resources statements since IDisposable now extends the AutoClosable interface.

  • Replaced many reference parameters with actual return values. Methods that returned a boolean value to indicate the validity of the reference parameter now return either a proper value or null if they could not provide one. Most prominent example of this change are the various #getTangent methods in IPathGeometry and GeneralPath that now return a Tangent object.

  • The return type of several methods has been changed from IEnumerator<T> to IEnumerable<T>, which has the benefit that those can now be consumed as streams.

Documentation

  • The Developer’s Guide has been completely revised. Now it consists of two parts: The first part covers the basics of yFiles for JavaFX, while the second part describes in detail how the behavior of the library can be adapted to the customer’s requirements.

Model

IGraph

  • Support for grouped graphs has been simplified to a large extent:

    • IGraph now supports grouping by default. The #GroupingSupported property has been removed from DefaultGraph. Grouping is now always enabled for graphs.

    • The new property #GroupingOperationsAllowed on GraphEditorInputMode allows for switching interactive grouping operations on or off. Grouping operations are disabled by default and have to be enabled explicitly if the input mode should support them.

    • The grouping support interfaces IGroupedGraph and IHierarchy<T> have been removed and folded with IGraph.

    • The property IHierarchy<T>#Root is no longer available. The root of a grouping hierarchy is now represented by null.

  • #createNode, #createEdge, #addLabel, #addPort: Ambiguous overloads were removed, missing overloads were added and parameters were ordered to be consistent throughout all overloads.

  • #Nodes, #Edges, #Labels and #Ports: The type of these properties has been changed from ICollectionModel to IListEnumerable. To be notified of created or removed items, the corresponding IGraph events should be used instead.

  • #NodeLabels and #EdgeLabels: These properties have been replaced by default methods that delegate to the merged #Labels property.

  • #CollectionModel and #Bends have been removed together with the classes BendList and ListLabelCollection. Use ListEnumerable<IBend> and ListEnumerable<ILabel> instead.

  • IGraph now provides events for property changes on model items, e.g. #NodeStyleChanged and #NodeLayoutChanged. Those events replace the dedicated change reporters available previously (e.g. INodeBoundsChangeReporter, ILabelTextChangeReporter) which have been removed.

  • The signatures of event handlers throughout the IGraph API have been unified by using EventHander with appropriate EventArgs. Exceptions are a few events that are raised very often which retain an argument list.

  • #isLeaf, #setLeaf and related properties and events have been replaced by #isGroupNode and #setIsGroupNode which have the exact opposite meaning from the old ones.

  • #addBend: The signature has changed. The index parameter has been moved to the end.

  • IGraphStructure and its implementation have been removed, as well as the constructor of DefaultGraph that accepted an IGraphStructure.

  • IGraph now extends the ITagOwner interface. Thus graphs now have a #Tag property.

  • DefaultGraph now raises removal events for labels, ports and bends which are implicitly removed when their owner is removed.

  • Various protected factory methods of DefaultGraph have been removed: #createNodeDefaults, #createEdgeDefaults and #createMapperRegistry, amongst others.

  • DefaultGraph#getBounds has been removed.

  • #UsingPortCandidateProvidersEnabled has been removed from both DefaultGraph and GraphSettings. Creating an edge using port candidate providers has to be done by manually querying the provider and calling #createEdge(IPort, IPort).

  • Added convenience methods #applyLayout for arranging graph elements.

Folding

  • The #expand, #collapse and #isExpanded methods on IFoldingView (previousely IFoldedGraph) now also work with nodes that belong to the master graph instead of the view graph. Thus the collapsed/expanded state can be set or queried for items that are currently not in the view graph.

  • IFoldingView#isInitiallyExpanded has been removed.

  • FoldingManager: #isInitiallyExpanded, #setInitiallyExpanded and #DefaultExpandedPredicate have been removed.

  • The interfaces IChangeDummyNodeAppearanceCallback, IChangeDummyEdgeAppearanceCallback and IChangeLabeledItemAppearanceCallback as well as FoldingManager#getChangeDummyAppearanceCallback have been removed. The view state properties can now be changed directly on the view state implementations returned by FoldingManager#getFolderNodeState and FoldingManager#getFoldingEdgeState, respectively.

  • Lots of other small changes around folding.

Labels

  • The property ILabel#Layout has been replaced by the new default method #getLayout.

  • The order of the parameters of ILabelModel#getGeometry has been changed to ILabelModel#getGeometry(ILabel, ILabelModelParameter).

  • The factory methods FreeNodeLabelModel#createNodeCenterAnchored and FreeNodeLabelModel#createNodeLayoutAnchored have been removed.

  • FreeNodeLabelModel#createDefaultParameter now uses the label’s center as its anchor point.

  • The new edge label models EdgeSegmentLabelModel and EdgePathLabelModel have been added and replace RotatingEdgeLabelModel, SliderEdgeLabelModel, SideSliderEdgeLabelModel, RotatedSliderEdgeLabelModel and RotatedSideSliderEdgeLabelModel.

    • EdgeSegmentLabelModel allows to create parameters for a segment index and segment ratio.

    • EdgePathLabelModel creates parameters using a ratio of the edge path.

    • The label model parameter of the edge label defaults now uses the EdgeSegmentLabelModel.

Ports

  • The property IPort#Location was removed since it was only a convenience method to access the location from the IPortLocationModelParameter.

    • To retrieve a live view of the location of a port, use the new default method IPort#getDynamicLocation.

    • To retrieve a simple snapshot of the current location instead, use IPort#getLocation.

  • NodeScaledPortLocationModel has been replaced by FreeNodePortLocationModel that allows to specify the port location by a ratio of the node layout’s size and an additional offset.

  • AnchoredPortLocationModel has been removed.

Table

  • ITable:

    • The signature of #createRow and #createColumn has changed. The index parameter has been moved to the end.

    • The events #StripeChanged and #StripeRemoved use StripeEventArgs now.

    • The event #LabelRemoved uses LabelEventArgs now.

    • The default methods: #findColumn, #findRow and #getCellBounds have been added.

  • Table:

    • The table’s lookup decorator can now decorate stripe labels, too.

    • The factory methods for the individual properties of RowDefaults and ColumnsDefaults have been removed.

    • The methods #removeUndoSupport as well as some overloads of #createRow, #createColumn and #addLabel have been removed.

    • The new properties #DefaultStripeLookup, #DefaultColumnLookup and #DefaultRowLookup replace the removed classes with the same same.

  • TableExtensions: method #getElementsToMove has been removed

  • IStripeDefaults: the three argument constructor has been removed.

  • IStripeSelection#SelectedStripes has been removed. Use the individual properties for #SelectedRows and #SelectedColumns instead.

  • StripeSelection: the surplus overloads of #isSelected and #setSelected taking an IRow or IColumn have been removed.

  • The default method #placeNodeInCell has been added to IGraph to easily move a node into a specific table cell.

Undo support

  • IGraph: default methods to enable or disable Undo support have been added.

  • Setting the #Tag property on model items and the graph now works with Undo.

  • Undo operations for the removal of graph elements now keep the proper item order. This improves the consistency especially for layouts between undo operations.

  • IGraph#beginEdit:

    • Overloads that work with IMementoSupport (either via ILookup or an IMementoSupportProvider) have been added.

    • The overload that accepted an IEnumerable of IModelItems has been removed.

  • IUndoSupport, MementoUndoUnit, MementoUndoableEdit and MementoStateStruct have been removed.

  • IUndoUnit: the methods #canUndo and #canRedo have been removed.

  • AbstractUndoUnit: the methods #undoImpl and #redoImpl have been removed. Implementations should use #undo and #redo from the IUndoUnit interface instead.

  • UndoEndgine: the properties #UndoText and #RedoText have been removed.

  • IGraphUndoUnitSupport has been removed. Its methods #create…​UndoUnit have been moved to DefaultGraph as overridable methods. Developers who have created a custom implementation have to derive from DefaultGraph and override the corresponding method(s).

Geometry

Package com.yworks.yfiles.geometry was purified:

  • The basic geometry types PointD, SizeD, RectD and InsetsD have been made immutable.

  • ImmutablePoint, ImmutableSize, ImmutableRectangle and ImmutableOrientedRectangle have been removed. The immutable types PointD, SizeD and RectD as well as the immutable instance provided by the new static method OrientedRectangle#createImmutable can be used instead.

  • IPointSetter and ISizeSetter have been removed. Instead their prior sub interfaces IMutablePoint and IMutableSize are used.

  • IReshapeable has been removed. The various overloads of the #reshape method have been implemented as default methods on IMutableRectangle instead.

  • IMovable has been removed as well. Instead an IPositionHandler can be used.

  • PointD#fromPoint, SizeD#fromSize and RectD#fromRectangle have been replaced by the default methods IPoint#toPointD, ISize#toSizeD and IRectangle#toRectD.

  • Various other geometry-related classes and interfaces have been removed.

  • IOrientedRectangle: the default method #getTopLeftLocation has been added.

  • The OrientedRectangle.EMPTY constant has been moved to the IOrientedRectangle interface.

  • ImmutableSize: The static fields #UNBOUND, #EMPTY and #ZERO have been added.

  • Most of the static convenience methods in the geometry classes have been removed. Only a few basic methods such as the union operation on RectD and the vector arithmetic on PointD remain.

View

Styles

  • Styles no longer implement IModelItemInstaller which simplifies certain custom style implementations.

  • The style and style renderer hierarchies have been flattened:

    • IModelItemStyle, ITaggedModelItemStyle with subinterfaces as well as all subinterfaces of INodeStyle, IEdgeStyle, ILabelStyle and IPortStyle have been removed.

    • AbstractEdgeStyle, AbstractStyleRenderer, AbstractNodeStyleRenderer, AbstractEdgeStyleRenderer, AbstractLabelStyleRenderer, AbstractShapedNodeStyleRenderer, AbstractShapedLabelStyleRenderer, VoidVisualStyle and VoidStyleRenderer have been removed.

    • Abstract base class AbstractTableNodeStyle and class DynamicTableNodeStyle have been removed and the funtionality has been merged with class TableNodeStyle.

    • ITableProvider as well as its implementations have been removed and method AbstractTableNodeStyle#getTable has been moved to class TableNodeStyleRenderer.

  • UserTagProvider and all implementations have been removed.

  • SimplePortStyle has been removed. You can use NodeStylePortStyleAdapter together with a ShapeNodeStyle instead.

  • Removed superfluous constructors from all style implementations.

  • The generics of the classes AbstractNode/Edge/Port/LabelStyle (former SimpleAbstractNode/Edge/Port/LabelStyle) have been removed. For example the class parameter from the constructor and the generic type parameter TVisual extends IVisual of the classes themselves have been removed. This means that the signature of the method #updateVisual changed as well and overrides of this method have to cast the Node parameter to the concrete type manually.

  • All IStyleRenderer implementations: the public #Style property has been reduced in accessibility to protected.

  • All IStyleRenderer implementations: the public #Item property has been reduced in accessibility to protected and named #Node, #Label, #Edge or #Port depending on the handled model item.

  • ILabelStyleRenderer implementations: the protected field #layout has been removed and the accessibility of the public property #Layout has been reduced to protected.

  • Columns and rows don’t use node styles anylonger but got their own style classes:

    • The new interface IStripeStyle is used for styles visualizing IColumns and IRows.

    • IStripeStyle, IStripeStyleRenderer and the implementors AbstractStripeStyle, NodeStyleStripeStyleAdapter, and AbstractJComponentStripeStyle have been added.

  • The class TextFormat and the corresponding property DefaultLabelStyle#TextFormat have been removed. The properties of Textformat have been added on DefaultLabelStyle instead and the enum TextWrapping has been added.

  • DefaultLabelStyle#Insets has been added that can be used to define a distance between the label border and the label content via insets. Per default the style now uses insets with thickness 2 instead of 0.

  • PathBasedEdgeStyleRenderer: The scope of the factory methods #createRectangleSelfLoop and #createRoundSelfLoop has been reduced from public to protected.

  • CSS support for visualizations of non-graph elements like indicators and decorations has been added. Those elements can be styled by inserting a style sheet into the scene that has definitions for certain style classes that address these decorations. For a detailed description, read the relating chapter in the Developer’s Guide.

  • Customizing the visualization via data templating has been refactored:

    • The new interface IDataTemplate replaced the abstract class DataTemplate and is used to create and update a javafx.scene.Node very similar to the IVisualCreator interface. In contrast to IVisualCreator it takes the data object to visualize as well as its bounds as additional parameter information.

    • The DataTemplate class with its context-free #creatInstance method as well as its subclasses have been removed.

  • GraphModelManager: The protected factory methods that supplied the initial value for the #*Installer properties (#EdgeStyleInstaller, #NodeStyleInstaller, etc.) have been removed.

  • GraphModelManager#invalidate has been removed.

  • Added a mechanism to support disposing and caching the Node which is created by IVisualCreator#createVisual:

    • IRenderContext: #setDisposeCallback, #childVisualRemoved and #registerForChildrenIfNecessary have been added to support the registration of a callback for disposal.

    • Added the interface IDisposeVisualCallback for this purpose.

  • VisualGroup is now managed and autosizes its children. This allows to add arbitrary JavaFX controls without the need to layout them manually.

  • IRenderContext#getCanvas has been pulled up to ICanvasContext and renamed to #getCanvasControl.

  • IInputModeContext now extends ICanvasContext so its #getCanvasControl was removed.

  • IRenderContext#Transform has been removed

  • Class RenderContext was replaced by the factory method ContextConfigurator#createRenderContext.

  • DefaultEdgePathCropper now uses the new method #handleEmptyPath if cropping the edge would result in an empty path. Per default this method only crops at the ports.

  • DefaultEdgeIntersectionCalculator: the callback method #getNodeGeometry has been added.

  • ModelManager#CanvasObjectGroupProviderCallback has been replaced with #getCanvasObjectGroup. ItemModelManager#CanvasObjectGroupProviderCallback has been replaced by #CanvasObjectGroup and the virtual method #getCanvasObjectGroup. The default implementation just defers to the property, just like #getDescriptor.

  • ItemModelManager#invalidate has been removed.

  • IGroupAction as well as ICanvasObjectGroup#getGroupAction have been removed as they had hardly any use.

  • ICanvasGroupProvider and the delegate CanvasObjectGroupProviderCallback have been removed. Accessing the individual canvas object groups can be done via the properties of CanvasControl instead.

  • ICanvasObjectTreeEventSource as well as the corresponding classes CanvasObjectAddEventArgs, CanvasObjectRemoveEventArgs, CanvasObjectMoveEventArgs and CanvasObjectInvalidateEventArgs have been removed.

  • ScrollBarVisibility has been replaced by the JavaFX enum ScrollPane.ScrollBarPolicy.

Input Modes (General)

  • The type hierarchy for input modes has been simplified considerably:

    • All input modes except OverviewInputMode, GraphViewerInputMode and GraphEditorInputMode now directly implement IInputMode without any abstract base classes in between.

    • IConcurrentInputMode has been merged into IInputMode. The property #Enabled has been removed but is still present on all concrete implementations.

    • All abstract input mode base classes except AbstractInputMode have been removed. AbstractConcurrentInputMode has been merged into AbstractInputMode.

    • AbstractInputMode: #requestMouse, #requestTouch, #releaseMouse and #releaseTouch have been combined in #requestPointer and #releasePointer

    • StateMachineInputMode as well as all state machine related classes has been removed. Input modes now no longer have protected methods for state machine transitions but instead those methods are mostly parameterless now.

  • Input mutex handling has been refactored considerably:

    • IInputMode#ConcurrencyController has been removed. Input modes now get a ConcurrencyController as parameter of their #install method.

    • The ConcurrencyController has been refactored and is now only responsible for a single input mode. Its property #Active indicates if it currently has or may request the mutex.

    • InputMutex has been removed.

    • The property PreferredCursor has been moved from IInputMode to ConcurrencyController.

    • The input mutex should be requested and released using the according methods on ConcurrencyController. Most input modes don’t provide the methods #hasMutex, #canRequestMutex, #requestMutex and #releaseMutex anymore.

    • The property IInputMode#Enabled is not set to false anymore if another input mode acquires the mutex. Instead their ConcurrencyController is deactivated. This provides a clear separation between suppressing input modes (while another mode holds the mutex) and explicitly disabling a mode from code (via the #Enabled property).

    • As a consequence most input modes don’t provide the event #EnabledChanged and the protected methods #onEnabled and #onDisabled anymore, but #onConcurrencyControllerActivated and #onConcurrencyControllerDeactivated instead.

  • IInputMode#Priority has been added which defines the installation priority of the input mode. It replaces the corresponding properties on GraphViewerInputMode, GraphEditorInputMode and TableEditorInputMode which previously defined the installation order.

  • All input modes no longer raise #Stopped and #Canceled events. Developers who want to get notified when an input mode gets stopped or canceled have to override the methods #onStopped and #onCanceled. The events #Initializing and #Initialized have been removed as well. Input modes that need to perform one-time initialization on first #install can keep track of that themselves.

  • MultiplexingInputMode:

    • #addConcurrent as well as the overload of #add that takes an additional priority parameter have been removed. There is only the #add method left that takes an input mode as its only parameter.

    • Priority is now determined by the input mode’s #Priority property.

    • Whether an input mode runs exclusive or always active alongside other input modes is determined by the input mode’s ConcurrencyController which has an #Exclusive property controlling that.

    • The mode is now aware of changes to the priority of already installed input modes and will update the installation order accordingly when an input mode’s priority is changed.

  • IInputMode implementations:

    • The setter for properties #Graph and #GraphSelection, if present, and its associated #set* methods have been removed. Both are now always retrieved from the input mode context.

    • The read-only property #InputModeContext has been introduced to expose the IInputModeContext the mode is installed in.

  • The Command mechanism has been refactored:

    • Classes Command, CommandBinding, CommandManager and related as well as the related properties on CanvasControl have been removed from public API. All commands are now handled by interface ICommand and the KeyboardInputMode using the new methods #addCommandBinding, #addKeyBinding and #addRecognizerBinding.

    • KeyboardInputMode has been refactored: interaction with keys recognized by this input mode are now handled by commands solely.

GraphEditorInputMode and GraphViewerInputMode

  • GraphViewerInputMode and GraphEditorInputMode have been made more similar regarding customization in the capabilities they both provide:

    • GraphViewerInputMode now supports the same click and selection behavior as GraphEditorInputMode. This includes detail selection (Shift+Click) and cyclic selection (Alt+Click) as well as finer control over behavior like the property #ClickSelectableItems and the method #shouldClickSelect.

    • The methods #click and #doubleClick now take an IModelItem and ClickEventArgs as arguments and have no return value. Instead of returning a boolean, the property #Handled on the ClickEventArgs should be set.

    • Their #ClickInputMode now delivers both left and right clicks.

    • The default click actions that change the selection and create new nodes are now only triggered on left mouse clicks.

    • The new property #DoubleClickHitTestOrder provides an explicit hit test order for double clicks. By default, this hit test order prefers labels over other graph elements.

    • GraphViewerInputMode now also has the property #AvailableCommands already known from GraphEditorInputMode or NavigationInputMode.

    • Several child input mode priorities in GraphViewerInputMode have been changed and most of them now have the same priorities as in GraphEditorInputMode.

    • The new event #CanvasClicked reports clicks on an empty canvas location.

    • The new property #SelectablePredicate allows finer control over what particular items should be selectable without the need to create a custom subclass.

    • The new method #createSelectionEventArgs creates SelectionEventArgs using the #GraphSelection.

    • The events #MultiSelectionStarted and #MultiSelectionFinished now use SelectionEventArgs<IModelItem>.

    • By default, graph items styled with a void style (VoidNodeStyle, VoidEdgeStyle, VoidLabelStyle and VoidPortStyle) are not selected or focused anymore. The new property #VoidStylesIgnored specifies whether this feature is enabled.

    • GraphViewerInputMode now has improved support for marquee selection. Marquee selection is no longer turned on or off via #MarqueeSelectableItems but instead directly on the MarqueeSelectionInputMode. The recognizer for marquee selection is Shift+Drag and the child input mode priorities have been adjusted accordingly so that marquee selection and viewport movement can co-exist. The sub-input mode still defaults to being disabled, though.

    • GraphViewerInputMode now also has a KeyboardInputMode.

    • GraphViewerInputMode now allows copying items (including the convenience methods) and handles the commands appropriately.

  • Improved functionality of GraphEditorInputMode

    • Changing the property #ShowHandleItems will now immediately update the currently visible handles.

    • The new property #DeletablePredicate allows finer control over what particular items should be deletable without the need to create a custom subclass.

    • The new property #OrthogonalBendRemovalEnabled toggles the new support for deleting bends in a way that an orthogonal edge remains orthogonal after removing the bends.

    • A new default action for duplicating single graph items or whole subgraphs is provided. This also works with incomplete subgraphs, for example in a tree, it is possible to duplicate a subtree and the tree will never be disconnected. In addition, the new command ICommand#DUPLICATE (shortcut: Ctrl-D) and the new method GraphClipboard#duplicate can be used to duplicate selected items without altering the clipboard contents. GraphClipboard#adjustGroupNodeBounds adjusts the bounds of parent nodes of pasted or duplicated nodes.

    • A new default action for reversing edges is provided. To this end, the methods #reverseEdge, #reverseEdges and #reverseSelectedEdges have been added to GraphEditorInputMode and the command #REVERSE_EDGE (shortcut: Ctrl-R) to ICommand.

    • Support for cyclic click selection was added. This helps in conveniently selecting items that are hidden behind other items. By default, this features is bound to the Alt key being pressed. It can be disabled by setting the #CyclicSelectionRecognizer property to IEventRecognizer#NEVER.

    • The property #ReparentToLeavesAllowed was added. When enabled, leaf nodes can be the target of a reparenting gesture in which case they are converted into group nodes.

    • The new protected method #shouldSelect can be overridden to determine whether an item can be selected in general.

    • The new events #LabelAdding and #LabelEditing were added. Those allow fine-grained control over adding or editing labels and tie into the existing functionality provided by IEditLabelHelper.

  • Cleanup of the old GraphEditorInputMode API:

    • The type of the property #OrthogonalBendRemoval has been changed from boolean to OrthogonalEdgeEditingPolicy.

    • The events #DeletingSelection and #DeletedSelection now use SelectionEventArgs<IModelItem>.

    • The constructor that take additional IGraph and IGraphSelection arguments have been removed, as well as the protected methods #setGraph, #setGraphControl, #onGraphChanged and the protected setter for the property #GraphSelection. Instead, the IGraph instance is now always taken from the #InputModeContext and can’t be changed after the mode is installed.

    • The method #createDefaultLabelConfiguration has been removed

    • The method #marqueeSelect<T>(RectD,IEnumerable<T>) has been removed.

    • The property #SelectionModel has been removed. Instead the property #GraphSelection is used.

    • The properties #CollectionModel and #GraphInputModeController have been removed.

    • The method #findItem has been removed. An additional overload of #findItems without the context parameter has been added. To replicate the previous behavior of #findItem, #findItems can be called and the first element taken from the resulting enumeration.

    • The method #shouldBeMovableForMoveInputMode has been removed.

  • Improved GraphViewerInputMode API:

    • Added support for the ICommand#COPY.

    • Added support for multi-selection via Ctrl+Click and marquee selection. The latter is disabled by default.

    • The click hit test order can now be configured by property #ClickHitTestOrder.

    • By default, clipboard commands are now disabled. This can be controlled with the new property #ClipboardOperationsAllowed.

    • The event #ItemSelected has been removed.

CreateEdgeInputMode

  • CreateEdgeInputMode was refactored and streamlined:

    • Orthogonal edge creation will be automatically enabled if orthogonal edge editing is enabled on the containing GraphEditorInputMode.

    • Property #ConnectingToCandidatesOnlyEnabled was removed. Now edge creation always uses port candidates.

    • The creation callbacks #NodeBasedEdgeCreationCallback and #PortBasedEdgeCreationCallback have been replaced by the new #EdgeCreator which is port-based.

    • The methods #getSourcePortOwner, #getTargetPortOwner, #getSourceNode and #getTargetNode have been replaced by #getSource and #getTarget.

    • The properties #SourcePortCandidate and #TargetPortCandidate now have public setter.

    • The methods #determineEdgeStyle, #assignSourcePortPosition, #assignEdgeStyle as well as the property #EdgeStyle have been removed. Instead the new #EdgeDefaults property can be used to customize the new edge.

    • Property #UsingHitNodeTargetCandidatesOnlyEnabled was replaced by the new property #UsingHitItemsCandidatesOnlyEnabled.

    • The type of the property #OrthogonalEdgeCreationEnabled has been changed from boolean to OrthogonalEdgeEditingPolicy.

    • The new property #DummyEdgeGraph is used to create the dummy edge that visualizes the edge during creation.

    • The preview edge which is displayed during edge creation now shows the edge as it will be created, i.e. the preview edge has the same style, port visualization, and labels as the created edge will have.

    • The property #SnapToTargetCandidateOwner has been removed. The preview edge now is always being cropped at the candidate owner’s borders.

    • A new property #CancelGestureOnInvalidTarget has been added that makes it possible to cancel the gesture immediately if ended on an invalid target.

    • #assignBends has been removed and its functionality folded into the default #EdgeCreator implementation.

    • The methods #isPortCandidateResolutionEnabled, #isValidEnd, #isValidBegin, #isCancelGesture, #isBendCreationEnforced, #isValidBend, #isSourceNodeDraggingFinished, #isRemoveBendEvent have been removed. The corresponding event recognizer can be used instead to customize the behavior.

    • #createBend(PointD), #startCreateEdge, #onTargetLocationChanged, #getNodes, #NodeComparer and #PortOwnerComparer have been removed.

Other InputModes

  • AbstractContextMenuInputMode: Support for different context menu trigger events has been added. Currently only mouse (right-click) and keyboard (Shift+F10, application / context menu key) are distinguished, more may be added in the future. The source can be queried from the property #EventSource in PopulateMenuEventArgs and PopulateItemContextMenuEventArgs.

  • An additional eventSource parameter has been added as well to the constructors of PopulatePopupMenuEventArgs and PopulateItemPopupMenuEventArgs as to the overload of AbstractContextMenuInputMode#onPopulateMenu which takes a context menu.

  • ClickInputMode:

    • The property #ValidClickHitCursor has been added. This cursor is used when hovering over a valid hit region.

    • The new method #preventNextDoubleClick can be used in event handlers for single clicks to prevent that this click can become part of a double click event.

    • If #ActiveButtons includes MouseButtons#RIGHT and ClickInputMode 's event handlers mark the corresponding click event as handled, the original right click event is marked as handled as well. Especially, no context menu will be shown if the right click is handled by ClickInputMode itself.

  • CreateBendInputMode#CancelEventRecognizer has been removed.

  • HandleInputMode#Active has been removed. The mode can be manually deactivated using the property #Enabled instead.

  • HandleInputMode#arm now has a handle parameter for the handle that is under the mouse cursor.

  • The class ItemDropInputMode is a new DropInputMode that facilitates subclasses that support preview and snapping of the dragged item as well as highlighting potential drop targets.

    • NodeDropInputMode and StripeDropInputMode have been refactored to use ItemDropInputMode as base class.

    • In NodeDropInputMode, callback #NodeCreator, event #NodeCreated and method #getDraggedNode have been removed. The callback #ItemCreator, event #ItemCreated and property #DraggedItem from superclass ItemDropInputMode should be used instead.

  • NodeDropInputMode can now optionally drop nodes onto leaf nodes and thus convert the leaves into group nodes. It is also possible to drop nodes into collapsed folder nodes. For both use-cases, an opt-in property has been added and a predicate property allows for fine-grained control over this feature.

  • ItemHoverInputMode is a new IInputMode that fires events when the mouse enters or leaves the visualization of a graph item.

  • OverviewInputMode:

    • The mode now extends MultiplexingInputMode.

    • It can be customized more easily. Minor modes can be replaced and adjusted, as well as the list of available default command bindings can be modified.

    • The new property #Margins specifies margins for the visible area of the bound GraphOverviewControl. The new protected method #updateVisibleArea provides further means for customizing the visible area.

  • MarqueeSelectionInputMode:

    • The events #DragStarting, #DragStarted, #Dragging, #Dragged, #DragFinishing, #DragFinished, #DragCanceling and DragCanceled now use MarqueeSelectionEventArgs that provide the current selection rectangle.

    • The event #MarqueeSelected has been removed. The event #DragFinished can be used instead.

    • Property #LastModifierState has been removed.

  • MoveInputMode:

    • The new event #QueryPositionHandler queries an IPositionHandler each time a drag is started.

    • The property #AffectedItems has been added which can be used to get a collection of items currently being moved.

    • Mouse hovers with the Shift key held down again are now accepted.

  • MoveViewportInputMode: Mouse cursor handling is now also done by protected methods #arm and #disarm, similar to other input modes.

  • MultiplexingInputMode: #ChildController and #createChildConcurrencyController have been removed.

  • TableEditorInputMode:

    • The new events #LabelAdding and #LabelEditing allow fine-grained control over adding or editing labels and tie into the existing functionality provided by IEditLabelHelper.

    • The events #DeletingSelection and #DeletedSelection now use SelectionEventArgs<IStripe>.

    • The property #AllowMixedSelection has been moved here from the removed class CompositeStripeSelection.

  • WaitInputMode#getMultiplexingInputMode has been removed.

  • TextEditorInputMode: The events #EditingStarted, #EditingCanceled and #TextEdited now use TextEventArgs.

  • TextEditorInputMode: The properties #StopRecognizer, #CancelRecognizer and #LineBreakRecognizer have been added which allow for easy customization of the key gestures used to add new line breaks and to cancel or stop the text editing.

Label Editing

  • IEditLabelHelper was refactored:

    • #addLabel and #editLabel were replaced by the methods #onLabelAdding and #onLabelEditing which take the new LabelEditingEventArgs as only argument.

    • Adding labels now can, depending on event handlers for LabelAdding or IEditLabelHelper implementations, optionally edit existing labels instead. This is similar to how editing labels can also add labels, e.g. if no labels are present on an item.

    • The method IEditLabelHelper#configureTextEditorInputMode has been removed. It has been replaced by the property LabelEditingEventArgs#TextEditorInputModeConfigurator.

    • The customizations possible from IEditLabelHelper are the same as those from the #LabelAdding and #LabelEditing events on GraphEditorInputMode and TableEditorInputMode. IEditLabelHelper is conceptually used as another event handler for those events.

    • The property #Owner of the implementing class EditLabelHelper has been removed, along with the respective constructor. The label owner can usually be queried from the LabelEditingEventArgs. Custom subclasses can of course still opt to store the item they were created for and use that field.

  • The label that is edited respectively the label owner for which a label is added is now determined in the following order:

    • If a label is explicitly provided as a command parameter or through a convenience method or is the only selected element, it is edited if the condition mentioned above is satisfied. No other candidates are tried in that case.

    • If a label owner is explicitly provided as a command parameter or through a convenience method, or is the only selected element, the first label that satisfies the condition above is edited. If no such label exists, a new label is added, provided that the owner allows adding. In either case, no other candidates are tried.

    • If there are multiple selected labels, the first selected label for which the previous condition is satisfied is edited.

    • If multiple label owners are selected, the first owner that has a label for which the previous condition is satisfied is chosen and that label is edited.

    • If IEditLabelHelper#editLabel for either an editable label or its owner provides a different label instance, this instance is edited instead.

    • Otherwise, a label is added if an eligible owner can be found.

  • If an IEditLabelHelper implementation is present in an ILabeledItem 's lookup, its #addLabel method is called to determine whether a label may be added and provide a suitable label instance. Additionally, the predicate method GraphEditorInputMode#shouldLabelBeAdded always has to return true, whether edit helpers are present or not. If the new label should be edited interactively after it’s creation (the default behavior), it also must be editable, following the rules above. Therefore an IEditLabelHelper implementation usually should allow editing of label instances that it has created itself in #addLabel.

  • Interactive label editing and creation has the following new features:

    • The current label visual can be hidden while the text editor is shown to reduce visual clutter. This feature is enabled by default and can be controlled through the property GraphEditorInputMode#HidingLabelDuringEditingEnabled.

    • GraphEditorInputMode and TableEditorInputMode provide new events #LabelTextEditingStarted and #LabelTextEditingCanceled that are raised directly before the label text editor is shown and after the label editing has been canceled, respectively.

    • Double clicking nodes and edges now opens the label editor. An existing label can be double clicked to edit the label text. This feature can be disabled with the property GraphEditorInputMode#EditLabelOnDoubleClickAllowed.

    • IEditLabelHelper implementations provided by the ILabel 's lookup can now be used to forbid or customize the editing of individual labels. Class LabelDecorator provides a new property #EditLabelHelperDecorator to customize this feature.

    • GraphEditorInputMode#editLabel and TableEditorInputMode#editLabel can now be used with SimpleLabel instances. This provides editing capabilities for dummy elements such as legends, page headers or other textual elements.

Snapping

  • Node and edge labels can now snap to particular locations while moving them interactively. Both types of labels can be aligned horizontally or vertically to their original location. In addition, a node label can be aligned with the borders or the center of its owner, and during resizing of that owner, smartly keeps its relative location to the snapped position. An edge label can be snapped on the path of its owner, or at particular distances of it. This feature can be enabled and configured with a LabelSnapContext and is available for labels with one of these label models: SmartEdgeLabelModel, FreeEdgeLabelModel, FreeNodeLabelModel and FreeLabelModel.

  • SnapContext:

    • A boolean parameter snappingDisabled has been added to the methods #handleMove and #dragFinished. This parameter has to be set to true to handle moves or finish a drag when snapping is temporarily disabled. This replaces the call to SnapContext#disableSnapping.

    • The events #Initializing, #Initialized and #CleanedUp as well as associated methods now use InputModeEventArgs.

    • #VoidInstance has been removed.

  • GraphSnapContext:

    • The return type of #getMovementInfos has been changed to IListEnumerable<MovementInfo> and the classes NodeMovementInfo, PortMovementInfo, BendMovementInfo and EdgeEndMovementInfo have been removed.

    • The info parameter’s type of #addEdgeEndToBeMoved has been changed to the more general MovementInfo. A boolean parameter atSource has been added.

    • The methods #addSameWidthEntries and #addSameHeightEntries now return an IListEnumerable<RectD> containing the rectangles whose widths respectively heights are closest to the given size. The parameters resultingSize and rects have been removed.

  • IEdgeSnapResultProvider:

    • The methods #initializeSnapping and #cleanupSnapping have been removed.

    • The info parameter’s type of #CollectSnapResults has been changed to IListEnumerable<MovementInfo>.

  • SnapResult now has more factory methods. The class SnapLineSnapResult has been replaced by a factory method as well.

  • The Classes SnapLineContainer, SingleLineSnapLineContainer, EdgeSegmentSnapLineContainer, FixedDistanceSnapLineContainer and InBetweenSnapLineContainer have been removed.

Clipboard

  • GraphClipboard has been improved:

    • GraphClipboard can be customized easier now. The filter factory #createDefaultCopyFilter takes the graph the copy filter is for. For the duplicate actions the new #createDefaultDuplicateFilter method and the property #DuplicateCopier can be used. Copied labels now use the model parameter returned by the callback #getLabelModelParameter.

    • The new properties #CopyItems, #IndependentCopyItems and #DependentCopyItems allow for restricting the types of items that can be copied at all, independently from their owners, or implicitly through their owners, respectively.

    • The various protected #adjustPosition methods have been removed, as applying the #PasteDelta is now done by GraphCopier.

    • The property #ClipboardContext has been removed.

  • The #copy methods in GraphCopier now have a new PointD offset parameter that shifts nodes and bends by a given amount upon copying them.

  • The signature of IClipboardIdProvider#getId has changed. The context parameter has been moved to the front.

  • Events

    • The properties #LastMouse2DEventArgs and #LastEventLocation have been removed from all input modes. Instead, the properties #LastMouse2DEventArgs and #LastEventLocation on CanvasControl can be used.

    • EdgeEventArgs now also contains the owner of the source and target port.

    • ItemClickedEventArgs now also contains the location of the click.

    • StripeEventArgs now also contains the ITable for this event .

    • OrthogonalEdgeEditingContext: The events #Initializing, #Initialized and #CleanedUp as well as associated methods now use InputModeEventArgs.

  • Keyboard Shortcuts have been changed:

    • Ctrl+O is now bound to ICommand#OPEN.

    • Ctrl+S is now bound to ICommand#SAVE.

    • Ctrl+Ins is now bound to ICommand#COPY.

    • Shift+Ins is now bound to ICommand#PASTE.

    • Shift+Del is now bound to ICommand#CUT.

    • Ctrl+PageDown is now bound to ICommand#MOVE_FOCUS_PAGE_DOWN.

    • Ctrl+PageUp is now bound to ICommand#MOVE_FOCUS_PAGE_UP.

    • Shift+PageDown is now bound to ICommand#SELECT_TO_PAGE_DOWN.

    • Shift+PageUp is now bound to ICommand#SELECT_TO_PAGE_UP.

    • ICommand#ADJUST_GROUP_NODE_SIZE now always processes the nodes in bottom to top order instead of using the order in which the nodes were selected

    • The default keyboard shortcut for deselecting elements (ICommand#DESELECT_ALL) has been changed to Ctrl+Shift+A. Ctrl+D is now the default shortcut for duplicating selected elements (ICommand#DUPLICATE). Duplicating elements can be disabled via GraphEditorInputMode#DuplicateAllowed.

  • For MacOS, shortscuts using the CTRL key now work with the COMMAND key instead.

    • ModifierKey: the enum value #SHORTCUT has been added.

    • KeyEventArgs: the property #ShortcutDown has been added.

    • IEventRecognizer: the static fields #SHORTCUT_DOWN, #SHORTCUT_UP and #SHORTCUT_PRESSED have been added.

  • Touch2DEvent: The modifier keys that are pressed during a touch event are now provided by the #Modifiers and #ChangedModifiers properties.

  • All hit-testing methods as well as the methods in IPortSelectionTester and IBendSelectionTester now take an IInputModeContext instead of ICanvasContext as their context parameter

  • IPositionHandler and IHandle implementations no longer also implement IPoint.

  • IPositionHandler#setPosition has been removed. The interface is now used as flagging interface only.

  • The classes DefaultPositionHandler and PointHandle have been removed

  • INodeCreationCallback#createNode now has a parent parameter which can be used as the parent node for creating a new node. GraphEditorInputMode tries to find a group node at the click location to pass as parent to the #NodeCreator.

  • Opening a context menu from the keyboard no longer uses the last known mouse pointer location for opening the context menu. Instead, the current selection or the current item are used.

  • IPortCandidateProvider: The two method overloads #getSourcePortCandidates and #getTargetPortCandidates that had an IEdge parameter have been removed.

  • The property AbstractPortCandidateProvider#PortOwner has been removed, along with the methods that made use of it.

  • AbstractPortCandidateProvider: create overloads of #createCandidate taking an IPort and optionally an IPortLocationModel have been removed.

  • DefaultPortCandidate: a constructor overload taking the PortCandidateValidity additionally has been added.

  • OrthogonalEdgeEditingContext#addMovedEdgeEnd: The type of the parameter movementInfo has been changed to the more general MovementInfo. A boolean parameter atSource has been added.

  • PortRelocationHandle: The method #configureDummyEdge has been folded into #createDummyEdge.

  • The methods IDragHandler#handleMove and IReshapeHandler#handleReshape don’t return anymore whether they had a visual effect.

  • The classes InputModeController and GraphInputModeController have been removed.

  • The abstract class EdgeEndMoveHandle has been removed.

  • The StateMachine class as well as the delegates StateHandler and TransitionHandler have been removed.

  • When the command ICommand#DELETE is executed when editing a table and some graph items are selected together with a stripe all selected items (including the stripe) will be deleted (was: only the stripe was deleted).

  • The classes FilteredCollectionModel and CancelEventArgs have been removed.

CanvasControl and GraphControl

  • CanvasControl:

    • The new property #LastEventLocation always contains the location of the last mouse event.

    • The property #MouseWheelBehavior taking a value of type MouseWheelBehaviors replaces the previous property #AutoMouseWheelZoomEnabled.

    • The scroll bars now scroll 5 view units per unit scroll (was 1 world unit) and 90 % of the visible width/height per block scroll (was 50 %).

    • The methods #add, #addCreator, #addGroup and #addGroupToGroup have been removed as the new methods #addChild and #addGroup of ICanvasObjectGroup provide a more intuitive way to add child elements to e.g. the GraphControl#getBackgroundGroup.

    • The property #InputModes has been removed. Developers who want to install multiple input modes on a CanvasControl have to set a MultiplexingInputMode as CanvasControl#InputMode and add their input modes to that mode.

    • The properties #AllMouseInputCapturingEnabled and #AllTouchInputCapturingEnabled have been combined in property #AllPointerInputCapturingEnabled.

    • The properties #OnCompoundKeyReleased, #onCompoundKeyTyped and #onCompoundKeyPressed have been added.

    • The property #collectCanvasObjects has been removed.

    • The method #renderContent was removed. Despite its name this method wasn't used to render the content.

  • GraphControl:

    • The #ContentRect will now also be updated when creating edges, adding, editing or moving labels or deleting all graph item types.

    • The methods #openFile, #saveFile and #saveFileAs have been reduced in accessibility to protected. The respective commands should be used instead of calling those methods.

    • The commands ICommand#CUT, ICommand#COPY and ICommand#PASTE are no longer handled and the respective convenience methods have been removed as well. Command bindings for #COPY are still supplied by GraphViewerInputMode and GraphEditorInputMode. Command bindings for #CUT and #PASTE are still supplied by GraphEditorInputMode.

    • The commands ICommand#UNDO and ICommand#REDO are no longer handled and the respective convenience methods have been removed as well. Command bindings for #UNDO and #REDO are still supplied by GraphEditorInputMode. Furthermore, the respective methods can still be called on the UndoEngine directly.

    • Property #UndoabilityEnabled has been removed. The commands ICommand#UNDO and ICommand#REDO can be enabled on the GraphEditorInputMode.

    • Property #ClipboardEnabled has been removed. The clipboard commands can be enabled on the GraphEditorInputMode.

    • Method #getUndoEngine has been removed. The current UndoEngine can be retrieved from the GraphControl#Graph.

    • Event #SelectionChanged has been removed.

    • Added convenience methods #morphLayout for arranging graph elements in an animated fashion.

    • Added a convenient way to set a custom GraphMLIOHandler to a GraphControl. Previously the lookup of the class needed to be decorated.

  • Most of the properties of the classes CanvasControl, GraphControl and GraphOverviewControl now have correspondent JavaFX properties for databinding and events previously reporting their changes have been removed.

GraphML

The XML namespaces and GraphML naming conventions have been updated. The mapping from yfiles classes to the corresponding XML namespaces has been changed, as well as some of the naming conventions:

  • All platform independent model classes are now mapped to http://www.yworks.com/xml/yfiles-common/3.0. This includes the following packages:

    • com.yworks.yfiles.graph

    • com.yworks.yfiles.graph.labelmodels

    • com.yworks.yfiles.graph.portlocationmodels

    • com.yworks.yfiles.graph.styles.common

    • com.yworks.yfiles.markup.common

  • All platform independent graphml support classes are now mapped to http://www.yworks.com/xml/yfiles-common/markup/3.0. This includes the following packages:

    • com.yworks.yfiles.markup.system

  • All platform independent framework classes are now mapped to http://www.yworks.com/xml/yfiles-common/markup/primitives/2.0. This includes the following classes:

    • primitive types (int, double, boolean, char)

    • java.lang.String

  • All types and members in these namespaces use the WPF naming convention in GraphML files:

    • WPF type and property names (if applicable)

    • UpperCamelCase for properties, fields, constants and enum members

  • All platform dependent library classes are now mapped to http://www.yworks.com/xml/yfiles-java-fx/3.0/xaml. This includes the following packages:

    • com.yworks.yfiles.styles

    • com.yworks.yfiles.markup.platform.java

  • All types and members in this namespace use the native naming convention in GraphML files:

    • actual type and property names (if applicable)

    • UpperCamelCase for properties

    • UPPERCASE_UNDERSCORE for fields, constants and enum members

  • The performance of parsing GraphML files has been improved. The speed-up is especially notable for large graphs with several thousands of nodes.

  • The following events have been added to signal the end of the write or parse process, respectively: GraphMLIOHandler#Parsed, GraphMLParser#Parsed, GraphMLIOHandler#Written, GraphMLWriter#Written, together with the corresponding event raiser methods.

  • SerializationProperties:

    • The new property #ParseLabelSize optionally disables parsing of the preferred size of a label.

    • #DISABLE_USER_TAGS changed its type from TypedKey<boolean> to TypedKey<GraphItemTypes>.

    • #DISABLE_STRIPE_USER_TAGS changed its type from TypedKey<boolean> to TypedKey<StripeTypes>.

    • #WRITE_GRAPH_SETTINGS and #DISABLE_GRAPH_SETTINGS have been merged to a single #DISABLE_GRAPH_SETTINGS property which is interpreted according to the context where it is set.

    • #INDENT_OUTPUT has been added that allows to define whether the XML output should be properly indented.

  • A few abstract base classes have been merged:

    • AbstractXmlWriter and DirectXmlWriter have been merged into XmlWriter.

    • AbstractMapperInputHandler and ComplexMapperInputHandler have been merged into MapperInputHandler.

    • AbstractMapperOutputHandler and ComplexMapperOutputHandler have been merged into MapperOutputHandler.

  • TypeConverter and all subclasses have been removed and were replaced either by ValueSerializer s or by implementations of the new interface IMarkupExtensionConverter.

  • The generic types of collection properties are now better (de-)serialized. To achieve this, method PropertyInfo#getPropertyType now returns a Type instead of a Class.

  • The legacy interface IDeserializer and all implementations have been removed. For custom deserialization an event handler for GraphMLIOHandler#HandleDeserialization can be used.

  • The legacy interface ISerializer and all implementations have been removed. For custom serialization an event handler for GraphMLIOHandler#HandleSerialization can be used.

  • ArrayValueSerializer and NullXmlWriter have been removed.

  • IXamlNameMapper has been refactored:

    • The methods #addMapping have been removed

    • The method #getXmlNamespace has been removed

    • The return type of #getName has been changed from String to XmlName, so the XmlNamespace of a type can be retrieved via XmlName#getXmlNamespace.

  • QueryOutputHandlersEventArgs: The overload of #addOutputHandler taking an object id has been removed

  • XmlWriter: constructor overloads taking a boolean parameter indent have been added that allow to define whether the XML output should be properly indented.

  • XmlWriter: the constructor overload taking an InternalXmlWriter as well as the corresponding property #DelegateWriter have been removed.

  • GraphMLSerializationMode has been removed. The GraphMLMemberVisibility can be used instead.

  • The annotations ContentProperty, ValueSerializer and SingletonSerialization have been replaced by corresponding properties on annotation GraphML. Annotation MarkupExtensionReturnType has been removed.

Utility classes

  • Removed a lot of utility classes and interfaces:

    • Reference and all subclasses.

    • EmptyCollection<T>, EmptyList<T>, DoubleCollection CompositeEnumerable, CompositeListEnumerable, SingleListEnumerable, SingletonCollection, SingletonList, SingletonEnumerator and CompositeEnumerator.

    • CompositeHandle<T> and CompositePositionHandler.

    • IStruct, ElementFoundCallback and ILookupProvider.

    • Replaced IMapperDelegate and FactoryDelegate<TResult,TContext> by java.util.function.Function.

    • ILookupCallback and ContextLookups. Use IContextLookup instead.

    • CompositeCollectionModel, CallbackLookup, AbstractContextLookupChainLink, GenericYList, GenericListCell and HashSet.

    • CollectionChangedEventArgs, CollectionChangeType, CollectionExtensions and ICollectionChangeReporter.

    • ComponentResourceKey was removed and usages replaced by its base class ResourceKey which got a new constructor taking a Class and an Object as parameter.

    • The class GraphCopier for layout graphs and related classes and methods have been removed. Note that the GraphCopier implementation for IGraph still exists.

    • The classes DefaultNodeLookup, DefaultEdgeLookup, DefaultPortLookup, DefaultLabelLookup, DefaultBendLookup and DefaultItemLookup have been removed. Instead the properties #DefaultNodeLookup, #DefaultEdgeLookup, #DefaultPortLookup, #DefaultLabelLookup and #DefaultBendLookup have been added to DefaultGraph.

    • Class ItemDecorator<TModelItem> has been removed. Its members have been pushed down to its former sub classes NodeDecorator, EdgeDecorator, LabelDecorator, PortDecorator and BendDecorator.

  • The events #ItemSelected and #ItemDeselected on ISelectionModel have been merged into the #ItemSelectionChanged event.

  • Changed the return type for some methods from IEnumerable to the less restrictive type Iterable where possible in IHitTester, IBendSelectionTester, IHandleProvider, IPortCandidateProvider and many more. This makes it easier for clients to implement or extend those classes.

  • GeomSupport: method #createSmoothedPath has been moved to class GeneralPath.

  • Usage of EventHandler was made more consistent:

    • The sub interfaces ItemEventHandler, HierarchyItemEventHandler, Mouse2DEventHandler and CompoundKeyEventHandler have been replaced by EventHandler s typed with the specific EventArgs like EventHandler<ItemEventArgs>.

    • More usages of EventHandler have been typed to the specific EventArgs that are used by the handler.

  • The methods #contains, #notContains and #containsAll have been added to FlagsEnum.

  • GeneralPath: Removed the #FillMode parameter from methods #createPath and #updatePath.

  • GeneralPath: Removed the unused methods #createGeometry.

  • The interface IMapperMetadata has been removed and its single implementation MapperMetadata is now used instead.

  • IMapper: The method #removeValue has been removed. It depends on the specific implementation of the mapper whether a mapping can be removed. If an implementation provides a way to remove a mapping, that should be preferred over setting a null value.

  • TagOwnerMapper has been removed. Use this or similar code instead to access Tag s via an IMapper : Mappers#createMapper<ITagOwner, object>(key ⇒ key.Tag).

  • CanvasPrinter: The property #PageMarkPrintingEnabled and the protected method #createPageMarks have been added to support adding page marks to the print output.

  • The interface IPropertyChangeReporter has been removed. Usages have been replaced by regular events.

  • The classes TypedKey and TypedKeyMapper have been moved to package com.yworks.yfiles.graphml.

  • The interface ICollectionModel has been renamed to IObservableCollection and its implementing classes accordingly.

Layout

Layout execution

  • LayoutExecutor:

    • The method #stop now stops a running layout calculation as soon as possible and then immediately shows the result so far, skipping any animation. In addition, the new method #cancel immediately cancels a running calculation and doesn’t change the GraphControl#Graph unless the animation was already running.

    • The method #setAbortHandler has been removed. Instead there is a protected factory method #createAbortHandler which can be overridden to create a custom AbortHandler implementation.

    • Labels are now taken into account for the final content rectangle and viewport animation.

    • The property #FinishedHandler has been replaced by the event #LayoutFinished that uses the new LayoutEventArgs. LayoutExceptionEventArgs have been replaced by LayoutEventArgs whose property #Exception is null when no exception occured.

    • The new property #ConsiderViewportLimiter can be enabled to let the target viewport after a layout respect the ViewportLimiter of the GraphControl. The ViewportAnimation has a new property #ConsiderViewportLimiter for the same purpose.

    • Classes LayoutExecutor and LayoutGraphAdapter now have a property #AutomaticEdgeGrouping that automatically configures edge groups for ports with multiple incoming or outgoing edges. This feature is enabled by default.

    • Classes LayoutExecutor and LayoutGraphAdapter now have a property #FixPorts that automatically configures strong source and target port constraints for all edges in the graph. This feature is disabled by default.

  • LayoutGraphAdapter now adds data providers that map each node, edge and label of a LayoutGraph to their corresponding IModelItem in the original IGraph. Especially, these data providers are available if a layout is run with a LayoutExecutor or the convenience methods LayoutExtensions#morphLayout and LayoutExtensions#applyLayout.

  • The factory methods #createEdgeBetweennessPartitionFinder, #createComponentPartitionPlacer, #createPolylineInterEdgeRouter, #createChannelInterEdgeRouter and their overloads have been moved from the PartitionLayout class to appropriate interfaces IPartitionFinder, IPartitionPlacer and IInterEdgeRouter.

Streamlined Layout API

  • The legacy hierarchic layout com.yworks.yfiles.layout.hierarchic.HierarchicLayouter, com.yworks.yfiles.layout.hierarchic.HierarchicGroupLayouter, and the associated legacy interfaces ILayerer, IDrawer, IMementoSupport, ILayerSequencer, together with their implementations, have been removed. Instead, IncrementalHierarchicLayouter has been renamed to HierarchicLayout and is now the only implementation of the hierarchic layout style. All associated interfaces and implementations from the package com.yworks.yfiles.layout.hierarchic.incremental have been moved up to com.yworks.yfiles.layout.hierarchic.

  • Legacy classes OrthogonalGroupLayouter and DirectedOrthogonalLayouter have been removed and their features have been incorporated in OrthogonalLayout. Class DirectedOrthogonalLayoutData has been removed and its features have been incorporated into OrthogonalLayoutData.

  • Legacy class OrthogonalEdgeRouter and all associated classes have been removed.

  • Class HVTreeLayouter has been removed and its features have been incorporated into TreeLayout.

  • Class DefaultGraphLayout has been removed.

  • Class ParentEdgeAugmentationStage has been removed.

  • Method Graph#moveSubgraph has been removed.

  • CopiedLayoutIGraph was removed. An instance of the super type CopiedLayoutGraph with the same functionality can be obtained from factory method #createCopiedLayoutGraph in LayoutGraphAdapter.

  • The method canLayout has been removed from all layout algorithms. Previously it pretty much always returned true.

Major Features Added

  • Added support for Sankey diagrams which visualize flow quantity between entities like e.g., cost or energy flow.
  • HierarchicLayout: Added support for port grouping, see PortConstraintKeys#SOURCE_PORT_GROUP_ID_DPKEY and PortConstraintKeys#TARGET_PORT_GROUP_ID_DPKEY. Edges are bundled at their ports, but routed independently.
  • HierarchicLayout now allows to specify the directedness of edges, see HierarchicLayout#EDGE_DIRECTEDNESS_DPKEY. This new feature enables to, for example, support mixed graphs that contain both directed and undirected edges: While for directed edges the layering step tries to find a solution where the source of an edge is placed above the target (with respect to the main layout direction), for undirected edges the direction doesn't matter and the edge may also be inserted as same-layer edge. This feature also enables to force some edges to specifically point against the main layout direction.
  • HierarchicLayout: Added support for edges with a specific thickness. Minimum distances in the layout will consider these thicknesses, see HierarchicLayout#EDGE_THICKNESS_DPKEY.
  • Added preferred placement specifiers LabelLayoutConstants#PLACE_AT_SOURCE_PORT and LabelLayoutConstants#PLACE_AT_TARGET_PORT for edge labels which express that the label should be placed directly at the source/target port of the edge. Currently, the specifiers are only considered by the integrated labeling of the HierarchicLayout.
  • OrganicLayout now supports the detection of regular substructures in the graph (see OrganicLayout#setChainSubstructureStyle(ChainSubstructureStyle), OrganicLayout#setStarSubstructureStyle(StarSubstructureStyle), OrganicLayout#setCycleSubstructureStyle(CycleSubstructureStyle), and OrganicLayout#setParallelSubstructureStyle(ParallelSubstructureStyle)) and applies a specific layout style to them such that they can be better recognized.
  • TreeReductionStage: added possibility to specify a custom labeling algorithm that places labels of non-tree edges. Now, users do not need to take care of such edge labels themselves after using a tree layout algorithm on a non-tree input graph in conjunction with the reduction stage. See properties TreeReductionStage#setNonTreeEdgeLabelingAlgorithm and TreeReductionStage#setNonTreeEdgeLabelSelectionKey.
  • SeriesParallelLayout: added possibility to specify a custom labeling algorithm that places labels of non-series-parallel edges. Such labels are now automatically handled. Users do not need to handle them after running the algorithm with a non-series-parallel input graph. See properties SeriesParallelLayout#setNonSeriesParallelEdgeLabelingAlgorithm and SeriesParallelLayout#getNonSeriesParallelEdgeLabelSelectionKey.
  • HierarchicLayout supports recursively routed edges. Edges that pass the border of group nodes will always leave at the bottom side and enter at the top side of the group node. This routing style is specified using EdgeLayoutDescriptor#setRecursiveEdgeStyle(RecursiveEdgeStyle).
  • HierarchicLayout: Improved from-sketch behavior for groups with changed bounds (e.g. after folding or expanding a group node).
  • Added edge bundling feature. Bundling together multiple edges means that their common parts are to some degree merged into a bundled part. Edge bundling is useful to increase the readability of graph drawings with a high number of edges that connect a comparably small number of nodes. The following layout algorithms support edge bundling:
    • CircularLayout: Edge bundling is applied to edges of the same partition.
    • TreeReductionStage: Edge bundling is applied to non-tree edges.
    • RadialLayout: Edge bundling is applied to non-tree edges.
  • Added new layout algorithm SeriesParallelLayout for graphs that are constructed only by series (combining two series parallel graphs by merging the source of one graph with the sink of the other) and parallel (combining two series parallel graphs by merging the sources and the sinks) operations.
  • Added multi-parent support to TreeLayout. A tree node can have multiple parents that are connected to all of its siblings and share the same parents. This might come to use in organizational charts where a team answers to multiple superiors.
  • Added grid placement support for nodes and edges to HierarchicLayout.
  • Passing data to a layout algorithm has been simplified by the new LayoutData classes. For each major and many minor layout algorithms a subclass of LayoutData has been added that allows to set data relevant for this algorithm using properties. This LayoutData object can be set on LayoutExecutor or passed to the IGraph#applyLayout or GraphControl#morphLayout method. The following layout data classes have been added:
    • ARTreeLayoutData for the ARTreeLayouter
    • BalloonLayoutData for the BalloonLayouter
    • BusRouterData for the BusRouter
    • ChannelEdgeRouterData for the ChannelEdgeRouter
    • CircularLayoutData for the CircularLayouter
    • ComponentLayoutData for the ComponentLayouter
    • CompositeLayoutData to combine different layout data objects
    • DirectedOrthogonalLayoutData for the DirectedOrthogonalLayouter
    • FamilyTreeLayoutData for the FamilyTreeLayouter
    • FixedGroupLayoutData for the FixedGroupLayoutStage
    • GenericTreeLayoutData for the GenericTreeLayouter
    • HVTreeLayoutData for the HVTreeLayouter
    • IncrementalHierarchicLayoutData for the HierarchicLayout
    • LabelingData for the SALabeling and GreedyMISLabeling
    • MultiPageLayoutData for the MultiPageLayouter
    • OrganicEdgeRouterData for the OrganicEdgeRouter
    • OrthogonalEdgeRouterData for the OrthogonalEdgeRouter
    • OrthogonalLayoutData for the OrthogonalLayouter
    • OrthogonalPatternEdgeRouterData for the OrthogonalPatternEdgeRouter
    • ParallelEdgeLayoutData for the ParallelEdgeLayouter
    • PartialLayoutData for the PartialLayouter
    • PartitionLayoutData for the PartitionLayouter
    • PolylineEdgeRouterData for the com.yworks.yfiles.layout.router.polyline.EdgeRouter
    • RadialLayoutData for the RadialLayouter
    • RecursiveGroupLayoutData for the RecursiveGroupLayouter
    • SelfloopCalculatorLayoutData for the SelfloopCalculator
    • SmartOrganicLayoutData for the SmartOrganicLayouter
    • StraightLineEdgeRouterData for the StraightLineEdgeRouter
    • TreeReductionStageData for the TreeReductionStage

Minor Features Added

  • HierarchicLayout: Added support for sequence constraints between edges as well as nodes and edges, see SequenceConstraintFactory.
  • HierarchicLayout: Added support for overlapping layers. The strict layer structure can be compacted by moving layers up into the space of previous layers. Layers are only moved if it won't produce overlaps with nodes or edges.
  • HierarchicLayout: Added feature that allows for edges that connect group nodes with their descendants to directly connect from inside to the group node's border. It can be activated for each edge individually on the EdgeLayoutDescriptor by calling EdgeLayoutDescriptor#setDirectGroupContentEdgeRoutingEnabled(boolean).
  • RecursiveGroupLayout: Added edge splitting for inter-edges and the possibility to align edges that connect to the group border from inside and outside.
  • GenericLabeling: Added option AbstractMISLabeling#setAmbiguityReductionEnabled(boolean) that reduces the ambiguity of label placements. When enabled, the labeling algorithms try to avoid placing labels at positions where it is not clear to which graph element a label belongs.
  • Added layout stage CurveFittingLayoutStage which allows the approximation of edge paths with cubic bezier curve control points. The stage is especially useful if curved edges are modeled using a large number of bends connected via straight lines.
  • AbortHandler: Added method hasCheckFailed() that allows to query whether a check method was called after a stop or cancel event.
  • Added interface LabelLayoutFactory that provides methods for creating, adding and removing node/edge labels for LayoutGraphs.
  • HierarchicLayout: Added support for incremental group nodes (see IncrementalHintsFactory#createIncrementalGroupHint(Object)). Incremental groups will be placed on a suitable position. The hints of their descendants are interpreted relative to the group node.
  • SimplexNodePlacer: Added option setNodeCompactionEnabled(boolean) that allows to place adjacent nodes of a layer in a more compact, stacked style.
  • Added vertical alignment option for DefaultNodePlacer and SimpleNodePlacer. In addition to the previous compact child placement, siblings can now be aligned at top, center or bottom for example.
  • TreeLayout: Added support for critical edges in DefaultNodePlacer, DendrogramNodePlacer, SimpleNodePlacer, LayeredNodePlacer and DoubleLineNodePlacer. Nodes connected to a critical edge will be center aligned which can be used to highlight certain paths in the tree.
  • TreeLayout: Added support for grouped edges in DefaultPortAssignment. Grouped edges will share the same port location at local root.
  • Added class GroupedNodePlacer that allows TreeLayout to place siblings into different groups.
  • RecursiveGroupLayout: Added option setInterEdgeRouter(ILayoutAlgorithm) to specify an edge router to layout edges that cross group node bounds. Thus, it is not necessary to subclass the layouter to change inter-edge routing anymore.
  • Added layout stage FixPortLocationStage which ensures that layout algorithms that cannot handle port constraints keep the ports of edges with strong port constraints.
  • Added layout stage PortPlacementStage which assigns edges to the ports specified by PortConstraints or PortCandidates after calling the core layout.
  • Groups: Added k-means clustering algorithm that partitions a given graph in k-clusters.
  • Groups: Added hierarchical clustering algorithm that partitions a given graph based on agglomerative (i.e., bottom-up) strategy and some linkage function (single-, complete- and average-linkage).

Improvements

  • HierarchicLayout: Improved support for PortCandidates at group nodes. Previously, they were only obeyed if there was just a single candidate defined, which also applied to the opposite node (not necessarily a group node). Now, out of the given candidates, one is selected and considered for the routing. Still, fixed candidates are treated like free ones and are not supported at the side of group nodes.
  • Improved the performance of OrthogonalSegmentDistributionStage and thus also ChannelEdgeRouter which by default uses the mentioned stage as edge distribution strategy.
  • HierarchicLayout: Routing of grouped edges that connect to nodes of different groups now assures that the whole bus segment remains outside the different group nodes. This avoids that group nodes get unnecessarily large and potentially makes drawings more symmetric.
  • HierarchicLayout: Improved edge grouping such that it is now possible to group incoming/outgoing edges as well as same-layer/backloop edges with common edges.
  • HierarchicLayout can now take the original edge route into account to determine the route of a self-loop.
  • MultiPageLayout: Added new option MultiPageLayout#setStrictClusterSeparationEnabled(boolean) that allows to specify whether or not nodes with different cluster IDs may be placed onto the same page.
  • The following tree algorithms now support custom selection of the root node of the tree:
    • BalloonLayout
    • TreeLayout
    • ClassicTreeLayout
    • AspectRatioTreeLayout
  • BalloonLayout: Interleaved child placement now works in conjunction with from sketch-mode and custom child order comparators. This means that the settings BalloonLayout#setFromSketchModeEnabled(boolean) and BalloonLayout#setComparator(Comparator) are no longer ignored when enabling the interleaved placement mode (see BalloonLayout#setInterleavedMode(InterleavedMode)).
  • TreeLayout and ClassicTreeLayout: Now take into consideration the minimum group node size specified by the user with a DataProvider registered with the graph with key GroupingKeys#MINIMUM_NODE_SIZE_DPKEY.
  • ChannelRouter: Improved order of segments to avoid edge crossings when there are multiple segments that have one common end point.
  • New convenience method LayoutGraphUtilities#getPathClippedOnBB(YPointPath, YRectangle, YRectangle) that computes a clipped edge path given a YPointPath and two YRectangles to clip on.
  • HierarchicLayout: Added properties that allow for stopping the layout algorithm after the layering or the sequencing phase while skipping the subsequent phases. This may be useful when using two layout runs to collect layering and/or sequencing information in the first run that will be used during the second run.
  • HierarchicLayout: Fixed edges which have segments that should be horizontal or vertical but are slightly non-orthogonal.
  • HierarchicLayout: Improved behavior in incremental mode that moved normal nodes that were in different layers (in the initial layout) to the same layer. This behavior occurred in case there were group nodes that extended into the layer above or below to get a compact result.
  • EdgeRouter will now consider the target group of an edge if this edge is the only member of its source group.
  • EdgeRouter: Improved edge routes of self-loops to go around at least one corner of the node. Only if both source and target port are restricted to the same side (PortConstraint, PortCandidate), self-loops may start and end at the same side of the node.
  • InteractiveOrganicLayout: Fixed possible performance problem after changing the inertia/stress of some nodes.
  • The directed style of the OrthogonalLayout: Now always produces planar drawings for trees.
  • GenericLabeling: Generic labeling algorithms do not consider any more labels of zero width or height. Before, bad labeling results were possible.
  • GenericLabeling: Improved performance - especially for large graph instances.
  • Improved support for PreferredPlacementDescriptor side preference (left, on-edge, right) when using generic labeling algorithms GenericLabeling. Now, the side preference is considered for edge labels with arbitrary EdgeLabelModel implementations.
  • TreeLayout: Improved DefaultPortAssignment to consider PortConstraints in all modes. If a distributed mode is selected then weak constraints will also be distributed on the according side.
  • LayeredNodePlacer: Improved spacing between labels and bends when polyline labeling is enabled.
  • RadialLayout: If the data provider registered with key RadialLayout.NODE_INFO_DPKEY also implements DataAcceptor interface, it will be filled with the according RadialLayout.NodeInfo object for each node.
  • Added layout stage HandleNaNCoordinatesStage which prevents layout algorithms that take initial coordinates for nodes and edges into account from failing if some of those graph elements have NaN-coordinates.
  • Several smaller runtime improvements for the following layout algorithms:
    • HierarchicLayout
    • ChannelRouter
    • OrganicLayout
    • OrthogonalLayout
    • CircularLayout
    • RadialLayout
  • HierarchicLayout: Reduced number of group node overlaps that may appear for groups containing elements with tail/head constraints, see SequenceConstraintFactory#addPlaceNodeAtTailConstraint(Object) and SequenceConstraintFactory#addPlaceNodeAtHeadConstraint(Object).
  • Improved abort handling for algorithms that use ConstraintIncrementalLayerer, ConstraintLayerer and TopologicalIncrementalLayerer. For large graphs these classes may require a long runtime that cannot be canceled by using an AbortHandler.
  • HierarchicLayout: The group transposition feature (see DefaultLayerSequencer.setGroupTranspositionEnabled(boolean)) can now also be used in incremental layout mode.
  • ConstraintIncrementalLayerer: Improved handling of same layer constraints. In previous versions the layerer sometimes ignores same layer constraints even though there is a valid layering.
  • HierarchicLayout: More compact placement of rotated as well as stacked labels.
  • OrganicLayout: Now also considers the group node compactness (see option setGroupNodeCompactness(double)) if option setNodeEdgeOverlapAvoided(boolean) is enabled.
  • OrganicLayout: Improved node overlap removal (see option setNodeOverlapsAllowed(boolean)). Now, if the scope is set to SUBSET or MAINLY_SUBSET, the number of node overlaps that cannot be removed is reduced.
  • LayeredNodePlacer: Reduced overlaps between edges and node labels for all routing styles.
  • GridNodePlacer: Corrected alignment of child nodes and edge routing when there are node labels.
  • AbstractRotatableNodePlacer.RootAlignment, DefaultNodePlacer and DendrogramNodePlacer: Instead of aligning bounding boxes including nodes and their labels, nodes are aligned directly with other nodes. Therefore a layout with node labels gets more compact and the alignment is consistent with that of graphs without node labels.
  • DelegatingNodePlacer: Added support for a child comparator for children of local root nodes.
  • TreeLayout now ignores labels with zero width or height in all distance calculations.
  • TreeLayout: INodePlacer implementations now also use the specified spacing as minimum distance between different subtrees.
  • PartialLayout: Reduced number of element overlaps if there are partial group nodes.
  • ParallelEdgeRouter: Now always separates parallel edges according to their direction, i.e., edges (v,w) and (w,v) are never placed interleaved.
  • GenericLabeling now also considers the node/edge overlap penalty specified by a LabelCandidate.

Changes in Default Behavior

  • HierarchicLayout: Creating layer constraints (see LayerConstraintFactory) or sequence constraints (see SequenceConstraintFactory) using a disposed of factory now throws an IllegalStateException.
  • GenericLabeling: Changed LabelCandidates default for overlap penalty of nodes and edges from 0 to 1. This means label overlaps are now considered more severe.
  • HierarchicLayout: The edge grouping now supports to group incoming and outgoing edges of a node. In previous versions incoming and outgoing edges always defined separate groups even though the user specified the same group IDs for such edges.
  • The following default values of properties have been changed:
    • MultiStageLayout and MultiPageLayout: The default LabelLayout is now set to an instance of GenericLabeling.
    • PartialLayout: Default value of property MinimalNodeDistance is now 10d instead of 0.0.
    • MultiParentDescriptor: Default value of property MinimumNodeDistance is now 15d instead of 10.0.
    • BalloonLayout: Default value of property MinimalNodeDistance is now 10.0 instead of 0.0.
    • GenericLabeling: Default value of property DeterministicModeEnabled is now true instead of false.
    • SplitEdgeLayoutStage: Default value of property ProxyNodeSize is now 1.0 instead of 0.0.
  • HierarchicLayout: For input graphs with infeasible PortConstraints and PortCandidates/PortCandidateSets (i.e., for edges that have non-matching port constraints/candidates), the layout algorithm now always prefers PortConstraints. In previous versions, the behaviour was not well-defined for such cases.
  • PortCandidateAssignmentStage: Now, if an edge has registered PortCandidates and connects to nodes with PortCandidateSets, the stage will try to match both collections to find an appropriate port. In case there is no matching port candidate, a PortCandidate specified for the edge is preferred. Before, one of PortCandidates was selected without trying to match with node port candidates.
  • GraphTransformer: Method setOperation(int) now only sets the operation value and does not disable the automatic selection of best fitting rotation angle if an operation other than ROTATE is selected.
  • Centrality: The following methods can now take empty INodeMaps and IEdgeMaps as arguments for returning the resulting centrality values.
    • Centrality#edgeBetweenness(Graph, IEdgeMap, boolean, DataProvider)
    • Centrality#nodeBetweenness(Graph, INodeMap, boolean, DataProvider)
    • Centrality#nodeEdgeBetweenness(Graph, INodeMap, IEdgeMap, boolean, DataProvider)
  • Most of the setter methods of the properties of package layout now throw an IllegalArgumentException if an unexpected/illegal or null argument is given as input.
  • DelegatingNodePlacer: Method determineChildConnector(Node) now throws an IllegalStateException instead of an IllegalArgumentException.
  • OrthogonalLayout: Method setIntegratedEdgeLabelingEnabled(boolean) throws an IllegalStateException if the current label layouter is not of type LabelLayoutTranslator.
  • TreeComponentLayout: Constructor TreeComponentLayout(ILayouterAlgorithm) throws an IllegalArgumentException if null is given as argument.

Other API Changes

  • Groups.Dendrogram does no longer extend class Graph. To enable convenient iteration of a dendrogram, method Groups.Dendrogram.getChildren(Node) was added.
  • The following constructors have been removed:
    • Bipartitions.Bipartitions()
    • Centrality.Centrality()
    • Cycles.Cycles()
    • GraphConnectivity.GraphConnectivity()
    • NetworkFlows.NetworkFlows()
    • NodeOrders.NodeOrders()
    • Paths.Paths()
    • RankAssignments.RankAssignments()
    • SpanningTrees.SpanningTrees
    • Transitivity.Transitivity()
    • Bfs.Bfs()
    • Grouping.Grouping()
    • Swimlanes.Swimlanes()
    • RecursiveGroupLayout.RecursiveGroupLayout(ILayoutAlgorithm,IGroupBoundsCalculator)
  • FixedGroupLayoutStage: Method getInterEdgeroutingStyle() has been renamed to getInterEdgeRoutingStyle().
  • EdgeReverser: Method reverseEdges(Graph,EdgeList) has become static.
  • The following classes, constructors, and methods have been deprecated:
    • PortConstraint: All constructors
    • PortCandidate: All constructors
    • SequenceConstraintFactory: Methods
      • addPlaceNodeAfterConstraint(Object, Object)
      • addPlaceNodeAtHeadConstraint(Object)
      • addPlaceNodeAtTailConstraint(Object)
      • addPlaceNodeBeforeConstraint(Object, Object)
    • WeightedLayerer: Method downShiftNodes(Graph, INodeMap, int)
  • BendConverter: The data provider key ScopeDpKey has been renamed to AffectedEdgesDpKey.
  • BendConverter: Property AdoptSelection has been renamed to AdoptEdgeMarking.
  • BendConverter: Property SelectedEdgesDpKey has been renamed to MarkedEdgesDpKey.
  • CircularLayouter: The data provider key CircleIdHolderDpKey has been renamed to CircleIdDpKey.
  • CircularLayouter: The data provider key CircularCustomGroupsDpKey has been renamed to CustomGroupsDpKey.
  • com.yworks.yfiles.layout.circular.LayoutStyle: Enum type CircularCustomGroups has been renamed to CustomGroups.
  • ComponentLayouter: The data provider key LayoutNodeDpKey has been renamed to AffectedComponentsDpKey.
  • ComponentLayouter: The data provider key GivenComponentDpKey has been renamed to ComponentIdDpKey.
  • EdgeReversalStage: The data provider key ReverseEdgesDpKey has been renamed to AffectedEdgesDpKey.
  • FamilyTreeLayouter: The data provider key DpKeyFamilyType has been renamed to FamilyTypeDpKey and data provider registered with this key have to return values of the new com.yworks.yfiles.layout.genealogy.FamilyType enum.
  • PartitionGrid: The data provider key PartitionCellDpKey has been renamed to PartitionCellIdDpKey.
  • ConstraintIncrementalLayerer: The data provider key EdgeWeightsDpKey has been renamed to AdditionalEdgeWeightDpKey.
  • com.yworks.yfiles.layout.hierarchic.HierarchicLayouter: The data provider key LayerValueHolderDpKey has been renamed to LayerIndexDpKey.
  • com.yworks.yfiles.layout.hierarchic.HierarchicLayouter: The data provider key SequenceValueHolderDpKey has been renamed to SequenceIndexDpKey.
  • com.yworks.yfiles.layout.hierarchic.IEdgeData: The property SourceCandidates has been renamed to SourcePortCandidates.
  • com.yworks.yfiles.layout.hierarchic.IEdgeData: The property TargetCandidates has been renamed to TargetPortCandidates.
  • SelfloopCalculator: The data provider key IsOctilinearDpKey has been renamed to OctilinearEdgesDpKey.
  • HierarchicLayout: The data provider key CriticalEdgeDpKey has been renamed to CriticalEdgePriorityDpKey.
  • HierarchicLayout: The data provider key LayerValueHolderDpKey has been renamed to LayerIndexDpKey.
  • HierarchicLayout: The data provider key SequenceValueHolderDpKey has been renamed to SequenceIndexDpKey.
  • LayouterKeys: The data provider key SelectedNodesDpKey has been renamed to AffectedNodesDpKey.
  • LayouterKeys: The data provider key SelectedEdgesDpKey has been renamed to AffectedEdgesDpKey.
  • LabelLayoutKeys: The data provider key IgnoreLabelDpKey has been renamed to IgnoredLabelsDpKey.
  • LabelingBase: Property SelectedLabelsDpKey has been renamed to AffectedLabelsDpKey.
  • NormalizingGraphElementOrderStage: The data provider key ComparableNodeDpKey has been renamed to NodeComparableDpKey.
  • NormalizingGraphElementOrderStage: The data provider key ComparableEdgeDpKey has been renamed to EdgeComparableDpKey.
  • The enum com.yworks.yfiles.layout.organic.SphereOfAction has been removed. Earlier usages have been replaced by com.yworks.yfiles.layout.organic.Scope. SphereOfAction.ALL has been mapped to Scope.ALL, SphereOfAction.MAINLY_SELECTION has been mapped to Scope.MAINLY_SUBSET and SphereOfAction.ONLY_SELECTION has been mapped to Scope.SUBSET.
  • OrganicLayouter: The data provider key SphereOfActionNodesDpKey has been renamed to AffectedNodesDpKey.
  • OrganicLayouter: Property SphereOfAction has been renamed to Scope and is now of type com.yworks.yfiles.layout.organic.Scope.
  • ShuffleLayouter: The data provider key MinimalDistanceDpKey has been renamed to MinimalNodeDistanceDpKey.
  • SmartOrganicLayouter: The data provider key NodeSubsetDpKey has been renamed to AffectedNodesDpKey.
  • SmartOrganicLayouter: Data provider registered with the key GroupNodeModeDpKey now have to return values of the new com.yworks.yfiles.layout.organic.GroupNodeMode enum.
  • SplitEdgeLayoutStage: Property SplitEdgesDpKey has been renamed to AffectedEdgesDpKey.
  • ParallelEdgeLayouter: The data provider key ScopeDpKey has been renamed to AffectedEdgesDpKey.
  • PartialLayouter: The data provider key PartialNodesDpKey has been renamed to AffectedNodesDpKey.
  • PartialLayouter: The data provider key PartialEdgesDpKey has been renamed to AffectedEdgesDpKey.
  • PartialLayouter: The data provider key ComponentAssignmentDpKey has been renamed to ComponentIdDpKey.
  • PartitionLayouter.OrthogonalInterEdgeRouter: Property SelectedEdgesDpKey has been renamed to AffectedEdgesDpKey.
  • PartitionLayouter.PolylineInterEdgeRouter: Property SelectedEdgesDpKey has been renamed to AffectedEdgesDpKey.
  • PortCandidate: The data provider key SourcePcListDpKey has been renamed to SourcePortCandidateCollectionDpKey.
  • PortCandidate: The data provider key TargetPcListDpKey has been renamed to TargetPortCandidateCollectionDpKey.
  • PortCandidateSet: The data provider key NodeDpKey has been renamed to NodePortCandidateSetDpKey.
  • com.yworks.yfiles.layout.radial.CenterNodesPolicy: Enum type Selection has been renamed to Custom.
  • BusRouter: The data provider key EdgeSubsetDpKey has been renamed to AffectedEdgesDefaultDpKey.
  • BusRouter: Property SelectedEdgesDpKey has been renamed to AffectedEdgesDpKey.
  • CollinearBendHider: The data provider key SelectedEdgesDpKey has been renamed to AffectedEdgesDpKey.
  • The enum com.yworks.yfiles.layout.router.SphereOfAction has been removed. Earlier usages have been replaced by com.yworks.yfiles.layout.router.Scope. SphereOfAction.ROUTE_ALL_EDGES has been mapped to Scope.ALL, SphereOfAction.ROUTE_SELECTED_EDGES has been mapped to Scope.SUBSET and SphereOfAction.ROUTE_EDGES_AT_SELECTED_NODES has been mapped to the new enum value Scope.SUBSET_AT_AFFECTED_NODES.
  • OrganicEdgeRouter: The data provider key RouteEdgeDpKey has been renamed to AffectedEdgesDpKey.
  • OrthogonalEdgeRouter: Property SelectedNodesDpKey has been renamed to AffectedNodesDpKey.
  • OrthogonalEdgeRouter: Property SelectedEdgesDpKey has been renamed to AffectedEdgesDpKey.
  • OrthogonalEdgeRouter: Property SphereOfAction has been renamed to Scope and is now of type com.yworks.yfiles.layout.router.Scope.
  • com.yworks.yfiles.layout.router.Polyline.EdgeRouter: The data provider key LabelCrossingCostFactorDpKey has been renamed to LabelCrossingPenaltyFactorDpKey.
  • com.yworks.yfiles.layout.router.Polyline.EdgeRouter: Property SphereOfAction has been renamed to Scope and is now of type com.yworks.yfiles.layout.router.Scope.
  • com.yworks.yfiles.layout.router.Polyline.EdgeRouter: Property SelectedNodesDpKey has been renamed to AffectedNodesDpKey.
  • com.yworks.yfiles.layout.router.Polyline.EdgeRouter: Property SelectedEdgesDpKey has been renamed to AffectedEdgesDpKey.
  • com.yworks.yfiles.layout.router.Polyline.EdgeRouter: Method IsSelected has been renamed to IsAffected.
  • PolylineLayoutStage: Property SphereOfAction has been renamed to Scope and is now of type com.yworks.yfiles.layout.router.Scope.
  • PolylineLayoutStage: Property SelectedNodesDpKey has been renamed to AffectedNodesDpKey.
  • PolylineLayoutStage: Property SelectedEdgesDpKey has been renamed to AffectedEdgesDpKey.
  • StraightLineEdgeRouter: Property SphereOfAction has been renamed to Scope and is now of type com.yworks.yfiles.layout.router.Scope.
  • StraightLineEdgeRouter: Property SelectedNodesDpKey has been renamed to AffectedNodesDpKey.
  • StraightLineEdgeRouter: Property SelectedEdgesDpKey has been renamed to AffectedEdgesDpKey.
  • SubgraphLayouter: Property SubgraphNodesDpKey has been renamed to AffectedNodesDpKey.
  • ARTreeLayouter: The data provider key RatioDpKey has been renamed to SubtreeAspectRatioDpKey.
  • ARTreeLayouter: Data provider registered with the key RootPlacementDpKey now have to return values of the new com.yworks.yfiles.layout.tree.RootPlacement enum.
  • ARTreeLayouter: The data provider key RoutingPolicyDpKey has been renamed to SubtreeRoutingPolicyDpKey and data provider registered with this key now have to return values of the new com.yworks.yfiles.layout.tree.RoutingPolicy enum.
  • ARTreeLayouter: Method GetRoutingPolicy now returns a RoutingPolicy enum value.
  • ARTreeLayouter: Method GetRootPlacement now returns a RootPlacement enum value.
  • ARTreeLayouter: Property RoutingPolicy is now of the type RoutingPolicy.
  • ARTreeLayouter: Property RootPlacement is now of the type RootPlacement.
  • AssistantPlacer: The data provider key AssistantDpKey has been renamed to AssistantNodeDpKey.
  • DelegatingNodePlacer: The data provider key LeftRightDpKey has been renamed to PrimaryNodesDpKey.
  • DelegatingNodePlacer: Method GetUpperLeftChildren has been renamed to PrimaryChildren.
  • DelegatingNodePlacer: Method GetLowerRightChildren has been renamed to SecondaryChildren.
  • DelegatingNodePlacer: Property PlacerUpperLeft has been renamed to PrimaryPlacer.
  • DelegatingNodePlacer: Property PlacerLowerRight has been renamed to SecondaryPlacer.
  • com.yworks.yfiles.layout.tree.InterleavedMode: Enum type SelectedNodes has been renamed to MarkedNodes.
  • GenericTreeLayouter: The data provider key ChildComparatorDpKey has been renamed to OutEdgeComparerDpKey.
  • GridNodePlacer: The data provider key GridDpKey has been renamed to RowIndexDpKey.
  • LeftRightPlacer: The data provider key LeftRightDpKey has been renamed to LeftNodeDpKey.
  • NodeOrderComparator: The data provider key NodeOrderDpKey has been renamed to NodeOrderComparableDpKey.
  • Class HierarchicTreePlacer has been renamed to HierarchicTreeNodePlacer.
  • Class ParallelEdgeLayouter has been renamed to ParallelEdgeRouter.
  • Class ReducedSphereOfActionStage has been renamed to ReducedScopeStage.
  • Class SelfLoopLayouter has been renamed to SelfLoopRouter.
  • Class AssistantPlacer has been renamed to AssistantNodePlacer.
  • Class BusPlacer has been renamed to BusNodePlacer.
  • Class DendrogramPlacer has been renamed to DendrogramNodePlacer.
  • Class DoubleLinePlacer has been renamed to DoubleLineNodePlacer.
  • Class FreePlacer has been renamed to FreeNodePlacer.
  • Class LeafPlacer has been renamed to LeafNodePlacer.
  • Class LeftRightPlacer has been renamed to LeftRightNodePlacer.
  • EdgeLabelLayoutImpl: obsolete property PreferredPlacement has been removed.
  • com.yworks.yfiles.layout.hierarchic.EdgeLayoutDescriptor: obsolete property OrthogonallyRouted has been removed.
  • WeightedLayerer: deprecated method AssignNodeLayer has been removed.
  • LabelingBase: deprecated property UseAlternativeSideHandling has been removed.
  • LabelLayoutData: deprecated constructors LabelLayoutData(double,double,LabelPlacements) and LabelLayoutData(YOrientedRectangle,LabelPlacements) has been removed.
  • LabelLayoutData: obsolete property PreferredPlacement has been removed.
  • OrthogonalLayouter: obsolete properties NodeModel and UseSpacePostprocessing have been removed.
  • PortConstraint: the deprecated constructors have been removed.
  • CanvasObjectDescriptor: deprecated fields Paintable and DynamicDirtyPaintable have been removed.
  • TapInputMode: deprecated property DoubleTap has been removed.
  • LayoutExtensions: deprecated extension method CreateLayerConstraintFactory has been removed.

Demos

  • Added a demo that shows how to model a Business Process Diagram editor using customized styles and layout algorithms.
  • Added a demo that presents different layout algorithms and their configuration properties.
  • Added a demo that shows how to extend the export capabilities of yFiles for JavaFX with third-party libraries to export a graph in the SVG format.
  • Added a demo that presents the various events dispatched by the model and the input modes that can be listened to.

Bugfixes

Viewer

  • A bug in orthogonal edge editing was fixed where an edge could become non-orthogonal when a non-selected bend was moved.
  • Fixed an issue with orthogonal edge editing where canceling moving a port or node would add bends to otherwise straight edge segments.
  • Fixed an issue where moving edge ports of a self-loop could break edge orthogonality despite orthogonal edge editing.
  • Fixed a bug that prevented individually disabling certain grouping commands.
  • Fixed a bug with folding that sometimes ignored the view state for a port on a folder node when a folding edge was created.
  • A bug in OverviewInputMode has been fixed that could break the overview visualization if the overview has a specific very small width or height.
  • Fixed a potential exception when using folding on a filtered graph when either nodes with labels or ports, or edges with bends or labels are shown for the first time after being hidden before.
  • Fixed an issue where setting a BridgeManager on the RenderContextEvent had no effect and bridges would not show.
  • Fixed an issue where setting a custom Pen for a grid with GridStyle.DOTS had no effect.
  • Fixed incorrect rendering of grids for viewports with aspect ratios smaller than 1.
  • Removed remaining dependencies to AWT classes.
  • Fixed a bug in OverviewInputMode that could break the overview visualization if the overview has a specific very small width or height. This was for example the case when using a GraphOverviewControl in a TitledPane that was collapsed/expanded in an animated fashion.
  • Fixed NullPointerException that occurred when calling the GraphOverviewControl's constructor with a new GraphControl as argument.
  • Properties StripeDefaults#Insets and SimpleLabelStyle#TextFormat have default values that are intended to be shareable but were mutable which could lead to unwanted side effects. The default values for those properties have been made immutable.
  • SimpleLabelStyleRenderer: Fixed a bug that caused the border of the label to be clipped away sometimes.
  • Fixed a bug that prevents disabling the snapping feature by pressing the control key when moving or resizing nodes or creating edges interactively.
  • Changing the zoom level by mouse wheel is now the same on all systems.
  • Added missing shortcuts for the open (Shortcut+O) and save (Shortcut+S) commands.
  • Fixed a ClassCastException that occurs when the CollapsibleNodeStyleDecoratorRenderer specifies a collapse button that is not a JavaFX Button instance.
  • Fixed an issue that prevented saving and loading graphs with table nodes.
  • PixelImageExporter: fixed a bug that prevented CSS styling to be applied to the exported image.
  • MouseHoverInputMode: fixed a NullPointerException that sometimes occured when trying to hide a tooltip.

Layout

  • HierarchicLayout: Fixed rare bug that caused same-layer edge to cross through their source or target node, e.g., the port was at the top of the source node but the edge crossed through the source node to leave it at the bottom.
  • HierarchicLayout: Fixed bug that sometimes caused the route of back-loop edges with at least one endpoint incident to a group node to unnecessarily enter this group node.
  • SimplexNodePlacer: Fixed bug that caused overlaps between edges and nodes when enabling node compaction (#setNodeCompactionEnabled(boolean)) and having edges with either strong PortConstraints or fixed PortCandidates.
  • HierarchicLayout: Fixed bug that caused a violation of minimum first/last segment length for backloop/reversed edges that connect to group nodes.
  • HierarchicLayout: Fixed rare bug that caused overlaps between labels and segments of edges with octilinear routes.
  • HierarchicLayout: fixed possible infinite loop if there are critical edges (see #CRITICAL_EDGE_DPKEY).
  • HierarchicLayout: Fixed bug that caused critical edges to not be aligned (see #CRITICAL_EDGE_DPKEY).
  • HierarchicLayout: Fixed rare NullPointerException triggered in AsIsSequencer for edges incident to group nodes that have a sketch without bend points as well as port constraints.
  • HierarchicLayout: Fixed bug that caused non-orthogonal segments of grouped edges even though orthogonal edge routing was enabled.
  • HierarchicLayout: Improved compactness of layouts that feature group nodes with insets and (group) nodes with halos (NodeHalo). Previously, specifying halos could enlarge the insets of group nodes by an unnecessary large amount.
  • HierarchicLayout: Fixed bug that caused a violation of the specified minimum distance or edge overlaps in the case of same-layer edges.
  • HierarchicLayout: Fixed NullPointerException that could happen in AsIsSequencer when incremental group hints are defined (see IncrementalHintsFactory#createIncrementalGroupHint(java.lang.Object)) along with specific port constraints on edges incident to an incremental group node.
  • HierarchicLayout: Improved result if compact label placement is enabled (which is the default), see SimplexNodePlacer#setLabelCompactionEnabled(boolean). In previous versions the labels may have been placed in a stacked style even if this did not make the result more compact (e.g. if all labels are placed to the right of the edges).
  • HierarchicLayout: Fixed distance between vertical (in a top-to-bottom layout) segments of same-layer edges that connect to group nodes. This also applies to self-loops that connect to the top or bottom of a group node with both ends as well as same-layer parts of other edges like backloops.
  • HierarchicLayout: Fixed bug that caused the minimum edge-to-edge distance to be violated by edges with strong port constraints that cross each other.
  • Fixed IllegalArgumentException that is triggered in some cases when using a SequenceConstraintFactory.
  • RecursiveGroupLayout when used with HierarchicLayout as core layout algorithm: Fixed IllegalStateException that could be triggered when group nodes of the input graph have PortCandidates.
  • OrganicLayout now temporarily hides DataProviders which are registered by the user with keys that are related to RecursiveGroupLayout and #LayoutMultiplexer since their presence during the layout process may cause corrupted results.
  • PartialLayout: fixed NullPointerException that appeared if no DataProvider with key PartialLayouter#PARTIAL_NODES_DPKEY is registered with the input graph.
  • GraphPartitionManager: fixed functionality to hide edges when using methods GraphPartitionManager#hide(Edge), GraphPartitionManager#hideEdges(), GraphPartitionManager#hide(EdgeCursor) or GraphPartitionManager#hide(EdgeList). Previously, edges were actually not hidden from the graph.
  • ParallelEdgeRouter: Fixed bug that caused wrong (very large) edge port coordinates. These coordinates could also lead to Exceptions later when processing the graph, for example, when calculating placements of edge labels belonging to the edges with bad coordinates.
  • TreeLayout: fixed possible group node overlaps in conjunction with some node placers, for example AssistantNodePlacer.
  • TreeLayout: fixed bug that caused less compact layout results when having node halos (see NodeHalo).
  • TreeLayout: Fixed bug that caused edges which are reversed during the layout and have a port constraint only to one endpoint (e.g., source) to obtain the same port constraint also to the other endpoint (e.g., target).
  • EdgeRouter: Fixed rare RuntimeException that appeared if there were fixed (see EdgeRouter#setSphereOfAction(byte)) and grouped edges at the same time.
  • EdgeRouter: Fixed possible NullPointerException that may appear if a specified PortCandidate has multiple directions.
  • ChannelEdgeRouter: Fixed routing of self-loops that have both source and target end point at the same side of the node. Previously, when multiple such self-loops were present at the same node, the routing produced bad end points located outside of the node.
  • BusRouter: Fixed rare IllegalStateException caused by non-orthogonal edge segments.
  • Groups#hierarchicalClustering(Graph, int, INodeMap,INodeDistanceProvider, Linkage): Fixed NullPointerException that occurred when the given maximum number of clusters was 0 or 1.
  • HierarchicLayout: Fixed bug that caused grouped edge segments to overlap with one of the adjacent nodes if it is a group node.
  • HierarchicLayout: Fixed bug that caused same layer segments to be too short for the labels that should be placed at those segments.
  • HierarchicLayout: Fixed bug that caused a violation of minimum first/last segment length for edges that connect two neighboring nodes in the same layer.
  • HierarchicLayout: Fixed bug that caused a violation of minimum first/last segment length for edges that connect to group nodes. Now, the first/last segments of those edges will have at least the length of the largest minimum first/last segment length of all edges connected to the same group node.
  • HierarchicLayout: Fixed rare IllegalStateException that is caused by an inconsistent group node order that may appear for input graphs containing both swimlanes and groups.
  • HierarchicLayout: Fixed bug with some ignored any side strong port constraints.
  • HierarchicLayout: Fixed bug that caused PortCandidates to potentially be ignored or not handled correctly for self-loops when having directions other than PortCandidate.NORTH, PortCandidate.SOUTH, PortCandidate.WEST or PortCandidate.EAST
  • EdgeRouter: Fixed bug that caused edges routed by the EdgeRouter to sometimes share the same port with edges defined as fixed.
  • EdgeRouter: Fixed bug that caused violations of the node to edge distance between an edge and its target if the edge approaches the target from the opposite side of the target port constraint.
  • EdgeRouter: Fixed bug that caused incorrect routes for grouped edges with intersecting source and target.
  • EdgeRouter: Fixed rare NullPointerException that may appear during rerouting of edges (see EdgeRouter.setReroutingEnabled(boolean)) if the input graph contains overlapping nodes.
  • EdgeRouter: Fixed possible NullPointerException that may appear if there are grouped edges consisting of both fixed and non-fixed edges (see EdgeRouter.setScope(Scope)).
  • EdgeRouter: Fixed bug that may cause that some edges are not considered during rerouting. It only appears if the graph contains grouped edges.
  • EdgeRouter: Fixed rare bug that may cause a StackOverflowError.
  • GenericLabeling: Improved placement of edge labels with preferred placement at source/target if the label model FreeEdgeLabelModel.
  • GenericLabeling: Fixed bug that may cause that the postprocessing step ignores some node labels with model FreeNodeLabelModel.
  • Directed style of the OrthogonalLayout: Fixed problem that may cause non-directed routes for directed edges if option OrthogonalLayout.setAlignDegreeOneNodesEnabled(boolean) is enabled.
  • MultiPageLayout: Fixed possible NullPointerException that may appear if an internal layouter queries a DataProvider for an inserted dummy node.
  • CircularLayout: Fixed a bug that could potentially cause an infinite loop when encountering a node with a very high out-degree.
  • CircularLayout: Fixed bug that caused nodes to be placed outside of the enclosing circle when using layout style SINGLE_CYCLE and partition layout style PARTITION_LAYOUTSTYLE_ORGANIC.
  • ParallelEdgeRouter: Fixed possible NullPointerException that may appear if the parallel edge is almost horizontal/vertical.
  • PortCandidateAssignmentStage: Fixed bug that caused the location of strong port constraints to be ignored when using this stage together with a layout algorithm that cannot handle port constraints.
  • RemoveCollinearBendsStage: Now coincident bend points can also be removed since they produced edge segments of very small length and, thus, in some layout algorithms caused label placement failures.
  • FamilyTreeLayout: Fixed handling of grouping DataProviders so they are not changed by the layout algorithm.
  • FamilyTreeLayout: Fixed possible NullPointerException that may appear if the input graph contains group nodes.
  • HierarchicLayout: Fixed IllegalStateException that may appear in incremental layout mode if there are group nodes that contain non-incremental elements.
  • HierarchicLayout: Fixed bug that may cause an incorrect order of elements if the graph contains sequence constraints.
  • HierarchicLayout: Fixed problem that may cause a very long runtime if the layouter is applied in incremental mode and the graph contains sequence constraints.
  • HierarchicLayout: Fixed bug that caused that the layer of an incremental group (see IncrementalHintsFactory.createIncrementalGroupHint(Object)) depends on the group's location if recursive layering is enabled (see IncrementalHierarchicLayouter.setRecursiveGroupLayeringEnabled(boolean)). However, the position of incremental groups should be freely chosen by the layouter.
  • HierarchicLayout: fixed orientation of edge labels on selfloops connected to a group node.
  • HierarchicLayout: Fixed NullPointerException that occurred if an incremental group node has only incremental descendants.
  • HierarchicLayout: Fixed problem that caused bad results when assigning top or bottom layer constraints (i.e., LayerConstraintFactory.addPlaceNodeAtTopConstraint(Object) or LayerConstraintFactory#addPlaceNodeAtBottomConstraint(Object)) to fixed elements.
  • HierarchicLayout: Fixed bug that caused collinear bends in some edge routes.
  • HierarchicLayout: Fixed bug that caused the maximum duration values specified for Layerer, Sequencer and NodePlacer to be overridden and not considered during the hierarchic layout.
  • EdgeRouter: Fixed bug that caused violations of the minimum first or last segment length for target grouped edges. This only happened when these distances were defined in the default EdgeLayoutDescriptor instead of a DataProvider with individual descriptors.
  • EdgeRouter: Fixed side handling of external strong ports.
  • EdgeRouter: Fixed rare NullPointerException that may occur for graphs where only a subset of edges is routed, see EdgeRouter.setScope(Scope).
  • SimplexNodePlacer: fixed bug that disabled label compaction feature.
  • BalloonLayout: Fixed bug that caused BalloonLayout.CHILD_ORDERING_POLICY_SYMMETRIC not to work as desired.
  • AssistantNodePlacer: fixed placement of assistant nodes. When all children of a node are assistants, they are all placed left/right.
  • ClassicTreeLayout: Fixed StackOverflowError occurred in trees with high depth.
  • TreeLayout: Fixed root alignments to only take the child node bounds into account without considering edge segments in the subtree.
  • DelegatingNodePlacer: Constants DelegatingNodePlacer.VERTICAL and DelegatingNodePlacer.HORIZONTAL along with methods DelegatingNodePlacer.setOrientation(Orientation) and DelegatingNodePlacer#getOrientation() are deprecated since they had no effect.
  • Trees: fixed method getCenterRoot(Graph) that didn't always return the correct center node of a tree.
  • ClassicOrganicLayout: Fixed bug that caused tree-beautifier feature (see ClassicOrganicLayout#setActivateTreeBeautifier(boolean)) to have no effect if activated when the graph is actually flat (i.e., there is no group node that contains child nodes) but data providers for groups (see GroupingKeys) are registered with the graph.
  • CircularLayout: Fixed bug that may cause node overlaps.
  • SplitEdgeStage: Fixed bug that caused the user's selection for edges that have to be split to be ignored. Also, fixed bug that caused an IllegalArgumentException because of nodes with zero width/height.
  • ShortestPaths: Fixed NullPointerException that occurred when applying the Dijkstra or Bellman-Ford algorithm to an empty graph.
  • HierarchicLayout: Fixed label placement for octilinear selfloops with the same side constraints for source and target port.
  • HierarchicLayout: Fixed routing style violations in octilinear grouped edges.
  • HierarchicLayout: Fixed NullPointerException that could occur when octilinear edges are attached to group nodes.
  • HierarchicLayout: Fixed bug that caused first or last segments of edges to be too short to span all associated labels.
  • HierarchicLayout and RankAssignments: Fixed possible NullPointerException that may occur if the maximal duration of the algorithm is limited.
  • HierarchicLayout: Fixed bug that may cause overlaps of edge labels with preferred placement at source/target.
  • HierarchicLayout: Fixed rare IllegalStateException that may appear for grouped graphs containing nodes with fixed coordinates hint (see, e.g., IncrementalHintsFactory#createUseExactCoordinatesHint(Object)).
  • HierarchicLayout: Fixed bug that breaks incremental hints of grouped edges in incremental layout mode. (see IncrementalHintsFactory#createSequenceIncrementallyHint(Object)).
  • HierarchicLayout: Fixed bug that may cause an incorrect order of fixed (non-incremental) elements if the layouter is applied in incremental mode and the graph contains sequence constraints.
  • OrthogonalLayout: Fixed bug that caused an IllegalArgumentException if data provider key PortConstraintKeys#SOURCE_GROUPID_KEY is registered to the input graph but data provider key PortConstraintKeys#TARGET_GROUPID_KEY is not registered.
  • OrthogonalLayout: Fixed possible IllegalArgumentException caused by nodes without node IDs. This problem may only appear if the inter edge router is set to PartitionLayout.ChannelInterEdgeRouter.
  • ClassicTreeLayout: Fixed bug that may cause a ClassCastException if the input graph is a CopiedLayoutGraph that consists of multiple connected components and the layouter uses the LayeredNodePlacer (e.g., if property ClassicTreeLayout.setLeafPlacement(LeafPlacement) is set to ClassicTreeLayout.ALL_LEAVES_ON_SAME_LAYER).
  • DoubleLineNodePlacer: Fixed the distance between the local root and the upper line to match the specified spacing. The distance between the two lines can now be defined in relation to the spacing.
  • TreeReductionStage: Fixed wrong handling of group nodes which may cause a WrongGraphStructure exception as well as broken routes of edges incident to group nodes.
  • SimpleNodePlacer: Fixed broken edge routes that may appear for edges on nodes with external labels if integrated node labeling is enabled.
  • MultiPageLayout: Fixed bug that caused that an AbortHandler attached to the input graph was ignored.
  • MultiPageLayout: Fixed NullPointerException that may occur if the edge ID data provider (see MultiPageLayout.EDGE_ID_DPKEY is an instance of IEdgeMap.
  • MultiPageLayout: Fixed bug that may cause non-orthogonal edge routes.
  • ComponentLayout: Fixed bug that caused an ArrayIndexOutOfBoundsException if the style is set to ComponentArrangementStyles.MULTI_ROWS_HEIGHT_CONSTRAINT or ComponentArrangementStyles#MULTI_ROWS_HEIGHT_CONSTRAINED_COMPACT (see ComponentLayout.setStyle(ComponentArrangementStyles)) and all components exceed the preferred height (see ComponentLayout.setPreferredLayoutSize(double, double)).
  • PortCandidateSet: Fixed bug that caused method PortCandidateSet.CandidateMatcher.findMatchingCandidate() to return the entry with the highest cost instead of the lowest cost if the candidate matcher is created with method PortCandidateSet.createMatcher().
  • CopiedLayoutGraph: Fixed NullPointerException that occurs when nodes or edges are added to the copied graph without removing them before calling commitLayoutToOriginalGraph().
  • CopiedLayoutGraph: Fixed problem that may cause movement of label boxes in the original graph even if method CopiedLayoutGraph.commitLayoutToOriginalGraph() is not called.
  • BorderLine: Fixed bug in method grow(double, double, boolean) that may produce an IllegalArgumentException because the min value of a BorderLine becomes greater than its max value.
  • PartialLayout: Fixed bug that may cause broken edge routes for edges incident to incremental group nodes if option setImmediateInterEdgeRoutingEnabled(boolean) is enabled.
  • EdgeRouter: Fixed rare NullPointerException that mainly appears if there are overlapping nodes.
  • EdgeRouter: Fixed bug that may cause zero length routes of edges whose start and end point are at the same location.
  • AbstractLabeling: Fixed bug that may cause removal of labels that don't overlap with other elements if option setNodeOverlapsRemovalEnabled(boolean) is enabled.