# 20 通过手势在白板上绘制

#### 1. 白板绘制思路分析

对功能需求的分析主要从 **界面数据信息**、**交互与数据维护**、**界面构建逻辑** 三个方面来思考。

- **数据信息**

界面上需要呈现多条线，每条线由若干个点构成，另外可以指定线的颜色和粗细。所以这里可以封装一个 `Line` 类维护这些数据：

```ini
class Line {
  List<Offset> points;
  Color color;
  double strokeWidth;

  Line({
    required this.points,
    this.color = Colors.black,
    this.strokeWidth = 1,
  });
}
```

---

然后需要 `List<Line>` 线列表来表示若干条线；由于支持颜色和粗细选择，需要给出支持的颜色、粗细选项列表，以及两者的激活索引：

```ini
List<Line> _lines = []; // 线列表

int _activeColorIndex = 0; // 颜色激活索引
int _activeStorkWidthIndex = 0; // 线宽激活索引

// 支持的颜色
final List<Color> supportColors = [
  Colors.black, Colors.red, Colors.orange,
  Colors.yellow, Colors.green, Colors.blue,
  Colors.indigo, Colors.purple,
];

// 支持的线粗
final List<double> supportStorkWidths = [1,2, 4, 6, 8, 10];
```

---

- **交互与数据维护**

线列表数据的维护和用户的拖拽事件息息相关：

- 用户开始拖拽开始时，需要创建 Line 对象，加入线列表。
- 用户拖拽过程中，将触点添加到线列表最后一条线中。
- 用户点击清除时，清空线列表。
- 用户可以通过交互选择颜色，更新颜色激活索引。
- 用户可以通过交互选择线宽，更新线宽激活索引。

---

- **界面构建逻辑**

在该需求中的数据和交互分析完后，就可以考虑界面的构建逻辑了。下面是一个示意简图:

![image.png](assets/257ebf39b83b4106826678f939a58bfe_tplv-k3u1fbpfcp-jj-mark_1890_0_0_0_q75.png)

- 使用 Scaffold + Appbar 组件构建整体结构。
- 使用 CustomPaint 组件构建主体内容，作为可绘制区域。
- 通过 GestureDetector 组件监听拖拽手势，维护数据变化。
- 通过 Stack 组件将画笔颜色和线粗选择器叠放在绘制区上。
- 画笔颜色和线粗选择器的构建将在下一篇详细介绍。

到这里，主要的数据和交互，以及实现的思路就分析的差不多了，接下来就进入项目代码的编写。

---

#### 2. 手势交互与数据维护

如下，新建一个 paper 文件夹，用于盛放白板绘制的相关代码。其中：

- `model.dart` 中盛放相关的数据模型，比如 `Line` 类。
- `paper_app_bar.dart` 是抽离的头部标题组件。
- `paper.dart` 是白板绘制的主界面。

首先在 `_PaperState` 中放入之前分析的数据：

![image.png](assets/021b8fad23074c1d87240610d067ee04_tplv-k3u1fbpfcp-jj-mark_1890_0_0_0_q75.png)

---

想要监听用户的拖拽手势，可以使用 `GestureDetector` 组件的 `pan` 系列回调。如下所示，在 `CustomPaint` 之上嵌套 `GestureDetector` 组件；通过 `onPanStart` 可以监听到用户开始拖拽那刻的事件、通过 `onPanUpdate` 可以监听到用户拖拽中的事件：

```dart
body: GestureDetector(
  onPanStart: _onPanStart,
  onPanUpdate: _onPanUpdate,
  child: CustomPaint(
    //略同...
  ),
)

void _onPanStart(DragStartDetails details) {}

void _onPanUpdate(DragUpdateDetails details) {}
```

---

回调中的逻辑处理也比较简单，在开始拖拽时为线列表添加新线；此时新线就是 `_lines` 的最后一个元素，在拖拽中，为新线添加点即可:

```scss
// 拖拽开始，添加新线
void _onPanStart(DragStartDetails details) {
  _lines.add(Line(points: [details.localPosition],));
}

// 拖拽中，为新线添加点
void _onPanUpdate(DragUpdateDetails details) {
  _lines.last.points.add(details.localPosition);
  setState(() {

  });
}
```

---

#### 3. 画板的绘制逻辑

在 `PaperPainter` 中处理绘制逻辑，绘制过程中需要线列表的数据，而数据在 `_PaperState` 中维护。可以通过构造函数，将数据传入 PaperPainter 中，以供绘制时使用：

```dart
class PaperPainter extends CustomPainter {
  PaperPainter({
    required this.lines,
  }) {
    _paint = Paint()
      ..style = PaintingStyle.stroke
      ..strokeCap = StrokeCap.round;
  }

  late Paint _paint;
  final List<Line> lines;

  @override
  void paint(Canvas canvas, Size size) {
    for (int i = 0; i < lines.length; i++) {
      drawLine(canvas, lines[i]);
    }
  }

  ///根据点集绘制线
  void drawLine(Canvas canvas, Line line) {
    _paint.color = line.color;
    _paint.strokeWidth = line.strokeWidth;
    canvas.drawPoints(PointMode.polygon, line.points, _paint);
  }

  @override
  bool shouldRepaint(CustomPainter oldDelegate) => true;
}
```

绘制逻辑在上面的 `paint` 方法中，便历 `Line` 列表，通过 `drawPoints` 绘制 `PointMode.polygon` 类型的点集； `Line` 对象中的颜色和边线数据，可以在绘制前为画笔设置对应属性。最后，在 `_PaperState` 状态类中，当 `PaperPainter` 对象创建时，将 `_lines` 列表作为入参提供给画板即可：

| ———————————————————— | ———————————————————— |
|---|---|
| ![107.gif](assets/6e453d69331b4f4ab05f823f2a14c781_tplv-k3u1fbpfcp-jj-mark_1890_0_0_0_q75.png) | ![108.gif](assets/6e3248be8674407bacee67617c46f7de_tplv-k3u1fbpfcp-jj-mark_1890_0_0_0_q75.png) |

```css
--->[_PaperState]----
child: CustomPaint(
  painter: PaperPainter(
    lines: _lines
  ),
```

---

#### 4.弹出对话框

在点击清除按钮时，清空线列表。一般对于清除的操作，需要给用户一个确认的对话框，从而避免误操作。如下所示：

| 点击弹框 | 确认清除 |
|---|---|
| ![109.gif](assets/b218f03dc32445cfa70da0a47bff9081_tplv-k3u1fbpfcp-jj-mark_1890_0_0_0_q75.png) | ![110.gif](assets/b9b092c0f0634a98a4b019209e7c8428_tplv-k3u1fbpfcp-jj-mark_1890_0_0_0_q75.png) |

弹出对话框可以使用框架中提供的 `showDialog` 方法，在 `builder` 回调函数中创建需要展示的组件。这里封装了 `ConformDialog` 组件用于展示对话框，将一些文字描述作为参数。这样其他地方想弹出类似的对话框，可以用 `ConformDialog` 组件，这就是封装的可复用性。

```javascript
void _showClearDialog() {
  String msg = "您的当前操作会清空绘制内容，是否确定删除!";
  showDialog(
      context: context,
      builder: (ctx) => ConformDialog(
        title: '清空提示',
        conformText: '确定',
        msg: msg,
        onConform: _clear,
      ));
}

// 点击清除按钮，清空线列表
void _clear() {
  _lines.clear();
  setState(() {
  });
}
```

---

对话框背景是不透明灰色，这种展示效果可以使用 `Dialog` 组件；弹框整体结构也比较简单，是上中下竖直排列，可以使用 `Column` 组件；标题、消息内容、按钮这里通过三个函数来构建：

>

> 小练习: 自己完成 ConformDialog 中三个构建函数的逻辑。

![image.png](assets/189bb7e9e6d7401488696d43abbb4bf6_tplv-k3u1fbpfcp-jj-mark_1890_0_0_0_q75.png)

```scala
class ConformDialog extends StatelessWidget {
  final String title;
  final String msg;
  final String conformText;
  final VoidCallback onConform;

  ConformDialog({
    Key? key,
    required this.title,
    required this.msg,
    required this.onConform,
    this.conformText = '删除',
  }) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return Dialog(
      child: Padding(
        padding: const EdgeInsets.all(20.0),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          mainAxisSize: MainAxisSize.min,
          children: <Widget>[
            _buildTitle(),
            _buildMessage(),
            _buildButtons(context),
          ],
        ),
      ),
    );
  }
  //...
}
```

---

#### 5. 本章小结

本章主要完成白板绘制的基础功能，包括整体布局结构、监听拖拽事件，维护点集数据、以及绘制线集数据。其中蕴含着数据和界面展现的关系，比如，数据是如何产生的、数据在用户的交互期间有哪些变化、数据是如何呈现到界面上的，大家可以自己多多思考和理解。

到这里，界面上的线条会随着手指的拖动而呈现，完成了最基础的功能，当前代码位置 [paper](https://github.com/toly1994328/flutter_first_station/tree/45eae5c9472425a477f8d8282d2f4284b781e113/lib/paper)。下一篇将介绍一下，如何通过交互来修改画笔颜色和粗细，让界面的呈现更加丰富。
