Graphite 2024 年第四季度进展报告：Q4 质量生活特性与过程式编辑工作流全面升级

Graphite 2024 年第四季度进展报告：Q4 质量生活特性与过程式编辑工作流全面升级

【免费下载链接】GraphiteCommunity-built comprehensive 2D content creation appplication for graphic design, digital art, and interactive real-time motion graphics powered by a node-based procedural graphics engine项目地址: https://gitcode.com/GitHub_Trending/gr/Graphite

导读

本报告整理并解读 Graphite（开源 2D 过程式图形编辑器）2024 年第四季度（10 月至 12 月）的完整开发进展：本季度没有停留在基础框架上，而是聚焦于交互式工具工作流与过程式节点编辑工作流的"质量生活"（Quality of Life）特性——包括将选中节点合并为可复用子图的节点图新能力、文本工具的行高/字距/文本框控制、一批新的矢量与数学节点、以及大量路径工具细节改进与修复。读完本文你将掌握 Q4 新增的每个节点与交互特性的功能定位、参数含义、快捷键与底层源码实现（仓库相对路径见文内链接），可用于理解 Graphite 当前的编辑能力边界，也可作为查阅源码的导航。

一、Q4 概览：围绕两种工作流的打磨

2024 年 Q4（10-12 月）Graphite 的所有提交都可在仓库 git 历史中按时间范围查看，全部值得注意的变更如下文各节详述。本季度是 2024 年季度系列报告的第四篇，此前发布过 Q3 2024 进展报告，当时引入了Changing Seasons演示作品。

本季度核心主题：在 Graphite 的两种核心创作范式上做细节打磨：

• 工具驱动工作流：画笔（Pen）、路径（Path）、徒手（Freehand）、选择（Select）、文本（Text）、画板（Artboard）等工具的交互细节改进与 bug 修复；
• 过程式编辑工作流：节点图中新增可合并子图、多个矢量修改节点、多个数学节点、节点属性面板增强等。

Q4 还发布了新演示作品Parametric Dunescape（参数化沙丘）：这是为了展示"将选中节点合并为可复用子图"这一新特性而创作——沙丘的每一层都由自定义参数（颜色、高度、随机种子）过程式生成，无需手工绘制。对应源文件可在 demo-artwork/parametric-dunescape.graphite 查看。

关于发布时间说明：本文档发布于 2025 年 3 月 31 日，报告 2024 年 10 月至 12 月三个月的开发成果；文中同时提到 GSoC 2025 实习申请截止时间为 4 月 8 日 18:00 UTC，以及贡献/QA 测试/艺术与营销类志愿项目等参与方式。

二、节点图核心新特性：合并选中节点为子图

本季度最重要的节点图功能更新是：在节点上下文菜单中通过 "Merge Selected Nodes" 选项，或快捷键CtrlM（macOS 上为⌘M），把选中的多个节点合并成一个自定义节点（子图）。

这一特性让过程式编辑的可组合性显著提升：

• 复用：将一段反复使用的节点逻辑打包成单个节点后，可在同一文档乃至其他文档中重复使用，避免重复布线；
• 封装：子图对外只暴露必要的输入输出端口，使复杂网络的顶层视图更简洁；
• 参数化：这正是Parametric Dunescape演示作品的核心手段——每个沙丘层通过其自定义参数（颜色、高度、随机种子）由同一子图生成，改变了参数即可改变整个沙丘形态。

从仓库结构看，Graphite 的节点系统建立在 node-graph/graph-craft 的编译/文档模型与 node-graph/nodes 各功能节点集之上；节点宏机制定义于 node-graph/node-macro，节点图执行由 node-graph/interpreted-executor 与 node-graph/graphene-cli 支撑。合并子图即在此架构之上，将选中的节点集合折叠为一个新的可调用节点（调用方即子图实例），其输入输出连接关系被保留为子图端口。

三、文本与排版控制：行高、字距与可拖拽文本框

文本工具本季度获得了排版层面的实用控制：

• 行高（Line height）：控制多行文本的垂直间距；
• 字符间距（Character spacing）：控制字符间的水平留白，用于字母间距微调；
• 可拖拽的换行框区域（Wrappable box areas）：文本被限定在可拖拽的盒子内换行，框的大小可直接用 Text 工具拖动调整。

这些控制让文本不再只是"一行文字"或"纯文本框"，而是可以进行精细排版约束的排版对象。相关实现可参考 node-graph/nodes/text 中的文本处理与 editor/src/messages/tool/common_functionality 中工具的公共功能模块。仓库内置字体资源 node-graph/nodes/text/src/source-sans-pro-regular.ttf 展示了文本节点默认使用的字体文件形态。

四、属性面板增强：可固定的节点分区、节点插入与图层重命名

4.1 节点分区可固定（Pinnable node sections）

Properties（属性）面板中，节点属性可以"固定"（pin）。当节点被选中时，其属性按分区（section）展示；用户可以固定某个分区，使其在切换选择其他节点时保持显示，便于在不同节点间对照参数。

4.2 节点插入按钮与图层重命名

• 节点插入按钮：Properties 面板新增节点插入按钮，无需切到节点图即可在选定节点后直接插入新节点；
• 图层重命名：可直接在 Properties 面板中重命名图层，省去在 Layers 面板中的二次操作。

这两项改进把高频操作前置到属性面板，缩短了"选中 → 修改"的路径。

五、新增矢量节点：Offset Path、Flatten、Bevel、Jitter Points

5.1 Offset Path 节点

Offset Path节点用于沿法线方向整体扩展或收缩一个矢量形状。其核心实现位于 node-graph/nodes/vector/src/vector_nodes.rs，源码签名如下：

#[node_macro::node(category("Vector: Modifier"), path(core_types::vector), properties("offset_path_properties"))] async fn offset_path<V: MapVectorItems + 'n + Send>( _: impl Ctx, #[implementations(Graphic, Vector)] content: Item<V>, distance: Item<f64>, join: Item<StrokeJoin>, #[default(4.)] miter_limit: Item<f64>, ) -> Item<V>

参数说明：

实现细节：节点遍历输入形状的所有子路径（stroke_bezpath_iter），将其变换到世界坐标后交给 Kurbo 库的偏移算法（offset_bezpath）按-distance计算新路径，再逆变换回局部坐标并重建矢量。Join 参数直接映射为 Kurbo 的Join::Miter/Bevel/Round。miter_limit 默认值 4.0与 Kurbo 的斜接限制语义一致——当尖角比例超过该值时会自动退化为斜切，防止产生过长的尖刺。

5.2 Flatten Vector Elements 节点

Flatten Vector Elements节点把多个矢量路径图层合并为单一组合路径。其意义在于配合本季度对实例化节点的改动（见下节）：当Copy to Points、Repeat、Circular Repeat改为输出组（group）数据后，若希望恢复"单一路径"的旧行为，就用Flatten Vector Elements展开组内各层并合并。

实现上，矢量修改节点共享MapVectorItems等特质接口（见 node-graph/nodes/vector/src/vector_nodes.rs 顶部的for_each_vector_list_mut、expand_vector_items等抽象），Flatten 即通过"把组内的每个矢量元素映射并展开为单个矢量"完成合并。

5.3 Bevel 节点

Bevel节点将矢量形状的尖角"切平"（倒角），通过把角点替换为斜切线段来柔化轮廓。它对装饰性图形与图标设计尤为实用，可在保留整体轮廓的同时消除尖锐角点。

5.4 Jitter Points 节点

Jitter Points节点随机偏移矢量路径中的每个点，生成手绘抖动、自然感或噪声效果。可用于破坏机械感、生成有机形态，配合随机种子可复现/变换同一种抖动样式。

5.5 节点之间组合示例

从源码结构看，矢量修改节点（如 Offset Path、Bevel、Jitter Points、Round Corners、Simplify、Decimate 等）集中定义在 node-graph/nodes/vector/src/vector_nodes.rs，均属于Vector: Modifier类别，可随意串联：例如Jitter Points→Offset Path→Fill，形成"先抖动再扩边再填充"的过程式管线。

六、组数据与实例化节点改造

本季度对实例化相关节点做了数据语义升级：

• Copy to Points、Repeat、Circular Repeat 节点现在输出组（group）数据，而不是单一路径；
• 这意味着每个单独实例（每个复制出来的图层）可以继续被针对组运算的节点处理，例如Assign Colors（按组逐层赋色）；
• 若希望保持旧行为（实例作为一条完整路径），则用新增的Flatten Vector Elements节点展开合并。

同时，Fill 与 Stroke 节点开始支持组输入：当输入为组时，填充/描边会应用到组内的每一个矢量图层上。这两项改动配合使用，可以在一次实例化后统一给所有副本赋色、描边，极大提升批量装饰效率。源码位于 node-graph/nodes/repeat/src/repeat_nodes.rs（Repeat 系列）与 node-graph/nodes/vector/src/vector_nodes.rs 中的assign_colors、fill、stroke节点。

七、新增通用与数学节点

7.1 Switch 节点

Switch节点根据一个true/false 布尔值，在两条数据连接中二选一进行路由（类似三元运算的数据流版本）。适合条件分支逻辑，如"根据开关切换两组参数"。

7.2 Clamp 节点

Clamp节点将输入数值限制在 [min, max] 区间内：低于最小值取最小值，高于最大值取最大值。常用于把无界输入约束到合法范围（如角度、透明度、比例）。

7.3 类型转换节点：To U32 与 To U64

To U32与To U64节点把数值转换为无符号整数类型，供少数要求正整数输入的节点使用——这是自动类型转换尚未完全支持时的显式工作区。在 node-graph/libraries/core-types 的类型系统中，这类显式转换节点弥补了 contravariance（逆变）类型检查的覆盖缺口。

7.4 Dot Product 节点

Dot Product节点计算两个数值向量（vec2）的点积（数学上的内积），结果为标量。常用于向量投影、夹角判断等几何计算。

7.5 Math 节点：自定义数学表达式

Math节点接受一个自定义数学表达式字符串，并在其中使用变量 "A" 与 "B" 进行计算。实现位于 node-graph/nodes/math/src/lib.rs：

#[node_macro::node(category("Math: Arithmetic"), properties("math_properties"))] fn math<T: num_traits::float::Float>( _: impl Ctx, /// The value of "A" when calculating the expression. #[implementations(f64, f32)] operand_a: Item<T>, /// A math expression that may incorporate "A" and/or "B", such as `sqrt(A + B) - B^2`. #[default("A + B")] expression: Item<String>, /// The value of "B" when calculating the expression. #[implementations(f64, f32)] #[default(1.)] operand_b: Item<T>, ) -> Item<T>

参数要点：

表达式解析与求值由仓库中的Math-Parser 库承担（本季度内部改动之一），位于 libraries/math-parser，提供完整的词法/语法分析（lexer.rs、parser.rs、ast.rs）与求值器（executer.rs）。节点通过ast::Node::try_parse_from_str解析表达式、构造EvalContext注入 A/B 值后求值；表达式非法或求值失败时记录警告并回退输出 0。文档演示了经典插值表达式0.33 * A + (1 - 0.33) * B，即 A、B 按 33%/67% 权重混合——可用于节点参数的平滑过渡或混合。

7.6 三角函数选项与 Modulo 增强

• 三角函数相关数学节点新增度数/弧度（Degrees/Radians）切换选项，避免手动换算；
• Modulo 节点新增 "Always Positive"（恒正）选项：使取模结果始终落在非负区间，解决负数取模的符号语义问题，简化循环动画、相位计算等场景。

这些改动让数学节点在日常参数化设计中更顺手。其余数学节点（加减乘除、指数、根、对数、正弦余弦等）均定义于 node-graph/nodes/math/src/lib.rs，类别覆盖Math: Arithmetic、Math: Trig、Math: Vec2等。

八、节点图 UI 与控制栏改版

• 节点图控制栏（Control bar）改版：新增若干按钮，重新组织了常用操作入口；
• 多个顶部输出线：同一图层堆栈现在可引出多条顶部输出线，一条堆栈的输出可同时送入多个下游节点，避免复制数据；
• 层叠面板样式改进：Layers 面板改进了折叠图层内选中子层的显示——即使所选子层被折叠隐藏，面板也能清晰指示选中项位于层级中的位置；
• 节点图视觉修复：修复了节点左侧边框在没有进入的线时出现的视觉缺口（cutout）。

对应 UI 组件可在 frontend/src/components 与 editor/src/messages/layout 中溯源。

九、绘制工具交互新特性

9.1 路径（Path）工具

• Space+ 拖拽手柄：拖动控制手柄的同时按Space，锚点会随之一起被拖动，便于整体移动某段曲线而不破坏其形状；
• Tab+ 拖拽手柄：拖动手柄时按Tab，切换到该锚点的对手柄（从一侧手柄跳到另一侧），方便对称编辑；
• Shift+Ctrl拖拽手柄：拖拽手柄时按住这两个修饰键，锁定手柄角度并吸附到 15° 增量，实现精确的斜线/正交控制；
• 点选语义：单击已填充形状时取消选中全部点，双击则全选所有点，简化整形状操作；
• 文档空间平移：点微调（nudge）在文档空间中工作（修复了视角倾斜时微调失效的问题）。

9.2 钢笔（Pen）工具

• 端点连接合并：新特性允许通过端点连接两个图层，使它们合并为单个图层——可用于将分段的开放路径首尾相接；
• Shift追加路径：默认 Pen 工具不再追加新路径，只有在按住Shift时才在现有图层上追加（修复了误追加问题）；
• 端点吸附：即使全局吸附关闭，Pen 工具也始终吸附到端点锚点，保证闭合路径时精准对齐。

9.3 徒手（Freehand）工具

• 在已有矢量图层上按住Shift可绘制新的子路径（subpath）并追加到该图层，便于在同一路径内添加多个笔画段。

9.4 文本（Text）工具

• 修复按Esc时清除文本的问题——现在 Esc 退出编辑而不丢失已输入内容；
• 文本图层的点击目标更宽容，更易选中已有文本图层；
• 修复退出文本交互编辑模式后文本图层被取消选中的问题。

9.5 选择（Select）工具

• 框选减法：按住修饰键（详见编辑器底部上下文提示）进行框选时，从当前选中集合中减去框内图层；
• 修复Shift框选无法扩展选择的问题。

9.6 画板（Artboard）工具

• 从顶部/左侧调整画板大小时，画板内容同步移动，使画布上的图形保持不动（避免改变画板边界导致内容错位）；
• 修复倾斜视角下的图层微调与画板工具的 nudge 缩放。

9.7 其他工具与界面

• 图层自动归位画板：绘制图层时，若绘制区域位于某画板内，该图层自动放入所绘制的画板中（#2110），不再需要手动拖入；
• 菜单栏新增Layer>New、Layer>Group Selected、Layer>Delete Selected：图层新建/分组/删除不再依赖快捷键或面板；
• 快速测量覆盖（Quick measurement overlays）重做：支持所有图层排列场景的测量提示；
• 无选中时禁用菜单项：没有图层选中时，相关菜单栏条目自动置灰，避免无效操作。

十、Q4 修复清单

本季度修复覆盖矢量、文本、渲染、UI、SVG 导出与崩溃问题，要点分类如下：

路径/矢量相关

• 布尔运算时开放子路径自动闭合；
• 双击锚点在平滑/尖锐之间切换失败的问题；
• Sample Points、Scatter Points、Splines from Points节点生成可见线段（而非仅不可见点）并支持子路径；
• Spline节点算法在起点/终点间连续（修复接缝）；
• 矢量相关节点多处 bug 修复；
• 共线手柄拖动时打破共线性（可脱离锚点移动）；
• 路径工具编辑经过类型转换中间层后的上游矢量路径。

渲染与视图

• 修复 Vello 渲染器下渐变变换错误；
• 修复图像图层包围盒错误（同时影响其图层缩略图）；
• 对齐吸附在按住Shift时不保持宽高比的问题；
• 修复视角倾斜时的图层微调、画板 nudge 缩放。

文本与 SVG

• 导出 SVG 的语法微调，兼容严格的 SVG 查看器；
• 文本工具 Esc 清空文本、文本图层误取消选中、点击目标过窄等问题。

节点图与 UI

• 打开节点图时视口工具不再在后台保持活动状态；
• 切换出 Select 工具时有时破坏选中图层的问题；
• 数字输入控件切换字段时单位符号不更新的问题；
• 编辑器偏好设置对话框一致性清理；
• 移除大部分遗留的 "coming soon" 占位元素；
• 菜单栏File>Close的快捷键标签恢复。

崩溃与稳定性

• 升级 3 个提交前的含Modulo节点文档时的崩溃；
• 变换框旋转取消后导致下一次变换状态损坏的问题；
• 选择历史相关问题、若干其他崩溃与 bug 的综合修复。

性能

• 字体目录加载推迟到文档创建时，加快编辑器启动速度。

十一、内部架构与依赖更新

本季度内部改动揭示了 Graphite 引擎演进方向：

• Math-Parser 库：新增 libraries/math-parser 用于读取与求值数学表达式，为Math节点提供解析/求值能力，含 parser.rs 与 ast.rs 等模块；
• 节点/参数描述解析系统：建立从 doc 注释解析节点与参数描述的系统，为后续更好的节点工具提示铺路；
• 类型系统修复：修复逆变（contravariance）检查的缺陷；
• Wasm 依赖更新：修复 Firefox 中因 WebGPU 规范变更导致 Vello 崩溃的问题；
• Bezier-rs 改进：简化交互式 web demo 代码、修复矩形构造函数产生线性段；
• RawKit 重构：多个 PR 重构 libraries/rawkit 相机 RAW 处理库；
• 上传纹理节点分辨率感知：Upload Texture节点按分辨率正确处理；
• 消息传递简化：编辑器架构内缓冲消息传递实现简化；
• 节点 ID 生成清理、吸附目标收集重构、Clippy 警告修复与常规依赖更新。

十二、网站与演示作品更新

• 发布 Q3 2024 进展报告（即本报告的前篇）；
• 首页轮播截图更新；
• 网站路线图及其他细节更新；
• 新增Changing Seasons演示作品（Q3 报告已介绍）与Parametric Dunescape演示作品，均可在 demo-artwork 目录找到对应.graphite源文件，其中包括 demo-artwork/changing-seasons.graphite 与 demo-artwork/parametric-dunescape.graphite。

结语

Graphite 的 Q4 2024 从"能跑"走向"好用"：子图合并打开了节点逻辑复用的新维度，Offset Path / Flatten / Bevel / Jitter Points / Switch / Clamp / Math等一批新节点补齐了矢量与数学操作的基本盘，文本行高字距、可固定属性分区、实例化组输出等改动显著改善了两大工作流的日常体验，而多达数十项的修复让工具交互更加可靠。对于希望深入源码的读者，node-graph/nodes/vector/src/vector_nodes.rs（矢量节点）、node-graph/nodes/math/src/lib.rs（数学节点）、node-graph/nodes/repeat/src/repeat_nodes.rs（实例化节点）与 libraries/math-parser（表达式引擎）是本季度变更最集中的代码入口。

【免费下载链接】GraphiteCommunity-built comprehensive 2D content creation appplication for graphic design, digital art, and interactive real-time motion graphics powered by a node-based procedural graphics engine项目地址: https://gitcode.com/GitHub_Trending/gr/Graphite