Developers only need to include the charts4j.jar in their classpath. It is available in the charts4j.zip file. The application must also be connected to the Internet because the charts are ultimately rendered by the Google Chart API server.
Developers who are using charts4j for the first time should start off by examining the {@link com.googlecode.charts4j.Data} and {@link com.googlecode.charts4j.DataUtil} classes. Next, they can build charts via the {@link com.googlecode.charts4j.GCharts} static factory class.
All data provided to charts4j is expressed as numbers between 0 and 100. If your data does not fall in that range, you will have to scale it so it does fall in that range. The {@link com.googlecode.charts4j.DataUtil} class can help scale data. Also note that {@link com.googlecode.charts4j.AbstractAxisChart#setGrid(double,double,int,int) grids}, {@link com.googlecode.charts4j.AxisLabelsFactory axis labels positions}, {@link com.googlecode.charts4j.Markers markers} are all expressed in the 0 to 100 range so that chart elements defined by the developer snap together consistently and nicely.
Another interesting feature of charts4j: {@link com.googlecode.charts4j.Plot}s can be incorporated into more than one chart type. In particular, they can be incorporated into
Chart URLs {@link com.googlecode.charts4j.GChart#toURLString() generated} by charts4j can then be incorporated into a web or Internet application. In a JSP / Servlet environment, generate the URL in the servlet and insert that URL in the JSP for display of the chart.
1. As of May 2009, the chart types that are not supported are QR Codes, map pins, sticky notes, information bubbles, text with outline. There are also a few other Google Chart API features that have not been exposed in charts4j. If this is a problem for you please submit an issue, and we will look into it as soon as possible.