Version 4.0 is the latest major release for yFiles for Java (Swing).
See the changelog for a list of all changes in this and all other versions.
Below you will find the technical requirements and a list of all new features and improvements.
Building applications based on yFiles for Java (Swing) requires the Java SE Development Kit 8 or newer.
This version brings a major overhaul of many parts of the API, resulting in a lot of incompatible changes. We have designed many functions to be simpler, more intuitive and more consistent and removed technical debt. In addition, this release contains numerous new features, improvements, and bug fixes to all parts of the library.
Categories: General Graph GraphBuilder Components Rendering Selection, Focus, Highlight Styles Interaction Label Editing Snapping Clipboard Folding GraphML Demos View-Layout-Bridge Layout Hierarchical Layout Tree Layout Orthogonal Layout Edge Router Labeling Organic Layout Circular Layout Radial Layout Radial Tree Layout Alignment Stage Series-parallel Layout Clear Area Layout Multi-page Layout Partial Layout Tabular Layout Component Layout Algorithms Analysis Geometry
IEventArgs interface that all yFiles *EventArgs classes inherited from has
been removed. Instead, the *EventArgs classes now extend java.util.EventObject.EventObject takes the event source as parameter and provides it as property, all constructors
now take the event source as first parameter.IEventListener interface now extends java.util.EventListener and the event source
parameter has been removed from its onEvent method.LookupDecorator class is now
easier to use, but most use cases are covered without having to access the low-level lookup architecture.
null.
IGraph#getEdgesBetween method returns all edges between two ports or port
owners.
CompositeLabelModel now cannot only combine label models but also individual label
model parameters or a mix of both kinds. Furthermore, it supports assigning a profit value to a parameter or model
that can be used when placing labels during an automatic layout.
CompositeLabelModel#addParameter method wraps a given parameter of one of
the composed label models.
IGraph now check consistently whether given geometric arguments are
neither infinite nor NaN.
OrientedRectangle, NodeLabel,
EdgeLabel and FreeEdgeLabelModel is now clockwise to be
consistent with the other models.
ExteriorLabelModel, InteriorLabelModel,
and InteriorStretchLabelModel have been renamed to ExteriorNodeLabelModel, InteriorNodeLabelModel, and StretchNodeLabelModel, respectively, to make it clear that only nodes are supported as
label owner for these models.
ILabelModelParameter and IPortLocationModelParameter used by the ILabelModel and
IPortLocationModel classes are now public and provide all properties necessary to
recreate them on the models. Consequently, the static LabelModelParameterSerializer
and PortLocationModelParameterSerializer classes, which could be used to retrieve
those properties and recreate the parameter, have been removed.
ILabelModel parameter of the ILabelModelParameterFinder#findBestParameter and ILabelModelParameterProvider#getParameters methods has been removed as it was only very
rarely required.
GraphCopier API has been enhanced to offer improved clarity and functionality.
GraphCopier has been optimized since its support for the GraphClipboard has been removed.
GraphCopier#copy method now uses an IStreamIterable of items to define the subset to copy.
SimpleNode, SimpleEdge, SimpleBend, SimpleLabel, and SimplePort classes now provide a convenience LookupDecorator
instance through the getDecorator method.
ILabelModel#createDefaultParameter method and most of its implementations have
been removed as it was often unclear what “default” meant. Most label models already had a corresponding
Create*Parameter method. For the remaining models, the GroupNodeLabelModel#createTabParameter method and the FreeNodeLabelModel#CENTER and FreePortLabelModel#CENTER
fields have been added.
null. This affects IEdge#SourcePort, IEdge#TargetPort, ILabel#Owner, IPort#Owner, and IBend#Owner.
IGraph#groupNodes method now has overloads with additional parameters that
specify the Style and Tag of the newly
created group.
EdgePathLabelModel and EdgeSegmentLabelModel have been
improved to provide better placements with edge-cases where the path is too short for the label or degenerates
completely.
GroupNodeLabelModel no longer triggers an IllegalArgumentException when used with / set for a node that does not use GroupNodeStyle. GroupNodeLabelModel is still not intended to
be used with nodes that do not use GroupNodeStyle. This restriction has been lifted to
support workflows where the node style is set to GroupNodeStyle after the label model
is set to GroupNodeLabelModel.
FreeNodePortLocationModel have been renamed analogue to
the static parameter fields in InteriorNodeLabelModel.
FilteredGraphWrapper now supports changing the node and edge predicates after
creation.
PropertyChanged event on the UndoEngine
class is now also emitted if the token is changed.
YList#addFirst and YList#addLast have
been renamed to push and pushLast, so they don't conflict with
the default methodsList#addFirst and addLast
that have been added with JDK 21.
ILabelOwner.getLabels().contains and IPortOwner.getPorts().contains implementations. Previously, these methods returned true for all
labels/ports in the owner's graph instead of only for labels/ports belonging to the owner.
EdgeSegmentLabelModel and EdgePathLabelModel which caused a gap in supported positions close to the source and
target node.
EdgeSegmentLabelModel and SmartEdgeLabelModel classes, label placement at source and target nodes is now correct
when an index is specified that is less than zero or greater than the number of bends of the edge.
EdgeSegmentLabelModel class now calculates valid label locations for selfloop
paths with one port at the side of the node.
EdgeSegmentLabelModel class now calculates valid label locations for paths with
duplicate bends, i.e., paths in which two or more consecutive bends have the same location.
GraphClipboard now properly respects ParentNodeDetection mode for sub trees.
GraphClipboard's ParentNodeDetection now can use
ParentNodeDetectionModes#NONE as fallback if no valid parent is found for modes
ParentNodeDetectionModes#SELECTION or ParentNodeDetectionModes#PREVIOUS_PARENT.
NullPointerException that occured when removing highlighted edges from their
graph.
HighlightIndicatorManager that occurred when removing highlighted
model items from their graph.
NinePositionsEdgeLabelModel center placements above and below the edge have been
improved when the angle wasn't close to one of the two coordinate axes and the distance was non-zero. Previously,
labels could seem to jump around when the path changed and weren't always close to the center of the path.
GroupNodeLabelModel no longer stretches tab labels and tab background labels into the
collapse/expand icon of the corresponding GroupNodeStyle.
GroupingSupport's methods enlargeGroupNode and enlargeAllGroupNodes do not create empty undo units anymore if nothing has changed.
NavigationInputMode#expandGroup and NavigationInputMode#enterGroup, as well as the Command#EXPAND_GROUP and Command#ENTER_GROUP commands do
not create empty undo units anymore if nothing has changed.
NavigationInputMode#exitGroup and the Command#EXIT_GROUP command now create undo units if the bounds of the exited group node
were adjusted.
NodeCreator#getUpdatedStyle, EdgeCreator#getUpdatedStyle, and LabelCreator#getUpdatedStyle methods now uses the default style from the graph as
fallback if the style provider is not set.
LabelCreator#getUpdatedLayoutParameter method now uses the default layout
parameter from the graph as fallback if the layout parameter provider is not set.
NodeCreator, EdgeCreator, and LabelCreator classes can now be used without a GraphBuilder.
This enables developers to apply styles and labels from a data object in cases where a GraphBuilder is not suitable for graph creation.
NodesSource now allows for recursive definition of child nodes in a grouping
hierarchy. The new methods addChildNodesSource and createChildNodesSource allow for defining a source to fetch child node items from a node
data item.
NodesSource now allows for implicit definition of parent nodes in a grouping
hierarchy. The new methods addParentNodesSource and createParentNodesSource allow for defining a source to fetch a parent node item from a
node data item.
GraphOverviewComponent has been improved to be
more in sync with the rendering order in the corresponding GraphComponent.
GraphOverviewComponent now uses its ContentGroup
instead of the RootGroup to add the visualization of its graph content. This
makes it easier to customize the overview for example by adding a background visual.
GraphModelManager#LabelLayerPolicy property, which defines whether labels should
be rendered at their owner or in a separate layer, has been split into three separate properties NodeLabelLayerPolicy, EdgeLabelLayerPolicy,
and PortLabelLayerPolicy to support different policies for node, edge, and
port labels.
SelectionModelChanged event of GraphComponent is raised when the model managing the selection is changed itself, not when
the selected items change.
VisualGroup instances) now works consistently. Previously, they may sometimes never have
appeared.
ViewportLimiter now also works with isometric projections and offers options to use
the CanvasComponent#ContentBounds for the limiting. It now offers the possibility to
specify margins in the view coordinate system around the specified bounds, and bounds can be given as a list of
convex polygon points. CanvasComponent now also notifies the viewport limiter when the
size of the ContentBounds or the size of the CanvasComponent changes.
CanvasComponent and GraphComponent now have a new scroll
bar design, as well as new behavior if either HorizontalScrollBarPolicy or
VerticalScrollBarPolicy is set to AS_NEEDED. The
new style is similar to system scrollbars in many operating systems, overlays the content and gets out of the way
when not needed or interacted with. These dynamic scroll bars can be disabled using a client property with key CanvasComponent#DISABLE_DYNAMIC_SCROLL_BARS.
GraphComponent now uses GraphViewerInputMode as the
default InputMode for basic graph exploration.
ICanvasContext#CanvasComponent property (and consequently IRenderContext and IInputModeContext) is now guaranteed to
have a non-null value.
IEventRecognizer constants can now be found in the same class, IEventRecognizer, which improves discoverability. In addition, their names now follow the
platform conventions, i.e. they are formulated in the present tense and use the same wording as corresponding input
events.CanvasComponent which are related to input devices
now have the same consistent names.
CanvasComponent#ContentRect property is now named ContentBounds to make its purpose more clear. The ContentRectUpdatingEnabled method has been renamed likewise.
CanvasComponent#setContentRect method has been removed in favor of
the setter of the ContentBounds property.
BridgeManager. This allows you to have
different types of bridges on different types of edges.
MouseWheelScrollFactor) have been increased to allow for faster scrolling.
CanvasComponent#HorizontalScrollEventRecognizer property allows customizing
switching from vertical to horizontal scrolling.
CanvasComponent: Animated viewport changes could lead to strange behavior if maximum
or minimum zoom were set and violated by the viewport change.
AbstractObjectRenderer class allows conveniently implementing the IObjectRenderer interface.
RenderTag to implementations of IObjectRenderer.
PortCandidateRenderTag class will be passed as render tag for port
candidates.
MarqueeRenderTag class will be passed as render tag for the marquee
rectangle renderer of the MarqueeSelectionInputMode class.
LassoRenderTag class will be passed as render tag for the lasso path
renderer of the LassoSelectionInputMode class. The new LassoPathState enum defines the current state of the lasso selection path in this
class.
LabelCandidateRenderTag class will be passed as render tag to the label
candidate renderer of the LabelPositionHandler.
IObjectRenderer#VOID_OBJECT_RENDERER constant provides a singleton renderer that renders
nothing.
Domain property on the HighlightIndicatorManager class matches the Domain
property on the SelectionIndicatorManager class and allows automatic removal of
highlights no longer present in the domain.
FocusIndicatorManager supports a new policy that will only show the keyboard focus
indicator, when the user is actually using the keyboard to manipulate the focus.
CompositeNodeStyle, CompositeEdgeStyle, CompositeLabelStyle, and CompositePortStyle classes.
DelegatingNodeStyle, DelegatingEdgeStyle, DelegatingLabelStyle, or DelegatingPortStyle class.
ShapePortStyle class displays ports as geometric shapes and supports the same
shapes as the ShapeNodeStyle class.
Arrow class now supports more types and features. In particular:
ArrowType#CHEVRON, ArrowType#DELTOID, and ArrowType#KITE.
PortDecorator#EdgePathCropper for this.
AbstractPathEdgeStyle class simplifies using a complex GeneralPath as the edge path of a style. Subclasses only have to create the path while the
style already handles the visualization, including placing arrows and bridges. Several callback methods can be
overridden to customize the behavior.
ShapeNodeStyle class now supports more shapes, namely PENTAGON, OCTAGON_STANDING, TRIANGLE_POINTING_LEFT, and TRIANGLE_POINTING_RIGHT.
These shapes are also available as TextWrappingShape.
GeneralPathNodeStyle class.
GroupNodeStyle now have more useful default port
candidates. Either four candidates, one in each cardinal direction, for group nodes with GroupNodeStyle. Or a single central port for folder nodes with a GroupNodeStyle.
CollapsibleNodeStyleDecorator class positions and styles the button now closer to
what GroupNodeStyle does to achieve a more modern look.
getLassoTestable method of the interfaces INodeStyleRenderer, IEdgeStyleRenderer, ILabelStyleRenderer, and IPortStyleRenderer is similar to
the existing getMarqueeTestable method, so marquee and lasso selection do no longer
differ in the ways the testable is retrieved.
ArrowEdgeStyle's bounds now are tightly enclosing the rendered shape. Before they
were too large.
ArcEdgeStyle, ArrowEdgeStyle, or
BridgeEdgeStyle are no longer shown when selecting these edges. Additionally, marquee
and lasso selection will not select these bends anymore even if they lie in the selection rectangle.
IconLabelStyle now has a default icon size of 24x24 instead of empty, such that
the icon is always visible.
GroupNodeStyle's tab width is set to 0, the tab width does not reduce the corner
radius of the style's outline anymore. However, it still forces the corner radius of the style's inner corners (i.e.
the corners of the content area on the side of the style's tab) to 0.
GroupNodeStyle's new MinimumContentAreaSize
property simplifies enforcing a minimum size for the content area a group node.
GroupNodeStyle offers the possibility to have its tab width grow (or shrink) depending
on the preferred size of associated tab and tab background labels.
GroupNodeStyle#RenderingTransparentContentAreaEnabled property controls
whether a semi-transparent ContentAreaPaint works as expected by showing what's behind
the group node.
ShapeNodeStyle now considers the pen thickness when rendering rectangle, round
rectangle and ellipse shapes, i.e. the pen is rendered half inside and half outside the node bounds, like for the
other shapes.
BasicStroke#CAP_BUTT as end line cap. Previously the
cap was changed to BasicStroke#CAP_SQUARE.
AbstractEdgeStyle, AbstractNodeStyle, AbstractLabelStyle,
AbstractPortStyle, and AbstractStripeStyle are now generic and take the subtype of
the IVisual that is returned by their createVisual and updateVisual methods
as generic type.
GroupNodeStyle's associated IGroupPaddingProvider now
correctly calculates insets for “small” nodes, i.e. nodes whose height (or width) is less than the style's TabHeight property.
BridgeEdgeStyle or
ArcEdgeStyle no longer disappears too early if the edge path is only partially in the
viewport.
RectangleNodeStyle has been corrected for some
previously failed instances that caused edges to end in midair or disappear.
ShapeNodeStyle, ArrowNodeStyle, GeneralPathNodeStyle, GroupNodeStyle, and RectangleNodeStyle.
ArcEdgeStyle, the three center positions of the NinePositionsEdgeLabelModel are now in the right places. Previously they were often way
off.
GroupNodeStyle's collapse/expand icon can now be reliably hit in all cases. In rare
cases, changing the value of one the properties that affect the icon's location were not taken into account for hit
tests.
GroupNodeStyle no longer renders a hairline in place of the tab when using a Pen with TabWidth 0.
LabelStyle now adds ellipsis more reliably at the end when the text does not fit into
the specified text wrapping shape.
ArrowEdgeStyle now correctly considers its visibility with thicknesses greater than
13.
Ctrl , Shift , or Alt modifier during
the gestures extends, subtracts or toggles the current selection with the elements in the marquee or lasse area.
IHitTester interface has been changed to support faster hit testing. The generic
type has been removed. Instead, a GraphItemTypes parameter has been added that is used
to reduce hit tests to the specified item types.
PointerLongPress event is raised when the mouse is pressed and stays
still for a configurable amount of time.
PointerLongRest event is raised when the pointer stays still for a
configurable amount of time during a move or drag gesture.
IInputMode which report creation of, changes to, or deletion of model
items now have arguments of type InputModeItemEventArgs or InputModeItemChangedEventArgs. This type provides the affected item and the IInputModeContext for the involved input mode.
Alt key can
now be pressed instead of the Ctrl key.
Ctrl key instead of the Alt key
can be pressed to keep the center of the reshaped node.
Ctrl key has to be pressed instead
of the Shift key.
Shift key while dragging the items.
GraphEditorInputMode#CreationSelectableItems property allows you to specify
GraphItemTypes which should be selected after creation.
CreateEdgeInputMode#EdgeDirectionReversed event and the new CreateEdgeInputMode#onEdgeDirectionReversed method are triggered when the direction of
the edge creation changed during edge creation.
HandleType#VOID enum value makes a handle invisible and excludes it from hit
testing.
CreateEdgeInputMode#MinimumSelfLoopBendCount property allows for specifying
the number of bends an edge must at least have before it can be created as selfloop.
CreateEdgeInputMode#ShowStartPortCandidateDelay property allows for
specifying a delay after which start port candidates are displayed when the user hovers over a start port candidate
owner.
GraphEditorInputMode#MovableUnselectedItems property allows for defining
items which can be moved without selecting them first. The MovableUnselectedItemsPredicate property can be used for closer specification.
Shift key while dragging the pointer.
GraphEditorInputMode#setNodeLocation method uses the IPositionHandler of a node to change its location, and this way also adjusts the attached
orthogonal edges and the position of child nodes if the given node is a group node.
CanvasComponent's event system is now based on the PointerEventArgs API instead of mouse events.
MoveInputMode class now also handles moving labels, thus the MoveLabelInputMode has been removed.
ItemsCopied on GraphViewerInputMode
and the events ItemsCopied, ItemsCut,
ItemsPasted, ItemsDuplicated, and DeletedSelection on GraphEditorInputMode now use
ItemsEventArgs providing the items that are the subjects of the events.
MoveViewportInputMode#Priority to 105 to make viewport
panning with CTRL or SPACE modifiers easier in dense graphs.
InputMode now corresponds to the
input mode's Priority. In other words, visualizations of input modes with a
smaller priority value (= higher priority) are drawn on top.
GraphViewerInputMode#findItems and GraphEditorInputMode#findItems methods now consider the actual z-order of the hit items.
GraphViewerInputMode#ItemClicked and GraphEditorInputMode#ItemClicked events and the cyclic selection now consider the actual
z-order of the hit items at the cursor location. Bends and invisible ports are now properly taken into account and
hit before their owners.
PointerEventArgs#Handled property has been added that can be used to set and
detect if another listener already handled the event.
MoveViewportInputMode now gracefully handles concurrent programmatic viewport
modifications.
ILabelModelParameterFinder during label movement can now be
changed with the LabelPositionHandler#UseParameterFinderRecognizer property.
ClickInputMode#Clicked event is now raised also for double-clicks and
multi-clicks. Clicking multiple times in the same location increments the ClickEventArgs#ClickCount by one for each click.
MoveInputMode and MoveUnselectedInputMode
properties of GraphEditorInputMode have been renamed to MoveSelectedItemsInputMode and MoveUnselectedItemsInputMode to better describe what they are used for. Associated
properties and methods have been renamed accordingly.
Ctrl+Space now prefers toggling the selection state of GraphComponent#CurrentItem over deselecting a single selected item.
IInputMode API has been updated for clarity: the InputMode property has been removed from the interface. Instead, most
implementations now offer the protected ParentInputModeContext property to
clearly indicate its role as the input mode's parent context. Most input modes can create a context which can be
passed to dependents via the protected createInputModeContext method. The created
context has the input mode set as the parent input mode. The new InputModeContext
class may be used by implementations to conveniently create new contexts.
GraphViewerInputMode, the viewport can now be moved by either dragging
with the left or middle mouse button.
GraphEditorInputMode, the viewport can now be moved by either dragging
with the middle mouse button or by dragging with the left mouse button when pressing the Ctrl or
Space key.
Command#ZOOM_TO_SELECTION zooms to the bounding box around all selected
items. It can be triggered by the keyboard short cut Alt+2.
GraphComponent loses the focus.
GraphViewerInputMode's and GraphEditorInputMode's ClickHitTestOrder now reflects the z-Order of the elements. By enabling SkippingHitLabelsEnabled (the default) elements behind labels can still be prioritized
over the labels.
Ctrl+0 or Alt+0 sets the zoom to 100%.
Alt+1 fits the content in the view.
Alt+2 brings the selection into the view.
Alt+3 brings the current item into the view.
Ctrl+Plus increases the zoom value.
Ctrl+Minus decreases the zoom value.
Alt+Left collapses a selected group node.
Alt+Right expands a selected folder node.
Alt+Up exits the current folder node.
Alt+Down enters the current folder node.
Alt+Shift+Left or Alt+Shift+Right toggles the expansion state of a selected group or
folder node.
GraphEditorInputMode now allows for starting label editing just by starting to type.
The EditLabelOnTypingAllowed property can be used to configure this setting, which
is turned on, by default.
Enter
key.
HandleTypes enums has been refactored to a non-flaggable HandleType enum, and the values have been adjusted to those used in the library as well as
some custom variants for individual use.
IHandle implementations can use the new IHandle#Tag property for various purposes, including custom handle visualizations.
yFiles does not use the property and initializes it with null, but decorating handles forwards any
values unmodified.
OverviewInputMode now uses the CanvasComponent's MouseWheelZoomEventRecognizer to determine if the used performed a zoom gesture.
Wheel event is handled by code, the default behavior (zoom/scroll) will be cancelled.
ICommand, inspired by WPF's commands,
has been replaced with an enumeration of primary input gestures called Command. GraphComponent now manages the execution of commands:
GraphComponent#executeCommand runs the specified command with an optional
parameter.
GraphComponent#canExecuteCommand indicates whether the specified command can be
executed.
CanExecuteChanged event is triggered when the executable state of a
command has changed.
MouseHoverInputMode has been renamed to ToolTipInputMode to better reflect its function.
handleIsHit and getClosestHitHandle methods of
HandleInputMode now have an additional parameter which specifies the PointerType of the related user gesture.
GraphEditorInputMode#OrthogonalEdgeEditingContext property is now set and
enabled per default and may not be null anymore. Edges can be individually configured to be edited
orthogonally by providing an apropriate IOrthogonalEdgeHelper in their lookup.
PolylineEdgeStyle, the style's new OrthogonalEditingEnabled property can be set so such a helper is automatically
provided.
Enabled property of the
OrthogonalEdgeEditingContext can be set to false.
OrthogonalEdgeEditingContext#FallbackEdgeHelperProvider property can be set to a
helper supporting orthogonal edge editing.
NavigationInputMode now interprets the direction of arrow keys in view coordinates by
default. Previously the default settings could lead to surprising behavior when combined with a Projection on GraphComponent.
Should- methods of the input modes have been removed and replaced by predicate
properties. This simplifies adjusting the behavior without the need to subclass the input modes.
LabelDropInputMode now consults the IEditLabelHelper of
possible drop targets when dragging and dropping labels.
CreateEdgeInputMode#startEdgeCreation method can be used to
start interactive edge creation from a node or port, respectively.
GraphClipboard has been streamlined.
GraphViewerInputMode#HitTester property works in the same way as the GraphEditorInputMode#HitTester property.
GraphEditorInputMode#duplicateSelection method now also dispatches MultiSelectionStarted and MultiSelectionFinished events.
HandleInputMode#AffectedItems property now include edges
that were modified with the height handle of BezierEdgeStyle and ArcEdgeStyle.
PortRelocationHandle#createDummyEdge method has been renamed to createPreviewEdge and can be overridden.
CreateEdgeInputMode#createPreviewBend method has been added that can
be overridden to customize bends added during edge creation.
CreateEdgeInputMode#StartPortOwnerDraggingFinishedRecognizer.
ItemDropInputMode#DragDropped event is now raised after the drop gesture has
actually finished, in line with how similar events are raised elsewhere.
MoveInputMode and HandleInputMode sub-modes of GraphEditorInputMode no longer have a pre-set SnapContext.
Instead, they get their SnapContext from the InputModeContext. That way, setting the SnapContext on GraphEditorInputMode will affect all sub-modes unless a custom SnapContext is set to them.
GraphClipboard#DefaultGraphClipboard has been added and is used
per default as GraphComponent#Clipboard. This way copy&paste operations work between
multiple GraphComponent instances without the need to set a shared GraphClipboard instance first.
GraphViewerInputMode and GraphEditorInputMode can now be replaced while the input mode is installed.
Command#TOGGLE_ITEM_SELECTION has been adjusted accordingly, and the behavior the Command#SELECT_ITEM and Command#DESELECT_ITEM has also
been changed accordingly.
NavigationInputMode now reliably brings items selected with keyboard navigation into
the view. Previously this only worked for nodes.
DropInputMode (and derived types) now continues working properly even if the control's
template changes.
EditLabelInputMode could not be overwritten by mistake. The install, uninstall, stop, and cancel methods and the Enabled property can now be overwritten.
GraphViewerInputMode#findItems and GraphEditorInputMode#findItems methods: when the filter includes both edges and bends,
the edge will no longer be ignored if any of its bends are hit.
GraphViewerInputMode#findItems and GraphEditorInputMode#findItems method: when using GraphItemTypes#ALL, bends will not be ignored. Furthermore, the interfaces IBendSelectionTester and IPortSelectionTester are properly
queried.
GraphViewerInputMode#findItems and GraphEditorInputMode#findItems method: Ports with a style are no longer reported twice.
GraphComponent that has a projection, the inertia now
works in the right direction.
marqueeSelect and lassoSelect methods
of GraphEditorInputMode and GraphViewerInputMode were
called with a wrong input mode context.
GraphViewerInputMode#findItems or GraphEditorInputMode#findItems without the context parameter now finds the items
correctly.
GraphComponent#InputMode while the context menu is
open would lead to a crash.
HighlightIndicatorManager that could result in missing or surplus
highlight visualizations when changing the GraphComponent#HighlightIndicatorManager.
MoveViewportInputMode that caused the inertia feature to mistakenly
start moving the viewport after the mouse has stopped before being released.
CanvasComponent/GraphComponent viewport
animation now properly stops a running MoveViewportInputMode inertia animation.
ClickInputMode#FocusClickSwallowingEnabled property had no effect.
EditLabelInputMode, which is now a subordinate mode of GraphEditorInputMode. The new input mode consolidates the methods, properties, and events
necessary for customizing label editing. The key methods, addLabel and
editLabel, remain accessible through GraphEditorInputMode.
ILabel and ILabelOwner now includes a default
implementation of IEditLabelHelper in its lookup. The
IEditLabelHelper interface has been updated to offer greater control over the label
editing process.
TableEditorInputMode, except
for the key methods addLabel and editLabel. Label editing is now handled through GraphEditorInputMode's EditLabelInputMode.
SnapLine, so SnapCircle, SnapGrid, and SnapSize instances are created and are
available for the SnapResult providers.
GraphSnapContext, so the LabelSnapContext has been removed. Configuration options have been moved from LabelSnapContext to GraphSnapContext.
GraphSnapContext#AffectedItems property provides the items for which
SnapResult shall be collected.
GraphSnapContext are now easier to use and more
concise.
collectGridSnapReferences and collectSameSizeSnapReferences of GraphSnapContext can
be overridden to customize the SnapGrid and SnapSize
instances items can snap to.
SnapReference class is now the base class of SnapLine, and the new SnapGrid, SnapSize, and SnapCircle classes. The new SnapReference#SnappableItems property describes which item types may snap to this
reference.
SnapContext#SnapResultPen property is used as default pen for the
SnapResult rendering.
OrthogonalSnapLine#Croppable property is used to decide which snap lines
to crop if GraphSnapContext#SnapLineCroppingEnabled is true.
Reference, Item,
and ItemAnchor of the SnapResult class can
be used by the IObjectRenderer for the visualization of the SnapResult.
ReshapeRectangleContext simplify the calculation of the bounds for
a specified pointer delta or the SnapConstraint necessary to result in a specified
width, height or side location.
GraphClipboard and GraphEditorInputMode with
Element in their name that actually referred to model items were renamed to
Item to clarify their usage.
GraphClipboard#paste method now accepts an optional pasteLocation
parameter specifying the center of the bounds of the pasted items.
GraphClipboard now use GraphClipboardEventArgs that provide the current IGraphClipboardContext and the Items.
IClipboardHelper now has methods to support duplicate, too: shouldDuplicate and onDuplicated.
GraphClipboard's cut, copy, paste, and duplicate methods now use an IStreamIterable to
determine the subgraph to copy.
GraphClipboard now uses an optimized ClipboardGraphCopier for its clipboard operations instead of the general GraphCopier.
updateGroupNodeState and updateMasterEdges,
have been added to IFolderNodeConverter and IFoldingEdgeConverter, respectively, for handling these updates.
IFoldingView). Instead, the edge is now removed
from the view.
GraphClipboard if it is duplicated.
FolderNodeConverter if labels
are copied between master and view node.
GraphBuilder to populate your graph, and implementing custom styles for nodes, for edges or for labels.
BPMN-DI import for LaneSets in a Subprocess.
Colors#TRANSPARENT.
GroupNodeStyle and RectangleNodeStyle.
LayoutExecutor can now automatically create port constraints for edges at ports that
use a CompositePortLocationModel. For all parameters added to a CompositePortLocationModel, a fixed port candidate is created. The cost, capacity, and
PortSide of this candidate can be specified when adding the parameter to the model.
LayoutExecutor#TableLayoutConfigurator feature now uses more flexible placements
for nodes that don't belong to any table node.
LayoutExecutor and LayoutGraphAdapter classes now
correctly assign port group IDs to edges that connect to the same port. Previously, in some cases involving ports
with a single incoming and outgoing edge, the port group IDs were omitted, which could cause incorrect layout
results (such as diagonal segments instead of orthogonal ones).
LayoutPortCandidates now have a MatchingId. When
finding matching LayoutPortCandidates at nodes and for edges, two LayoutPortCandidates can only match if their MatchingId properties are equal.
LayoutAnchoringStage class (previously called FixNodeLayoutStage) now allows using not only nodes but also edges and labels to anchor
the graph's position.
NodeAnchoringPolicies, EdgeAnchoringPolicies, NodeLabelAnchoringPolicies and EdgeLabelAnchoringPolicies properties specify which part of the items should
be used to calculate the anchor point.
LayoutExecutor#AnchoredItems property specifies the graph items used to
anchor the graph's position.
ComponentLayout has now the ability to specify which layout to apply to individual
components using ComponentLayoutData#ComponentLayouts property. Additionally, edges
between components can be routed using a router set via ComponentLayout#InterEdgeRouter.
PartitionGrid). This is made possible by the new LayoutGrid.CellDescriptor#LayoutGrid property. This way it is no more required to set the
global layout grid with the LayoutGridData#Grid property. If a node is to be placed
in a grid but not in a specific cell, this can now be achieved using the new LayoutGrid#createDynamicCellDescriptor method. Be aware that many layout algorithms like
HierarchicalLayout don't support multiple layout grids.
LayoutData classes are now generic and can be used for items of a LayoutGraph, too. Of course, it's still possible to use LayoutData with IGraph items.
LayoutData instances when used with IGraph typically
need INode, IEdge, ILabel, and ILabel as their type arguments.
LayoutData instances when used with LayoutGraph
typically need Node, Edge, NodeLabel, and EdgeLabel as their type arguments.
LayoutData classes can be created via factory methods on
the layout algorithm themselves, for example, HierarchicalLayout#createLayoutData. Depending on the type of graph that is provided
as the argument, the correct data instance will be created.
LayoutGraph class has received a major rework. The LayoutGraph is the only remaining graph implementation for the layout analysis part.
Classes Graph (previously used for graph analysis, only) and CopiedLayoutGraph have been removed and functionality was moved to LayoutGraph.
IGraph with
respect to creation, modification and access to nodes, edges and labels.
NodeList and EdgeList have
been removed as well as cursor for iteration over the elements.
NodeCount and EdgeCount
have been removed. Query the size of the Nodes and Edges properties instead.
LayoutGraph#getLayout). It is now accessible on the items
itself and is also mutable, see Node#Layout property.
SourcePortLocation, TargetPortLocation
and Bends.
LayoutGraph#addLabel method. The complicated ILabelLayoutFactory that covered that use case in the past has been removed.
LayoutGraphHider class.
Graph#containsEdge method has been removed in favor of LayoutGraph#getEdgesBetween. The same holds for the Node#getEdgeTo and Node#getEdgeFrom methods.
Node#Neighbors have been removed. Instead, query all
edges (using the Edges property) and filter the required adjacent nodes manually.
LayoutGraph instance, the new LayoutGraph#createCopy method has been added.
LayoutGraph without coordinate/path information is needed (to optimize memory
performance), it can be created using the factory LayoutGraph#createStructureGraph method.
LayoutExecutor now supports arranging graphs without a GraphComponent.
LayoutGraph#getEdgesBetween method returns all edges between two nodes.
PortPlacementStage now computes cost-minimal matchings between port candidates at
nodes and edges.
PortPlacementStage, rather than being
natively integrated into the layouts. As a result, the quality may be poor.
CurveFittingStage now correctly respects the maximum error. Previously, it
sometimes produced curves that violated the maximum error.
LineSegment#getIntersection method no longer produces incorrect results when the
specified epsilon is zero. Previously, there were some edge cases where the algorithm failed to detect an
intersection and returned null instead.
ParallelEdgeRouter#hideMultiEdges method, which is required to
meaningfully overwrite the existing protected ParallelEdgeRouter#findAndHideMultiEdges method.
PortPlacementStage now correctly considers port candidates together with port
groups.
TreeReductionStage, CircularLayout, and RadialLayout classes no longer produce results with a lot of superfluous, collinear bends
for bundled edges.
HierarchicalLayout class now supports defining minimum distances between the
ports. They can be specified per node side using the HierarchicalLayoutNodeDescriptor#MinimumPortDistance property. The node size is
increased if necessary in order to accommodate the minimum distances.
PortData#SourcePortAlignmentIds
and PortData#TargetPortAlignmentIds accessible via HierarchicalLayoutData#Ports.
HierarchicalLayout now produces fewer bends for multi-edges with labels when
integrated edge labeling is enabled.
HierarchicalLayout class now produces better results for graphs with tabular
groups where all children have a fixed user-specified order.
HierarchicalLayout no longer produces overlapping edge segments if there are
grouped edges with different thicknesses values. Previously, the user had to ensure that all these edges use the
same thickness.
HierarchicalLayout now enforces a more symmetric placement of
the nodes that are part of chains or height-2 trees.
HierarchicalLayout class now also considers layering constraints between elements
of different grouping hierarchies if the recursive group layering is enabled ( HierarchicalLayout#GroupLayeringPolicy property). Previously, such constraints were
ignored in that case.
HierarchicalLayout algorithm now correctly handles node and edge labels with width
or height set to negative values. Previously, large negative values may have caused exceptions.
LayerConstraintData and SequenceConstraintData that are configured with comparables can now be reused for multiple
layout calculations.
HierarchicalLayout class no longer creates avoidable crossings between edges with
the same target node when FromSketchModeEnabled property is enabled.
HierarchicalLayout class no longer unnecessarily enlarges group nodes in the case
when no group node padding is defined, i.e. no data registered with the LayoutKeys#GROUP_NODE_PADDING_DATA_KEY property.
HierarchicalLayout#StopDuration property is no longer ignored
during the execution of some ILayerAssigner or ICoordinateAssigner implementations that have their own specific StopDuration. The HierarchicalLayout class will now
always consider the shortest applicable duration.
HierarchicalLayout class now always places aligned ports correctly in from-sketch
mode.
HierarchicalLayout class no longer assigns superfluous space to group nodes if
there are grouped edges.
HierarchicalLayout class no longer produces an error when using a non-zero grid
distance in combination with incremental mode's exact coordinate hints.
HierarchicalLayout class no longer produces an error for labeled graphs with port
alignment constraints when the integrated edge label placement is enabled.
HierarchicalLayout class no longer produces superfluous crossings between
backloops or same-layer edges in the first or last layer.
HierarchicalLayout class no longer produces superfluous crossings for tabular
group nodes with fixed children order.
HierarchicalLayout now properly handles self-loop edges when the edge is at a
group node and furthermore edge/port grouped with the same ID on both sides. Previously, it was not routed correctly
or that it was removed from the LayoutGraph instance when running the layout algorithm
directly on the graph instance without using a copy.
HierarchicalLayout class no longer swaps the position of fixed nodes in
incremental layout mode with user-specified sequence constraints.
HierarchicalLayout class no longer produces superfluous crossings for some graphs
with group nodes in incremental layout mode.
HierarchicalLayout class no longer produces very long edge segments for some input
graphs containing groups with node halos and polyline edge routing.
HierarchicalLayout class no longer throws an exception for graphs with bus
structures if the algorithm runs in incremental mode and the group transposition feature is enabled.
HierarchicalLayout class no longer misplaces port labels at the connector nodes of
integrated subcomponents.
HierarchicalLayout class no longer produces intertwined edge routes with many
superfluous crossings and bends for some cases with sequence constraints placeAtHead or placeAtTail. The
problem mainly occurred with graphs with groups or LayoutGrid and incompatible
sequence constraints.
HierarchicalLayout class no longer produces superfluous crossings for some edges
with alternative paths that are incident to group nodes (see HierarchicalLayoutData#AlternativeEdgePaths).
HierarchicalLayout algorithm no longer requires a long runtime for some larger,
grouped graphs with layering constraints and non-recursive layering.
HierarchicalLayout algorithm no longer requires a long runtime for some larger
graphs with layering constraints when a maximum duration is specified.
HierarchicalLayout class no longer throws an exception for some invalid
specifications of alternative group bounds in incremental layout mode.
TreeLayout#FromSketchModeEnabled property to consider the initial
coordinates of the graph elements. This has an effect only if the used subtree placers implement IFromSketchSubtreePlacer.
TreeLayoutData#MultiParentDescriptors property that allows to specify
style information for multi-parent structures.
TreeReductionStageData class now offers NonTreeEdgesResult property. It allows to conveniently query the set of edges that
the stage actually selected as non-tree edges.
TreeLayout now considers minimum last segment lengths no matter on which side the
port shall be placed.
LeftRightSubtreePlacer now supports minimum segment length, which can be set with
the properties MinimumFirstSegmentLength and MinimumLastSegmentLength.
AbstractRotatableSubtreePlacer.RootAlignment support
placing the subtree root centered above the ports with the new value CENTER_OVER_PORTS.
SingleLayerSubtreePlacer supports placing the subtree root centered with respect
to the ports at its children with the new enum value SingleLayerSubtreePlacerRootAlignment#CENTER_OF_PORTS.
AspectRatioSubtreePlacer now supports minimum first and last segment lengths.
AspectRatioSubtreePlacer now supports multiple variants how to place the root node
with respect to its children, which can be set using the properties ChildArrangement and RootPlacement.
TreeReductionStageData directly to the LayoutData of tree layouts, including RadialLayoutData,
RadialTreeLayoutData, and TreeLayoutData.
TreeLayout class now places the ports of edges incident to multi-parent nodes and
with port constraints (excluding any-side constraints) at the nodes' border. Previously, unlike as for edges
incident to other nodes, the edge ports where located at the nodes' center.
TreeLayout now correctly handles the specified CompactSubtreePlacerStrategyMementos (STRATEGY_MEMENTO_DATA_KEY) for nodes associated with a CompactSubtreePlacer. Previously, the algorithm incorrectly overwrote the value for the
leaves.
TreeLayout class no longer ignores the initial locations for some subtree placers
if the FromSketchModeEnabled property is enabled.
TreeLayout now automatically places edge labels of the parallel edges handled by
its ParallelEdgeRouter instance, when integrated edge labeling is enabled.
TreeLayout class no longer produces broken edge routes for some input graphs with
multi-parent structures.
AspectRatioSubtreePlacer class no longer ignores the specified AspectRatioSubtreePlacer#ChildAlignmentPolicy for some specific setups (e.g., if all
children are leaves and have the same size).
OrthogonalLayout#QualityTimeRatio property allows controlling the
layout quality by automatically enabling/disabling additional optimization steps.
OrthogonalLayout algorithm now supports specifying edges that should be routed
against the main layout orientation in addition to the option to route with the main layout orientation. See OrthogonalLayoutData#EdgeOrientation property.
OrthogonalLayout now automatically places edge labels of the parallel edges
handled by its ParallelEdgeRouter instance, when integrated edge labeling is enabled.
OrthogonalLayout class no longer throws an exception for some input graphs with
tree substructures when the TreeSubstructureStyle is set to a value different from
TreeSubstructureStyle#NONE.
EdgeRouter is run with the buses feature and a limited duration, it now splits the
available time amongst buses, meaning that it will not get "stuck" on a single bus, which could otherwise impact the
quality of the remaining buses and non-bus edge routings.
EdgeRouter now prefers to use fixed port candidates that are not overlapped by
other nodes.
EdgeRouter class no longer produces uncovered buses. Previously, there were some
rare cases where the specified bus edges didn't constitute a bus.
EdgeRouter class does no longer yield different results in rare cases when the
same instance is applied twice to the same input graph.
EdgeRouter class no longer produces self-crossing routes of edges with labels if
EdgeRouterEdgeLabelPlacement property is set to EdgeRouterEdgeLabelPlacement .INTEGRATED.
EdgeRouter class no longer produces bad layout results for some scenarios with
grouped edges and multiple LayoutPortCandidate. Previously, the algorithm selected any
of them without considering the alternative options.
GenericLabeling algorithm now correctly considers the case where model parameters
of a CompositeLabelModel have different weight values. Higher weights are preferred.
EdgeLabelCandidates#buildCandidates method does no longer return
null for some setups with free edge label models. Instead it returns an empty IStreamIterable now.
GenericLabeling class now produces less node-label overlaps.
GenericLabeling class no longer produces non-optimal label placements for some
rare setups of graphs with node halos.
GenericLabeling class no longer produces bad label placements for edges with
direct group content routing, i.e., edges that connect a group node with one of its descendants and are routed
directly without leaving the group.
OrganicLayout class now supports integrated edge labeling which can be enabled
with EdgeLabelPlacement property.
OrganicLayout class now provides a feature that dynamically detects whether nodes
already lie almost on a common line or circle and, if so, snaps the nodes to this line/circle. This new feature can
be enabled with the ChainRecognitionEnabled and CircleRecognitionEnabled properties.
OrganicLayout class now supports drawing the edges such that they point to the
main layout direction. Whether an edge should follow the main orientation can be specified with the new OrganicLayoutData#EdgeOrientation property.
OrganicLayout class now supports individual minimum lengths of edges that can be
specified with the new OrganicLayoutData#MinimumEdgeLengths property.
OrganicLayout class now supports different types of constraints that restrict the
placement of the graph’s nodes. These constraints can be specified with the new OrganicConstraintData class (cf. the OrganicLayoutData#Constraints property).
OrganicLayout has been substantially improved for large graphs
without group nodes. The improvement is triggered if no special constraints are defined and no shape recognition is
enabled.
OrganicLayout now supports different styles for group substructures, which are set
via the GroupSubstructureStyle property.
OrganicLayout now automatically places edge labels of the parallel edges handled
by its ParallelEdgeRouter instance, when integrated edge labeling is enabled.
OrganicLayout class no longer ignores the preferred edge length in incremental
layout mode with a single affected element.
OrganicLayout class now supports specified minimum group node sizes with more
feature combinations. Previously, the minimum group node size was sometimes violated.
OrganicLayout class no longer produces edge overlaps when ChainRecognitionEnabled property is enabled.
CircularLayout class now offers the possibility to define star substructures. The
CircularLayout#StarSubstructureStyle property specifies the style of star
substructures and the CircularLayout#StarSubstructureSize property their minimum
size (structures of smaller size are not handled as a star substructure). Furthermore, the CircularLayout#StarSubstructureTypeSeparationEnabled property specifies whether star
substructures should be separated by the node type.
CircularLayoutData class offers the new EdgeDirectedness property that influences the detection of star-substructures; see
CircularLayout#StarSubstructureStyle.
CircularLayout class no longer produces strange routes for some bundled edges.
CircularLayout class no longer throws an exception if StarSubstructureStyle property is set to StarSubstructureStyle#RADIAL and the whole input graph is a star.
RadialLayout class now allows defining a custom order of child nodes around a
local root node. The order can be individually specified for each node by using the new RadialLayoutData#ChildOrder property. It is especially suitable for tree-like input
graphs. For specifying a single global order for all nodes, for example, alphabetically, the new ChildOrderData#TargetNodeComparables property is a more convenient option.
RadialLayout class now supports node types. The types influence the ordering of
nodes of the same circle such that nodes of the same type are preferably placed next to each other if this does not
induce additional crossings or conflicts with other constraints. Node types can be defined via the RadialLayoutData#NodeTypes property.
RadialLayout class no longer throws an exception if the layout algorithm is
executed too many times from the same instance.
OUT_EDGE_COMPARATOR_DATA_KEY to RadialTreeLayout class (formerly BalloonLayout).
AlignmentStage class places the nodes of a given layout on automatically
determined horizontal and/or vertical lines. This stage is particularly designed as a post-processing step that
snaps suitable nodes to the same x- or y-coordinates to obtain a grid-like structure. When rearranging the initial
layout, the stage moves the nodes as little as possible.AlignmentStageData class allows to specify custom data considered during the layout
calculation.
SeriesParallelLayout now automatically places edge labels of the parallel edges
handled by its ParallelEdgeRouter instance, when integrated edge labeling is enabled.
ClearAreaLayout class no longer produces violations of the LayoutGrid if the ClearAreaStrategy is set to LOCAL or LOCAL_UNIFORM.
ClearAreaLayout class no longer produces results where the specified area is not
cleared for some input graphs when ClearAreaStrategy property is set to PRESERVE_SHAPES or PRESERVE_SHAPES_UNIFORM.
MultiPageLayout algorithm will adhere to page size specifications in rare cases that
could previously cause the maximum page size to be exceeded.
PartialLayout now supports specifying inversely directed edges in addition to
undirected and directed edges.
PartialLayoutScopeData will no longer mark any edges as affected when only nodes are
specified to be in scope, nor mark any nodes as affected when only edges are specified to be in scope.
PartialLayout class does no longer yield different results in rare cases when the
same instance is applied twice to the same input graph.
PartialLayout class now correctly places disconnected components for cases where a
layout orientation is specified, and the ComponentAssignmentStrategy property is not
SINGLE. Previously, such components were sometimes placed far away from the remaining graph elements.
TabularLayout class now supports the calculation of node arrangements that lead to
a low overall edge length. This feature can be enabled with the new EdgeConsiderationEnabled property.
TabularLayoutData#LayoutGridData property makes it easy to query the cell to
which a node was assigned to by the TabularLayout class after applying it.
Exception when a LayoutGrid including a
mapping from nodes to LayoutGridCellDescriptors is defined and if algorithm
TabularLayout was executed before with LayoutMode AUTO_SIZE or FROM_SKETCH. In these modes the TabularLayout
automatically assigns cells to nodes so that any mapping defined prior will be ignored now.
ComponentLayout now supports NodeMargins
(formerly NodeHalos) for each ComponentArrangementStyle other than NONE and KEEP_CENTERS.
LongestPath algorithm now uses double values instead of integers for edge
traversal costs. This improves the Paths, LayoutGraphAlgorithms, and LongestPath classes.
LayoutGraphAlgorithms#findCycleEdges method has been improved and now requires
fewer edges to be reversed. In addition, a new, even better but slower heuristic can be enabled with a new optional
parameter.
Intersections class does not dispose FilteredGraphWrapper instances that it is given with no subgraph nodes or edges specified
anymore. Previously, this caused the graph instance to become defunct, resulting in various operations running into
null fields and properties, generating exceptions that were non-trivial to understand.
Intersections.Result no longer includes intersections that have no actual intersection
points. This issue occurred when two graph elements were within a small epsilon distance of each other.
KShortestPaths class has a new implementation of the k-shortest path algorithm
that allows for the exclusion of non-simple paths (i.e., paths with repeating vertices). Previously, these paths
could not be excluded. The new implementation is used by default and can be disabled with the SimplePaths parameter.
LayoutGraph, the algorithm is also available via the LayoutGraphAlgorithms#kShortestPaths method.
Paths when a
large number of start and end nodes were set.
KShortestPaths class now correctly calculates the k-shortest paths of graphs.
Previously, in rare cases, the algorithm sometimes produces wrong results, i.e., returns paths that are not the
shortest.
GeneralPath#areaOrPathContains method tests if the path fuzzily contains a
point and can be used for hit-testing a GeneralPath.
GeneralPath class now consistently accept IPoint instead of PointD and IRectangle instead of RectD.
RectD and PointD to calculate
the distance between points and rectangles.
GeneralPath#getProjection method is now faster for paths with Bezier segments.
IRectangle interface no longer implements IPoint. As
a consequence, it is no longer possible to inadvertently use rectangles as parameters for methods that expect a
point. You can still easily get the top-left corner of a rectangle with its getTopLeft method. Similarly, IMutableRectangle no longer
implements IMutablePoint.
GeneralPath#pathMayIntersectClip method has been corrected for paths with
multiple segments, at least one of which is a cubic segment.
SizeD#Area property now returns 0 for empty sizes. This is consistent with the
behavior of the RectD#Area property.
Categories: General Graph GraphBuilder Components Rendering Selection, Focus, Highlight Styles Interaction Snapping Clipboard Folding Lookup GraphML View-Layout-Bridge Layout Layout Data Hierarchical Layout Tree Layout Orthogonal Layout Edge Router Labeling Organic Layout Interactive Organic Layout Circular Layout Radial Layout Radial Tree Layout Radial Group Layout Series-parallel Layout Compact Disk Layout Multi-page Layout Partial Layout Tabular Layout Component Layout Tree Map Layout Recursive Group Layout Layout Grid Other Layouts Algorithms Analysis Collections Geometry
IEnumerable interface has been renamed to IStreamIterable and several of its
static and default methods have been removed. Most of the removed methods can be replaced by using the
Java stream API. Furthermore, its enumerator method together with the IEnumerator
interface have been removed and the usages replaced by the inherited iterator method.
IListEnumerable interface has been renamed to IIndexedIterable
IEnumerable.EMPTY and IListEnumerable.EMPTY fields have been removed. If there is need
of an empty instance of those interfaces, IIndexedIterable.create can be called with
Collections.emptyList() as parameter.
ICollection and IList interfaces has been removed.
YList class has been renamed to LinkedCellList
StripeSelection class. Instead, use the instance returned by the
TableEditorInputMode#StripeSelection property.
BorderLineSegment, LabelScopeData, ItemCollection, ItemMapping, FreePortLabelModel, and FreeNodeLabelModel. They either
already had an internal constructor or do not offer any meaningful members for overriding.
Default prefix from the names of the following types: DefaultEdgePathCropper, DefaultFoldingEdgeConverter, DefaultFolderNodeConverter, DefaultLabelStyle, ObservableCollection, DefaultPortCandidate, and DefaultSelectionModel.
DefaultLabelModelParameterFinder.
Padding and Margins in member names:
TextEditorInputMode#TextAreaPadding property to TextAreaMargins.
LabelStyleIndicatorRenderer#Padding property to Margins.
GraphEditorInputMode#ContentRectMargins property to ContentMargins.
OverviewInputMode#Margins property to ContentMargins.
ViewportAnimation#TargetBounds property to Target.
ViewportAnimation#TargetViewMargins property to TargetMargins.
StripeLabelModel#UsingActualInsetsEnabled property to UsingTotalPaddingEnabled.
StretchStripeLabelModel#UsingActualInsetsEnabled property to UsingTotalPaddingEnabled.
IStripe#getActualInsets method to getTotalPadding.
GroupNodeStyle#ContentAreaInsets property to ContentAreaPadding.
YInsets properties of all ILabelModel
implementations to Margins.
Insets of other types and members with Padding.
BridgeManager#ClipMargin property.
NORTH, EAST, SOUTH, WEST naming convention have been renamed to
follow a Top, Right, Bottom, Left naming convention. In
particular, the values of the following enums have been renamed: HandlePositions,
EdgeSegmentDirection, ExteriorLabelModel.Position, InteriorLabelModel.Position, InteriorStretchLabelModel.Position, StretchStripeLabelModel.Position, and StripeLabelModel.Position,.
PortSide enum to PortSides.
null. This might require additional null checks or changed signatures of method overrides.
CreateEdgeInputMode#SelfloopsAllowed property to SelfLoopsAllowed.
GraphEditorInputMode#selectNodeAndSelfloopBends method to selectNodeAndSelfLoopBends.
GraphEditorInputMode#AutoSelectingSelfloopBendsEnabled property to AutoSelectingSelfLoopBendsEnabled.
IEdge#isSelfloop method to IEdge#isSelfLoop.
ILookup interface and its extension methods have been moved to the
com.yworks.yfiles.utils package.
IMapper interface and the Mappers class have been moved to the
com.yworks.yfiles.utils package.
DefaultGraph class has been renamed to Graph.
LabelDefaults of INodeDefaults, IEdgeDefaults and IPortDefaults have been renamed to Labels.
PortDefaults of INodeDefaults and IEdgeDefaults have been renamed to Ports.
EdgePathLabelModel and EdgeSegmentLabelModel have been
modified to yield better results for some degenerate path cases. This leads to greater visual stability when the
path is not long enough for the label or even completely invisible due to overlapping nodes. Technically, this can
result in slightly different placements with the same parameter values in these edge-cases.
GroupNodeLabelModel to a node that does not use GroupNodeStyle or setting a GroupNodeLabelModel-created
parameter for a label whose owner node does not use GroupNodeStyle no longer throws an
IllegalArgumentException claiming "The parameter does not support this kind of label.".
SegmentRatioPortLocationModel class is now named EdgeSegmentPortLocationModel, similar to EdgeSegmentLabelModel.
createFromSource and createFromTarget methods of
the SegmentRatioPortLocationModel and BendAnchoredPortLocationModel are now named createParameterFromSource and createParameterFromTarget.
TableAnimation class. Use the factory IAnimation#createTableAnimation method as a replacement.
GenericPortLocationModel has been renamed to CompositePortLocationModel and doesn't implement IStreamIterable anymore. Instead, the Parameters
property can be used to iterate the parameter.
FreeEdgeLabelModel#createEdgeAnchored method has been renamed to createParameter.
FreeNodeLabelModel#createDefaultParameter method has been removed and replaced
by the new FreeNodeLabelModel#CENTER field.
FreeNodeLabelModel#createCanonicalParameter method has been renamed to createParameter.
FreePortLabelModel#createDefaultParameter method has been removed and replaced
by the new FreePortLabelModel#CENTER field.
ExteriorLabelModel, InteriorLabelModel,
and InteriorStretchLabelModel have been renamed to ExteriorNodeLabelModel, InteriorNodeLabelModel, and StretchNodeLabelModel, respectively,.
GenericLabelModel class has been removed. Its functionality has been integrated
into the CompositeLabelModel, which can be used instead.
CompositeLabelModel#LabelModels property has been removed. Instead of adding
label models to this list, the new addModel method has to be called.
LabelModelParameterSerializer and PortLocationModelParameterSerializer classes have been removed. These classes could be
used to retrieve the properties of label model parameters and port location model parameters and are not necessary
anymore as the parameter classes are now public.
ILabelModel parameter of the ILabelModelParameterFinder#findBestParameter and ILabelModelParameterProvider#getParameters methods has been removed.
ConsumerUndoUnit and CompositeUndoUnit have
been removed. The new factory methods IUndoUnit#fromConsumer and IUndoUnit#combine can be used instead.
AbstractUndoUnit class has been removed. Subclasses now have to implement the
IUndoUnit interface instead.
owner parameter of the ITable#createRow, createColumn, and setParent methods has been renamed to
parent.
GraphCopier class:
copyNodeStyle, copyEdgeStyle, copyPortStyle, copyLabelStyle, getOrCreateCopy, copyLabelLayoutParameter, and copyPortLocationParameter have been made protected.
copyNode, copyGroupNode, and copyEdge have been renamed to createNode, createGroupNode, and createEdge to clarify their
role.
Clone property has been renamed to CloneTypes.
Copy method now uses an IStreamIterable
of items instead of a filter predicate to define the subset to copy.
ILabelModel#createDefaultParameter method has been removed. Instead suitable
other Create*Parameter methods of the concrete label model implementations should be used.
IPortLocationModelParameter#supports method has been removed. Instead, the IPortLocationModel#getLocation method may now throw an exception if the port and port
location model parameter don't match.
IEdge#SourcePort, IEdge#TargetPort, ILabel#Owner, IPort#Owner, IBend#Owner) now throw exceptions if
accessed for items that are no longer in the graph. If it is unknown whether the item is still in the graph, please
test the item with hasOwner or hasSourceAndTargetPort first before accessing these properties.
IEdge's getSourceNode and getTargetNode methods now throw exceptions if called for an edge that is no longer in
the graph or if the owner of the edge's source or target port is not a node.
ILabelModelParameter#supports method has been removed. Instead, the ILabelModel#getGeometry method may now throw an exception if the label and label model
parameter don't match.
GraphItemTypes#notContains method was removed, use the contains method instead.
GroupingSupport#getPathToRoot has been renamed to getAncestors and returns an IIndexedIterable instead of an
IList.
FreeNodePortLocationModel have been renamed analogue to
the static parameter fields in InteriorNodeLabelModel.
GraphClipboard#isDummy method has been renamed to isHelper.
UndoEngine#Token property replaces the UndoEngine#getToken method.
IMapperRegistry interface, the MapperRegistry class,
and the IGraph#MapperRegistry property have been removed. To store additional
information for graph items, either use the item's Tag property or keep a dictionary alongside the graph.LayoutData instead.
ITagOwner interface is now in the com.yworks.yfiles.utils package.
OrientedRectangle, NodeLabel,
EdgeLabel and FreeEdgeLabelModel is now clockwise to be
consistent with the other models.
EdgeSegmentPortLocationModel#createParameterFromTarget method now interprets the
parameter ratio from the target to the source side.
ArrowType#TRIANGLE.
EdgeSegmentLabelModel
using its createParameterFromCenter method instead of createParameterFromSource.
Padding properties of ExteriorNodeLabelModel, InteriorNodeLabelModel, StretchNodeLabelModel, and StretchStripeLabelModel have been
changed from empty insets to insets with value 2 on each side. This way the label bounds per default don't touch the
bounds of their owner anymore.
Distance properties of the EdgePathLabelModel and EdgeSegmentLabelModel when using
their default constructors have been changed from 0 to 2. This way the label bounds per default don't touch the edge
path of their owner anymore when an EdgeSide other than ON_EDGE is used.
INode doesn't return an IMutableRectangle anymore, the default lookup for IBend
doesn't return an IMutablePoint anymore, and the default lookup for ILabel doesn't return an IMutableSize anymore.
SegmentRatioPortLocationModel now uses the path geometry from the edge's style instead
of bend locations to determine segments.
TreeNodesSource and AdjacencyNodesSource no longer inherit
from NodesSource.
TreeBuilder#setData only accepts a TreeNodesSource and
no longer a NodesSource as a parameter.
XML namespace for yFiles Java has changed and is now http://www.yworks.com/xml/yfiles-for-java/4.0.
GraphModelManager#LabelLayerPolicy property has been removed.
Use the more specific properties NodeLabelLayerPolicy, EdgeLabelLayerPolicy,
and PortLabelLayerPolicy instead.
GridVisualCreator has been renamed to GridRenderer.
CanvasComponent#toViewCoordinates to worldToViewCoordinates.
CanvasComponent#toWorldCoordinates to viewToWorldCoordinates.
IRenderContext#toViewCoordinates to worldToViewCoordinates.
InputMode in GraphComponent is no
longer null but is now set to GraphViewerInputMode.
HighlightIndicatorManager#SelectionModel to Items.
SelectionIndicatorManager#SelectionModel to Items.
SelectionIndicatorManager#Model to Domain.
MOVE_FOCUS_BACK and MOVE_FOCUS_FORWARD to MOVE_FOCUS_LEFT and MOVE_FOCUS_RIGHT.
CanvasComponent#AutoDragEnabled property to AutoScrollingOnBoundsEnabled.
CanvasComponent#AutoDragInsets property to AutoScrollPadding.
ViewportChanges#AUTO_DRAG field to AUTO_SCROLL_ON_BOUNDS.
CanvasComponent#AutoDragEnabled property to AutoScrollingOnBoundsEnabled.
CanvasComponent#AutoDragInsets property to AutoScrollPadding.
ViewportChanges#AUTO_DRAG field to AUTO_SCROLL_ON_BOUNDS.
DragSize, DragTime and DoubleClickSize properties of the CanvasComponent
class.
IEventRecognizer have been removed.
CanvasComponent which are related to input devices and the corresponding
IEventRecognizer constants have been renamed to conform to platform conventions.
CanvasComponent#RenderTree property now encapsulates all low-level render
object related API which was previously available directly on CanvasComponent.
RootGroup, BackgroundGroup, ForegroundGroup, ContentGroup, SelectionGroup, FocusGroup, HighlightGroup, InputModeGroup), the helper methods relating to render tree elements (hitElementsAt, isHit, getVisual, getVisualCreator, getCanvasObjects (now getElements), getBounds).
ICanvasObject(Group) has
been moved to RenderTree as well, such as creating new elements or groups,
changing the parent group or removing a render tree element.
CanvasComponent#setContentRect method has been removed in favor of
the setter of the ContentBounds property.
GraphModelManager constructor no longer has canvasComponent and
contentGroup parameters. Also, the ContentGroup property can no
longer be set directly. Instead, the install method now sets both CanvasComponent and ContentGroup.
Canvas word components in properties and method parameter names to CanvasComponent.
ViewportLimiter#limitViewport now uses a signature that works with the new type
ViewportDescriptor and respects the new ViewportLimitingMode enum.
ViewportLimiter#HonoringBothDimensionsEnabled is now called ViewportLimiter#StrictBoundsContainmentEnabled and the default value changed to false.
ICanvasObject#Group property has been renamed to Parent.
GraphModelManager instances, the install
method has to be called either directly or indirectly by assigning the GraphModelManager to the GraphComponent#GraphModelManager
property.
CanvasComponent#MouseWheelBehavior to MouseWheelBehavior.SCROLL.or(MouseWheelBehavior.ZOOM)
MouseWheelBehavior.SCROLL.or(MouseWheelBehavior.ZOOM):
Mousewheel without any modifier zoomsMousewheel+shift pans horizontallyMousewheel+ctrl pans verticallyMousewheel+alt is center zoomICanvasObjectDescriptor interface has been renamed to IObjectRenderer and its isDirty method has been removed.
ICanvasObject interface has been renamed to IRenderTreeElement and its UserObject property has
been renamed to Tag. Its Descriptor
property has been replaced with property Renderer of type IObjectRenderer.
ICanvasObjectGroup interface has been renamed to IRenderTreeGroup.
ICanvasObjectInstaller interface has been removed.
ICanvasObjectDescriptor class are no longer necessary, and thus,
this class has been removed. There is now a IObjectRenderer#VOID_OBJECT_RENDERER singleton.
IFocusIndicatorInstaller, IHighlightIndicatorInstaller, and ISelectionIndicatorInstaller interfaces have been renamed to IFocusRenderer, IHighlightRenderer, and ISelectionRenderer respectively and now inherit from IObjectRenderer instead of ICanvasObjectInstaller. Classes
implementing these interfaces have been changed accordingly (EdgeStyleDecorationInstaller, LabelStyleDecorationInstaller,
NodeStyleDecorationInstaller, and PortStyleDecorationInstaller have been renamed to EdgeStyleIndicatorRenderer, LabelStyleIndicatorRenderer,
NodeStyleIndicatorRenderer, and PortStyleIndicatorRenderer respectively).
getInstaller methods on the ModelManager, FocusIndicatorManager, HighlightIndicatorManager, and SelectionIndicatorManager classes are now called getRenderer and return IObjectRenderer. Similarly, the
getCanvasObjectGroup methods of these classes have been renamed to getRenderTreeGroup.
GraphModelManager have been adjusted to reflect the ICanvasObjectDescriptor and ICanvasObject renamings. More
precisely, DEFAULT_EDGE_DESCRIPTOR, DEFAULT_LABEL_DESCRIPTOR, DEFAULT_NODE_DESCRIPTOR,
DEFAULT_PORT_DESCRIPTOR, EdgeDescriptor, EdgeLabelDescriptor, NodeDescriptor, NodeLabelDescriptor, PortDescriptor, PortLabelDescriptor, ProvidingUserObjectOnMainCanvasObjectEnabled, getCanvasObject, getCanvasObjectGroup, getCanvasObjectGroup, getCanvasObjectGroup, getCanvasObjectGroup, and getMainCanvasObject have been
renamed to DEFAULT_EDGE_RENDERER, DEFAULT_LABEL_RENDERER, DEFAULT_NODE_RENDERER, DEFAULT_PORT_RENDERER, EdgeRenderer, EdgeLabelRenderer, NodeRenderer, NodeLabelRenderer, PortRenderer, PortLabelRenderer, ProvidingRenderTagOnMainRenderTreeElementEnabled, getRenderTreeElement, getRenderTreeGroup, getRenderTreeGroup, getRenderTreeGroup, getRenderTreeGroup, and getMainRenderTreeElement
respectively.
ItemModelManager have been adjusted to reflect the ICanvasObjectDescriptor and ICanvasObject renamings. More
precisely, CanvasObjectGroup, Descriptor, getCanvasObject, getCanvasObjectGroup, and getDescriptor have been
renamed to RenderTreeGroup, Renderer,
getRenderTreeElement, getRenderTreeGroup, and getRenderer respectively.
RectangleIndicatorInstaller, OrientedRectangleIndicatorInstaller, and PointSelectionIndicatorInstaller classes have been removed.
IStripeInputVisualizationHelper interface is now called IStripeInputRenderer and extends IObjectRenderer, the DefaultStripeInputVisualizationHelper class has been removed.
StripeDecorator#InputVisualizationDecorator property has been renamed to InputRenderer.
DefaultPortCandidateDescriptor class is now called PortCandidateRenderer. The class no longer has the CANDIDATE_DRAWING_VALID_NON_FOCUSED_KEY, CANDIDATE_DRAWING_VALID_FOCUSED_KEY, CANDIDATE_DRAWING_INVALID_NON_FOCUSED_KEY, and CANDIDATE_DRAWING_INVALID_FOCUSED_KEY static properties.
PortCandidateRenderer property on the CreateEdgeInputMode class replaces the CandidateDescriptor and ClosestCandidateDescriptor properties.
PortCandidateRenderer on the PortRelocationHandle class replaces the createPortCandidateDescriptor and createCurrentPortCandidateDescriptor protected methods.
PortCandidateRenderer on the PortRelocationHandleProvider allows customizing the renderer for the port candidates.
ViewportRectangleRenderer property on the OverviewInputMode class allows customizing the renderer for the viewport rectangle. It
replaces the Template property and the VIEWPORT_TEMPLATE_KEY static property.
MarqueeSelectionInputMode#MarqueeRenderer property replaces the Template property and MARQUEE_RECTANGLE_TEMPLATE_KEY static property.
LassoSelectionInputMode#LassoRenderer property replaces the FinishRegionTemplate and FinishRegionHighlightTemplate properties and the FINISH_REGION_TEMPLATE_KEY and FINISH_REGION_HIGHLIGHT_TEMPLATE_KEY static properties. Also, the LASSO_PEN_KEY and LASSO_FILL_KEY static properties have
been removed.
CandidateRenderer property on the LabelPositionHandler class replaces the CandidateTemplate and HighlightTemplate
properties and the CANDIDATE_TEMPLATE_KEY and HIGHLIGHT_TEMPLATE_KEY static properties.
getCanvasObject and getCanvasObjects methods of
class CanvasComponent have been renamed to getRenderTreeElement and have been moved to the GraphModelManager class.
createSnapResultCanvasObjectDescriptor method of class SnapContext has been renamed to createSnapResultRenderer.
GraphVisualCreator property of class GraphOverviewComponent is now called GraphOverviewRenderer
and of type IObjectRenderer.
OverviewGraphVisualCreator class is now called GraphOverviewRenderer and implements IObjectRenderer instead
of IVisualCreator.
FocusIndicatorManager#PropertyChanged with event FocusedItemChanged.
FocusIndicatorManager#onPropertyChanged to onFocusedItemChanged and changed signature.
EdgeStyleDecorationInstaller, LabelStyleDecorationInstaller, NodeStyleDecorationInstaller, and
PortStyleDecorationInstaller classes were removed. Use the EdgeStyleIndicatorRenderer etc. classes instead.
addSelection and removeSelection methods on the
SelectionIndicatorManager class were removed. Instead, modify the Items property directly.
FocusIndicatorManager#ShowFocusPolicy changed its default to the new WHEN_USING_KEYBOARD. The old policy called ONLY_WHEN_FOCUSED is now called WHEN_FOCUSED.
HighlightIndicatorManager now by default uses the new GraphComponent#Highlights collection. Adding, removing, and clearing highlights should
now be done via the GraphComponent#Highlights property.
ISelectionModel interface has been removed and usages have been replaced by IObservableCollection. Thus, selecting an element works by calling Collection#add, deselecting works by calling Collection#remove, and checking the selection state is done via Collection#contains.
ItemSelectionChangedEventArgs have been replaced by usages of ItemEventArgs and there are now two separate events for adding/selecting and
removing/deselecting elements from the collections. The ItemSelectionChangedEventArgs
type has been removed.
IGraphSelection and IStripeSelection have been removed from the public API.
ShapeVisual#Fill property has been renamed to Paint.
TextAlignment enum has been renamed to HorizontalTextAlignment.
VerticalAlignment enum has been renamed to VerticalTextAlignment.
LabelStyle#TextAlignment property has been renamed to
LabelStyle#HorizontalTextAlignment.
GroupNodeStyle's tab width is set to 0, the tab width does not reduce the corner
radius of the style's outline anymore. However, it still forces the corner radius of the style's inner corners (i.e.
the corners of the content area on the side of the style's tab) to 0.
Arrow is now immutable and comes with separate scale factors for arrow
length and width. The default arrow was renamed to ArrowType#STEALTH, circle arrow
to ArrowType#ELLIPSE, and simple arrow to ArrowType#OPEN. The short arrow type was removed.
Wrapped property of CollapsibleNodeStyleDecorator, ShadowNodeStyleDecorator,
and IconLabelStyle has been renamed to WrappedStyle.
DelegatingNodeStyle and CompositeNodeStyle style
variants may be used.
TableNodeStyle#copyBackgroundStyle method has been removed. The clone method doesn't deep copy the background style but just uses it for the clone as
well, which also was the previous default behavior.
BevelNodeStyle, PanelNodeStyle and
ShinyPlateNodeStyle have been removed.
TextWrappingShape and ShapeNodeShape:
TRIANGLE_POINTING_DOWN.
HEXAGON_STANDING.
ShapeNodeShape: SHEARED_RECTANGLE, SHEARED_RECTANGLE2, TRAPEZ,
TRAPEZ2,
FAT_ARROW, and FAT_ARROW2.
ArrowNodeStyle for more flexible visualizations of these geometries.
STAR5_UP to STAR5, removed old (down pointing) STAR5.
GeneralPathNodeStyle for stars and polygons with an
arbitrary number of points/edges and configurable rotation angle.
TextWrappingShape: SHEARED_RECTANGLE, SHEARED_RECTANGLE2, TRAPEZ, and
TRAPEZ2.
IArrow interface now requires the CropAtPort
property to be provided by implementations. For backward compatibility return false in simple subclasses.
VOID_NODE_STYLE, VOID_EDGE_STYLE, VOID_LABEL_STYLE, VOID_PORT_STYLE, VOID_STRIPE_STYLE classes, and the respective renderer classes were removed. Use one of the
following constant singletons instead: INodeStyle#VOID_NODE_STYLE, IEdgeStyle#VOID_EDGE_STYLE, ILabelStyle#VOID_LABEL_STYLE, IPortStyle#VOID_PORT_STYLE, and IStripeStyle#VOID_STRIPE_STYLE.
VoidShapeGeometry and VoidPathGeometry classes were
removed. Use one of the following constant singletons instead: IShapeGeometry#VOID_SHAPE_GEOMETRY and IPathGeometry#VOID_PATH_GEOMETRY.
IVisualTemplate interface and the templating mechanism has been removed and replaced by
the IObjectRenderer API.
Pen returning the Pen constants have been replaced by
corresponding static fields (e.g. Pen.getAzure() by Pen.AZURE).
Pen#EndCap property has been renamed to EndLineCap.
MemoryImageNodeStyle#BitmapSource has been renamed to Images.
CanvasComponent's LastEventLocation property has
been removed. Use getLastPointerEvent().getLocation() instead.
CanvasComponent's LastInputEvent property has
been renamed to LastPointerEvent to better reflect its type.
IGridConstraintProvider interface has been removed, its usages have been
replaced with the existing item-specific interfaces, and the unused ILabelGridConstraintProvider and ILabelOwnerGridConstraintProvider have been removed. In addition, the GridConstraintProvider class is no longer generic and implements all remaining
item-specific interfaces.
PortRelocationHandle#createDummyEdgeVisualCreator method. To change the
preview edge's style overwrite PortRelocationHandle#createPreviewEdge instead.
LabelPositionHandler#setPosition method has been removed.
LabelPositionHandler#UsingFinderEnabled property has been removed. Use the new
UseParameterFinderRecognizer property instead.
LabelPositionHandler#useParameterFinder method has been renamed to shouldUseParameterFinder.
createEdgeCreationInputModeContext method on the CreateEdgeInputMode class has been removed. Use or override the createInputModeContext method, instead.
ToolTipQueryEventArgs class is now named QueryToolTipEventArgs to properly match the corresponding event's name.
DoubleClickPolicy to ClickReportingPolicy.
ClickInputMode#DoubleClickPolicy to ClickReportingPolicy.
DoubleClickPolicy#INITIAL_SINGLE_AND_DOUBLE_CLICK to ClickReportingPolicy#INSTANT.
DoubleClickPolicy#DOUBLE_CLICK_ONLY to WAIT_FOR_DOUBLE_CLICK.
DoubleClickPolicy#BOTH_SINGLE_CLICKS_AND_DOUBLE_CLICK.
ClickInputMode#ClickReportingPolicy to ClickReportingPolicy#INSTANT.
preventNextDoubleClick method from ClickInputMode class. Use the cancel method instead.
LassoSelectionEventArgs#SelectionPath property has been renamed to Path.
marqueeSelect and lassoSelect methods of
GraphEditorInputMode and GraphViewerInputMode, that take
an enumerable and predicate, have been removed while the other marqueeSelect and
lassoSelect method got an additional parameter of type SelectionPolicy.
DropInputMode#MousePosition to PointerPosition.
ItemDropInputMode#SnappedMousePosition to SnappedPointerPosition.
IHitTester interface has been removed. Instead, a parameter of
type GraphItemTypes has been added to its iterateHits
method.
LabelDropInputMode#UsingBestMatchingParameterEnabled and PortDropInputMode#UsingBestMatchingParameterEnabled to UsingLocationForParameterEnabled.
InputModeItemEventArgs instead of ItemEventArgs. These are
the events:
CreateBendInputMode: BendCreated.
CreateEdgeInputMode: StartPortCandidateChanged, EndPortCandidateChanged, EdgeCreated,
PortAdded, EdgeCreationStarted.
GraphEditorInputMode: LabelEdited, LabelAdded, NodeCreated, PortAdded.
ItemDropInputMode and inheritors: ItemCreated.
NavigationInputMode: GroupCollapsing, GroupCollapsed, GroupExpanding, GroupExpanded, GroupEntering, GroupEntered, GroupExiting, GroupExited.
TableEditorInputMode: DeletedItem.
EditLabelInputMode: LabelAdded, LabelEditingStarted, LabelEditingCanceled, LabelEdited.
StripeDropInputMode: StripeCreated.
InputModeItemChangedEventArgs:
GraphEditorInputMode#DeletedItem: InputModeItemChangedEventArgs instead of IEventListener<ItemEventArgs>.
GraphEditorInputMode#EdgePortsChanged: InputModeItemChangedEventArgs instead of EdgeEventArgs.
GraphEditorInputMode#NodeReparented: InputModeItemChangedEventArgs instead of NodeEventArgs.
EditLabelInputMode#LabelDeleted: InputModeItemChangedEventArgs instead of LabelEventArgs.
CreateEdgeInputMode class:
ResolvingSourcePortCandidatesEnabled to ResolvingStartPortCandidatesEnabled.
ResolvingTargetPortCandidatesEnabled to ResolvingEndPortCandidatesEnabled.
SourcePortCandidateChanged to StartPortCandidateChanged.
TargetPortCandidateChanged to EndPortCandidateChanged.
SourcePortCandidate to StartPortCandidate.
TargetPortCandidate to EndPortCandidate.
SnappingToTargetCandidateEnabled to SnappingToEndCandidateEnabled.
CancelGestureOnInvalidTarget to CancelingGestureOnInvalidEndEnabled.
SourceNodeDraggingCursor to StartPortOwnerDraggingCursor.
ShowSourcePortCandidatesHitTestable to ShowStartPortCandidatesHitTestable.
onSourcePortCandidateChanged to onStartPortCandidateChanged.
onTargetPortCandidateChanged to onEndPortCandidateChanged.
SourcePortCandidateChanged to StartPortCandidateChanged.
TargetPortCandidateChanged to EndPortCandidateChanged.
getSource to getStartPortOwner.
getTarget to getEndPortOwner.
getSourcePortCandidateProvider to getStartPortCandidateProvider.
getTargetPortCandidateProvider to getEndPortCandidateProvider.
getSourcePortCandidates to getStartPortCandidates.
getTargetPortCandidates to getEndPortCandidates.
getSourcePortCandidate(IEnumerableIPortCandidate>, PointD, boolean) to selectStartPortCandidate.
getClosestCandidate to selectClosestCandidate.
getClosestSourceCandidate to selectClosestStartCandidate.
getClosestTargetCandidate to selectClosestEndCandidate.
SourcePortCandidateHitRadius to StartPortCandidateHitRadius.
updateTargetLocation to updateEndLocation.
ShowingTargetHighlightEnabled to ShowingEndHighlightEnabled.
updateTargetHighlight to updateEndHighlight.
DummyTargetNode to PreviewEndNode.
DummyTargetNodePort to PreviewEndNodePort.
ShowPortCandidates#SOURCE to Start and
ShowPortCandidates#TARGET to End.
CreateEdgeInputMode#createDummyEdgeGraph, CreateEdgeInputMode#createDummyEdge, CreateEdgeInputMode#createDummyTargetNode, CreateEdgeInputMode#createDummyTargetNodePort, CreateEdgeInputMode#updateDummyEdgeSourcePort, and CreateEdgeInputMode#updateDummyEdgeTargetPort.
InputModeContext property has been removed from the IInputMode interface. In input mode implementations, the property has been renamed to
ParentInputMode and changed to protected access to prevent incorrect usage.
ICanvasContext#DEFAULT and ICanvasContext#create
have been removed. A valid ICanvasContext can be retrieved from the CanvasComponent#CanvasContext property.
IInputModeContext#EMPTY has been removed. A valid IInputModeContext can be retrieved using CanvasComponent#InputModeContext property.
IInputModeContext interface have
been removed. Appropriate IInputModeContext implementations can be obtained using
InputModeContext class with CanvasComponent#InputModeContext as parent context.
ALL_NODE_CANDIDATES and ALL_NODE_AND_EDGE_CANDIDATES on IEdgeReconnectionPortCandidateProvider have been replaced by the factory methods fromAllNodeCandidates and fromAllNodeAndEdgeCandidates.
The implementations now provide a port candidate for the unchanged port of the edge when collecting the port
candidates from the IPortCandidateProvider instances of the nodes and edges.
CreateEdgeInputMode's methods have been renamed:
getClosestSourceCandidate to selectClosestStartCandidate.
getClosestCandidate to selectClosestCandidate.
getClosestTargetCandidate to selectClosestEndCandidate.
CreateEdgeInputMode#StartPortCandidateHitRadius now is defined in view coordinates.
HandleTypes enums has been refactored to a non-flaggable HandleType enum, and the values have been adjusted.
Tag property has been added to the IHandle
interface. yFiles does not use the property and initializes it with null, but decorating handles
forward any values unmodified.
textProvider parameter for ToolTipInputMode's constructor has been
removed. An event handler for the QueryToolTip event can be registered
instead.
ICommand interface and its implementations have been replaced with the enum Command.
ICommand have been replaced with equally named constants of enum Command.
canExecute and execute and its CanExecuteChanged event in ICommand have been
replaced with CanvasComponent's canExecuteCommand and
executeCommand methods and the CanExecuteChanged
event, respectively.
KeyboardInputMode.
CanvasComponent and GraphComponent.
GraphViewerInputMode,
GraphEditorInputMode, TableEditorInputMode, and TextEditorInputMode (e.g. createKeyboardInputMode). Set custom instances using the properties, instead.
ToolTip and TextArea properties on classes ToolTipInputMode and TextEditorInputMode, respectively. Set custom instances using the properties, instead.
getBounds, getVisual, getVisualCreator, and isHit from CanvasComponent class. Use the respective methods of RenderTree class instead.
MouseHoverInputMode class has been renamed to ToolTipInputMode.
GraphViewerInputMode#MouseHoverInputMode and
GraphEditorInputMode#MouseHoverInputMode properties have been renamed to ToolTipInputMode.
NavigationInputMode#findNearestItem method now gets the startItem
as a parameter instead of the location of it, and this item is also included in the itemsToCheck
parameter. Implementations may use the new getReferenceLocation method to find the
starting location and should make sure not to return the startItem itself.
Should- methods of the input modes have been removed and replaced by predicate
properties.
GraphEditorInputMode#LabelTextChanged has been changed to LabelEdited to reflect the broader scope of changes allowed during label editing.
Similarly, GraphEditorInputMode#onLabelTextChanged is now named onLabelEdited.
GraphEditorInputMode to EditLabelInputMode: AutoRemovingEmptyLabelsEnabled, HidingLabelDuringEditingEnabled, TextEditorInputMode,
TextEditorInputModeConfigurator, createLabel,
createLabelCore, editLabelCore, openTextEditor, LabelDeleted, LabelTextEditingStarted, LabelTextEditingCanceled, and ValidateLabelText. The events LabelEditing
and LabelAdding have been moved to EditLabelInputMode and renamed to QueryLabelEditing
and QueryLabelAdding, respectively, to clarify their purpose.
TableEditorInputMode to EditLabelInputMode: AutoRemovingEmptyLabelsEnabled, HidingLabelDuringEditingEnabled, TextEditorInputMode,
TextEditorInputModeConfigurator, createLabel,
createLabelCore, editLabelCore, openTextEditor, LabelDeleted, LabelTextEditingStarted, LabelTextEditingCanceled, and ValidateLabelText. The events LabelEditing
and LabelAdding have been moved to EditLabelInputMode and renamed to QueryLabelEditing
and QueryLabelAdding, respectively, to clarify their purpose.
Mouse2DEventArgs with PointerEventArgs.
ClickInputMode events except for Clicked. Click buttons and click count can be obtained from the ClickEventArgs.
getBendsInPath has been added to the IBendSelectionTester interface and is used to check for bends that should be lasso
selected.
getPortsInPath has been added to the IPortSelectionTester interface and is used to check for ports that should be lasso
selected.
InvalidItemsDiscardingEnabled in ItemHoverInputMode
has been renamed to IgnoringInvalidItemsEnabled, and its behavior was reversed.
ItemDropInputMode#DragDropped event is now raised after the drop gesture has
actually finished, in line with how similar events are raised elsewhere.
ArcEdgeStyle, ArrowEdgeStyle, or
BridgeEdgeStyle are no longer shown when selecting these edges. Additionally, marquee
and lasso selection will not select these bends anymore even if they lie in the selection rectangle.
MoveLabelInputMode class and its corresponding property on GraphEditorInputMode have been removed. Label movement is now handled directly by MoveInputMode. Most customizations related to label movement (as opposed to
the move gesture in general) can now be done on LabelPositionHandler, instead.
MoveInputMode and HandleInputMode sub-modes of GraphEditorInputMode no longer have a pre-set SnapContext.
Instead, they take the SnapContext from the InputModeContext. That way, changing the SnapContext on
GraphEditorInputMode will also affect the sub-modes.
HoveredItemChangedEventArgs is no longer a subclass of the unrelated ItemEventArgs.
Dummy in names with a more descriptive term. In particular:
CreateEdgeInputMode, DummyEdge, DummyEdgeGraph, DummyTargetNode,, DummyTargetNodePort, updateDummyEdgeSourcePort, updateDummyEdgeTargetPort, getDummyEdgeSnapLines,
and CreateDummyBend have been renamed to PreviewEdge, PreviewGraph, PreviewEndNode, PreviewEndNodePort,
updatePreviewEdgeStartPort, updatePreviewEdgeEndPort, getPreviewEdgeSnapLines,
and createPreviewBend.
Visualization#DUMMY enum value has been renamed to Visualization#PLACEHOLDER.
PortRelocationHandle, createDummyEdge has been
renamed to createPreviewEdge.
DeletedSelection of GraphEditorInputMode now uses ItemsEventArgs instead of
SelectionEventArgs.
doStartEdgeCreation method on the CreateEdgeInputMode class is now called startEdgeCreation.
doStartDrag method on the MoveInputMode class is
now called startDrag.
beginDragging method on the HandleInputMode class
is now called startDrag.
addLabel method on GraphEditorInputMode
is now called startLabelAddition.
editLabel method on GraphEditorInputMode
is now called startLabelEditing.
TextEditorInputMode#TextAreaPlacementPolicy to TextAreaPlacementPolicy#MOVE_TEXT_AREA.
GraphViewerInputMode#findItems and GraphEditorInputMode#findItems methods now considers the actual z-order of the hit
items.
GraphEditorInputMode's MoveUnselectedItemsInputMode now only moves unselected items. Previously it also
moved selected items despite its name.
MultiSelectionRecognizer of GraphEditorInputMode and GraphViewerInputMode are not used
anymore for marquee and lasso selection. Instead, MarqueeSelectionInputMode and LassoSelectionInputMode have their own modifiers for different selection policies.
LabelDropInputMode#isValidLabelOwner method now only accepts instances of FreeLabelModel or that the draggedLabel's owner type matches the owner type
e.g. INode, IEdge, or IPort.
NodeReshapeHandleProvider#RatioReshapeRecognizer property
and ReshapeHandlerHandle has been changed to null. If no custom
recognizer is set, ReshapeHandlerHandle uses the new HandleInputMode#isDirectionalConstrained method instead if a HandleInputMode is found in the IInputModeContext.
EnableSnappingRecognizer in CreateEdgeInputMode, HandleInputMode, and MoveInputMode has been changed from CTRL_UP to ALT_UP.
DisableSnappingRecognizer in CreateEdgeInputMode, HandleInputMode, and MoveInputMode has been changed from CTRL_DOWN to ALT_DOWN.
CenterReshapeRecognizer in NodeReshapeHandleProvider and ReshapeHandlerHandle has been
changed from ALT_IS_DOWN to CTRL_IS_DOWN.
ReparentNodeHandler#ReparentRecognizer has been changed from
SHIFT_IS_DOWN to CTRL_IS_DOWN.
GraphEditorInputMode#GroupingOperationsAllowed is now true by default.
CreateEdgeInputMode to ensure consistency and symmetry
between gesture cancellation and completion.
EdgeCreationStarted only after the start
node dragging has finished and the end port candidate is determined.
GestureFinishing, allowing users to apply final updates to the end port.
GestureStarting, GestureStarted.
GestureCanceling, GestureCanceled.
EdgeCreationStarted, GestureFinishing, EdgeCreated, GestureFinished.
EdgeCreationStarted and EdgeCreated
events provide now arguments of type ItemEventArgsIEdge>.
IEdgeReconnectionPortCandidateProvider#fromSourceAndTarget.
GraphViewerInputMode / GraphEditorInputMode: the ClickHitTestOrder default value has been changed to GraphItemTypes#ALL which means that the default order is the Z-Order but with a
prioritization for elements behind labels.
GraphViewerInputMode: The MoveViewportInputMode's
priority has been changed to 190.
GraphEditorInputMode: The sub input mode's priorities have been changed to the
following order: WaitInputMode, KeyboardInputMode, HandleInputMode, ClickInputMode, CreateEdgeInputMode, MoveSelectedItemsInputMode,
MoveUnselectedItemsInputMode, CreateBendInputMode, MoveViewportInputMode, LassoSelectionInputMode, MarqueeSelectionInputMode, ItemHoverInputMode, NavigationInputMode, AbstractPopupMenuInputMode, NodeDropInputMode, LabelDropInputMode, PortDropInputMode, ToolTipInputMode, EditLabelInputMode.
CreateEdgeInputMode#PortCandidateResolutionRecognizer has been
changed from SHIFT_IS_DOWN to CTRL_IS_DOWN.
CreateEdgeInputMode#EnforceBendCreationRecognizer has been
changed form CTRL_IS_DOWN to ALT_IS_DOWN.
Command#COLLAPSE_GROUP now uses Alt+Left.
Command#EXPAND_GROUP now uses Alt+Right.
Command#ENTER_GROUP now uses Alt+Down.
Command#EXIT_GROUP now uses Alt+Up.
Command#TOGGLE_EXPANSION_STATE now uses Alt+Shift+Left and
Alt+Shift+Right.
Command#INCREASE_ZOOM now uses Ctrl+Plus.
Command#DECREASE_ZOOM now uses Ctrl+Minus.
TextEditorInputMode#AutoCommittingOnFocusLostEnabled is now
true . This means that the text of an edited label is commited instead of discarded when the text box
loses the focus e.g. by clicking on the canvas.
IPositionHandler anymore so dragging a
selected edge doesn't move all its bends.
GraphEditorInputMode#OrthogonalEdgeEditingContext
property. This can be done by enabling the PolylineEdgeStyle#OrthogonalEditingEnabled properties of the styles, by setting an
apropriate FallbackEdgeHelperProvider on the used OrthogonalEdgeEditingContext or by providing an IOrthogonalEdgeHelper in the edges' lookup.
NavigationInputMode now interprets the direction of arrow keys in view coordinates by
default.
IPositionHandler implementation.
CreateEdgeInputMode it was previously possible to define a fallback for getPortOwner if IHitTester was removed. This option for
defining a fallback is removed and always returns null.
CreateBendInputMode behavior: Previously, dragging an existing bend
triggered the BendCreated event, causing confusion and limiting event handling
for new bend creation. This has been adjusted to ensure the event only fires when a new bend is created
interactively.
CanvasComponent#updateContentBounds now only considers the items in the RenderTree#ContentGroup instead of the RootGroup
when calculating the new bounds.
LabelSnapContext has been removed, and label snapping is now handled by GraphSnapContext:
GraphEditorInputMode#LabelSnapContext property and the GraphEditorInputMode#onLabelSnapContextChanged method have been removed.
CollectLabelSnapLineEventArgs class has been removed.
LabelSnapContext have been moved to GraphSnapContext and renamed.
ILabelSnapContextHelper interface and the LabelSnapContextHelper class have been removed. Instead, the ILabelSnapResultProvider interface and the classes LabelSnapResultProvider and LabelSnapReferenceProvider
have been added.
LabelDecorator#LabelSnapContextHelperDecorator property has been replaced by
the properties SnapReferenceProvider and SnapResultProvider.
CollectGraphSnapLinesEventArgs has been renamed to CollectSnapReferencesEventArgs. Its methods addFixedNodeSnapLine, addFixedSegmentSnapLine, addPortSnapLine, and addAdditionalSnapLine have been
removed and replaced by the single addSnapReference method.
GraphSnapContext has been refactored, and the following members have changed:
SnappingNodesToSnapLinesEnabled, SnappingBendsToSnapLinesEnabled, SnappingSegmentsToSnapLinesEnabled, SnappingBendAdjacentSegmentsEnabled, SnappingPortAdjacentSegmentsEnabled, SnappingEdgeLabelsEnabled, SnappingNodeLabelsEnabled, and SnappingPortLabelsEnabled have been replaced by the new properties SnappableItems and GridSnappableItems.
collectVisibleNodePairs method now takes the CollectSnapReferencesEventArgs the snap references shall be added to.
findSameWidthEntries and findSameHeightEntries have been removed. Instead, the SnapSize references describing to which size items can snap are provided by the SnapReferences property. Similarly, the FixedNodeSnapLines, FixedSegmentSnapLines, FixedPortSnapLines, and AdditionalSnapLines properties have been removed. The SnapReferences property should be used instead.
SnapLine#ResourceKey property has been removed along with most of the static
ResourceKey members used for snapping. Instead, a VisualizationType property of the enum type SnapReferenceVisualizationType is used to describe which visualization should be used for
the SnapLine.
SnapLine have been removed as they only provided properties used
for the visualization that are now available on SnapResult.
SnapTypes enum used by SnapResult has been replaced
by the new SnapConstraint class that supports finding common snap locations for SnapResult with different constraints.
snap and isSnapped methods of SnapResult have been removed. Instead, a Constraint
property of type SnapConstraint has been added that is used to merge possible SnapResult and check if a location is valid for a given SnapResult.
SnapResult#getVisualCreator method has been removed and is replaced by the new
ObjectRenderer property.
SnapResult have been adjusted:
createPointSnapResult has been renamed to createSnapResult.
createSnapLineSnapResult has been renamed to createLineSnapResult.
createLabelSnapResult has been removed.
SnapReference API. Most methods now take one instance of a SnapReference subclass like SnapLine or SnapGrid.
SnapState has been removed.
SnapContext properties of all input modes has been changed from SnapContext to GraphSnapContext.
SnapLine in their name have been renamed to include
SnapReference instead.
ReshapeRectangleContext#InitialBounds property has been renamed to InitialLayout.
GraphEditorInputMode#SnapContext property is now set per default and may not be
null. It is disabled per default.
GraphSnapContext#NodeToNodeDistance property to NodeDistance.
GraphSnapContext#EdgeToEdgeDistance property to EdgeDistance.
LABEL_MODEL_PARAMETER and PORT_LOCATION_MODEL_PARAMETER have been removed from the CloneTypes enum as those parameter are typically immutable, so cloning them has no effect.
IElementCopiedCallback has been renamed to IItemCopiedCallback.
GraphViewerInputMode's ElementsCopied event has
been renamed to ItemsCopied.
GraphEditorInputMode's ElementsCopied, ElementsCut, ElementsCopied, ElementsPasted and ElementsDuplicated events
were renamed to ItemsCopied, etc.
GraphClipboard, the ElementsCut,
-Cutting, -Copying, -Copied, -Pasting, -Pasted,
-Duplicating, and -Duplicated events were renamed to Items instead of Elements and use the new
GraphClipboardEventArgs. Also, the onElementCut,
-Copied-, and -Pasted methods were renamed to start with OnItem and take an
additional ClipboardOperationContext as a parameter.
GraphClipboard#removeElements has been renamed to removeItems.
GraphClipboard#isFoldingStateElement has been renamed to isFoldingStateItem.
GraphClipboard#createContext now takes an additional IInputModeContext parameter that should be returned in the new contexts lookup.
GraphClipboard#ClipboardGraph property is now read-only.
GraphClipboard's Copy method
have been rearranged so default values for optional parameters could be added.
createClipboardGraph, createToClipboardCopier, createFromClipboardCopier,
createDuplicateCopier, and createDefaultClipboardIdProvider from GraphClipboard that
were used to lazily initialize the corresponding properties have been removed.
GraphClipboard#paste now takes an enumerable of IModelItem as targetOwners parameter instead of a targetFilter
predicate.
GraphClipboard#isFoldingStateElement is now an instance method and doesn't have an
owner parameter anymore.
GraphClipboard#PasteDelta property has been renamed to PasteOffset. It is now modified by the GraphClipboard's cut , copy, paste, and duplicate methods instead of the corresponding methods on GraphEditorInputMode.
GraphEditorInputMode#PasteDelta property has been removed and replaced by the
new GraphClipboard#PasteOffsetIncrement property.
IClipboardHelper's methods cut, copy, and paste have been renamed to
onCut, onCopied, and onPasted.
IClipboardHelper's methods cut and copy don't return an object anymore and the object
parameter of paste and shouldPaste has
been removed. For cut/copy and paste the same IClipboardHelper method is now
used so any state that should be transfered can be stored in a custom implementation.
IClipboardHelper has new methods shouldDuplicate and
onDuplicated which have to be implemented, now.
GraphClipboard`s methods getMemento and getClipboardHelper have been removed.
GraphClipboard's protected copy and paste methods now take the new ClipboardOperationContext as parameter instead of the sourceGraphs and
filter predicates.
GraphClipboard's cut, copy, paste, and duplicate methods now use an IStreamIterable
instead of a filter predicate to determine the subgraph to copy.
GraphClipboard's Create*Filter methods have been removed.
GraphClipboard now uses ClipboardGraphCopier
instances for its ToClipboardCopier, FromClipboardCopier, and DuplicateCopier.
graph#ParentNodeDetectionModes has been reduced to contain only the mainly used
options. The option Root has been renamed to NONE, and the options ALLOW_SELF and FORCE as well as the MODE_MASK and MODIFIER_MASK have been removed. The getTargetNode
method can be overridden if the reduced modes are not suitable and may call the new findParentByPreviousParent method to simulate the old FORCE setting.
GraphClipboard`s getTarget methods now take an
additional ClipboardOperationContext parameter, and the getTarget overload for nodes also takes a pasteLocation as
an additional parameter.
GraphComponent instances now use a shared GraphClipboard
per default. To revert to the previous behavior, a new GraphClipboard instance can be
set on each GraphComponent.
FoldingLabelOwnerState#remove(FoldingLabelState) was renamed to removeLabel and the
FoldingLabelState#removeBend(FoldingBendState) was
renamed to removeBend.
IFolderNodeConverter has a new updateGroupNodeState method.
IFoldingEdgeConverter has a new updateMasterEdges method.
FolderNodeConverter now relies on FolderNodeDefaults to
configure initialization and update of states.
FoldingEdgeConverter and MergingFoldingEdgeConverter now
rely on FoldingEdgeDefaults to configure initialization and update of states.
IFolderNodeConverter and IFoldingEdgeConverter implementations. The default implementations already synchronize the
tags.
createGroup method now always creates a group
even if the isExpanded predicate specified in the FoldingManager#createFoldingView method specifies otherwise. Create the group on the
master graph if you want the predicate to be respected.
setLookupImplementation and getLookup
have been removed from Graph. Instead the lookup
method should be overridden if the default lookup behavior should be replaced.
setLookup and getLookup have been
removed from AbstractGraphWrapper. Instead, the lookup
method should be overridden if the default lookup behavior should be replaced.
node parameter of the methods in the interfaces IGroupPaddingProvider, INodeSizeConstraintProvider, and
IGroupBoundsCalculator has been removed.
edge parameter of the methods in the interfaces IEdgePortHandleProvider, IBendCreator, and IOrthogonalEdgeHelper has been removed.
label parameter of the methods in the interfaces ILabelModelParameterProvider, and ILabelModelParameterFinder
has been removed.
ISnapReferenceProvider#addSnapReferences has been
removed.
ILabelModelParameter parameter of ILabelModel#getContext has been removed and ILabelModel
doesn't extend ILookup anymore. Instead, the lookup returned by getContext should be used for all lookup calls.
IPortLocationModelParameter parameter of IPortLocationModel#getContext has been removed and IPortLocationModel doesn't extend ILookup anymore. Instead,
the lookup returned by getContext should be used for all lookup calls.
OrthogonalEdgeEditingContext#getOrthogonalEdgeHelper method has been replaced by
the FallbackEdgeHelperProvider and OrthogonalEdgeHelperProvider properties.
INodeInsetsProvider interface was renamed to IGroupPaddingProvider.
LookupDecorator#setImplementation to addConstant.
LookupDecorator#setFactory to addFactory.
LookupDecorator#setImplementationWrapper to addWrapperFactory.
LookupDecorator#hideImplementation to hide.
Decorator suffix. For
example, graphDecorator.EdgeDecorator.PositionHandlerDecorator.HideImplementation is now
graphDecorator.Edges.PositionHandler.Hide.
LookupDecorator#NullFallback. Instead, use the predicate of the addFactory method or return the original instance in the addWrapperFactory method.
LookupDecorator#DecoratingNullsEnabled. Instead, implement the desired
behavior in addWrapperFactory.
SimpleNode#LookupImplementation property, SimpleEdge, SimpleBend, SimpleLabel and SimplePort. Instead, use the new getDecorator method to adjust the item's lookup.
SimpleNode, SimpleEdge, SimpleBend, SimpleLabel and SimplePort classes are now sealed, and their lookup method
is no longer virtual. To adjust the item's lookup, use the getDecorator method.
CanvasComponent#inputModeContextLookup and CanvasComponent#InputModeContextLookupChain. Instead, use the new getInputModeContextDecoratorFor method to decorate the input mode context lookup.
EdgeDecorator#getDecoratorFor method, NodeDecorator, etc. no longer has the nullIsFallback and
decorateNull parameters.
GraphMLIOHandler#addInputMapperFuture and GraphMLIOHandler#addInputHandlerFactory have been removed, together with their support
classes.
addRegistryInputMapper and addRegistryOutputMapper methods have been removed from GraphMLIOHandler, since the MapperRegistry has been removed.
To read or write additional per-item data, use the addInputMapper or addOutputMapper methods, instead.
ItemMapping#Function to MapperFunction.
LayoutUtilities#morphLayout method to applyLayoutAnimated.
LayoutExecutor#Duration property to AnimationDuration.
LayoutExecutor#createMorphAnimation method to createLayoutAnimation.
LayoutGraphAdapter#PORT_DUMMY_NODE_DPKEY constant has been renamed to PORT_HELPER_NODE_DATA_KEY.
LayoutExecutor#FixPorts property is replaced by an ItemMapping PortPlacementPolicies, that allows to
specify a policy for the handling of each individual port.
LayoutExecutor#AutomaticEdgeGrouping has been removed. Edges at the same port are
now always automatically port grouped unless port groups have been defined explicitly.
LayoutGraphAdapter#AutomaticEdgeGrouping has been removed. Edges at the same port
are now always automatically port grouped unless port groups have been defined explicitly.
PortAdjustmentPolicy of LayoutExecutor class to an ItemMapping PortAdjustmentPolicies which allows for
different values for each port. The default is PortAdjustmentPolicy#LENGTHEN.
PortAdjustmentPolicy of LayoutGraphAdapter class to an
ItemMapping PortAdjustmentPolicies which allows
for different values for each port. The default is PortAdjustmentPolicy#LENGTHEN.
LayoutExecutor#Duration property to AnimationDuration.
ContextItemMapping class.
LayoutExecutor#SelectionModel and LayoutGraphAdapter#SelectionModel have been removed, meaning that selected items of the
IGraph are no longer automatically marked in the LayoutGraph via keys like the former LayoutKeys#AFFECTED_NODES_DPKEY. If the selected items should be marked for a specific
key of layout algorithms, then these items can always be provided via the specific LayoutData property of the layout algorithms.
TableLayoutConfigurator#prepare and LayoutExecutor#prepareTableLayout methods now return a LayoutGridData instance.
YGraphAdapter class to StructureGraphAdapter.
YGraphAdapter#YGraph property to StructureGraph.
YGraphAdapter#createEdgeEnumerable to createOriginalEdgeList.
YGraphAdapter#createNodeEnumerable to createOriginalNodeList.
YGraphAdapter#createEdgeList to createCopiedEdgeList.
YGraphAdapter#createNodeList to createCopiedNodeList.
YGraphAdapter#createMapper to createCopiedToOriginalNodeWrapper and createCopiedToOriginalEdgeWrapper.
YGraphAdapter#createDataMap to createOriginalToCopiedNodeWrapper and createOriginalToCopiedEdgeWrapper.
LayoutGraphAdapter#ORIGINAL_TAG_DP_KEY. Use the Tag property of the
layout items instead to get the original tag associated to the original IGraph items.
LayoutGraphAdapter class does no longer offer a method to create a layout graph
several times but is now meant to create exactly one layout graph copy which can be accessed via the LayoutGraph property and initialized with method LayoutGraphAdapter#initialize. After initialization, changing properties of the LayoutGraphAdapter has no effect anymore.
ItemMapping and ItemCollection have been removed. Instead the instances returned by the LayoutData properties should be used to configure the LayoutData.
ItemMapping parameter of GenericLayoutData#addItemMapping has been removed.
ItemCollection parameter of GenericLayoutData#addItemCollection has been removed.
SubgraphLayout class to SubgraphLayoutStage
and renamed the respective layout data class from SubgraphLayoutData to SubgraphLayoutStageData.
EdgeBundlingStage to BundledEdgeRouter.
GivenCoordinatesStage to GivenCoordinatesLayout.
GivenCoordinatesStageData to GivenCoordinatesLayoutData.
OrientationLayout class has been renamed to OrientationStage.
isOrientationMirrored, Transform, prepareTransform,
completeTransform, createOrientedNodeHalo, createOrientedInsets and createOrientedNodeSize.
BendConverter to BendSubstitutionStage.
OrientationLayout#HorizontalOrientation property has been removed. To check for
a horizontal orientation, check if Orientation property equals LayoutOrientation#LEFT_TO_RIGHT or LayoutOrientation#RIGHT_TO_LEFT.
GraphLayoutLineWrapper to LineWrappingStage.
HideGroupsStage to GroupHidingStage.
TemporaryGroupNodeInsertionStage to TemporaryGroupInsertionStage and the respective data class from TemporaryGroupNodeInsertionData to TemporaryGroupInsertionData.
BorderLineSide to Side, moved to namespace Layout and renamed its values:
North to Side#TOP, East to Side#RIGHT, South to Side#BOTTOM, and
West to Side#LEFT.
BorderLine and BorderLineSegment to namespace
Layout.
NodeHalo class. Halos are now specified as InsetsD and called node margins. in the corresponding LayoutData (e.g. HierarchicalLayoutData#NodeMargins).
NodeHalos have been renamed to NodeMargins for the following classes: AlignmentStageData, CircularLayoutData, CompactDiskLayoutData, ComponentLayoutData, RadialGroupLayoutData, RecursiveGroupLayoutData, HierarchicalLayoutData (formerly HierarchicLayoutData),
GenericLabelingData (formerly LabelingData), OrganicLayoutData, OrthogonalLayoutData, ClearAreaLayoutData, FillAreaLayoutData, PartialLayoutData, RadialLayoutData, CurveRoutingStageData, TabularLayoutData, EdgeRouterData, RadialTreeLayoutData (formerly BalloonLayoutData), TreeLayoutData.
AsIsLayerer#NodeHalo to FromSketchLayerAssigner#NodeMargin.
TemporaryGroupDescriptor#Halo to Margins.
NodeHalo#NODE_HALO_DPKEY to LayoutKeys#NODE_MARGIN_DATA_KEY.
LayoutExecutor#TargetBoundsInsets to TargetBoundsPadding.
GroupingKeys#GROUP_NODE_INSETS_DPKEY to GROUP_NODE_PADDING_DATA_KEY and moved the key to LayoutKeys.
GroupingKeys#MINIMUM_NODE_SIZE_DPKEY to LayoutKeys#MINIMUM_GROUP_NODE_SIZE_DATA_KEY.
InsetsGroupBoundsCalculator#DefaultInsets to GroupBoundsCalculator#DefaultPadding and InsetsGroupBoundsCalculator#NodeHalosConsiderationEnabled to GroupBoundsCalculator#NodeMarginsConsiderationEnabled.
TemporaryGroupDescriptor#Insets to Padding.
Graph#reInsertNode and reInsertEdge to LayoutGraph#reinsert.
LayoutGraphHider, the FiringGraphEventsEnabled
and Graph properties, and the hideEdges, hideSelfLoops, simplifyGraph, and hideMultipleEdges methods have been removed. Also, all methods to hide and unhide
various collections of nodes or edges have been replaced by hide and unhide methods that get an IStreamIterable of Node or Edge.
PortCalculator, IIntersectionCalculator, and IntersectionCalculatorKeys have been removed. Instead, the LayoutExecutor#PortAdjustmentPolicy property should be set to a suitable value.
BorderLine#createMin to createMinimum.
BorderLine#createMax to createMaximum.
GraphPartitionManager is removed, LayoutGraphHider
provides the same functionality.
PortCalculator#calculatePorts and PortCalculator#equalsEps have been removed.
ReverseEdgesStage: ReverseEdgesStage#findReversedTreeEdges, ReverseEdgesStage#reverseEdge and ReverseEdgesStage#reverseEdges.
MirrorModes to MirroredOrientations and OrientationLayout#MirrorMode to MirroredOrientations.
AbortHandler#CheckFailed property has been removed. To achieve the same
functionality, the LayoutAbortController (new name of the AbortHandler) can be subclassed, overriding its check
method which allows to detect calls to that method.
LayoutGraphHider: Method names have been standardized for consistency. Collection
parameters and return values are now of type IStreamIterable. Methods with
non-nullable parameters will now throw an exception if passed null values.
XOffset and YOffset
of the PortCandidate class by a single property Offset of type PointD.
SequentialLayout#Layouts property is now a read-only List<ILayoutAlgorithm>. The appendLayout,
appendLayouts, and removeAll methods have been
removed as their functionality is now handled by the list methods.
PortConstraints and PortCandidates have been unified and
renamed to LayoutPortCandidate.
PortDirections and PortSide have been unified as PortSides, and the enum values of the sides have been renamed.
PortCandidateSets have been replaced by NodePortCandidates, and collections of PortCandidates for
edges have been replaced by EdgePortCandidates.
LayoutData classes have been combined into a
sub-LayoutData Ports.
PortConstraintKeys have been moved to LayoutKeys.
SourcePortGroupIds,
TargetPortGroupIds, SourcePortCandidates, TargetPortCandidates)
have been moved to a sub-data accessible via the property Ports.
BufferedLayout class has been removed. To apply a layout algorithm on a copy of a
LayoutGraph instance use LayoutGraph#createCopy method
to get a copy, then apply the layout on it and, finally, write back the result using LayoutGraphCopyData#commitLayoutToOriginalGraph.
CompositeLayoutStage class has been removed. If a complex composition of layout
stages is required, the new LayoutStageStack class can be used instead. To get an
ILayoutAlgorithm that is then applied like CompositeLayoutStage was before, LayoutStageStack#linkCoreLayouts method must be called.
MinimumSizeGroupBoundsCalculator and InsetsGroupBoundsCalculator into the new GroupBoundsCalculator class.
LayoutMultiplexer has been removed. The features of ComponentLayout (COMPONENT_LAYOUT_DATA_KEY) or RecursiveGroupLayout (GROUP_NODE_LAYOUT_DATA_KEY) can be
used instead.
FixPortLocationStage and FixPortLocationStageData have been removed from the library. To correct the port locations
after applying a layout use the PortPlacementStage class.
PortPlacementStage#PathCorrection has been replaced by PortPlacementStage#RouteCorrectionPolicy of enum type RouteCorrectionPolicy.
SnapOuterPortsToNodeBorderStage class has been removed.
NormalizeGraphElementOrderStage. Use NodeComparison and EdgeComparison of LayoutExecutor instead.
ChannelEdgeRouter, OrthogonalPatternEdgeRouter and OrthogonalSegmentDistributionStage have been removed from the library. Their functionality
is superseded by the EdgeRouter routing algorithm.
EdgeRouter to generate a style that is similar to the removed
ChannelEdgeRouter, set the StopDuration
property to zero and use the predefined penalty configuration EdgeRouterCosts#LOW_QUALITY. It is however not compatible with advanced features
like integrated edge label placement.
PortConstraintConfigurator class has been removed.
PartitionLayout and PartitionLayoutData.
FamilyTreeLayout class has been removed.
SplitEdgeStage.
MinimumSizeGroupBoundsCalculator#MinimumNodeSizeDpKey and
InsetsGroupBoundsCalculator#GroupNodeInsetsDpKey have been removed. The bounds
calculator classes now always use the values defined via the keys LayoutKeys#MINIMUM_GROUP_NODE_SIZE_DATA_KEY and LayoutKeys#GROUP_NODE_PADDING_DATA_KEY. Using the IGraph
API, the insets and minimum sizes are registered automatically, so that this change has no effect.
SubgraphLayout#AffectedNodesDpKey and SubgraphLayout#AffectedEdgesDpKey have been removed. They were replaced by static
read-only keys SubgraphLayoutStage#SUBGRAPH_NODES_DATA_KEY and SubgraphLayoutStage#SUBGRAPH_EDGES_DATA_KEY.
LayoutKeys#NODE_ID_DPKEY and LayoutKeys#EDGE_ID_DPKEY.
HandleNaNCoordinatesStage has been removed.
MultiStageLayout class has been removed from the API. The HierarchicalLayout (formerly HierarchicLayout), OrganicLayout, OrthogonalLayout, TreeLayout, RadialTreeLayout (formerly BalloonLayout), SeriesParallelLayout, RadialLayout, CompactDiskLayout, and RadialGroupLayout (formerly CactusGroupLayout) classes now
directly implement ILayoutAlgorithm. These classes offer a new LayoutStages property that allows to access the mutable stack of ILayoutStage instances associated with the respective algorithm. In addition, the offer
different new properties to directly access frequently used stages.
EdgeRoutingStyle and those on edge-specific classes have been renamed to
RoutingStyle.
polyline#EdgeRoutingStyle enum has been renamed to router#RoutingStyle.
tree#EdgeRoutingStyle enum has been renamed to SingleLayerSubtreePlacerRoutingStyle.
LayeredRoutingStyle enum has been renamed to LevelAlignedSubtreePlacerRoutingStyle.
radial#EdgeRoutingStrategy enum has been renamed to radial#RoutingStyle.
partial#EdgeRoutingStrategy enum has been renamed to partial#RoutingStyle.
hierarchic#EdgeRoutingStyle enum has been renamed to hierarchical#RoutingStyle while the old RoutingStyle class has been
renamed to RoutingStyleDescriptor.
AbortHandler to LayoutAbortController.
MaximumDuration property is renamed to StopDuration in all public API usages.
StopDurations that were of type long are now of type TimeSpan.
StopDurations now affect pre-and post-processing steps defined directly on the layout algorithms, as
opposed to only the core algorithm.
LayoutAbortController (formerly AbortHandler) is no
longer available as a property on LayoutData classes but only on the LayoutExecutor.
LayoutAbortController (formerly AbortHandler) like getFromGraph have been removed since
the handler instance can easily be accessed via the LayoutGraphContext when working
with LayoutGraph.
LayoutAbortController#StopDuration and LayoutAbortController#CancelDuration has been changed from Duration#ZERO to Constants#MAX_DURATION. Previously,
ZERO was interpreted as unlimited time, which is not the case anymore.
hideGroupNodes and unhideGroupNodes of GroupHidingStage.
Segment class of BorderLine is now
the unnested BorderLineSegment class, and some of its members have been changed:
grow to enlarge, addOffset to addPositionOffset, min to MinPosition and max to MaxPosition.
BorderLine#adoptValues method.
BorderLine#FirstSegment, BorderLine#LastSegment, BorderLine#Segment#prev and
BorderLine#Segment#next from methods to read-only properties, and renamed prev to Previous.
BorderLine#prev and BorderLine#next. Use
methods BorderLineSegment#Previous and BorderLineSegment#Next instead.
Maps.
Result in their name:
Renamed CircularLayoutData#CircleIds to CircularLayoutData#CircleIdsResult, HierarchicLayoutData#LayerIndices to HierarchicalLayoutData#LayerIndicesResult, HierarchicLayoutData#SequenceIndices to HierarchicalLayoutData#SequenceIndicesResult, OrganicLayoutData#ZCoordinates to OrganicLayoutData#ZCoordinatesResult, RadialLayoutData#NodeInfos to RadialLayoutData#NodePlacementsResult, and ParallelEdgeRouterData#RoutedParallelEdges to ParallelEdgeRouterData#RoutedMultiEdgesResult.
IMapper instance.
AbstractDpKey and subclasses to accept a single string
parameter 'ID' for unique identification.
AbstractDpKey#DeclaringType and AbstractDpKey#Name.
AbstractDpKey class abstract.
TemporaryGroupDescriptor used by TemporaryGroupInsertionStage class to define temporary group nodes now does not allow that
properties YInsets, MinimumSize and Margins (formerly Halo) are null anymore. Previously
this was the default which is now InsetsD#Empty, SizeD#EMPTY and InsetsD#Empty, meaning that the behavior
does not change.
CopiedLayoutGraph class was removed from the API. To create a copy of a layout
graph, the new factory LayoutGraph#createCopy method may be used.
YPointPath class. Instead of this class an array or more generally an
IStreamIterable of type PointD[] is now used in API
members.
HierarchicLayout#ALTERNATIVE_EDGE_PATH_DPKEY, ClearAreaLayout#EXPANDED_NODE_ORIGINAL_EDGE_PATH_DPKEY and GivenCoordinatesStage#EDGE_PATH_DPKEY to IStreamIterablePointD>.
BusDescriptor properties BusPoints
and ComputedBusPoints to type PointD[].
IDataProvider interface and refactored the whole way data is registered
with a LayoutGraph instance. The replacement of IDataProvider is the generic IMapper interface. It allows
setting and getting data via an indexer.
Graph#addDataProvider and removeDataProvider. Data is now registered and removed using the methods on the new
LayoutGraphContext class (e.g. addItemData, addData, remove).
Graph#DataProviderKeys property.
GroupingKeys#GROUP_DPKEY, GroupingKeys#NODE_ID_DPKEY and GroupingKeys#PARENT_NODE_ID_DPKEY which were necessary to define grouping information
for LayoutGraph instances. This can now be achieved via the helper LayoutGraphGrouping class or directly via instance methods such as LayoutGraph#setIsGroupNode.
GraphDpKey class was replaced by ValueDataKey.
GraphTransformer class; use factory methods from LayoutTransformations class instead to create stages that apply transformation operations
on a LayoutGraph.
Comparator interface with Comparison function
delegates.
LayoutGraphUtilities class. The new Edge#resetPath method replaces LayoutGraphUtilities#resetPath method. The new ParallelEdgeRouter#routeEdgesParallel method replaces LayoutGraphUtilities#routeEdgesParallel method.
LayoutGraphUtilities#getBoundingBox were combined to one more general, moved
to LayoutGraph class and made an instance method.
LayoutGraph#reverseEdge now reverses the edge path too. To exchange only
source and target of an edge use LayoutGraph#changeEdge method.
SingleItemTItem> was removed.
Affected properties use ItemCollectionTItem> instead.
ItemMapping in LayoutData classes are
now named using plural consistently.
HierarchicalLayoutData#LayerIndicesResult, HierarchicalLayoutData#SequenceIndicesResult, HierarchicalLayoutData#GivenLayersIndices, RadialLayoutData#LayerIds and CircularLayoutData#CircleIdsResult has been changed from primitives to their boxed type.
Null as value means that nothing was published for an item.
HierarchicalLayout#LAYER_INDEX_RESULT_DATA_KEY, HierarchicalLayout#SEQUENCE_INDEX_RESULT_DATA_KEY, GivenLayersAssigner#LAYER_INDEX_DATA_KEY, RadialLayout#LAYER_ID_DATA_KEY and CircularLayout#CIRCLE_ID_RESULT_DATA_KEY has been changed from primitives to their boxed type.
Null as value means that the nothing was published for an item.
DefaultDrawingDistanceCalculator#SwimlaneDistanceOptimizationEnabled property
has been removed. The behavior does not change and is the same as the old default where the property was disabled.
Override DrawingDistanceCalculator#getMinimumDistance method and assign zero to
nodes that are in different rows/columns to get the same behavior as when previously enabling the property.
SimplexNodePlacer#SwimLaneCrossingWeight has been renamed to LayoutGridCrossingWeight. Note that the class has been renamed to CoordinateAssigner.
GroupCompactionStrategy.
SimplexNodePlacer#GroupCompactionStrategy to GroupCompactionEnabled and changed its type to boolean.
SequenceConstraintData of the HierarchicalLayoutData placeBefore and placeAfter were replaced by placeInOrder.
LayerConstraintData of the HierarchicalLayoutData placeAbove and placeBelow were replaced by placeInOrder.
HierarchicalLayout#GridSpacing: made grid spacing behavior consistent across all
layouts by throwing an exception for negative values.
NodeLayoutDescriptor#NodeLabelMode was removed. If node labels shall be considered
by the layout algorithm, they are now considered during all phases. In particular, self-loops do not overlap node
labels anymore.
NodeLabelMode enum was removed.
LayerType to HierarchicalLayoutLayerType.
DefaultLayerSequencer to DefaultSequencer.
HierarchicLayout, which is renamed to HierarchicalLayout.
HierarchicLayout#StopAfterLayeringEnabled/Sequencing to HierarchicalLayoutCore.
HierarchicLayout properties BackLoopRouting & BackLoopRoutingForSelfLoopsEnabled with HierarchicalLayoutEdgeDescriptor#BackLoopRoutingEnabled, where it can now be specified
per edge (HierarchicalLayoutData#EdgeDescriptors) or for all edges at once (HierarchicalLayout#DefaultEdgeDescriptor).
SourcePortOptimizationEnabled and TargetPortOptimizationEnabled from HierarchicalLayoutEdgeDescriptor class.
LayerConstraintData no longer inherits from LayoutData.
SequenceConstraintData no longer inherits from LayoutData.
IPortAllocator to IHierarchicalLayoutPortAssigner.
DefaultPortAllocator to HierarchicalLayoutPortAssigner.
HierarchicLayout#INCREMENTAL_HINTS_DPKEY in INCREMENTAL_NODE_HINTS_DATA_KEY and INCREMENTAL_EDGE_HINTS_DATA_KEY.
IncrementalHint in IncrementalNodeHint for nodes and IncrementalEdgeHint for edges.
HierarchicLayoutData#IncrementalHints in HierarchicalLayoutData#IncrementalNodes and HierarchicalLayoutData#IncrementalEdges. IncrementalNodes now only allows for specifying the nodes that should be inserted
incrementally during the layering phase. Additional options for incremental node insertion can be specified using
GenericLayoutData.
DefaultDrawingDistanceCalculator#NodeToNodeDistance property to DrawingDistanceCalculator#NodeDistance.
DefaultDrawingDistanceCalculator#EdgeToEdgeDistance property to DrawingDistanceCalculator#EdgeDistance.
HierarchicLayout#NodeToNodeDistance property to NodeDistance.
HierarchicLayout#EdgeToEdgeDistance property to EdgeDistance.
EdgeLayoutDescriptor to HierarchicalLayoutEdgeDescriptor.
HierarchicLayout#EdgeLayoutDescriptor to DefaultEdgeDescriptor.
HierarchicLayoutCore#EDGE_LAYOUT_DESCRIPTOR_DPKEY to HierarchicalLayout#EDGE_DESCRIPTOR_DATA_KEY.
HierarchicLayoutData#EdgeLayoutDescriptors to EdgeDescriptors.
NodeLayoutDescriptor to HierarchicalLayoutNodeDescriptor.
HierarchicLayout#NodeLayoutDescriptor to DefaultNodeDescriptor.
HierarchicLayoutCore#NODE_LAYOUT_DESCRIPTOR_DPKEY to HierarchicalLayout#NODE_DESCRIPTOR_DATA_KEY.
HierarchicLayoutData#NodeLayoutDescriptors to NodeDescriptors.
ILayerer to ILayerAssigner.
HierarchicLayout#FixedElementsLayerer to HierarchicalLayoutCore and renamed to FixedElementsLayerAssigner.
HierarchicLayout#FromScratchLayerer to HierarchicalLayoutCore and renamed to FromScratchLayerAssigner.
WeightedLayerer to WeightedLayerAssigner.
ConstraintIncrementalLayerer to ConstraintIncrementalLayerAssigner.
MultiComponentLayerer to MultiComponentLayerAssigner.
MultiComponentLayerer#SingleComponentLayerer to SingleComponentLayerAssigner.
AspectRatioComponentLayerer#SingleComponentLayerer to SingleComponentLayerAssigner.
TopologicalLayerer to TopologicalLayerAssigner.
AspectRatioComponentLayerer to AspectRatioComponentLayerAssigner.
BFSLayerer to BfsLayerAssigner.
GivenLayersLayerer to GivenLayersAssigner.
HierarchicLayoutCore#createIncrementalLayerer to createIncrementalLayerAssigner.
HierarchicLayoutData#BfsLayererCoreNodes to BfsLayerAssignerCoreNodes.
AsIsLayerer to FromSketchLayerAssigner.
GivenLayersLayerer#LAYER_ID_DPKEY to LAYER_INDEX_DATA_KEY.
HierarchicLayoutData#GivenLayersLayererIds to GivenLayersIndices.
HierarchicLayoutData#ConstraintIncrementalLayererAdditionalEdgeWeights.
AsIsSequencer to FromSketchSequencer.
SimplexNodePlacer#BarycenterModeEnabled to SymmetryOptimizationStrategy and changed its type to SymmetryOptimizationStrategy. It now supports performing strong, weak and no additional
symmetry optimization.
HierarchicLayout#LayoutMode property into a boolean FromSketchModeEnabled property and removed the LayoutMode enum.
IEdgeReverser interface and the HierarchicLayoutCore#createEdgeReverser method have been removed.
NodeLayoutDescriptor class of the HierarchicLayout
algorithm, which was renamed to HierarchicalLayoutNodeDescriptor, does no longer allow
to specify the border-to-port gap ratios individually for each node side. The BorderToPortGapRatio property now defines the value for all four node sides.
BusDescriptor is renamed to GridComponentDescriptor.
HierarchicLayout#BUS_DESCRIPTOR_DPKEY is renamed to GRID_COMPONENT_DESCRIPTOR_DATA_KEY.
HierarchicLayoutData#Buses is renamed to GridComponents.
HierarchicLayoutData#BusRootOffsets is renamed to GridComponentRootOffsets.
NodeDataType#BUS_STRUCTURE_DUMMY is renamed to GRID_COMPONENT_BUS_NODE.
INodeData interface with HierarchicalLayoutNodeContext class.
INodeData#GroupId to HierarchicalLayoutNodeContext#EdgeGroupId.
INodeData#ParentGroupNode property.
IEdgeData interface with HierarchicalLayoutEdgeContext class.
IEdgeData#Type is read-only on the new HierarchicalLayoutEdgeContext.
IEdgeData properties now offer read and write access on the new
HierarchicalLayoutEdgeContext: SourceGroup,
TargetGroup, SourcePortGroup, TargetPortGroup, SourcePortCandidates,
TargetPortCandidates, Thickness,
CrossingCost, CriticalEdgePriority,
SourcePortAlignment, TargetPortAlignment.
IEdgeData#SourcePortConstraint and TargetPortConstraint to SelectedSourcePortCandidate and SelectedTargetPortCandidate respectively. Bot properties now offer read and
write access.
IEdgeData#Group property.
ILayer interface with HierarchicalLayoutLayer
class.
ILayer#List property with HierarchicalLayoutLayer #Nodes.
ILayers interface with a list of HierarchicalLayoutLayer instances accessible via HierarchicalLayoutContext#Layers property.
HierarchicalLayoutContext#insertLayer and removeLayer are replacements for the ILayers#insert
and ILayers#remove methods.
IItemFactory interface with ItemFactory class.
Several of the factory methods have also been removed or renamed.
createDummyEdge has been renamed to createHelperEdge.
CreateProxyNode has been renamed to createSideProxyNode and destroyProxyNode to destroySideProxyNode.
createSameLayerProxy has been renamed to createSameLayerProxyEdge and destroySameLayerProxy
to destroySameLayerProxyEdge.
setTemporaryEdgeGroups has been renamed to createGroupedEdgeContext.
setTemporaryCriticalEdgePriority has been removed.
setTemporaryCrossingCost has been removed.
setTemporaryEdgeThickness has been removed.
setTemporaryPortConstraint has been removed.
EdgeDataType#REDIRECTED_GROUP_EDGE has been removed.
ILayoutDataProvider interface is removed and its functionality is moved to HierarchicalLayoutContext.
ILayers interface is moved to the HierarchicalLayoutContext, and methods that accepted ILayers
as a parameter instead accept HierarchicalLayoutContext now.
IItemFactory interface is moved to the HierarchicalLayoutContext, and methods that accepted IItemFactory as a parameter instead accept HierarchicalLayoutContext now.
PortBorderGap were renamed to now contain BorderToPortGapRatio.
HierarchicLayout#RecursiveGroupLayeringEnabled and HierarchicLayout#GroupCompactionEnabled are combined into HierarchicalLayout#GroupLayeringPolicy.
ConstraintIncrementalLayerer#checkConstraints, GivenLayersLayerer#normalize have been removed.
getLayerAlignment and assignNodesToSublayer have been removed from the CoordinateAssigner class (formerly called SimplexNodePlacer). Furthermore, its getMinDistance method
has been renamed to getMinimumDistance.
IDrawingDistanceCalculator#getMinDistance method has been renamed to getMinimumDistance.
hierarchic#NodeDataType to HierarchicalLayoutNodeType and its value Normal to HierarchicalLayoutNodeType#REGULAR.
hierarchic#EdgeDataType to HierarchicalLayoutEdgeType and its value Normal to HierarchicalLayoutEdgeType#REGULAR.
LayerType#NORMAL to HierarchicalLayoutLayerType#REGULAR.
MergingPolicy to LayerMergingPolicy.
RankingPolicy to LayerRerankingPolicy and TopologicalLayerer#RankingPolicy to RerankingPolicy.
WeightHeuristic to SequencerWeightHeuristic.
HierarchicLayout#OrthogonalRoutingEnabled property has been removed. To specify
orthogonal or other routing styles, the routing style on the HierarchicalLayoutEdgeDescriptor must be used instead.
IPortConstraintOptimizer has been renamed to IPortCandidateSelector, and its methods have been renamed from optimizeAfterLayering and optimizeAfterSequencing to
selectAfterLayering and IPortCandidateSelector#selectAfterSequencing.
AbstractPortConstraintOptimizer has been removed.
PortCandidateOptimizer has been renamed to PortCandidateSelector and its properties have been renamed: BackLoopPenalty to BackLoopCost, CrossingPenalty to CrossingCost, and OverUsagePenalty to OverUsageCost.
ICandidateMatcher interface has been removed. For an advanced customization of the
port selection consider implementing a custom IPortCandidateSelector.
INodePlacer interface of the hierarchic layout has been renamed to ICoordinateAssigner. Its implementation has been renamed from SimplexNodePlacer to CoordinateAssigner.
HierarchicLayout#LayerSeparationEnabled property has been moved to CoordinateAssigner#SeparatingLayersEnabled, since it has always only worked when using
that implementation.
GroupTransposition property has been removed from DefaultLayerSequencer class. The Transposition property should now be used for groups too.
TypeBasedDrawingDistanceCalculator class has been removed.
ILayeredComponentsMerger and DefaultLayeredComponentsMerger have been removed. The functionality is integrated into the
MultiComponentLayerer, which now offers a new MergingPolicy property and protected method merge
for the case that a custom merging approach is required.
HierarchicLayoutCore class is not a standalone layout algorithm anymore but now
offers only access to more advanced features of the HierarchicLayout class.
HierarchicLayout class.
HierarchicLayoutData#SelfLoopCalculatorData was removed. Settings like
minimum lengths for self-loop edges are specified via the HierarchicalLayoutEdgeDescriptor class like for normal edges.
SelfLoopCalculator and SelfLoopCalculatorData
classes was removed from the API.
DefaultPortAllocator#getPortBorderGap, DefaultPortAllocator#getPortBorderGapRatio, and DefaultPortAllocator#getPortDistanceDelta were removed.
HierarchicLayout#createLayerConstraintFactory, HierarchicLayoutData#LayerConstraintFactory, HierarchicLayout#createSequenceConstraintFactory and HierarchicLayoutData#SequenceConstraintFactory. The factories are no longer required to
define layering and sequence constraints.
HierarchicLayoutData#LayerConstraints
and HierarchicLayoutData#SequenceConstraints.
LayoutGraphLayerConstraints and LayoutGraphSequenceConstraints were added.
HierarchicLayout#LAYER_CONSTRAINTS_MEMENTO_DPKEY and HierarchicLayout#SEQUENCE_CONSTRAINTS_MEMENTO_DPKEY.
TopLevelGroupToSwimlaneStage has been removed from the library.
createLayerConstraintFactory and createSequenceConstraintFactory have been removed from HierarchicLayout. To specify layer and sequence constraints, use LayoutData instead.
HierarchicalLayout now considers node labels by default.
HierarchicalLayout now places edge labels by default using an integrated labeling
algorithm.
HierarchicalLayout class from Polyline
to Orthogonal.
TreeLayout#graph field has been removed. For customizations in the TreeLayout the graph is available whatsoever and can if required be queried from the
node/edge items.
TreeLayout#layoutRoot now has an additional parameter of type LayoutGraph as its first argument.
GridNodePlacer#AutomaticRowAssignmentEnabled property (now renamed to MultiLayerSubtreePlacer) was removed. The layers are now always automatically assigned if
no layer indices are defined via TreeLayoutData#MultiLayerSubtreePlacerLayerIndices.
LayeredNodePlacer#Id property (class was also renamed to LevelAlignedSubtreePlacer). The ID can still be provided via the constructor. Reading it
later should never be necessary.
ConnectorDirection to SubtreeConnectorDirection, and the values
North to SubtreeConnectorDirection#UP, East to SubtreeConnectorDirection#RIGHT, South to SubtreeConnectorDirection#DOWN, and West to SubtreeConnectorDirection#LEFT.
ParentConnectorDirection: North to ParentConnectorDirection#UP, East to ParentConnectorDirection#RIGHT, South to ParentConnectorDirection#DOWN, and West to ParentConnectorDirection#LEFT.
IProcessor to ISubtreePlacerProcessor.
DelegatingNodePlacer now implements ISubtreePlacer
instead of IFromSketchNodePlacer.
BusNodePlacer now implements ISubtreePlacer instead of
IFromSketchNodePlacer.
tree#Matrix with the SubtreeTransform enum and
renamed constants:
Matrix#DEFAULT to SubtreeTransform#NONE.
Matrix#MIR_HOR to SubtreeTransform#FLIP_Y.
Matrix#MIR_VERT to SubtreeTransform#FLIP_X.
Matrix#ROT90 to SubtreeTransform#ROTATE_LEFT.
Matrix#ROT180 to SubtreeTransform#ROTATE180.
Matrix#ROT270 to SubtreeTransform#ROTATE_RIGHT.
Matrix#MIR_VERT_ROT90 to SubtreeTransform#ROTATE_RIGHT_FLIP_Y.
Matrix#MIR_HOR_ROT90 to SubtreeTransform#ROTATE_LEFT_FLIP_Y.
DefaultNodePlacer class to SingleLayerSubtreePlacer.
DelegatingNodePlacer class to SingleSplitSubtreePlacer.
DoubleLineNodePlacer class to DoubleLayerSubtreePlacer.
FreeNodePlacer class to FixedSubtreePlacer.
GridNodePlacer class to MultiLayerSubtreePlacer.
GroupedNodePlacer class to MultiSplitSubtreePlacer. The class now considers port grouping (use TreeLayoutData#Ports) to define how child nodes are split.
LayeredNodePlacer class to LevelAlignedSubtreePlacer.
TreeLayout#DefaultNodePlacer property to DefaultSubtreePlacer.
TreeLayoutData#DelegatingNodePlacerPrimaryNodes property to SingleSplitSubtreePlacerPrimaryNodes.
TreeLayoutData#GridNodePlacerRowIndices property to MultiLayerSubtreePlacerLayerIndices.
RoutingStyle.Polyline to SingleLayerSubtreePlacerRoutingStyle#STRAIGHT_LINE_TO_CHILD_CONNECTOR, RoutingStyle#FORK property to SingleLayerSubtreePlacerRoutingStyle#ORTHOGONAL, and RoutingStyle#FORK_AT_ROOT property to SingleLayerSubtreePlacerRoutingStyle#ORTHOGONAL_AT_ROOT.
SingleLayerSubtreePlacerRoutingStyle#POLYLINE property which leads to a
polyline routing style.
TreeLayout#DefaultLeafPlacer property as well as LeafNodePlacer class.
SimpleNodePlacer class; use DefaultSubtreePlacer class instead.
DefaultNodePlacer#ChildPlacement property with the new SingleLayerSubtreePlacer#Transformation property. The formerChildPlacement#HORIZONTAL_DOWNWARD value now maps to SubtreeTransform#NONE, ChildPlacement#HORIZONTAL_UPWARD
to SubtreeTransform#FLIP_Y,ChildPlacement#VERTICAL_TO_LEFT to SubtreeTransform#ROTATE_RIGHT, and ChildPlacement#VERTICAL_TO_RIGHT to SubtreeTransform#ROTATE_LEFT_FLIP_Y.
RootAlignment#CENTER_OVER_CHILDREN to SubtreeRootAlignment#CENTER_OF_CHILDREN.
RootAlignment#LEADING to SubtreeRootAlignment#LEFT, RootAlignment#TRAILING to
SubtreeRootAlignment#RIGHT, RootAlignment#LEADING_OFFSET to SubtreeRootAlignment#LEADING, and RootAlignment#TRAILING_OFFSET to SubtreeRootAlignment#TRAILING.
IPortAssignment to ITreeLayoutPortAssigner.
DefaultPortAssignment to TreeLayoutPortAssigner.
TreeLayout#PORT_ASSIGNMENT_DPKEY to PORT_ASSIGNER_DATA_KEY.
TreeLayoutData#PortAssignments to PortAssigners.
AbstractNodePlacer class. Implement ISubtreePlacer interface instead.
PlaceSubtree(Node, ParentConnectorDirection) of former subclasses of AbstractNodePlacer class. Override placeSubtree
method(IMapper<Node, SubtreeShape>, IMapper<Node, SubtreeShape>, LayoutGraph, Node) instead.
determineChildConnector method of former subclasses of AbstractNodePlacer class. Override determineChildConnectors method instead.
getNodeShape and getSubtreeShape
from former subclasses of AbstractNodePlacer class.
TreeLayout#MultiParentAllowed to MultiParentAllowed.
TreeReductionStage#MultiParentAllowed to MultiParentAllowed.
TreeReductionStage#NonTreeEdgeLabelingAlgorithm property has been renamed to
NonTreeEdgeLabeling.
getPortBorderGap and getPortDistanceDelta from the DefaultPortAssignment
(renamed to TreeLayoutPortAssigner) class.
DefaultPortAssignment#BorderGapToPortGapRatio property was renamed to BorderToPortGapRatio.
tree#PortAssignmentMode value PortConstraint has been
removed. Port candidates are always considered if they are specified.
tree#PortAssignmentMode values DISTRIBUTED_EAST, DISTRIBUTED_WEST, DISTRIBUTED_NORTH, DISTRIBUTED_SOUTH have been replaced by value DISTRIBUTED. The side can be specified by using TreeLayoutData#Ports.
tree#PortAssignmentMode#NONE has been renamed tree#PortAssignmentMode#CENTER.
TreeLayout#getPortAssignment can no longer be overridden. To specify IPortAssignment strategies per node, TreeLayoutData#PortAssigners can be used.
TreeLayout#getNodePlacer can no longer be overridden. To specify NodePlacer strategies per node, TreeLayoutData#SubtreePlacers can be used.
TreeLayout have been removed:
ReverseEdges.
getRootsArray.
getOutEdgeComparer - TreeLayoutData#ChildOrder
can be used instead.
createNodeShape - modifyNodeShape can be used
instead to modify the shape.
directTree - TreeLayoutData#TreeRoot can be used
to accomplish the same result.
DefaultNodePlacer#calculateParentConnector has been removed. Custom implementations
can be inlined at the end of placeSubtree.
SubtreeShape#addBoundsToShape accepts a single RectD
parameter instead of its deconstructed values.
SubtreeShape#assignValuesTo has been removed - createCopy can be used instead.
FillStyle to AspectRatioChildAlignmentPolicy and
AspectRatioNodePlacer#FillStyle to ChildAlignmentPolicy.
INodePlacer interface was renamed to ISubtreePlacer.
TreeLayout#SourcePortConstraintDataAcceptor and TreeLayout#TargetPortConstraintDataAcceptor have been removed.
TreeLayout#SourceGroupDataAcceptorTreeLayout#TargetGroupDataAcceptor have been removed.
TreeComponentLayout class has been removed.
TreeReductionStage#createStraightLineRouter method has been removed. The
standalone router StraightLineEdgeRouter class should be used instead when
straight-line edges are required.
AspectRatioTreeLayout has been removed together with AspectRatioTreeLayoutData, RootPlacement, and SubtreeArrangement. Use the TreeLayout with the AspectRatioSubtreePlacer instead.
ClassicTreeLayout has been removed together with the enums
LeafPlacement, EdgeRoutingStyle, and PortStyle. The TreeLayout can be used instead.
TreeLayoutData#OutEdgeComparators to TreeLayoutData#ChildOrder and changed the types to Comparison function.
TreeLayout#DefaultOutEdgeComparator. Use TreeLayoutData#ChildOrder instead. Also removed NodeOrderComparator class.
TreeLayout, RadialTreeLayout, now default to using the TreeReductionStage to temporarily remove non-tree edges from the graph during layout
calculation.
TreeLayoutData#OutEdgeComparators property with new, more powerful ChildOrder property.
TreeLayout now considers node labels by default.
TreeLayout now places edge labels by default using an integrated labeling
algorithm.
ChainLayoutStyle to ChainSubstructureStyle.
CycleLayoutStyle to CycleSubstructureStyle.
TreeLayoutStyle to TreeSubstructureStyle.
EdgeLayoutDescriptor to OrthogonalLayoutEdgeDescriptor.
OrthogonalLayout#EdgeLayoutDescriptor to DefaultEdgeDescriptor.
OrthogonalLayout#EDGE_LAYOUT_DESCRIPTOR_DPKEY to EDGE_DESCRIPTOR_DATA_KEY.
OrthogonalLayoutData#EdgeLayoutDescriptors to EdgeDescriptors.
LayoutStyle enum (belonging to the OrthogonalLayout)
has been renamed to OrthogonalLayoutMode. Furthermore, the new values are Strict
(former Default), FORCED_STRAIGHT_LINE (former Box) , and Relaxed (former FIXED_MIXED). The former values Uniform, FIXED_BOX, and
Mixed have been removed from the enum.
OrthogonalLayout properties related to substructures have all been renamed to
contain "substructure" in their name. ChainStyle, ChainSize, TreeStyle, TreeSize, TreeOrientation, CycleStyle, CycleSize are now called ChainSubstructureStyle, ChainSubstructureSize, TreeSubstructureStyle, TreeSubstructureSize, TreeSubstructureOrientation, CycleSubstructureStyle,
CycleSubstructureSize.
OrthogonalLayout class:
Randomization, CrossingReductionEnabled, EdgeLengthReductionEnabled, PerceivedBendOptimizationEnabled and FaceMaximizationEnabled. Use the new QualityTimeRatio property instead.
DirectedEdges properties of OrthogonalLayoutData and PartialLayoutData are now both of type ItemMapping with the
name EdgeOrientation and support floating-point values to also specify edges
oriented against the main layout direction.
EdgeDirectednessDpKey on all supporting ILayoutAlgorithms have been
combined into a global data key LayoutKeys#EDGE_DIRECTEDNESS_DATA_KEY.
PartialLayout#DIRECTED_EDGES_DPKEY is renamed to EDGE_ORIENTATION_DATA_KEY and now also allows specifying edges should be routed against
the main layout orientation.
CompactOrthogonalLayout class.
OrthogonalLayout now considers node labels by default.
OrthogonalLayout now places edge labels by default using an integrated labeling
algorithm.
MonotonicPathRestriction enum is now a flags enum and is called MonotonicPathRestrictions.
SelfLoopRouter#SmartSelfLoopPlacementEnabled property has been removed. It was
enabled by default and the algorithm now always behaves like when it was enabled previously. To get all self-loops
on the same node corner independently of other edges, the SelfLoopRouter can be
applied in a separate post-processing step where only self-loops are present in the graph (use SubgraphLayoutStage).
ParallelEdgeRouter#AbsJoinEndDistance property has been renamed to AbsoluteJoinEndDistance.
ParallelEdgeRouter#RelJoinEndDistance property has been renamed to RelativeJoinEndDistanceFactor, and its default value now is 0.
ParallelEdgeRouter#LineDistance property has been renamed to EdgeDistance.
SelfLoopRouter#LineDistance property has been renamed to EdgeDistance.
IntermediateRoutingPoints property has been changed from IList to IStreamIterable.
ParallelEdgeRouter#ROUTED_PARALLEL_EDGES_DPKEY to ROUTED_MULTI_EDGES_RESULT_DATA_KEY.
ParallelEdgeRouter#findAndHideParallelEdges to findAndHideMultiEdges.
ParallelEdgeRouterData#RoutedParallelEdges to RoutedMultiEdgesResult.
CurveEdgeLayoutDescriptor#MinimumEdgeToEdgeDistance property to MinimumEdgeDistance.
EdgeLayoutDescriptor#MinimumEdgeToEdgeDistance property (EdgeRouter) to MinimumEdgeDistance.
PenaltySettings#MinimumEdgeToEdgeDistancePenalty property to EdgeRouterCosts#MinimumEdgeDistanceCost.
EdgeRouter#Grid has been replaced by EdgeRouter#GridSpacing.
polyline#Grid has been removed.
EdgeLayoutDescriptor to EdgeRouterEdgeDescriptor.
CurveEdgeLayoutDescriptor to CurveRoutingEdgeDescriptor.
EdgeRouter#EDGE_LAYOUT_DESCRIPTOR_DPKEY to EDGE_DESCRIPTOR_DATA_KEY.
EdgeRouter#DefaultEdgeLayoutDescriptor to DefaultEdgeDescriptor.
EdgeRouter#getEdgeLayoutDescriptor to getEdgeDescriptor.
EdgeRouterData#EdgeLayoutDescriptors to EdgeDescriptors.
PathSearchContext#CurrentEdgeLayoutDescriptor to CurrentEdgeDescriptor.
CurveRoutingStage#DefaultEdgeLayoutDescriptor to DefaultEdgeDescriptor.
CurveRoutingStage#CURVE_EDGE_LAYOUT_DESCRIPTOR_DPKEY to EDGE_DESCRIPTOR_DATA_KEY.
CurveRoutingStageData#EdgeLayoutDescriptors to EdgeDescriptors.
Interval#Min to Interval#Minimum.
Interval#Max to Interval#Maximum.
OrthogonalInterval#Min to OrthogonalInterval#Minimum.
OrthogonalInterval#Max to OrthogonalInterval#Maximum.
PenaltySettings to EdgeRouterCosts.
EdgeLayoutDescriptor#PenaltySettings property to EdgeRouterCosts.
XyzCost instead of XyzPenalty: SketchViolationPenalty to SketchViolationCost, EdgeLengthPenalty
to EdgeLengthCost, BendPenalty to
BendCost, EdgeCrossingPenalty to
EdgeCrossingCost, AdjacentEdgeCrossingPenalty to AdjacentEdgeCrossingCost, SelfCrossingPenalty to SelfCrossingCost,
NodeCrossingPenalty to NodeCrossingCost, PortCrossingPenalty to
PortCrossingCost, GroupNodeCrossingPenalty to GroupNodeCrossingCost, NodeLabelCrossingPenalty to NodeLabelCrossingCost, EdgeLabelCrossingPenalty to EdgeLabelCrossingCost, MinimumNodeToEdgeDistancePenalty to MinimumNodeToEdgeDistanceCost, MinimumGroupNodeToEdgeDistancePenalty to MinimumGroupNodeToEdgeDistanceCost, MinimumEdgeToEdgeDistancePenalty to MinimumEdgeDistanceCost, MinimumNodeCornerDistancePenalty to MinimumNodeCornerDistanceCost, MinimumFirstLastSegmentLengthPenalty to MinimumFirstLastSegmentLengthCost, BendsInNodeToEdgeDistancePenalty to BendsInNodeToEdgeDistanceCost, MonotonyViolationPenalty to MonotonyViolationCost, PartitionGridCellReentrancePenalty to LayoutGridCellReentranceCost, PortViolationPenalty to PortViolationCost, InvalidEdgeGroupingPenalty to InvalidEdgeGroupingCost, and SingleSideSelfLoopPenalty to SingleSideSelfLoopCost.
PartitionCellKeys#NODE_LABEL_CROSSING_COST_FACTORS_KEY to
EdgeRouter#NODE_LABEL_CROSSING_COST_FACTOR_DATA_KEY.
PartitionCellKeys#EDGE_LABEL_CROSSING_COST_FACTORS_KEY to
EdgeRouter#EDGE_LABEL_CROSSING_COST_FACTOR_DATA_KEY.
EdgeRouterData#LabelCrossingPenaltyFactors has been replaced by the two new
properties EdgeRouterData#NodeLabelCrossingCostFactors and EdgeRouterData#EdgeLabelCrossingCostFactors.
SelfLoopRouter#layoutSelfLoops method has been removed. To route the self-loop
edges, the SelfLoopRouter class should be applied to the graph.
SelfLoopRouter#LayoutStyle property has been renamed to RoutingStyle. The respective enum type has been renamed to SelfLoopRoutingStyle.
OrganicEdgeRouter#createNodeEnlargementStage method has been removed and is now
replaced by the new MovingNodesAllowed property.
OrganicEdgeRouter#EdgeNodeOverlapAllowed property has been renamed to OrganicEdgeRouter#EdgeNodeOverlapsAllowed.
EdgeRouter#createDefaultEdgeOrderComparator method has been removed.
Use EdgeRouterData#EdgeProcessingComparison instead.
Obstacle to RoutingObstacle.
Path to PathSearchResult.
PathRequest to PathSearchRequest.
EdgeRouter class.
PathSearch, PathSearchResult,
CellSegmentInfo, EdgeInfo, Channel, ChannelBasedPathRouting, SegmentInfo, AbstractSegmentInfo, SegmentGroup, router#polyline#Alignment, DynamicObstacleDecomposition,
IObstaclePartition, IPartition, GraphPartition, GraphPartitionExtensionAdapter, IDecompositionListener, IDynamicDecomposition, IEnterIntervalCalculator and IGraphPartitionExtension
have been removed.
PartitionCell#createBorderInterval method has been removed alongside with
the PartitionCellBorder enum.
EdgeCellInfo#EnterSegmentGroup, EdgeCellInfo#ExitSegmentGroup and EdgeCellInfo#CellSegmentInfos have been removed.
EdgeRouter#RegisteredPartitionExtensions, RegisteredPathSearchExtensions and Partition have been removed, as well as
methods createObstacleDecomposition, createPathSearch, createPathSearchContext, configurePathSearch, createPathRouting, createConfiguration, configureGraphPartition and
cleanUpGraphPartition.
PathSearchContext#PathSearch and PathSearchContext#PathSearchResult have been removed.
EdgeRouter#addPathSearchExtension and EdgeRouter#addPartitionExtension.
PartitionExtension class as replacement for IGraphPartitionExtension.
IRouterPartition interface as replacement of IObstaclePartition and IPartition.
PathSearchConfiguration class.
Path#length property has been renamed to PathSearchResult#CellEntranceCount.
EdgeRouter and all its related classes have been moved from namespace com.yworks.yfiles.layout.router.polyline to com.yworks.yfiles.layout.router.
PolylineLayoutStage class has been renamed to OctilinearRoutingStage. Its PreferredPolylineSegmentLength property has been renamed to PreferredOctilinearSegmentLength.
EdgeRouter#IgnoringInnerNodeLabelsEnabled property has been removed from the
API. Consideration is controlled via EdgeRouter#NodeLabelPlacement. Inner labels of
non-group are only ignored when choosing value EdgeRouterNodeLabelPlacement#IGNORE;
labels of group nodes alone can be ignored when choosing EdgeRouterNodeLabelPlacement#IGNORE_GROUP_LABELS.
EdgeRouter#PolylineRoutingEnabled, EdgeRouter#PreferredPolylineSegmentLength and EdgeRouter#MaximumPolylineSegmentRatio have been removed. They are replaced by
respective properties on the EdgeRouterEdgeDescriptor class.
EdgeRouter#EdgeComparator property of type Comparator with EdgeRouterData#EdgeProcessingComparison of
type Comparison function.
PenaltySettings and EdgeLayoutDescriptor#PenaltySettings property where renamed to EdgeRouterCosts and EdgeRouterEdgeDescriptor#EdgeRouterCosts.
BusRouter class and all API members related to it have been removed. For bus-style
edge routing, use EdgeRouter instead.
ParallelEdgeRouter#layoutParallelEdges was renamed to routeEdges.
ParallelEdgeRouter#RelativeJoinEndDistanceFactor has changed from 0.1
to 0.
EdgeRouter now considers node labels by default.
EdgeRouter now places edge labels by default using a generic labeling algorithm.
GraphModelManager#LabelLayerPolicy property. Use the more specific
properties NodeLabelLayerPolicy, EdgeLabelLayerPolicy and PortLabelLayerPolicy instead.
SandwichLabelModel has been removed. It can be emulated using a CompositeLabelModel with the top and bottom position of an ExteriorNodeLabelModel.
LabelAngleOnRightSideRotations and LabelAngleReferences non-flags enums.
LabelAngleOnRightSideOffsets enum.
PreferredPlacementDescriptor#AngleOffsetOnRightSide enum property to the
AddingHalfRotationOnRightSideEnabled bool property.
INodeLabelLayout and IEdgeLabelLayout. Labels of the LayoutGraph are instead
represented by types NodeLabel and EdgeLabel.
LayoutGraph#getLabelLayout. Labels can instead be retrieved using Node#Labels and Edge#Labels.
ILabelLayoutFactory class. Labels can instead be created and removed using
LayoutGraph#addLabel and LayoutGraph#remove.
INodeLabelLayoutModel, IEdgeLabelLayoutModel and all implementations. To specify valid positions for GenericLabeling, the types NodeLabelCandidates and EdgeLabelCandidates offer methods for creating positions that correspond to the old model
implementations. Candidates can be specified using GenericLabelingData#NodeLabelCandidates and GenericLabelingData#EdgeLabelCandidates.
ConsiderNodeLabels, ConsiderEdgeLabels,
IntegratedNodeLabelingEnabled, IntegratedEdgeLabeling, and NodeLabelingPolicy as
two properties NodeLabelPlacement and EdgeLabelPlacement.
LabelLayoutTranslator, LabelLayoutData, LabelLayoutKeys and related classes. The behavior of LabelLayoutData can be recreated using NodeLabel#AbsolutePlacement and EdgeLabel#AbsolutePlacement.
NodeOverlapsRemovalEnabled, EdgeOverlapsRemovalEnabled and EdgeGroupOverlapAllowed from GenericLabeling.
GenericLabeling#QualityTimeRatio property providing the possibility of
balancing runtime and quality.
LabelCandidate class, which provides means to
compute profits and to mimic the behavior of the removed properties.
AbstractMISLabeling#OptimizationStrategy. Use GenericLabeling#DefaultNodeLabelingCosts and GenericLabeling#DefaultEdgeLabelingCosts instead. Additionally individual costs can now
be set for each label, using GenericLabelingData#NodeLabelingCosts and GenericLabelingData#EdgeLabelingCosts.
AbstractLabeling#AutoFlippingEnabled. Automatically flipping labels
right-side up is handled by the view, e.g. SmartEdgeLabelModel#AutoRotationEnabled.
IProfitModel interface and properties AbstractLabeling#ProfitModel and AbstractMISLabeling#CustomProfitModelRatio. Custom weights for a label candidate can be
set at creation of the candidate with NodeLabelCandidates and EdgeLabelCandidates, or through a callback for each label using GenericLabelingData#NodeLabelCandidateProcessors and GenericLabelingData#EdgeLabelCandidateProcessors.
AbstractMISLabeling and AbstractLabeling.
GenericLabeling: createEdges, assignProfit, foundLabelOverlap, foundNodeOverlap, foundEdgeOverlap, foundHaloOverlap, foundPartitionGridLineOverlap, foundPartitionGridInsetOverlap, foundPartitionGridInteriorOverlap.
LabelSideReferences#ABSOLUTE_WITH_LEFT_IN_NORTH to ABSOLUTE_WITH_LEFT_ABOVE.
LabelSideReferences#ABSOLUTE_WITH_RIGHT_IN_NORTH to ABSOLUTE_WITH_RIGHT_ABOVE.
DiscreteNodeLabelPositions enum have been renamed.
INTERNAL_MASK to INSIDE.
EIGHT_POS_MASK to DiscreteNodeLabelPositions#OUTSIDE.
SIDES_MASK to SIDES.
CORNER_MASK to Corners.
SANDWICH_MASK.
DiscreteNodeLabelPositions have been renamed:
DiscreteNodeLabelPositions#TOP, DiscreteNodeLabelPositions#TOP_LEFT, ... have been renamed to TOP_INSIDE, TOP_LEFT_INSIDE, ...
DiscreteNodeLabelPositions#NORTH, DiscreteNodeLabelPositions#NORTH_WEST, ... have been renamed to DiscreteNodeLabelPositions#TOP, DiscreteNodeLabelPositions#TOP_LEFT, ...
LabelCandidate#CustomProfit to Weight.
SliderMode to EdgeLabelSliderMode.
LabelingData class for the GenericLabeling algorithm has been renamed to GenericLabelingData to be more in line with other LayoutData
implementations.
DescriptorWrapperLabelModel.
ILabelCandidateDescriptor and related interfaces have been removed.
LayoutGraphAdapter: removed getLabelCandidateDescriptorProvider and getLabelCandidateDescriptor.
AbstractMISLabeling#AmbiguityReductionEnabled is removed. Ambiguous label placements
can instead be penalized using LabelingCosts#AmbiguousPlacementCost.
PreferredPlacementDescriptor class has been renamed to EdgeLabelPreferredPlacement.
IEdgeLabelLayout#PreferredPlacementDescriptor property has been removed.
Instead, the preferred placement can be specified using EdgeLabelPreferredPlacement#EDGE_LABEL_PREFERRED_PLACEMENT_DATA_KEY.
OutputRestriction class and the associated properties have been renamed to ShapeConstraint.
OrganicConstraintData no longer inherits from LayoutData.
OrganicLayoutData#SourceGroupIds to SubstructureSourceGroupIds. OrganicLayout now uses
OrganicLayout#SUBSTRUCTURE_SOURCE_GROUP_ID_DATA_KEY instead of LayoutKeys#SOURCE_EDGE_GROUP_ID_DATA_KEY.
OrganicLayoutData#TargetGroupIds to SubstructureTargetGroupIds. OrganicLayout now uses
OrganicLayout#SUBSTRUCTURE_TARGET_GROUP_ID_DATA_KEY instead of LayoutKeys#TARGET_EDGE_GROUP_ID_DATA_KEY.
OrganicLayout#GROUP_NODE_MODE_DPKEY property to GROUP_NODE_HANDLING_POLICY_DATA_KEY.
TreeSubstructureStyle#BALLOON has been renamed to RADIAL_TREE.
OrganicLayout now configures the ComponentLayout by
default, and SmartComponentLayoutEnabled was removed.
OrganicLayout#configureComponentLayout and disposeComponentLayout were removed. To configure the ComponentLayout, replace the instance of the ComponentLayout
in the LayoutStageStack with a suitably configured instance.
OrganicLayout#NodeSizeConsiderationEnabled was removed. The OrganicLayout now always considers node sizes.
OrganicLayout#ClusterAsGroupSubstructureAllowed to ClusterAsGroupSubstructureAllowed.
OrganicLayout#AvoidingNodeEdgeOverlapsEnabled to AvoidingNodeEdgeOverlapsEnabled.
OrganicLayout#NodeOverlapsAllowed to NodeOverlapsAllowed.
GroupNodeMode#NORMAL to GroupNodeHandlingPolicy#FREE.
OrganicLayout class no longer offers value ClusteringPolicy#USER_DEFINED. Now, cluster IDs provided by users via OrganicLayoutData#ClusterIds property or data key OrganicLayout#CLUSTER_ID_DATA_KEY are always considered first. If none are defined, the
specified OrganicLayout#ClusteringPolicy is considered.
ClusterNodes property from OrganicLayout. It is replaced by ClusteringPolicy property.
To disable the clustering, specify ClusteringPolicy#NONE. To enable it choose one of
the available other policies.
ClusteringQuality property from OrganicLayout. Use QualityTimeRatio instead.
ClassicOrganicLayout class has been removed. It is superseded by the more powerful
OrganicLayout algorithm that should be used instead.
OrganicRemoveOverlapsStage and ShuffleLayout
have been removed from the library. To solve the task of overlap removal, the RemoveOverlapsStage class is still available and the style previously generated by OrganicRemoveOverlapsStage can be triggered via the policy OverlapRemovalPolicy#PRESERVE_RELATIVE_LOCATIONS.
RecursiveShuffleLayout class has been removed from the API.
OrganicPartitionGridLayoutStage class has been removed.
OrganicLayout's ComponentLayout
is changed to PACKED_CIRCLE.
OrganicLayout now considers node labels by default.
OrganicLayout now places edge labels by default using a generic labeling
algorithm.
OrganicLayout now always considers node sizes.
InteractiveOrganicLayoutData class has been added. It handles the initial settings
per node and edge.
InteractiveOrganicNodeHandle and InteractiveOrganicEdgeHandle have been added. They handle the settings per node and edge
while the algorithm runs.
InteractiveOrganicLayout that concern settings
for individual items have been moved to InteractiveOrganicLayoutData or the handles as
appropriate.
InteractiveOrganicLayout#addStructureUpdate method has been removed.
InteractiveOrganicLayout#commitPositions and commitPositionsSmoothly have been combined as the InteractiveOrganicLayoutData#updateNodeCenters method.
InteractiveOrganicLayout#OutputRestriction property has been renamed to ShapeConstraint.
InteractiveOrganicLayout#PreferredEdgeLength property has been renamed to DefaultPreferredEdgeLength.
InteractiveOrganicLayout#syncStructure method has been removed.
ExteriorEdgeLayoutDescriptor#EdgeToEdgeDistance property to CircularLayoutExteriorEdgeDescriptor#EdgeDistance.
EdgeLayoutDescriptor to CircularLayoutEdgeDescriptor.
CircularLayout#DefaultEdgeLayoutDescriptor to EdgeDescriptor.
ExteriorEdgeLayoutDescriptor to CircularLayoutExteriorEdgeDescriptor.
CircularLayout#ExteriorEdgeLayoutDescriptor to ExteriorEdgeDescriptor.
CircularLayout#MaximumDeviationAngle property has been changed to
double.
SingleCycleLayout has been removed. The CircularLayout with PartitioningPolicy set to SINGLE_CYCLE can be used instead.
CircularLayout#SingleCycleLayout has been replaced by CircularLayout#PartitionDescriptor.
CircularLayout#DefaultEdgeLayoutDescriptor has been renamed to EdgeDescriptor.
CircularLayout#BalloonLayout has been renamed to BackboneLayout.
CircularLayout#LayoutStyle property has been renamed to PartitioningPolicy to better reflect the fact that it controls how nodes are partitioned.
The corresponding enum has also been renamed from to PartitioningPolicy.
EdgeRoutingPolicy#MARKED_EXTERIOR. To manually select which
edges should be routed externally, use the CircularLayoutData#ExteriorEdges property
instead.
CircularLayout#LayoutStyle to CircularLayout#PartitioningPolicy.
circular#LayoutStyle to circular#PartitioningPolicy.
LayoutStyle#CUSTOM_GROUPS. If custom partitions are specified
using CircularLayoutData#Partitions, they are respected by the CircularLayout automatically.
INodeSequencer class has been removed from the API. Use the new CircularLayoutData#NodeComparison property to specify custom node orders.
PartitionDescriptor#InitialAngle is measured in degrees rather than radians.
CircularLayout's ComponentLayout is changed to PACKED_CIRCLE.
CircularLayout now considers node labels by default.
CircularLayout now places edge labels by default using a generic labeling
algorithm.
RadialLayout#MinimumNodeToNodeDistance property to MinimumNodeDistance.
RadialLayout#MinimumEdgeToEdgeDistance property to MinimumEdgeDistance.
RadialLayout.NodeInfo has been renamed to NodePlacementResult.
radial#LayeringStrategy to RadialLayeringStrategy.
ItemMapping OutEdgeComparators with ChildOrderData ChildOrder.
radial#LayeringStrategy#USER_DEFINED. Custom layers are now
always used if defined via RadialLayoutData#LayerIds property.
CenterNodesPolicy#CUSTOM. Custom center nodes are now always
used if defined via RadialLayoutData#CenterNodes property.
CenterNodesDpKey property from the RadialLayout class has been removed. It was replaced by the static read-only key RadialLayout#CENTER_NODES_DATA_KEY that must now be used instead to mark the custom
center nodes.
RadialLayout's ComponentLayout
is changed to PACKED_CIRCLE.
RadialLayout now considers node labels by default.
RadialLayout now places edge labels by default using a generic labeling algorithm.
RadialLayout.NodePlacementResult#SectorStart property is now interpreted in
clockwise direction.
RadialLayoutData#LayerIds property.
RadialLayoutData#CenterNodes
property.
RootNodePolicy to RootSelectionPolicy.
BalloonLayout has been renamed to RadialTreeLayout, and
BalloonLayoutData has been renamed to RadialTreeLayoutData.
BalloonLayout (now RadialTreeLayout): The field graph, the BalloonLayout.NodeInfo, the methods getInfo, calculateChildArrangement, calculateAngles, determineRoot, and sortChildNodes, the FromSketchModeEnabled property (use
the new enum value FROM_SKETCH of ChildOrderingPolicy instead), and the InterleavedMode
property (use RadialTreeLayoutData#InterleavedNodes instead).
BalloonLayout (now RadialTreeLayout) have been renamed: PreferredChildWedge has been renamed to PreferredChildSectorAngle, PreferredRootWedge has been renamed to PreferredRootSectorAngle, and the getPreferredChildWedge method has been renamed to getPreferredChildSectorAngle.
InterleavedMode enum has been removed.
InterleavedMode#MARKED_NODES has been removed. To define specific
parents for interleaved placed child nodes use the RadialTreeLayoutData#InterleavedNodes property.
RootNodePolicy#SELECTED_ROOT has been removed. A custom root node is
now always used if defined via RadialTreeLayoutData#TreeRoot property.
PreferredChildSectorAngle, PreferredRootSectorAngle, MinimumEdgeLength,
and MinimumNodeDistance.
OutEdgeComparator property with ChildOrderData ChildOrder.
BalloonLayout#Comparator. Use RadialTreeLayoutData#ChildOrder instead.
BalloonLayoutData#OutEdgeComparator property with new, more powerful ChildOrder property (class is renamed to RadialTreeLayoutData).
RadialTreeLayout's (formerly BalloonLayout's) ComponentLayout is changed to PACKED_CIRCLE.
RadialTreeLayout sorts like before but no longer takes
precedence over orders specified with the RadialTreeLayoutData properties ChildOrder or NodeTypes.
RadialTreeLayout now considers node labels by default.
RadialTreeLayout now places edge labels by default using an integrated labeling
algorithm.
CactusGroupLayout#GroupSizingPolicy to RadialGroupLayout#GroupSizePolicy.
CactusGroupLayout has been renamed to RadialGroupLayout, and the CactusGroupLayoutData has been
renamed to RadialGroupLayoutData.
PreferredRootWedge has been renamed to PreferredRootSectorAngle.
CactusGroupLayout#NodeComparator property of type Comparator with RadialGroupLayoutData#ChildNodeComparator
of type Comparison function.
RadialGroupLayout's (formerly CactusGroupLayout's) ComponentLayout is changed to PACKED_CIRCLE.
PreferredRootSectorAngle property has been changed from 180
to 360.
RadialGroupLayout now places edge labels by default using a generic labeling
algorithm.
ForkStyle and PortAssignmentMode have been integrated into the PortAssignmentMode enum, and the ForkStyle enum has been
removed.
DefaultPortAssignment#ForkStyle has been removed.
IPortAssignment to ISeriesParallelLayoutPortAssigner.
DefaultPortAssignment to SeriesParallelLayoutPortAssigner.
SeriesParallelLayout#PORT_ASSIGNMENT_DPKEY to PORT_ASSIGNER_DATA_KEY.
SeriesParallelLayoutData#PortAssignments to PortAssigners.
SeriesParallelLayout#VerticalAlignment property to ParallelSubgraphAlignment.
SeriesParallelLayout#MinimumNodeToNodeDistance property to MinimumNodeDistance.
SeriesParallelLayout#MinimumEdgeToEdgeDistance property to MinimumEdgeDistance.
EdgeLayoutDescriptor to SeriesParallelLayoutEdgeDescriptor.
SeriesParallelLayout#DefaultEdgeLayoutDescriptor to DefaultEdgeDescriptor.
SeriesParallelLayout#EDGE_LAYOUT_DESCRIPTOR_DPKEY to EDGE_DESCRIPTOR_DATA_KEY.
SeriesParallelLayoutData#EdgeLayoutDescriptors to EdgeDescriptors.
GeneralGraphHandling property was removed. SeriesParallelLayout now handles general graphs by default.
DefaultPortAssignment#BorderGapToPortGapRatio property was renamed to BorderToPortGapRatio.
getPortBorderGap and getPortDistanceDelta from the DefaultPortAssignment class.
SeriesParallelLayout#NonSeriesParallelEdgeLabelingAlgorithm property has been
renamed to NonSeriesParallelEdgeLabeling.
SeriesParallelLayout#DefaultOutEdgeComparator. Use SeriesParallelLayoutData#ChildOrder instead. Also removed DefaultOutEdgeComparator class.
SeriesParallelLayoutData property .OutEdgeComparators with new, more powerful ChildOrder property.
SeriesParallelLayout now considers node labels by default.
SeriesParallelLayout now places edge labels by default using an integrated
labeling algorithm.
SeriesParallelLayout now handles general graphs by default.
CompactDiskLayout now considers node labels by default.
CompactDiskLayout now places edge labels by default using a generic labeling
algorithm.
MultiPageLayout#ProxyReferenceNodeCreationEnabled property has been renamed to
UsingProxyReferenceNodesEnabled.
EdgeBundleModes enum and the associated properties have been renamed to MultiEdgeConnectorPolicy. The enum values have been renamed to SEPARATE, SHARE_FOR_SAME_DIRECTION and SHARE, respectively. The corresponding EdgeDataKey has
been renamed to MULTI_EDGE_CONNECTOR_ID_DATA_KEY (previously EDGE_TYPE_DPKEY).
GroupingPolicy to MultiPageGroupingPolicy.
MultiPageLayout class has been changed.
ILayoutCallback interface has been removed. The respective MultiPageLayout#LayoutCallback property is now an Action delegate instead.
Furthermore, MultiPageLayout#calculateLayout method has been removed, meaning
the layout can and should only be started like all other algorithms (e.g. via the LayoutExecutor or IGraph#applyLayout).
IElementFactory interface and the DefaultElementFactory class have been removed. The replacement is MultiPageElementFactory class which can be accessed and modified using MultiPageLayout#ElementFactory property.
MultiPageLayout#createElementFactory method has been removed. The factory
can be get and set using MultiPageLayout#ElementFactory property.
IElementInfoManager interface has been removed.
LayoutContext class of the MultiPageLayout has
been renamed to MultiPageLayoutContext and its properties Graph and Layout have
been removed.
INodeInfo, IEdgeInfo, INodeLabelInfo, IEdgeLabelInfo interfaces related to
MultiPageLayout have been removed. The data provided by them can now be retrieved
via methods of the MultiPageLayoutContext (which is available also as property on
the MultiPageLayoutResult).
MultiPageLayout#removeConnectorPair, routeRestoredEdges and applyIncrementalLayout have
been removed.
MultiPageLayoutResult#getPage and pageCount have
been replaced by PageGraphs.
MultiPageLayoutData handles the ID mapping automatically. Consequently, the explicit
mappings NodeIds, EdgeIds, NodeLabelIds, and EdgeLabelIds have been
removed. Original graph items can be obtained by calling MultiPageLayoutData#getOriginalItem.
multipage#NodeType to MultiPageNodeType and its
value Normal to MultiPageNodeType#REGULAR.
multipage#EdgeType to MultiPageEdgeType and its
value Normal to MultiPageEdgeType#REGULAR.
EdgeBundleModes enum has been renamed to MultiEdgeConnectorPolicy and converted from a flags enum to a regular enum. To manually
select which multi-edges should be distinguished, use the MultiPageLayoutData#MultiEdgeConnectorIds property.
MultiPageLayout#EdgeBundleModeMask, MultiPageLayout#EDGE_TYPE_DPKEY, and MultiPageLayoutData#EdgeTypes have been renamed to MultiPageLayout#MultiEdgeConnectorPolicy, MultiPageLayout#MULTI_EDGE_CONNECTOR_ID_DATA_KEY, and MultiPageLayoutData#MultiEdgeConnectorIds.
partial#LayoutOrientation to PartialLayoutOrientation.
PartialLayout#layoutSubgraph method has been removed.
configureEdgeRouter method has been removed from classes PartialLayout and ClearAreaLayout. The router instance can
be specified via the PartialLayout#EdgeRouter and ClearAreaLayout#EdgeRouter properties so that an additional configuration callback is
not necessary.
ComponentAssignmentStrategy#CUSTOMIZED. Custom components are
now always used if defined with PartialLayoutData#ComponentIds, ClearAreaLayoutData#ComponentIds or FillAreaLayoutData#ComponentIds respectively.
PartialLayoutData#ComponentIds.
NodeLayoutDescriptor to TabularLayoutNodeDescriptor.
TabularLayout#DefaultNodeLayoutDescriptor to DefaultNodeDescriptor.
TabularLayout#NODE_LAYOUT_DESCRIPTOR_DPKEY to NODE_DESCRIPTOR_DATA_KEY.
TabularLayoutData#NodeLayoutDescriptors to NodeDescriptors.
tabular#LayoutPolicy to TabularLayoutMode.
TabularLayout#NodeComparator property of type Comparator with TabularLayoutData#FreeNodeComparison of
type Comparison function.
TabularLayout class now features its own data key (LAYOUT_GRID_CELL_DESCRIPTOR_RESULT_DATA_KEY) where it will publish cell IDs of nodes
that it explicitly assigned to the cells. Previously it reused the common data key PartitionGrid#PARTITION_CELL_ID_DPKEY.
TabularLayout now considers node labels by default.
TabularLayout now places edge labels by default using a generic labeling
algorithm.
ComponentArrangementStyles enum has been renamed to ComponentArrangementStyle, as it is no longer a Flags-Enum.
ComponentArrangementStyles#MASK.
ComponentArrangementStyles#MODIFIER_NO_OVERLAP with TRY_KEEP_CENTERS.
ComponentArrangementStyles#MODIFIER_AS_IS with ComponentLayout#FromSketchModeEnabled.
ComponentLayout#calculateBounds to calculateComponentBounds.
ComponentLayout#setOrigin to setComponentLocation.
IsolatedGroupComponentLayout class has been removed.
ComponentArrangementStyles#NONE to ComponentArrangementStyle#KEEP_CENTERS.
ComponentArrangementEnabled property from ComponentLayout; use the new ComponentArrangementStyle#NONE instead to avoid arranging components.
ComponentLayout#arrangeFields method.
ComponentLayout#arrangeComponents and ComponentLayout#setOrigin to now accept instances of Component class.
ComponentLayout is used as a pre-processing step to apply a layout algorithm on
multiple connected components, the StopDuration of that layout is divided
appropriately over all components, instead of being applied once per component.
ComponentArrangementStyle#PACKED_CIRCLE and ComponentArrangementStyle#PACKED_RECTANGLE now consider the convex hulls of components
to determine overlaps.
TilingPolicy to TilingStrategy and TreeMapLayout#TilingPolicy to TreeMapLayout#TilingStrategy.
TreeMapLayout#NodeComparator property of type Comparator with TreeMapLayoutData#ChildNodeComparison of
type Comparison function.
NodeWeightComparator class.
RecursiveGroupLayout#NULL_LAYOUT is renamed to RecursiveGroupLayout#FIX_CONTENT_LAYOUT.
FixGroupLayoutStage is removed and its functionality is replaced by RecursiveGroupLayout using RecursiveGroupLayout#FIX_GROUP_LAYOUT for all groups.
RecursiveGroupLayout class now ignores empty group nodes by default (see EmptyGroupsConsiderationEnabled property).
IGroupBoundsCalculator#calculateBounds method was changed. The
given children are now of type IIndexedIterable.
GroupBoundsCalculator implementation now keeps the center of empty group nodes if
EmptyGroupsConsiderationEnabled is enabled.
GroupBoundsCalculator#calculateBounds now correctly considers the specified
children. Previously, the given children were ignored and all graph elements were considered when calculating the
group bounds.
PartitionGrid is renamed to LayoutGrid. This also
affects the related classes PartitionGridData, GenericPartitionGridStage, and GenericPartitionGridStageData.
ColumnDescriptor to LayoutGrid.Column & RowDescriptor to LayoutGrid.Row.
PartitionCellId to LayoutGrid.CellDescriptor.
LayoutGrid.Column (formerly ColumnDescriptor) and LayoutGrid.Row (formerly RowDescriptor) to now be called padding (e.g., LeftPadding instead of LeftInset).
Swimlanes and layout#SwimlaneRepresentative.
SwimlanesMode enum.
PartitionGrid#prepareOrientationChange and PartitionGrid#finalizeOrientationChange have been removed.
OriginalPosition and OriginalWidth from LayoutGrid.Column class (formerly
ColumnDescriptor). Use properties LayoutGrid.Column#Position (formerly ComputedPosition)
or LayoutGrid.Column#Width (formerly ComputedWidth).
OriginalPosition and OriginalHeight from LayoutGrid.Row class (formerly
RowDescriptor). Use properties LayoutGrid.Row#Position
(formerly ComputedPosition) or LayoutGrid.Row#Height (formerly ComputedHeight).
SwimlaneDescriptor class has been removed from the API. Use LayoutGrid class (formerly called PartitionGrid) instead,
which is able to model one-dimensional and two-dimensional grids.
PartitionGridLayoutStage class has been removed. It is not necessary to manually
add this stage, since HierarchicalLayout can support LayoutGrid out-of-the-box.
RowOrderOptimizationEnabled and ColumnOrderOptimizationEnabled from PartitionGridData
class.
PartitionGrid#PARTITION_GRID_DPKEY. The key LayoutGrid#LAYOUT_GRID_CELL_DESCRIPTOR_DATA_KEY is now the only data key which can be
used to specify layout grids.
RecursiveGroupLayout#GROUP_NODE_PARTITION_GRID_DPKEY. The key LayoutGrid#LAYOUT_GRID_CELL_DESCRIPTOR_DATA_KEY is now the only data key which can be
used to specify layout grids.
CurveFittingLayoutStage to CurveFittingStage.
FixNodeLayoutStage to LayoutAnchoringStage and
FixNodeLayoutData to LayoutAnchoringStageData. In
addition:
FixPointPolicy to LayoutAnchoringPolicy.
FixNodeLayoutStage#FIXED_NODE_DPKEY to NODE_ANCHORING_POLICY_DATA_KEY.
calculateFixPoint to calculateAnchorPoint.
FixNodeLayoutData#FixedNodes. Graph elements to anchor the graph on can
be specified by setting the respective AnchoringPolicies using LayoutAnchoringStageData.
InterEdgeRoutingStyle enum.
IntersectionInfo has been renamed to Intersection and
has become an inner class of LayoutGraphAlgorithms.
ParallelEdges#findParallelEdges to LayoutGraphAlgorithms#findMultiEdges.
BfsDirection enum. Use TraversalDirection
instead.
Algorithms#Util. The types are now in namespace Algorithms.
TreeAnalyzer class has been removed. Use the more convenient and powerful TreeAnalysis class instead.
LayoutGraphAlgorithms
instead.
IntersectionAlgorithm class. Use corresponding methods of LayoutGraphAlgorithms instead.
NetworkFlows class. Use corresponding methods of LayoutGraphAlgorithms instead (e.g. MaximumFlow).
NodeOrders class. Use corresponding methods of LayoutGraphAlgorithms instead (e.g. topologicalNodeOrder).
GraphConnectivity class. Use corresponding methods of LayoutGraphAlgorithms instead.
IndependentSets class. Use corresponding methods of LayoutGraphAlgorithms instead.
LayoutGraphAlgorithms
instead.
LayoutGraphAlgorithms instead.
LayoutGraphAlgorithms
instead.
LayoutGraphAlgorithms instead.
ParallelEdges class. Use corresponding methods of LayoutGraphAlgorithms instead.
LayoutGraphAlgorithms
instead.
LayoutGraphAlgorithms
instead.
ShortestPaths class. Use corresponding methods of LayoutGraphAlgorithms class instead (e.g. ShortestPath).
LayoutGraphAlgorithms instead.
HierarchicalClusteringDendrogram.
LayoutGraphAlgorithms#bfs instead.
LayoutGraphAlgorithms#dfs instead.
analysis#Component to ConnectedComponent.
SpanningTrees class has been removed. To compute a minimum spanning tree, use
LayoutGraphAlgorithms#minimumSpanningTree method.
RankAssignments class has been removed in favor of the single LayoutGraphAlgorithms#simplexRankAssignment method that offers access to the rank
assignment algorithm.
GraphChecker class has been removed and most of its methods are now available on
LayoutGraphAlgorithms.
algorithms#NodeAggregation class has been renamed to LayoutGraphNodeAggregation, emphasizing that this class is intended for users working with
the LayoutGraph API only.
NODE_TYPE_DPKEY has been removed. The replacement is key
LayoutKeys#NODE_TYPE_DATA_KEY.
NODE_CENTER_DPKEY has been removed. Node centers are now
directly read from the LayoutGraph instance which must contain the coordinates of
nodes if useful results should be generated.
EUCLIDEAN_SQUARED from DistanceMetric enum. Use enum value Euclidean instead which now calculates with squared
values.
DistanceMetric enum of KMeansClustering
class. Use KMeansDistanceMetric enum instead.
AggregationPolicy enum of NodeAggregation class. Use AggregationPolicy enum
instead.
Sorting that offered methods to get a sorted node array
based on node degrees or another criterion. The functionality is written without this utility by first getting the
array of nodes from the graph and then sorting it using standard built-in sorting utilities.
NodeAggregation#NodeTypeHandling property has been renamed to NodeTypePolicy.
NodeTypeHandlingPolicy enum has been renamed to NodeTypePolicy.
AggregationInfo to NodeAggregationInfo.
AggregationInfo#ParentAggregation to ParentNodeAggregation.
NodeAggregation.AggregationPolicy to NodeAggregationPolicy.
NodeAggregation#Aggregation to AggregationPolicy.
DistanceMetric to KMeansDistanceMetric.
GraphStructureAnalyzer#hasMultipleEdges to hasMultiEdges.
GraphStructureAnalyzer#getMultipleEdges to getMultiEdges.
algorithms#Linkage with HierarchicalClusteringLinkage.
Substructure to SubstructureItems.
analysis#Component to ConnectedComponent.
YList#elementAt method was removed.
ICursor#prev to ICursor#previous.
ListCell#succ to ListCell#Next.
ListCell#pred to ListCell#Previous.
isEmpty method from LinkedCellList class. Test LinkedCellList#Count property
for 0 instead.
succCell and predCell from LinkedCellList class. Use new properties ListCell#Next and
ListCell#Previous instead.
cyclicSucc, cyclicPred, containsAll and retainAll from LinkedCellList class.
ListCell class. Use new properties Next and
Previous instead.
LinkedCellList class. Use First property instead.
GeomUtilities class has been renamed to GeometryUtilities.
intersects methods of the GeneralPath class are
now called pathIntersects.
mayIntersectClip method of the GeneralPath class
is now called pathMayIntersectClip.
areaContains methods of the GeneralPath class now
have an optional flatteningTolerance parameter.
isEmpty method of the GeneralPath class
was removed. Use the isVisible method or the Count property, instead.
getBounds overload of the GeneralPath class that
returns the approximate bounds for Bézier segments is now called getApproximateBounds.
RectD, PointD, and SizeD classes were removed. Use the toRectD, toPointD, or toSizeD methods respectively instead.
GeomUtilities#findRayIntersection method to getSegmentRayIntersection.
GeomUtilities#findEllipseLineIntersection method to getEllipseLineIntersection.
Geom#collinear method to GeometryUtilities class
and renamed to areCollinear.
Geom#calcConvexHull method to GeometryUtilities
class and renamed to getConvexHull.
Geom#calcIntersection method to GeometryUtilities class and renamed to getLineLineIntersection.
Geom#projection method. Use PointD#getProjectionOnSegment method instead.
distanceToLineSegment of Geom class. Use PointD#distanceToSegment method instead.
IRectangle interface no longer implements IPoint.
You can get the top-left corner of a rectangle with its getTopLeft method. For
usages of the dynamic behavior of IPoint, like in a custom IPositionHandler, we recommend to let the IPositionHandler
implement IPoint, too.
IMutableRectangle interface no longer implements IMutablePoint. When working with the MutableRectangle class,
use its Location property to get a dynamic point of the location.
IPlaneObject and LineSegment to package com.yworks.yfiles.geometry.
LineSegment#XOffset property to YIntercept.
LineSegment class sealed.
LineSegment#isInXIntervall method to LineSegment#isInXInterval and LineSegment#isInYIntervall
method to LineSegment#isInYInterval.
getBottom, getLeft, getRight, and getTop of InsetsD
have been removed. Use the read-only fields bottom, left, right, and top
instead.