MPAndroidChart绘制自定义运动数据图表示例详解

Psyche ·

更新时间:2024-11-14

· 1566 次阅读

引言

TimeAxis

SportYAxis

CustomLineChart

引言

声明：文中的MPChart代指MPAndroidChart.

本系列之前的文章介绍的MPChart中BarChart相关的一些绘制，接下来我们看看LineChart相关的绘制。

这里以实际的运动相关的图表数据做业务支撑来讲解。MPChart图表支持多指触控方法，这里所有的图表自定义都关掉了这个属性，这样就减少Transformer，以及绘制过程中的更多的变动，相当于一个静态的图。

通常图表在放大的过程中，坐标轴也会随之展现更小的刻度，复杂度就变高了，具体的显示的刻度就可能出现小数之类的等情况。

这里我们关掉触摸放大后，相当于一个静态的图。这时候，产品以及设计可能需要我们的X轴坐标、Y轴坐标等刻度尽可能地为整数，这样看起来比较美观。

静态的情况下，因为没法移动，即便可以移动，首次展现也希望图表的数据能够比较居中，这就涉及到YAxis的自定义如何影响控制 Chart的相关展示逻辑的内容，本章节首先从这入手，讲解运动数据图表的绘制。

TimeAxis

这里自定义X轴TimeAxis，实际意义是一次运动耗费的时间，继承自XAxis。假如一次运动1个小时06分钟，设计希望展示4个刻度（0， 20 ， 40， 60 分钟），这时需要我们自己去控制，假如不加控制的话，Default情况下没法准确的实现设计的需求。

XAxis、YAxis有两个属性，Maximum, Minmum. 这样设定每个interval 就可以计算出要显示的刻度列表， labelList, 加入到XAxis中的 mEntries，最后在XAxisRender会拿到mEntries 最终绘制 X坐标。

这里不在设计一个算法类计算每个时间段的刻度显示了，运动的时间范围有限，直接枚举, 在 TimeXAxis里的getlabelCount() 实现。

  if (max > 6000 * TimeDateUtil.TIME_MIN_INT){
    interval = 2000 * TimeDateUtil.TIME_MIN_INT;
  } else if (max > 4800 * TimeDateUtil.TIME_MIN_INT) {// 80个小时
    interval = 1920 * TimeDateUtil.TIME_MIN_INT;
  } else if (max > 2400 * TimeDateUtil.TIME_MIN_INT) {// 40个小时
    interval = 960 * TimeDateUtil.TIME_MIN_INT;
  } else if (max > 1200 * TimeDateUtil.TIME_MIN_INT) {
    interval = 480 * TimeDateUtil.TIME_MIN_INT;
  }
  。。。。。
  else if (max > 20 * TimeDateUtil.TIME_MIN_INT) {
    interval = 5 * TimeDateUtil.TIME_MIN_INT;
  } else if (max > 15 * TimeDateUtil.TIME_MIN_INT) {
    interval = 4 * TimeDateUtil.TIME_MIN_INT;//4分钟刻度
  } else if (max > 5 * TimeDateUtil.TIME_MIN_INT) {//
    interval = 2 * TimeDateUtil.TIME_MIN_INT;//2分钟刻度。
  } else {
    interval = TimeDateUtil.TIME_MIN_INT;
  }
  float currentEntry = min;
  List<Float> entryList = new ArrayList<>();
  do {
    entryList.add(currentEntry);
    currentEntry += interval;
  } while (currentEntry <= max);
  labelCount = entryList.size();
  mEntryCount = labelCount;
  if (mEntries.length < labelCount) {
    mEntries = new float[labelCount];
  }
  for (int i = 0; i < labelCount; i++) {
    mEntries[i] = entryList.get(i);
  }

准备好XAxis 中的Entry数据后，依旧是交给Buffer，经过Transformer转化，最终绘制出来，自定义TimeAxisRender，然后 renderAxisLabels() 方法里drawLabel(), 绘制XAxis的坐标轴线：

图1.0 XAxis 坐标线的绘制

SportYAxis

Y轴的绘制相比XAxis要复杂一些，自定义的SportYAxis继承自YAxis, TimeXAxis 只有时间数据对应。SportYAxis根据具体的数据业务可以表示心率，高度海拔，速度，配速，频率等数据。

这些数据中，心率、步频等取值范围可以比如（0， 250）类似这样的可以直接定下来Y轴的Max, Min 值以及对应的刻度，高度海拔有负数的，速度的Max根据所给数据来定，配速比较特殊，需要将Y轴 revert。

为了将图表能够居中，通常YAxis 上的Maximum 会比数据中的极大值要偏大，保证图表不会呈现的太慢，影响美观。根据不同的Sport数据，将Y轴分为以下几种：

// TYPE_FIX_MIN_ZERO = 0; Y轴从固定的0开始 到 max；步频、起跳高度
// TYPE_FIX_MIN_POSITIVE = 1; 从 entryList的 真实的 min（min不能小于0）开始，到max； 心率、速度、划频、Swolf
// TYPE_FIX_COMMON = 2; 从entryList的最小值min开始到max的最大值，无论最大、最小是否为Positive， 例如海拔；
//TYPE_FIX_RESTRICT_MAX = 3; 限制最大值，比如配速。Y轴 Invert，所以最小值min为大于等于 0 的Positive value； 配速
public static final int TYPE_FIX_MIN_ZERO = 0;
public static final int TYPE_FIX_MIN_POSITIVE = 1;
public static final int TYPE_FIX_COMMON = 2;
public static final int TYPE_FIX_RESTRICT_MAX = 3;

每种类型下计算Y轴的Maximum、Minmum; 然后计算刻度的间距 itemValue, 得到坐标Label 的List。

以上的几种坐标的实现具体在 SportYAxis 中实现。

将Y轴数据限定下来之后，图表的展现因为Y轴的Maximum、Minmum 限定在比较居中的位置。

对于配速，当运动停下来时，单位距离的耗时可能无限大，假如我们考虑把这个极值画下来的话，Y轴可能跨度很大导致图表没法看，所以需要限定极大值，截断图形：

//限制最大值
private float getYAxisMax2(List<SportRecordEntry> values, float yAxisMin) {
    int size = values.size();
    float yAxisMax = Integer.MIN_VALUE;
    float yAxisMinTemp = Integer.MAX_VALUE;
    float sum = 0;
    for (int i = 0; i < size; i++) {
      SportRecordEntry entry = values.get(i);
      yAxisMax = Math.max(entry.getY(), yAxisMax);
      yAxisMinTemp = Math.min(entry.getY(), yAxisMinTemp);
      sum += entry.getY();
    }
    float averageY = sum / (size * 1.0f);
    float distanceMin = averageY - yAxisMinTemp;
    float distanceMax = yAxisMax - averageY;
    int num = (int) (distanceMax / distanceMin);
    if (num > 5) {// 配速中 有 配速值很慢的点，坐标时不考虑它们了。
      yAxisMax = averageY + 2 * distanceMin; // 限制Y 轴坐标。
    }
    float distance = yAxisMax - yAxisMin;
    if (yAxisMax > 0 && distance <= 2) {
      return yAxisMax + 2;
    }
    return yAxisMax + distance * mLineChartAttr.maxYAxisRatio;
}

CustomLineChart

处理完XAxis、YAxis的数据及绘制后，处理LineChart的主体，这里包含了折线图、曲线图等体现数据展现的，还有drawFill，底部的填充；drawMaxMinPop() 极值点的绘制等。

着重讲解折线图的绘制，对于LineChart，Entry比较简单，存有对应的X， Y值，

图1.1CustomLineChart 绘制逻辑

考虑先后两个点，PreEntry, CurrentEntry 然后绘制每段折线，最终连成图表。

针对配速图表Y轴需要倒过来的，

private float getYAsInverted(Entry entry) {
    final float phaseY = mAnimator.getPhaseY();
    float yValueRange = mYAxis.getAxisMaximum() - mYAxis.getAxisMinimum();
    if (mYAxis.isInverted()) {
      if (entry.getY() <= mYAxis.getAxisMinimum()) {
        return entry.getY() * phas
        eY;
      } else {
        return (yValueRange - entry.getY()) * phaseY;
      }
    } else {
      return entry.getY() * phaseY;
    }
}

以下就是配速图表，极大值的限定线取的太大，导致整个图形太偏上了，可以做响应的修改。