jfreechart

****************************** * JFREECHART: Version 0.9.20 * ****************************** 7 June 2004 (C)opyright 2000-2004, by Object Refinery Limited and Contributors. ----------------- 1. INTRODUCTION ----------------- JFreeChart is a free chart library for the Java(tm) platform. It runs on the Java 2 Platform (JDK 1.2.2 or later) and uses the Java 2D API for drawing. JFreeChart is licensed under the terms of the GNU Lesser General Public Licence (LGPL). A copy of the licence is included in the distribution. Please note that JFreeChart is distributed WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. Please refer to the licence for details. SPECIAL NOTE: THE JFREECHART API IS NOT YET STABLE. IT IS SUBJECT TO CHANGE UNTIL VERSION 1.0.0 IS RELEASED. ------------------- 2. LATEST VERSION ------------------- The latest version of this class library can be obtained from: http://www.jfree.org/jfreechart/index.html If you have an comments, suggestions or bugs to report, please post a message in the JFreeChart forum. ----------------- 3. DOCUMENTATION ----------------- You can download installation instructions (jfreechart-0.9.20-install.pdf) from the JFreeChart home page or the project page on SourceForge. Further documentation for JFreeChart (the JFreeChart Developer Guide) is available to purchase from by Object Refinery Limited, a company owned and operated by David Gilbert (the original author of JFreeChart). For more information, please see: http://www.object-refinery.com/jfreechart/guide.html Sales of the JFreeChart Developer Guide are an important source of funding for the project. Please help us to continue developing free software. Javadoc HTML files are available on-line. If you wish to keep a local copy of the Javadoc files, you can regenerate the Javadocs directly from the source code. You can do this using the 'javadoc' utility directly, or with the Ant script (build.xml) included in the distribution. ----------------- 4. DEPENDENCIES ----------------- JFreeChart has the following dependencies: (a) JDK 1.2.2 or higher - JFreeChart requires the Java2D and Collections APIs, so it won't work with JDK 1.1. If you are using JFreeChart to create applets, this means that you cannot rely on the JVM integrated with Microsoft's Internet Explorer - your users will need to have the Java 2 plug-in installed. Most other browsers (e.g. Mozilla/Netscape, Galeon, Konqueror) support JDK 1.4. (b) JCommon - version 0.9.3 or later. The runtime jar file is included in the JFreeChart distribution. You can obtain the complete source code for JCommon from: http://www.jfree.org/jcommon/index.html JCommon is licensed under the terms of the GNU Lesser General Public Licence. (c) GNU JAXP - a free implementation of the standard XML processing APIs for Java. http://www.gnu.org/software/classpathx/jaxp/ Classes in the org.jfree.data.xml package require this library, or another JAXP v1.1 compliant parser. The gnujaxp.jar file (from the gnujaxp-1.0beta1.zip distribution) is included with JFreeChart. GNU JAXP is licensed under the terms of the GNU General Public License with an additional library exception. (d) servlet.jar - NOT INCLUDED IN THE DISTRIBUTION. You need to obtain a copy of this file (I used the one in the Tomcat 4.1.18 distribution) and put it in the 'lib' directory if you want to recompile JFreeChart. Classes in the org.jfree.chart.servlet package require this file. (e) JUnit - a unit testing framework (the junit.jar runtime file is included in the distribution). JUnit is licensed under the terms of the IBM Common Public License. You can find out more about JUnit and/or download the latest version from: http://www.junit.org The JUnit tests included with JFreeChart have been created using JUnit 3.8. -------------------- 5. ANT BUILD SCRIPT -------------------- An Ant build script (build.xml) is included in the distribution. This is the same script that is used to create the JFreeChart distribution. For more information about Ant: http://ant.apache.org/ Please note that you will need to obtain the servlet.jar file (see the DEPENDENCIES section above) before running the Ant script. ------------------------ 6. THE DEMO APPLICATION ------------------------ The main demonstration application is called JFreeChartDemo. To run it you need the files jcommon-0.9.5.jar, jfreechart-0.9.20.jar and jfreechart-0.9.20-demo.jar. Using JDK 1.2.2 (or later) you can start the demo by running the class: org.jfree.chart.demo.JFreeChartDemo. Use the following command: java -jar jfreechart-0.9.20-demo.jar Alternatively, you can specify the class and classpath via the command line. For example, on Linux, the following command line will run the demo application: java -classpath lib/jcommon-0.9.5.jar:jfreechart-0.9.20.jar:jfreechart-0.9.20-demo.jar org.jfree.chart.demo.JFreeChartDemo Depending on your system configuration and the current working directory, you may need to specify paths in the above command line. If you are using Windows, please note that the entries on the class path should be separated with a semi-colon rather than a colon: java -classpath lib/jcommon-0.9.5.jar;jfreechart-0.9.20.jar;jfreechart-0.9.20-demo.jar org.jfree.chart.demo.JFreeChartDemo There are also more than 100 other demonstration applications included in the download: org.jfree.chart.demo.AreaChartDemo org.jfree.chart.demo.BarChartDemo1 org.jfree.chart.demo.BarChartDemo2 org.jfree.chart.demo.BarChartDemo3 org.jfree.chart.demo.BarChart3DDemo1 org.jfree.chart.demo.BarChart3DDemo2 org.jfree.chart.demo.BoxAndWhiskerDemo org.jfree.chart.demo.BubblePlotDemo org.jfree.chart.demo.BubblyBubblesDemo org.jfree.chart.demo.BubblyBubblesDemo2 org.jfree.chart.demo.CandlestickDemo org.jfree.chart.demo.CombinedCategoryPlotDemo1 org.jfree.chart.demo.CombinedCategoryPlotDemo2 org.jfree.chart.demo.CombinedXYPlotDemo1 org.jfree.chart.demo.CombinedXYPlotDemo2 org.jfree.chart.demo.CombinedXYPlotDemo3 org.jfree.chart.demo.CombinedXYPlotDemo4 org.jfree.chart.demo.CompassDemo org.jfree.chart.demo.CompassDemo2 org.jfree.chart.demo.ContourPlotDemo org.jfree.chart.demo.ContourPlotDemo2 org.jfree.chart.demo.DifferenceChartDemo org.jfree.chart.demo.DualAxisDemo org.jfree.chart.demo.DualAxisDemo2 org.jfree.chart.demo.DualAxisDemo3 org.jfree.chart.demo.DualAxisDemo4 org.jfree.chart.demo.DynamicDataDemo org.jfree.chart.demo.EventFrequencyDemo org.jfree.chart.demo.FastScatterPlotDemo org.jfree.chart.demo.GanttDemo1 org.jfree.chart.demo.GanttDemo2 org.jfree.chart.demo.HighLowChartDemo org.jfree.chart.demo.ImageMapDemo1 org.jfree.chart.demo.ImageMapDemo2 org.jfree.chart.demo.ImageMapDemo3 org.jfree.chart.demo.InternalFrameDemo org.jfree.chart.demo.IntervalBarChartDemo1 org.jfree.chart.demo.LegendManiaDemo org.jfree.chart.demo.LineChartDemo1 org.jfree.chart.demo.LineChartDemo2 org.jfree.chart.demo.LineChartDemo3 org.jfree.chart.demo.LineChartDemo4 org.jfree.chart.demo.LineChartDemo5 org.jfree.chart.demo.MarkerDemo1 org.jfree.chart.demo.MeterPlotDemo org.jfree.chart.demo.MinMaxCategoryPlotDemo org.jfree.chart.demo.MouseZoomDemo org.jfree.chart.demo.MovingAverageDemo org.jfree.chart.demo.MultiPieChartDemo org.jfree.chart.demo.MultiPieChartDemo2 org.jfree.chart.demo.MultipleAxisDemo1 org.jfree.chart.demo.MultipleAxisDemo2 org.jfree.chart.demo.OverlaidBarChartDemo org.jfree.chart.demo.OverlaidCategoryChartDemo org.jfree.chart.demo.OverlaidXYPlotDemo org.jfree.chart.demo.OverlaidXYPlotDemo2 org.jfree.chart.demo.ParetoChangeDemo org.jfree.chart.demo.PieChart3DDemo1 org.jfree.chart.demo.PieChart3DDemo2 org.jfree.chart.demo.PieChartDemo1 org.jfree.chart.demo.PieChartDemo2 org.jfree.chart.demo.PieChartDemo3 org.jfree.chart.demo.PieChartDemo4 org.jfree.chart.demo.PopulationChartDemo org.jfree.chart.demo.PriceVolumeDemo org.jfree.chart.demo.ScatterPlotDemo org.jfree.chart.demo.ScatterPl