Flutter篇 （二）绘制贝塞尔曲线 、折线 、柱状图，支持触

之前写过一篇Android原生绘制曲线图的博客，动画效果不要太丝滑，那么现在到了Flutter，该如何实现类似的效果呢？如果你熟悉android的Canvas,那么恭喜你, 你将很快上手Flutter的Canvas绘制各种图形，因为实现方式基本上与android是一模一样

先看下要实现的基本效果：

Flutter中如果想要自定义绘制，那么你需要用到 **CustomPaint **和 CustomPainter ; CustomPaint是Widget的子类，先来看下构造方法

const CustomPaint({
    Key key,
    this.painter,
    this.foregroundPainter,
    this.size = Size.zero,
    this.isComplex = false,
    this.willChange = false,
    Widget child,
  }) :super(key: key, child: child);

我们只需要关心三个参数，painter，foregroundPainter 和 child ， 这里需要说明一下，painter 是绘制的 backgroud 层，而child 是在backgroud之上绘制，foregroundPainter 是在 child 之上绘制，所以这里就有了个层级关系，这跟android里面的backgroud与foreground是一个意思，那这两个painter的应用场景是什么呢？假如你只是单纯的想绘制一个图形，只用painter就可以了，但是如果你想给绘制区域添加一个背景（颜色，图片，等等），这时候如果使用 painter是会有问题的，painter的绘制会被child 层覆盖掉，此时你只需要将painter替换成foregroundPainter,然会颜色或者图片传递给child即可。

如果是Android绘制几何图形，应该是重写View的onLayout() 和 onDraw方法，但是Flutter实现绘制，必须继承CustomPainter并重写 paint（Canvas canvas, Size size）和 shouldRepaint (CustomPainter oldDelegate) 方法 ，第一个参数canvas就是我们绘制的画布了（跟Android一模一样），paint第二个参数Size就是上面CustomPaint构造方法传入的size, 决定绘制区域的宽高信息

既然Size已经确定了，现在就定义下绘制区域的边界,一般我做类似的UI，都会定义一个最基本的padding, 一般取值为16 ， 因为绘制的内容与坐标轴之间需要找到一个基准线，这样更容易绘制，而且调试边距也很灵活

double startX, endX, startY, endY;//定义绘制区域的边界
static const double basePadding = 16; //默认的边距
double fixedHeight, fixedWidth; //去除padding后曲线的真实宽高
bool isShowXyRuler; //是否显示xy刻度
List<ChatBean> chatBeans;//数据源

class ChatBean {
  String x;
  double y;
  int millisSeconds;
  Color color;

  ChatBean({@required this.x, @required this.y, this.millisSeconds, this.color});
}

然后在paint()方法中拿到Size,确定绘制区域的坐标

///计算边界
  void initBorder(Size size) {
    print('size - - > $size');
    this.size = size;
    startX = yNum > 0 ? basePadding * 2.5 : basePadding * 2; //预留出y轴刻度值所占的空间
    endX = size.width - basePadding * 2;
    startY = size.height - (isShowXyRuler ? basePadding * 3 : basePadding);
    endY = basePadding * 2;
    fixedHeight = startY - endY;
    fixedWidth = endX - startX;
    maxMin = calculateMaxMin(chatBeans);
  }

maxMin是定义存储曲线中最大值和最小值的

///计算极值 最大值,最小值
  List<double> calculateMaxMin(List<ChatBean> chatBeans) {
    if (chatBeans == null || chatBeans.length == 0) return [0, 0];
    double max = 0.0, min = 0.0;
    for (ChatBean bean in chatBeans) {
      if (max < bean.y) {
        max = bean.y;
      }
      if (min > bean.y) {
        min = bean.y;
      }
    }
    return [max, min];
  }

初始化画笔 .. 是dart中的独特语法，代表使用对象的返回值调用属性或方法

var paint = Paint()
      ..isAntiAlias = true//抗锯齿
      ..strokeWidth = 2
      ..strokeCap = StrokeCap.round//折线连接处圆滑处理
      ..color = xyColor
      ..style = PaintingStyle.stroke;//描边

绘制坐标轴，这里在确定好的边界基础上再次xy轴横向和纵向各自增加一倍的padding,不然显得太紧凑

canvas.drawLine(Offset(startX, startY),Offset(endX + basePadding, startY), paint); //x轴
canvas.drawLine(Offset(startX, startY),Offset(startX, endY - basePadding), paint); //y轴

绘制 X 轴刻度，定义为最多绘制7组数据 ，rulerWidth就是刻度的长度定义为8

int length = chatBeans.length > 7 ? 7 : chatBeans.length; //最多绘制7个
double DW = fixedWidth / (length - 1); //两个点之间的x方向距离
double DH = fixedHeight / (length - 1); //两个点之间的y方向距离
for (int i = 0; i < length; i++) {
     ///绘制x轴文本
     TextPainter(
            textAlign: TextAlign.center,
            ellipsis: '.',
            text: TextSpan(
                text: chatBeans[i].x,
                style: TextStyle(color: fontColor, fontSize: fontSize)),
            textDirection: TextDirection.ltr)
          ..layout(minWidth: 40, maxWidth: 40)
          ..paint(canvas, Offset(startX + DW * i - 20, startY + basePadding));

      ///x轴刻度
      canvas.drawLine(Offset(startX + DW * i, startY),Offset(startX + DW * i, startY - rulerWidth), paint);
   }

这里要说明一点，Flutter绘制文本，并不能像android那样调用canvas.drawText () , 而是通过TextPainter来渲染的;
构造TextPainter 你必须指定文字的方向 textDirection 和 宽度 layout ,最后调用paint方法，指定坐标进行绘制;
绘制 Y 轴刻度，y轴的刻度数量并不需要跟随数据源的长度，只需要按照一定数量(**yNum **)平分y轴最大值即可。

      int yLength = yNum + 1; //包含原点,所以 +1
      double dValue = maxMin[0] / yNum; //一段对应的值
      double dV = fixedHeight / yNum; //一段对应的高度
      for (int i = 0; i < yLength; i++) {
        ///绘制y轴文本，保留1位小数
        var yValue = (dValue * i).toStringAsFixed(isShowFloat ? 1 : 0);
        TextPainter(
            textAlign: TextAlign.center,
            ellipsis: '.',
            maxLines: 1,
            text: TextSpan(  
                text: '$yValue',
                style: TextStyle(color: fontColor, fontSize: fontSize)),
            textDirection: TextDirection.rtl)
          ..layout(minWidth: 40, maxWidth: 40)
          ..paint(canvas, Offset(startX - 40, startY - dV * i - fontSize / 2));

        ///y轴刻度
        canvas.drawLine(Offset(startX, startY - dV * (i)),Offset(startX + rulerWidth, startY - dV * (i)), paint);
      }

现在坐标轴和刻度已经绘制完成了，基本上与原生一致，只是代码方式有些区别，接下来的曲线也是一模一样的，绘制贝塞尔曲线其实也不难，主要是找到起点和两个坐标之间的辅助点， 贝塞尔曲线的原理可以参考这里

path.cubicTo(double x1, double y1, double x2, double y2, double x3, double y3)

path = Path();
double preX, preY, currentX, currentY;
int length = chatBeans.length > 7 ? 7 : chatBeans.length;
double W = fixedWidth / (length - 1); //两个点之间的x方向距离

遍历数据源的第一个元素时，需要做个判断，index=0时，需要将path move到此处

if (i == 0) {
     path.moveTo(startX, (startY - chatBeans[i].y / maxMin[0] * fixedHeight));
     continue;
   }

添加后面的坐标时，需要找辅助点

currentX = startX + W * i;
preX = startX + W * (i - 1);

preY = (startY - chatBeans[i - 1].y / maxMin[0] * fixedHeight);
currentY = (startY - chatBeans[i].y / maxMin[0] * fixedHeight);

path.cubicTo(
              (preX + currentX) / 2, preY,
              (preX + currentX) / 2, currentY,
              currentX, currentY
            );

如果是要画折线而非曲线，第一步还是path.moveTo ，折线不需要找辅助点，所以后续可以直接添加坐标，path.lineTo

最后将path绘制出来

canvas.drawPath(newPath, paint);

虽然曲线已经成功绘制，但是这样显得很枯燥，如果可以看到绘制过程那就会更加有趣味性，这时候就需要通过动画来更新曲线的path的长度了，一般Android中我会用ValueAnimator.ofFloat(start ,end ) 来开启一个动画 ,在Flutter中，动画也是非常简单实用

_controller = AnimationController(vsync: this, duration: widget.duration);
      Tween(begin: 0.0, end: widget.duration.inMilliseconds.toDouble())
          .animate(_controller)
            ..addStatusListener((status) {
              if (status == AnimationStatus.completed) {
                print('绘制完成');
              }
            })
            ..addListener(() {
              _value = _controller.value;//当前动画值
              setState(() {});
            });
      _controller.forward();

动画执行过程中，我们会及时获取到当前的动画进度 _value, 此时就需要一段完整的path跟随动画值 等比绘制了 ，之前在Android中我们可以用 PathMeasure 来测量path ，然后根据动画进度不断地截取，就实现了像贪吃蛇一样的效果， 但是在Flutter中，我并没有找到PathMeasure 这个类，相反的，PathMeasure 在Flutter竟然是个私有的类 _PathMeasure ，经过一通百度 和 google，也没有找到类似的案例。难道没有人给造轮子，就必须要停止我前进的步伐了嘛，不急，显然Path这个类里面有很多方法，就这样我走上了一条反复测试的不归路...

幸运的是，在翻阅了google 官方Flutter api 后，终于找到了突破口

哈哈，藏得还挺深呐，就是这个 PathMetrics 类，path.computeMetrics() 的返回值 ，是用来将path解析成矩阵的一个工具

var pathMetrics = path.computeMetrics(forceClosed: false);

有个参数 forceClosed ， 表示是否要连接path的起始点 ，我们这里当然不要啦 ，computeMetrics方法返回的是PathMetrics对象，调用 toList () 可以获取到 多个path组成的 List<PathMetric> ; 集合中的每个元素代表一段path的矩阵 ， 奇怪，为什么是多个path 呢 ？？？
当时我也是懵着猜测的，历史总是惊人的相似，被我给猜对了，不晓得你们有没有发现，**Path有个方法可以添加多个Path , **

path.addPath(path, offset);

当我每调用一次 addPath（）或者 moveTo（） ，lsit . length就增加1，所以上面提到的多个path的集合 就不难理解了 ，因为我们这里只有一个path, 所以我们的 list 中只有一个元素 , 元素中包含一段path, 现在我们获取到了描述path的矩阵PathMetric

PathMetric . length 就是这段path的长度了，唉，为了找到你 ，我容易吗 ！
另外还有个关键的方法，可以将pathMetric按照给定的位置区间截取，最后返回这段path, 这就跟android中的PathMeasure.getSegment()是一样

extractPath（double start， double end，{ bool startWithMoveTo：true }） → Path
给定起始和停止距离，返回中间段。

现在是时候将前面获取到的当前动画值 value 用起来了，找到当前path的length乘以value即是当前path的最新长度

var pathMetrics = path.computeMetrics(forceClosed: true);
var list = pathMetrics.toList();
var length = value * list.length.toInt();
Path newPath = new Path();
for (int i = 0; i < length; i++) {
     var extractPath =list[i].extractPath(0, list[i].length * value, startWithMoveTo: true);
      newPath.addPath(extractPath, Offset(0, 0));
    }
 canvas.drawPath(newPath, paint);

走到这里，好像跨过了山和大海，得了，困死了，睡了、睡了...

现在曲线和折线都已经绘制完成了，不过刚开始的demo里还有个渐变色的部分没有完成，貌似有了渐变色以后，显得不那么单调了，其实，我们绘图所用到的Paint还有一个属性shader，可以绘制线条或区域的渐变色，LinearGradient可实现线性渐变的效果，默认为从左到右绘制，你可以通过begin和end属性自定义绘制的方向，我们这里需要指定为从上至下，并且颜色类型为数组的形式，所以你可以传入多个颜色值来绘制

var shader = LinearGradient(
              begin: Alignment.topCenter,
              end: Alignment.bottomCenter,
              tileMode: TileMode.clamp,
              colors: shaderColors)
          .createShader(Rect.fromLTRB(startX, endY, startX, startY));

值得注意的是，通过 createShader的方式创建shader，你需要指定绘制区域的边界，我们这里要实现的是从上至下，所以就以y轴为基准，指定从上至下的绘制方向
既然是绘制渐变色，所以画笔的样式必须设置为填充状态

Paint shadowPaint = new Paint();
      shadowPaint
        ..shader = shader
        ..isAntiAlias = true
        ..style = PaintingStyle.fill;

另外，渐变色的区域我们是通过path来指定上面的边界的，所以我们还需要指定path下面部分的起点和终点，这样形成一个闭环，才能确定出完整的区域

///从path的最后一个点连接起始点，形成一个闭环
      shadowPath
        ..lineTo(startX + fixedWidth * value, startY)
        ..lineTo(startX, startY)
        ..close();
      canvas..drawPath(shadowPath, shadowPaint);

至此，即可实现带有渐变色的曲线或者折线，也许你有个疑问，画折线为什么也要用path呢，不是可以直接drawLine吗 ？机智如我，添加到path以后，可以更方便的绘制，添加动画也很方便; 另附上最终的实现效果，至于触摸操作就不打算阐述了，可以参考以下代码

代码已发布到 Dart https://pub.dev/flutter/packages?q=flutter_chart
GitHub仓库链接 https://github.com/good-good-study/flutter_chart