yFiles for Java (Swing) Changelog
yFiles for Java (Swing) 3.6
This release brings exciting new major features, and many other minor new features, improvements, and bugfixes to all parts of the library. As always, there are new and improved demos demonstrating these features and improvements.
If you are updating from an older version of yFiles for Java (Swing), have a look at the list of incompatible changes.
Major new features
- New styles for graph items
-
The
RectangleNodeStyle
class is a new node style that uses a rectangular shape whose corners are either rounded or cut diagonally. Its properties specify which corners get rounded, the corner radius, its fill, and its border stroke.The new
GroupNodeStyle
class is a node style primarily designed for collapsed and expanded group nodes. It draws a (rounded) rectangle with an optional tab or ribbon, and offers extensive configuration options for an optional icon, its various fills, and paddings. The newGroupNodeLabelModel
is tailored to place labels in the tab or tab background of aGroupNodeStyle
.The new
ArrowNodeStyle
class draws a node as an arrow shape. The arrow can point in one of the four compass directions, and the arrow head slope, the shaft thickness, the fill, and the border stroke can be configured.Similarly, the new
ArrowEdgeStyle
class draws an edge as an arrow shape. This style always points from the source port to the target port, ignoring bends, and can be configured in the same way as the node style.The
DefaultLabelStyle
class now supports different common background shapes.The
ShapeNodeStyle
class now supports three additional shapes:HEXAGON2
(a six-sided polygon with tips at top and bottom),STAR5_UP
(a five-pointed star with one tip pointing upwards), andPILL
(a stadium shape with the shorter sides rounded).Its new property
KeepingIntrinsicAspectRatioEnabled
defines whether to keep the intrinsic aspect ratio of the shape.The new
BridgeEdgeStyle
class renders an edge as a 3-segment bridge with a given height between the edge's source and target port locations. This is especially useful to distinguish parallel multi-edges between the same pair of nodes. - Wrap text to shape
-
The text wrapping feature of
DefaultLabelStyle
now wraps the text inside a given shape instead of just the rectangular label bounds. TheTextWrappingShape
enum provides the predefined shapes, and includes for example pill, ellipse, and hexagon. The newDefaultLabelStyle.TextWrappingPadding
property defines the padding between the chosen shape and the text.If the predefined shapes don't fit your needs, you can override the
DefaultLabelStyleRenderer.getTextWrappingOutline
method to return any custom convex path asGeneralPath
instead. - Compact disk layout
-
The new
CompactDiskLayout
class arranges a graph on a disk, packing the nodes as dense as possible. This layout is mostly suitable for graphs with small components whose loosely connected nodes should be grouped and packed in a small area.The associated new class
CompactDiskLayoutData
allows to specify custom data considered during the layout calculation. - Cactus group layout
-
The new
CactusGroupLayout
class offers an alternative representation of hierarchically nested data. It places the children of a group along the groups circular border, resembling the structure of a cactus.The associated new class
CactusGroupLayoutData
allows to specify custom data considered during the layout calculation.
New Features
View
-
The new class
PortLocationModelParameterSerializer
provides static helper methods which can convert the built-inIPortLocationModelParameter
implementations into key-value pairs. It also supports creatingIPortLocationModelParameter
instances from these key-value pairs. -
Added the new property
AspectRatio
to theGeneralPathNodeStyle
which defines the aspect ratio of the path. -
The new property
CanvasComponent#MouseWheelZoomEventRecognizer
can be used to set the modifier for distinguishing between mouse wheel scrolling and zooming. -
The new class
LabelModelParameterSerializer
provides static helper methods which can convert the built-inILabelModelParameter
implementations into key-value pairs. It also supports creatingILabelModelParameter
instances from these key-value pairs. -
The methods
getNodesRevealedAfterExpand
,getEdgesChangedAfterExpand
, andgetEdgesChangedAfterCollapse
have been added toFoldingManager
. They can be used to retrieve information about folding states that would be used when a specified group node would be expanded or collapsed.
Interaction
-
Handles can now react to mouse click events. The
handleClick
method has been added to theIHandle
interface and is called whenHandleInputMode#ClickedRecognizer
was triggered on a targeted handle. To customize the general handle click handling, theClicked
event can be listened to or the methodHandleInputMode#handleClick
can be overridden.
Hierarchic Layout
-
The
HierarchicLayout
class now supports so-called tabular group nodes. The children of such groups are arranged in a compact tabular fashion (i.e., like a single column table for layout orientation left-to-right). PropertyHierarchicLayoutData#TabularGroups
allows to mark groups as "tabular" and propertyHierarchicLayoutData#TabularGroupChildComparators
to specify a custom order for the children.
Organic Layout
-
The
OrganicLayout
class now offers the possibility to define a group substructure scope, see propertyGroupSubstructureScope
. Group substructures that lie in the specified scope are treated as substructures in the layout process, i.e., the child nodes are arranged on a disk that is contained in the group node. -
In addition, the new property
ClusterAsGroupStructureAllowed
allows to specify whether or not detected clusters (see propertyClusteringPolicy
) are taken into account as group substructures. -
The
OrganicLayout
class now offers two newChainSubstructureStyles
calledDISK
andDISK_NESTED
that lead to a compact disk-like layout for chains. -
The
OrganicLayout
class now offers the possibility to define tree substructures (stars, chains, cycles and parallel structures are already supported). TheOrganicLayout#TreeSubstructureStyle
property specifies the style of tree substructures and theOrganicLayout#TreeSubstructureSize
property specifies their minimum size (structures of smaller size are not handled as a tree substructure).
Balloon Layout
-
The
BalloonLayout
class now supports node types. The types influence the ordering of child nodes and the subtrees rooted at them such that nodes of the same type are preferably placed next to each other. Node types are weaker than a user-specified custom order defined via a comparison function. Types can be defined via theBalloonLayoutData#NodeTypes
property.
Radial Layout
-
The
RadialLayout
now supports a new layering strategy that produces a circular dendrogram drawing. -
The
RadialLayout
now supports two new edge routing styles, namely a radial polyline style and a curved style. The radial polyline style produces edge paths which consist of a series of straight and arc segments. The curved polyline style routes the edges as curved bezier paths. In the latter case, the edge paths can be also returned as control points that represent cubic bezier control points. -
The
RadialLayout
now supports integrated node labeling i.e., the node labels are taken into consideration when determining the positions for the nodes of the graph and guarantees that labels will not overlap with other objects in the graph.
Circular Layout
-
The
CircularLayout
now supports integrated node labeling i.e., the node labels are taken into consideration when determining the positions for the nodes of the graph and guarantees that labels will not overlap with other objects in the graph. -
The
CircularLayout
class now supports curved edge routing within and between circles.
Analysis
-
Added the new
RankAssignment
analysis algorithm class that solves the rank assignment problem on an acyclic graph using the simplex method. -
The new analysis class
Intersections
finds intersections and overlaps between graph items, featuring flexible configuration options to find only specific intersections. The respectivecom.yworks.yfiles.layout.Intersections
class provides the functionality also for theLayoutGraph
API, but offers less convenience.
Improvements
General
- The documentation about configuring the item visualization has been improved. All styles and their configuration options are now described in a Developer's Guide chapter.
View
-
GraphClipboard
now respects thePasteDelta
value when pasting items without owner (e.g. edges without selected source or target node). -
ModelManager
and its derived classesHighlightIndicatorManager
,SelectionIndicatorManager
, andFocusIndicatorManager
now haveinstall
anduninstall
methods for properly allocating and freeing resources when setting or removing a manager to aCanvasComponent
. -
GraphModelManager
: the propertiesNodeManager
,EdgeManager
,PortManager
,EdgeLabelManager
,NodeLabelManager
,PortLabelManager
, andProvideUserObjectOnMainCanvasObject
have been made public.
Interaction
-
The
MoveViewportInputMode#uninstall
method is now virtual and can be overridden in derived classes. -
A
SizeConstraintProvider
property was added toNodeReshapeHandleProvider
andNodeReshapeHandlerHandle
that is queried during node resize gestures if no explicitMinimumSize
,MaximumSize
orMinimumEnclosedArea
is set. - The input modes don't perform hit tests upon auto-repeated key down events for modifier keys anymore.
- Cursor property changes of active input modes are now immediately reflected in the application's mouse cursor. Previously, the application mouse cursor might have been updated only after the next mouse event.
-
The new
MoveInputMode#ValidBeginCursor
property offers the possibility to use different cursors for signaling a valid position for beginning a move operation and actually moving items. -
The
ResizeStripeInputMode
class now offers the possibility to customize the cursors for signaling a valid position for beginning a resize operation as well as actually resizing columns or rows. -
The
ResizeStripeInputMode
class now offers properties to set an invalid end cursor for column and row resize. The invalid end cursor is shown during resize operations if the column or row in question cannot be resized to the current mouse position. -
The properties
ValidBeginRecognizer
andValidBeginCursor
have been added toLassoSelectionInputMode
,MarqueeSelectionInputMode
, andMoveViewportInputMode
. TheValidBeginRecognizer
can be used to indicate whether the selection respectively move viewport gesture may begin in which case theValidBeginCursor
is used. -
The property
MouseHoverInputMode#ValidHoverLocationCursor
has been added that is used when theValidHoverLocationHitTestable
returns true for a location. -
The property
PopupMenuInputMode#ValidMenuLocationCursor
has been added that is used when theValidMenuLocationHitTestable
returns true for a location. -
IReparentNodeHandler#isValidParent
is now also called withnull
as new parent during the drag gesture if no real parent node has been tested for the location. -
Keyboard navigation with
NavigationInputMode
now always considers the current item to navigate from, regardless of the value of theNavigableItems
property. -
The
GraphClipboard
now raises the eventsElementsCutting
,ElementsCopying
,ElementsPasting
, andElementsDuplicating
at the very beginning of thecut
,copy
,paste
, andduplicate
methods. -
GraphEditorInputMode
now raises theGroupingSelection
andGroupedSelection
events at the start and end of thegroupSelection
method. Similarly, theUngroupingSelection
andUngroupedSelection
events are raised at the start and end ofungroupSelection
method. -
The new
CreateEdgeInputMode#SourceNodeDraggingCursor
property offers the possibility to customize the cursor that is shown while the mouse is still over the source node after starting the edge creation. -
Changes to
ItemHoverInputMode
'sHoverCursor
property now take effect immediately if the mouse pointer is currently hovering over an item. -
The
TextEditorInputMode
now releases the mutex before dispatching theTextEdited
event. -
CanvasComponent
now has aCursorChanged
event that can be used to react to cursor changes (which happen primarily when input modes change it).
Styles
-
The
Pen#DashStyle
property is now marked as@Nonnull
, since several internal usages assumed that to be the case anyway. In addition, the documentation of theDashStyle#Dashes
property now clarifies that both an empty collection andnull
result in a solidPen
. -
Added a new property
KeepingAspectRatioEnabled
toImageNodeStyle
andMemoryImageNodeStyle
to support keeping the image's aspect ratio during resizes. -
Nodes rendered with the
ShapeNodeStyle
now respect their actual outline shape when selected with theLassoSelectionInputMode
.
GraphBuilder
-
GraphBuilder
now offers simplified access to a node/edge that has been created with a given ID or data item or accessing the data a node/edge has been created for via the new methodsgetNodeById
,getNodeForItem
,getDataItem(INode)
,getEdgeById
,getEdgeForItem
, andgetDataItem(IEdge)
. -
TreeBuilder
andAdjacencyGraphBuilder
now offer simplified access to a node that has been created with a given ID or data item or accessing the data a node/edge has been created for via the new methodsgetNodeById
,getNodeForItem
,getDataItem(INode)
, andgetDataItem(IEdge)
.
Hierarchic Layout
-
The
HierarchicLayout
class now allows to combine theSimplexNodePlacer#StraightenEdges
andSimplexNodePlacer#BarycenterMode
properties. Previously, edge straightening was not supported in barycenter mode. -
The
HierarchicLayout
class generates more compact results for some cases with edges between nodes of the same layer and integrated edge labeling where previously unnecessarily large distances to the label and edge were kept. -
The
HierarchicLayout
class now places nodes without any edges as far left as possible without violating any constraints. That way they do not disturb the layout for the connected part of the graph. -
For input graphs with a
PartitionGrid
structure, theHierarchicLayout
class now correctly considers the layering produced by theFromScratchLayerer
if it is already compatible with the specified grid structure. Previously, for such cases, the algorithm may have calculated an entirely different layer assignment. -
The
HierarchicLayout
class now considers the flow direction to place the ports of port groups when combined with direct group content edges. -
The
HierarchicLayout
class comes with an improved support for subcomponent layouts (seeHierarchicLayoutData#Subcomponents
). Defining subcomponents now works by assigning instances of the newSubcomponentDescriptor
class to nodes so that nodes mapped to the same descriptor instance form a component. Components that have inter-edges only to a single non-component node are now integrated directly at that node when using the new placement policiesSubcomponentPlacementPolicy#AlwaysIntegrated
orSubcomponentPlacementPolicy#Automatic
(and if the orientation of the sub-layout permits it). The overall results for such cases feature better edge routing quality and more compact drawings. -
The
HierarchicLayout
class now also considers layering constraints between elements of different grouping hierarchies if the recursive group layering is enabled (propertyHierarchicLayout#RecursiveGroupLayering
). Previously, such constraints were ignored in that case. -
The
HierarchicLayout
class now uses a more compact layer placement for graphs with edge labels between layers. -
The
HierarchicLayout
class now requires fewer bends for some inputs with grouped edges and port constraints or port candidates.
Organic Layout
-
The
OrganicLayout
class now produces stable results for inputs with node labels and in deterministic mode, where it previously could generate a slightly different arrangement when applied twice with the same parameters. -
The
OrganicLayout
class now allows to specify custom node clusters by setting theClusteringPolicy
property toClusteringPolicy#USER_DEFINED
. The custom cluster IDs have to be specified by means of theOrganicLayoutData#ClusterIds
property.
Circular Layout
-
The
CircularLayout
class now supports node types (seeCircularLayoutData#NodeTypes
) also for the layout of the cycle partitions. Previously, the types had an influence only on the layout of a partition itself. If all nodes of a partition are of the same type, then the partition gets that type as well, so that partitions of same type are preferably placed next to each other. -
The
CircularLayout
class has received a faster algorithm for calculating edge bundles.
Tree Layout
-
Root Alignment in
GenericTreeLayout
can also factor in the port position to straighten out an edge. -
The
TreeLayout
class now also supports integrated edge labeling for configurations that use aLayeredNodePlacer
.
Edge Router
-
The
EdgeRouter
class now produces better results for some setups with monotonic path restrictions and edges with vertically/horizontally overlapping endpoints. -
The
EdgeRouter
class now tries to avoid routes that cross fixed external ports of other edges as well as fixed internal ports at group nodes of other edges. The new propertyPenaltySettings#PortCrossingPenalty
allows to specify the cost of such crossings. -
The
EdgeRouter
class now supports buses that include self-loops (see classBusDescriptor
). Previously, self-loops were ignored.
Generic Labeling
- The generic labeling algorithm has an additional preset to avoid overlaps of labels and the partition grid.
Layout
- Improved the initialization time and memory consumption of layout animations.
-
The
TemporaryGroupNodeInsertionStage
class now automatically marks inserted group nodes with anIDataProvider
registered to the input graph with the keyINSERTED_GROUP_NODE_DPKEY
. -
The
TemporaryGroupNodeInsertionStage
class now also supports specifying hierarchically nested temporary groups. Therefore, the newTemporaryGroupDescriptor
class has been added.
Analysis
-
The
TraversalDirection
enumeration used by theNeighborhood
andBfs
algorithms has been extended. The enum valueUNDIRECTED
has been added that ignores the edge direction and corresponds semantically with the previous valueBOTH
. The semantic ofBOTH
has been adjusted to indeed return the union of theSUCCESSOR
and thePREDECESSOR
results. To keep the default behavior of theNeighborhood
andBfs
algorithms, the default value of theirTraversalDirection
property has been changed fromBOTH
toUNDIRECTED
. -
The
GraphStructureAnalyzer
class now supports operating on a subset of the graph. -
The new
SubgraphNodes
andSubgraphEdges
properties on theReachability
class allow to define a subset of nodes/edges the algorithm should operate on.
Bugfixes
View
-
Combining
HierarchicNestingPolicy#GROUP_NODES
,LabelLayerPolicy#AT_OWNER
and undo no longer throws aNullPointerException
. -
Viewport animations no longer suddenly stop when the zoom level is near
CanvasComponent#MinimumZoom
orMaximumZoom
. - Holding down a scrollbar button no longer scrolls beyond the scrollable area indicated by this scrollbar.
-
Changing the
ICanvasObject#Group
property no longer triggers unnecessary recreation of the visuals anymore. -
Fixed a bug in
SelectionIndicatorManager
that didn't callremoveSelection
when an item was deselected. -
Changing the
GraphComponent#GraphModelManager
property no longer leaks memory in certain situations. -
Calling
IFoldingView#collapse
on a normal (i.e. non-group) node no longer creates anUndoUnit
or a view state (which included an unexpected call toIFolderNodeConverter#initializeFolderNode
even though the result would have never been used). Now callingIFoldingView#collapse
on a normal node does nothing. - The automatic flipping behavior of labels now also works with projections that distort the labels.
-
ViewportAnimation
s now are properly cleaned up oncancel
. -
GroupNodeStyle
's associatedINodeInsetsProvider
now correctly calculates insets for “small” nodes, i.e. nodes whose height (or width) is less than the style'sTabHeight
property. -
Inertia in
MoveViewportInputMode
no longer stops working randomly.
Graph
-
Fixed a bug in
FilteredGraphWrapper
'sNodeRemoved
event where the provided old parent might have been present in the wrapped graph but not in the filtered graph. -
The
FilteredGraphWrapper
class now raises the correct events when filtering out port labels. Previously, the events contained incorrect owner information. -
EdgePathLabelModel
'sfindBestParameter
method now creates correct parameters for locations close to bends. -
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 correspondingGroupNodeStyle
. -
NavigationInputMode#ExpandGroup
,EnterGroup
, and theEXPAND_GROUP
andENTER_GROUP
commands do not create empty undo units anymore if nothing has changed. -
NavigationInputMode#ExitGroup
and theEXIT_GROUP
command now create undo units if the bounds of the exited group node were adjusted. -
GroupingSupport
's methodsenlargeGroupNode
andenlargeAllGroupNodes
do not create empty undo units anymore if nothing has changed. -
EdgePathLabelModel
,EdgeSegmentLabelModel
, andSmartEdgeLabelModel
findBestParameter
implementations now create correct parameters for label boxes that overlap the edge's source or target node.
Interaction
-
After pasting, a closed group node within another closed group now stays closed. Previously, it
was open due to a bug in the
GraphClipboard
class. -
The
GraphEditorInputMode#AdjustContentRect
method now only updates theCanvasComponent#ContentRect
property once per call. Previously there have been circumstances where the property would have been updated twice unnecessarily. -
The
TableEditorInputMode
class no longer changes theGraphComponent#Selection
property unnecessarily when theGraphComponent#Graph
property is changed. -
An instance of the
HandleInputMode
class is no longercanceled
if a handle is removed during its ownDragFinished
call. This fixes some very rare exceptions under complicated circumstances. -
Multiple
DropInputMode
instances now correctly consider their respective priorities. -
UndoEngine
no longer adds an empty undo unit for an aborted operation in certain rare cases. -
Fixed an issue where changing the
GraphComponent#InputMode
while the context menu is open would lead to a crash. -
Fixed a bug in
MoveViewportInputMode
that caused the inertia feature to mistakenly start moving the viewport after the mouse pointer has stopped before being released. -
Starting a
CanvasComponent
/GraphComponent
viewport animation now properly stops a runningMoveViewportInputMode
inertia animation. - The direction of the first edge segment during orthogonal edge creation is now correctly determined when the source port candidate lies on the node border.
-
SmartEdgeLabelModel
now properly supports the original position snap line.
Styles
-
Cloning an
ITable
instance now properly clones all of the table's internal state. Previously, changing a cloned table's insets could result in the cloned table's stripes not updating their geometry. -
TableNodeStyle
now allows the table background style to access the table node's tag. - The built-in styles with rounded corners now have the correct outline shape for all calculations.
- Edges with Bézier paths can now also be animated into non-Bézier paths.
-
Edge cropping now works as expected when using the
BezierEdgeStyle
class and the terminating nodes have styles that do not provide an outline in theirIShapeGeometry
implementation. -
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. -
ShapeNodeStyleRenderer
now always uses the protectedgetPaint
andgetPen
methods for all shapes instead of falling back to the respective style properties for some shapes. -
IconLabelStyle
'supdateVisual
implementation now properly updates if the style's Icon instance is changed. -
DefaultLabelStyle
now adds ellipsis more reliably at the end when the text does not fit into the specified text wrapping shape.
GraphML
-
The
key
parameter ofAbstractInputHandler#setValue
method is now annotated correctly as nullable. The key may benull
when the model item used as key is created after its data has been parsed. -
Fixed GraphML serialization and deserialization for certain configurations of
GeneralPathNodeStyle
andShapeNodeStyle
. -
Fixed GraphML serialization and deserialization for certain configurations of
GroupNodeStyle
andRectangleNodeStyle
. -
Fixed an issue in
GraphMLIOHandler
'sWriteEvents
where theDataWriting
event has been dispatched after the writing process instead of before.
GraphBuilder
-
Label bindings which don't provide label data (or
null
) no longer add empty labels. Instead, no label will be added. -
Fixed a potential memory leak in
AdjacencyGraphBuilder
. Some internal references were not cleaned up after items have been removed duringupdateGraph
. -
Fixed a bug in
GraphBuilder
where updating an existing edge whose (new) source or target nodes cannot be resolved did not remove the edge from the graph. -
Fixed a potential memory leak in
GraphBuilder
,AdjacencyGraphBuilder
, andTreeBuilder
. Some internal map entries for labels were not discarded after their owner nodes or edges were removed.
Table
-
Fixed a bug in
StretchStripeLabelModel
that was causing incorrect handling of insets.
Hierarchic Layout
-
The
SimplexNodePlacer
class used by theHierarchicLayout
no longer throws an error due to an internal overflow for very wide layouts. -
The
HierarchicLayout
class now correctly considers the specified halos of group nodes when there is a partition grid defined. -
The
HierarchicLayout
class no longer generates broken non-orthogonal edge segments of same-layer edges for some cases in conjunction with integrated edge labeling and edge labels placed at the ports. -
The
HierarchicLayout
class now properly satisfiesPortCandidates
defined for same-layer edges at nodes where other edges with (rather large) source/target port labels additionally exist. -
The
HierarchicLayout
class now produces a correct edge grouping structure for short edges having the same source and target group ID. -
The
HierarchicLayout
class no longer throws an exception when the edge-directedness feature (HierarchicLayoutData#EdgeDirectedness
) is used in conjunction with enabled back-loop routing (HierarchicLayout#BackLoopRouting
). -
The
HierarchicLayout
class no longer creates unnecessary spacing between sub-components (seeHierarchicLayoutData#SubComponents
) and other elements. This previously happened in some cases due to edge/node labels being present. In consequence, these cases are now more compact. -
The
HierarchicLayout
class no longer produces overlaps between (large) external node labels and unrelated edges. -
The
HierarchicLayout
class no longer produces overlaps between sub-component elements (seeHierarchicLayoutData#SubComponents
) and edges that are not part of the component. -
The
HierarchicLayout
class now correctly assigns ports to edges incident to groups if the uniform port assignment is enabled (see propertyHierarchicLayoutData#UniformPortAssignmentGroups
) for some cases where it previously did not yield a uniform port distribution. -
The
HierarchicLayout
now correctly considers thePreferredPlacementDescriptor
settings of an edge label when there are additionally edge groupings defined. Previously, it could, for example, happen that the edge label was placed on the wrong side of the edge. -
The
HierarchicLayout
class now adheres more closely to its maximum duration and itsAbortHandler
. -
The
HierarchicLayout
class now considers thePortCandidate
directions correctly for layout orientations other thanTopToBottom
. This also improves the optimization results withPortCandidateSet
s that allow multiple directions to connect to nodes. -
For input graphs with a
PartitionGrid
structure, theHierarchicLayout
class now correctly considers the layering produced by theFromScratchLayerer
if it is already compatible with the specified grid structure. -
The
HierarchicLayout
class no longer throws an exception for some invalid specifications of alternative group bounds in incremental layout mode. -
The results of the
DefaultLayerSequencer
class are now deterministic by default, since it no longer aborts the calculation after 10s. For this, itsMaximumDuration
value is now unrestricted.
Organic Layout
-
The
OrganicLayout
class no longer produces broken routes of self-loops at group nodes if theScope
is not equal toALL
. -
The
OrganicLayout
class now correctly considers the specifiedPartitionGrid
if substructure detection is enabled. Previously, the grid cell assignment of nodes belonging to a substructure has been ignored. -
The
OrganicLayout
class now correctly considers fix-contents and fix-bounds groups (see enumGroupNodeMode
) if the substructure detection is enabled. -
The
OrganicLayout
class now correctly detects chain substructures if there are nodes of different types (OrganicLayoutData#NodeTypes
). -
The
OrganicLayout
class now satisfies propertyOrganicLayout#DeterministicModeEnabled
for more cases when the maximum duration is restricted. Note, however, that non-deterministic behavior is still possible when restricting the duration. -
The
OrganicLayout
class no longer produces violations of the specified minimum node distance for separated radial substructures (see propertyStarSubstructureStyle#SEPARATED_RADIAL
).
Clear Area Layout
-
The
ClearAreaLayout
class no longer produces results where the specified area is not cleared for some input graphs when propertyClearAreaStrategy
is set toPRESERVE_SHAPES
orPRESERVE_SHAPES_UNIFORM
. -
The
ClearAreaLayout
class now correctly considers the initial partition grid assignment of nodes.
Orthogonal Layout
-
The
OrthogonalLayout
class no longer produces bad edge routes where the path is non-orthogonal and does not connect to the source node anymore for some rare cases containing parallel edges or chain substructures. -
The
OrthogonalLayout
class now correctly considers the specified minimum group node sizes (seeGroupingKeys#MINIMUM_NODE_SIZE_DPKEY
). Previously, the minimum sizes were always enlarged by the groups' insets (seeGroupingKeys#GROUP_NODE_INSETS_DPKEY
). Actually, the minimum size should include the insets. -
The
OrthogonalLayout
class now correctly handles input graphs with parallel edges if theParallelRoutesPreferenceEnabled
property is enabled. Previously, such inputs have caused exceptions in some rare cases. -
The
OrthogonalLayout
class no longer generates overlaps between edge segments (of a parallel edge) and edge labels of other edges for some rare scenarios.
Edge Router
-
The
EdgeRouter
class now correctly interprets specified intermediate points (EdgeLayoutDescriptor#IntermediateRoutingPoints
) as well as bus points (BusDescriptor#BusPoints
) in the case when the algorithm runs inside an orientation layout with an orientation other thanTopToBottom
. -
The
EdgeRouter
class now correctly considers the maximum duration and theAbortHandler
when the octilinear routing style is chosen. Previously, it could happen that the algorithm kept on running even though the time was up. -
The
EdgeRouter
class no longer throws an exception for some rare cases with collinear bends. -
The
EdgeRouter
class now correctly handles direct content edges that are incident to group nodes withPortCandidateSets
. -
The
EdgeRouter
class no longer produces bad layout results for some scenarios with grouped edges and multiplePortCandidates
. Previously, the algorithm selected any of them without considering the alternative options.
Generic Labeling
-
The
GenericLabeling
class no longer produces superfluous label overlaps if one of itsRemoveNodeOverlaps
orRemoveEdgeOverlaps
properties is enabled. -
The
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.
Circular Layout
-
A circular layout with
LayoutStyle#BCC_ISOLATED
can no longer get into an infinite loop for inputs where a component consists only of articulation points.
Single Cycle Layout
-
The
SingleCycleLayout
class no longer produces violations of the specified minimum node distance.
Layout
-
TableLayoutConfigurator
now considers the correctOriginalPosition
s of theRowDescriptor
s andColumnDescriptor
s when table insets are used. -
The
TableLayoutConfigurator
class now treats tables without rows or columns as tables with exactly one row and column instead of throwing an exception. -
The
PolylineLayoutStage
class now correctly considers a registeredAbortHandler
instance so that it is possible to terminate early. Previously, the stage ignored theAbortHandler
. -
The
TabularLayout
class now always uses the correct bounding box values for node labels that are considered. Previously, wrong label bounds could lead to unnecessarily large rows or columns. -
The
IsolatedGroupComponentLayout
class no longer produces unnecessarily large group nodes if the specifiedGridSpacing
is zero.
Incompatible Changes
API
-
Due to the new
install
anduninstall
methods of theModelManager
class, the following of its members have been changed:- The
CanvasComponent
constructor parameter has been removed. Instead, you can call the newinstall
method with theCanvasComponent
as parameter. Similarly, theCanvasComponent
constructor parameters of the derived classes have been removed, too. - Its existing protected methods
install
anduninstall
have been renamed toinstallItem
anduninstallItem
. - Its protected methods
add
andremove
have been renamed toaddItem
andremoveItem
.
- The
-
The optional
SelectionModel
andModel
parameters ofHighlightIndicatorManager
andSelectionIndicatorManager
have been removed from the constructors, too. Instead, you can set the corresponding properties directly. -
The
NavigationInputMode#adjustGroupNodeLocation
method has now an additional parameterexpandedSize
that specifies the size of the group node when it is expanded. -
The
LabelCreator#addLabel
method can returnnull
if no label is added. -
The
LabelCreator#updateLabel
method now returns a boolean value:true
if the label has been updated,false
if the label should be removed. -
The
IHandle
interface has a new methodhandleClick
. This method must be implemented by custom handle implementations. -
The
DataProviderAdapter#defined
method has been removed since it had no effect. -
The
GraphModelManager#ProvideUserObjectOnMainCanvasObject
property has been renamed toProvidingUserObjectOnMainCanvasObjectEnabled
. -
The
NodeLabelingPolicy
enum has been moved fromcom.yworks.yfiles.layout.tree
tocom.yworks.yfiles.layout
. The reason is that the policy is now not only supported byBalloonLayout
but also byCircularLayout
,RadialLayout
andCactusGroupLayout
. -
The type of the
EdgeCellInfo#CellSegmentInfos
property has been changed fromYList
toCellSegmentInfo[]
. -
The
HierarchicLayoutData#SubComponents
property is replaced by the newHierarchicLayoutData#Subcomponents
property with a different signature. The new property uses instances of the newSubcomponentDescriptor
class to define subcomponents, and the layout algorithm responsible for a component is now specified via the newSubcomponentDescriptor#LayoutAlgorithm
property. -
Similarly, the data provider keys
HierarchicLayout#SUB_COMPONENT_ID_DPKEY
andHierarchicLayout#SUB_COMPONENT_LAYOUT_ALGORITHM_DPKEY
are replaced by the new keyHierarchicLayout#SUBCOMPONENT_DESCRIPTOR_ID_DPKEY
that assigns instances of the newSubcomponentDescriptor
class to nodes. -
The
TemporaryGroupNodeInsertionData#Components
property is replaced by the newTemporaryGroups
property of typeTemporaryGroupDescriptor
, which now specifies groups and the applied recursive group layout algorithm. -
Similarly, the data provider key
TemporaryGroupNodeInsertionStage#COMPONENT_LAYOUT_ALGORITHM_DPKEY
was removed and the name of the keyTemporaryGroupNodeInsertionStage#COMPONENT_ID_DPKEY
was changed toTEMPORARY_GROUP_DESCRIPTOR_DPKEY
. -
The
Pen#DashStyle
property is now marked as@Nonnull
, since several internal usages assumed that to be the case anyway.
Changes of Default Behavior
-
The semantic of the
TraversalDirection#BOTH
enumeration value used by theNeighborhood
andBfs
algorithms has been changed and does not ignore the direction anymore, but now returns a union of theSUCCESSOR
and thePREDECESSOR
results instead. The old behavior can be restored by using the newTraversalDirection#UNDIRECTED
enum value. Consequently, the default value of theTraversalDirection
property of both theNeighborhood
and theBfs
algorithm has been changed fromBOTH
toUNDIRECTED
. -
With the graph builder classes, label bindings which don't provide label data (or provide
null
) no longer add empty labels. Instead, no label will be added. Similarly, for label sources, no label will be added for data items for which theLabelCreator#TextProvider
returnsnull
. -
When starting to drag the handle of a selected item, the handle isn't replaced anymore by a new
handle instance provided for the selected item. Previously, this happened automatically, regardless of whether
necessary to support use cases where state changes should result in a different handle instance. Now, the
GraphEditorInputMode#requeryHandles
method has to be called explicitly when changes are made that affect handles that are potentially already visible. Alternatively, a proxy implementation can be used that dynamically dispatches to new instances on its own when required. -
The
HandleInputMode
class doesn't initialize a handle drag as soon as the handle is pressed, anymore. Instead, it waits until theDraggedRecognizer
is triggered. When pressed, the mutex is already acquired, which discards other concurrent input modes. This can be turned off by setting theRequestMutexOnPress
property tofalse
. -
ResizeStripeInputMode
now always uses theN_RESIZE_CURSOR
for resizing rows and theW_RESIZE_CURSOR
for resizing columns instead of usingN_RESIZE_CURSOR
,S_RESIZE_CURSOR
,W_RESIZE_CURSOR
orE_RESIZE_CURSOR
depending on the dragged side. The old behavior was inconsistent when dragging the border between two stripes and had no visual difference on most platforms. New cursor properties have been added that can be used to set a custom cursor for different usecases. -
The lists returned by the
GraphPartition#getCells
,DynamicObstacleDecomposition#getCells
andDynamicObstacleDecomposition#getObstacles
methods are no longer unmodifiable. -
The value of the
DefaultLayerSequencer#MaximumDuration
property is now unrestricted. Previously, it was restricted to 10 seconds. It is used by theHierarchicLayout
class, which still adheres to its own maximum duration.
Deprecations
-
The
BevelNodeStyle
,ShinyPlateNodeStyle
, andPanelNodeStyle
classes and their renderers are now deprecated. Their appearance is rather outdated, and some of them are not very configurable. For group nodes, have a look at the newGroupNodeStyle
class.
New Demos
-
The Group Node Style Demo shows the new
GroupNodeStyle
in different configurations. -
The Arrow Node Style Demo shows the new
ArrowNodeStyle
and its setting options. -
The Rectangle Node Style Demo shows the new
RectangleNodeStyle
and its setting options. -
The Shape Node Style Demo shows the shapes that are available for the
ShapeNodeStyle
. -
The Default Label Style Demo shows the background shapes that are now available for the
DefaultLabelStyle
. - The Text Wrapping Demo shows the various options of the new text wrapping feature for labels.
- The Layout Without View Demo shows shows how to create a graph, run a graph analysis algorithm, and calculate a layout without using a view or the IGraph API.
yFiles for Java (Swing) 3.5
Major New Features
Smooth animations
-
Many viewport transitions are now smoothly animated. This prominently includes scrolling and
zooming with the mouse wheel, but also the various commands, such as zooming via a toolbar button, fitting the graph
into the viewport, interacting with the overview, and many others. This can be turned off for individual
interactions via the new
CanvasComponent#AnimatedViewportChanges
property, and customized with the new protected methodCanvasComponent#getViewportAnimationDuration
.
Node Types
-
The
CircularLayout
class is now able to separate nodes that are on the same cycle with respect to their node type. For this, the newNodeTypeAwareSequencer
class can be set asNodeSequencer
on theCircularLayout#SingleCycleLayout
. Node types are specified via theCircularLayoutData#NodeTypes
property. -
The
ComponentLayout
class now supports node types. The types influence the arrangement and ordering of the components such that components consisting mostly of nodes of the same type are put close to other components consisting of nodes of that type. Use theComponentLayoutData#NodeTypes
property to define types. -
The
TreeLayout
andClassicTreeLayout
classes now support node types. The types influence the ordering of child nodes and the subtrees rooted at them such that nodes of the same type are preferably placed next to each other. Node types are a weak criterion, i.e., if the ordering and placement is determined by other constraints, these are prioritized. Types can be defined via theTreeLayoutData#NodeTypes
property. -
The
HierarchicLayout
class now supports node types. The types influence the ordering of nodes within their layers as a subordinate optimization criteria. More precisely, nodes of the same type are more likely to be placed next to each other if this does not violate other constraints. -
The
OrganicLayout
class now allows defining node types via the newOrganicLayoutData#NodeTypes
property. The types control the detection of substructures (e.g. stars, parallel structures). When types are defined, only nodes of the same type can form a substructure. For star-like and parallel substructures, it is also possible to have a single substructure with nodes of different types, see properties#ParallelSubstructureTypeSeparationEnabled
and#StarSubstructureTypeSeparationEnabled
. The algorithm still tries to highlight the different types by choosing a suitable layout for these components (e.g., placing nodes of the same type closer together or on the same circle). -
The
OrthogonalLayout
class now allows defining node types via the newOrthogonalLayoutData#NodeTypes
property. The types control the detection of substructures, i.e., chains, cycles and trees. When types are defined, only nodes of the same type can form a substructure. -
The node types feature is shown in the new
NodeTypesDemo
and the newOrganicSubstructuresDemo
.
Edge routing only if needed
-
Added the new penalty property
PenaltySettings#SketchViolationPenalty
supported by theEdgeRouter
class. It defines the cost for a deviation from the original edge path if the new routing policy property is set to#SEGMENTS_AS_NEEDED
. -
Optionally, the
EdgeRouter
,ChannelEdgeRouter
andBusRouter
classes now automatically determine whether a new path should be calculated for a certain edge. This is controlled via the new propertiesEdgeLayoutDescriptor#RoutingPolicy
,ChannelEdgeRouter#RoutingPolicy
andBusDescriptor#RoutingPolicy
, respectively. The decision is based on the quality of the existing routes - edges with strict violations of the routing style or that intersect other elements will be selected for routing. Available options:RoutingPolicy#ALWAYS
: A new route is calculated in any case. This was the previous behavior and remains the default.RoutingPolicy#PATH_AS_NEEDED
: The algorithm determines whether a new route is needed. If an edge is selected, its current path is not considered when computing a new route.RoutingPolicy#SEGMENTS_AS_NEEDED
: The algorithm determines whether a new route is needed. If an edge is selected, its current path is preserved as much as possible. Only the required segments are changed. This is only supported by theEdgeRouter
class.
New Features
Graph, and View
-
The graph and tree builders now support bindings for bend locations. This is implemented by new
bend-related members of the
EdgeCreator
class. -
The new
EdgePathPortLocationModel
for ports owned by edges can be used to define port locations as a ratio of the edge path length. This keeps the port location stable when bends are added onto the edge path, for example during orthogonal edge editing.
Layout and Algorithms
-
The new
TreeAnalysis
algorithm offers a convenient way of analyzing tree structures and querying tree-related properties (e.g. leaf nodes, parent-child relations and more). -
The new
ParallelEdges#findParallelEdges
method allows to find all sets of parallel edges contained in a given graph or incident to a specific node. -
The new
GenericLayoutData
class is a generic implementation ofLayoutData
that allows to pass arbitrary data to layout stages. As a consequence, theLayoutData#apply
,ItemCollection#provideMapper
andItemMapping#provideMapper
methods were removed. -
The new
SelfLoopRouterData
class specifies custom data for theSelfLoopRouter
class. In more details, it allows defining which self-loop edges should be routed and which should keep their current path. -
The new
PortPlacementStageData
class specifies custom data for thePortPlacementStage
class. In more details, it allows defining port candidates, port constraints, and node port candidate sets which are then considered by that layout stage. -
The
SubgraphLayout
class now allows defining which edges must be included or excluded in the subgraph. Previously, only nodes could be specified. The newSubgraphLayoutData
class offers the#SubgraphNodes
and#SubgraphEdges
properties to conveniently define the nodes and edges that should form the subgraph the core layout runs on. -
The
OrganicLayout
class offers the new#ClusteringPolicy
property, which allows to specify the clustering algorithm that is applied to the input graph. Three clustering algorithms are available: Louvain modularity, edge betweenness, and label propagation. Previously, the node clustering was always based on edge betweenness. By default, clustering is disabled. -
The
PartialLayout
class offers a new property#MovingFixedElementsAllowed
to allow moving fixed elements. This often yields a better layout quality even though the preservation of the mental map declines because the fixed elements may change their position. -
The
OrganicLayout
andClassicOrganicLayout
classes support the new scopeMAINLY_SUBSET_GEOMETRIC
. In addition to the actual affected nodes, this scope may to some degree move nodes that are geometrically close to an affected node. The existing scopeMAINLY_SUBSET
is similar, but it does determine the closeness of other nodes by using the graph structure instead of the current geometry (i.e. location).
Improvements
Interaction
-
The new
HandleInputMode#QueryClosestHandle
event can be used to provide the closest handle for a certain query location. -
Tooltip contents can now be provided asynchronously. As an alternative to setting the tooltip
content directly, the
ToolTipQueryEventArgs
class also accepts aCompletionStage
that provides the tooltip content asynchronously. -
The
HandleInputMode#beginDragging
method now returns aCompletionStage
which indicates whether the drag of a handle has been finished or canceled. -
Validation of the text of edited labels can now be provided asynchronously. The new
LabelTextValidatingEventArgs#ValidatedText
property accepts aCompletionStage
that provides the validated text asynchronously. -
The
CanvasComponent#zoomToAnimated
method now returns aCompletionStage
that is completed when the animation has finished. The parameter of typeIEventListener<AnimationEventArgs>
has been removed. -
The
CreateEdgeInputMode#doStartEdgeCreation
method now returns aCompletionStage
that completes when the edge creation gestures has been finished or cancelled. - The methods
GraphEditorInputMode#createLabel
,#createLabelCore
,#editLabel
,#editLabelCore
, and#addLabel
now return aCompletionStage
that completes when the label creation, editing or adding has been finished. -
The methods
TableEditorInputMode#createLabel
,#editLabel
, and#addLabel
now return aCompletionStage
that completes when the label has been created, edited or added. -
The
MoveInputMode#doStartDrag
method now returns aCompletionStage
that completes when the move gestures has been finished or cancelled. - Changing the selection state of a large number of elements is now faster.
-
The
OrthogonalEdgeEditingContext#createOrthogonalEdgeDragHandler
method now accepts anIPortOwner
instead of only anINode
as dragged item. This can be used for custom edge drag handling that should support orthogonal edge editing. -
The
ItemCopiedEventArgs
class now guarantees that its#Original
and#Copy
properties are notnull
.
Graph
-
The
DefaultFolderNodeConverter
andAbstractFoldingEdgeConverter
classes now have#PortLabelStyle
and#PortLabelLayoutParameter
properties to control the style and label layout parameter of copied port labels. -
The new
NodeInsetsProvider
class is anINodeInsetsProvider
that returns the same insets for each node. -
The
GraphBuilder
,TreeBuilder
, andAdjacencyGraphBuilder
classes no longer throw Exceptions during calls to#updateGraph
when the graph was modified.
Organic Layout
-
For the substructures in the
OrganicLayout
it is now possible to explicitly specify whether structures are allowed to be nested or not. Previously, substructures were allowed to be nested by default. New styles were added while the old styles now will not generated nested structures anymore.- Star structures offer the new styles
StarSubstructureStyle#RADIAL_NESTED
andStarSubstructureStyle#CIRCULAR_NESTED
. ChainSubstructureStyle#RECTANGULAR_NESTED
andChainSubstructureStyle#STRAIGHT_LINE_NESTED
are the new styles for nested chains.CycleSubstructureStyle#CIRCULAR_NESTED
is the new style for nested cycles.
- Star structures offer the new styles
-
The
OrganicLayout
class now offers the possibility to define the minimum sizes of substructures (stars, chains, cycles, and parallel structures). Structures of smaller size are not handled as a substructure. For each type of structure a new property was added:OrganicLayout#StarSubstructureSize
,OrganicLayout#ChainSubstructureSize
,OrganicLayout#CycleSubstructureSize
andOrganicLayout#ParallelSubstructureSize
. -
With substructures, the
OrganicLayout
class now often produces more compact results and comes with an improved placement of degree-one nodes. -
When specified for the
OrganicLayout
class, the scopeMAINLY_SUBSET
now works together with more of its other features and constraints, and has a larger impact. For example, it previously had very little or no effect when a partition grid or an output restriction was defined.
Edge Routing
-
When the
EdgeRouter
class runs with a highly restricted maximum duration or is aborted via theAbortHandler
class, i.e., the router operates in the fastest possible mode, the calculated edge routes now are of higher quality. The quality improvements mainly affect cases with fixed port locations. -
The
EdgeRouter
class now allows to explicitly define the costs for different types of edge crossings. The new propertiesPenaltySettings#AdjacentEdgeCrossingPenalty
andPenaltySettings#SelfCrossingPenalty
relate to crossings between two adjacent edges and crossings between two line segments that belong to the same edge, respectively. Previously, all types of crossings were covered by the existingEdgeCrossingPenalty
property.- By default, now, crossings of adjacent edges are more expensive than normal ones and self-crossings are the most expensive.
- Furthermore, the default values of the
EdgeLengthPenalty
andGroupNodeCrossingPenalty
properties were increased to obtain more balanced results.
-
The
EdgeRouter
class now produces more suitable routes for edges with octilinear routing style. Previously, the diagonal segments where often omitted after/before an edge's first/last segment.
Hierarchic Layout
-
The
HierarchicLayout
class now generates shorter paths for edges that cross borders ofPartitionGrid
columns in cases where there are no other obvious constraints that require the edge to be longer. This holds for the default vertical layout orientation; for a horizontal orientation, edges that cross borders of rows are affected by this improvement. -
The
HierarchicLayout
class now considers the edge direction when choosing a port candidate for edges with multiple candidates. This new strategy often leads to fewer bends.
Layout
-
LayoutExecutor#start
,GraphComponent#morphLayout
andLayoutUtilities#morphLayout
now return aCompletionStage
instead ofnull
. -
The new
BalloonLayoutData#OutEdgeComparator
property specifies a comparison function used to sort a nodes' outgoing edges. -
The new
LayoutGraphAdapter#ORIGINAL_TAG_DP_KEY
data provider key provides access to the object stored in thetag
property of the original graph item from within custom layout code. -
The quality of the curved edge routing was improved with respect to various aspects and such that
it yields aesthetically nicer curves. To further configure the curve routing, the following settings were added.
CurveShortcutsAllowed
: if shortcuts are allowed, curves can become smoother and more direct but may violate other constraints (e.g. edge-edge distance). Available forHierarchicLayout
(RoutingStyle#CurveShortcutsAllowed
),EdgeRouter
(EdgeLayoutDescriptor#CurveShortcutsAllowed
) andCurveRoutingStage
(CurveEdgeLayoutDescriptor#CurveShortcutsAllowed
).CurveUTurnSymmetry
: allows to specify the symmetry preference for u-turns (180 degree turns) of curved routes. The default is zero so that results are equal to previous results. Available forHierarchicLayout
(RoutingStyle#CurveUTurnSymmetry
),EdgeRouter
(EdgeLayoutDescriptor#CurveUTurnSymmetry
) andCurveRoutingStage
(CurveEdgeLayoutDescriptor#CurveUTurnSymmetry
).
-
The
HierarchicLayout
,EdgeRouter
, andCurveRoutingStage
classes now avoid unnecessary, consecutive Bezier segments for modeling larger straight-line parts of an edge path. The resulting reduced bend count improves the user experience when working with theBezierEdgeStyle
. -
The
ClassicTreeLayout
class now features properties#MinimumFirstSegmentLength
and#MinimumLastSegmentLength
that allow to specify the minimum first and last segment length for the orthogonal routing style. -
The new
ParallelEdgeRouterData#RoutedParallelEdges
property returns which edges theParallelEdgeRouter
class routed and thus were hidden during the core layout. This can be useful if parallel, non-leading edges need further handling, e.g., for placing their labels.
View
-
The
CanvasComponent#makeVisible
,CanvasComponent#fitContent
, andGraphComponent#fitGraphBounds
methods now return aCompletionStage
that completes when the view port adjustment has been finished. -
The
Animator#animate
method now returns aCompletionStage
that is completed when the animation has finished. The parameter of typeIEventListener<AnimationEventArgs>
has been removed together with theAnimationEventArgs
class. -
The new
#install
and#uninstall
methods of theGraphModelManager
class simplify exchanging the manager used by aGraphComponent
. They are called when setting/removing aGraphModelManager
asGraphComponent#GraphModelManager
and should also be called when combining aGraphModelManager
with aCanvasComponent
. -
The new
IAnimation#createDelay
method creates an animation that does nothing. This is especially useful in combination with other animations that run in parallel or in sequence to create complex multi-sequence animations. The accompanying method#createDelayedAnimation
for theIAnimation
interface delays the provided animation. -
The new
IAnimation#fromCallback
method creates an animation for a given animation callback and duration. -
The
CanvasComponent#makeVisible
method now respects margins defined by theCanvasComponent#ContentMargins
property. Ensure visible is called for example by keyboard navigation,. -
The
ZOOM
command now respects margins defined by theCanvasComponent#ContentMargins
property when executed with a rectangle as parameter. -
The
ZOOM_TO_CURRENT_ITEM
command now respects the margins defined in theCanvasComponent#ContentMargins
property. -
Setting the various descriptor properties of the
GraphModelManager
class no longer causes updates for every installed item if the descriptor hasn't actually changed. -
The
OverviewInputMode
now renders its handle on top of the viewport rectangle instead of below it. -
The
ViewportLimiter#limitViewport
method now has an overload with a parameter that enforces theViewportLimitingPolicy#STRICT
policy. -
The
CanvasComponent#makeVisible
method now has an overload with a parameter to specify insets to keep around what to make visible in the viewport. -
The
CanvasComponent#makeVisible
method now has an additional overload to make a set of points visible in the viewport. This is mainly useful when using a Projection and trying to make something visible that is not a rectangle in world coordinates. -
All the following features no longer block user interaction: the viewport animations for
CanvasComponent#makeVisible
, executing scroll commands when theCanvasComponent#ScrollCommandAnimationEnabled
property is enabled, and executingICommand#ZOOM_TO_CURRENT_ITEM
. -
The
CanvasComponent#fitContent
andGraphComponent#fitGraphBounds
methods now have an overload with a parameter that allows changing the viewport in an animated fashion. -
GraphComponent#openFile
now auto-completes the chosen filename with the file extension chosen in theFileDialog
if missing.
Styles
-
Edge cropping now works as expected when using
BezierEdgeStyle
and the terminating nodes have styles that don't provide an outline in theirIShapeGeometry
implementation.
Bugfixes
Interaction
-
When expanding a closed group, the parent groups of the expanded group no longer become
unnecessarily large. The incorrect behavior could be observed only under certain conditions and was caused by a bug
in the
NavigationInputMode
class. - Auto dragging was not stopped in certain cases.
-
The text area shown by the
TextEditorInputMode
class is now correctly placed if theTextAreaPlacementPolicy#MOVE_TEXT_AREA
is set and a projection is used. -
Fixed editing self-loops with
PolylineEdgeStyle
and orthogonal edge editing enabled. -
HandleInputMode
is no longer canceled if a handle is removed during its ownDragFinished
call. This fixes some very rare exceptions under complicated circumstances. -
Fixed a bug in
CreateEdgeInputMode
which prevented toggling the direction of an orthogonal edge segment when the mouse was over a potential target.
Graph
-
The
ITable#StripeChanged
event now reports the correct parent when re-parenting will be undone or redone. -
A label with
EdgeSegmentLabelModel
orEdgePathLabelModel
now moves steadily when the segment to which it belongs moves. -
The
FilteredGraphWrapper
class now dispatchesParentChanged
events in the correct order after predicate changes. -
All
#setFactory
methods of theNode
-,Edge
-,Label
-,Port
-, andBendDecorator
classes now respect the#nullIsFallback
property. -
FilteredGraphWrapper
now fires the correct events when filtering out port labels. Previously, the events contained incorrect owner information. -
Fixed
CompositeUndoUnit#UndoName
setting theRedoName
instead.
Styles
-
The parameter of type
IShapeGeometry
of theDefaultEdgePathCropper#isInside
and#getIntersection
methods is now nullable. - Built-in styles with rounded corners now have the correct outline shape for certain calculations.
- Edges with Bezier paths can now also be animated to non-Bezier paths.
Geometry
-
The
#Area
property of an emptyRectD
instance (includingRectD#EMPTY
) is now always zero, and no longer a negative value.
Hierarchic Layout
-
The
HierarchicLayout
class now correctly processes input graphs with sub-components (HierarchicLayoutData#SubComponents
) and curved edge routing style. Previously, such setups may have a caused an exception. -
The
HierarchicLayout
class now correctly handles grouped input graphs if the node compaction is enabled (see propertySimplexNodePlacer#NodeCompactionEnabled
). Previously, the algorithm sometimes produced less compact results for such inputs. -
The
HierarchicLayout
class now correctly considers the specified port groups for edges (seeHierarchicLayoutData#SourcePortGroupIds
). Previously, such groups were not always considered properly if there are either critical edges or propertySimplexNodePlacer#EdgeStraighteningEnabled
istrue
. -
The
HierarchicLayout
class now correctly considers the specified critical edge priorities (seeHierarchicLayoutData#CriticalEdgePriorities
) if the input graph contains grouped edges. -
The
HierarchicLayout
class now adheres more closely to its maximum duration and itsAbortHandler
. -
The
HierarchicLayout
now considers thePortCandidate
directions correctly for layout orientations other thanTOP_TO_BOTTOM
. This also improves the optimization results withPortCandidateSets
that allow multiple directions to connect to nodes. -
The
HierarchicLayout
class now correctly considers input graphs with group nodes and aPartitionGrid
. Previously, in some rare cases, such inputs may have caused overlapping group nodes. -
The
HierarchicLayout
class no longer generates broken non-orthogonal edge segments of same-layer edges for some cases in conjunction with integrated edge labeling and edge labels placed at the ports. -
The
HierarchicLayout
class now correctly routes grouped edges where in some rare cases it could previously lead to node-edge overlaps. -
The
HierarchicLayout
class not properly satisfiesPortCandidates
defined for same-layer edges at nodes where additionally other edges with (rather large) source/target port labels exist. -
The
HierarchicLayout
class now produces a correct edge grouping structure for short edges having the same source and target group ID. -
The
HierarchicLayout
class no longer produces superfluous port overlaps if there are edges with strong port constraints. -
The
HierarchicLayout
class now correctly assigns ports to edges incident to groups if the uniform port assignment is enabled (see propertyHierarchicLayoutData#UniformPortAssignmentGroups
) for some cases where it previously did not yield a uniform port distribution. -
The
HierarchicLayout
now correctly considers thePreferredPlacementDescriptor
settings of an edge label when there are additionally edge groupings defined. Previously, it could, for example, happen that the edge label was placed on the wrong side of the edge. -
The
HierarchicLayout
no longer throws an Exception when the edge directedness feature (HierchicLayoutData#EdgeDirectedness
) is used in conjunction with enabled backloop-routing (HierarchicLayout#BackLoopRoutingEnabled
). -
The
HierarchicLayout
class no longer creates unnecessary spacing between sub-components (seeHierarchicLayoutData#SubComponents
) and other elements, which previously happened in some cases due to edge/node labels being present. In consequence, these cases are now more compact. -
The
HierarchicLayout
class no longer produces overlaps between (large) external node labels and unrelated edges. -
The
HierarchicLayout
class no longer produces overlaps between sub-component elements (seeHierarchicLayoutData#SubComponents
) and edges that are not part of the component.
Organic Layout
-
The
OrganicLayout
class no longer throws an exception when running it on a graph with a partition grid, group nodes and such that the IDs of the group nodes (see provider keyGroupingKeys#NODE_ID_DPKEY
) are defined using a provider that cannot handlenull
as argument to its get method. -
The
OrganicLayout
andClassicOrganicLayout
classes no longer cause undesired layout side effects when a mapper is registered with keyRecursiveGroupLayout#GROUP_NODE_LAYOUT_DPKEY
or when data is provided via theRecursiveGroupLayoutData#GroupNodeLayouts
property. Previously, the layout algorithms registered there could be applied to nodes that should actually be kept fix by the organic layout. -
The
OrganicLayout
class now produces correct results if auto-clustering is enabled (i.e., propertyClusteringPolicy
is notNONE
) and theGroupNodeMode
is set toFIX_BOUNDS
orFIX_CONTENTS
. -
The
OrganicLayout
class now correctly considers fix-contents and fix-bounds groups (see enumGroupNodeMode
) if the substructure detection is enabled. -
The
OrganicLayout
class now correctly handles nodes with several degree-one neighbors. Previously, such inputs could cause arrangement artifacts if theStarSubstructureStyle
isNONE
. -
The
OrganicLayout
class now correctly detects chain substructures if there are nodes of different types (OrganicLayoutData#NodeTypes
).
Circular Layout
-
The
CircularLayout
class no longer crashes when enabling edge bundling, defining node types (CircularLayoutData#NodeTypes
) and applying it on a graph that contains parallel edges. -
The
CircularLayout
class no longer produces node overlaps if propertySingleCycleLayout#MinimumNodeDistance
is set to 0.
Partial Layout
-
The
PartialLayout
class now correctly routes the edges if propertyMovingFixedElementsAllowed
is enabled. Previously, in some rare cases, this setting could cause broken edge routes.
Clear Area Layout
-
The
ClearAreaLayout
class now correctly routes the edges if propertyEdgeRoutingStrategy
is set toSTRAIGHTLINE
. Previously, in some rare cases, this setting could cause broken edge routes.
Edge Routing
-
The
EdgeRouter
class no longer generates unnecessary detours in the routes when it is configured withMonotonicPathRestriction#BOTH
. -
The
CurveRoutingStage
class now correctly considers the minimum distance to nodes specified as value of theCurveEdgeLayoutDescriptor#MinimumNodeToEdgeDistance
property. Previously, the curves could violate the distance and get too close to nodes. -
The
EdgeRouter
class no longer has a problem that occasionally resulted in bad edge routing artifacts if edge grouping is enabled and non-affected edges are grouped at both end points. -
The
EdgeRouter
class no longer occasionally throws an exception if the input contains bus edges (defined viaBusDescriptor
). -
The
OrganicEdgeRouter#KeepingExistingBendsEnabled
property now correctly obeys its definition and actually keeps the absolute coordinates of the existing bends. -
The
EdgeRouter
class no longer produces artifacts if there are edges with curved routing style and labels, and the integrated edge labeling is disabled (see propertyEdgeRouter#IntegratedEdgeLabelingEnabled
).
Layout
-
The comparison delegates defined in
TreeLayoutData#OutEdgeComparators
andSeriesParallelLayoutData#OutEdgeComparators
no longer receivenull
elements during runtime. -
The
SimpleProfitModel
class now computes meaningful different profits based on thePreferredPlacementDescriptor
for candidates that belong to aSliderEdgeLabelLayoutModel
or aDiscreteEdgeLabelLayoutModel
. Previously, the computed profit was equal for all candidates. -
Fixed a bug in
LayoutExecutor
which caused port labels not to be placed in their calculated position after a layout animation. -
The
LayoutExecutor
class now uses the correct target bounds when a projection is set on theGraphComponent
. -
The
CircularLayout
class no longer produces node label overlaps when itsPlacingChildrenOnCommonRadiusEnabled
property is disabled. -
The
ClearAreaLayout
class now correctly considers node labels. Previously, there could be results where node labels intersected with the specified area to be cleared. -
The
ParallelEdgeRouter
class now produces correct parallel routes if itsJoiningEndsEnabled
property is enabled. -
Curved edge routes generated by
HierarchicLayout
,EdgeRouter
andCurveRoutingStage
no longer contain a self-crossing for edges that connect to a group node and where the connection styleCurveConnectionStyle#ORGANIC
is specified. -
Fixed a bug in
TableLayoutConfigurator
that resulted in wrongOriginalPositions
of theRowDescriptors
andColumnDescriptors
when table insets were used. - Fixed a bug that caused errors in shear transformations.
-
Fixed the
UndoEngine
getting corrupted after a layout exception has been catched. -
The
TabularLayout
class now correctly handles the case that the input graph contains only a single node. Previously, the node was not properly assigned to a partition cell and the partition cell row/column did not get correct values for its computed width, height and position.
View
- The mouse event coordinates are no longer quantized to very large steps if a projection is used and the viewport is zoomed in afterwards.
-
The clipboard now doesn't copy labels or ports if they are not selected and their owner's
IClipboardHelper
forbids copying the owner. -
The
ZOOM_TO_CURRENT_ITEM
command no longer moves the current item outside the visible area in rare cases. This was caused by a problem in theViewportLimiter
class. -
Callbacks registered for removed visuals on the
CanvasObject
tree now reliably run after the visual is indeed no longer visible. -
Callbacks registered with the
IRenderContext#setDisposeCallback
method now are reliably called, even when a canvas object has been explicitly removed. -
The
CanvasComponent#makeVisible
method no longer ignores the limited viewport size in certain cases. -
CanvasComponent
's orGraphComponent
's scrollbars now respect the component'sViewPortLimiter
. - Fixed a bug that didn't reset the cursor when exiting the canvas and hovering over the scrollbars.
-
Fixed a potential memory leak that could occur when changing the
GraphComponent#GraphModelManager
. -
The
CanvasComponent#ZoomToAnimated
method now works correctly when aProjection
is used. This has previously been reported as fixed, but was not.
Incompatible Changes
-
The protected method
HandleInputMode#isHovering
has been removed. To customize what handle should be used for a certain query location, the newHandleInputMode#QueryClosestHandle
event can be used. -
The
HandleInputMode#beginDragging
method now returns aCompletionStage
. -
The
CanvasComponent#Projection
property no longer accepts transforms with a non-zero translation component. -
The
CanvasComponent#ContentViewMargins
property has been renamed to#ContentMargins
. Accordingly, the#onFitContentViewMarginsChanged
method and the#FitContentViewMarginsChanged
event have been renamed to#onContentMarginsChanged
and#ContentMarginsChanged
, respectively. -
The
CanvasComponent#zoomToAnimated
method now returns aCompletionStage
that is completed when the animation has finished. The parameter of typeIEventListener<AnimationEventArgs>
has been removed. -
The
CreateEdgeInputMode#doStartEdgeCreation
method now returns aCompletionStage
that completes when the edge creation gestures has been finished or cancelled. -
The
GraphEditorInputMode#onLabelTextEdited
method now returns aCompletionStage
that completes when the text validation is done and provides whether the validation succeeded or was canceled. - The methods
GraphEditorInputMode#createLabel
,#createLabelCore
,#editLabel
,#editLabelCore
, and#addLabel
now return aCompletionStage
that completes when the label creation, editing or adding has been finished. -
The methods
TableEditorInputMode#createLabel
,#editLabel
, and#addLabel
now return aCompletionStage
that completes when the label has been created, edited or added. -
The
MoveInputMode#doStartDrag
method now returns aCompletionStage
that completes when the move gestures has been finished or cancelled. -
LayoutExecutor#start
,GraphComponent#morphLayout
andLayoutUtilities#morphLayout
now return aCompletionStage
instead ofnull
. -
The
Animator#animate
method now returns aCompletionStage
that is completed when the animation has finished. The parameter of typeIEventListener<AnimationEventArgs>
has been removed together with theAnimationEventArgs
class. -
Animator#animateAndWait
has been removed as the waiting didn't work correctly. -
The
TextEditorInputMode#getTextBoxBounds
method has been removed. -
The new
GenericLayoutData
class is a generic implementation ofLayoutData
that allows to pass arbitrary data to layout stages. As a consequence, theLayoutData#apply
,ItemCollection#provideMapper
andItemMapping#provideMapper
methods were removed. -
The
PolylineEdgeRouterData
class has been renamed toEdgeRouterData
to match the name of the layout algorithm it supports. -
The overload of
Centrality#pageRank
taking just aGraph
parameter has been removed as it only returned the sum of all pageRanks. Use the overload taking aGraph
and anINodeMap
instead.
Behavior
-
The provider returned by
IEdgeReconnectionPortCandidateProvider#ALL_NODE_AND_EDGE_CANDIDATES
now doesn't return port candidates of the reconnected edge itself anymore as this lead to an unstable reconnection behavior. -
The
FIT_CONTENT
andFIT_GRAPH_BOUNDS
commands now change the viewport in an animated fashion. -
Zooming with the mouse wheel to the center of the viewport by using
CanvasComponent
'sCenterZoomEventRecognizer
no longer uses theINCREASE_ZOOM
andDECREASE_ZOOM
commands. - During animated viewport transitions, for performance reasons, mouse events are not redispatched, anymore, except for the last frame of the animation.
-
LayoutExecutor#start
doesn't throw an exception anymore if an error occurred during the layout that wasn't handled in the#LayoutFinished
event. Instead theCompletionStage
returned by#start
is completed exceptionally. -
The
OrganicLayout
substructure stylesStarSubstructureStyle#RADIAL
,StarSubstructureStyle#CIRCULAR
,ChainSubstructureStyle#RECTANGULAR
,ChainSubstructureStyle#STRAIGHT_LINE
andCycleSubstructureStyle#CIRCULAR
do no longer allow that the detected substructures are nested inside other substructures. To get the old behavior and allow nesting, new style values were added (e.g.StarSubstructureStyle#RADIAL_NESTED
). -
The following behavior change applies to class
HierarchicLayout
with polyline edge routing style: the default value of propertyEdgeLayoutDescriptor#MinimumSlope
was changed from0.3
to0.2
which makes the sloped segments less steep and the overall results more compact. -
In organic layout, the way edge grouping influences the layout of certain substructures has
changed. Structures are not split-up anymore into several ones when edges of nodes in the structure have different
group IDs. Now, the new node types can be used to split-up structures (see
OrganicLayoutData#NodeTypes
). If a structure contains different edge groups, the grouping is properly considered and may influence the sorting of elements within the structure. Affected substructure styles areStarSubstructureStyle#SEPARATED_RADIAL
,ParallelSubstructureStyle#RADIAL
,ParallelSubstructureStyle#STRAIGHT_LINE
andParallelSubstructureStyle#RECTANGULAR
. -
The
OrganicEdgeRouter#KeepingExistingBendsEnabled
property now correctly obeys its definition and actually keeps the absolute coordinates of the existing bends. Therefore, the new propertyOrganicEdgeRouter#ExistingBendsConsiderationEnabled
was introduced to get the old behavior. Existing bends are considered, but their absolute coordinates are not kept. -
The default value of the
ClassicTreeLayout#MinimumLayerDistance
property was changed from40.0
to20.0
and the default value of theClassicTreeLayout#BusAlignment
property was changed from0.3
to0.5
. In addition, the new#MinimumFirstSegmentLength
and#MinimumLastSegmentLength
properties may lead to different results compared to previous versions. Setting both properties to zero will neutralize their influence on the result. -
For the
DefaultNodePlacer
class that is used by theTreeLayout
, the default values of the#HorizontalDistance
and#VerticalDistance
properties were changed from40.0
to20.0
, and the default values of the#MinimumFirstSegmentLength
andMinimumLastSegmentLength
properties were changed from0.0
to20.0
. -
For the
CompactNodePlacer
class that is used by theTreeLayout
, the default values of the#HorizontalDistance
and#VerticalDistance
properties were changed from40.0
to20.0
, and the default values of the#MinimumFirstSegmentLength
and#MinimumLastSegmentLength
properties were changed from10.0
to20.0
. -
The default value of the
LayeredNodePlacer#BusAlignment
property was changed from0.3
to0.5
.
Deprecations
-
The
CanvasComponent#ScrollCommandAnimationEnabled
property has been deprecated in favor of the newAnimatedViewportChanges
property, which offers more control over viewport animations, not just the scroll commands. -
The
OrganicLayout#NodeClusteringEnabled
property is now deprecated. It is replaced by the newOrganicLayout#ClusteringPolicy
property. To disable clustering specifyClusteringPolicy#NONE
. To enable it and use the same algorithm as before, specifyClusteringPolicy#EDGE_BETWEENNESS
. -
The class
com.yworks.yfiles.analysis.TreeAnalyzer
has been deprecated. The more powerful classTreeAnalysis
should be used instead.
New Demos
-
The new
LensInputMode
demo shows how to create anInputMode
to show a magnifying glass effect on the canvas. -
The new
OrganicSubstructuresDemo
shows you how substructures are supported by theOrganicLayout
algorithm. -
The new
NodeTypesDemo
shows you how the new node types feature is supported by several layout algorithms. -
The new
ReshapeHandleProviderConfigurationDemo
shows you how to use a customIReshapeHandleProvider
implementation. TheReshapeHandleProviderDemo
has been re-written to show how to use the built-in providers. -
CompositeNodeStyle
demo shows how to combine multiple styles into one. -
The
NetworkFlowsDemo
has been added that shows how to use different network flow algorithms using a network of water pipes. -
The new
MavenDemo
shows how to set up a basic yFiles for Java (Swing) project using Apache Maven. -
The new
GradleDemo
shows how to set up a basic yFiles for Java (Swing) project using Gradle.
Demo Improvements
-
More sample graphs and configuration options have been added to the
LayoutStyle
demo.
yFiles for Java (Swing) 3.4.0.1
Improvements
View
-
The
ViewportLimiter
class now always centers the viewport if itsHonoringBothDimensionsEnabled
property is disabled.
Layout
-
The
HierarchicLayout
class now has an improved strategy for choosing the port candidates for same-layer edges with multiple available candidates. Previously, the chosen candidate may have led to superfluous back-loops.
Algorithms
-
The
LabelPropagationClustering
algorithm now produces normalized, continuous clustering IDs. In other words, for example, if it finds 5 clusters, they get IDs from 0 to 4. Previously, the range of IDs may have contained holes. If initial label values are provided, this normalization is omitted.
GraphML
-
The
ValueSerializer
for well-known color names now supports screaming snake case in addition to camel case and lower case names.
Bugfixes
View
-
The clipboard now doesn't copy labels or ports if they are not selected and their owner's
IClipboardHelper
forbids copying the owner. -
The
CanvasComponent#ZoomToAnimated
method now works correctly when a Projection is used. -
The
ZOOM_TO_CURRENT_ITEM
command no longer moves the current item outside the visible area in rare cases. This was caused by a problem in theViewportLimiter
class. -
Fixed a bug in
CanvasComponent#FitContent
andGraphComponent#FitGraphBounds
which causedFitContentViewMargins
being incorrectly applied in case aProjection
has been set. -
The following issues of the
ZOOM_TO_CURRENT_ITEM
command have been corrected:- The item is now longer placed slightly out of center if scrollbars appear during the operation.
- If the current item is too large to fit the viewport at zoom 1, the command now zooms out.
-
Fixed incorrect margins on an
GraphOverviewComponent
with aProjection
set. -
Fixed a bug which caused the
ZOOM
command to disrespect theViewportLimiter
if executed with a rectangle as parameter. - The mouse event coordinates are no longer quantized to very large steps if a projection is used and the viewport is zoomed in afterwards.
-
Fixed
Animator#animateAndWait
to update the canvas during the animation. -
GraphOverviewComponent
now considers its border thickness correctly when calculating the visible area of aGraphComponent
using a projection.
Graph
-
The
DefaultFolderNodeConverter
andAbstractFoldingEdgeConverter
classes (and thus, also theDefaultFoldingEdgeConverter
andMergingFoldingEdgeConverter
classes) no longer ignore port labels. -
A label with
EdgeSegmentLabelModel
orEdgePathLabelModel
now moves steadily when the segment to which it belongs moves.
Input
-
The
CreateEdgeInputMode
class no longer has an error which prevented the removal of port candidate visualizations after another input mode claimed to be active.
GraphML
- Labels at ports of collapsed nodes are no longer lost during GraphML serialization.
Styles
-
HtmlLabelStyle
: Fixed text placement when the render size of the label text exceeds the size reserved for the label.
Layout
-
The
TabularLayout
class no longer throws an exception about a missingPartitionGrid
when used withinRecursiveGroupLayout
andRecursiveGroupLayoutData
andTabularLayoutData
are used without an explicit cell-id mapping. -
The
LayoutExecutor
class now uses the correct target bounds when a projection is set on theGraphComponent
. -
When the
MaximumDuration
of theEdgeRouter
class is exceeded, it now still uses the same port for edges that are grouped. Previously, edge grouping constraints were mostly ignored when the time was up. -
Improved the reaction time of the
EdgeRouter
class when theMaximumDuration
is exceeded or the algorithm should stop due toAbortHandler
for some cases where previously the search for a path kept on running for a long time. -
The
RadialLayout
class is now much faster if the input graph is a very large tree structure. -
The
OrganicLayout
andClassicOrganicLayout
classes no longer produce an internal integer overflow that may lead to an early exit and, thus, poor layout results for very large input graphs. -
The
ClearAreaLayout
class no longer throws an exception for some scenarios where the same algorithm instance was first applied to a graph withPartitionGrid
and later to a graph without grid. -
The
EdgeRouter
andPolylineLayoutStage
classes no longer produce broken routes for edges with polyline segments. Previously, such broken routes may have appeared in rare cases. -
The
HierarchicLayout
class now correctly considers the back-loop routing style (HierarchicLayout#BackLoopRoutingEnabled
) for graphs with critical edges (seeHierarchicLayoutData#CriticalEdgePriorities
). -
The
ClearAreaLayout
andFillAreaLayout
classes no longer throw an exception for some input graphs with edge labels if propertyEdgeLabelConsiderationEnabled
is enabled. -
The
GenericLabeling
class no longer throws an exception for edge labels with preferred placement descriptor if propertyEdgeLabelPlacementEnabled
is disabled. -
The
TreeLayout
class now correctly handles trees with group nodes. Previously, it sometimes produced overlapping elements and halo violations for such inputs. -
The curved edge routes produced by
HierarchicLayout
,EdgeRouter
orCurveRoutingStage
no longer violate the minimum node-edge distance or intersect the node. Intersections could previously happen especially when the specified node-edge distance was zero. -
The
RecursiveGroupLayout
class now correctly handles setups that use both recursive and non-recursive group nodes. Previously, such use-cases may have led to invisible/ignored edges and, thus, broken edge routes. -
The
PartialLayout
class now transfers the value of itsPartialLayout#MaximumDuration
property to the internally used edge routing algorithm. This means that when the partial layout has a restricted running time, the routing part will be restricted, too. Previously, the duration of the edge routing was unrestricted. Note that if the router instance is user-specified, this instance will not get a maximum duration. -
The
HierarchicLayout
,EdgeRouter
andCurveRoutingStage
classes no longer occasionally throw an exception when the curved routing style is used for graphs that have self-loop edges. -
The
ClearAreaLayout
class now produces correct orthogonal routes for edges if itsClearAreaStrategy
property is set to a local strategy. Previously, some of the edges may have received a non-orthogonal route. -
The
EdgeRouter
class no longer throws an exception if the input contains a bus defined viaBusDescriptor
where all the associated edges are actually fixed.
Hierarchic Layout
-
The
HierarchicLayout
class no longer produces an infinite looping issue in the incremental layout mode for some input graphs with layer constraints that specify that a node should be placed in the topmost/bottommost layer. -
The
HierarchicLayout
class no longer produces unnecessary edge crossings between self-loop edges at the same node in cases where a larger number of self-loops exist at a node. -
The
HierarchicLayout
class no longer ignores edges connected to group nodes when the group node contains a bus structure (seeHierarchicLayoutData#Buses
) and no other elements. Such edges were previously actually removed from the layout graph such that other stages (e.g. theComponentLayout
) could have failed with an exception. -
The
HierarchicLayout
class no longer occasionally throws an exception when enablingHierarchicLayout#GroupCompactionEnabled
and in conjunction with layering constraints and/or a group node marked as incremental. -
The
HierarchicLayout
class does no longer violate the specified minimum length for edges incident to group nodes. -
The sequencing phase of the
HierarchicLayout
class is now faster for large graphs with sequence constraints and non-incremental layout mode.
Edge Routing
-
The
BusRouter
class now produces more suitable edge routes for rare cases that were caused by an unsuitable bus placement. -
The
EdgeRouter
class now uses the given ports for edges of a bus with fixed edges. -
The
EdgeRouter
class now correctly considers edges incident to a fixed inner port of a group node when the routing algorithm has restricted maximum duration. Previously, this setup sometimes led to strange edge routes with many superfluous bends. -
The
EdgeRouter
class no longer contains edges with self-crossings in some rare cases where it previously failed to eliminate them. -
The
EdgeRouter
andCurveRoutingStage
classes no longer change the path of unaffected (fixed) edges when theControlPointCreationEnabled
property of their associatedEdgeLayoutDescriptor
instance (CurveEdgeLayoutDescriptor
respectively) is enabled. -
The
EdgeRouter
class now correctly supports the use case that a subset of edges is routed with the curved routing style while another subset is routed with another routing style and different settings on the associated individualEdgeLayoutDescriptor
instances. Previously, with some edges being curved, the settings of the other edges got lost and the default settings were used. -
The
OrthogonalSegmentDistributionStage
class does no longer crash when receiving input graphs with a very large edge count (greater than approximately 22000). Note that theChannelEdgeRouter
class is affected too, as the stage is by default called from within the router.
Analysis
-
The
Cycles#FindCycleEdges
algorithm no longer crashes when the given input graph contains self-loops.
yFiles for Java (Swing) 3.4
This release contains many new major features and lots of other new features, improvements, and bugfixes for all parts of the library. In addition to the new demos, there are some notable demo improvements, too.
If you are updating from an older version of yFiles for Java, have a look at the list of incompatible changes.
Major New Features
- Isometric Drawing and Other Projections
-
CanvasComponent
(and thusGraphComponent
) now has an additionalProjection
property that can be used to transform the viewport into a different parallel projection, e.g. isometric or cabinet projection. Predefined useful projections are provided as constants on the newProjections
class. Interaction, including graph editing, snapping, orthogonal edge editing, etc. still work as expected, just within the new projection. That is, orthogonal edge editing becomes isometric edge editing with an isometric projection. There is a corresponding chapter in the Developer's Guide that goes into further detail what has changed and which customization options exist.The
IsometricDrawingDemo
displays graphs in an isometric fashion to create an impression of a 3-dimensional view. - Fill Area Layout and Clear Area Layout
-
The new
ClearAreaLayout
algorithm clears a user-specified area in an existing layout by moving elements. It is suitable if the rest of the layout should not change much but some free space is required, e.g., because new elements need to be inserted into the drawing or have been resized.The new
The following two new demos showcase the new layout algorithms:FillAreaLayout
algorithm fills a user-specified area in an existing layout by moving elements into or towards it. It can make layouts around the specified area more compact and is suitable if, e.g., elements were removed from the graph or their size has changed substantially.-
The new
MarqueeClearAreaLayoutDemo
shows how to make space in a diagram by dragging a marquee rectangle. -
The new
FillAreaAfterDeletionDemo
shows how to fill free space after deleting nodes using theFillAreaLayout
algorithm.
-
The new
- Aggregation and Analysis of (Large) Graphs
-
Many new algorithms for analyzing graphs are now included, for example to detect components and clusters, to aggregate sub-graphs, and to calculate centrality values. In addition, the analysis algorithms now have the option to define a subset of the graph to work on. In detail, the new classes are:
-
The new
NodeAggregation
class provides an algorithm that intelligently aggregates nodes of (large) input graphs. It does not require complex configuration and can be used without knowledge of specific clustering or aggregation techniques. -
The
KCoreComponents
class provides a component detection algorithm that finds k-cores. -
The classes
LouvainModularityClustering
andLabelPropagationClustering
provide two new algorithms for cluster detection. -
The
EigenvectorCentrality
class offers a centrality algorithm that measures the influence of a node in a network based on the Eigenvector score. -
The
PageRank
class provides a centrality algorithm that calculates the so-called page rank for the nodes. -
The classes
ChainSubstructures
,CliqueSubstructures
,CycleSubstructures
,StarSubstructures
, andSubtreeSubstructures
provide new algorithms that detect isolated substructures like chains, cliques, cycles, stars, or subtrees. This can be used as an input to other (layout) algorithms. -
The class
GraphStructureAnalyzer
now offers additional methods to calculate the average degree, the average weighted degree, the diameter, and the density of a given graph.
-
The new
- Support for Curved Edges
-
The new
BezierEdgeStyle
renders edges with smooth Bezier-curve paths.In addition, the new edge label models
BezierEdgePathLabelModel
andBezierEdgeSegmentLabelModel
place labels optimally on curved edges rendered with this style.Support for curved edges has been added to the layout and edge routing algorithms
EdgeRouter
and theCurveRoutingStage
, andHierarchicLayout
. - Interactive Node Resizing
-
Resizing nodes using their handles now supports two new behaviors:
- Center resizing keeps the center fixed and scales the node in all directions. It is active when the
NodeReshapeHandleProvider#CenterReshapeRecognizer
is triggered which defaults to theAlt
key held down. - Aspect ratio resizing maintains the aspect ratio of a node. It is active when the
NodeReshapeHandleProvider#RatioReshapeRecognizer
is triggered which defaults theShift
key held down. - The
NodeReshapeHandleProvider#ReshapePolicy
property determines how the mouse location is interpreted when aspect ratio resizing is active.
The
ReshapeHandleProviderDemo
showcases these different resizing behaviors. - Center resizing keeps the center fixed and scales the node in all directions. It is active when the
- Graph Builder
-
The new
GraphBuilder
,TreeBuilder
,AdjacencyGraphBuilder
have been added. These new classes facilitate building graphs from arbitrary data:GraphBuilder
can be used when the data consists of one or more collections of nodes, edges, and optionally, groups.TreeBuilder
can be used when the data consists of one or more collections of nodes, each of which knows its child nodes, and optionally, groups.AdjacencyGraphBuilder
can be used when the data consists of one or more collections of nodes, each of which knows its neighbors, and optionally, groups.
New Features
Graph
-
The new
NodeLabelModelStripeLabelModelAdapter
class allows using node label model parameters for the positioning of the row and column labels of a table.
Algorithms
-
New methods of the
GraphChecker
andGroups
classes compute several additional network statistics, namelyGraphChecker#getAverageDegree
,GraphChecker#getAverageWeightedDegree
,GraphChecker#getDiameter
,GraphChecker#getDensity
, andGroups#getModularity
. -
The new
NodeAggregation
class provides an algorithm that intelligently aggregates nodes of (large) input graphs. It does not require complex configuration and can be used without knowledge of specific clustering or aggregation techniques. -
The new
Transitivity#TransitiveEdges
method creates the transitive edges that connect the visible nodes in an input graph. -
The new
GraphConnectivity#kCore
overloaded methods compute the so-called k-cores of an undirected input graph. -
The new
Centrality#eigenvectorCentrality
method computes the eigenvector centrality for each node in an undirected graph. -
The new
Centrality#pageRank
method provides an implementation of the page rank algorithm that computes a rank for each node. -
The new
Groups#labelPropagation
method implements the label propagation algorithm which detects communities in the input graph. -
The new
Groups#louvainModularity
method detects the communities of an input graph by applying the well-known Louvain method for community detection. -
The new
Groups#getClusteringCoefficient
method computes the local clustering coefficient for each node as well as the average clustering coefficient. -
The new
Substructures
class offers methods to detect the following graph structures: Chains, Cliques, Cycles, Stars, and Trees.
Layout
-
The new routing style
EdgeRoutingStyle#CURVED
of theHierarchicLayout
class results in edge paths that consist of smooth curves that are constructed using cubic bezier splines. -
The new property
EdgeLayoutDescriptor#RoutingStyle
allows specifying the routing style individually for each edge routed by theEdgeRouter
class. Furthermore, the new propertiesMaximumOctilinearSegmentRatio
andPreferredOctilinearSegmentLength
on the descriptor provide means to configure the octilinear routing style. -
The
EdgeRouter
class now supports a new routing style that generates curved edge paths. It can be specified for each edge individually using theEdgeRoutingStyle#CURVED
enum value. -
The new layout stage
CurveRoutingStage
replaces polyline edge paths with curved segments using cubic bezier splines and provides a generic way to produce layouts with curved edges. -
The
CircularLayout
class now supports exterior edges that are routed around the exterior of the circle as smooth arcs. This can be specified with the newCircularLayout#EdgeRoutingPolicy
property. -
The new
EdgeBundlingStage
class offers edge bundling for general undirected graphs. Bundling together multiple edges means that their common parts are to some degree merged into a bundled part. Edge bundling is useful to increase the readability of graph drawings with a high number of edges that connect a comparably small number of nodes. -
The
RadialLayout
class now supports a user-defined layer/circle assignment strategy. This can be specified with theLayeringStrategy#USER_DEFINED
enum value and the layout data propertyRadialLayoutData#LayerIds
.
Improvements
-
IListEnumerable#create
can now be called with any Iterable instead of only with Lists. -
The license mechanism now only logs license messages when no valid license has been found.
Previously it was also logged to
System#err
that a license is valid. -
Added property
LicensePath
to classLicenseConfig
to support license files in places other than the classpath root.
Graph
-
The
ITable#addLabel
method no longer accepts label model parameters that do not supportIStripe
instances. Previously node label models could be used, but did not work properly at runtime. -
The default method
getPathPoints
was added for theIEdge
interface. The returnedIListEnumerable
contains a snapshot of the source port location, followed by the bend locations, followed by the target port location of an edge. -
The
FilteredGraphWrapper
class now has a new overload without the edge predicate, which often just returnstrue
anyway. -
GraphMLIOHandler
has been improved to prevent external entity injection attacks by default. To prevent these attacks,GraphMLIOHandler
disallowsDTD
declarations in readXML
documents. -
Added new method
setDisposeCallback
to classesAbstractJComponentLabelStyle
,AbstractJComponentNodeStyle
,AbstractJComponentPortStyle
, andAbstractJComponentStripeStyle
. This method enables client code to register a callback for freeing resources that have been allocated in methodcreateComponent
once the created component is no longer used.
View
-
The
CanvasComponent#updateContentRect
method now throws anIllegalStateException
if an element on the canvas provided invalid bounds, e.g. one with infinite values. -
The
CanvasComponent#fitContent
method now respects theLimitedFitContentZoom
property if aViewportLimiter
is enabled. -
A new policy has been added to the
ViewportLimiter
class which allows for zooming and panning towards the limits but not away from them. This prevents the viewport from "jumping" from out-of-limit coordinates into the limited bounds. -
The methods
raise
,lower
,toFront
andtoBack
on classGraphModelManager
are not final anymore, thus, can now be overridden. -
The new
GraphModelManager#ProvideUserObjectOnMainCanvasObject
property can be set so that a model is accessible as its main canvas object's user object. -
The classes
DefaultFolderNodeConverter
andAbstractFoldingEdgeConverter
provide a new protected methodcreatePreferredLabelSize
to allow for overriding the default implementations. -
The classes
NodeStyleLabelStyleAdapter
,NodeStylePortStyleAdapter
, andNodeStyleStripeStyleAdapter
now propagate the tags of labels, ports, and stripes to the node that's rendered with the node style. -
The
GridVisualCreator
class can now draw only horizontal lines or only vertical lines when itsGridStyle
property is set to one of the new enum valuesGridStyle#HORIZONTAL_LINES
orGridStyle#VERTICAL_LINES
. -
The property
GridVisualCreator#GridRenderPolicy
has been added and can be used to switch between a high-quality and a fast-performing rendering. -
OverviewInputMode
now has a protected methodupdateVisibleArea
which is the callback that fits the client canvas' content rectangle into the overview again after it has changed. -
An
Animation
can now be paused and unpaused by setting thePaused
property on theAnimator
class after the animation has started.
Projections Feature
-
The image export and printing classes (
ContextConfigurator
,PixelImageExporter
,XpsExporter
,CanvasPrintDocument
,CanvasComponent#Print
) have been improved to work better with the new Projections feature by being able to define an arbitrary list of points as well as the projection that should be used for export/printing. The export chooses the exported area in a way that all these points are enclosed in a rectangular area which is axis-parallel to the output coordinates under the given projection. -
The property
CanvasPrintable#PrintPoints
was added and contains the points in world coordinates which determine the region to print. The propertyPrintRectangle
that was previously used to determine the world bounds to print now delegates toPrintPoints
. -
The
CanvasComponent
class has additional methods to convert between the world, the new intermediate, and the view coordinate system. -
The
MarqueeSelectionInputMode
,NavigationInputMode
, andHandleInputMode
classes now have a propertyUseViewCoordinates
, which controls whether the input mode draws its decorations and processes input in view coordinates. -
When the
MarqueeSelectionInputMode
class uses view coordinates, the resulting shape of the marquee in world coordinates may not be a rectangle. Therefore theMarqueeSelectionEventArgs
class now has aPath
property of typeGeneralPath
to describe the marquee shape and aUsePath
property that determines whether thePath
property or theRectangle
property shall be used. -
MarqueeSelectionInputMode
now has a propertySelectionPath
that returns aGeneralPath
representing the current or last selection rectangle in world coordinates. This is necessary for projections where the marquee selection rectangle is not a rectangle in world coordinates. -
The
EdgeDecorationInstaller
,RectangleIndicatorInstaller
,PointSelectionIndicatorInstaller
, andDefaultPortCandidateDescriptor
classes now have a propertyUseViewCoordinates
that controls whether the decoration is rendered in view coordinates. -
The
CreateEdgeInputMode#measureDistance
method now has to return the distance in view coordinates if and only ifCanvasComponent
'sProjection
is used. -
The
IRenderContext
interface now has the following additional members that are useful with the new projections feature:getProjection
,getToIntermediateTransform
,worldToIntermediateCoordinates
, andintermediateToViewCoordinates
.
Input
-
It is now easier to customize the
GroupingNodePositionHandler
class. The boolean propertiesAdjustingParentNodeLayoutEnabled
,MovingChildNodesEnabled
andReparentingEnabled
have been added to control whether an ancestors' node layout should be adjusted when a node is moved, to not move the contents of a group node when a group node is moved or forbid any interactive reparenting. -
The
GraphEditorInputMode#requeryHandles
method has been made public and can now be used to refresh the displayed handles, ifIHandleProvider
implementations return different handles over time. -
The
GraphClipboard
andGraphEditorInputMode
classes now provide the newElementsDuplicated
event that occurs when a duplicate operation finished successfully. -
The
undo
andredo
methods of theUndoEngine
class now throw anIllegalStateException
if the current state does not allow performingundo
orredo
. Previously eitherUnsupportedOperationException
orRuntimeException
have been thrown. - The default position handler for edges now creates fewer additional bends when the edge is dragged while orthogonal edge editing is enabled.
-
A
MaximumBoundingArea
can now be set on the classesAbstractReshapeHandleProvider
,ReshapeHandlerHandle
,RectangleHandle
, andReshapeRectangleContext
to restrict reshaping to stay inside the given bounds. -
The
ReshapeHandlerHandle
class has new getters for theIReshapeHandler
and theHandlePositions
. -
The new
NodeDecorator#ReshapeHandlerDecorator
property simplifies using customIReshapeHandler
implementations for nodes. -
The new
ReshapeRectangleContext#Ratio
property specifies the width/height ratio that is kept for aspect ratio resizing. -
The new classes
NodeReshapeHandleProvider
andNodeReshapeHandlerHandle
are used as default implementation for node resize handles. -
With the new
ReshapeRectangleContext#ReshapePolicy
property,INodeReshapeSnapResultProvider
implementations can respect the node aspect ratio for according resize gestures. -
The new
NavigationInputMode#fitContent
method is called after collapse, expand, enter, and exit operations if theFitContentAfterGroupActions
property is enabled. -
The
NavigationInputMode
class doesn't fit the content anymore after expand and collapse operations if anAutoGroupNodeAlignmentPolicy
other thenNONE
is used. -
An optional parameter
preferredSnapType
has been added to theSnapLineSnapResult
constructor and theSnapResults#createSnapLineSnapResult
factory method. -
The new factory method
OrthogonalEdgeEditingContext#createOrthogonalEdgeDragHandler
can be used for custom node position handler and reshape handler to keep orthogonal edges attached to a node orthogonal during the drag/reshape gesture. -
The properties
GridSnapDistance
andGridSnapType
of theGraphSnapContext
class have been pulled up to theSnapContext
class. -
The zoom-invariant
GridSnapDistance
property has been added to theCollectSnapResultsEventArgs
class. -
The
SnapResults#createResizeSnapResult
method now takes aPointD
as delta parameter instead of a double so it is possible to create resize snap results where the orientation of the mouse delta differs from the orientation of the snapped size. -
Class
ResizeStripeInputMode
now has anIsDragging
property, indicating whether a drag currently is in progress. -
Class
DropInputMode
now has anIsDragging
property, indicating whether a drag on the canvas currently is in progress. -
Class
HandleInputMode
now has anIsDragging
property, indicating whether a drag currently is in progress. -
The
CompositeLabelModel
class now supports label snapping. -
The default data flavor for
LabelDropInputMode
,NodeDropInputMode
,PortDropInputMode
, andStripeDropInputMode
now uses the class loader associated toILabel
,INode
,IPort
, andIStripe
respectively instead of the system class loader. -
The new
ClickListenerDecorator
property of Bend-, Edge-, Label-, Node- andPortDecorator
simplifies using customIClickListener
implementations.
Geometry
-
The new method
PointD#interpolate
calculates the linear interpolation between two points. -
GeneralPath
has a few new helper methods, mostly related to cubic Bézier curves:findCurveIntersection
finds the intersection between a cubic Bézier curve and the path.getCubicSplitPoints
determines new control points for splitting a cubic Bézier curve.getProjection
calculates the projection of a point onto a specific segment of the path.
Analysis
-
Most of the algorithms in namespace
Analysis
provide propertiesSubgraphNodes
andSubgraphEdges
which facilitate to analyze only a subset of the given graph. -
The
GraphStructureAnalyzer
class has now methods to determine whether there are multiple edges between the same pair of nodes. -
The
GraphCentrality
andClosenessCentrality
analysis algorithms now calculate the centrality individually per component instead of returning a centrality value of 0.0 for nodes in graphs that are not connected. -
In a single node graph, the single node's closeness centrality and graph centrality value is now
1.0. (Previously, it was infinity.) This also affects derived values such as minimum, maximum, and normalized
centrality. The backing algorithms in the
Centrality
class are unchanged. -
When
EdgeBetweennessClustering
andFeedbackEdgeSet
are executed, the specified edge weights are checked and in case they are not positive or finite, anIllegalStateException
is thrown.
Layout
- Frequently used types of the layout part have now nullability annotations.
-
The
DefaultPortAllocator
class has a new propertyConsiderFixedPorts
that allows to specify whether edges with strong port constraints or fixed port candidates should be considered during the port assignment. Previously, such edges were ignored which could lead to intersections with the ports of the other edges. This new feature is enabled by default. -
The
EdgeRouter
class now provides an improved support for early exits. The routing algorithm now often reacts more sensibly to the case that the specifiedMaximumDuration
is reached. -
If the
EdgeRouter
algorithm runs with highly restricted time (seeEdgeRouter#MaximumDuration
) or when it gets stopped by means ofAbortHandler
, it now keeps the minimum edge to edge distance better. -
The
PartialLayout
class now produces more stable results if it is multiple times applied to the same input graph and propertySubgraphPlacement
is set toSubgraphPlacement#FROM_SKETCH
. -
The
HideGroupStage
class now offers a new propertyResetEdgePaths
that allows to specify whether or not the stage resets the path of edges incident to group nodes. -
The
ComponentLayout
class now correctly considers node and edge labels when using the packed layout styles, e.g.,ComponentArrangementStyles#PACKED_RECTANGLE
orComponentArrangementStyles#PackedCircle
. Previously, labels could overlap other elements when using these component arrangement styles. -
Constructor overloads have been added to classes
SingleItem
,ItemCollection
,ItemMapping
, andContextItemMapping
that initialize one of their properties on construction. -
The
LayoutExecutor
class now generates more specific port constraints with theFixPorts
property enabled, resulting in better edge paths. -
If the
Mapper
property of classHierarchicLayoutData#EdgeDirectedness
is directly accessed (not explicitly set) its default for unset values is 1.0 (directed edge). -
If the
Mapper
property of classOrganicLayoutData#GroupNodeModes
is directly accessed (not explicitly set) its default for unset values isGroupNodeMode#NORMAL
. This doesn't change the result of the layout. -
For the
RootPlacements
,SubtreeRoutingPolicies
, andSubtreeAspectRatio
properties of theAspectRatioTreeLayoutData
class, the type of the mapped values has been made nullable. Fornull
or unset values, the settings on theAspectRatioTreeLayout
will now be taken. -
Relaxed the strict type requirements for
IncrementalHintItemMapping
'ssetIncrementalSequencingItems(Iterable)
overload to accept specificIModelItem
sub-types as well. -
Relaxed the strict type requirements for
LayoutData
setter overloads that take mappings of one kind or the other to accept sub-types of the required value type. This also applies toLayoutExecutor#setPortLabelPolicies
andLayoutGraphAdapter#setPortLabelPolicies
.
Bugfixes
View
- Layout animations for graphs with ports that are owned by edges no longer throw an exception.
-
An animation created with the
Animations#createGraphAnimation
method no longer throws an exception if the providedIMapper
with new bend locations doesn't provide bend locations for all edges. -
The
ViewportAnimation
no longer throws an Exception when applied on a zero-sizeGraphComponent
. -
Fixed a bug which caused the
ZOOM_TO_CURRENT_ITEM
command to ignore theViewportLimiter
of the correspondingCanvasComponent
. -
The
CanvasComponent#zoomTo
method no longer triggers twoViewportChanged
events. - Scrolling the viewport with the mouse wheel no longer scrolls in the wrong direction if the mouse wheel is set to scroll one page at a time (instead of several lines).
-
The
GraphModelManager#getMainCanvasObject
method no longer throws aNullPointerException
when overriding itsgetCanvasObject
methods for items in an unexpected way. -
Due to better
null
checks, several styles and input modes no longer throw an exception in the rare case that anIRenderContext
doesn't provide aCanvasComponent
instance. -
Fixed a bug in
FoldingManager
where a predicate change in aFilteredGraphWrapper
which serves asMasterGraph
could trigger an Exception if a child of a folder node has been hidden. -
The methods
ICanvasObject#above
andbelow
don't unnecessarily triggerIRenderContext#ChildVisual
anymore. -
Callbacks registered via
IRenderContext#setDisposeCallback
are now always called when the visual was disposed. Previously there have been some cases, such as creating visuals outside of rendering (e.g. for measuring), where the callback would never be called. - Edges between deeper nested nodes are now displayed correctly in front of a common ancestor after that ancestor has been added or removed.
-
Fixed a bug in the
GraphCopier
class which caused theLabelCopied
event to be dispatched twice for port labels on folder nodes. - Fixed a bug in the visualization of the snapping of resized nodes. Due to the bug the arrows indicating that the width or height of the node equals the width or height of other nodes were only rendered at the resized node but not at the other nodes with same width or height.
-
The file chooser dialogs shown from
GraphComponent
'sopenFile
andsaveFileAs
methods now respect the filter values specified forCanvasResources
'GraphComponent#OpenFileDialog#Filter
andGraphComponent#SaveFileDialog#Filter
resource keys.
Input
-
Calling the
GraphInputMode#findItems
andGraphInputMode#HitTester#enumerateHits
methods with a customIInputModeContext
will now always pass that context to theIHitTestable
implementations of the items being hit-tested. Previously, the main input mode's ownIInputModeContext
was used in certain cases. -
The paste and duplicate operations now honor the
GraphEditorInputMode#shouldSelect
predicate. -
The
NodeDropInputMode
class now correctly considers port labels, both for creating the new node and for the preview. -
The
ICommand#SET_CURRENT_ITEM
command can now also be used to “reset” the current item tonull
by passingnull
as the command parameter. This also fixes that theNavigationInputMode#SetCurrentItem
andGraphInputMode#SetCurrentItem
methods did nothing whennull
was passed as an argument. -
The
TextEditorInputMode
class now correctly queries theViewportLimiter
ifTextBoxPlacementPolicy#SCROLL_CANVAS
is used. If the text box is still not visible because it's outside the limited viewport, the text box will be moved as well. - Undo and redo of additions and removals of bends on folding edges now correctly restores the bends at the location they had at the time of removal.
-
The
NavigationInputMode#FitContentAfterGroupActions
property is no longer ignored when theNavigationInputMode
class is used as a child input mode of theGraphEditorInputMode
class. -
The
NavigationInputMode
class now also updates theCanvasComponent#ContentRect
property when it is not used as a child input mode of theGraphEditorInputMode
class. -
The
SnapContext#GridSnapDistance
andSnapContext#SnapDistance
properties are no longer incorrectly interpreted in world coordinates when calculatingSnapResults
. -
MouseWheelEventArgs
are now set toHandled = true
whenCanvasComponent
scrolls or zooms to avoid those events from bubbling to parent controls. - Orthogonal edge editing does not add bends anymore to edges that are marked as not orthogonal.
- Input modes are no longer left in an undefined state if another input mode has been activated in an event handler of the first input mode. This usually resulted in the wrong cursor being displayed.
Geometry
-
Fixed the
MaxX
andMaxY
properties ofRectD#INFINITE
which now returnDouble#POSITIVE_INIFINITY
instead ofNaN
. In turn,RectD#INFINITE
'sTopRight
,BottomRight
, andBottomLeft
corners were fixed, too.
Analysis
-
The
EdgeBetweennessClustering#run
method no longer throws an exception with its default setting for theMaximumClusterCount
property. -
The Manhattan distance metric for
HierarchicalClustering
no longer ignores the vertical distance component. -
The
HierarchicalClustering
class no longer throws an exception when applied to an empty graph. -
The results of the
Chains
class are now correct for undirected cycles, too. If such cycles are not connected to other parts of the graph, theNodes
collection of a resultingPath
could have been in an incorrect order. -
The
ClosenessCentrality
class no longer calculatesNaN
as result of theNormalizedNodeCentrality
property if the graph consists of one single node. Instead, the value of theNormalizedNodeCentrality
property is now positive infinity. -
The
ClosenessCentrality#run
method no longer throws an exception for unconnected graphs. Instead, all values of theNodeCentrality
andNormalizedNodeCentrality
properties will be0.0
as the documentation states. -
A number of spurious
NullPointerException
s in various graph analysis algorithms do no longer happen when configuring them with aMapper
that doesn't have an explicit value for every node/edge in the graph.
Layout
-
The
morphLayout
andLayoutExecutor#start
methods no longer throw an exception when applied on a zero-sizeGraphComponent
. -
Fixed a bug in
ItemCollectionMapping
that could result in aNullPointerException
for addedItemCollections
where no items were specified. -
The
HierarchicLayout
class now correctly handles inputs that have both bus structures and edges with recursive style. Previously, an exception could be triggered when an edge was marked as recursive and belonged to a bus at the same time. -
The
HierarchicLayout
class no longer throws an exception that was previously triggered in some cases with bus structures (see propertyHierarchicLayoutData#Buses
) and in conjunction with layering constraints. -
Fixed a bug in the
HierarchicLayout
class that in some cases caused a violation of the minimum first or last segment length (EdgeLayoutDescriptor#MinimumFirstSegmentLength
andEdgeLayoutDescriptor#MinimumLastSegmentLength
). The bug was only triggered when the minimum length values were relatively large. -
The
OrganicLayout
class no longer throws an exception when having aPartitionGrid
and at the same time the scope set toSUBSET
orMAINLY_SUBSET
where all nodes of the graph are marked as affected (could have used scopeALL
instead). -
The
EdgeRouter
class no longer produces unnecessary overlaps for cases where the source or target node is overlapped by (several) label elements. This generally improves the ability of the router to deal with input that contains source/target nodes that are overlapped by other elements and are required to be crossed by an edge route. -
The
EdgeRouter
class no longer throws an exception whenEdgeLayoutDescriptor#IntermediateRoutingPoints
are too close together. -
The
EdgeRouter
class no longer has a problem that appeared with a bus containing affected as well as non-affected (fixed) edges at the same time. Previously, this could trigger an exception or lead to the incorrect behavior that an actually affected other edge was not routed. -
The
EdgeRouter
class no longer occasionally throws an exception if the input contains bus edges defined viaBusDescriptor
. -
The
EdgeRouter
class no longer has a problem that occasionally resulted in bad edge routing artifacts if edge grouping is enabled and non-affected edges are grouped at both end points. -
The
EdgeRouter
class no longer yields edge labels that overlap with unrelated group nodes when using the integrated label placement feature. -
Resolved a bug in the
EdgeRouter
class which caused that grouped edges were sometimes actually not grouped together. This mainly appeared in conjunction with a large value of either the minimum first or last segment length. -
The
EdgeRouter
class no longer produces an exception for some rare cases with fixed grouped edges and octilinear paths. -
The
EdgeRouter
class now correctly observes inputs where the user specifies buses with both fixed and non-fixed edges at the same time. -
The
EdgeRouter
class now properly considers ports provided by aPortCandidateSet
when the set contains multiple candidates with single capacities and where the candidates are on the same node side. Previously, it could happen that only one of several edges connecting to the node correctly considered the ports. -
The
EdgeRouter
class does no longer use the same fixedPortCandidate
out of a specifiedPortCandidateSet
if another non-saturated candidate can be chosen. Thus, overlapping edge segments are avoided. -
The
EdgeRouter
class no longer occasionally throws an exception if the input contains bus edges (defined viaBusDescriptor
). -
The
BusRouter
class no longer fails to generate connected buses for cases with fixed and incremental edges on the same bus. Previously it sometimes generated a disjoint bus even though the bus IDs were equal. -
The
BusRouter
class no longer ignores edges that should be routed when a they are on a bus with fixed edges (seeBusDescriptor#Fixed
property) and when they share both source and target port with a fixed edge. -
The element processing order in the
BendConverter
layout stage is now deterministic. The previous non-deterministic order of inserting and removing elements could lead to non-deterministic behavior for consecutive layout calculations. -
The
ParallelEdgeRouter
class no longer throws an exception if the input has both a large number of parallel edges and a leading edge with ports on the node border. -
The
OrthogonalLayout
class now correctly handles input graphs with parallel edges if thePreferParallelRoutes
property is enabled. Previously, such inputs have caused exceptions in some rare cases. -
The
FamilyTreeLayout
class now properly handles the case that the family tree contains cycles, e.g., due to a family founded by parent and (step-)child. Previously, it sometimes produced a stack overflow or non-orthogonal routes for such an input. -
The
AspectRatioTreeLayout
class no longer crashes, causing a stack overflow, when applied to a large chain graph. -
The
AbstractNodePlacer#placeSubtree
method now clears its internal caches, especially the graph cached in fieldAbstractNodePlacer#graph
. Previously, holding onto a node placer instance could lead to subtle memory leaks. -
The
OrthogonalSegmentDistributionStage
no longer produces degenerated (very large or small) coordinates for edges that contain zero-length segments, that is, duplicate edge path points. -
The
ChannelEdgeRouter
class no longer yields degenerated routing results (very large or small coordinates) when using theOrthogonalPatternEdgeRouter
as path finder strategy and setting its minimum distance to zero. TheOrthogonalPatternEdgeRouter
class now avoids duplicate points when theMinimumDistance
property is set to zero. -
The
RecursiveGroupLayout
class now correctly moves child nodes along with their group also in case theRecursiveGroupLayout#CoreLayout
isnull
. Previously, if additionally a group node had a specific layout algorithm associated to it, the content was not correctly moved along. If the core layout was notnull
, the issue did not occur.
Incompatible Changes
API
-
The
GraphBuilder
,TreeBuilder
, andAdjacentNodesGraphBuilder
in thecom.yworks.yfiles.graph
package have been replaced with incompatible, new implementations in thecom.yworks.yfiles.graph.builder
package. API-compatible adapters to the old API can be found in thebuilder.compatibility
demo. -
The return type of
ContextConfigurator
'screateClip
method has been changed fromRectD
toShape
. The return value of this method is intended to be passed toGraphics2D#clip(Shape)
to constrain the painting area. -
The method
CanvasComponent#createInputModeContext
is protected again, after having been made public accidentally previously. -
The
GraphEditorInputMode#requeryHandles
method is now public. -
The optional
IPortLocationModelParameter
andIPortStyle
parameters of theIGraph#addPort
andGraphExtensions#addPort
methods can now benull
. -
The
ModelManager#unInstall
method has been renamed to the canonical nameuninstall
. -
The
NodeReshapeSnapResultProvider#getSnapLines
method now takesCollectSnapResultsEventArgs
as additional parameter. -
Several methods related to snapping now take a
PointD
instead of adouble
asdelta
parameter. In detail, these areSnapResults#createResizeSnapResult
,NodeReshapeSnapResultProvider#addSnaplineSnapResult
,NodeReshapeSnapResultProvider#addGridLineSnapResult
, andNodeReshapeSnapResultProvider#addSameSizeSnapResult
. -
The following methods now require an
IRenderContext
instance as first parameter:AbstractLabelStyle#createLayoutTransform
andJComponentLabelStyleRenderer#createLayoutTransform
. -
All overloads of
YGraphAdapter#createMapper
now require an additional parameter specifying theClass
of the type argument. This is required for correct fallback values if an item is not explicitly mapped. -
CanvasPrintable#getWorldBounds
now returns an Iterable ofPointD
instead of aRectD
to suit the new projection feature. -
IGraph
methodsgetBends
,getEdgeLabels
,getNodeLabels
, andgetPortLabels
have been changed to return a "live" view of corresponding objects in the graph. Previously, these methods returned a cached view. This change necessitated changing the return type of these methods fromIListEnumerable
toIEnumerable
. -
The
HierarchicalClustering#Result#DendrogramRoot
property can now returnnull
if the result has been obtained from an empty graph.
Behavior
- The view coordinate system now includes the projection. For customers who do not use a projection, nothing will change. However, when the (old) view coordinate system has been used to render parts of the visualization in a zoom-invariant manner, the equivalent now is called the intermediate coordinate system. The view coordinate system is still necessary when coordinates relative to the control are needed, e.g. for tooltips or a context menu.
-
When using the new projections feature, the
CanvasComponent#ContentRect
property no longer has an effect on scrollbars or theGraphComponent#fitGraphBounds
method. -
The
CanvasComponent
class ignores itsViewportLimiter
when projections are used. -
The
ViewportLimiter
no longer jumps to the limited viewports if the current viewport is outside the limited area. This behavior can be restored by setting theViewportLimiter#LimitingPolicy
property toLimitingPolicy#STRICT
. - Visuals that are rendered in view coordinates relative to the viewport may appear in a different location when exporting an image.
-
The
NavigationInputMode#adjustContentRect
method doesn't fit the graph bounds in the viewport anymore. -
NavigationInputMode#FittingContentAfterGroupActionsEnabled
now isfalse
by default. -
The
NavigationInputMode
class doesn't fit the content after expand and collapse operations anymore. This can be re-enabled by setting theAutoGroupNodeAlignmentPolicy
to a value other thanNONE
andFittingContentAfterGroupActionsEnabled
totrue
. -
For the
RootPlacements
,SubtreeRoutingPolicies
, andSubtreeAspectRatio
properties of theAspectRatioTreeLayoutData
class, the type of the mapped values has been made nullable. Fornull
or unset values, the settings on theAspectRatioTreeLayout
will now be taken. This is the documented behavior, though. -
GraphMLIOHandler
has been improved to prevent external entity injection attacks by default. To prevent these attacks,GraphMLIOHandler
disallowsDTD
declarations in readXML
documents. -
Added file filters for
XML
files and all files to the file chooser dialogs shown fromGraphComponent
'sopenFile
andsaveFileAs
methods. -
IGraph
methodsgetBends
,getEdgeLabels
,getNodeLabels
, andgetPortLabels
have been changed to return a "live" view of corresponding objects in the graph. Previously, these methods returned a cached view. This change necessitated changing the return type of these methods fromIListEnumerable
toIEnumerable
. -
The following places now throw a
ConcurrentModificationException
instead of anIllegalStateException
:IGraph
: changing graph items while iterating those using theIListEnumerable
returned byIGraph#getNodes
orIGraph#getEdges
.IGraph
: changing the bends, labels, or ports at an edge while iterating those using theIListEnumerable
returned by the respectivegetBends
,getLabels
, orgetPorts
method.IGraph
: changing the labels or ports at a node while iterating those items using theIListEnumerable
returned by the respectivegetLabels
orgetPorts
method.IGraph
: changing nodes while iterating those using theIListEnumerable
returned byIGraph#getChildren
.
-
The
GraphCentrality
andClosenessCentrality
analysis algorithms now calculate the centrality individually per component instead of returning a centrality value of 0.0 for nodes in graphs that are not connected. -
HierarchicLayoutData#EdgeDirectedness
: If theMapper
property is directly accessed (not explicitly set), its default for unset values is now 1.0 instead of 0.0. These means that such edges are now treated as directed instead of undirected. -
The value of the read-only property
EdgeRouter#Partition
is nownull
after applying the routing algorithm. It is only intended to be used during the execution. Previously, it was cached, even though the documentation stated otherwise.
Deprecations
-
The properties
EdgeRouter#PolylineRouting
,EdgeRouter#PreferredPolylineSegmentLength
andEdgeRouter#MaximumPolylineSegmentRatio
are now deprecated. To enable polyline routing, specifyEdgeRoutingStyle#OCTILINEAR
as routing style viaEdgeLayoutDescriptor#RoutingStyle
. The other two properties are also replaced by respective properties on theEdgeLayoutDescriptor
class.
New Demos
-
The
GanttChartDemo
shows how to create a project schedule visualization. -
The
ZoomInvariantLabelStyleDemo
demonstrates zoom-invariant label rendering. -
The
MarqueeClearAreaLayoutDemo
shows how to make space in a diagram by dragging a marquee rectangle. -
The
FillAreaAfterDeletionDemo
shows how to fill free space after deleting nodes using theFillAreaLayout
algorithm.
Demo Improvements
-
The
IsometricDrawingDemo
has been reworked to use the new projections functionality (see also the Major New Features section). -
The
LayoutStyles
demo has been enhanced to include new layout features:- Exterior edge routing for
CircularLayout
. - Curved edge routing style for
HierarchicLayout
and PolylineEdgeRouter
. - Bus routing for
HierarchicLayout
and PolylineEdgeRouter
. - Integrated Edge Labeling for Polyline
EdgeRouter
.
- Exterior edge routing for
-
Improved support for parsing the
BPMN
Diagram Interchanged format. -
The
BPMN
node styles now support setting colors. -
The
BPMN
demo has been improved to provide more flexibility. Its code now can easier be used in custom projects. -
BpmnDiParser
has been improved to prevent external entity injection attacks by default. To prevent these attacks,BpmnDiParser
disallowsDTD
declarations in readXML
documents.
yFiles for Java (Swing) 3.3.0.1
Bugfixes
-
IFoldingView#Collapse
and#Expand
now throw anIllegalArgumentException
when called with a node not belonging to the graph (instead of aNullPointerException
). -
CollapsibleNodeStyleDecorator
: When the wrapped style has its ownIClickListener
defined in its lookup, theIClickListener
for the collapse/expand button has precedence but the other one is used when the button is not hit. -
FoldingManager#hasFoldingEdgeState
now returnsfalse
for non-dummy edges instead of throwing an exception. -
FilteredGraphWrapper
: Fixed a possibleIllegalArgumentException
("Node not in this graph") which could occur when the parent of a node which is not visible in the filtered graph has been changed in the wrapped graph. -
FoldingManager#getFoldingEdgeState
now throws anIllegalArgumentException
with a meaningful message instead of aNullPointerException
if the state is queried for a master edge (both source and target node are expanded). -
Fixed a bug in
TableLayoutConfigurator
which in rare cases could cause exceptions in additional layout stages. -
ILabelCandidateDescriptor
's#getProfit
now is considered properly by the labeling algorithms. -
FoldingManager
: Invoking#hasFoldingEdgeState
for a master edge (both source and target are expanded) yields now anIllegalArgumentException
with an explaining message text instead of throwing a simpleNullPointerException
. -
Fixed an issue where
NavigationInputMode
's#AutoGroupNodeAlignmentPolicy
would sometimes not work when the expanded and collapsed group node sizes differ. -
The
FilteredGraphWrapper
class now correctly handles port labels of filtered items. -
The
GeneralPath#prepend
method no longer loses a part of the combined path in certain circumstances. -
GraphMLIOHandler
: Fixed an error that prevented parsingnull
values by input handlers added via#createMapperInputHandler
.
Layout
-
Fixed a bug in the
HierarchicLayout
class that could cause unnecessary (double) edge crossings when the algorithm was executed in incremental layout mode with edge grouping and alternative group bounds. -
The
EdgeRouter
class now correctly observes fixed ports for some cases where it previously ignored them due to incorrect path cost calculations. -
The
EdgeRouter
class now considers the correct shape of non-affected, fixed edges. Previously, it sometimes incorrectly parsed their shape which could lead to undesired effects like incorrect path cost calculation of affected edges. -
The
BalloonLayout
class now longer crashes due to a stack overflow for inputs containing very long chain graphs. -
The
HierarchicLayout
class now produces better results for input graphs with grouped edges and aPartitionGrid
. Previously, such inputs may have produced edge routes with superfluous bends. -
The
HierarchicLayout
class now correctly considers the propertiesMaximumNodesAfterBus
andMaximumNodesBeforeBus
of theBusDescriptor
for single line (layer) buses. In addition, for multiple layer buses, the specified minimum node to edge distance is now considered for the distance between nodes and the vertical bus segment. -
The
OrganicLayout
class now correctly removes node overlaps if itsScope
is set to
and itsNodeOverlapsAllowed
property is disabled. Previously, the layout sometimes produced superfluous overlaps for such cases. -
The
TreeMapLayout
class no longer produces results that may have infinite coordinates. -
The
HierarchicLayout
class no longer throws an exception that was previously triggered in some cases with bus structures (see propertyHierarchicLayoutData#Buses
) and in conjunction with undirected edges (seeHierarchicLayoutData#EdgeDirectedness
). -
The constants
EdgeLabelLayoutDpKey
andNodeLabelLayoutDpKey
of theLabelLayoutKeys
class now specify correctly that their generic type parameter isLabelLayoutData
[] and not justLabelLayoutData
.
Input
-
Fixed that
NavigationInputMode
ignores the#shouldSelectItem
and#shouldFocus
predicate methods ofGraphEditorInputMode
andGraphViewerInputMode
. -
Fixed a bug that executed commands on keypress although the
KeyboardInputMode
is not enabled.
Incompatible Changes
-
FoldingManager#getFoldingEdgeState
now throws anIllegalArgumentException
instead of aNullPointerException
if the state is queried for a master edge (both source and target node are expanded). -
FoldingManager#hasFoldingEdgeState
now throws anIllegalArgumentException
instead of aNullPointerException
if the state is queried for a master edge (both source and target node are expanded). -
FoldingManager#hasFoldingEdgeState
now returnsfalse
for non-dummy edges instead of throwing an exception.
Demos and Tutorials
The Getting Started
and Custom Styles
tutorial
trails have been moved into the demos
directory to simplify
project setup for yFiles for Java (Swing)'s programming samples in IDEs.
New Demos
-
The
LabelHandlerProviderDemo
shows how to implement custom handles for interactive rotation and resizing of labels. -
The
SplitEdgesDemo
shows how to align edges at group nodes usingRecursiveGroupLayout
together withHierarchicLayout
. -
The
EdgeGroupingDemo
shows the effects of edge and port grouping when arranging graphs withHierachicLayout
. -
The
PartialLayoutDemo
shows how to arrange some elements in a graph while keeping other elements fixed. -
The
CriticalPathsDemo
shows how to emphazise important paths with hierarchic and tree layout algorithms. -
The
CustomLabelModelDemo
shows how to create and use a custom label model. -
The
SmartClickNavigationDemo
shows how to navigate in a large graph, especially when only a part of the graph is visible in the viewport. -
The
ToolTipDemo
shows how to add tooltips to graph items. -
The
GridSnappingDemo
shows how to enable grid snapping during interactive changes. -
The
SnappingDemo
shows how to enable snapping (guide lines) for interactive changes. -
The
LevelOfDetailDemo
shows how to display different levels of detail depending on the current zoom factor. -
The
FamilyTreeDemo
usesFamilyTreeLayout
to arrange genealogical graphs. -
The
TreeMapDemo
usesTreeMapLayout
to arrange file system nodes. -
The
TreeLayoutDemo
shows the tree layout style and the different ways in which this algorithm can arrange a node and its children. -
The
ClickableStyleDecoratorDemo
shows how to handle mouse clicks in specific areas of a node's visualization. -
The
BackgroundImageDemo
shows how to add background visualizations to a graph component. -
The
FilteringAndFoldingDemo
shows how to configure filtering and folding in the same application. -
The
FoldingDemo
shows how to enable collapsing and expanding of group nodes. -
The
FilteringDemo
shows how to temporarily remove nodes or edges from the graph with filtering. -
The
GraphCopyDemo
shows how to copy a graph or part of it to another graph.
yFiles for Java (Swing) 3.3
Major New Features
- A large number of code examples has been added to the API Documentation.
-
The
HierarchicLayout
class is now able to arrange children of a specific root node in a compact bus-like way. These bus substructures are defined by theHierarchicLayoutData#Buses
property, and the newBusDescriptor
class provides more individual settings for the buses. -
The
EdgeRouter
class now features integrated edge label placement. Labels are automatically placed when the new propertyIntegratedEdgeLabelingEnabled
is enabled. The placement considers the optionalPreferredPlacementDescriptor
of a label. -
The
EdgeRouter
class now supports port grouping of edges at their source and target. To specify the port group IDs, see the associated properties in thePolylineEdgeRouterData
class. -
The
EdgeRouter
class now supports orthogonal bus routing. The newBusDescriptor
class specifies the settings for a single bus. - The powerful analysis algorithms got a new API that is based on the
IGraph
interface and streamlines working with the results. In particular, it makes working with a special analysis graph class obsolete. The algorithms that are available with the new API include centrality measures, clustering, flow calculation, rank assignment, spanning tree, shortest path, and more. This is accompanied by the newGraphStructureAnalyzer
class that provides methods to check structural properties of a given graph.
New Features
Layout
-
The
HierarchicLayout
class is now able to consider individual costs for crossing a group node border. These costs are defined with theHierarchicLayoutData#GroupBorderCrossingCosts
property. -
The
HierarchicLayout
class is now able to consider individual crossing costs for edges. They can be defined with theHierarchicLayoutData#EdgeCrossingCosts
property. -
The new callback method
DefaultLayerSequencer#getCrossingCost
allows for defining an individual crossing cost value for a specific pair of edges when using the said sequencer implementation for theHierarchicLayout
algorithm. -
In order to easily retrieve the original edge instance when customizing the hierarchic layout
algorithm, the
HierarchicLayout#getOriginalEdge
method was added. -
The
HierarchicLayout
class is now able to uniformly distribute ports at group nodes - with a few restrictions. The new propertyHierarchicLayoutData#UniformPortAssignmentGroups
. defines the groups for which the feature should be enabled. -
The
OrganicLayout
class is now able to produce 3D layout results. -
The
OrganicLayout
class is now able to consider user-specified inertia and stress values for nodes. -
The new property
InteractiveOrganicLayout#CompactnessFactor
specifies the compactness of the result. If the graph contains several components, this feature can prevent that the components drift apart. -
The
LeftRightNodePlacer
class now supports layouts with multiple branches. With this feature, subtrees can not only be placed left/right of a single vertical bus, but left/right of multiple vertical buses (the branches). The new propertyBranchCount
allows to configure the number of branches. -
The tree node placer
GridNodePlacer
offers the following new features:- The placement of the bus for routes to its children can now be configured using the new enumeration
BusPlacement
. Available placements areLEADING
,TRAILING
andCENTER
. - Child sub-trees can be assigned to rows automatically using the new property
GridNodePlacer#AutomaticRowAssignmentEnabled
. - The new alignment policy
GridNodePlacer#BUS_ALIGNED
aligns the root node with the bus.
- The placement of the bus for routes to its children can now be configured using the new enumeration
-
The
OrthogonalLayout
class is now able to consider custom crossing and bend costs for edges. They can be specified using the new propertiesOrthogonalLayoutData#EdgeCrossingCosts
andOrthogonalLayoutData#EdgeBendCosts
respectively. -
The new class
GivenCoordinatesStage
changes node locations and edge paths to user-specified values before invoking the core layout algorithm. To specify locations and paths, use the newGivenCoordinatesStageData
class. -
The new
GenericPartitionGridStage
class offers generic support for partition grid structures.
Viewer
-
The
GraphEditorInputMode
class provides the new methodsraiseSelection
,lowerSelection
,selectionToFront
andselectionToBack
that change the z-order of all selectedIModelItems
. -
The
GraphModelManager
class has the new methodsraise
,lower
,toFront
andtoBack
that allow for changing the z-order ofIModelItems
. All these z-order-related methods can also be triggered by the new commandsRAISE
,LOWER
,TO_FRONT
andTO_BACK
. -
CreateEdgeInputMode
can now create edges in reversed direction, i.e. starting from target port.- The new
EdgeDirectionPolicy
supports starting creation at source, target, in the last direction, or depending on the port candidate. - A configurable
ToggleDirectionRecognizer
allows for changing the edge direction during creation.
- The new
-
The method
CreateEdgeInputMode#doStartEdgeCreation
that is used to programmatically start an interactive edge creation gesture now returns aFuture
with the newly created edge as result. -
The method
MoveInputMode#doStartDrag
that is used to programmatically start an interactive drag gesture now returns aFuture
with the affected items as result. -
The new property
MoveLabelInputMode#MovingUnselectedLabelsAllowed
enables moving labels without having to select them first.
New Demos
-
The
GraphAnalysisDemo
shows how to use the new interfaces for the graph analysis algorithms and how to visualize their results. -
The
LogicGateDemo
shows how yFiles can be used for the visualization of a digital system consisted of logic gates. -
The
Neo4jDemo
shows how to integrate a Neo4j graph data base in your application.
Improvements
Algorithms
-
The new
GraphStructureAnalyzer
class provides methods to check structural properties of a given graph.
Layout
-
Added convenience overloads for
ItemCollection
andItemMapping
property setters toLayoutData
classes with properties of typeItemCollection
orItemMapping
. E.g.hierarchicLayoutData#getEdgeLayoutDescriptors().setConstant(newDescriptor)
can now be abbreviated tohierarchicLayoutData#setEdgeLayoutDescriptors(newDescriptor)
. -
The
HierarchicLayout
class now correctly calculates the group node bounds. Previously, the groups' insets were slightly too large (up to one pixel). -
The
HierarchicLayout
class now always places a port in the middle of a node side, if it is the only port on that side. Previously the port was only centered if the label was additionally placed on the edge. -
The
HierarchicLayout
class now also considers critical edge priorities for grouped edges. -
The
HierarchicLayout
class now requires less memory for graphs with sequence constraints. -
The
HierarchicLayout
class now uses the specified layer alignment (seeNodeLayoutDescriptor#LayerAlignment
) to align sub-components (seeHierarchicLayoutData#SubComponents
). -
The
HierarchicLayout
class no longer inserts superfluous bends for edges between group nodes if the input graph contains grouped edges. -
With
HierarchicLayout
, the number of edges crossing through group nodes without starting or ending in them when using the default algorithm settings was reduced. Furthermore, the behavior can be customized using the new group node border crossing costs (see propertyHierarchicLayoutData#GroupBorderCrossingCosts
). -
The
HierarchicLayout
class now also considers sequence constraints for grouped edges. -
The layering of
HierarchicLayout
was improved with respect to the resulting edge lengths if the recursive group layering is enabled. -
The
HierarchicLayout
class now produces less overlapping elements for graphs with fixed coordinate hints. -
The new property
OrthogonalLayout#ParallelRoutesPreferenceEnabled
allows for controlling how parallel edges (multi-edges) are routed. -
The
RecursiveGroupLayout
class now allows to define a localPartitionGrid
structure for each recursively handled group node. See the new propertyRecursiveGroupLayoutData#GroupNodePartitionGrids
for details. -
The
EdgeRouter
class now generates less edge-edge overlaps and a better distribution of edge segments when theEdgeRouter#MaximumDuration
is strongly restricted or set to zero, or when the algorithm is stopped via theAbortHandler#stop
method. -
The
EdgeRouter
class now avoids superfluous bends that were in some cases caused by group nodes with (small) inset values. -
The path search performance of the
EdgeRouter
class has been improved for cases where an edge has a strong, externalPortConstraint
or a fixed, externalPortCandidate
. -
The
EdgeRouter
now supports edge grouping on both endpoints. Previously, an edge could only be part of either a source or a target group. -
The
EdgeRouter
class now generates a proper routing from a group node border to a port location inside this group node defined by a strongPortConstraint
or a fixedPortCandidate
. Previously, the route was only calculated to the border and then the last segment was extended without consideration of obstacles and other elements. -
The performance of the
GenericLabeling
algorithm and the quality of the label placements were improved. -
The quality of edge label placement of the
GenericLabeling
class was improved in case that there are multiple labels with a source or target preference near the same node. They may now be placed further away but avoid undesired overlaps. -
The
PortCalculator
class now considers edge label positions such that they are not affected by whether this stage is applied or not. Previously, label positions could be changed if the label position was stored relative to the first/last segment or the port. -
If the master edge is clipped on the bounds of its source or target, the
ParallelEdgeRouter
class now always clips the associated parallel edges on that bounds, too. -
The
RemoveCollinearBendsStage
.Scale
property now also allows zero and negative numbers as its value. This makes it possible to internally round coordinates to full integer values for the comparison of bend points and, thus, the stage can be made more fuzzy. -
The
TreeReductionStage
now marks non-tree edges if anIDataAcceptor
is registered with the input graph with keyTreeReductionStage#NonTreeEdgeSelectionKey
. This way a user is able to query which edges the algorithm determined to be the non-tree edges. -
New options on class
PlaceNodesAtBarycenterStage
allow for specifying the size of affected nodes, considering the grouping structure when calculating the barycenter of nodes as well as removing the bends of edges incident to affected nodes. -
The properties
Rows
andColumns
of classPartitionGrid
are now of typeIEnumerable<RowDescriptor>
andIEnumerable<ColumnDescriptor>
instead of an un-typedYList
. -
The
PartitionGridData
class has new propertiesRowOrderOptimizationEnabled
andColumnOrderOptimizationEnabled
to indicate whether or not the order of the rows respectively columns should be chosen automatically to minimize edge lengths. -
The new
ChannelRoutingTool
class brings back the features of theChannelRouter
class that was removed in version 3.0. -
Combining multiple
LayoutData
classes is now easier:- The base class
LayoutData
offers a new methodcombineWith
that combines the current instance with anotherLayoutData
instance. - The class
CompositeLayoutData
has an additional constructor that takes a variable number ofLayoutData
instances.
- The base class
-
The new properties
AbortHandler
,SourcePortConstraints
,TargetPortConstraints
,SourcePortCandidates
, andTargetPortCandidates
ofChannelEdgeRouterData
facilitate using these features withChannelEdgeRouter
. -
The
RowIndices
andColumnIndices
properties of thePartitionGridData
class can now also be used in combination with theGrid
property. -
The
ImprovingPortAssignment
boolean property ofLayoutExecutor
andLayoutGraphAdapter
was replaced by thePortAdjustmentPolicy
property that offers more options how port locations should be adjusted after a layout calculation.
Viewer
- The parameter of the scroll command, that can be used to specify an additional scroll factor, can now be any numeric value of type Number.
-
CanvasComponent
: AddedzoomToAnimated
overloads which take an optional event listener that is notified of the animation's end. -
IMapperRegistry#createDelegateMapper
has been renamed tocreateFunctionMapper
. -
The property
ItemMapping#Delegate
has been renamed to Function. -
The property
ContextItemMapping#ContextDelegate
has been renamed toContextBiFunction
. -
The property
ItemCollection#Delegate
has been renamed to Predicate. -
The default methods
toList
andtoArray
have been added toIEnumerable
. -
Added convenience methods to convert view geometry classes (
PointD
,RectD
,SizeD
,InsetsD
,OrientedRectangle
) to layout classes (YPoint
,YRectangle
,YDimension
,YInsets
,YOrientedRectangle
) and vice versa. -
Added convenience methods for easy conversion between yFiles geometry classes and Java geometry
classes:
IPoint#toPoint2D
andPointD#fromPoint2D
.IRectangle#toRectangle2D
andRectD#fromRectangle2D
.
-
HandleInputMode
now clears theAffectedItems
after theCanceled
event has been raised instead of before. -
DefaultEdgePathCropper
's methodscropEdgePath
andcropEdgePathAtArrow
are no longer final. -
The viewport animation of the
LayoutExecutor
class considers now the value of theLimitingFitContentZoomEnabled
property of the correspondingGraphComponent
. -
NodeStylePortStyleAdapter
andAbstractJComponentPortStyle
now have anOffset
property that allows to shift the port visualization so that it no longer is centered over the port. -
The
GraphModelManager
class has new factory methods for creating theItemModelManager
of each item group. -
The
GraphModelManager#getModelItem
method now always returns theIModelItem
for anICanvasObject
retrieved for it viagetMainCanvasObject
. Previously this only worked in all cases for theICanvasObject
retrieved viagetCanvasObject
. - Mouse move and drag events now correctly report the changed modifier keys.
- Reduced number of cases where a new label was created by interactive editing instead of editing an existing one.
-
The methods
addLabel
,createLabel
andeditLabel
ofGraphEditorInputMode
andTableEditorInputMode
that are used to start the respective interactive label editing gesture programmatically return now aFuture
with the edited or newly created label as result. -
GraphEditorInputMode
provides new protected methodscreateLabelCore
andeditLabelCore
to allow for overriding the default implementations. -
GraphEditorInputMode
provides aTextEditorInputModeConfigurator
to allow for configuring theTextEditorInputMode
before each label editing. -
The
GraphEditorInputMode#DeletedItem
event provides now context information about the state before the item has been deleted. For example, if a label has been deleted you now can get its old owner. -
The method
GraphEditorInputMode#onDeletedItem
is no longer final. -
Added the
GraphClipboard#getId
method to facilitate retrieving the original item from which an item to be pasted has been copied from. -
The new property
GraphClipboard#ClipboardContext
provides access to the currentIGraphClipboardContext
during a clipboard operation. -
The new property
CreateEdgeInputMode#ShowingTargetHighlightEnabled
specifies whether to enable or disable highlighting of potential targets for edge creation. Also, the methodupdateTargetHighlight
has been added to allow for further customization of the highlight. -
NavigationInputMode
: Added a propertyScrollingToSelectionEnabled
that controls whether a node that is focused or selected with a keyboard gesture is automatically scrolled into the viewport if necessary. -
The new properties
PortRelocationHandle#ShowingTargetHighlightEnabled
andPortRelocationHandleProvider#ShowingTargetHighlightEnabled
specify whether to enable or disable highlighting of potential targets for edge creation. Also, the methodupdateHighlight
has been added to thePortRelocationHandle
class to allow for further customization of the highlight. -
The new properties
PortRelocationHandle#ShowingPortCandidatesEnabled
andPortRelocationHandleProvider#ShowingPortCandidatesEnabled
specify whether to enable or disable showing port candidates during edge relocation. -
The new
PortStyleDecorationInstaller
class allows the use of anIPortStyle
to render the selection, highlight, or focus indicator of ports. -
The properties
RectangleIndicatorInstaller#Template
andOrientedRectangleIndicatorInstaller#Template
now return always the value that has been set by client code and are not modified by internal code anymore. - Snaplines are now infinitely long by default.
-
The performance of
EdgePathLabelModel#getGeometry
andEdgeSegmentLabelModel#getGeometry
has been strongly increased. -
The
GraphMLIOHandler
class now supports reading and writing arbitrary objects at graph level. -
GraphML deserialization now supports the symbolic names "Zero" and "Infinite" for reading
SizeD
values. -
GraphML deserialization now supports the symbolic name "Infinite" for reading
RectD
values. -
GraphML deserialization now supports the symbolic name "Origin" for reading
PointD
values. -
The type of property
GraphBuilder#EdgeLabelProvider
was generalized fromFunction<TEdge,String>
toFunction<TEdge,Object>
.
Bugfixes
Algorithms
-
The
Paths#findAllChains
method now correctly calculates the chains of input graphs with cycles. -
The
GraphChecker#isMultipleEdgeFree
method now returns the correct result for input graphs with self-loops. -
The
Bfs#getLayers
method now correctly stores the layer indices in the specifiedINodeMap
. Previously, the maximum layer index stored in the map exceeded the number of returned layers.
Layout
-
The
EdgeRouter
class no longer produces bad, non-orthogonal edge segments in cases where a selected edge is grouped together with an un-selected edge and where both edges have strongPortConstraints
at their common source/target node. -
The
PortPlacementStage
class no longer destroys the grouping information for the core layout algorithm. -
The
EdgeRouter
class now correctly considers strong port constraints of edges that belong to a bus structure. -
The
HierarchicLayout
class no longer throws an exception if the component arrangement policy is set toComponentArrangementPolicy#COMPACT
and bus routing is enabled (see propertyHierarchicLayoutData#Buses
). -
The
OrganicLayout
class now correctly considers input graphs where substructure handling is enabled and all nodes are located at coordinate(0,0)
. Previously, such inputs may have triggered anArgumentException
. -
Class
EdgeRouter
no longer throws an exception if all fixed edges of a bus are non orthogonal/octilinear. -
The
GenericLabeling
class no longer throws anArgumentException
for some input graphs containing labeled edges with zero length. -
The
HierarchicLayout
class no longer throws an exception if it is wrapped by an instance ofRecursiveGroupLayout
and the input graph contains layering constraints between elements of different groups. -
The
HierarchicLayout
class now correctly considers the group insets for input graphs with nested group nodes. Previously, it sometimes produced too large insets for inner groups. -
The
HierarchicLayout
class no longer throws anIllegalArgumentException
for some rare cases in incremental layout mode. -
The
HierarchicLayout
class now produces shorter, more direct edge routes for edges connecting at a group node and leaving on the the left/right group side. This only affects cases where the relevant group node also contains direct-content edges (seeEdgeLayoutDescriptor#DirectGroupContentEdgeRoutingEnabled
). -
Self-loop segments generated by the
HierarchicLayout
class are now shorter and take up less space if possible. Previously, segments were sometimes unnecessarily long even though the minimum length settings allowed shorter segments. -
The
HierarchicLayout
class now produces less superfluous crossings if there are same-layer edges withPortConstraints
orPortCandidates
. -
The
HierarchicLayout
class now correctly handles port labels with zero height/width. Previously, such labels may have caused very large distances between some nodes. -
The
HierarchicLayout
class sometimes threw anIllegalArgumentException
for input graphs that contained incremental elements in combination with groups. -
The
HierarchicLayout
class sometimes threw anIllegalArgumentException
for input graphs that contained fixed elements in combination with both swimlanes and groups. -
The
HierarchicLayout
class now places sloped segments of grouped octilinear edges such that they are perfectly overlapping each other. Previously, it could happen that segments were slightly displaced with respect to each other. -
The
HierarchicLayout
class no longer causes non-orthogonal segments when the input contained port labels in conjunction with edge grouping. -
The
HierarchicLayout
class now correctly considers fixed nodes with layering constraints. In previous versions there were some rare cases where such inputs caused infinite looping issues. -
The
HierarchicLayout
class no longer produces intersections between edges and elements of a sub-component (seeHierarchicLayoutData#SubComponents
). Note that this fix may sometimes cause less compact results within a layer. -
Improved the path search performance of the
EdgeRouter
class for cases where a large number of fixed and overlapping edge segments exist. Previously, the search could become very slow in such scenarios. -
The
EdgeRouter
class now correctly groups edges associated with equal group IDs that have a different object ID. -
The
EdgeRouter
class now avoids unnecessary bends in cases that containPortCandidates
with fixed offsets (or strongPortConstraints
) where the fixed port locations have a very similar x- or y-coordinate such that the path must consist of three segments with a single, very short middle segment. Previously, five segments in total were generated. -
A rare exception that was triggered by the
EdgeRouter
class during routing when aGrid
is defined on which edges need to be routed is now fixed. -
The
EdgeRouter
class now correctly handles edges with external ports. Previously, such inputs may have caused an exception. -
The
EdgeRouter
class now correctly routes direct content edges with strong port constraints at the group nodes. Previously, the algorithm sometimes produced weird routes for such edges. -
Fixed a bug in the
EdgeRouter
class that sometimes caused a non-deterministic behavior. -
Fixed two issues in the
EdgeRouter
class that resulted in the violation of aPortCandidate
with fixed offsets or a strongPortConstraint
. The first was only triggered for constraints at the target side and only when the target node was additionally partly or fully covered by other obstacles (e.g. node labels). The second issue appeared in cases with the source and target node fully overlapping (e.g. an edge from a group to a child node). -
The
EdgeRouter
class no longer throws an exception if itsPolylineRoutingEnabled
property is enabled and the input contains fixed, grouped edges. -
The
EdgeRouter
class now considers the correctNodeHalo
associated with the target node when handling the minimum last segment length setting. Previously it incorrectly considered the halo of the source node which could lead to unnecessarily long or too short last segments. -
The
EdgeRouter
class now correctly considers intersections between edges and labels of fixed edges if propertyEdgeLabelConsiderationEnabled
is enabled. -
The
EdgeRouter
class no longer throws an exception during routing in cases where the source or target node is covered by obstacles (i.e. by other nodes or labels). -
The
EdgeRouter
class now correctly considers intermediate routing points when using the polyline routing style (EdgeRouter#PolylineRoutingEnabled
). Previously, it could happen that intermediate points were not part of the final polyline edge path. -
The
EdgeRouter
class no longer throws an exception during the routing of some graphs with grouped edges. -
The
EdgeRouter
class no longer considers allPortCandidates
with multiple directions as fixedPortCandidates
. -
The
EdgeRouter
class now correctly handles cases where the maximum duration is exceeded and where previously an exception was triggered. -
Fixed a
StackOverflowError
inEdgeRouter
. -
The
OrganicLayout
class no longer throws an exception when usingCycleSubstructureStyle#CIRCULAR
and arranging a cycle structure where at least one cycle node is also connected to a group node outside the cycle. -
The
OrganicLayout
class now produces deterministic results for group nodes if its propertyDeterministicModeEnabled
is enabled. -
The
OrthogonalLayout
class no longer causes an exception for some input graphs when propertyFaceMaximizationEnabled
is enabled. -
The
OrthogonalLayout
class no longer runs into an infinite loop for some input graphs that are tree structures with mixed edge directedness (see propertyOrthogonalLayout#EdgeDirectednessDpKey
). Note that the problem only occurred if propertyOrthogonalLayout#TreeStyle
is not set toTreeLayoutStyle#NONE
. -
The
OrthogonalLayout
class no longer throws an exception when its propertyUniformPortAssignmentEnabled
is enabled and the input contains parallel edges. -
When using
RecursiveGroupLayout
, the values of the propertiesComputedWidth
,ComputedHeight
andComputedPosition
of the classesColumnDescriptor
andRowDescriptor
are now correctly set after the layout ifEdgeRouter
is the correspondingInterEdgeRouter
. -
The
CompactNodePlacer
class no longer throws an exception for input graphs with specified memento strategies (seeTreeLayoutData#CompactNodePlacerStrategyMementos
orCompactNodePlacer#STRATEGY_MEMENTO_DPKEY
). -
The
CompactNodePlacer
class now correctly considers the specified values of theVerticalDistance
andHorizontalDistance
properties. -
The
CompactNodePlacer
class no longer throws an exception for some inputs with specified strategy memento information (either via propertyTreeLayoutData#CompactNodePlacerStrategyMementos
or with a mapper registered with keyCompactNodePlacer#STRATEGY_MEMENTO_DPKEY
). -
The
SimpleNodePlacer
class no longer produces very long horizontal edge segments for inputs where it isn't required. -
The
GenericLabeling
class now correctly places labels of direct content edges (edges that directly connect a group node with a descendant, without leaving the group) with a free edge label model. -
The
GenericLabeling
class no longer calculates wrong label profit values (AbstractLabeling#getProfit
) for some edge labels. Previously, edges that had aPreferredPlacementDescriptor
were sometimes affected. -
The
GenericLabeling
class now produces valid results for edge labels that have a preferred distance to the edge (PreferredPlacementDescriptor#DistanceToEdge
) and at the same time multipleSideOfEdge
preferences (e.g. left of edge and on the edge). Previously, the algorithm sometimes violated the preferred distance even though it would have been possible to keep it. -
The
GenericLabeling
class now always prefersLabelCandidates
with higher profit values over others with lower profit (seeAbstractLabeling#getProfit
). Previously, this sometimes happened even though both candidates did not intersect with other elements. -
The
GenericLabeling
class does no longer assume that allLabelCandidates
associated to a label have the same size. Previously, this caused unexpected labeling results if custom candidates with different sizes were given. -
Fixed a rare bug in the
GenericLabeling
that may have caused anIllegalArgumentException
for some input graphs that contain edges with zero length segments and labels associated with a free edge label model. -
The
SeriesParallelLayout
class now correctly handles input graphs with groups that only contain disconnected nodes. Previously, such inputs caused an exception. -
The
PartialLayout
class now correctly considers the specifiedPortCandidates
during orthogonal or octilinear routing of edges. -
The
PartialLayout
class does no longer reduce the size of fixed group nodes if the optionPartialLayout#ResizeFixedGroups
is disabled. -
The
ComponentLayout
class now correctly handles input graphs with user-specified components that contain nodes withnull
as their component ID (see propertyComponentLayoutData#ComponentIds
). Previously, such inputs may have caused an exception. -
The
PolylineLayoutStage
does no longer generate overlaps between sloped, polyline segments created by the stage and unrelated other obstacles (e.g. nodes). -
The
OrganicRemoveOverlapsStage
no longer produces infinite loops in some rare cases. -
Fixed a bug in
YGraphAdapter
that could trigger aNullPointerException
when boolean, integer or double values were requested from registeredIMapper
but no value had been set beforehand.
Viewer
-
Fixed a bug in
GraphEditorInputMode
where changing the value ofShowHandleItems
while handles were already displayed resulted in duplicate handles. -
Fixed a bug in
EdgePathLabelModel
which could return an invalid geometry for parameters with a ratio < 0 and zero length edge segments. -
A bug in
CanvasComponent#fitContent
has been fixed that sometimes resulted in a short flickering. -
Mapper: Fixed default value handling for the
null
key. -
Mapper: Ensured that mappings for the
null
key are taking into account by methodgetEntries
. -
Changed
CommandBindingAction
'sactionPerformed
behavior to always pass the action's target to the associatedKeyboardInputMode#ExecuteCommandHandler
andKeyboardInputMode#CanExecuteCommandHandler
instances instead of the action event's source. -
GeneralPath#flatten()
: Fixed unexpected behavior if a curve follows after a close operation. - Zooming the viewport during interaction no longer synthesizes mouse-move events in the wrong locations.
-
Labels at folder nodes and their adjacent edges are no longer lost during GraphML deserialization
if the
DefaultFolderNodeConverter#CopyFirstLabel
property is enabled. -
Fixed a bug in
PortRelocationHandleProvider
where the settingsShowPortCandidates
andShowTargetHighlight
were ignored. -
Fixed a bug in
CreateEdgeInputMode#getPortOwner
which could return edges even ifEdgeToEdgeConnectionsAllowed
was set to false. This could result in the edge'sIPortCandidateProvider
being queried for candidates erroneously. - Fixed a bug in the graph implementation that sometimes lead to a runtime that was quadratic in the number of nodes when creating large graphs.
- Reparenting an expanded group node into a collapsed group node no longer throws an exception.
-
Fixed an exception which could occur in
CanvasComponent
's methodcompareRenderOrder
and when usingGraphModelManager
'sComparator
property. -
GraphClipboard
's methodsonElementCut
andonElementCopied
are no longer called for graph items which are not copied themselves but are owners of copied items. -
When an edge is duplicated using
GraphClipboard
and a port is newly created during this operation, the new port now gets the old port's style and tag. -
Fixed a memory leak in the
UndoEngine
class if the tokens returned bygetToken
were not disposed when theUndoEngine
got cleared. -
The
CreateEdgeInputMode
class now considers the value of theCanvasComponent#HitTestRadius
property when itsStartingOverCandidateOnlyEnabled
property is enabled. -
The visualization of source port candidates by the
CreateEdgeInputMode
class does not flicker, anymore. -
With
SmartEdgeLabelModel
, it was impossible to move a label from the left side of an edge to the right side. Instead, the label stopped at the edge. -
The
null
check for theGridVisualCreator#Pen
property works correctly now. -
The type
IGridConstraintProvider
cannot be used in lookup methods since it has a generic type parameter. Therefore, new specific interfaces have been added for each item type (for exampleINodeGridConstraintProvider
). -
The
EdgeStyleDecorationInstaller
class no longer causes an exception when used on edges that are attached to other edges. - Parsing a GraphML file with a folding edge state with a label without a preferred size no longer throws an exception.
- In rare cases, saving a graph with folding to GraphML threw an exception.
Incompatible Changes
Layout
-
The
ImprovingPortAssignment
boolean property ofLayoutExecutor
andLayoutGraphAdapter
has been replaced by thePortAdjustmentPolicy
property. -
SingleItemCollection
'sItem
property has been pulled up toItemCollection
. ClassSingleItemCollection
has been removed, its usages have been replaced byItemCollection
. -
The property
HierarchicLayoutData#AlternativeEdgePath
has been renamed toHierarchicLayoutData#AlternativeEdgePaths
. -
The property
HierarchicLayoutData#AlternativeEdgePaths
now expectsIterable<IPoint>
instead ofYPointPath
as mapped values. -
The property
HierarchicLayoutData#AlternativeGroupBounds
now expectsIRectangle
instead ofYRectangle
as mapped values. -
The type of the properties
BalloonLayoutData#TreeRoot
andTreeLayoutData#TreeRoot
has been changed toSingleItem<INode>
. -
The property
TreeLayoutData#LeftRightPlacersLeftNodes
has been renamed toTreeLayoutData#LeftRightNodePlacerLeftNodes
. -
The property
TreeLayoutData#DelegatingNodePlacersPrimaryNodes
has been renamed toTreeLayoutData#DelegatingNodePlacerPrimaryNodes
. -
The properties
SourceGroups
andTargetGroups
ofRadialLayoutData
have been removed since edge grouping is not supported by theRadialLayout
class. -
The properties
Rows
andColumns
of classPartitionGrid
are now of typeIEnumerable<RowDescriptor>
andIEnumerable<ColumnDescriptor>
instead of an un-typedYList
. -
The
PenaltySettings#InvalidEdgeGroupingPenalty
property has been removed. If edge groups are defined, theEdgeRouter
class now always considers them. Therefore, this setting no longer applies. -
The following changes regarding the expert API related to the
EdgeRouter
class were made:- The first parameter of the constructors in class
AbstractSegmentInfo
is now of typeObject
instead ofEdge
. The provided type should be eitherPathRequest
for affected edges orEdge
for non-affected, fixed ones. Furthermore, the propertyAbstractSegmentInfo#Edge
has been removed as the info is not necessarily associated with an edge anymore. - Simialrly, the first parameter of the constructor in class
EdgeCellInfo
is now of typeObject
instead ofEdge
. The provided type should be eitherPathRequest
for affected edges orEdge
for non-affected, fixed ones. - The constructor of class
EdgeInfo
now additionally takes a parameter of typeEdge
. - The parameter of type
Edge
from the constructor ofPath
as well as the respective property were removed. A path is now not necessarily associated with an edge but only with the newly introducedPathRequest
. - The method
PathSearchResult#getEdgeInfo(Path)
was removed.
- The first parameter of the constructors in class
Viewer
-
The property
CanvasComponent#Editable
and the associated eventeditableChanged
are not necessary and have been removed. -
IMapperRegistry#createDelegateMapper
has been renamed tocreateFunctionMapper
. -
The property
ItemMapping#Delegate
has been renamed toFunction
. -
The property
ContextItemMapping#ContextDelegate
has been renamed toContextBiFunction
. -
The property
ItemCollection#Delegate
has been renamed toPredicate
. -
Changed
CommandBindingAction
'sactionPerformed
behavior to always pass the action's target to the associatedKeyboardInputMode#ExecuteCommandHandler
andKeyboardInputMode#CanExecuteCommandHandler
instances instead of the action event's source. -
GraphClipboard
's methodsonElementCut
andonElementCopied
are no longer called for graph items which are not copied themselves but are owners of copied items. As a consequence, the methodscut
andcopy
of theIClipboardHelper
implementations of these elements are no longer called, either. -
The classes
GeneralPath
andGeneralPath.PathCursor
are now final.
Changes of Default Behavior
Layout
-
Renamed property
PartialLayout#ResizeFixedGroups
toFixedGroupResizingEnabled
. -
The
HierarchicLayout
class now uses a higher crossing cost for group node borders. To specify custom values, use the propertyHierarchicLayoutData#GroupBorderCrossingCosts
. -
The
GroupingSupport
class no longer throws anIllegalArgumentException
if there is a node without associated ID (seeGroupingKeys#NODE_ID_DPKEY
). Instead the class uses the node itself as ID. -
The
SimplexNodePlacer#BarycenterMode
property is now enabled by default. Thus, theHierarchicLayout
class with default settings now produces different (usually more symmetric) layouts. -
The default value of the property
GridNodePlacer#RootAlignment
was changed toGridNodePlacer#BUS_ALIGNED
fromAbstractRotatableNodePlacer#RootAlignment#TRAILING
. -
If the master edge is clipped on the bounds of its source or target, the
ParallelEdgeRouter
class now always clips the associated parallel edges on that bounds, too.
Viewer
-
The following places now throw a
ConcurrentModificationException
instead of anIllegalStateException
:-
FilteredGraphWrapper
: Changing graph items while iterating those using theIListEnumerable
returned byFilteredGraphWrapper#getNodes
,FilteredGraphWrapper#getEdges
,FilteredGraphWrapper#getLabels
orFilteredGraphWrapper#getPorts
. -
FilteredGraphWrapper
: Changing the edges at a port or node while iterating those edges using theIListEnumerable
returned byedgesAt
. -
GeneralPath
: Changing the path's structure while iterating the path using aPathCursor
returned byGeneralPath#createCursor
.
-
-
The default tooltip in the class
ToolTipQueryEventArgs
is now set tonull
. Thus, the tooltip is not displayed when the event is handled without setting the tooltip content. -
The properties
RectangleIndicatorInstaller#Template
andOrientedRectangleIndicatorInstaller#Template
now return always the value that has been set by client code and are not modified by internal code anymore.
yFiles for Java (Swing) 3.2.0.3
Bugfixes
Viewer
- With
SmartEdgeLabelModel
, it was impossible to move a label from the left side of an edge to the right side. Instead, the label stopped at the edge. - Fixed an exception which could occur in
CanvasComponent
's method#compareRenderOrder
and when usingGraphModelManager
's#Comparator
property. - Parsing a GraphML file with a folding edge state with a label without a preferred size no longer throws an exception.
- In rare cases, saving a graph with folding to GraphML threw an exception.
- The
NodeAlignmentPolicy
valuesCENTER_LEFT
,CENTER_RIGHT
,TOP_CENTER
,BOTTOM_CENTER
, andBOTTOM_LEFT
now work correctly. - Reparenting an expanded group node into a collapsed group node no longer throws an exception.
DefaultLabelStyle
: Fixed insets calculation.
Layout
- Fixed a potential exception in
LayoutExecutor
which could occur when a layout is applied to a graph which contains table nodes which are not group nodes.
yFiles for Java (Swing) 3.2.0.2
New Demos
- Added
RotatableNodesDemo
that shows how support for rotated node visualizations can be implemented on top of the yFiles library. - Added
PartitionGridDemo
that shows how aPartitionGrid
can be used in layout calculations to restrict the node positions to grid cells. - Added
RenderingOrderDemo
that shows the effect of different render policies on the z-order of nodes, edges, labels and ports. - Added
EdgeToEdgeDemo
that demonstrates the use of edge-to-edge connections.
Improvements
Layout
- Slightly improved the performance of the
GenericLabeling
algorithm and improved the quality of the label placements for some cases.
Bugfixes
View
- Fixed null check for
GridVisualCreator#Pen
property. - Fixed an issue where
EdgeStyleDecorationInstaller
would cause an exception when used on edges that connect to other edges. - Fixed a bug, which might occur in very rare cases in the undo/redo processing of several consecutive reparent actions.
- Fixed a bug in the graph implementation that sometimes led to a runtime that was quadratic in the number of nodes when creating large graphs.
CreateEdgeInputMode
: Fixed a bug that caused the visualization of source port candidates to flicker.- The
EdgeStyleDecorationsInstaller
class now properly displays decorations for edges between group nodes and their descendants when displayed in view coordinates. CollapsibleNodeStyleDecorator
: Although the wrapped style has its ownIClickListener
defined in its lookup, it was not always used by theCollapsibleNodeStyleDecorator
.- Fixed a bug in the
UndoEngine
that could lead to memory leaks if the tokens returned bygetToken
were not disposed of when theUndoEngine
got cleared. - Fixed a bug that rendered labels or ports neither in a separate layer nor at their owner when
exactly one of
LabelLayerPolicy#AT_OWNER
orPortLayerPolicy#AT_OWNER
was used. - Fixed a bug in
GridVisualCreator
that rendered the grid at the wrong location when the viewport contained negative coordinates. CollapsibleNodeStyleDecorator
:IsHit
respects buttons outside the node bounds.
Algorithms
- Method
Paths#findAllChains
now correctly calculates the chains of input graphs with cycles.
Layout
- Fixed a bug in class
EdgeRouter
that sometimes caused a non-deterministic behavior. - The
PolylineLayoutStage
does no longer generate overlaps between sloped, polyline segments created by the stage and unrelated other obstacles (e.g. nodes). - Fixed a rare exception that was triggered by the
EdgeRouter
class during routing in cases where the input contained grouped edges. - The
GenericLabeling
class now produces better results for edge labels that have a preferred distance to the edge (PreferredPlacementDescriptor#DistanceToEdge
) and at the same time multipleSideOfEdge
preferences (e.g. left of edge and on the edge). Previously, the algorithm sometimes violated the preferred distance even though it would have been possible to keep it. - Fixed two issues that induced the violation of a
PortCandidate
with fixed offsets (or a strongPortConstraint
) by theEdgeRouter
class. The first was only triggered for constraints at the target side and only when the target node was additionally partly or fully covered by other obstacles (e.g. node labels). The second issue appeared in cases with the source and target node fully overlapping (e.g. an edge from a group to a child node). - The
EdgeRouter
class no longer throws an exception for inputs (rare) containing fixed, grouped edges and whenEdgeRouter#PolylineRoutingEnabled
is enabled. - The
EdgeRouter
now considers the correctNodeHalo
associated with the target node when handling the minimum last segment length setting. Previously it incorrectly considered the halo of the source node which could lead to unnecessarily long or too short last segments. - Class
EdgeRouter
now correctly considers intersections between edges and labels of fixed edges if propertyEdgeLabelConsiderationEnabled
is enabled. - Fixed a very rare exception that was triggered by the
EdgeRouter
class during routing in cases where the source/target node is covered by obstacles (i.e. other nodes, labels). - The
EdgeRouter
class now correctly considers intermediate routing points when using the polyline routing style (EdgeRouter#PolylineRoutingEnabled
). Previously, it could happen that intermediate points were not part of the final polyline edge path. - Class
PartialLayout
now correctly considers the specifiedPortCandidates
during the orthogonal/octilinear routing of edges. - Class
EdgeRouter
no longer considers allPortCandidates
with multiple directions as fixedPortCandidates
. - The
OrthogonalLayout
class no longer throws an exception when propertyOrthogonalLayout#UniformPortAssignmentEnabled
is enabled and the input contains parallel edges. - The
CompactNodePlacer
class now correctly considers the specified values of theVerticalDistance
andHorizontalDistance
properties. - Class
OrganicRemoveOverlapsStage
no longer produces infinite loops for some rare cases. - The
CompactNodePlacer
class no longer throws an exception for some inputs with specified strategy memento information (either via propertyTreeLayoutData#CompactNodePlacerStrategyMementos
or with a mapper registered with keyCompactNodePlacer#STRATEGY_MEMENTO_DPKEY
). - Self-loop segments generated by the
HierarchicLayout
class are now shorter and take up less space if possible. Previously, segments were sometimes unnecessarily long even though the minimum length settings allowed shorter segments. - When using
RecursiveGroupLayout
, the values of the propertiesComputedWidth
,ComputedHeight
andComputedPosition
of the classesColumnDescriptor
andRowDescriptor
are now correctly set after the layout ifEdgeRouter
is the correspondingInterEdgeRouter
. - The
HierarchicLayout
class now produces less superfluous crossings if there are same-layer edges withPortConstraints
orPortCandidates
. - Improved the path search performance of the
EdgeRouter
class for cases where a large number of fixed and overlapping edge segments exist. Previously, the search could become very slow in such scenarios. - The
HierarchicLayout
class now correctly handles port labels with zero height/width. Previously, such labels may have caused very large distances between some nodes. - The
HierarchicLayout
class sometimes threw anArgumentException
for input graphs that contained incremental elements in combination with groups. - The
HierarchicLayout
class now prevents intersections between labels and the horizontal grid lines of aPartitionGrid
. - The
EdgeRouter
class no longer throws an exception for some inputs containing edges with intermediate routing points. - The
HierarchicLayout
class now places sloped segments of grouped octilinear edges such that they are perfectly overlapping each other. Previously, it could happen that segments were slightly displaced with respect to each other. - Class
SeriesParallelLayout
now correctly handles input graphs with groups that only contain disconnected nodes. Previously, such inputs caused an exception. - Fixed a bug in the
HierarchicLayout
that could cause non-orthogonal segments when the input contained port labels in conjunction with edge grouping. - The
OrganicLayout
class now produces deterministic results for group nodes (if propertyDeterministicModeEnabled
is enabled). - Fixed a
StackOverflowError
inEdgeRouter
.
yFiles for Java (Swing) 3.2.0.1
Improvements
Styles
-
PolylineEdgeStyle
andArcEdgeStyle
now consider property changes of their source and target arrows. Previously the source or target arrow properties had to be changed to instantly see the effect.
Layout
-
OrganicLayoutData
: The new propertiesSourceGroupIds
andTargetGroupIds
can be used to group edges when some preconditions are met.
Bugfixes
Viewer
-
Scrolling with
CanvasComponent#ScrollCommandAnimationEnabled
enabled no longer changes the zoom level. - Fixed a bug in
RectangleIndicatorInstaller
,OrientedRectangleIndicatorInstaller
,HandleInputMode
and inSnapResultProvider
andSnapResult
implementations, that has caused aNullPointerException
when the corresponding template is null. DefaultLabelStyleRenderer
: Fixed vanishing text when using a shared renderer instance between labels with non-empty text and label with empty text.
Input
PortDropInputMode
: The labels of dragged ports were not displayed correctly.
Graph Model
- Fixed an exception which might occur upon user interactions in a folded graph which contains labels at ports.
- Fixed a bug which might have caused an edge in a folded view to lose its bends and labels after repeatedly reversing the edge.
Layout
-
HierarchicLayout
: Fixed a problem that sometimes caused too long straight-line same-layer edges. Note that the additional length was equal to the value ofHierarchicLayout#NodeToEdgeDistance
-
HierarchicLayout
: Fixed endless loop issue causing aStackOverflowError
if a sub-component with a nested layout algorithm that again applied an instance ofHierarchicLayout
was defined. -
HierarchicLayout
: Fixed possibleNullPointerException
for input graphs with source/target port labels (seeLabelPlacements#AT_SOURCE_PORT
andLabelPlacements.AT_TARGET_PORT
) and with a subset of nodes associated with halos (seeNodeHalo
). -
HierarchicLayout
: Fixed a bug that sometimes caused a wrong placement of source/target edge labels when integrated edge labeling was enabled and if there were either critical edges (seeHierarchicLayout.CRITICAL_EDGE_DPKEY
) or propertySimplexNodePlacer.EdgeStraighteningEnabled
was enabled. -
HierarchicLayout
andSimplexNodePlacer
: Fixed a very rareIllegalArgumentException
that was caused by some input graphs that contain both swimlanes and groups as well as fixed elements. -
HierarchicLayout
: Fixed bug that could cause the violation of fixed port candidates if there were critical edges (seeHierarchicLayout.CRITICAL_EDGE_DPKEY
) and edges connecting to group nodes. -
OrganicLayout
: Fixed bug that caused that movable nodes kept their initial location if the scope is set toSUBSET
orMAINLY_SUBSET
and if there are output restrictions (seeOrganicLayout#OutputRestriction
). -
TreeLayout
: Fixed bug that caused less compact results when using theCompactNodePlacer
. -
TreeLayout
: Fixed bug that caused that the layout algorithm sometimes did not pass on exceptions that occurred during the layout calculation but caught them without proper handling. -
CompactNodePlacer
: FixedNullPointerException
that was triggered when the tree root was marked as assistant node, seeAssistantNodePlacer#ASSISTANT_DPKEY
. -
CompactNodePlacer
: FixedIllegalStateException
that could occur for input graphs that contain assistant nodes (seeAssistantNodePlacer#ASSISTANT_DPKEY
) and given placement strategies (seeCompactNodePlacer#STRATEGY_MEMENTO_DPKEY
). -
OrthogonalLayout
: FixedNullPointerException
that occurred when the subtree layout styleTreeLayoutStyle#INTEGRATED
was specified, the subtree orientation was fixed and the graph was almost a tree graph with the exception that the root node contained additional self-loop edges. -
SeriesParallelLayout
: Fixed a rare bug that triggered aNullPointerException
when the input location of a node was set to a very large value (e.g. largest possible floating-point value). This applies if the algorithm is not in from-sketch mode. For the from-sketch mode, an exception can still occur - this case is considered to be bad input. -
RadialLayout
: FixedNullPointerException
that was triggered when there was aDataProvider
registered with the graph with keyHierarchicalLayout.SUB_COMPONENT_ID_DPKEY
. -
ComponentLayout
: Fixed anIllegalArgumentException
that was triggered for some input graphs with user-defined components (seeCOMPONENT_ID_DPKEY
) where at least one node hadnull
as its component id. -
RecursiveGroupLayout
: Fixed a bug that caused violation of PortConstraints or PortCandidates for self-loops where both endpoints were restricted to the same node side. -
Polyline.EdgeRouter
: Fixed a rareNullPointerException
that was triggered for some input graphs when the maximum duration was exceeded. -
Polyline.EdgeRouter
: Fixed bug that could cause unnecessary bends for edges that need to cross group node borders. -
Polyline.EdgeRouter
: Fixed an issue that caused edge-to-edge distance violations (for segments directly connecting at a node) even if a cheaper route that e.g., introduces a bend - which costs less by default - was available. -
PolylineLayoutStage
: Fixed a bug that caused collinear bends to be removed from fixed edges. Now, such fixed edges are not changed anymore. -
GenericLabeling
: Fixed a very rareIllegalArgumentException
that was caused by some input graphs that contain edges with zero length segments and labels associated with a free edge label model (i.e.,SmartEdgeLabelModel
orFreeEdgeLabelModel
).
yFiles for Java (Swing) 3.2
Major New Features
- The new
LabelDropInputMode
andPortDropInputMode
classes implement drag and drop for labels and ports, respectively. The API of these classes is similar toNodeDropInputMode
for nodes. - Labels can now be added to ports and the new label models
FreePortLabelModel
andInsideOutsideLabelModel
can be used to place such labels. On the technical side,IPort
now extends theILabelOwner
interface and the enum constantGraphItemTypes#PORT_LABEL
was added. - The new
LassoSelectionInputMode
selects all model items inside a hand-drawn lasso region. This mode allows combinations of free-hand and straight-line sections during path creation. The following types and methods were added to support this mode.- Added the
GraphEditorInputMode#LassoSelectionInputMode
andGraphViewerInputMode#LassoSelectionInputMode
properties and a corresponding factory method.LassoSelectionInputMode
is disabled per default. - The new
GraphEditorInputMode#lassoSelect
andGraphViewerInputMode#lassoSelect
methods programmatically selects all items in the providedGeneralPath
. - The new
ILassoTestable
interface specifies whether the item is considered to be inside the lasso path. This is analog to theIMarqueeTestable
interface for marquee selection. - Any model item can be decorated with an instance of
ILassoTestable
or provide one in its lookup. For this, theNode
/Edge
/Port
/Label
/BendDecorator
classes got the newLassoTestableDecorator
property for decorating an item with a customILassoTestable
. - The new
#isInPath
method ofAbstractNode
/Edge
/Port
/LabelStyle
can be overridden to customize the lasso testing behavior.
- Added the
- Labels and ports can now optionally be rendered directly in front of their owner. Such a rendering
order can make the ownership of labels and ports more clear if nodes overlap. Previously, all label and ports were
rendered in front of all nodes. The new rendering order can be enabled by setting the new properties
LabelLayerPolicy
andPortLayerPolicy
ofGraphModelManager
toLabelLayerPolicy#AT_OWNER
andPortLayerPolicy#AT_OWNER
.
New Features
- The new
GraphBuilder
,TreeBuilder
, andAdjacentNodesGraphBuilder
classes can be used to build a graph from custom data. - The nesting options of
GraphModelManager
for the visualizations of nodes and edges have been improved and clearified.- The properties
HierarchicNodeNestingEnabled
andHierarchicEdgeNestingEnabled
are superseded by the newHierarchicNestingPolicy
property. This property has the enum typeHierarchicNestingPolicy
. - The new option
HierarchicNestingPolicy#GROUP_NODES
configuresGraphModelManager
to visualize all leaf nodes in one canvas object group while nesting all group nodes depending on their hierarchical depth.
- The properties
- The mouse wheel behavior of the overview can now be switched between
ZOOM
,SCROLL
, andNONE
, and optionally, the action can be performed only when the control is focused. This can be configured with the newOverviewInputMode#MouseWheelBehavior
property. TableEditorInputMode
: Double clicking a stripe or stripe label now edits the label in the same way as for other graph items.-
RectD
andInsetsD
: Added methods toreduce
the size of anRectD
andInsetsD
instance, respectively. - The new static methods
IPositionHandler#combine
combine multiple position handler instances into a single instance. - Added the events
ElementsCopied
,ElementsCut
, andElementsPasted
toGraphEditorInputMode
, and the eventElementsCopied
toGraphViewerInputMode
. - The new static
IAnimation#createSequentialAnimation
method creates an animation that animates multiple animations in sequence. - The rectangle of the marquee selection can now be customized with the new protected method
MarqueeSelectionInputModes#calculateMarqueeRectangle
. - Added new decorator implementations for table items. You can access these new decorators via
the new method
ITable#getDecorator
with theRowDecorator
,ColumnDecorator
andStripeLabelDecorator
properties. - If the new
CanvasComponent#QuantizingInputCoordinatesEnabled
property is enabled, world coordinates of mouse events are rounded to nicer values to avoid unnecessary precision. For example, you'll get the value 326.375 instead of 326.3758109495. The rounding is chosen based on the zoom level to ensure that there is almost no visual deviation. Lower zoom levels will result in coarser rounding, higher zoom levels will use exactly as much precision as necessary. By default, this option is enabled.
Layout
-
OrthogonalLayout
: Added support for parallel routing of parallel edges (multi-edges that share the same source and target node). They are routed as parallel as possible; if there are edge labels, the routes must differ somewhat. Previously, parallel edges were not handled explicitly and their routes were often very different, making the recognition of parallel structures difficult. -
OrthogonalLayout
: Added new propertyMaximumDuration
, which enables to control the preferred time limit of the layout algorithms. -
OrthogonalLayout
: Added propertyUniformPortAssignmentEnabled
that allows to obtain results with a more uniform port assignment. -
Added convenience layout stage
TemporaryGroupNodesInsertionStage
that automatically generates a (non-nested) grouping structure from a given mapping of nodes to a component Id. This temporary grouping is meant for use during the run of the core layout algorithm of the stage. It allows, for example, easy use ofRecursiveGroupLayout
without the need for a real grouping structure when the requirement is that different sub-graphs need to be arranged with different layout algorithms. - Added the
TemporaryGroupNodeInsertionData
configuration class for the newTemporaryGroupNodeInsertionStage
layout stage. -
TreeLayout
: Added node placerCompactNodePlacer
that produces more compact tree layouts. It uses a dynamic optimization approach that chooses a placement strategy of the children such that the overall result is compact with respect to a specified aspect ratio, see propertyCompactNodePlacer#PreferredAspectRatio
. - The new
TreeLayoutData#CompactNodePlacerStrategyMementos
property can be used to to maintain similar layout styles over subsequent runs of compact tree layout. -
Added the new layout algorithm
TabularLayout
that generates simple tabular arrangements of nodes. It allows for placing nodes in rows and columns, such that each table cell contains at most one node. Among its features is, for example, a from-sketch mode, the possibility to exactly map nodes to specific cells or different vertical and horizontal alignments. - Added the
TabularLayoutData
configuration class for the newTabularLayout
algorithm. -
OrthogonalLayout
: Added support for special layout styles of various substructures that are automatically detected in the input graph. Supported substructures are trees, chains and cycles - see the according propertiesOrthogonalLayout#TreeStyle
,OrthogonalLayout#ChainStyle
andOrthogonalLayout#CycleStyle
. In addition to the style, the new feature offers more settings, like, for example, the desired tree layout orientation (seeOrthogonalLayout#TreeOrientation
). The orthogonal layout styleLayoutStyle#NORMAL_TREE
has been removed as the new tree style feature allows more settings for the arrangement of tree-like graphs. -
Added the new layout algorithm
TreeMapLayout
that generates tree maps. Tree maps present hierarchical data using nested rectangles (nodes) where each rectangle (node) gets its size depending on a specific dimension of data associated to it. - Added the
TreeMapLayoutData
configuration class for the newTreeMapLayout
algorithm. -
Polyline.EdgeRouter
now supports routing through user-specified intermediate points. All specified points will lie on the edge route in the given order. See new propertyEdgeLayoutDescriptor#IntermediateRoutingPoints
. -
Polyline.EdgeRouter
: Edges that connect group nodes with their descendants can now directly connect from the inside to the group node border. Previously, an edge needed to always leave the group node before connecting to it. The feature can be enabled/disabled individually for each edge using the new propertyEdgeLayoutDescriptor#DirectGroupContentEdgeRoutingEnabled
. -
HierarchicLayout
: Added feature that allows to define sub-components of the input graph such that each sub-component is arranged by a user-specified layout algorithm. This allows for hierarchical layouts where parts of the graph are arranged in a different fashion, e.g., to emphasize special sub-structures. The sub-components can be specified by a data provider registered with the input graph with keyHierarchicLayout.SUB_COMPONENT_ID_DPKEY
or with the newHierarchicLayoutData#SubComponents
property . -
ShortestPaths
: Added a-star (A*) algorithm for finding the shortest path between two nodes in a directed or undirected, arbitrary graph.
Improvements
Graph Model
- All methods that set a node layout or a bend location are now fail-fast if the provided layout or
location contains a
NaN
value. Previously, this resulted not in an immediate error but broke subsequent code like an automatic layout or a content rectangle calculation. - The performance of
FilteredGraphWrapper
has been improved. Now, it depends mainly on the size of the resulting filtered graph. This allows for loading very large graphs into memory and displaying only a subset of them usingFilteredGraphWrapper
. - For
ITable
's default methodsfindRow
,findColumn
,findStripe
andfindStripes
, overloads without thePredicate
parameter have been added. -
DefaultGraph
has new factory methods to customize undo unit creation. -
DefaultGraph
now fills the undo engine and triggers events in a consistent manner for all graph element factory methods. - Many label model
createParameter
methods now have overloads without those parameters that are not needed every time. InteriorStretchLabelModel
: Added new parametersCENTER_HORIZONTAL
andCENTER_VERTICAL
for horizontal or vertical centered one-line labels.- The factory method
IMapper#fromMap
has been added which returns an implementation ofIMapper
that delegates to ajava.util.Map
.
View
- The new method
GraphModelManager#getMainCanvasObject
returns the canvas object that should be used when changing the visibility or z-order of a model item. - Assigning a new graph instance to
GraphOverviewComponent
now keeps configuration changes made to the overview'sGraphVisualCreator
instance. - Selfloop edges are now properly displayed in the
GraphOverviewComponent
. - Animations after a layout don't break anymore if the graph is modified concurrently.
- Added the new
CanvasComponent#LimitingFitContentZoomEnabled
property which controls whether the maximum zoom level for theCanvasComponent#fitContent
method as well as theFitContent
command is restricted to1
or the value of theMaximumZoom
property. - Akin to the two
CanvasComponent#zoomTo
methods, there are now twoCanvasComponent#zoomToAnimated
methods that animate the viewport change. ICanvasObjectGroup#addChild
: A default method without theICanvasObjectDescriptor
parameter was added as overload which uses theICanvasObjectDescriptor#ALWAYS_DIRTY_INSTANCE
.-
GraphModelManager
now avoids unnecessary re-installation of items if they keep theirICanvasObjectGroup
. By these re-installations the z-order of the item in its group was lost and a new visual was created. - The factory method
IAnimation#createLayoutAnimation
has been added which delegates toLayoutUtilities#createLayoutAnimation
as the method is easier to find inIAnimation
. - The factory methods
IAnimation#createParallelAnimation
now takes covariant Iterables, i.e.Iterable<T extends IAnimation>
instead ofIterable<IAnimation>
. - Inertia scrolling of the viewport behaves now in a more natural way. The scrolling stops now after a fixed amount of time and we fixed several problems that caused erratic behavior.
- The stroke thickness is now considered for the calculation of the origin of the default arrow visualizations. Therefore, the visualizations no longer extend into the node bounds.
Input
- Don't run unneccessary hit tests when a mode is canceled.
- The
INode
parameter of theNavigationInputMode#enterGroup
method is now optional. If it isnull
the whole graph will be revealed. - The
CanvasComponent#createInputModeContext
method is now public instead of protected. -
ItemClickedEventArgs
now extendsClickEventArgs
and therefore provides additional information like theInputModeContext
. - The new overload of the
CreateEdgeInputMode#doStartEdgeCreation
method taking aninitialTargetLocation
parameter can be used to define the initial location that shall be used to find a target node. -
CreateEdgeInputMode
now removes coinciding bends if orthogonal edge creation is enabled. -
CreateEdgeInputMode
provides access to a dummy target node which is used during the interactive edge creation. This allows making the node visible during creation by setting a style and size. -
CreateEdgeInputMode
now supports edges ending without a valid target port candidate. This allows for creating new target nodes together with newly created edges. - The new property
CreateEdgeInputMode#PrematureEndHitTestable
allows for considering any location as valid target point for an edge. - The new
CreateEdgeInputMode#DragCursor
property specifies the cursor that is used during edge creation when no bend may be created at the current location. -
CreateEdgeInputMode
now supports showing port candidates at potential sources for edge creation, too. -
CreateEdgeInputMode
now always creates dummy ports during a gesture, instead of temporarily reusing real ports if available. This makes it possible to change e.g. the dummy edge's source port's style during the gesture. - The new
CreateEdgeInputMode#StartingOverCandidateOnlyEnabled
property can be used to restrict the start of an edge creation gesture to directly hovered port candidates. - The new protected
CreateEdgeInputMode#getSourcePortCandidates
method makes determining source port candidates more flexible. -
GraphEditorInputMode
andTableEditorInputMode
: MethodeditLabel
now also returns aFuture
, similar toaddLabel
andcreateLabel
. -
ClickInputMode
now dispatches the clicked events in the same order asGraphEditorInputMode
andGraphViewerInputMode
, i.e. the more specific eventsLeftClicked
,RightClicked
,LeftDoubleClicked
andRightDoubleClicked
are now dispatched beforeClicked
andDoubleClicked
. Hence,Clicked
andDoubleClicked
will only be triggered if the event wasn't handled before. -
TableEditorInputMode
now handles clicks similar toGraphEditorInputMode
:- New
ItemClicked
,ItemLeftClicked
,ItemRightClicked
,ItemDoubleClicked
,ItemLeftDoubleClicked
,ItemRightDoubleClicked
events are raised. - If an event is handled, its default behavior is prevented.
- The new properties
ClickableItems
andClickableRegions
determine for which items and regions a click event will be raised.
- New
- The properties
MaximumSnapDistance
,ShowingHitPortOwnerCandidatesOnlyEnabled
andVisualization
have been added toPortRelocationHandleProvider
and are applied to eachPortRelocationHandle
created by this provider. - The default value of
DefaultPortCandidate#LocationParameter
is nowFreeNodePortLocationModel#NODE_CENTER_ANCHORED
for nodes andBendAnchoredPortLocationModel#FIRST_BEND
for edges instead of a parameter of an internal model. - During interactive edge creation, the tip of a newly created edge now only snaps to valid target port candidates to create orthogonal end segments.
- Moving a node with the
MoveInputMode
for unselected nodes now moves the bends of adjacent self-loops, too. - Added overridable methods to
PortRelocationHandle
to allow customization of the port candidates. - The new
TextEditorInputMode#TextAreaPlacementPolicy
property provides finer control of what happens when theTextArea
is (partially) outside of the viewport. - The new
TextEditorInputMode#TextAreaPadding
property controls the padding between theTextArea
and the border of the canvas. - The
CanvasComponent#Mouse2DClicked
event now reports the position of the mouse down event as its location. Previously, this was the location of the up events which can be slightly different. - The new
PortRelocationHandle#Visualization
property controls how the preview during edge reconnection is handled. A new option is to change the edge during the gesture, which improves fidelity of the preview in certain cases. MoveLabelInputMode
: The visualization of a moved label has been improved. The new propertyVisualization
allows easy switching between a symbolic preview, a preview or a live view.- The following input modes now release the mutex before dispatching their final event:
-
CreateEdgeInputMode
now releases the mutex before dispatching theEdgeCreated
event. -
MoveInputMode
now releases the mutex before dispatching theDragFinished
event. -
ResizeStripeInputMode
now releases the mutex before dispatching theDragFinished
event.
-
- The new methods
findNextItem
andfindNearestItem
ofNavigationInputMode
can be used to configure the determination of the "next" item. - The type parameter
T
of classItemDropInputMode
<T> is no longer restricted toIModelItem
. - Overloads of the methods
GraphCopier#copy
andGraphClipboard#duplicate
without theIElementCopiedCallback
parameter have been added. - The new
GraphEditorInputMode#MoveUnselectedInputMode
property provides a child input mode for moving unselected items. It supersedes the previous#createMoveUnselectedInputMode
method. This input mode is disabled by default. - The static constants
SELECTED_MOVABLES_POSITION_HANDLER
andSELECTED_MOVABLES_HIT_TESTABLE
have been added toGraphEditorInputMode
. These are used as defaultPositionHandler
andHitTestable
properties ofGraphEditorInputMode#MoveInputMode
and can be reused for other input modes.
Layout
-
HierarchicLayout
: Reduced required memory for graphs with sequence constraints. -
Polyline.EdgeRouter
: Improved routing quality for edges between group nodes and their descendants in the case that the routing is aborted viaAbortHandler
or when the maximum duration time limit is up. Previously, such edges might not have been handled in this case, whereas now they always get a simple but valid orthogonal route. -
HierarchicLayout
: Improved handling of sequence and layering constraints between sub-components, seeHierarchicLayout#SUB_COMPONENT_ID_DPKEY
orHierarchicLayoutData#SubComponent
. Previously, such constraints were ignored. -
OrthogonalLayout
: Reduced the number of bends of directed edges. -
OrthogonalLayout
: Reduced number of crossings for directed edges. -
BusRouter
: Now automatically ignores non-orthogonal edges with fixed bus descriptor (seeBusDescriptor#isFixed
) or transforms them into orthogonal edges if they are octilinear. In previous versions, the layout algorithm simply throws anIllegalArgumentException
in such cases. -
OrthogonalLayout
: Improved compactness of the layout results. -
OrthogonalLayout
: Improved result of the perceived bends optimization (seeOrthogonalLayout#PerceivedBendsOptimizationEnabled
). -
OrthogonalLayout
: The postprocessing step now also applies special transformations that can reduce the overall edge length. -
MultiPageLayout
: Improved runtime as well as layout quality if the input is a tree structure and the specified#CoreLayout
is either an instance of classTreeLayout
orClassicTreeLayout
. Furthermore, propertyMultiPageLayout#AdditionalParentCount
allows for specifing the number of additional proxies that the algorithm tries to add to a subtree. The original nodes associated with these proxies lie on the path of the tree's root to the subtree placed on a page. -
MultiPageLayout
: Added property#ProxyReferenceNodeCreationEnabled
that allows for disabling the creation of proxy reference nodes as well as property#MultipleComponentsOnSinglePagePlacementEnabled
that allows to prevent that elements of different connected components are placed on the same page. -
PortPlacementStage
now additionally considers port grouping constraints. If two edges are port-grouped at a certain node, the stage assigns the same port location to the edges. For more information about port grouping, seePortConstraintKeys#SOURCE_PORT_GROUP_ID_DPKEY
andPortConstraintKeys#TARGET_PORT_GROUP_ID_DPKEY
. -
TreeComponentLayout
: Added propertyUndirectedTreeConsiderationEnabled
that allows for specifing whether or not undirected tree structures should be handled or not. Previously, only directed tree structures were considered. -
OrthogonalLayout
: Reduced the length of straight-line edges which can lead to layouts that are significantly more compact. -
OrthogonalLayout
: Improved optimization that reduces the number of perceived bends, seeOrthogonalLayout#PerceivedBendsOptimizationEnabled
. -
HierarchicLayout
: Fixed problem that sometimes caused an unnecessarily large distance between adjacent layers. -
Added new stage
PlaceNodesAtBarycenterStage
that places a user-specified subset of nodes on the barycenter of their neighbors. During the core layout, these node are hidden. -
DefaultNodePlacer
andSimpleNodePlacer
now both support to specify a minimum distance between the edge segments that are routed orthogonally in the channel between the root node and the child nodes, see methodDefaultNodePlacer#MinimumChannelSegmentDistance
andSimpleNodePlacer#MinimumChannelSegmentDistance
respectively. -
ClassicTreeLayout
now allows for specifying a minimum vertical distance for the horizontal edge segments of the bus, seeClassicTreeLayout#MinimumBusSegmentDistance
. -
Major performance improvement for
Polyline.EdgeRouter
and routing scenarios where it is unavoidable to cross obstacles (e.g. other nodes, labels) in order to reach the target, including cases where a crossing is necessary to guarantee that port candidates/constraints at the target side are satisfied. -
Polyline.EdgeRouter
: Improved quality in maze routing scenarios. Previously, it could happen that edge-node overlaps occurred even though there exists a more complicated path that yields no overlaps. -
Several minor performance improvements for
Polyline.EdgeRouter
that affect the path search phase as well as the segment location assignment phase. - The new
TreeLayoutData#CriticalEdgePriorities
property can be used to specify critical edges. - The new
LayoutExecutor#createLayoutGraphAdapter
callback method makes it possible to configure theLayoutGraphAdapter
that is used for the layout calculation. -
SmartEdgeLabelModel
now is properly handled by labeling algorithms, resulting in better label placements. - The new
ImprovingPortAssignmentEnabled
property ofLayoutExecutor
andLayoutGraphAdapter
enablesPortCalculator
to improve the port assignment. - The combination of
PartitionGridData
andTableLayoutConfigurator
has been improved:-
PartitionGridData
now reuses thePartitionGrid
created by theTableLayoutConfigurator
. - Several methods have been added to
TableLayoutConfigurator
which provide access to thePartitionCellId
assignment of the configurator as well as the mappings betweenIRow
/IColumn
andRowDescriptor
/ColumnDescriptor
.
-
- The new properties
LayerConstraints
andSequenceConstraints
ofHierarchicLayoutData
can be used to configure layer and sequence constraints for theHierarchicLayout
. These supersede the previousLayerConstraintFactory
andSequenceConstraintFactory
properties. - The property
ItemMapping#Map
has been added that allows you to use ajava.util.Map
for the mapping from items to values.
Demos
- A new
LargeGraphsDemo
has been added that shows some strategies how to keep a smoothUI
when large graphs shall be visualized. - The new
GraphBuilderDemo
andInteractiveNodesGraphBuilderDemo
have been added that demonstrate basic usage of yFiles' newGraphBuilder
classes. - A new
CustomPortModelDemo
has been added that shows how to create and use a customIPortLocationModel
.
Further improvements
- The
PointD#toMutablePoint
andRectD#toMutableRectangle
methods now return aMutablePoint
instead ofIMutablePoint
and aMutableRectangle
instead of aIMutableRectangle
, respectively. - The new method
GeneralPath#intersects(GeneralPath)
determines whether the path intersects with anotherGeneralPath
. - The
GeneralPath#createSmoothedPath
method now has additional parameters to change how smoothing is applied. Those new options result in nicer smoothing when combined with large smoothing lengths and many different segment lengths in the path. - When reading GraphML with the deserialization property
IgnoreXamlDeserializationErrors
enabled, invalid property content is now skipped instead of discarding the whole object with such content. - Added a
remove
method toNodeDecorator
,LabelDecorator
,EdgeDecorator
,PortDecorator
, andBendDecorator
for easy removal of decorations. -
PolylineEdgeStyle
renders better looking paths for self loop edges whose ports are near the node border. - The performance of the
DefaultLabelStyle
has been improved. Using anotherVisualCachingPolicy
thenVisualCachingPolicy#Never
now also speeds up theDefaultLabelStyle
. - The class
CanvasResourceBundle
has been added which can be used to replace the default command binding key strokes and command names viaResourceBundles
. - The new class
LicenseConfig
has been added whose staticINSTANCE
can be optionally used to configure the license resolving:- If the content of the license file is set as
LicenseString
property, it is used directly instead of trying to load a license file. - Otherwise if the
LicenseClassLoader
property is set, thisClassLoader
is used to load the license file.
- If the content of the license file is set as
- The
PlatformClassloader
introduced withJDK 9
is now recognized per default when writing GraphML. ForJDK
classes ofJDK 9
that are no longer known to the bootstrap classloader but only to the platform classloader no explicitXamlNamespaceMapping
has to be added toGraphMLIOHandler
.
Bugfixes
Graph Model
- The
SmartEdgeLabelModel#findBestParameter
method returned a parameter that was centered on the edge even if the desired label layout overlapped only a little bit with an edge segment or was directly aside of one. - The graph of an
IFoldingView
now raises theNodeCreated
,EdgeCreated
,PortAdded
,LabelAdded
, andBendAdded
events after the created element is registered. This fixes a bug where the master item of the created item was not available in handlers for these events. Table
: The methodssetLabelText
,remove
,setLabelPreferredSize
andsetLabelLayoutParameter
now throw anIllegalArgumentException
instead of anInvalidStateException
.-
DefaultGraph
now calls theonRemovingEdge
andonRemovingPort
methods before their incident items are removed. - When a stripe is removed,
ITable#LabelRemoved
events for the implicitly removed associated labels are now raised, too. - The implementations of
IStripeHitTestHelper
andIBoundsProvider
in the lookup of anIStripe
could neither be decorated nor overridden by the context lookup provided by a stripe style. - The
INodeInsetsProvider
implementations which can be retrieved fromInteriorLabelModel
andInteriorStretchLabelModel
now correctly sum up the space required by overlapping labels.
View
- The methods
getBounds
andisVisible
describing theRectangleIndicatorInstaller
returned wrong values. This could impact the performance as e.g. some node selection highlights were updated although they were not in the view port and result in unnecessary large content rectangles. GraphModelManager
: FixedNullPointerException
that occured when any of the Descriptor properties were set while theGraphModelManager
instance was not yet associated to anIGraph
.- Bridges: For edges which cross each other with the same absolute slope now a bridge is added on exactly one of these edges, depending on the crossing policy (was: either on both edges or none of them).
- Reduced memory consumption of
DefaultEdgePathCropper
. - Removing an item that is currently highlighted with a custom
HighlightIndicatorManager
,FocusIndicatorManager
, orSelectionIndicatorManager
no longer results in aNullPointerException
. - Selected stripe labels no longer remain selected after their owning stripe is deleted.
- Selected stripe labels no longer cause exceptions when hovering over them.
- The selection indicator for selected stripe labels is now shown correctly.
- The methods
GraphClipboard#copy
andGraphClipboard#cut
don't copy items anymore which depend on items that are selected but not included inGraphClipboard#CopyItems
. - Undo units created by the execution of a layout algorithm are now correctly merged with undo units of the previously executed interactive gesture.
- Corrected weird scrolling behavior of the scroll bar when the viewport was outside the content rectangle.
- The commands
COPY
,CUT
, andDUPLICATE
are no longer enabled if there are no elements to cut, copy or duplicate. - Fixed a bug that sometimes prevented dispatching the mouse up event.
-
CanvasComponent#fitContent
now takes into account that scroll bars that are currently visible may vanish. - Mouse wheel scrolling and scroll commands no longer move the view to the top left corner if a the
viewport is limited by a
ViewportLimiter
. - Bridges did sometimes not appear on edges when they were scrolled into the viewport.
Input
-
PortRelocationHandleProvider
now can handlenull
asgraph
constructor parameter. -
PortRelocationHandle#GHOST_VISUALIZATION_PEN_KEY
now is excluded from obfuscation. - Fixed
IHitTestable
implementation ofDefaultPortCandidateDescriptor
which used incorrect coordinates. - The
ParentInputMode
property of theInputModeEventArgs
now is the input mode which has raised the event. Previously, some input modes erroneously set theParentInputMode
to the containingGraphEditorInputMode
orGraphViewerInputMode
. - Switching the input mode in an event handler of the current input mode no longer throws an exception.
-
ItemHoverInputMode
updates the hovered item upon mouse drag events, too. This is the documented behavior. Previously, the hovered item was only updated on mouse move events. -
ItemHoverInputMode
removes the hovered item uponcancel
. GraphClipboard
: The contents of a folder node was not copied if the folder was copied from within a group view, i.e. if the user entered a group node. In the worst case, this might have frozen the complete application.- Fixed an exception when an edge or label is pasted without selected target while its original owner is not in the current view.
-
ClickInputMode
provided wrong click locations in theClicked
event if aMouse2DEventTypes#CLICKED
event without precedingMouse2DEventTypes#PRESSED
event was processed. -
CreateEdgeInputMode
andCreateBendInputMode
now cancel onMOUSE_LOST_CAPTURE_DURING_DRAG
event. -
CreateEdgeInputMode
did not show port candidates after re-installation of the input mode. - Moving an edge label with
SmartEdgeLabelModel
that is owned by an edge without visible path no longer throws an exception. -
ItemHoverInputMode
now resets the hovered item when moving the mouse out of the component. -
GraphEditorInputMode
andGraphViewerInputMode
no longer ignore changes to their sub-input modes after having been installed once. - The
HitTestRadius
property of the following implementations ofICanvasContext
now correctly contain the value in world coordinates instead of view coordinates:- The context created by
ICanvasContext#create
when passing aCanvasComponent
but no hit test radius. - The context passed to
IDisposeVisualCallback
. - The context passed to
IPositionHandlers
byMoveInputMode
. - The context passed to adjacent handles when moving a bend handle.
- The context created by
- Disabling
MarqueeSelectionInputMode
during the gesture via code left the marquee visible on the screen. - When a selected stripe label is edited its
TextArea
now is correctly placed. - While relocating edges, dropping a port over an invalid target or empty canvas no longer creates an empty undo unit.
- The
Clicked
andDoubleClicked
events ofClickInputMode
were sometimes missing when clicking on a node or edge. Now, they are always triggered unless the event was handled before. - Snap lines which indicate the same size are no longer shown for implicitly re-sized parent group nodes.
TextEditorInputMode
: Inserting a line break now replaces selected text.- Node-to-edge snapping is now disabled by default which is the documented and intended value.
For this, the initial value of the
GraphSnapContext#NodeToEdgeDistance
property is set to-1.0
. - The
LabelEditingEventArgs#Context#ParentInputMode
property provided in the eventsGraphEditorInputMode#LabelAdding
,GraphEditorInputMode#LabelEditing
,TableEditorInputMode#LabelAdding
andTableEditorInputMode#LabelEditing
now contains the correspondingGraphEditorInputMode
orTableEditorInputMode
instance. - The default implementation of
IPortSnapResultProvider
never returned any snap results. CreateEdgeInputMode
: TheValidBeginCursor
is now correctly hidden during edge creation when bend creation isn't allowed.-
CreateEdgeInputMode
didn't always update the highlight of possible source port candidates when itsShowPortCandidates
property was configured to show the source port candidates. GraphEditorInputMode
/GraphViewerInputMode
: Corrected the popup menu location if the menu is opened using the keyboard. Previously, the menu could appear outside theGraphComponent
if the selected items or the current item were not completely inside the current viewport. Now the popup menu location (i.e. the menu's upper left corner) will be always inside theGraphComponent
.ReparentStripePositionHandler
: The source and target ghost visualization was not always updated correctly when custom ghosts were used.- Changing the values of the
CreateEdgeInputMode#DummyEdgeGraph#EdgeDefaults
property had no effect for some interactions. - Fixed a possible infinite loop in
OrthogonalEdgeHelper
. - The cursor is now correctly reset after editing an orthogonal edge.
- Fixed a possible
NullPointerException
which could occur in customizedLabelDropInputMode
andPortDropInputMode
classes. - The
CreateEdgeInputMode
doesn't show port candidates anymore if bend creation is enforced (by pressingCTRL
key during edge creation). - The indicators for bend grid snapping were not always drawn at the correct position for bends which were implicitly moved with a selected edge.
Layout
-
HierarchicLayout
: Fixed problem where edges between group nodes contained superfluous bends if there were grouped edges in the input graph. -
Polyline.EdgeRouter
: Fixed issue that sometimes caused weird edge routes if there are edges with intermediate routing points. -
Polyline.EdgeRouter
: FixedNullPointerException
that was triggered when the list of intermediate points for an edge consisted of exactly two equal points. -
OrganicLayout
: FixedIllegalArgumentException
that could appear if cycle substructure detection is enabled, seeOrganicLayout#CycleSubstructureStyle
. -
HierarchicLayout
: Fixed an issue that caused non-symmetric results for grouped edges even though propertySimplexNodePlacer#BaryCenterModeEnabled
was enabled. -
OrthogonalLayout
: Fixed rare infinite loop issue for grouped graphs. -
Polyline.EdgeRouter
: Fixed rareNullPointerException
. -
Polyline.EdgeRouter
: FixedNullPointerException
that occurred when there were intermediate routing points and the path search got aborted (e.g. because of maximum duration time limit). -
ShortestPaths
: Fixed possibleNullPointerException
that occurred when the a-star algorithm was applied to a graph with non-monotonic heuristic costs. -
HierarchicLayout
: FixedUnsupportedOperationException
that was triggered when aDataProviderAdapter
that does not implementIDataProvider#get
was registered with keyGivenLayersLayerer#LAYER_ID_DPKEY
. The issue only appeared in conjunction with sub-components, seeHierarchicLayout#SUB_COMPONENT_ID_DPKEY
. -
FamilyTreeLayout
: Fixed bug that caused that the preferred family member order wasn't considered, seeFamilyTreeLayout#FamilyMembersSortingPolicy
. -
GenericLabeling
: Fixed bug that could cause that a label candidate with a lower profit (seeAbstractLabeling#Profit
) was preferred over another candidate with higher profit even though both candidates did not overlap with any other elements. -
GenericLabeling
: Fixed unexpected labeling results that occurred if a label had label candidates with different sizes. The labeling algorithm previously calculated profits of candidates under the assumption that all candidates have equal size. -
HierarchicLayout
: Fixed rare infinite looping issue for input graphs with fixed (i.e., non-incremental) nodes and layering constraints. -
Polyline.EdgeRouter
: Fixed a rare bug that caused port candidate failures for edges grouped with fixed edges. -
Polyline.EdgeRouter
: Fixed a bug that caused collinear bends and self-crossings to be removed from fixed edges. Now, such fixed edges are not changed anymore. -
HierarchicLayout
: Fixed bug that sometimes caused aNullPointerException
if the input graph contains port groups, seePortConstraintKeys#SOURCE_PORT_GROUP_ID_DPKEY
andPortConstraintKeys#TARGET_PORT_GROUP_ID_DPKEY
. -
HierarchicLayout
: Fixed bug that sometimes caused superfluous bends if the edges were routed on a grid and the grid reference point was different from(0,0)
, see propertyNodeLayoutDescriptor#GridReference
. -
GraphLayoutLineWrapper
: Fixed bug that sometimes caused a large empty space inside the drawing. -
CircularLayout
: Now correctly considers whether or not an inter-partition edge should be bundled or not (seeEdgeBundleDescriptor#isBundled
). Previously, when having multiple partitions, inter-partition edges where sometimes bundled even if the bundling property was disabled. -
HierarchicLayout
: Fixed a bug where the edge thickness of grouped edge segments was not considered correctly (e.g. there was not enough space for a thick edge). -
BusRouter
: Fixed non-deterministic behavior with respect to multiple runs that occurred in very rare cases. - Corrected an error in the
Rectangle2D#Contains(Rectangle2D)
method. As a consequence of this error, the results of various algorithms and automatic layouts could have been wrong. -
OrthogonalLayout
now considers edge grouping also if there are no directed edges specified.
Further Bugfixes
-
GenericLabelModel
serialization: Fixed cyclic reference in GraphML which could happen while serializing aGenericLabelModel
with a parameter with associated descriptor. -
PolylineEdgeStyle
now takes arrow heads into account for visibility checks. - The default method
IOrientedRectangle#getCenter
didn't return the correct center if the width or height of the rectangle was equal to 0. - Sometimes the
GroupNodeDefaults#LabelDefaults#AutoAdjustingPreferredSizeEnabled
property and theGroupNodeDefaults#PortDefaults#AutoCleanupEnabled
property were not considered for labels and ports of groups. - The
GroupingSupport#hasGroupNodes
method now returns only true if there are actually group nodes in the graph. Previously, it returned also true if there once were group nodes which had been removed in the meantime. TableNodeStyle
: Fixed missing default visualization.- Fixed a possible
NullPointerException
inTableNodeStyleRenderer
when aTableNodeStyle
is rendered with#Table
set tonull
. - The
clone
method now is overridable in all style implementations.
Incompatible Changes
ReparentStripePositionHandler
: All callback methods dealing with ghost objects have been renamed consistently:UpdateXyzVisualization
toUpdateXyzGhost
.UpdateTargetVisualizationBounds
toUpdateTargetGhostBounds
.
- The method
Arrow#getAsFrozen
was removed as there was no benefit in converting the Arrow instance in an immutable instance. - The protected factory method
MoveLabelInputMode#createLabelHitTestable
has been removed. Developers who want to set a custom instance need to set it directly to theHitTestable
property. - The
#CanvasClicked
event ofGraphEditorInputMode/GraphViewerInputMode
now provides theGraphEditorInputMode/GraphViewerInputMode
as parent input mode in theContext
property of itsClickEventArgs
. - The
ITable#RelativeLocation
property has been removed. UseITable#Insets
with correspondingLeft
andTop
values instead. - Renamed all occurrences of
Cleanup
toCleanUp
in API names. -
ItemClickedEventArgs
now extendsClickEventArgs
. CreateEdgeInputMode
'sEdgeCreator
might receivenull
astargetPortCandidate
parameter. Callbacks must handle this case by either creating a target port of their own or canceling the edge creation by returningnull
.- The
StripeSubregion#TargetTableNode
property is now read-only. - Renamed the enumeration value
ShowFocusPolicy#WHEN_FOCUSED
toONLY_WHEN_FOCUSED
. - Renamed the
Animator#destroy
method tostop
. - The
GraphEditorInputMode#createMoveUnselectedInputMode
method has been removed. Use the propertyMoveUnselectedInputMode
instead. - The
boolean
CreateEdgeInputMode#PortCandidateShowingEnabled
property has been replaced by theCreateEdgeInputMode#ShowPortCandidates
property which has the enum typeShowPortCandidates
. - The
boolean
OverviewInputMode#AutoMouseWheelZoomEnabled
property has been replaced by theOverviewInputMode#MouseWheelBehavior
property which has the enum typeMouseWheelBehaviors
. - Classes
PropertyInfo
,TypedKey
,XamlHelper
andXmlName
were removed from the layout distribution where they were not used. CanvasComponent
: Removed the eventsMouseWheelZoomFactorChanged
,MouseWheelScrollFactorChanged
,AutoDragChanged
andHitTestRadiusChanged
. These events are unneeded since the corresponding properties are not changed by library code.- The method
Pen#adopt
has been renamed to#commit
to better reflect what it really does. DpKeyBase
has been renamed toAbstractDpKey
and made an abstract class.AbstractDpKey
and all subclasses now take the value type as additional constructor parameter. This value type may be retrieved through read-only propertyValueType
.IMapperRegistry
: The value type parameter was removed from all default methods takingNodeDpKey
,EdgeDpKey
orILabelLayoutDpKey
.MoveViewportInputMode
: The properties that controlled the inertia behavior have been removed since they no longer apply to the new algorithm. Instead, the new propertyInertiaDuration
can be used to specify the duration of the inertia scrolling.-
GraphModelManager#HierarchicNodeNestingEnabled
has been removed. Set the newHierarchicNestingPolicy
property toHierarchicNestingPolicy#NONE
to disable node nesting or to eitherHierarchicNestingPolicy#NODES
orHierarchicNestingPolicy#NODES_AND_EDGES
to use nesting. Similarly,GraphModelManager#HierarchicEdgeNestingEnabled
has been removed. Use eitherHierarchicNestingPolicy#NODES_AND_EDGES
to enable edge nesting or any other policy to disable it. - The method
CanvasComponent#animateScrollTo
has been removed and is superseded by the new#zoomToAnimated
methods. -
The property
SliderEdgeLabelLayoutModel#AutoFlipping
has been renamed to#AutoFlippingEnabled
. -
The property
TableLayoutConfigurator#Compaction
has been renamed to#CompactionEnabled
. -
The property
GraphPartitionManager#FiringGraphEventsEnabled
has been removed. -
The overloads of
ValueSerializer#getSerializerFor
taking no context have been removed. -
The class
com.yworks.yfiles.layout.hierarchic.GroupingSupport
has been removed.
Changes of Default Behavior
- The
IGraph#setNodeLayout
method and the various methods to create a node now throw anIllegalArgumentException
if the layout rectangle contains one or moreNaN
values. Similarly, theIGraph#setBendLocation
and the various methods to add a bend to an edge now throw anIllegalArgumentException
if the location point contains one or twoNaN
values. - By default, stripe labels that are programmatically selected or highlighted don't show a selection or highlight indicator anymore.
- Inertia scrolling of the viewport behaves now in a more natural way. The scrolling stops now after a fixed amount of time. Previously, the duration depended on the initial inertia velocity.
- GraphML: Duplicate properties on XAML input are now considered an error in accordance with the XAML specification.
- The stroke thickness is now considered for the calculation of the origin of the default arrow visualizations. This can result in a slightly different rendering of the arrows.
- The
CreateEdgeInputMode#DummyEdge
property is now always reset after the edge creation was finished or canceled. -
RectD#isFinite
andSizeD#isFinite
now also consider empty instances as not finite. MoveLabelInputMode
: The moved label now is visualized as a preview instead of a symbolic rectangle. Set theVisualization
property toVisualization#GHOST
to restore the old mode.- The
LayoutExecutor#ContentRectUpdatingEnabled
property is now enabled by default. CreateEdgeInputMode
: The determination whether the mouse hovers over a valid end has changed. IfForcingSnapToCandidateEnabled
is disabled, theEndHitTestable
now is queried first and a target port candidate is only searched if the hit testable returnstrue
. Previously, the hit testable was only queried if no target port candidate was found at the current location.- Previously, even if the
GraphModelManager#UsingHierarchicEdgeNestingEnabled
property was set totrue
, canvas objects for edges were added to theGraphModelManager#EdgeGroup
as long as no group nodes were part of the graph. The corresponding newHierarchicNestingPolicy
NODES_AND_EDGES
has no such behavior and thus,EdgeGroup
is empty by default. Use one of the other polices if canvas objects for edges should be part ofEdgeGroup
. -
PolylineEdgeStyle
defaults to an improved smoothing algorithm when using theSmoothingLength
property. This is especially apparent when using large values forSmoothingLength
. - The method
CollapsibleNodeStyleDecorator#createSelectionInstaller
has been removed. -
ClickInputMode
now dispatches the more specific eventsLeftClicked
,RightClicked
,LeftDoubleClicked
andRightDoubleClicked
before the generalClicked
andDoubleClicked
events. Hence,Clicked
andDoubleClicked
will only be triggered if the event wasn't handled before.
Deprecated
- The properties
LayerConstraintFactory
andSequenceConstraintFactory
ofHierarchicLayoutData
have been marked as deprecated. The new propertiesLayerConstraints
andSequenceConstraints
should be used instead. Similarly, the factory methodsLayoutUtilities#createLayerConstraintFactory(IGraph)
andLayoutUtilities#createSequenceConstraintFactory(IGraph)
have been marked as@Deprecated
. -
PartitionGrid#hasAtLeastTwoNonEmptyRows
has been marked as@Deprecated
and may be removed in future releases.
yFiles for Java (Swing) 3.1.0.1
Improvements
Demos
-
Added new demos:
-
The
GraphEvents
demo can be used to explore the different kinds of events dispatched by yFiles for Java. -
The
IsometricDrawing
demo displays graphs in an isometric fashion to create an impression of a 3-dimensional view. -
The
EdgeBundling
demo shows how to reduce visual clutter through edge bundling. -
The
Uml
demo shows interactive creation and editing of UML class diagrams.
-
The
-
PDFImageExportDemo
,SVGImageExportDemo
andSVGNodeStyleDemo
: Made the build scripts Java 9 ready.
Viewer
- Improved general rendering performance, which especially affects large graphs dramatically.
-
GridVisualCreator
now respects the clip of the render context passed to its#createVisual
and#updateVisual
methods. -
IArrow#CIRCLE
now uses a real circle for rendering. -
Removed unusable
SnapLine
resource keys fromCanvasComponent
's client properties.
Bugfixes
Viewer
-
GraphEditorInputMode
andGraphViewerInputMode
no longer ignore changes to the sub-input modes exposed as properties after having been installed once. -
Fixed a bug in
CanvasComponent
that moved the viewpoint too much when changing the zoom property. -
Fixed a bug in GraphML serialization that always looked for singletons on classes that were annotated with
@GraphML
even if theGraphML#singletonContainers
property was not set. -
TextEditorInputMode
: The size calculation for the editing#TextArea
was fixed to respect all properties of the#TextArea
. -
TextEditorInputMode
: UsingENTER
as#LineBreakRecognizer
no longer results in two new lines each timeENTER
is pressed. -
Fixed a bug that might occur when changing wrapped styles in
CollapsibleNodeStyleDecorator
,ShadowNodeStyleDecorator
,FixedShapeShadowNodeStyleDecorator
andNodeStylePortStyleAdapter
. -
DefaultLabelStyle
: Fixed line breaks when text wrapping is enabled. -
Added missing Obfuscation annotation for
DashStyle
constants. - Fixed serialization of shared collection resources.
- Fixed parsing of font style constants of GraphML files written with yFiles for Java 3.0.
-
DefaultLabelStyle
: Fixed#updateVisual
to take all style properties into account when determining whether or not the visualization has to be re-created. -
AbstractJComponentStyle
: Fixed a bug that prevented serialization of the#ContextLookup
property after obfuscating the library. -
XmlWriter
: Fixed JDK 9 only additional, undesired whitespace when writingCData
nodes. -
Several context implementations throughout the library now use the correct value in world coordinates for the
HitTestRadius
property instead of view coordinates:- The context created by
ICanvasContext.createCanvasContext
when passing aCanvasComponent
, but no hit test radius. - The
IRenderContext
passed toIDisposeVisualCallback
. - The
IInputModeContext
passed toIPositionHandlers
byMoveInputMode
. - The
IInputModeContext
passed to adjacent handles when moving a bend handle.
- The context created by
-
InteriorStretchLabelModel#getMinimumNodeSize
now uses the correct insets for width calculation. Previously the top insets were erroneously used for the width. -
The
NodeStyleStripeStyleAdapter#updateVisual
method always created a new visual by delegating to the#createVisual
method. - Mouse wheel zoom during an input gesture no longer results in incorrect coordinates for the subsequently dispatched mouse event.
-
Switching the
GraphComponent
's#InputMode
in a key event handler no longer throws an exception. -
MapperRegistry#addMapper
no longer throws an exception when trying to replace a mapper for an existing key. -
Labels with
NinePositionsEdgeLabelModel
now disappear when the owner edge has no visible edge path. This can happen for example when nodes are moved onto each other. Previously they appeared at unexpected locations, including the origin (0,0) and the upper left corner of the source node. -
GeneralPath#getTangent
now returnsnull
if there is no tangent at the requested position. Previously, it returned a bogus tangent. -
FreeLabelModel#INSTANCE
,FreeEdgeLabelModel#INSTANCE
, andFreeNodeLabelModel#INSTANCE
are now serialized correctly to GraphML when not used as part of their parameters (e.g. withinCompositeLabelModel
). -
Fixed an unnecessary exception in
IGraph#calculateLabelPreferredSize
which was thrown when the label owner was not part of the graph, but all optional parameters have been passed anyway. In that case there was no need to fetch the appropriateLabelDefaults
and thus the question of whether the owner is in the graph or not is irrelevant. - During reparenting, the edges at reparenting nodes were drawn below the group(s) and thus they were not visible. If reparenting was canceled, these edges stayed behind the group(s) and remained invisible.
-
CreateEdgeInputMode
did not always start correctly for quick gestures on slow devices. -
CreateEdgeInputMode
did not trigger the#EdgeCreationStarted
event for programmatic initialization of the edge creation gesture. -
HandleInputMode
's#CurrentHandle
property could not always be obtained during the#DragFinished
,#DragFinishing
,#DragCanceling
, and#DragCanceled
events ofHandleInputMode
. -
Setting
CreateEdgeInputMode
's#CancelRecognizer
could potentially get the input mode into a broken state. -
The
ICommand#COPY
command is no longer executed twice. -
Fixed a bug in
ViewportAnimation
that sometimes moved the viewport a bit before the animation started. -
Fixed an exception in
DropInputMode
which occurred if a drag enter was recognized while another drag action was still running. -
CreateEdgeInputMode
no longer fires gesture cancel events if it has not been started before. -
StripeDropInputMode
no longer calls#ItemCreator
twice. -
The
StripeDropInputMode#ItemCreated
event was not raised. -
GeneralPath#isVisible
often returned true for invisible paths. -
UndoEngine
now uses the end time of the previous undo unit for automatic bracketing instead of the start time. This improves auto-bracketing to work as intended for undo units spanning a time greater than#AutoMergeTime
.
Layout
-
Corrected an error in the
Rectangle2D#contains(Rectangle2D)
method. As a consequence, the results of various algorithms and automatic layouts could have been wrong. -
PortPlacementStage
: Fixed bug that causedNullPointerException
when the ports of edges in the input graph were outside the node bounds. -
BusRouter
: Fixed rareNullPointerException
that could be triggered if there are buses with both fixed and movable edges at the same time. -
AbstractLabelLayout
: Fixed bug that the box returned byAbstractLabelLayout#BoundingBox
was not consistent with the bounding box of the oriented box (AbstractLabelLayout#OrientedBox
). This was the case when the mutable oriented box instance was changed. -
LayeredNodePlacer
: Fixed bug that caused node-edge overlaps for some configurations. -
MultiPageLayout
: Fixed bug that edge typeEdgeType#PROXY
was never used. -
Setting
PartialLayout#EdgeRoutingStrategy
toStraightLine
erroneously rerouted all edges in the graph instead of just the ones that were required. -
polyline.EdgeRouter
: FixedRuntimeException
that could be triggered when the graph contained fixed edges (seeEdgeRouter#SphereOfAction
) with very short segments. -
HierarchicLayout
: FixedIllegalArgumentException
that could be triggered when the user specified both edge directedness (seeHierarchicLayout#EDGE_DIRECTEDNESS_DPKEY
) and layering constraints. -
OrthogonalLayout
: Fixed rare bug that caused node-edge overlaps. -
HierarchicLayout
andSimplexNodePlacer
: Fixed rareIllegalArgumentException
that could be triggered when the input graph had a partition grid andPortCandidate
s orPortConstraint
s. -
OrganicRemoveOverlapsStage
: Improved adherence to the specified maximum duration. -
HierarchicLayout
: Improved port assignment for edges incident to group nodes that are routed directly (seeEdgeLayoutDescriptor#DirectGroupContentEdgeRouting
). Previously, such edges were often reversed. -
HierarchicLayout
: Fixed bug that caused violation of specifiedPortCandidate
s of edges with labels with preferred placement specifierLabelPlacements#AT_SOURCE_PORT
orLabelPlacements#AT_TARGET_PORT
when using an orientation other than top-to-bottom. -
SeriesParallelLayout
: Fixed bug that caused misplaced edge labels for graphs containing only a single edge. -
HierarchicLayout
: Improved adherence to the specified maximum duration by applying a suitable runtime restriction to classPortCandidateOptimizer
. Previously, this class didn't have any runtime restrictions. -
OrthogonalLayout
: Fixed rare bug that caused overlapping nodes. -
OrthogonalLayout
: Improved from-sketch mode (seeUseSketchDrawing
) in conjunction with node labels or node halos. Previously, in the presence of the mentioned elements, the layout results did not always correctly resemble the sketch drawing, even if it was a good sketch. -
HierarchicLayout
: Fixed bug that caused that propertyHierarchicLayout#ComponentArrangementPolicy
was not correctly considered when there are undirected edges (seeHierarchicLayout#EDGE_DIRECTEDNESS_DPKEY
). -
HierarchicLayout
: Fixed bug that lead to edge ports lying outside the node boundaries when using the edge thickness feature (i.e. edges with thickness greater than zero, seeHierarchicLayout#EDGE_THICKNESS_DPKEY
) together with a (rather large) grid spacing value and the default port assignmentPortAssignmentMode#DEFAULT
. -
HierarchicLayout
: Fixed bug that caused unnecessarily large layer distances in case that there exist empty partition grid rows with a minimum row height. -
HierarchicLayout
with partition grid: Fixed bug that in some cases caused anIllegalArgumentException
when the layout algorithm was configured to stop after the layering or sequencing phase (seeHierarchicLayout#StopAfterLayeringEnabled
andHierarchicLayout#StopAfterSequencingEnabled
). -
DefaultNodePlacer
: Fixed bug inDefaultNodePlacer#MinimumLastSegmentLength
that caused that the value ofDefaultNodePlacer#MinimumFirstSegmentLength
was returned. -
TreeLayout
: Fixed bug inDefaultPortAssignment
that caused a memory leak. -
TreeLayout
: Fixed bug in the integrated edge labeling feature that caused that multiple edge labels were not always ordered correctly along the edge with respect to their preferred placement setting (i.e., place at source, center or target preference). For example, a source label should always come before a target label in the direction of the actual edge flow. -
polyline.EdgeRouter
: Fixed bug that sometimes caused a violation of the minimum first or last segment length if they were set to relatively large values. -
OrthogonalLayout
: Fixed rare bug that caused non-orthogonal line segments and bad edge end points.
Incompatible Changes
View
-
CreateEdgeInputMode
now triggers theEdgeCreationStarted
event for programmatic edge creation with thedoStartEdgeCreation
method.
yFiles for Java (Swing) 3.1
General Improvements
- The naming of classes, members and parameters has been reviewed and now uses more consistent and intuitive names. Please consult the Developer's Guide for a complete list of renamings.
- Some functionality has been removed from the API to reduce its complexity and some of the functionality has been moved to different classes or packages. Again, see the Developer's Guide to get a full list of moved/removed functionality.
Features
Layout
-
HierarchicLayout
: Added support for port grouping, seePortConstraintKeys#SOURCE_GROUP_ID_DPKEY
andPortConstraintKeys#TARGET_GROUP_ID_DPKEY
. Edges are bundled at their ports, but routed independently. -
HierarchicLayout
now allows to specify the directedness of edges, seeHierarchicLayout#EDGE_DIRECTEDNESS_DPKEY
. This new feature enables to, for example, support mixed graphs that contain both directed and undirected edges: While for directed edges the layering step tries to find a solution where the source of an edge is placed above the target (with respect to the main layout direction), for undirected edges the direction doesn't matter and the edge may also be inserted as same-layer edge. This feature also enables to force some edges to specifically point against the main layout direction. -
HierarchicLayout
: Added support for edges with a specific thickness. Minimum distances in the layout will consider these thicknesses, seeHierarchicLayout#EDGE_THICKNESS_DPKEY
. -
LabelPlacements
: Added preferred placement specifiers#AT_SOURCE_PORT
and#AT_TARGET_PORT
for edge labels which express that the label should be placed directly at the source/target port of the edge. Currently, the specifiers are only considered by the integrated labeling of theHierarchicLayout
and can be specified with propertyPreferredPlacementDescriptor#PlaceAlongEdge
. -
OrganicLayout
now supports the detection of regular substructures in the graph (see methods#setChainSubstructureStyle(ChainSubstructureStyle)
,#setStarSubstructureStyle(StarSubstructureStyle)
,#setCycleSubstructureStyle(CycleSubstructureStyle)
, and#setParallelSubstructureStyle(ParallelSubstructureStyle)
and applies a specific layout style to them such that they can be better recognized. -
TreeReductionStage
: Added possibility to specify a custom labeling algorithm that places labels of non-tree edges. Now, users do not need to take care of such edge labels themselves after using a tree layout algorithm on a non-tree input graph in conjunction with the reduction stage. See properties#NonTreeEdgeLabelingAlgorithm
and#NonTreeEdgeLabelSelectionKey
. -
SeriesParallelLayout
: Added possibility to specify a custom labeling algorithm that places labels of non-series-parallel edges. Such labels are now automatically handled. Users do not need to handle them after running the algorithm with a non-series-parallel input graph. See properties#NonSeriesParallelEdgeLabelingAlgorithm
and#NonSeriesParallelEdgeLabelSelectionKey
.
Improvements
Viewer
-
IGraph
: The default methods#applyLayout(ILayoutAlgorithm)
and#applyLayout(ILayoutAlgorithm, LayoutData)
have been added. -
FilteredGraphWrapper
now no longer queries the node and edge predicates as often. -
IMapperRegistry
: Several overloads for the#create*Mapper
methods have been added that take more specific tags but allow to omit the keyType parameter. -
GraphComponent
: Four#morphLayout
convenience methods have been added that run a layout on the graph of the component and animate the results. -
The property
GraphComponent#GraphMLIOHandler
has been added to set a customGraphMLIOHandler
to be used by the IO commands and convenience IO methods. Previously the lookup of the class needed to be decorated. -
GraphComponent
: The overloads#importFromGraphML(java.io.Reader)
,#importFromGraphML(java.io.InputStream)
,#exportToGraphML(java.io.OutputStream, java.net.URI)
and#exportToGraphML(java.io.Writer, java.net.URI)
have been added. -
Animator
: A getter for theCanvasComponent
, which had been passed to the constructor, was added. -
The types of the static
#INSTANCE
fields ofVoidNodeStyle
,VoidEdgeStyle
,VoidLabelStyle
,VoidPortStyle
,VoidStripeStyle
andVoidStripeStyleRenderer
have been changed to the concrete types instead of the interface types (e.g.INodeStyle
). -
IconLabelStyle
: A constructor has been added that only takes a custom renderer as argument. -
Class
DefaultPortCandidateDescriptor
, which is used to visualizeIPortCandidates
, now provides staticResourceKey
fields that are used to lookupIVisualTemplate
s for the different states ofIPortCandidates
. CustomIVisualTemplate
s can be used by either registering them viaCanvasComponent#putClientProperty
or by the new convenience methodDefaultPortCandidateDescriptor#setTemplate
. -
Resizing a table row or column now respects the
GraphEditorInputMode#AdjustContentRectPolicy
. -
CreateEdgeInputMode
now respects the settings#SnappingBendsToSnapLinesEnabled
and#SnappingBendAdjacentSegmentsEnabled
onGraphSnapContext
. It also handles grid snapping according to the configuration for snapping. - Nodes now show their target grouping hierarchy z-order during a reparenting gesture.
-
GraphMLIOHandler
now has#addXamlNamespaceMapping
methods for easier control of the XML namespace for certain types. -
GraphMLIOHandler
has two new events,#QueryType
and#QueryName
that allow for fine-grained control over XML namespace writing and parsing for certain types. -
GraphMLIOHandler
: The overloads#read(IGraph,java.io.Reader)
,#read(IGraph, java.io.InputStream)
,#write(IGraph, java.io.OutputStream, java.nio.charset.Charset, java.net.URI)
and#write(IGraph, java.io.Writer, java.net.URI)
have been added. -
GraphMLParser
: The overloads#parse(IGraph,Reader,IGraphElementFactory)
and#parse(IGraph, InputStream, IGraphElementFactory)
have been added. -
GraphML
: The performance for parsing java enums andFlagsEnums
has been improved. -
GraphML
: Parsing java enums andFlagsEnums
has been refactored and now respectsSerializationProperties#IGNORE_PROPERTY_CASE
.
Layout
-
HierarchicLayout
: Slightly reduced the number of bends when integrated edge labeling is enabled. -
HierarchicLayout
: Fixed unstable from-sketch behavior for non-default layout orientations when group nodes are folded or expanded. Applies to orientationsLayoutOrientation#LEFT_TO_RIGHT
,LayoutOrientation#RIGHT_TO_LEFT
andLayoutOrientation#BOTTOM_TO_TOP
. Geometry information registered with data providers with keysHierarchicLayout#ALTERNATIVE_GROUP_BOUNDS_DP_KEY
andHierarchicLayout#ALTERNATIVE_EDGE_PATH_DP_KEY
is now automatically rotated according to the specified layout orientation. -
HierarchicLayout
: Improved support forPortCandidate
s at group nodes. Previously, they were only obeyed if there was just a single candidate defined, which also applied to the opposite node (not necessarily a group node). Now, out of the given candidates, one is selected and considered for the routing. Still, fixed candidates are treated like free ones and are not supported at the side of group nodes. -
HierarchicLayout
: Routing of grouped edges that connect to nodes of different groups now assures that the whole bus segment remains outside the different group nodes. This avoids that group nodes get unnecessarily large and potentially makes drawings more symmetric. -
HierarchicLayout
: Improved edge grouping such that it is now possible to group incoming/outgoing edges as well as same-layer/backloop edges with common edges. -
HierarchicLayout
: Can now take the original edge route into account to determine the route of a self-loop. -
MultiPageLayout
: Added new option#StrictClusterSeparationEnabled
that allows to specify whether or not nodes with different cluster IDs may be placed onto the same page. -
The tree algorithms
BalloonLayout
,TreeLayout
andAspectRatioTreeLayout
now support custom selection of the root node of the tree. -
BalloonLayout
: Interleaved child placement now works in conjunction with from sketch-mode and custom child order comparators. This means that the settings#FromSketchModeEnabled
and#Comparator
are no longer ignored when enabling the interleaved placement mode (see#InterleavedMode
). -
TreeLayout
: Now take into consideration the minimum group node size specified by the user with aIDataProvider
registered with the graph with keyGroupingKeys#MINIMUM_NODE_SIZE_DPKEY
. -
SeriesParallelLayout
: Now takes into consideration the minimum node size specified by the user with aIDataProvider
registered with the graph with keyGroupingKeys#MINIMUM_NODE_SIZE_DPKEY
. -
Improved the runtime of
EdgeRouter
when routing edges that havePortConstraint
s orPortCandidate
s. -
Improved the performance of
OrthogonalSegmentDistributionStage
and thus alsoChannelEdgeRouter
which by default uses the mentioned stage as edge distribution strategy. -
ChannelRouter
: Improved order of segments to avoid edge crossings when there are multiple segments that have one common end point. -
Improved the performance of
PartialLayout
for input graphs that feature a high number of large subgraph components. Does not apply for component assignment strategyComponentAssignmentStrategy#SINGLE
. -
LayoutUtilities#applyLayout
now supports layout of tables. -
ItemMapping
: The property#Mapper
is now automatically set on first read-access to the property, enabling more convenient use of the mapper without first having to instantiate a matching instance. -
PartitionGridData
: It is now sufficient to specify one of a row mapping or the column mapping. The unspecified one will automatically be set to 0, resulting in a single row or column being used. -
BalloonLayoutData
,HierarchicLayoutData
,LabelingData
,OrthogonalLayoutData
,SeriesParallelLayoutData
andTreeLayoutData
now have anEdgeLabelPreferredPlacement
property which supports anItemMapping
for edge labels to provide aPrefererredPlacementDescriptor
. Can be used as alternative to mappers registered withLayoutGraphAdapter#EDGE_LABEL_LAYOUT_PREFERRED_PLACEMENT_DESCRIPTOR_DPKEY
. -
PlanarEmbedding
has been added and allows to calculate and query an embedding of a planar graph.
Bugfixes
Viewer
Model
-
Fixed a bug in
IGraph#addLabel
that ignored an explicitly specified preferred size if folding is enabled. -
FilteredGraphWrapper
: The fail-fast mechanism to detect concurrent modification changes in the#Nodes
,#Edges
,#Labels
and#Ports
IListEnumerables
didn't detect all modifications correctly. -
Folding:
- Fixed a bug that sometimes ignored the view state for a port on a folder node when a folding edge was created.
- Fixed a potential exception when using folding on a filtered graph when either nodes with labels or ports, or edges with bends or labels are shown for the first time after being hidden before.
- Fixed a bug that treated group nodes with no children als non-group nodes after they have been expanded.
- Fixed a bug that creates folders with empty size when manually creating groups and the folding view is configured to collapse group nodes by default.
-
SandwichLabelModel
: Fixed incorrectDefaultValue
annotation for some created parameters. -
SmartEdgeLabelModel
: An exception was thrown if the path of the corresponding edge contained bends that were close together or at the same location. -
NinePositionsEdgeLabelModel
: Fixed the placement for the positions#SOURCE_BELOW
and#TARGET_BELOW
.
Geometry
-
GeneralPath#equals
does no longer check for path equivalence (same coordinates etc.), but simply checks reference equality. This makes it consistent with the#hashCode
method. To check for path value equivalence, use the new method#isEquivalentTo
instead.
View
-
Fixed
GraphComponent
's#importFromGraphML(java.io.File)
method to respect theGraphMLIOHandler
's#ClearingGraphBeforeReadEnabled
property. (All the other#importFromGraphML
methods already did so.) -
Label text isn't mirrored anymore if
ComponentOrientation#RIGHT_TO_LEFT
is set on theGraphComponent
. -
GraphOverviewComponent
: Setting a new#OverviewInputMode
updates now the#InputMode
property accordingly. -
Fixed a bug that might occur when changing wrapped styles in
CollapsibleNodeStyleDecorator
,ShadowNodeStyleDecorator
,NodeStyleLabelStyleAdapter
andNodeStylePortStyleAdapter
. -
Fixed a bug in
GraphModelManager
that didn't update the child groups if a new#ContentGroup
is set. -
Fixed a bug in
GraphModelManager
where#HierarchicEdgeNestingEnabled
set tofalse
was not respected when the graph changed or a group node was created first on a yet ungrouped graph. -
Fixed some styles to call
IRenderContext#childVisualRemoved
after theIVisual
actually has been removed instead of just before the removal. -
Fixed a possible
NullPointerException
in the graph rendering code when items were removed from the graph during their style's#updateVisual
method. This could happen when removing graph items from a different thread (which is still not supported, but at least this particular case won't crash anymore). -
Fixed the maximum y-coordinate for horizontal grid lines produced
by
GridVisualCreator
with grid styleLINES
.
Input
-
All shortcuts have been adapted to the operation system conventions, e.g. shortcuts on Mac do not use the
Control
key anymore but theCommand
key as modifier instead. -
CreateEdgeInputMode
: Fixed a bug that didn't show the edge preview when the edge would be created between a node and one of its ancestors or vice versa. -
CreateEdgeInputMode
: The#EdgeCreated
event triggered before the corresponding undoable edit was committed. This could result in a broken undo queue, if e.g. an animated layout was started during in the event listener. The event now triggers after the edit has been committed. With automatic undo unit merging, this should not make a difference for the end user, however from the perspective of the code there will be two subsequent edits, rather than one compound, if the code in the listener actually modifies the edge. -
CreateEdgeInputMode
: Fixed a bug that broke the edge preview after the input mode was uninstalled and reinstalled again. - Fixed a bug in bend creation for orthogonal edges when grid snapping was enabled.
- A bug in orthogonal edge editing was fixed where an edge could become non-orthogonal when a non-selected bend was moved.
- Fixed an issue with orthogonal edge editing where canceling moving a port or node would add bends to otherwise straight edge segments.
- Self-loops with same source and target location are now treated as orthogonal.
-
When dragging an unselected bend and canceling the gesture by pressing
ESC
, the dragged bend was removed. - Fixed a bug that prevented individually disabling certain grouping commands.
-
OverviewInputMode
: Fixed a bug that could break the overview visualization if the overview has a specific very small width or height. -
StripeDropInputMode
: Fixed a bug that could result in nodes being moved to a wrong stripe when a new stripe was created or an existing one relocated. -
NodeDropInputMode
: Fixed a possible exception when snapping is enabled, but preview disabled. -
When a node and its parent group node were both selected and moved with the
SHIFT
key held down the node was erroneously reparented to the root. - Fixed reparent highlighting when multiple nodes are reparented together.
-
Fixed an issue where the parameter finder for
FreeEdgeLabelModel
cannot place the label correctly for self-loops. Labels previously always appeared at the port location in this case. -
Hiding
INodeSnapResultProvider
orIBendSnapResultProvider
from the lookup no longer leads to a crash when nodes or bends are moved. -
Fixed an issue where
ICommand#EDIT_LABEL
would not work directly on labels when aTableEditorInputMode
is active.
Styles
-
DefaultLabelStyle
: Fixed vertical text alignment for instances with non-empty insets. -
IconLabelStyle
: Fixed aNullPointerException
that occurred when rendering the style while the#Icon
property is set tonull
GraphML
-
Fixed a bug in GraphML parsing that prevented finding the annotated
@GraphML#contentProperty
of a class. - Fixed a bug in GraphML parsing that could result in an exception when parsing an empty text element.
-
Fixed a bug in GraphML serialization that ignored
@GraphML
annotations for static fields. -
Fixed structured GraphML serialization of
DashStyle
,Pen
andURL
instances. -
The
ValueSerializer
used for predefinedPen
s andIArrow
s now also respects theSerializationProperty#IGNORE_PROPERTY_CASE
. -
Methods
GraphMLIOHandler#addRegistryOutputMapper(String,Object)
and#addRegistryOutputMapper(String, String, Object, IEventListener)
created multiple GraphML key definitions for the same mapper instance -
Arrow
: Added@Obfuscation
annotation to exclude the class from obfuscation. ExcludingArrow
from obfuscation is necessary for properly reading (and writing) GraphML files. -
Fixed the
@DefaultValue
annotations for the#Pen
and#Paint
properties inArcEdgeStyle
,PolylineEdgeStyle
,GeneralPathNodeStyle
andShapeNodeStyle
. -
Fixed GraphML (de-)serialization of ports using
SegmentRatioPortLocationModel
and corresponding port location parameter instances.
Layout
-
HierarchicLayout
: Fixed bug that caused a violation of the specified minimum distance or edge overlaps in the case of same-layer edges. -
HierarchicLayout
: Fixed rare bug that caused same-layer edge to cross through their source or target node, e.g., the port was at the top of the source node but the edge crossed through the source node to leave it at the bottom. -
HierarchicLayout
: Fixed bug that sometimes caused the route of back-loop edges with at least one endpoint incident to a group node to unnecessarily enter this group node. -
HierarchicLayout
: Fixed bug that sometimes caused superfluous bends in edge routes when integrated edge labeling was enabled. -
HierarchicLayout
: Fixed bug that caused that the directedness of edges incident to groups wasn't considered correctly (seeHierarchicLayout#EDGE_DIRECTEDNESS_DP_KEY
). -
HierarchicLayout
: Fixed bug that caused node-edge overlaps in conjunction with some complex edge grouping specifications. -
RecursiveGroupLayout
when used withHierarchicLayout
as core layout algorithm: FixedIllegalStateException
that could be triggered when group nodes of the input graph havePortCandidate
s. -
RecursiveGroupLayout
: Fixed bug that caused edges to share the same port even though they should be assigned to different ports. Note that this problem only appeared if the core layout algorithm (seeCoreLayout
) is an instance of classHierarchicLayout
. -
SimplexNodePlacer
: Fixed bug that caused overlaps between edges and nodes when enabling node compaction (see#NodeCompaction
) and having edges with either strongPortConstraint
s orPortCandidate
s. -
OrganicLayout
: Fixed bug that caused group nodes with zero height/width in the layout result. The bug appeared when having empty groups, group node insets smaller than one (defined viaGroupingKeys#GROUP_NODE_INSETS_DPKEY
) and no minimum group node size specified (GroupingKeys#MINIMUM_NODE_SIZE_DPKEY
). -
OrganicLayout
andClassicOrganicLayout
: Fixed bug that caused the algorithm to not consider the specified customIGroupBoundsCalculator
(seeClassicOrganicLayout#GroupBoundsCalculator
). -
Fixed
OrganicLayout
ignoring theGroupNodeMode
settings. -
OrganicLayout
,ClassicOrganicLayout
andInteractiveOrganicLayout
: FixedIllegalArgumentException
that was triggered due toNaN
values that could occur in case the input graph has a very large number of nodes. -
CircularLayout
andRadialLayout
: Fixed bug that caused that always all edges are bundled if bundling is enabled for at least one single edge. More precisely, propertyEdgeBundleDescriptor#Bundled
wasn't considered correctly. -
CircularLayout
: Fixed bug that in some cases produced self-intersecting edges when edge bundling is enabled. -
SingleCycleLayout
: Fixed bug that may lead to aClassCastException
if edge bundling is enabled and a custom node sequencer is specified (seeSingleCycleLayout#NodeSequencer
). -
AspectRatioTreeLayout#ROOT_PLACEMENT_DPKEY
is now of typeNodeDpKey<RootPlacement>
. -
AspectRatioTreeLayout#SUBTREE_ROUTING_POLICY_DPKEY
is now of typeNodeDpKey<SubtreeArrangement>
. -
AspectRatioTreeLayoutData
did not register the correct values with the graph for the root placement and the subtree routing policy. -
MultiPageLayout
: Fixed rare bug that sometimes caused straight-line edge routes instead of orthogonal routes. -
IsolatedGroupComponentLayout
: Fixed bug that caused edge labels that intersect with group nodes even though optionComponentLayout#LabelConsiderationEnabled
is enabled. -
EdgeRouter
: Fixed rareRuntimeException
that appeared if there were fixed (see#Scope
) and grouped edges at the same time. -
EdgeRouter
: Fixed rareIllegalArgumentException
that was triggered when having multiple target port candidates, where at least one must be fixed. Furthermore, to trigger the exception it is necessary that the path search algorithm tries to perform an early exit due to maximum duration restrictions or a stop request viaAbortHandler
. -
EdgeRouter
: Fixed bug that caused violations of minimum first/last segment lengths of grouped edges when using different edge layout descriptors and, second, made the layout algorithm remove a user-registeredIDataProvider
with keyEdgeRouter#EDGE_LAYOUT_DESCRIPTOR_DPKEY
. -
EdgeRouter
: Fixed rare node overlaps in conjunction with monotonic path restrictions (seeEdgeLayoutDescriptor.MonotonicPathRestriction
). -
ChannelEdgeRouter
: Fixed routing of self-loops that have both source and target end point at the same side of the node. Previously, when multiple such self-loops were present at the same node, the routing produced bad end points located outside of the node. -
Groups#hierarchicalClustering(Graph,int,INodeMap,INodeDistanceProvider,Linkage)
: FixedNullPointerException
that occurred when the given maximum number of clusters was0
or1
. -
Fixed
NullPointerException
s in someLayoutData
implementations that could happen if some of the mappings where accessed but were never really used in client code. -
Fixed a bug in
TableLayoutConfigurator
which altered the size of a column or row if an edge routing algorithm has been applied. -
Fixed a bug in
TableLayoutConfigurator
which sometimes used the wrong table insets. -
LayoutGraphAdapter
/CopiedLayoutIGraph
:IMappers
which useILabels
as key andboolean
,int
ordouble
as value are now correctly translated into data providers for layout algorithms. -
Fixed a bug that a dataprovider with key
LayoutGraphAdapter#EDGE_LABEL_LAYOUT_PREFERRED_PLACEMENT_DESCRIPTOR_DPKEY
that has been filled by aLayoutData
has been ignored.
Incompatible Changes
Viewer
Model
-
IGraph
: The signature of method#addBend(IEdge, int, PointD)
has been changed to#addBend(IEdge, PointD, int)
. -
IMapperRegistry
: Renamed the methods#add*
to#create*
. The type of property#MapperMetadata
has been changed fromIMapperMetadata
toMapperMetadata
. -
DefaultGraph
andAbstractGraphWrapper
: The signature of method#addBend(IEdge, int, PointD)
has been changed to#addBend(IEdge, PointD, int)
. -
FoldingEdgeState
: The signature of method#addBend(int, PointD)
has been changed to#addBend(PointD, int)
.
Geometry
-
GeneralPath
: The return value type of methodcreatePath
has been changed fromPath3D.Double
toPath3D
.
View
-
Most implementations and some usages of
IAnimation
have been removed and are now available as factory methods inIAnimation
. This included the classesLayoutMorpher
,EasedAnimation
,GeneralPathAnimation
,ParallelAnimation
,LabelAnimation
,NodeAnimation
,PortAnimation
,EdgeAnimation
. -
GraphModelManager
: Signature of method#typedHitElementsAt(IInputModeContext, Class<T>, PointD, ICanvasObjectGroup)
has been changed to#typedHitElementsAt(Class<T>, IInputModeContext, PointD, ICanvasObjectGroup)
. -
CanvasComponent
: The property#Editable
has been removed. It had no effect on almost all input modes anyway. To no longer allow editing aCanvasComponent
use a different input mode instead, e.g.GraphViewerInputMode
, or configure the current input mode in a way that it no longer allows changes. -
GraphComponent
: Decorating the lookup ofGraphComponent
orIGraph
to set theGraphMLIOHandler
used by the IO commands and convenience IO methods onGraphComponent
is no longer supported. Use the#GraphMLIOHandler
property onGraphComponent
instead. -
The interface
IRectanglePainter
has been replaced by the more powerful interfaceIVisualTemplate
. Implementations have been adjusted accordingly and members and classes with name*Painter
or*RectanglePainter
have been renamed to*Template
or*VisualTemplate
. -
EdgeDecorationInstaller
: The method#getBendVisual(IRenderContext,IBend)
returning anIVisual
was replaced by the method#getBendDrawing(CanvasComponent,IEdge)
returning anIVisualTemplate
that is used for all bends of the passed edge.
The subclassesEdgeFocusIndicatorInstaller
,EdgeHighlightIndicatorInstaller
andEdgeSelectionIndicatorInstaller
now contain staticResourceKey
fields#BEND_TEMPLATE_KEY
that can be used to register customIVisualTemplate
s for bends on theGraphComponent
.
Input
-
The command mechanism has been refactored:
-
ICommand
,CommandAction
,CommandBindingAction
have been moved to packagecom.yworks.yfiles.view.input
. ClassesCommand
,CommandBinding
,CommandManager
,CanExecuteRoutedEventArgs
,ExecutedRoutedEventArgs
as well as the related properties onCanvasComponent
have been removed.KeyboardInputMode
offers new methods#addCommandBinding
and#addKeyBinding
for binding commands to actions and keyboard gestures to commands. -
Class
KeyboardInputMode
has been refactored. New interfacesCanExecuteCommandHandler
andExecuteCommandHandler
for handling commands have been introduced. All methods for binding commands toIEventListener
implementations have been retrofitted to the aforementioned handlers. All methods for removing command or key bindings have been removed. Methods for adding such bindings now return aKeyboardInputModeBinding
instance that offers a#remove
method for this purpose.
-
-
OverviewInputMode
now allows to zoom out further. -
OrthogonalEdgeEditingContext
: Changed return value of methods#getMovementInfos(IEdge)
and#getSegmentOrientations(IEdge)
toIListEnumerable
. -
HandleInputMode
: For allHandleType
s a correspondingResourceKey
was added as static field that can be used to register a customIVisualTemplate
for this handle type. Per default the#createVisual(IRenderContext,IHandle)
method now looks up theIVisualTemplate
for theResourceKey
matching theHandleType
for the passedIHandle
. The#updateVisual
method is no longer used and was removed. -
An initially collapsed group node as a result of
ICommand#GROUP_SELECTION
now has a reasonable size. -
IClipboardIdProvider
: Signature of method#getId(IModelItem, IGraphClipboardContext)
has been changed to#getId(IGraphClipboardContext, IModelItem)
. -
GraphCopier
: Changed signature of method#addBend(IGraph, IGraph, IEdge, IBend, int, PointD)
to#addBend(IGraph, IGraph, IEdge, IBend, PointD, int)
.
Styles
-
AbstractEdgeStyle
andAbstractStripeStyle
: The return type of method#clone()
has been changed fromAbstractEdgeStyle<TVisual>
toAbstractEdgeStyle
. Furthermore, the return type of methods#createVisual(IRenderContext, IEdge)
and#updateVisual(IRenderContext, IVisual, IEdge)
has been changed fromTVisual extends IVisual
toIVisual
. -
IconLabelStyle
:-
The type of property
#Url
has been changed fromString
tojava.net.URL
. -
The constructors have been changed and now take the
URL
of the icon instead of itsImage
.
-
The type of property
-
MemoryIconLabelStyle
: Simplified constructors that now only allow to specify the image of the icon as well as a custom renderer. -
The type of
ArcEdgeStyle#Renderer
has been changed fromIEdgeStyleRenderer
toArcEdgeStyleRenderer
. -
The type of
PolylineEdgeStyle#Renderer
has been changed fromIEdgeStyleRenderer
toPolylineEdgeStyleRenderer
. -
TableNodeStyle
: The type of property#Renderer
has been changed fromINodeStyleRenderer
toTableNodeStyleRenderer
. Furthermore, the parameter type of methods#addPropertyChangedListener(IEventListener<PropertyChangedEventArgs>)
and#removePropertyChangedListener(IEventListener<PropertyChangedEventArgs>)
has been changed fromIEventListener
toIEventListener<PropertyChangedEventArgs>
. -
The type of
VoidStripeStyle#Renderer
has been changed fromIStripeStyleRenderer
toVoidStripeStyleRenderer
.
GraphML
-
GraphML annotations:
SerializationVisibilityType
andGraphMLSerializationMode
have been merged toGraphMLMemberVisibility
. -
Property
: The properties#Value
and#OwnerInstance
have been removed. The new methodsgetValue
andsetValue
now take the owner instance as parameter. -
HandleSerializationEventArgs
: The property#SourceType
is now of typejava.lang.reflect.Type
instead ofjava.lang.Class
. -
IWriteContext
andIParseContext
: A parameter of typeClass<T>
that describes the target type has been added to the#getCurrent
methods. -
XamlSerializer
: Signature of method#serialize(Type, IWriteContext, Object)
has been changed to#serialize(IWriteContext, Object)
. -
IXamlNameMapper
: The return type of methodgetName(IWriteContext, Type)
has been changed fromString
toXmlName
. -
QueryOutputHandlersEventArgs
: ConstructorQueryOutputHandlersEventArgs(IWriteContext, KeyScope, Map<Object, IOutputHandler>)
has been changed toQueryOutputHandlersEventArgs(IWriteContext, KeyScope)
. -
GraphMLWriter
: Return type of method#getOutputHandlers(IWriteContext, KeyScope)
has been changed fromMap<Object, IOutputHandler>
toIterable<IOutputHandler>
. -
AbstractInputHandler
: The return type of method#initializeFromKeyDefinition(IParseContext, Element)
has been changed fromboolean
tovoid
.
Algorithms
-
The following classes have been deprecated:
GraphEvent
,IGraphListener
,Maps.HighPerformanceIntMap
andMaps.HighPerformanceDoubleMap
. -
YList
: The constructorYList(Collection<Object>)
has been changed toYList(Collection<Iterable>)
. Method#remove(int)
has been deprecated. -
Comparators
: Method#compare(int, int)
has been deprecated. -
Graph
: Methods#addGraphListener(IGraphListener)
,#edgeObjects()
,#getSource(Object)
,#getTarget(Object)
,#nodeObjects()
,#removeGraphListener(IGraphListener)
,#firePostEvent()
and#firePreEvent()
have been deprecated.
Layout
-
ClassicOrganicLayout
: The return type of method property#PreferredEdgeLength
has been changed fromint
todouble
. Note that this also induces a corresponding change in classOrganicLayoutData
. -
OrganicLayout
andClassicOrganicLayout
: The type of constant#PREFERRED_EDGE_LENGTH_DPKEY
has been changed fromEdgeDpKey<Integer>
toEdgeDpKey<Double>
. -
LayoutGraph
: Methods#getEdgeLabelLayout(Object)
,#getEdgeLayout(Object)
,#getNodeLabelLayout(Object)
and#getNodeLayout(Object)
have been deprecated. -
HierarchicLayoutCore.IncrementalHint
has been deprecated. MethodINodeData#getIncrementalHint()
now returnsObject
. -
LayoutGraphAdapter
: The type of the provided data provider keys have been changed fromObject
to a more specific type. -
PartitionCellId
: The return type of property#Cells
has been changed fromCollection<Object>
toIterable<Cell>
. -
HierarchicLayout
:- The edge grouping now supports to group incoming and outgoing edges of a node. In previous versions incoming and outgoing edges always defined separate groups even though the user specified the same group IDs for such edges.
-
Method
#isIntegratedEdgeLabelingEnabled
does now always returnfalse
if the labeling algorithm is disabled (seeMultiStageLayout#isLabelingEnabled
. In previous versions it was only required that an appropriate labeling algorithm was specified, but it was not necessary that it is enabled. Therefore, the integrated labeling state queried from the property might not have corresponded to what the layout algorithm actually did. The same behavior change applies for the following methods:HierarchicLayout#isNodeLabelConsiderationEnabled
OrthogonalLayout#isIntegratedEdgeLabelingEnabled
OrthogonalLayout#isNodeLabelConsiderationEnabled
-
HierarchicLayout
may now place source/target labels in layers that contain common nodes. In previous versions such labels were always placed in separate layers which often led to less compact drawings with superfluous bends. -
Geometry information registered with data providers with keys
#ALTERNATIVE_GROUP_BOUNDS_DP_KEY
and#ALTERNATIVE_EDGE_PATH_DP_KEY
is now automatically rotated according to the specified layout orientation. This fixes unstable from-sketch behavior in incremental layout mode when using an orientation other than top-to-bottom. User that
-
OrganicLayout
does no longer resize empty group nodes, possible ignoring a minimum group node size for them (seeGroupingKeys#MINIMUM_NODE_SIZE_DPKEY
). The behavior with respect to empty group nodes is now in line with the behavior of other common layout algorithms. -
Method
Centrality#closenessCentrality
now sets the closeness of a node toInfinity
if the sum of the shortest path distances is0
. Before, it was set toNaN
in such cases. -
Groups.Dendrogram
does no longer extend classGraph
. To enable convenient iteration of a dendrogram, method#getChildren(Node)
was added. -
SingleCycleLayout
: Property#NodeSequencer
now allows to specifynull
to return to the default sequencer. In previous versions, specifyingnull
leads to anIllegalStateException
.
Demo Improvements
- The package structure of the source code demos has been changed to a more intuitive structure.
- The Viewer distribution now provides several source code demos.
- The layout code in the BPMN demo was simplified and is now easier to adjust
- A new demo application that shows how to configure hierarchic layout for arranging Sankey diagrams was added.
-
The new
GraphMLCompatibilityDemo
that shows how to load GraphML files created by yFiles for Java 3.0.x was added.
yFiles for Java (Swing) 3.0.0.4
Improvements
Demos
-
BPMNEditorDemo
: The classBpmnLayoutData
was added and is now used instead of theBpmnLayoutConfigurator
. -
BPMNEditorDemo
: Fixed the initialization of snapping and of the default group node style. -
LayoutStylesDemo
: The bound restrictions of the Organic layout can now be specified explicitly. -
LayoutStylesDemo
: Fixed the configuration for the minimum node distance of the Organic layout that was not editable before.
Bugfixes
Viewer
-
Folding
: Fixed a bug in the folding mechanism that could lead to an endless loop when loading a GraphML file containingFoldingEdgeState
information. -
PathBasedEdgeStyleRenderer
: Fixed bug that could leave visual artifacts when switching to an arrow that returned anull
visual. -
CanvasComponent
: Fixed a bug in the mouse wheel scroll behavior that moved the viewport in the wrong direction when scrolling page-wise vertically.
Layout
-
Fixed
java.lang.IllegalArgumentException: Comparison method violates its general contract!
problems caused by callingjava.util.Arrays.sort
forjava.util.Comparator
implementations that do not imply a total order. -
HierarchicLayout
: Fixed bug that caused a violation of the minimum first/last segment length for reversed/backloop edges which connect to group nodes. -
HierarchicLayout
: Fixed rare bug that may cause overlaps between labels and segments of edges with octilinear routes. -
HierarchicLayout
: Fixed possible infinite loop if there are critical edges (seeCRITICAL_EDGE_DP_KEY
). -
TreeLayout
: Fixed possible group node overlaps in conjunction with some node placers, for exampleAssistantNodePlacer
. -
TreeLayout
: Fixed bug that caused less compact layout results when using node halos (seeNodeHalo
). -
OrganicLayout
: The type of the dataprovider keyGROUP_NODE_MODE_DPKEY
was fixed fromNodeDpKey<Object>
toNodeDpKey<GroupNodeMode>
. -
OrganicLayoutData
: The type of the propertyGroupNodeModes
was fixed fromItemMapping<Node, GroupNodeMode>
toItemMapping<INode, GroupNodeMode>
.
yFiles for Java (Swing) 3.0.0.3
Bugfixes
Viewer
-
Folding: when using a
MergingFoldingEdgeConverter
theFoldingEdgeState
representing multiple edges could become inconsistent after removing or reconnecting some of the edges. - Path Cropping: fixed a certain case where inaccurate numeric results with ports on node shape outlines would result in the first or last edge segment being completely removed.
-
DefaultEdgePathCropper
: fixed an issue wheregetIntersection
would not be called when cropping an edge at the source end. -
IInputModeContext
: fixed a bug ingetGraph
that could cause a stack overflow. - Edge Creation: fixed bug that could cause a 'Node not in this graph' exception during interactive edge creation.
-
PopupMenuInputMode
: moved the default popup menu location one pixel to the right and one pixel down to prevent the mouse cursor from being positioned directly on the popup menu's border. (Mouse clicks on the popup menu's border do neither close the popup menu nor trigger any of the popup menu's entries.)
Layout
-
HierarchicLayout
: fixed rareNullPointerException
triggered inAsIsSequencer
for edges incident to group nodes that have a sketch without bend points as well as port constraints. -
HierarchicLayout
: fixed bug that may cause non-orthogonal segments of grouped edges even though orthogonal edge routing is enabled. -
HierarchicLayout
: improved compactness of layouts that feature group nodes with insets and (group) nodes with halos (NodeHalo
). Previously, the specification of halos could enlarge the insets of group nodes by an unnecessary large amount. -
HierarchicLayout
: fixed an exception that sometimes got triggered when sequence constraints were used. -
PartialLayout
: fixedNullPointerException
that appeared if noDataProvider
with keyPARTIAL_NODES_DP_KEY
is registered with the input graph.
yFiles for Java (Swing) 3.0.0.2
Improvements
Documentation
- The Developer's Guide has been completely revised. Now it consists of two parts: The first part covers the basics of yFiles for Java, while the second part describes in detail how the behavior of the library can be adapted to the customer's requirements.
Viewer
-
Events defined on
DropInputMode
now carry additional event argumentsDropTargetEventArgs
which hold the original Java Swing drag and drop events.
Bugfixes
Viewer
-
Fixed shortcut
Ctrl+O
for the command to open a document. -
Methods
GraphMLIOHandler.addRegistryOutputMapper(String,Object)
andaddRegistryOutputMapper(String, String, Object, IEventListener)
wrongly created multiple GraphML key definitions for the same mapper instance. -
Some GraphML annotations have been added to properties of label models and enums to increase the cross-product
compatibility of generated GraphML files. The following properties have been annotated:
SmartEdgeLabelModel.AutoRotationEnabled
is now annotatedAutoRotation
HorizontalAlignment
'sCENTER
,LEFT
andRIGHT
values are now annotatedCenter
,Left
andRight
TextTrimming
'sNONE
,CHARACTER_ELLIPSIS
andWORD_ELLIPSIS
values are now annotatedNone
,CharacterEllipsis
andWordEllipsis
TextWrapping
'sWRAP_WITH_OVERFLOW
,NO_WRAP
andWRAP
values are now annotatedWrapWithOverflow
,NoWrap
andWrap
EdgePathLabelModel.AutoRotationEnabled
is now annotatedAutoRotation
EdgeSegmentLabelModel.AutoRotationEnabled
is now annotatedAutoRotation
FreeEdgeLabelModel.RelativeAngleEnabled
is now annotatedEdgeRelativeAngle
AbstractJComponentLabelStyle.AutoFlippingEnabled
is now annotatedAutoFlip
ArcEdgeStyle.FixedHeightEnabled
is now annotatedFixedHeight
HtmlLabelStyle.AutoFlippingEnabled
is now annotatedAutoFlip
NodeStyleLabelStyleAdapter.AutoFlippingEnabled
is now annotatedAutoFlip
-
The default value for GraphML serialization of
PanelNodeStyle.Color
is nowBlack
.
Layout
-
HierarchicLayout
: FixedNullPointerException
that could happen inAsIsSequencer
when incremental group hints are defined (seeIncrementalHintsFactory.createIncrementalGroupHint
) along with specific port constraints on edges incident to an incremental group node. -
HierarchicLayout
: Improved result if compact label placement is enabled (which is the default), seeSimplexNodePlacer.LabelCompaction
. In previous versions the labels may have been placed in a stacked style even if this did not make the result more compact (e.g. if all labels are placed to the right of the edges). -
GraphPartitionManager
: Fixed functionality to hide edges when using methodsGraphPartitionManager.hide
. Previously, edges were actually not hidden from the graph. -
HierarchicLayout
: Fixed distance between vertical (in a top-to-bottom layout) segments of same layer edges that connect to group nodes. This also applies to self-loops that connect to the top or bottom of a group node with both ends as well as same layer parts of other edges like back-loops. -
HierarchicLayout
: Fixed bug that caused the minimum edge-to-edge distance to be violated by edges with strong port constraints that cross each other.
Demos
- BPMNEditorDemo: Fixed positioning of the dynamic substate button of activity and choreography nodes.
- Fixed invalid HTML structure of demo readmes.
yFiles for Java (Swing) 3.0.0.1
Demos and Tutorials
-
Added new demo
layout.LayoutStylesDemo
that presents all major layout algorithms in an easily explorable and configurable manner. -
Added new demo
viewer.svgimageexport.SVGImageExportDemo
that shows how to export the contents of aGraphComponent
to SVG. -
Added new demo
viewer.pdfimageexport.PDFImageExportDemo
that shows how to export the contents of aGraphComponent
to PDF, EPS and EMF. -
Added new
demo viewer.svgnodestyle.SVGNodeStyleDemo
that shows how to use SVG for node visualization. -
Added new demo
bpmn.editor.BPMNEditorDemo
with corresponding graph element styles and a customized layout algorithm that demonstrates how to use yFiles for BPMN applications - GraphViewerDemo: Shift click on a node in the movie graph opens now a related link in the default browser (as already stated by the graph's description).
Improvements
Viewer
-
CanvasComponent
: Added an eventFitContentViewMarginsChanged
that gets invoked when the propery#FitContentViewMargins
has been changed.
Documentation Viewer
- Method parameters are shown in search results and quick navigation popups.
- Default properties are listed in a separate member section.
- The documentation viewer can be used offline by running
bower install
and openingindex-offline.html
. - Fixed links to package documentation pages.
Bugfixes
Viewer
-
Property
CanvasComponent#FitContentViewMargins
is now initialized to (10,10,10,10) as mentioned in its documentation. -
The
SerializationVisibility
annotation as well as theSerializationVisibilityType
enum that are used to customize the serialization behavior of properties are now public to work properly. -
Renaming
FlagsEnum
members withGraphML
annotations did not work. -
CollapsibleNodeStyleDecorator
didn't handle the hit testing correctly when different button sizes for the collapsed and expanded state were used. -
NodeStyleLabelStyleAdapter
sometimes produced aNullPointerException
during rendering. -
NodeStylePortStyleAdapter
didn't work well together withAbstractComponentNodeStyle
as inner style. -
The
AutoCleanupEnabled
property ofPortDefaults
wasn't serialized correctly as 'AutoCleanup' due to a missing GraphML rename. -
Port location model parameters created with
GenericPortLocationModel
weren't serialized correctly. -
ITable#setStyle(ILabel, ILabelStyle)
andITable#setLabelModelParameter
ignored the provided style resp. label model parameter.
Layout
-
SeriesParallelLayout
: Fixed possibleNullPointerException
when handling graphs with group nodes. -
ParallelEdgeLayout
: Fixed bug that caused wrong edge port coordinates. -
SeriesParallelLayout
: Fixed violations of the minimum first and last segment length and self-crossings of octilinear edges. -
SeriesParallelLayout
: Fixed bug that caused node-to-node or node-to-edge overlaps in the case where the graph contained group nodes and node/edge labels. -
HierarchicLayout
: Fixed bug that caused critical edges to not be aligned (seeCRITICAL_EDGE_PRIORITY_DPKEY
). -
BusRouter
: Fixed rareIllegalStateException
caused by non-orthogonal edge segments. -
TreeLayout
: Fixed bug that occurs when edges with single port constraints are reversed during the layout. -
Polyline.EdgeRouter
: Fixed possibleNullPointerException
that may appear if a specifiedPortCandidate
has multiple directions. -
OrganicLayout
: Fixed a bug that may occur when usingOrganicLayout
withRecursiveGroupLayout
andLayoutMultiplexer
.
Incompatible Changes
Changes in Default Behavior
Viewer
-
FlagsEnum
members now respectGraphML
annotations for renaming. Such members can't be read back in prior versions of the library. Reading older files with the current version still works.
yFiles for Java (Swing) 3.0
This is the initial release of the 3.0 series that brings a modernized API, many new or improved library features and support for current Java language features.
Please see the Developer's Guide for migration instructions from yFiles for Java 2.x