这是一套用于深入理解现代矢量图形编辑器 (如 Sketch、Figma) 底层架构与渲染原理的纯原生 Swift 工程原型。
本项目拒绝使用传统的面向对象 (OOP) UI 组件拼接,而是完全基于单向数据流、值类型模型 (Value Semantics) 和直接图形 API (CoreGraphics) 绘制。这种架构正是当今高性能设计工具和游戏引擎的核心秘密。
-
⚡️ 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 行代码即可实现无内存泄漏的无限次“整个世界快照”的撤销与重做。
- 值类型文档树 (Layer Tree): 采用
-
🖥 VectorApp (macOS 原生交互层)
- 工具状态机 (Tool Mode): 支持“选择工具 (V)”与“钢笔工具 (P)”的无缝切换。
- 选择与拖拽 (Selection & Dragging): 实时修改数据模型的矩阵 (
transform.tx, ty) 并触发重绘,实现丝滑的拖拽体验,并实时绘制蓝色包围盒 (Bounding Box) 与控制手柄。 - 钢笔作图 (Pen Tool): 拦截鼠标点击与拖拽,利用中心对称算法自动计算三次贝塞尔曲线的前向/后向控制手柄,实现所见即所得的平滑曲线绘制。
- 快捷键驱动: 支持 Cmd+Z / Shift+Cmd+Z 撤销重做,支持按下 R/G/B/Y 快捷修改选中图层的颜色。
.
├── 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
本项目对环境依赖极低,只需安装了 macOS 与 Swift 工具链 (Xcode) 即可。
打开终端,进入应用目录,直接运行:
cd VectorApp
swift run(首次运行可能需要编译几秒钟,随后会自动弹出 macOS 原生应用窗口)
- 双击
VectorApp文件夹中的Package.swift文件,Xcode 会自动解析整个工程。 - 在顶部的 Scheme 下拉菜单中选择
VectorApp。 - 点击
Run(Cmd+R) 按钮编译并运行。
当 App 窗口出现后,你可以进行以下操作:
- 拖拽图层: 鼠标直接拖拽画板中央的“红心”或“绿圆”。
- 快捷换色: 点击选中红心(出现蓝色包围盒后),在键盘上按下
B(蓝色)、G(绿色)、Y(黄色)、R(红色)。 - 体验撤销: 拖动完或者换色后,按下
Cmd + Z体验时间倒流。按下Cmd + Shift + Z重做。 - 使用钢笔画曲线:
- 按下键盘的
P键进入钢笔模式(鼠标变成十字)。 - 在画板上点击一下松开:创建直线顶点。
- 在画板上点击并拖拽:拉出贝塞尔控制手柄,画出平滑的曲线。
- 按下
ESC键完成这条路径的绘制。它将永久留在画板上,并且可以被选择和拖拽! - 按下键盘的
V键退出钢笔模式,回到选择模式。
- 按下键盘的
Generated as an architectural prototype for deeply understanding vector graphic editors.