XCL-Charts图表库中柱形图的同源风格切换介绍

时间：2023-03-09 18:43:21
XCL-Charts图表库中柱形图的同源风格切换介绍

柱形图是被使用最多的图之中的一个，在写XCL-Charts这个Android图表库时，为它花费的时间相当多，不是由于有多难绘制，而是要在设计时怎样才干保证图基类能适应各种情况，能灵活满足足够多的需求，以及够简洁的接口，并要开放出足够多的绘制元素和參数供开发者定制，同一时候对各类柱形图独有的的特点要加以突出，再加上柱形图的选项本身相对于其他图来说也是相当多的，所以花了比較多的时间。结果嘛，至少我自己临时认为还算不错。

这里我仅仅简单给大家介绍XCL-Charts图表库中柱图一个比較有意思的特点: 柱形图在使用同一数据源情况下，实现显示风格的灵活切换。

首先介绍下数据源:

XCL-Charts柱形图的数据源我将其定义的相当简单，就三大元素:

键值,数据序列,柱形颜色 

BarData(String key,List<Double> dataSeries,Integer color)

其次，看看实现风格切换:

我在图表库Demo中，举了以下这样一个样例, 对于传入的同一个数据源，XCL-Charts支持在6种形式的柱形图风格间进行切换。

XCL-Charts图表库中柱形图的同源风格切换介绍

经过封装，在XCL-Charts中实现这个效果代码在相当少的:

/**

 * Copyright 2014  XCL-Charts

 *

 * Licensed under the Apache License, Version 2.0 (the "License");

 * you may not use this file except in compliance with the License.

 * You may obtain a copy of the License at

 *

 *     http://www.apache.org/licenses/LICENSE-2.0

 *

 * Unless required by applicable law or agreed to in writing, software

 * distributed under the License is distributed on an "AS IS" BASIS,

 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

 * See the License for the specific language governing permissions and

 * limitations under the License.

 *

 * @Project XCL-Charts

 * @Description Android图表基类库

 * @author XiongChuanLiang<br/>(xcl_168@aliyun.com)

 * @Copyright Copyright (c) 2014 XCL-Charts (www.xclcharts.com)

 * @license http://www.apache.org/licenses/  Apache v2 License

 * @version v0.1

 */

package com.demo.xclcharts.view;

import java.text.DecimalFormat;

import java.util.LinkedList;

import java.util.List;

import org.xclcharts.chart.BarChart3D;

import org.xclcharts.chart.BarChart;

import org.xclcharts.chart.BarData;

import org.xclcharts.chart.StackBarChart;

import org.xclcharts.common.IFormatterDoubleCallBack;

import org.xclcharts.common.IFormatterTextCallBack;

import org.xclcharts.renderer.XEnum;

import android.content.Context;

import android.graphics.Canvas;

import android.graphics.Color;

import android.util.Log;

/**

 * @ClassName SpinnerBarChart01View

 * @Description  柱形图同数据源不同柱形图切换的样例

 * @author XiongChuanLiang<br/>(xcl_168@aliyun.com)

 */

public class SpinnerBarChart01View extends GraphicalView {

	private String TAG = "SpinnerBarChart01View";

	private int mChartStyle = 0;

	private int mOffsetHeight = 0;

	private BarChart mChart = null;

	//标签轴

	private List<String> chartLabels = new LinkedList<String>();

	private List<BarData> chartData = new LinkedList<BarData>();

	public SpinnerBarChart01View(Context context,int chartStyle,int offsetHeight) {

		super(context);

		// TODO Auto-generated constructor stub

		mChartStyle = chartStyle;

		mOffsetHeight = offsetHeight;

		chartLabels();

		chartDataSet();

		chartRender();

	}

	private void initChart(int chartStyle)

	{

		switch(chartStyle)

		{

		case 0: //竖向柱形图

			mChart = new BarChart();

			//图例

			mChart.getLegend().setLeftLegend("百分比");

			break;

		case 1:	//横向柱形图

			mChart = new BarChart();

			mChart.setChartDirection(XEnum.Direction.HORIZONTAL);

			break;

		case 2:	//竖向3D柱形图

			mChart = new BarChart3D();

			break;

		case 3:	//横向3D柱形图

			mChart = new BarChart3D();

			mChart.setChartDirection(XEnum.Direction.HORIZONTAL);

			break;

		case 4:	//竖向堆叠柱形图

			mChart = new StackBarChart();

			((StackBarChart) mChart).setTotalLabelVisible(false);

			break;

		case 5:	//横向堆叠柱形图

			mChart = new StackBarChart();

			mChart.setChartDirection(XEnum.Direction.HORIZONTAL);

			((StackBarChart) mChart).setTotalLabelVisible(false);

			break;

		}

	}

	public void chartRender()

	{

		try {

			initChart(mChartStyle);

			//图所占范围大小

			mChart.setChartRange(0.0f, mOffsetHeight, getScreenWidth(),getScreenHeight() - mOffsetHeight);

			if(mChart.isVerticalScreen())

			{

				mChart.setPadding(5, 40, 10, 15);

			}else{

				mChart.setPadding(10, 45, 15, 15);

			}

			//数据源

			mChart.setDataSource(chartData);

			mChart.setCategories(chartLabels);	

			//数据轴

			mChart.getDataAxis().setAxisMax(100);

			mChart.getDataAxis().setAxisMin(0);

			mChart.getDataAxis().setAxisSteps(20);

			//定义数据轴标签显示格式

			mChart.getDataAxis().setLabelFormatter(new IFormatterTextCallBack(){

				@Override

				public String textFormatter(String value) {

					// TODO Auto-generated method stub

					Double tmp = Double.parseDouble(value);

					DecimalFormat df = new DecimalFormat("#0");

					String label = df.format(tmp).toString();

					return label+"%";

				}

			});

			//定义柱形上标签显示格式

			mChart.getBar().setItemLabelVisible(true);

			mChart.getBar().getItemLabelPaint().setColor((int)Color.rgb(72, 61, 139));

			mChart.getBar().getItemLabelPaint().setFakeBoldText(true);

			mChart.setItemLabelFormatter(new IFormatterDoubleCallBack() {

				@Override

				public String doubleFormatter(Double value) {

					// TODO Auto-generated method stub

					DecimalFormat df=new DecimalFormat("#0");

					String label = df.format(value).toString();

					return label+"%";

				}});

		} catch (Exception e) {

			// TODO Auto-generated catch block

			Log.e(TAG, e.toString());

		}

	}

	private void chartDataSet()

	{

		//标签相应的柱形数据集

		List<Double> dataSeriesA= new LinkedList<Double>();

		dataSeriesA.add(50d);

		dataSeriesA.add(25d);

		dataSeriesA.add(20d);

		BarData BarDataA = new BarData("Google",dataSeriesA,(int)Color.rgb(73, 135, 218));

		List<Double> dataSeriesB= new LinkedList<Double>();

		dataSeriesB.add(35d);

		dataSeriesB.add(65d);

		dataSeriesB.add(75d);

		BarData BarDataB = new BarData("Baidu",dataSeriesB,(int)Color.rgb(224, 4, 0));

		List<Double> dataSeriesC= new LinkedList<Double>();

		dataSeriesC.add(15d);

		dataSeriesC.add(10d);

		dataSeriesC.add(5d);

		BarData BarDataC = new BarData("Bing",dataSeriesC,(int)Color.rgb(255, 185, 0));

		chartData.add(BarDataA);

		chartData.add(BarDataB);

		chartData.add(BarDataC);

	}

	private void chartLabels()

	{

		chartLabels.add("路人甲");

		chartLabels.add("路人乙");

		chartLabels.add("路人丙");

	}	

	@Override

    public void render(Canvas canvas) {

        try{

        	mChart.render(canvas);

        } catch (Exception e){

        	Log.e(TAG, e.toString());

        }

    }

}

6种图各有各的特点，但在上面代码却能够看到，在XCL-Charts中使用柱形图是件很easy的事，甚至有没这样的感觉，传入数据轴和标签轴数据源的代码，比设置画图属性的代码很多其它? 当然代码少不代表效果阳春白雪。

效果图例如以下:

XCL-Charts图表库中柱形图的同源风格切换介绍 XCL-Charts图表库中柱形图的同源风格切换介绍 XCL-Charts图表库中柱形图的同源风格切换介绍

XCL-Charts图表库中柱形图的同源风格切换介绍 XCL-Charts图表库中柱形图的同源风格切换介绍 XCL-Charts图表库中柱形图的同源风格切换介绍

上面这些图仅仅是用最简单的方式展示了下柱形图风格的切换，这个样例并没有展示XCL-Charts灵活的定制性。而图表库在设计时，

花时间最多的就是在其定制性上，由于我觉得图表库主要就是封装绘制图表时其本身的位置计算，逻辑处理等详细过程，而其他一切

參数与绘制元素都应当是可供定制的。所以XCL-Charts中画图相关的各个元素和參数，差点儿都开放出来供用户定制，在这就不细说了。

当然假设你留意下样例中的代码，也能够看出一部份特点来. 我把图中相关元素分别单立封装成了一个个类，如轴分为数据轴和标签轴，

用于管理轴各自相关的一切属性。而柱形则归于bar这个类去处理。 而对于标签文字的显示等，则採用回调函数的方式开放出来，让用户自己定义格式，

当然，不实现回调也没关系，会按默认的显示风格显示。

只是我也不是蛮干，啥都自定义，在有些地方能够看到，我开放了Canvas的Paint画笔对象出来，这样用户能够直接操控Android本身的画笔对象类，利用Android自己的函数和属性来定制效果，即够灵活，我也省事。嘿嘿.

这个样例中显露的也仅仅是一点点功能而已,远不止这点功能。感兴趣的能够自己去下代码，看下我写的Demo。

另外再提一句，XCL-Charts是利用Android Canvas相关的函数来绘制图表，相比于调用Web的各类js图表库来说，是具有原生优势的。假设有

图表需求的，能够来尝试尝试。

 XCL-Charts是开源的，基于Apache v2 License开源协议。

开源中国收录的项目地址:

         http://www.oschina.net/p/xcl-charts



       代码分别托管在开源中国和GitHub上:

    开源中国上的代码托管地址:

           https://git.oschina.net/xclcharts/XCL-Charts



        GitHub上的代码托管地址:

           https://github.com/xcltapestry/XCL-Charts

对这个库感兴趣的能够关注下。

还有就是我前几天才公布的这个图表库，仅仅在****自己博客发了篇通知和EOE论坛上发了个帖，没想到关注的人蛮多的，还有网友留言支持。真没想到，在这谢谢了。

个人觉得，Android图表事实上是个非常小众的功能需求，当时折腾仅仅是纯兴趣。假设有留意我前段时间的博文就知道，当时事实上仅仅是学Canvas时觉得好玩，尝试实现了下在上面绘制各种图，没想到折腾出来的这东东整理整理还算有点用。

特别是要谢谢开源中国,其代码托管速度蛮快的，另外收录的也非常快，我看了下，在"Android UI 组件"类别下的第4页就能找到了，在https://git.oschina.net/explore也上了推荐。

当然眼下要完好的东东还有非常多， 总之有人关注就有了继续弄的动力，哈哈。

MAIL: xcl_168@aliyun.com

Blog:http://blog.****.net/xcl168