MindFusion Diagramming Toolkit for Java Swing
(JDiagram for short)
version 4.9.2


***** ABOUT JDIAGRAM *****

 JDiagram is a Java Swing component that provides Swing based applications with the ability to create and display various kinds of diagrams. The package also includes an applet class that can be loaded in web pages. The component supports workflow, flowchart and process diagrams, object hierarchy and relationship charts, entity-relationship diagrams, structures like graphs and trees, etc.
 Every behavioral and appearance aspect of JDiagram can be customized as suits best your project. Diagram objects can have different styles, colors, fonts and pictures.
 The control's programming model comprises more than 300 methods, properties and events.


***** SOURCE CODE *****

 A JDiagram license can be purchased with the control's full source code. JDiagram is developed entirely in Java using the Swing API. 


***** SAMPLES *****

(run this command on Linux/macOS to make all sample run scripts executable)
find samples/ -type f -iname "*.sh" -exec chmod +x {} \;
find samples/ -type f -iname "*.command" -exec chmod +x {} \;

~ Anchors ~ demonstrates how to define and use anchor point patterns.

~ AnnealLayout ~ demonstrates the AnnealLayout automatic layout algorithm.

~ CircuitDesigner ~ is an interactive electronic circuit designer and simulator. It allows users to visually assemble and wire electronic components, configure their electrical properties, and run circuit simulations that calculate voltage spread across the wire junctions.

~ Controls ~ presents some auxiliary Swing controls included in the MindFusion.Diagramming library.

~ CustomDraw ~ uses custom painting of links to show animated progress of a process running in the system represented by a diagram.

~ Demo ~ demonstrates most of the features of JDiagram.

~ DiagramDB ~ implements basic storage of diagrams in MySql database.

~ DirTree ~ uses custom-designed shapes to represent folder icons. It also demonstrates how to use JDiagram as a tree control, utilizing automatic tree arrangement and collapsing and expanding of sub-trees.

~ Effects ~ demonstrates the visual effects that can be applied to nodes.

~ Fishbone ~ is a fishbone diagram editor demonstrating how to implement custom drawing, hit-testing and interaction handling in derived node types.

~ FlowCharter ~ a small application for drawing diagrams and flowcharts. It lets end-users drag shapes from a palette to construct diagram nodes. The sample also demonstrates the available arrowhead shapes, anchor points usage, saving and loading files and printing.

~ FormEditor ~ implements a form editor that allows creating forms by drawing Java Swing components in the diagram. The components are hosted in ControlNode instances.

~ FractalLayout ~ demonstrates the FractalLayout tree layout algorithm.

~ IconNodes ~ shows how to create a custom node type that displays an image and a label below the image.

~ InteractiveTable ~ shows how to present a combo-list of options for each row of a table. That is not a  built-in feature of JDiagram but can be easily implemented by showing a combo when a row is clicked.

~ JspSample ~ shows how to use JDiagram in a web application, either as a client-side applet, or by generating bitmap images and html image maps on the server.

~ Lanes ~ implements a Gantt-like chart using the swimlane grid feature of the control.

~ LayeredLayout ~ demonstrates the LayeredLayout graph layout algorithm.

~ Magnifier ~ demonstrates the magnifier tool and its options.

~ MinApp ~ shows the minimal setup required to display a diagram inside a JFrame.

~ MultiViews ~ shows how to display the same Diagram in multiple views.

~ OnewayLayout ~ demonstrates the OnewayLayout graph layout algorithm.

~ PredShapes ~ shows the predefined JDiagram shapes and their identifiers.

~ Routing ~ demonstrates the automatic link routing algorithm.

~ Scripting ~ shows how to associate scripts with flowchart nodes to design and run actual algorithms represented by the flowcharts. The example also demonstrates how to integrate Swing components into a diagram using ControlNode class.

~ SiteMap ~ shows how to attach custom data to diagram nodes. That data is saved/loaded together with the JDiagram document. Also demonstrates how to iterate over the diagram items to create a sample site-map.

~ StressTest ~ shows the fastest way to add a large number of diagram items.

~ SWDesigner ~ uses JDiagram to create and edit simple UML-like class diagrams interactively.

~ TabbedView ~ demonstrates multi-page diagrams and the DocumentView control.

~ Tutorial1 ~ shows how to build a graph from XML data.

~ Tutorial2 ~ shows how to build a tree from XML data.

~ Tutorial3 ~ shows how to create custom node types.

~ Tutorial4 ~ shows how to enable undo/redo support and serialization for custom nodes.

~ XmlTree ~ demonstrates how to build a tree from arbitrary XML data.


***** HISTORY *****

new in version 4.9.2:
  auto-routing improvements
  custom lasso tools

new in version 4.9.1:
  serialization improvements
  nodeModified raised for freeform handles

new in version 4.9:
  ItemListView component
  Palette component
  JSON serialization improvements

new in version 4.8.1:
  improved BPMN shapes
  Visio2013Exporter improvements
  spatial index fixes
  getDiagramListeners method

new in version 4.8:
  customize node action icons
  display bitmap image inside item label
  SVG rendering improvements

new in version 4.7.3:
  improved node.Image render quality
  improved Overview render quality
  pen.Brush property value is now saved in files

new in version 4.7.2:
  support for custom in-place edit controls
  FreeFormNodes can be rotated
  disable AutoDeleteLinks to keep deleted node's links
  nodeHovered and linkHovered events
  DividerPen property for container and table nodes

new in version 4.7.1:
  drag indicator displayed by NodeListView
  align dropped node relative to mouse position
  DiagramItem.Opacity property
  TableNode copy constructor fixes
  ItemLabel in-place edit fixes

new in version 4.7:
  PatternRouter link routing class
  CompositeRouter link routing class
  spatial indexing
  improved CompositeNode focus handling
  RoutingOptions.AvoidOverlaps

new in version 4.6.2:
  multiple labels per node
  move item labels interactively
  improved text centering
  improved ZoomControl rendering
  ExcelExporter improvements

new in version 4.6.1:
  TableNode custom drawing
  TableNode.CaptionBackBrush property
  TreeViewItem.Brush property
  TreeViewNode.ShowLines property

new in version 4.6:
  scrollable containers
  ContainerNode.resizeToFitChildren method
  new ImageAlign modes
  ContainerNode.AutoDeleteChildren property
  improved ContainerNode API
  text rendering improvements
  dragging from list controls adds to container
  lasso zoom tool
  layouts process TreeViewItem links
  initializeLasso event
  zoomToRect and bringIntoView overloads
  customize modifier keys
  customize mouse button bindings

new in version 4.5.1:
  MoveNodes behavior
  fixed inplace edit on scaled display
  fixed tooltips on scaled display
  database storage example

new in version 4.5:
  SvgNode class renders SVG drawings
  JSON files now encoded as UTF8
  ImagePadding property
  ContainerNode.FoldIconSize property
  Cell.Tag property
  Windows 10 display scaling fixes

new in version 4.4.2:
  JSON compatibility fixes

new in version 4.4.1:
  JSON Serialization
  Overview fix for Win10 resolution scaling
  CreateDiagramLink overload for tree views

new in version 4.4:
  interactive CompositeNode components:
    button and check box
    editable text area
    slider and spinner
  FlowchartLayout improvements

new in version 4.3.3:
  Java 10 compatibility
  multi-line text in tables and containers
  text padding in container captions
  improved handling of containers by layout classes
  fixes exception in CascadeLayout

new in version 4.3.2:
  export Excel files
  greatly reduced memory footprint

new in version 4.3.1:
  ShapeNode shapes can be flipped
  AllowSplitLinks supported for Bezier links
  PanAndModify behavior
  IntermediateShape supported for Spline links
  updateRuntimeIndices method
  Brush and Pen moved to com.mindfusion.drawing

new in version 4.3:
  new Spline shape implemented for links
  static finals replaced by enum types
  SegmentCount settable for auto-routed links
  builder classes for fluent API
  SvgExporter fix for embedded image positions
  setLicenseKey fix for non-Oracle JREs

new in version 4.2:
  free-form nodes
  convert free-form drawings to ShapeNodes
  TreeViewNode scroll fixes
  HandlesStyle now serialized by DiagramNode
  AdjustmentHandle class represents handles

new in version 4.1.4:
  resize table columns and rows
  undo / redo records for in-place edit
  KeepInsideDiagram node constraint
  StartPoint and EndPoint link properties
  mouse capture in ControlNodes
  improved dash-frame default colors

new in version 4.1.3:
  LayoutTraits keys changed to enumerations
  LayoutTraits serialization in binary format
  changeUnit now also scales pen widths
  overloaded setBounds moves node w/o updating links
  fixed bug in setMeasureUnit
  fixed container-fold bug after XML deserialization
  fixed warnings in JDiagram and samples' code

new in version 4.1.2:
  improved quality of print preview page images
  TabbedScrollPane.AllowTabReorder property
  changeUnit method sets MeasureUnit and scales items
  associate AnchorPattern with Shape definitions
  XUnit and YUnit properties added to AnchorPoint
  PdfExporter.DisableTextClipping property added
  fixed node spacing in bottom-to-top TreeLayout

new in version 4.1.1:
  mitered joints in arrowhead shapes
  shadow of arrowhead matches its brush transparency
  Shape.LinkSegmentInset property added
  IntermediateShape is rendered for Bezier link
  fill background of link labels
  fixed glitch in CaptionBackBrush rendering
  multiple-resize fix for rotated nodes

new in version 4.1:
  create composite nodes from various kinds of components
  TreeMapLayout tree mapping algorithm
  DecisionLayout algorithm for arranging simple flowcharts
  export Visio 2013 VSDX files
  VisioImporter now supports Visio group shapes
  Improved PdfExporter performance
  layout classes automatically resize Diagram.Bounds

new in version 4.0.5:
  resize multiple selected nodes simultaneously
  ImportItemEvent provides access to Visio shape master XML
  VisioImporter supports more types of connectors and curves
  LinkLabel improvements and fixes
  set ZoomControl's width > height to change its orientation
  setZoomFactor updates ZoomControl trackbar position
  the pan widget now fills the ZoomControl width or height

new in version 4.0.4:
  rounded segment joints for polyline and cascading links
  import Visio 2013 .vsdx files
  import OpenOffice Draw files
  ZoomControl UI for changing zoom level and scroll position
  star shapes with 4/5/6/7/16/24/32 vertices
  new shapes: RightTriangle, Decagon, Trapezoid, Donut, Plaque
  Permissions attribute added to applet manifest

new in version 4.0.3:
  HatchBrush class allows filling shapes with a pattern
  Centimeter and WpfPoint measure units
  RotationHandleBrush property added to HandlesVisualStyle
  RoundAndSquare and RoundAndSquare2 handle styles
  access shape decorations via Shape.getDecorations method
  Scrollable property added to TreeViewNode

new in version 4.0.2:
  local Z order in containers
  improved interaction with containers in multiple selection
  clip child items to their container's borders
  ScrollZoneSize controls the auto-scroll distance from view edges
  improvements in auto-layout of link labels
  DiagramLink.intersects checks whether links intersect

new in version 4.0.1:
  preserve order in tree layout
  apply distinct brushes to different arrowheads of links
  undirected path finding
  ContainerNode properties to prevent adding or removing children
  SelectOnly behavior allows users to only select items
  FontUnit property in Style classes
  styled text can contain <br> tags to force line breaks
  Cell.TextPadding specifies text margins of table cells

new in version 4:
  Glass and Aero visual effects
  styles and themes
  multi-page diagram documents and tabbed views
  all node types support rotation
  rotation of attached nodes when rotating groups
  node list-view control
  layers and layer list-view control
  one-way graph layout
  round-rect shape for containers and tree views
  magnifier tool
  link labels can be arranged automatically
  TextPadding property added
  support for custom ruler units
  
new in version 3.5:
  use Java Swing components as nodes
  load UI controls in single applet instance
  improved path-finding for long links in QuickRouter
  SwimlaneLayout improvements
  %T shows total number of pages in print header 

new in version 3.4:
  interactive node alignment via alignment guides
  FractalLayout tree layout algorithm
  getAllIncomingLinks, getAllOutgoingLinks, getAllLinks methods
  PdfExporter can now be used from Java 7
  rotated nodes are now aligned to the grid when moved
  KeepRatio node constraint
  KeepInsideParent node constraint
  DisableMirroring node constraint

new in version 3.3:
  OrthogonalLayout improved to create less link bends
  specify start and end nodes for LayeredLayout
  improved alignment in FlowchartLayout branches
  the DiagramItem.Query method implements relationship queries on the graph
  DiagramLinks can display multiple labels

new in version 3.2:
  support for background swimlane grid
  Swimlane diagram layout algorithm
  Cascading graph layout algorithm
  Triangular graph layout algorithm
  Hierarchical graph layout algorithm
  Ortogonal graph layout improvements

new in version 3.1:
  topological graph layout algorithm
  shadows can be painted using any brush type
  support for custom arrowheads
  Granularity property added to QuickRouter
  ShowToolTips property added to DiagramView

new in version 3.0:
  the TreeViewNode class represents nodes that can display hierarchical data
  Ruler control
  export diagrams to SVG
  Link routing enhancements
  Flowchart graph layout
  LayeredLayout can straighten links that cross multiple layers in the graph
  Frozen nodes in SpringLayout
  Organizational charts with assistant nodes as in MS Office
  improved speed of GridLayout and OrthogonalLayout
  Adjustment handles styling
  new ScriptHelper methods
  DiagramApplet provides local clipboard support
  Shape elements can be assigned distinct color and line styles
  ShapeListBox.ShowLabels specifies whether to display item labels
  links custom drawing
  PdfExporter creates hyperlinks for nodes whose HyperLink property is set
  drawForeground event lets your render custom graphics in the diagram foreground

new in version 2.2:
  PdfExporter lets you export JDiagram documents to PDF

new in version 2.1:
  Orthogonal graph layout algorithm
  Circular graph layout algorithm
  mergeUndoRecords() lets you merge multiple undo records into a composite one
  setExpandButtonPosition() sets the position of collapse/expand icons

new in version 2.0:
  model / view architecture
  clipboard support
  container nodes
  laying out unconnected subgraphs so that the diagram covers a minimal area
  Orthogonal graph layout
  the text of links can be edited in-place 

new in version 1.2.2:
  wrapping text to new lines can be disabled, clipping the text if it overflows
  now text can wrap to a new line at arbitrary position in the text
  ScriptHelper.loadShapeLibrary lets you load a custom shape library from JavaScript
  ScriptHelper.createTextFormat lets you create TextFormat objects from JavaScript
  FlowChartApplet.createFlowChart can be overridden to return an object derived from FlowChart
  the OverviewApplet class implement an applet that wraps the Overview control
  BehaviorType.Pan enables panning without using the Alt key
  the ENTER and ESC keys can be used to accept or cancel inplace editing
  now the itemModified event lets you find out the selection handle used to modify an item
  the nodesIntersect method lets you find out if two nodes are overlapping
  the cancelDrag method of ValidationEvent lets you immediately cancel the operation

new in version 1.2.1:
  now AnnealLayout takes into consideration the size of nodes
  the Overview tracking rectangle borders width does not depend on the zoom level
  the tracking rectangle follows the mouse more precisely
  setTrackingRectPen lets you specify the color and width of the tracking rectangle borders
  the itemSelecting validation event is called when an user tries to select an item
  mouseEnterItem / mouseLeaveItem events raised when the mouse enters / leaves an item
  a custom shape definition can have a text area larger than the box bounds
  some drawing glitches have been fixed
  text smoothing mode is set separately from the drawing primitives one using setTextAntiAlias
  setHitTestPriority lets you change the order in which items are hit-tested
  the shape of items is considered when selecting them with a selection rectangle
  resizeToFitText makes a box big enough to display its text without clipping

new in version 1.2:
  an Overview control that provides a scaled-down view of the diagram
  a ShapeListBox control that displays shapes icons and allows drag-and-drop creation of boxes
  support for Shape Library XML files that contain custom shape definitions
  AnnealLayout layout class
  the setImageUrl method lets you load a background image from URL
  the getNodesAt method lets you find all nodes lying at the specified location.
  the setRotateText method lets you enable or disable text rotation in boxes
  the resizeToFitText resizes a tables rows and columns so that the table cells fit their text

new in version 1.1:
  now SaveToString and LoadFromString use base64 encoding 
  print preview window
  print scaling
  XML serialization into/from String objects
  itemDeleting event added
  the FlowChartApplet class lets you use JDiagram as an applet
  MeasureUnit property added

version 1.0:
  initial release


***** CONTACT US *****

for any questions you might have about using the control:
support@mindfusion.eu
+359 888 951737

for administrative and sales information:
sales@mindfusion.eu

our web site:
https://mindfusion.dev


***** COPYRIGHTS *****

Copyright (C) 2005-2026, MindFusion LLC - Bulgaria
All rights reserved.