Skip to content

About

一款绘图APP

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

VectorApp & VectorEngine

./截图.png

这是一套用于深入理解现代矢量图形编辑器 (如 Sketch、Figma) 底层架构与渲染原理的纯原生 Swift 工程原型。

本项目拒绝使用传统的面向对象 (OOP) UI 组件拼接,而是完全基于单向数据流、值类型模型 (Value Semantics) 和直接图形 API (CoreGraphics) 绘制。这种架构正是当今高性能设计工具和游戏引擎的核心秘密。

✨ 核心特性 (Features)

  • ⚡️ VectorEngine (纯粹的底层数据与渲染引擎)

    • 值类型文档树 (Layer Tree): 采用 Struct 和 Enum 构建不可变的数据模型 (DocumentState),天然规避了引用类型的状态污染。
    • SVG 路径解析器 (SVG Path Parser): 手写词法分析 (Lexer) 和语法分析 (Parser),支持解析标准的 SVG d 属性 (M, L, C, Z),包括处理相对/绝对坐标和隐式省略指令。
    • 高性能渲染器 (DocumentRenderer): 将纯数据模型遍历并翻译为底层 CGContext 绘图指令,严格管理图形的 Z-Index 和局部 CGAffineTransform 矩阵变换。
    • 拓扑学碰撞检测 (Hit-Testing): 基于 CGPath.contains(using: .winding) 的非零环绕规则。无论图形形状多复杂、被移动过多少次,都能像素级精准判断鼠标是否点击了图形实体,而非仅仅点击了包围盒。
    • 时间旅行撤销系统 (Undo/Redo System): 得益于 Swift 的 Copy-on-Write 机制,HistoryManager 只需 40 行代码即可实现无内存泄漏的无限次“整个世界快照”的撤销与重做。
  • 🖥 VectorApp (macOS 原生交互层)

    • 工具状态机 (Tool Mode): 支持“选择工具 (V)”与“钢笔工具 (P)”的无缝切换。
    • 选择与拖拽 (Selection & Dragging): 实时修改数据模型的矩阵 (transform.tx, ty) 并触发重绘,实现丝滑的拖拽体验,并实时绘制蓝色包围盒 (Bounding Box) 与控制手柄。
    • 钢笔作图 (Pen Tool): 拦截鼠标点击与拖拽,利用中心对称算法自动计算三次贝塞尔曲线的前向/后向控制手柄,实现所见即所得的平滑曲线绘制。
    • 快捷键驱动: 支持 Cmd+Z / Shift+Cmd+Z 撤销重做,支持按下 R/G/B/Y 快捷修改选中图层的颜色。

📂 工程结构 (Project Structure)

.
├── Docs/                           # 核心架构设计与原理推导文档 (必读!)
│   ├── 01_Architecture_and_SVG_Design.md
│   ├── 02_Data_Model_Design.md
│   ├── 03_Renderer_Engine.md
│   ├── 04_SVG_Parser_Design.md
│   ├── 05_Interaction_and_HitTesting.md
│   ├── 06_Undo_Redo_System.md
│   ├── 07_Pen_Tool_and_Bezier_Curves.md
│   └── 08_BoundingBox_and_Color.md
│
├── VectorEngine/                   # 底层引擎 (纯 Swift Package,不依赖 UI 框架)
│   ├── Package.swift
│   ├── Sources/VectorEngine/
│   │   ├── DocumentModel.swift     # 图层树结构 (Document, LayerNode)
│   │   ├── Primitives.swift        # 基础数据结构 (Color, Transform, PathCommand)
│   │   ├── Style.swift             # 样式结构 (Fill, Stroke)
│   │   ├── SVGPathParser.swift     # SVG 字符串解析器 (核心算法)
│   │   ├── HitTester.swift         # 射线碰撞检测
│   │   ├── Renderer.swift          # CoreGraphics 渲染器
│   │   └── HistoryManager.swift    # 撤销/重做快照栈
│   └── Tests/VectorEngineTests/    # 引擎单元测试 (TDD 保证解析器健壮性)
│
└── VectorApp/                      # macOS 可执行应用 (依赖 VectorEngine)
    ├── Package.swift
    └── Sources/VectorApp/
        └── VectorApp.swift         # SwiftUI 壳子 + 继承自 NSView 的核心 CanvasView

🚀 如何运行 (How to Run)

本项目对环境依赖极低,只需安装了 macOS 与 Swift 工具链 (Xcode) 即可。

方法一:命令行运行 (推荐)

打开终端,进入应用目录,直接运行:

cd VectorApp
swift run

(首次运行可能需要编译几秒钟,随后会自动弹出 macOS 原生应用窗口)

方法二:使用 Xcode 打开

  1. 双击 VectorApp 文件夹中的 Package.swift 文件,Xcode 会自动解析整个工程。
  2. 在顶部的 Scheme 下拉菜单中选择 VectorApp。
  3. 点击 Run (Cmd+R) 按钮编译并运行。

🎮 交互指南 (Playground Guide)

当 App 窗口出现后,你可以进行以下操作:

  1. 拖拽图层: 鼠标直接拖拽画板中央的“红心”或“绿圆”。
  2. 快捷换色: 点击选中红心(出现蓝色包围盒后),在键盘上按下 B(蓝色)、G(绿色)、Y(黄色)、R(红色)。
  3. 体验撤销: 拖动完或者换色后,按下 Cmd + Z 体验时间倒流。按下 Cmd + Shift + Z 重做。
  4. 使用钢笔画曲线:
    • 按下键盘的 P 键进入钢笔模式(鼠标变成十字)。
    • 在画板上点击一下松开:创建直线顶点。
    • 在画板上点击并拖拽:拉出贝塞尔控制手柄,画出平滑的曲线。
    • 按下 ESC 键完成这条路径的绘制。它将永久留在画板上,并且可以被选择和拖拽!
    • 按下键盘的 V 键退出钢笔模式,回到选择模式。

Generated as an architectural prototype for deeply understanding vector graphic editors.

About

一款绘图APP

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages