Page Index Toggle Pages: 1 Send TopicPrint
Normal Topic Diagramming for Java Swing, V4.7 (Read 1668 times)
Forum Admin
YaBB Administrator

Rock and Roll

Posts: 694
Joined: Apr 6th, 2003
Diagramming for Java Swing, V4.7
Feb 23rd, 2023 at 1:59pm
Print Post  
We have released version 4.7 of JDiagram. It 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.
  • Improved keyboard focus handling for CompositeNode components.
  • Fixed exception in EditComponent drawing code.

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.

Distribution for the latest version can be downloaded here, or from the clients area on our site.

Updated JAR is also available at the Maven Central Repository:

Back to top
IP Logged
Page Index Toggle Pages: 1
Send TopicPrint