作者:李俊才 (jcLee95):https://blog.csdn.net/qq_28550263
邮箱 :291148484@163.com
本文地址:https://blog.csdn.net/qq_28550263/article/details/133418742
目 录
- 1. 任务介绍
- 任务要求
- 效果预览
- 预期收获
- 2. 知识点准备
- 3. 代码实现与效果
1. 任务介绍
在本文中,我们将一起开发一个基本的Flutter画板应用,用户可以在画板上自由绘制,选择不同的颜色来绘制线条。这个画板应用将允许用户通过点击颜色选择按钮来选择画笔的颜色,并提供鼠标光标支持以增强用户体验。
任务要求
- 创建一个Flutter应用,包含一个画板界面,初始时,画板上没有任何绘制内容。
- 实现颜色选择功能,用户可以点击应用栏中的颜色选择按钮,弹出颜色选择对话框,选择绘制颜色。
- 支持自由绘制功能,用户可以使用鼠标或触摸屏在画板上自由绘制线条。绘制时,使用所选的颜色。
- 当用户在画板上绘制时,应实时显示他们的绘制内容。
- 用户可以使用鼠标光标,绘制不同颜色的线条。
效果预览
预期收获
任务完成后,你将具备以下技能:
- Flutter应用开发基础知识。
- 实现用户界面中的颜色选择和绘制功能。
- 处理用户输入和手势操作。
- 自定义绘制,使用自定义绘制器和Canvas API。
这个任务将有助于您深入了解Flutter应用的开发,以及如何实现一个具有基本绘图功能的用户界面。
2. 知识点准备
本文将使用以下知识点,最终实现
-
MouseRegion:
MouseRegion
用于捕获鼠标事件,允许您指定鼠标在其内部时的行为,包括设置鼠标光标的外观(在这里使用了SystemMouseCursors.click
)。 -
SystemMouseCursors:
SystemMouseCursors
是一个用于指定不同系统鼠标光标样式的类。在这里,我们使用了SystemMouseCursors.click
,将鼠标光标设置为点击样式,以提供用户视觉反馈。 -
GestureDetector:
GestureDetector
用于捕获用户手势事件,如拖动手势(onPanUpdate
和onPanEnd
)。它允许您检测用户的绘制动作并触发相应的回调。 -
CustomPaint:
CustomPaint
是一个用于自定义绘制的容器,它接受一个自定义的CustomPainter
对象。在这里,它用于呈现用户的绘制。 -
CustomPainter:
CustomPainter
是一个抽象类,它包含了用于自定义绘制的方法。在这里,我们创建了MyPainter
类来实现绘制用户绘制的笔画。 -
RenderBox:
RenderBox
是一个用于获取渲染对象的边界框和坐标的类。在这里,我们使用它来获取鼠标事件的本地坐标,并将其转换为相对于CustomPaint
的坐标。 -
Canvas:
Canvas
是一个用于绘制 2D 图形的画布。我们使用它在MyPainter
中绘制用户的笔画。 -
PointMode:
PointMode
类用于指定如何绘制点的枚举类。在画板应用中,它有两种可能的值:- PointMode.points: 这个模式用于绘制单个点。当用户在画板上点击并松开鼠标时,将使用此模式来绘制点,以实现单击绘制的效果。
- PointMode.polygon: 这个模式用于绘制连接的线条。当用户在画板上拖动鼠标时,将使用此模式来绘制连接的线条,以实现绘制笔画的效果。
PointMode 通过
canvas.drawPoints
方法在 CustomPainter 中使用,用于指定如何绘制用户的绘制。对于单击,我们使用PointMode.points
来绘制点,而对于笔画,我们使用PointMode.polygon
来绘制连接的线条。
该类包含在dart:ui
库中。 -
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});Widget build(BuildContext context) {return const MaterialApp(home: DrawingBoard(),);}
}/// 画板应用的主页 [StatefulWidget]。
class DrawingBoard extends StatefulWidget {const DrawingBoard({super.key});State<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('确定'),),],);},);}Widget 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);void 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);}}} bool shouldRepaint(CustomPainter oldDelegate) {return true;}
}/// 用户绘制的对象类,包括点和颜色。
class DrawObject {final List<Offset?> points;final Color color;DrawObject(this.points, this.color);
}
效果如图所示: