作者：李俊才 （jcLee95）：https://blog.csdn.net/qq_28550263
邮箱 ：291148484@163.com
本文地址：https://blog.csdn.net/qq_28550263/article/details/133418742

1. 任务介绍

在本文中，我们将一起开发一个基本的Flutter画板应用，用户可以在画板上自由绘制，选择不同的颜色来绘制线条。这个画板应用将允许用户通过点击颜色选择按钮来选择画笔的颜色，并提供鼠标光标支持以增强用户体验。

任务要求

1. 创建一个Flutter应用，包含一个画板界面，初始时，画板上没有任何绘制内容。
2. 实现颜色选择功能，用户可以点击应用栏中的颜色选择按钮，弹出颜色选择对话框，选择绘制颜色。
3. 支持自由绘制功能，用户可以使用鼠标或触摸屏在画板上自由绘制线条。绘制时，使用所选的颜色。
4. 当用户在画板上绘制时，应实时显示他们的绘制内容。
5. 用户可以使用鼠标光标，绘制不同颜色的线条。

效果预览

预期收获

任务完成后，你将具备以下技能：

• Flutter应用开发基础知识。
• 实现用户界面中的颜色选择和绘制功能。
• 处理用户输入和手势操作。
• 自定义绘制，使用自定义绘制器和Canvas API。

这个任务将有助于您深入了解Flutter应用的开发，以及如何实现一个具有基本绘图功能的用户界面。

2. 知识点准备

本文将使用以下知识点，最终实现

1. MouseRegion: MouseRegion 用于捕获鼠标事件，允许您指定鼠标在其内部时的行为，包括设置鼠标光标的外观（在这里使用了 SystemMouseCursors.click）。

2. SystemMouseCursors: SystemMouseCursors 是一个用于指定不同系统鼠标光标样式的类。在这里，我们使用了 SystemMouseCursors.click，将鼠标光标设置为点击样式，以提供用户视觉反馈。

3. GestureDetector: GestureDetector 用于捕获用户手势事件，如拖动手势（onPanUpdate 和 onPanEnd）。它允许您检测用户的绘制动作并触发相应的回调。

4. CustomPaint: CustomPaint 是一个用于自定义绘制的容器，它接受一个自定义的 CustomPainter 对象。在这里，它用于呈现用户的绘制。

5. CustomPainter: CustomPainter 是一个抽象类，它包含了用于自定义绘制的方法。在这里，我们创建了 MyPainter 类来实现绘制用户绘制的笔画。

6. RenderBox: RenderBox 是一个用于获取渲染对象的边界框和坐标的类。在这里，我们使用它来获取鼠标事件的本地坐标，并将其转换为相对于 CustomPaint 的坐标。

7. Canvas: Canvas 是一个用于绘制 2D 图形的画布。我们使用它在 MyPainter 中绘制用户的笔画。

8. PointMode：PointMode 类用于指定如何绘制点的枚举类。在画板应用中，它有两种可能的值：

   • PointMode.points: 这个模式用于绘制单个点。当用户在画板上点击并松开鼠标时，将使用此模式来绘制点，以实现单击绘制的效果。
   • PointMode.polygon: 这个模式用于绘制连接的线条。当用户在画板上拖动鼠标时，将使用此模式来绘制连接的线条，以实现绘制笔画的效果。

   PointMode 通过 canvas.drawPoints 方法在 CustomPainter 中使用，用于指定如何绘制用户的绘制。对于单击，我们使用 PointMode.points 来绘制点，而对于笔画，我们使用 PointMode.polygon 来绘制连接的线条。
   该类包含在dart:ui库中。

9. flutter_colorpicker 模块：这是一个选择颜色的第三方模块，你可以参考其官方文档

3. 代码实现与效果

import 'dart:ui';
import 'package:flutter/material.dart';
import 'package:flutter_colorpicker/flutter_colorpicker.dart';void main() => runApp(const MyApp());class MyApp extends StatelessWidget {const MyApp({super.key});@overrideWidget build(BuildContext context) {return const MaterialApp(home: DrawingBoard(),);}
}/// 画板应用的主页 [StatefulWidget]。
class DrawingBoard extends StatefulWidget {const DrawingBoard({super.key});@overrideState<DrawingBoard> createState() => _DrawingBoardState();
}/// [DrawingBoard] 的状态类，负责管理用户绘制的功能和界面。
class _DrawingBoardState extends State<DrawingBoard> {List<DrawObject> drawObjects = [];Color selectedColor = Colors.black;bool isFirstDraw = true;/// 显示颜色选择对话框的方法。void selectColor() {showDialog(context: context,builder: (BuildContext context) {Color newColor = selectedColor;return AlertDialog(title: const Text('选择颜色'),content: SingleChildScrollView(child: ColorPicker(pickerColor: selectedColor,onColorChanged: (color) {newColor = color;},),),actions: <Widget>[TextButton(onPressed: () {setState(() {selectedColor = newColor;});Navigator.of(context).pop();},child: const Text('确定'),),],);},);}@overrideWidget build(BuildContext context) {// 创建一个鼠标光标，使用Icons.draw_outlined图标const mouseCursor = SystemMouseCursors.click;return Scaffold(appBar: AppBar(title: const Text('Jack Lee 的画板'),actions: [IconButton(icon: const Icon(Icons.color_lens),onPressed: () {selectColor();},),],),body: MouseRegion(cursor: mouseCursor, // 使用自定义光标child: GestureDetector(onPanUpdate: (details) {setState(() {RenderBox renderBox = context.findRenderObject() as RenderBox;final offset = renderBox.globalToLocal(details.localPosition);if (isFirstDraw) {drawObjects.add(DrawObject([], selectedColor));isFirstDraw = false;}if (drawObjects.isNotEmpty) {drawObjects.last.points.add(offset);}});},onPanEnd: (details) {setState(() {drawObjects.add(DrawObject([], selectedColor));isFirstDraw = true;});},child: CustomPaint(painter: MyPainter(drawObjects),size: Size.infinite,),),),);}
}/// 自定义画板的绘制器 [CustomPainter]。
class MyPainter extends CustomPainter {final List<DrawObject> drawObjects;MyPainter(this.drawObjects);@overridevoid paint(Canvas canvas, Size size) {for (final drawObject in drawObjects) {final paint = Paint()..color = drawObject.color..strokeCap = StrokeCap.round..strokeWidth = 5.0;if (drawObject.points.length > 1) {for (int i = 0; i < drawObject.points.length - 1; i++) {if (drawObject.points[i] != null &&drawObject.points[i + 1] != null) {canvas.drawLine(drawObject.points[i]!, drawObject.points[i + 1]!, paint);}}} else if (drawObject.points.isNotEmpty) {canvas.drawPoints(PointMode.points, drawObject.points.cast<Offset>(), paint);}}}@overridebool shouldRepaint(CustomPainter oldDelegate) {return true;}
}/// 用户绘制的对象类，包括点和颜色。
class DrawObject {final List<Offset?> points;final Color color;DrawObject(this.points, this.color);
}

效果如图所示：