Flutter 像素编辑器#02 | 配置编辑

本系列,将通过 Flutter 实现一个全平台的像素编辑器应用。源码见开源项目 【pix_editor】


上一篇完成了 Flutter 像素编辑器的点击交互,绘制像素。本篇继续完善像素编辑器,划分布局区域,并运行修改项目和画笔的配置。如下所示,是 Flutter 像素编辑器的第二版:


1. Flutter 像素编辑器布局结构

在桌面端中,第二版将应用划分为五个区域:

  • 顶部菜单栏 MenuToolBar :放置菜单以及操作按钮。
  • 左侧编辑工具 ToolBar : 放置编辑按钮。
  • 右侧操作面板 OperationArea : 放置配置操作的内容。
  • 底部信息栏 BottomBar : 展示信息。
  • 中间绘制区 EditorArea :交互绘制像素的区域。

通过行列布局,结合 Expanded 组件,可以是中间的 EditorArea 绘制区大小自适应窗口。

dart 复制代码
class PixEditorPage extends StatelessWidget {
  const PixEditorPage({super.key});

  @override
  Widget build(BuildContext context) {
    return const Scaffold(
      backgroundColor: Colors.white,
      body: Column(
        children: [
          MenuToolBar(),
          Expanded(
              child: Row(
            children: [
              ToolBar(),
              Expanded(child: Column( children: [Expanded(child: EditorArea()), BottomBar()] )),
              OperationArea()
            ],
          )),
        ],
      ),
    );
  }
}

目前 BottomBar、MenuToolBar、ToolBar 三个区域只是简单展示一下,具体功能后续完善。本篇主要着重介绍 OperationArea 操作区,如何影响 EditorArea 绘图区。


2、数据变化的业务逻辑

OperationArea 操作区在编辑时,绘图区的内容需要实时变化。比如下面修改网格的数量,输入过程中绘图区的个数会相对改变:

所以需要数据的变化可以通知画板进行更新。这里定义 ProjectConfigLogic 类维护配置状态数据,混入 ChangeNotifier 拥有通知监听的能力。其中主要维护 PixEditorConfig 配置数据,并提供一些方法,来修改某个维度的数据。数据变化后通过 notifyListeners 通知更新:

dart 复制代码
class ProjectConfigLogic with ChangeNotifier {

  late TextEditingController rowCtrl = TextEditingController(text: config.row.toString());
  late TextEditingController columnCtrl = TextEditingController(text: config.column.toString());

  @override
  void dispose() {
    rowCtrl.dispose();
    columnCtrl.dispose();
    super.dispose();
  }

  PixEditorConfig _config = PixEditorConfig(
    column: 5,
    row: 5,
    name: "新建文件",
    backgroundColor: const Color(0xfff0f0f0),
    gridColor: Colors.white,
    showGrid: true,
  );

  PixEditorConfig get config => _config;

  set config(PixEditorConfig config){
    _config = config;
    notifyListeners();
  }

  void updateRow(int row){
    rowCtrl.text = row.toString();
    config = _config.copyWith(row: row);
  }
  void updateBackgroundColor(Color color){
    config = _config.copyWith(backgroundColor: color);
  }
  void updateGridColor(Color color) {
    config = _config.copyWith(gridColor: color);
  }

  void updateColumn(int column){
    columnCtrl.text = column.toString();
    config = _config.copyWith(column: column);
  }

  void toggleShowGrid(){
    config = _config.copyWith(showGrid: !_config.showGrid);
  }
}

3、项目配置的状态数据管理

接下来就需要访问 ProjectConfigLogic 的数据进行界面构建,并触发其方法,修改数据触发更新。这里拿是否展示网格的这条功能需求,介绍一下如何处理:

目前功能并不是很复杂,使用 Flutter 内置的 InheritedNotifier 来共享 ProjectConfigLogic 即可。后面功能复杂之后,再考虑使用状态管理的库,来维护 ProjectConfigLogic 的功能。如下所示,定义 ProjectConfigScope 向子树提供状态数据:

dart 复制代码
class ProjectConfigScope extends InheritedNotifier<ProjectConfigLogic> {
  const ProjectConfigScope({
    required super.notifier,
    required super.child,
    super.key,
  });

  static ProjectConfigLogic of(BuildContext context) =>
      context.dependOnInheritedWidgetOfExactType<ProjectConfigScope>()!.notifier!;

  static ProjectConfigLogic read(BuildContext context) =>
      context.getInheritedWidgetOfExactType<ProjectConfigScope>()!.notifier!;
}

然后再需要共享数据组件们的上层嵌套 ProjectConfigScope,来达到向子树共享数据的目的:

ps:之前在 《 Flutter 组件集录 | InheritedNotifier 内置状态管理组件》 一文中介绍过 InheritedNotifier 的使用。


这样,下层的组件可以通过 ProjectConfigScope.of(context) 根据上下文得到 ProjectConfigLogic 业务逻辑对象。对于是否显示网格来说 Checkbox 的 value 可以访问 configLogic 中的数据;点击事件 onChanged 中,通过 configLogic 对象触发 toggleShowGrid 方法,修改是否展示网格的配置数据,并触发更新:

dart 复制代码
ProjectConfigLogic configLogic = ProjectConfigScope.of(context);

Row(
  children: [
    Text("显示网格", style: TextStyle(fontSize: 12)),
    const SizedBox(width: 8),
    Container(
      width: 20,
      height: 20,
      child: Checkbox(
        value: configLogic.config.showGrid,
        onChanged: (bool? value) {
          configLogic.toggleShowGrid();
        },
      ),
    )
  ],
),

其他的配置项数据的修改同理。


4、绘制信息的状态数据管理

绘制信息中目前增加了画笔的颜色,我们也可以通过业务逻辑层,来封装绘制方面的状态数据。如下定义 PixPaintLogic 来维护像素点列表 _pixCells,以及画笔颜色 _paintColor。这样命中像素点数据变化逻辑,就可以写在 PixPaintLogic 中。

dart 复制代码
class PixPaintLogic with ChangeNotifier {
  final List<PixCell> _pixCells = [];

  List<PixCell> get pixCells => _pixCells;

  Color get paintColor => _paintColor;

  set paintColor(Color value){
    _paintColor = value;
    notifyListeners();
  }

  Color _paintColor = const Color(0xff5ec8f8);

  // 命中像素点
  void hitPix(int x,int y) {
    bool hasPix = _pixCells.where((e) => e.position == (x, y)).isNotEmpty;
      if (hasPix) {
      _pixCells.removeWhere((e) => e.position == (x, y));
    } else {
      _pixCells.add(PixCell(color: _paintColor, position: (x,y)));
    }
    notifyListeners();
  }
}

同理,提供 PixPaintScope 向子树共享 PixPaintLogic 业务逻辑对象:

dart 复制代码
class PixPaintScope extends InheritedNotifier<PixPaintLogic> {
  const PixPaintScope({
    required super.notifier,
    required super.child,
    super.key,
  });

  static PixPaintLogic of(BuildContext context) =>
      context.dependOnInheritedWidgetOfExactType<PixPaintScope>()!.notifier!;

  static PixPaintLogic read(BuildContext context) =>
      context.getInheritedWidgetOfExactType<PixPaintScope>()!.notifier!;
}

此时剩下最后一件事,如何在两个业务逻辑对象更新时,通知画板进行重新绘制呢? CustomPainter 可以指定 repaint 参数,监听可监听对象,当其进行通知时,会触发画板的重绘。所以只要将两个可监听的,业务逻辑对象传入画板中即可:

在共享区域的子树,有上下文的地方,就可以得到业务逻辑对象。这里可以通过 read 方法,让绘制区不建立依赖关系,这样更新时 EditorArea 不会重新构建,仅通知画板进行更新:


5、性能方面

目前 100*100 的网格中,需要绘制 10000 个方格,此时 windows 中的帧率远远低于 120 FPS。没有任何性能问题,后续随着功能的增加,会多多注意性能方面的变化,那本文就到这里,谢谢观看 ~

相关推荐
Estar.Lee1 小时前
时间操作[计算时间差]免费API接口教程
android·网络·后端·网络协议·tcp/ip
找藉口是失败者的习惯2 小时前
从传统到未来:Android XML布局 与 Jetpack Compose的全面对比
android·xml
Jinkey3 小时前
FlutterBasic - GetBuilder、Obx、GetX<Controller>、GetxController 有啥区别
android·flutter·ios
大白要努力!5 小时前
Android opencv使用Core.hconcat 进行图像拼接
android·opencv
天空中的野鸟6 小时前
Android音频采集
android·音视频
小白也想学C7 小时前
Android 功耗分析(底层篇)
android·功耗
曙曙学编程7 小时前
初级数据结构——树
android·java·数据结构
Summer不秃7 小时前
Flutter之使用mqtt进行连接和信息传输的使用案例
前端·flutter
旭日猎鹰7 小时前
Flutter踩坑记录(二)-- GestureDetector+Expanded点击无效果
前端·javascript·flutter
sunly_7 小时前
Flutter:AnimatedSwitcher当子元素改变时,触发动画
flutter