android - MPAndroidChart渲染器如何工作以及如何编写自定义渲染器?

标签 android mpandroidchart

我正在使用库mpandroidchart,但它并没有我想要的所有功能。
我听说可以通过编写自定义渲染器来实现我想要的功能。
我已经查看了mpandroidchart github repo中的source code for the renderers,但我无法理解其中涉及的概念。
mpandroidchart渲染器是如何工作的?
编写自定义渲染器的高级过程是什么?
注意:对于so for aa>上发布的许多问题,解决方案是实现某种自定义渲染器。如果没有指南,对这些问题的评论“可以通过编写自定义渲染器来解决此问题”是不令人满意的。为一个不常见和不寻常的需求编写一个包含完整解决方案的答案可能会非常耗时。目前还没有编写自定义渲染器的指南,希望这个问题可以作为提问者能够帮助自己的工具,如果不是重复的目标。虽然我在这里尝试了我自己的答案,但欢迎其他答案、更正和评论。

最佳答案

了解视图和画布
首先,我们应该研究android官方文档中的Canvas and Drawables Guide。特别需要注意的是,LineChart等是BarChart的子类,它们通过重写视图超类的View回调来显示自己。另请注意“画布”的定义:
画布为你工作,作为一个托词,或接口,到实际的表面上,你的图形将被绘制-它持有你所有的“绘制”调用。
使用渲染器时,将处理在画布上绘制线条、条形图等的功能。
图表上的值与画布上的像素之间的转换
图表上的点相对于图表上的单位指定为x和y值。例如,在下面的图表中,第一个条的中心位于onDraw(Canvas c)。第一个条的y值为x = 0
an MPAndroidChart barchart
这显然与画布上的像素坐标不符。在画布上,画布上的52.28将是最左边的像素,这显然是空白的。同样,因为像素枚举从顶部开始为x = 0,所以条的顶端显然不在y = 0(图表上的y值)。如果我们使用developer options/pointer location,我们可以看到第一个栏的顶端大约是52.28x = 165
ay = 1150负责将图表值转换为像素(屏幕上)坐标,反之亦然。渲染器中的一个常见模式是使用图表值(更容易理解)执行计算,然后在最后使用转换器将转换应用到屏幕上进行渲染。
查看端口和边界
视图端口是一个窗口,即图表上的有界区域。视图端口用于确定用户当前可以看到图表的哪个部分。每个图表都有一个Transformer来封装与视图端口相关的功能。我们可以使用ViewPortHandlerViewPortHandler#isInBoundsLeft(float x)来确定用户当前可以看到的x值。
在上图所示的图表中,条形图“知道”6和6以上的isInBoundsRight(float x),但由于它们超出了边界且不在当前视口中,因此6和6以上不渲染。因此,x值BarEntry0在当前视区内。
图表动画师
5提供了要应用于图表的附加转换。通常这是一个简单的乘法运算。例如,假设我们需要一个动画,其中图表的点从底部开始,在1秒内逐渐上升到其正确的y值。动画师将提供一个ChartAnimator这个简单的标量,从phaseY开始,到0.000逐渐上升到0ms
渲染器代码示例
现在我们已经了解了所涉及的基本概念,让我们看看1.000中的一些代码:

protected void drawHorizontalBezier(ILineDataSet dataSet) {

    float phaseY = mAnimator.getPhaseY(); 

    Transformer trans = mChart.getTransformer(dataSet.getAxisDependency());

    mXBounds.set(mChart, dataSet);

    cubicPath.reset();

    if (mXBounds.range >= 1) {

        Entry prev = dataSet.getEntryForIndex(mXBounds.min);
        Entry cur = prev;

        // let the spline start
        cubicPath.moveTo(cur.getX(), cur.getY() * phaseY);

        for (int j = mXBounds.min + 1; j <= mXBounds.range + mXBounds.min; j++) {

            prev = cur;
            cur = dataSet.getEntryForIndex(j);

            final float cpx = (prev.getX())
                    + (cur.getX() - prev.getX()) / 2.0f;

            cubicPath.cubicTo(
                    cpx, prev.getY() * phaseY,
                    cpx, cur.getY() * phaseY,
                    cur.getX(), cur.getY() * phaseY);
        }
    }

    // if filled is enabled, close the path
    if (dataSet.isDrawFilledEnabled()) {

        cubicFillPath.reset();
        cubicFillPath.addPath(cubicPath);
        // create a new path, this is bad for performance
        drawCubicFill(mBitmapCanvas, dataSet, cubicFillPath, trans, mXBounds);
    }

    mRenderPaint.setColor(dataSet.getColor());

    mRenderPaint.setStyle(Paint.Style.STROKE);

    trans.pathValueToPixel(cubicPath);

    mBitmapCanvas.drawPath(cubicPath, mRenderPaint);

    mRenderPaint.setPathEffect(null);
}

1000ms循环之前的前几行是渲染器循环的设置。注意,我们从chartanimator、transformer获取LineChartRenderer,并计算视图端口边界。
for循环基本上意味着“对于视图端口左右边界内的每个点”。渲染不可见的x值是没有意义的。
在循环中,我们使用phaseY获取当前项的x值和y值,并在该项和前一项之间创建一个路径。请注意路径是如何与动画的for相乘的。
最后,在计算路径之后,使用dataSet.getEntryForIndex(j)应用转换,并使用phaseY将路径渲染到画布上。
编写自定义渲染器
第一步是选择正确的类作为子类。注意班级
在包trans.pathValueToPixel(cubicPath);中,包括mBitmapCanvas.drawPath(cubicPath, mRenderPaint);com.github.mikephil.charting.renderer等。一旦创建子类,就可以简单地重写适当的方法。根据上面的示例代码,我们将重写XAxisRenderer,而不调用LineChartRenderer(这样就不会调用两次呈现阶段),并将其替换为所需的功能。如果你做得对,被重写的方法应该看起来至少有点像你正在重写的方法:
获取转换器、动画和边界上的句柄
在可见的x值之间循环(在视图端口边界内的x值)
准备要在图表值中呈现的点
将点转换为画布上的像素
使用void drawHorizontalBezier(ILineDataSet dataSet)类方法在画布上绘制
您应该研究Canvas classsuper等)中的方法,以查看允许在渲染器循环中执行哪些操作。
如果需要重写的方法未公开,则可能需要对基础呈现程序(如Canvas)进行子类化以实现所需的功能。
一旦设计了所需的renderer子类,就可以使用drawBitmapLineRadarRenderer和其他方法轻松地使用它。

关于android - MPAndroidChart渲染器如何工作以及如何编写自定义渲染器?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/43443787/

相关文章:

android异步任务尝试

android - MPAndroidChart - 如何将 BarChart 的范围值设置为 2.0.9v?

java - MPAndroidChart 在图表的水平线上显示标签

android - 如何在折线图中的突出显示点上画一个圆圈?

java - 在 Android 上使用 iText 将 HTML 转换为 PDF。如何设置 UTF-8(变音符号)?

AndroidX 导致 AppCompatActivity 崩溃

java - 为什么我的 android 应用程序这么慢?

android - 将麦克风流式传输到扬声器 android

android - 在 MPAndroidChart 中单击任何条时如何停止突出显示?

设置 setVisibleXRangeMaximum 时,iOS-Charts X 轴值无限重复