Page Index Toggle Pages: 1 Send TopicPrint
Normal Topic Version 4.7 beta (Read 706 times)
YaBB Moderator

Posts: 3187
Joined: Oct 19th, 2005
Version 4.7 beta
Jan 20th, 2023 at 1:31pm
Print Post  
JDiagram version 4.7 contains the following new features and improvements:

Spatial index
Set the EnableSpatialIndex property of Diagram to create an index of item positions for faster hit-testing and viewport clipping queries. This should greatly improve user interaction and rendering speed for diagrams containing tens of thousands or more items.

Select All
// it will take some time to populate the diagram with a million nodes,
// but subsequent redraws and hit-tests should be very fast
Diagram diagram = new Diagram();

for (int c = 0; c < 1000; c++)
	for (int r = 0; r < 1000; r++)
		ShapeNode node = diagram.getFactory().createShapeNode(
			20 + c * 40, 20 + r * 40, 25, 25);


Note that rendering speed improves only when showing a smaller part of the diagram inside DiagramView's viewport. Rendering a lot of items at small zoom levels or in overview's fit-all mode will still need a lot of processing, so you might want to apply constraints on minimal zoom level of diagram view and overview controls for large diagrams.

Pattern router
New PatternRouter class routes links by applying patterns of segment and turn sequences and accepting them when resulting paths do not cross nodes. A path is accepted if its final segment ends in target point and is orthogonal to respective side of target node. If there are several possible paths, the router selects the shortest one. The MinimumDistance property specifies minimum allowed distance of link segments from nodes. The PreferredDistance property specifies distance of first or last link bend from associated node. PatternRouter includes several predefined patterns designed to create consistent-looking paths, and allows creation of custom patterns. Custom patterns can be defined as sequence of RouteStep objects specifying whether the path advances by relative or absolute distance, or changes direction:

Select All
RoutePattern rightZigzag = new RoutePattern();
	new RouteStep(RouteStepKind.AdvanceRelative, 0.5f));
	new RouteStep(RouteStepKind.TurnRight));
	new RouteStep(RouteStepKind.AdvanceRelative, 1));
	new RouteStep(RouteStepKind.TurnLeft));
	new RouteStep(RouteStepKind.AdvanceRelative, 0.5f));

// this can be defined in shorter form using a pattern string
// RoutePattern rightZigzag2 = new RoutePattern(
//     "ADR0.5 TRR ADR1 TRL ADR0.5");

Composite router
The CompositeRouter class lets you chain link routers (objects implementing LinkRouter interface) so that a link passes through the sequence until it gets routed successfully. Diagram's default router is now set to a CompositeRouter instance containing a PatternRouter and GridRouter sequence. This applies the several standard pattern paths when possible, and otherwise routes links using the cost minimizing heuristics-based grid router.

  • Disabling AvoidOverlaps property of RoutingOptions lets you create routes with overlapping segments.

API changes
  • Suspend and Resume methods removed from LinkRouter interface. Call Diagram's suspendLinkRouter and resumeLinkRouter methods instead.
  • Default Diagram.LinkRouter changed from QuickRouter to CompositeRouter instance.
  • bool SmartPolylineEnds property of RoutingOptions replaced by PolylineRouting enum property, which also provides an option to prevent inclined link segments for LinkShape.Polyline routes.

If anyone is interested in trying the beta version, please download this archive containing updated JAR file:

Any comments, questions and general feedback are welcome.
Back to top
IP Logged
Page Index Toggle Pages: 1
Send TopicPrint