MPAndroidChart绘制K线图(一)

公司项目使用RN实现的k线图效果不忍直视,调试过很多个版本都没有达到理想的效果,于是想用原生来实现。经过调研选用的MPAndroidChart库(Github:https://github.com/PhilJay/MPAndroidChart), 实现效果还是挺满意的,虽然后来原生项目死掉了。。。但毕竟也花了时间,这里准备把在使用过程中遇到的疑难点整理成系列博文,基础的api介绍网上到处都是就不写了,希望能帮到有需要的人。

GitHub地址
自定义股线图StockChart

MPAndroidChart绘制K线图(一)高亮线自定义
MPAndroidChart绘制K线图(二)动态时间格式+高亮时底部滑动时间刻度
MPAndroidChart绘制K线图(三)长按高亮,双击事件,缩放中心点变换,图表联动,跨表缩放失效

效果图


image

一、MpAndroidChart根据源码包结构简单梳理:

1.animation: 动画 用于进场出场XY方向的各种动画,支持多种动画效果(Easing)
2.chart:图表控件, 支持LineChart、CandleStickChart、BarChart、PieChart等各种图表,而CombinedChart包含了所有图表,绘制k线图时,主图涉及分时图蜡烛图,K线指标,副图有指标和各种柱状图,所以可以直接都使用CombinedChart。
3.renderer: 渲染器,每个图表都对应有内容区数据渲染器,x轴 y轴渲染器,绘制圆圈,圆角,Legend的渲染器等,定制化图表就需要在渲染器做文章。
4.matrix:3维矩阵,映射至xyz轴,用于做缩放平移旋转运算。在工具类ViewPortHandler中封装了很多关于变换的api,所以和矩阵打交道的情况比较少。
5.data: 举个例子:指标线为线形图,需要使用LineData, 而LineData中可以放入多个LineDataSet,每个LineDataSet对应一条指标线,dataSet中封装了源数据Entry,以及该条数据线绘制需要的颜色、粗细、样式等属性。每一种图表分别有自己对应的Data、DataSet、Entry。
6.formatter: 颜色、数字、百分比等格式化的类。K线图时间坐标轴就需要自定义ValueFormatter
7.highlight:选中高亮时各个类型的图高亮表现是不一样的,对每个图表封装了合适的高亮信息的类。
8.component:x轴 y轴 限制线 MarkView Description等,就跟名字一样用于绘制对应的图表属性
9.jobs:维护的对象池,用于有序的处理缩放,平移,动画等事务
10.listener 触控点击选中事件监听等

k线图表需要进行较多的定制化的话建议看看源码,这里着重说一下BarLineChartBase中onDraw()方法,图表绘制的核心都在这里, 。从这里基本能看出可能存在哪些api, 通过了解绘制的流程基本可以大致知道需要定制图表功能时在哪个地方下功夫。

@Override
    protected void onDraw(Canvas canvas) {
        super.onDraw(canvas);

        if (mData == null)
            return;

        // 1.绘制网格背景
        drawGridBackground(canvas);
      // 自动缩放(开启后图表会自适应的合理的占满屏幕),所以肯定有个setAutoScaleMinMaxEnabled()来开启禁用自动缩放
    // (下面基本大部分绘制操作都会提供相应的Enable的开关)
        if (mAutoScaleMinMaxEnabled) {
            autoScale();
        }

      // 左边y轴,右边y轴,底部x轴在需要绘制时,先计算数据范围和图表尺寸之间的关系。
        if (mAxisLeft.isEnabled())
            mAxisRendererLeft.computeAxis(mAxisLeft.mAxisMinimum, mAxisLeft.mAxisMaximum, mAxisLeft.isInverted());  

        if (mAxisRight.isEnabled())
            mAxisRendererRight.computeAxis(mAxisRight.mAxisMinimum, mAxisRight.mAxisMaximum, mAxisRight.isInverted());

        if (mXAxis.isEnabled())
            mXAxisRenderer.computeAxis(mXAxis.mAxisMinimum, mXAxis.mAxisMaximum, false);
        // 绘制对应轴的坐标轴线(只是xy轴线条)
        mXAxisRenderer.renderAxisLine(canvas);
        mAxisRendererLeft.renderAxisLine(canvas);
        mAxisRendererRight.renderAxisLine(canvas);

// 网格线,xy方向都有。注意这个isDrawGridLinesBehindDataEnabled决定了背景网格线层级,
// 默认为true,先绘制网格线再绘制K线等数据线,反之网格线会盖在数据线上方
        if (mXAxis.isDrawGridLinesBehindDataEnabled())
            mXAxisRenderer.renderGridLines(canvas);

        if (mAxisLeft.isDrawGridLinesBehindDataEnabled())
            mAxisRendererLeft.renderGridLines(canvas);

        if (mAxisRight.isDrawGridLinesBehindDataEnabled())
            mAxisRendererRight.renderGridLines(canvas);
// 限制线 和网格线一样可以设置层级
        if (mXAxis.isEnabled() && mXAxis.isDrawLimitLinesBehindDataEnabled())
            mXAxisRenderer.renderLimitLines(canvas);

        if (mAxisLeft.isEnabled() && mAxisLeft.isDrawLimitLinesBehindDataEnabled())
            mAxisRendererLeft.renderLimitLines(canvas);

        if (mAxisRight.isEnabled() && mAxisRight.isDrawLimitLinesBehindDataEnabled())
            mAxisRendererRight.renderLimitLines(canvas);

        // 画布会被裁剪, 保证后续绘制在坐标轴以内进行(注意了重写下面的方法drawData renderGridLines等时,都不会超过坐标轴线)
        int clipRestoreCount = canvas.save();
        canvas.clipRect(mViewPortHandler.getContentRect());

// ****** 数据绘制
        mRenderer.drawData(canvas);

// 根据isDrawGridLinesBehindDataEnabled的设置确定网格线到底绘制在数据线之前还是之后
        if (!mXAxis.isDrawGridLinesBehindDataEnabled())
            mXAxisRenderer.renderGridLines(canvas);

        if (!mAxisLeft.isDrawGridLinesBehindDataEnabled())
            mAxisRendererLeft.renderGridLines(canvas);

        if (!mAxisRight.isDrawGridLinesBehindDataEnabled())
            mAxisRendererRight.renderGridLines(canvas);

        // if highlighting is enabled 高亮绘制
        if (valuesToHighlight())
            mRenderer.drawHighlighted(canvas, mIndicesToHighlight);

        // Removes clipping rectangle  又把画布给恢复啦,所以下面的绘制操作是可以超出坐标轴以外了
        canvas.restoreToCount(clipRestoreCount);

// 额外的绘制,后续我们会有不少需求的实现就需要重写drawExtras
        mRenderer.drawExtras(canvas);

        if (mXAxis.isEnabled() && !mXAxis.isDrawLimitLinesBehindDataEnabled())
            mXAxisRenderer.renderLimitLines(canvas);

        if (mAxisLeft.isEnabled() && !mAxisLeft.isDrawLimitLinesBehindDataEnabled())
            mAxisRendererLeft.renderLimitLines(canvas);

        if (mAxisRight.isEnabled() && !mAxisRight.isDrawLimitLinesBehindDataEnabled())
            mAxisRendererRight.renderLimitLines(canvas);

// 坐标轴上的刻度标签
        mXAxisRenderer.renderAxisLabels(canvas);
        mAxisRendererLeft.renderAxisLabels(canvas);
        mAxisRendererRight.renderAxisLabels(canvas);
// 每一个数据点标示值绘制
        if (isClipValuesToContentEnabled()) {
            clipRestoreCount = canvas.save();
            canvas.clipRect(mViewPortHandler.getContentRect());

            mRenderer.drawValues(canvas);

            canvas.restoreToCount(clipRestoreCount);
        } else {
            mRenderer.drawValues(canvas);
        }

        mLegendRenderer.renderLegend(canvas);

// 描述(比如加载不到数据时显示的文本)
        drawDescription(canvas);
// 标记控件
        drawMarkers(canvas);
    }

从上面可以看出绘制操作都会使用对应的Renderer来执行(mRenderer,mXAxisRenderer,mAxisRendererLeft等),而chart本身更多的是设置绘制开关之类的一些属性。后续会根据遇到的需求疑难点逐个说一下处理方法思路。

一、高亮线的自定义

从上面的代码可以看出高亮线绘制是使用chart自身控件类型的Renderer(CombinedChartRenderer/ LineChartRenderer/BarChartRenderer...)。

 if (valuesToHighlight())
            mRenderer.drawHighlighted(canvas, mIndicesToHighlight);

所以根据需求重写其drawHighlighted方法就可以了,我这里用的CombinedChart,需求只需要高亮十字线上加个圆圈,CombinedChart的Renderer是CombinedChartRenderer,只需要新建CombinedChartRenderer的子类,重写drawHighlighted方法,把这个自定义的renderer在初始化后设置给chart即可。

// CombinedChartRenderer的子类中
    @Override
    public void drawHighlighted(Canvas c, Highlight[] indices) {
        super.drawHighlighted(c, indices);
        Bitmap bitmap;
        if (mCallback == null || (bitmap = mCallback.getCrossBitmap()) == null) {
            return;
        }
        for (Highlight high : indices) {
            float drawX = high.getDrawX();
            float drawY = high.getDrawY();
            if (bitmap.isRecycled()) {
                return;
            }
            c.drawBitmap(bitmap, drawX - bitmap.getWidth() / 2, drawY - bitmap.getHeight() / 2, mDrawPaint);
        }
    }


        // chart类中
        mChartRenderer = new MyCombineChartRenderer(this, mAnimator, mViewPortHandler);
        mChartRenderer.setCombineCallback(this);
        setRenderer(mChartRenderer);

需要更改高亮线的样式可以看一下drawHighlighted中的具体实现,其mHighlightPaint的参数设置是从dataSet中获取的,所以在准备数据阶段是可以通过设置dataSet来确定高亮线的样式。比如LineDataSet中可以设置颜色,宽度,虚线样式等

// LineDataSet中设置高亮线的方法
       public void setHighLightColor(int color);
       public void setHighlightLineWidth(float width) 
       public void enableDashedHighlightLine(float lineLength, float spaceLength, float phase);  // 设置虚线样式
       public void setDrawHighlightIndicators(boolean enabled)
      ......

效果图:


image.png
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,294评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,493评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,790评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,595评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,718评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,906评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,053评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,797评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,250评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,570评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,711评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,388评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,018评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,796评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,023评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,461评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,595评论 2 350

推荐阅读更多精彩内容