Android报表库aChartEngine系列（pie chart）

1、pie chart介绍

aChartEngine中的pie Chart其实就是一个饼状图，是数据显示的一种。效果如图：

 

2、如何使用pie chart。

其实aChartEngine是使用是非常简单的，不同的chart的使用方式都是一样的，并不需要我们根据不同的chart调用不同的接口，接口都是统一的。那么我们应该如何使用呢？总结了一下分为两步：

①获取数据dataSet；

②获取渲染器render。

其实这很好理解，一个图表其实本来就是一些数据的显示方式。所以你必须得有数据（dataset），有了数据之后你总得知道应该以什么样的方式来显示吧（render）。这么看来这两部分是缺一不可的，而且功能很明确。

 

3、demo。

package com.example.test;

import org.achartengine.ChartFactory;
import org.achartengine.model.CategorySeries;
import org.achartengine.renderer.DefaultRenderer;
import org.achartengine.renderer.SimpleSeriesRenderer;

import android.app.Activity;
import android.graphics.Color;
import android.os.Bundle;
import android.view.View;

public class MainActivity extends Activity {

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        double[] values = new double[] { 12, 14, 11, 10, 19 };
        int[] colors = new int[] { Color.BLUE, Color.GREEN, Color.MAGENTA, Color.YELLOW, Color.CYAN };
        DefaultRenderer renderer = buildCategoryRenderer(colors);
        renderer.setZoomButtonsVisible(true);
        renderer.setZoomEnabled(true);
        renderer.setChartTitleTextSize(20);
        //        Intent intent = ChartFactory.getPieChartIntent(this, buildCategoryDataset("Project budget", values), renderer, "Budget");
        //        startActivity(intent);
        View view = ChartFactory.getPieChartView(this, buildCategoryDataset("Project budget", values), renderer);
        view.setBackgroundColor(Color.BLACK);
        setContentView(view);
    }

    protected DefaultRenderer buildCategoryRenderer(int[] colors) {
        DefaultRenderer renderer = new DefaultRenderer();
        renderer.setLabelsTextSize(15);
        renderer.setLegendTextSize(15);
        renderer.setMargins(new int[] { 20, 30, 15, 0 });
        for (int color : colors) {
            SimpleSeriesRenderer r = new SimpleSeriesRenderer();
            r.setColor(color);
            renderer.addSeriesRenderer(r);
        }
        return renderer;
    }

    protected CategorySeries buildCategoryDataset(String title, double[] values) {
        CategorySeries series = new CategorySeries(title);
        int k = 0;
        for (double value : values) {
            series.add("Project " + ++k + " (" + value + ")", value);
        }
        return series;
    }
}

 

 

4、分析demo。

代码中比较关键的地方其实是 ChartFactory.getPieChartView，它返回一个view，也就是我们需要显示的chart。那么我们看看这个方法（在doc上有开发说明）：

public static final GraphicalView getPieChartView(android.content.Context context,
                                                  CategorySeries dataset,
                                                  DefaultRenderer renderer)

Creates a pie chart intent that can be used to start the graphical view activity. 

Parameters:

context - the context

dataset - the category series dataset (cannot be null)

renderer - the series renderer (cannot be null)

Returns:

a pie chart view

Throws:

java.lang.IllegalArgumentException - if dataset is null or renderer is null or if the dataset number of items is different than the number of series renderer。

所以需要两个非常重要的参数，也就是开始我们提到的dataset、renderer。具体是如何构造的见代码。

这里需要值一提的是dataset中的item数应该和renderer中的SeriesRenderer数相等。每组数据应该对已一个renderer，也就是说每一组数据都应有自己独立的显示样式。

 

5、总结。

pie Chart 是achartengine里面最简单的chart，使用起来很方便。它需要的dataset中需要离散的几个数，而不是离散的几个点。

在使用上面的代码前一定要引入achartengine1.0.0.jar包，如果运行时有找不到类、类定义这样的问题，也许我的博文http://www.cnblogs.com/vanezkw/archive/2012/06/25/2561393.html可以帮助到你。

我的另一篇博文http://www.cnblogs.com/vanezkw/archive/2012/07/27/2611177.html对achartengine做了简单的介绍。

欢迎交流。期待你的宝贵意见。