Android 开源项目源码解析之HoloGraphLibrary 源码解析

1. 功能介绍

HoloGraphLibrary 是一个可用于绘制图表的项目，支持绘制线状图、柱状图、饼状图。

优点：图形设计友好，使用方便。

2. 总体设计

本项目较为简单，总体设计请参考4.1类关系图。

3. 流程图

本项目的每个控件的流程较为类似，可以抽象成一个流程图来理解。

4. 详细设计

4.1 类关系图

其中LineGraph、BarGraph、PieGraph分别对应线状图、柱状图、饼状图控件。
其他除 View 以外的类都表示封装的数据。

4.2 核心类功能介绍

4.2.1 柱状图：

Bar.java：用于表现一个柱体，构成柱状图的基本元素。封装了颜色，名字，BarStackSegment（下文将会涉及）数组等属性。若需要对Bar的每一个片段进行控制，改变BarStackSegment数组属性即可。

BarStackSegment.java：一般来说，一个柱体用于展示一个类型的数据，而BarStackSegment是作为柱体的扩展部分，用在同一个柱体上不同区间展示不同数据。

BarGraph.java：继承View类，表示柱状图控件，通过数据绘制负责柱状图。

(1). onDraw 流程图

(2). onDraw 源码分析
a. 绘制的样式定义（柱体颜色、宽度大小等属性）

public void onDraw(Canvas ca) {
    ...
    
    // 柱体的样式定义
    float maxValue = 0;
    float padding = 7;
    int selectPadding = 4;
    float bottomPadding = 40;

    // 定义绘制柱体的区间
    float usableHeight;
    if (showBarText) {
        this.p.setTextSize(40);
        this.p.getTextBounds(unit, 0, 1, r3);
        usableHeight = getHeight() - bottomPadding - Math.abs(r3.top - r3.bottom) - 26;
    } else {
        usableHeight = getHeight() - bottomPadding;
    }
    
    ...                    
    
    // 绘制柱体
    int count = 0;
    for (Bar p : points) {
        // 绘制每个柱体里的自定义区间
        if(p.getStackedBar()){
                 ...
        }else {
            // 若没有自定义区间，则正常绘制
            ...
        }
    }    
    ...
}

b. 绘制计算过程（详细看源码）
1）绘制 X 轴
2）确定柱体的数量
3）计算柱体所需的宽度
4）如果使用动画，柱体最大值（影响绘画的高度）使用动态计算的最大值
5）计算 X 轴上标签的字体的大小（不考虑动画状态，否则会导致字体抖动）
6）设置柱体边界
7）绘制柱体
8）创建选择区域
9）绘制标签
10）绘制柱体顶部的文字
11）限制总体宽度，防止弹出
12）若有使用后，设置监听，对进行动画更新

4.2.2 饼状图

PieSlice.java：扇形，构成饼状图的基本元素。封装了颜色，值，标题，路径以及区域等属性。

PieGraph.java：：继承View类，表示饼状图控件，通过数据绘制负责饼状图。

(1). onDraw 流程图

(2). 绘制计算过程（详细看源码）
1）若有背景图片，设置背景图片
2）设置扇形的开始的位置，大小，圆心
3）计算不同的扇形的大小，从上次结束的位置进行绘制，记录好该扇形结束的位置。重复此步骤，直到所有扇形绘制完成

4.2.3 折线图：

LinePoint.java：折线的最基本元素，两点构成一条直线，属性包括二维坐标，路径以及区域等属性。

Line.java：由点构成线，里面封装了一个包含LinePoint的数组。

LineGraph.java：：继承View类，表示折线图控件，通过数据绘制负责折线图。
(1). onDraw 流程图

(2). 绘制计算过程（详细看源码）
1）若需要填充，先对整个绘制范围内进行直线绘制，然后擦除折线以上的直线
2）绘制 X 轴
3）绘制折线
4）绘制折点

5. 杂谈

其实，这个项目的代码并不是写的很好，但无碍我们的使用，有兴趣的同学可以重构一下，也有开发者 fork 之后扩展得更加有趣。->链接。对于控件类的开源库，可以把重点放在绘制以及事件处理上。

本文为 Android 开源项目源码解析 中 HoloGraphLibrary 部分
项目地址：HoloGraphLibrary，分析的版本：028cd2a，Demo 地址：HoloGraphLibrary Demo
分析者：AaronPlay，校对者：lightSky，校对状态：完成