https://github.com/shannah/cn1-charts

Visual Charts Library for Codename One
https://github.com/shannah/cn1-charts

Last synced: 7 days ago
JSON representation

Visual Charts Library for Codename One

• Host: GitHub
• URL: https://github.com/shannah/cn1-charts
• Owner: shannah
• Created: 2013-07-31T18:04:16.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2013-12-09T16:55:33.000Z (about 11 years ago)
• Last Synced: 2024-12-24T05:04:38.276Z (16 days ago)
• Language: JavaScript
• Size: 6.1 MB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
#Codename One Charts

A library for creating visual charts in Codename One.

##Synopsis

This library allows you to create visual charts (e.g. bar charts, pie charts, time series charts, line charts, etc..) and embed them

in your [Codename One](http://www.codenameone.com/) application.  It was built by wrapping the powerful [Flot](http://www.flotcharts.org/) Javascript library

and exposing it's configuration options and methods as a Java API.

##License

[LGPL2](http://www.gnu.org/licenses/lgpl-2.1.html)

##Requirements

[Codename One](http://www.codenameone.com/) 1.0 or higher

(Previous builds required the CodenameOne Javascript bridge but this requirement has been removed).

##Platform Compatibility

1. Android.  Tested, Works.

2. Java SE (i.e. in the simulator).  Tested, Works

3. iOS. Should work using both build server and  [Offline build](http://sjhannah.com/blog/?p=228).

4. Windows Phone.  Not tested, but should work.  Please let me know if it doesn't!

##Download

* [CN1Charts.cn1lib](https://github.com/shannah/CN1-Charts/raw/master/dist/CN1Charts.cn1lib)

##Installation

Copy the [CN1Charts.cn1lib](https://github.com/shannah/CN1-Charts/raw/master/dist/CN1Charts.cn1lib) library into your project's lib directory.

##Usage

The general usage of this chart involves:

1. Create a Chart object which is the model of the chart.

2. Create a ChartView object with a Chart as its model, and initialize it.

3. Add the ChartView to the component hierarchy.

E.g. Creating a Pie Chart

![Pie Chart](https://github.com/shannah/CN1-Charts/raw/master/screenshots/piechart.png)

    Form hi = new Form("Pie Chart");

    hi.setLayout(new BorderLayout());

    ChartBuilder b = new ChartBuilder();

    Chart chart = b.newPieChart(

            new double[]{10, 22, 45},

            new String[]{"BC", "Alberta", "Saskatchewan"}

    );

    ChartView v = new ChartView(chart);

    v.initLater();

    hi.addComponent(BorderLayout.CENTER, v);

    hi.show();

E.g. Creating a Bar Chart

![Bar Chart](https://github.com/shannah/CN1-Charts/raw/master/screenshots/multibarchart.png)

    Form hi = new Form("Bar Chart");

    hi.setLayout(new BorderLayout());

    ChartBuilder b = new ChartBuilder();

    Chart chart = b.newBarChart(

            new double[][]{

                {1, 3, 2, 5},

                {3, 1, 2, 4},

                {7, 4, 1, 6},

                {2, 3, 4, 1}

            }, 

            new String[]{"BC", "Alberta", "Ontario", "Saskatchewan"},

            new String[]{"June", "July", "August", "Sept"}

    );

    ChartView v = new ChartView(chart);

    v.initLater();

    hi.addComponent(BorderLayout.CENTER, v);

    hi.show();

The ChartBuilder class is just a convenience class to build some common types of charts but

you can configure your chart using the specific configuration options themselves also:

E.g. Adding multiple Series to a chart, and configuring it to be a pie chart 

with specific "ticks".

    Chart chart = new Chart();

    for ( int i=0; i ticksArr = new ArrayList();

    for ( int i=0; i xAxes = new ArrayList();

    xAxes.add(xAxis);

    opts.xAxes(xAxes);

    chart.options(opts);

    return chart;

Most [configuration options for Flot](https://github.com/flot/flot/blob/master/API.md) have been wrapped in a Java API so you should be able

to look at examples of the Flot javascript library and translate them directly to the Java API.

##Documentation

* [Javadocs](https://rawgithub.com/shannah/CN1-Charts/master/dist/javadoc/index.html)

* [Flot Documentation](https://github.com/flot/flot/blob/master/API.md)

* [Sample Application](https://github.com/shannah/CN1-Charts-Sample-App)

##Contact

Steve Hannah [@shannah78](http://www.twitter.com/shannah78)