Orson Charts
(C)opyright 2013-2020, by Object Refinery Limited. All rights reserved.
Version 2.0, 15 March 2020.
Overview
Orson Charts is a 3D chart library for the Java(tm) platform that can generate a wide variety of 3D charts for use in client-side applications (JavaFX and Swing) and server-side applications (with export to PDF, SVG, PNG and JPEG).
Key features include:
- multiple chart types: pie charts, bar charts (regular and stacked), line charts, area charts, scatter charts and surface plots;
- mouse-enabled chart viewers in JavaFX and Swing provide 360 degree rotation and zooming for precise end-user view control;
- configurable tool tip support;
- interactive charts (mouse event support on all chart elements);
- flexible data sources;
- JSON format data import and export;
- regular and logarithmic axis scales;
- auto-adaptive axis labeling;
- value and range marker annotations
- support for PDF, SVG, PNG and JPG export of charts for reporting;
- a clean and well-documented API with a high degree of chart configurability.
Orson Charts is very easy to use, and includes comprehensive Javadocs. It is licensed under the terms of the GNU General Public License version 3 or later. For companies that do not wish to be bound by the terms of the GPLv3, a commercial license can be purchased from Object Refinery Limited. The license permits royalty-free redistribution of the Orson Charts runtime jar file. Orson Charts requires JDK/JRE 11 or later. To use Orson Charts with JavaFX requires the Orson Charts FX extension project.
Documentation
The Javadoc generated documentation is the principal source of documentation for Orson Charts:
http://www.object-refinery.com/orsoncharts/javadoc/index.html
If there are topics that are not covered or not clear in the documentation, please let us know so that we can improve the coverage.
Demos
Demo applications can be found in the following projects at GitHub:
Building
You can build Orson Charts using Maven by issuing the following command from the root directory of the project:
mvn clean install
The build requires JDK 11 or later.
Reporting Bugs
If you find a bug in Orson Charts, please file a bug report at:
https://github.com/jfree/orson-charts/issues
More Info
You can find out more about Orson Charts at:
http://www.object-refinery.com/orsoncharts/
If you have any questions, don't hesitate to send a mail to [email protected].
History
Version 2.1 : not-yet-released
- upgrade JUnit to version 5.
Version 2.0 : 15-Mar-2020
- created a Java module (
org.jfree.chart3d
); - refactored into
org.jfree.chart3d
namespace; - fixed bug #4 in
NumberAxis3D
where tick label override is not applied.
Version 1.7 : 17-Nov-2017
- removed JavaFX support to a separate project Orson Charts FX;
- fixed cell content bug in
GridElement
; - fixed bug in
GradientColorScale
; - protect from
NullPointerException
inAbstractValueAxis3D
; - streamline build by removing Ant build support and moving demo code to external projects.
Version 1.6 : 2-Nov-2016
- added
remove()
method toXYZSeries
and added change notification mechanism; - added
remove()
andremoveAll()
methods toXYZSeriesCollection
and added change notification; - added generics to source files;
- updated
FXGraphics2D
to version 1.5; - updated
JFreeSVG
to version 3.2.
Version 1.5 : 28-Jan-2016
- added new
LineXYZRenderer
; - added option to invert axes;
- fix exception when setting a new dataset using
CategoryPlot3D.setDataset()
: - fix direction of mouse wheel zooming in JavaFX;
- included FXGraphics2D version 1.3 as a dependency;
- updated OrsonPDF to version 1.7;
- updated JFreeSVG to version 3.0;
- added
pom.xml
for Maven builds; - JavaFX demos brought up to match the Swing demos;
- various Javadoc improvements.
Version 1.4 : 27-May-2014
- added JavaFX support;
- added support to marker elements and item labels for
KEY_BEGIN_ELEMENT
andKEY_END_ELEMENT
rendering hints; - added
JPEG
export option; - added
minAutoRangeLength
attribute inAbstractValueAxis3D
(this fixes a bug for plots where the length of the data range is zero, for example scatter plots with a single value); - fixed endless loop in axis range code for datasets with infinite values;
- fixed bug in hinting for tick labels on
NumberAxis3D
; - fixed
Utils.js
functions that didn't work with Internet Explorer 9.
Version 1.3 : 11-Apr-2014
- added chart mouse event and tooltip support for the chart viewer in Swing;
- added item label support;
- added
JSON
format data import and export; - new utility methods to extract an
XYZDataset
from aCategoryDataset3D
; - fixed a clipping issue for panels with borders assigned;
- added rendering hints for SVG output via JFreeSVG (to support tool-tips and mouse events on chart elements);
- added JavaScript utility library to support JFreeSVG export;
Version 1.2 : 7-Mar-2014
- added value and range markers for numerical axes, and category markers for category axes;
- added a
tickLabelOrientation
attribute for axes so that tick labels can be drawn either perpendicular or parallel to the axis line; - added a logarithmic axis;
- added theme support, with several built-in themes;
- added template driven label generators for pie section labels and category axis labels;
- added export to
JPEG
, plus options to configure the available export types; - optimized the rendering code to reduce memory usage;
- put in place a localisation mechanism, and added German and Italian translations;
- made the projection distance configurable in the chart viewer;
- added series accessors for
XYZSeriesCollection
; - added
yDimensionOverride
attribute forCategoryPlot3D
; - fixed an issue with the
StackedBarRenderer
and negative values; - incorporated various other bug fixes.
Version 1.1 : 23-Dec-2013
- added surface plots (via the new
SurfaceRenderer
class andChart3DFactory.createSurfaceChart()
); - added
ColorScale
and supporting classes for use by the surface charts; - added orientation attribute to control the chart legend orientation;
- optimized rendering code for improved performance;
- added missing change events for gridline attributes in
CategoryPlot3D
; - added constants including
SCALE_TO_FIT_TARGET
andCENTER_NO_SCALING
to theFit2D
class; - added
setColors(Color...)
toAbstractCategoryRenderer3D
andAbstractXYZRenderer3D
;
Version 1.0 : 17-Nov-2013
This is the first public release of Orson Charts, we welcome your feedback and suggestions.