FullControl GCode Designer GCode生成核心算法深潜:GenerateModel函数拆解
FullControl GCode Designer GCode生成核心算法深潜:GenerateModel函数拆解
FullControl GCode Designer 是一款基于 Excel + VBA 的开源 GCode 生成器,让 3D 打印、激光切割等用户无需切片软件,就能通过表格"参数化设计"直接生成 GCode。本文带你深潜它的核心算法:.vba/GenerateModel.bas 中长达 3500 多行的 GenerateModel 函数,拆解它如何把一张 Excel 表格变成一整段可执行的机器代码 🧵。
先看懂全貌:没有渲染引擎的"切片器"
传统切片软件靠网格体素去计算填充,而 FullControl 的思路完全不同:它不建模,只"排线"。
- 用户在 FullControl_GCODE_Designer_Heron02d.xlsm 的
Main Sheet表格里逐行写下"特征"(Line、Rectangle、Circle/arc、Cartesian repeat……); - 每行就是一个指令,支持用公式(Excel 计算)驱动参数;
- 点击生成后,VBA 把表格解释成一条条移动线段,再补上抬刀、回抽、换刀,最后拼出 GCode 文本。
整个引擎就住在 GenerateModel.bas 里(Sub GenerateModel 入口)。理解它,只需抓住下面这张"流水线":
读取表格 → 特征预处理(复制/展开) → 逐特征生成命令 → 自动补 Travel/换刀 → 转 GCode 文本 → 写入工作表
第一步:数据摄入——表格变成二维数组
进入函数后,前 100 行都在做"读数据"。核心动作有三个:
1️⃣ 把特征表读进内存
程序选中 Main Sheet 从 B8 单元格 往下取数,一次读入 14 列(iInputCols = 14),存进 arrFeatures 数组。每行一个特征,第一列是特征名。遇到第一个空行就停止——这正是"允许用 Excel 公式控制特征是否启用"的关键:公式返回空字符串时,该特征自动被跳过。
2️⃣ 读取全局设置
打印/移动速度、起始坐标、回抽参数等,全部来自 T 列固定单元格,例如:
| 单元格 | 参数 |
|---|---|
| T9 | Z 偏移 |
| T16/T17 | 打印速度 / 移动速度 |
| T19/T20 | 耗材直径 / 挤出单位(mm 或 mm³) |
| T27~T34 | 自动回抽阈值、Z-hop 等 |
3️⃣ 按 ID 查找 Start/End/ToolChange GCode
程序横向扫描 StartGCODE、EndGCODE、ToolGCODE 三张工作表,按用户指定的 ID 找到对应的一组宏指令(如开机预热、关断料),缓存起来备用。
💡 细节亮点:函数开头有一段"兼容性检查",能识别旧版本设计文件的格式(比如旧的 E/F 写法),弹出提示引导用户修正——开源项目对用户习惯的照顾很到位。
第二步:预处理——"复制再重算"先于一切
主循环开始前,有两个"展开"阶段(见 L464-L624):
- Reproduce and recalculate(复制并重算):把用户指定的特征整体"复印" N 份,每份按 X/Y/Z 位移量偏移坐标,且引用关系会同步重编号。复制的坐标运算细节放在独立模块 ReproduceFeature.bas 里,保持主函数可读性;
- Repeat rule(重复规则)收集:所有"重复规则"先被扫描进
arrRepeatRules数组(L696-L711),主循环真正执行到重复类特征时再回来查表应用——支持固定偏移、逐层递增、分级递增、甚至用数学表达式计算偏移(OffsetLinearMaths)。
这一步是"参数化"的精髓:几行规则就能让一个截面逐层螺旋放大,做出花瓶、螺旋面这类结构,而不必手写几百层坐标。
第三步:核心主循环——13 种特征的"if-elseif 流水线"
从 L728 开始,For i = 1 To iNumberOfFeatures 逐行处理特征。每个特征先经过 ConvertRelativeToAbsoluteCoordintes:坐标以字母 R 开头表示相对上一段终点(如 R10 表示"相对原点 X+10"),否则视为绝对坐标——这个约定让连续画线非常顺手。
然后是长达上千行的 If/ElseIf 分发,支持的特征类型一览:
| 特征类型 | 代码位置 | 作用 |
|---|---|---|
| Line(Cartesian / Polar) | L744 | 直线段,支持极坐标描述 |
| Retraction | L812 | 手动回抽 + Z-hop |
| Custom GCODE | L836 | 插入任意原始 GCode |
| Rectangle | L852 | 矩形 = 4 条线,自动判断顺/逆时针 |
| Circle/arc、Polygon | L901 | 用旋转矩阵把圆弧离散成直线段 |
| Line equation | L992 | 用数学公式驱动 X/Y/Z,逐段求值 |
| Line equation polar | L1129 | 极坐标版公式驱动(角度/半径方程) |
| Cartesian / Polar repeat | L1291 | 平移/旋转复制已生成命令 |
| Reflect | L1731 | 沿任意直线镜像(含解析几何求解) |
| Concentric repeat | L1873 | 矩形同心收缩/扩张 |
| Postprocess | L1970 | 对已生成命令批量偏移/改参数 |
其中最能体现"FullControl"理念的,是 Line equation 系列:X/Y/Z 不再是数字,而是公式字符串。程序把 Tval(参数 t)、Zval 等占位符替换为当前数值后,交给 Evaluate 求值(L1041-L1063)。也就是说,一条螺旋线、一条波浪线,都可以用一个参数方程定义——这正是仓库 ParametricDesignDemos/ 里"RippleRamen""ParametricVase"等演示文件能玩出花样来的原因。
关键数据结构:arrCommands 命令矩阵
所有特征最终都写入同一个二维数组 arrCommands,它的"列号常量"定义在 L240-L262:第 1 列是命令类型(Print/Travel),第 2~12 列依次是起止 X/Y/Z、线宽、线高、E 挤出量、F 速度、工具号,第 14~17 列是特征 ID、特征树路径、备注和最终 GCode 文本。
每个特征生成线段时调用 AddLine,它做了两件小事:
- 自动计算 E 值:若用户没手动指定,挤出量 = 线段长度 × 线宽 × 线高,再按耗材直径换算(L2461-L2462);
- 维护特征树
IDtree:例如"特征 3 的第 2 次重复中的特征 5"会记成3.2-5,后面的 Postprocess 和 Repeat rule 就靠这棵"谱系树"精准选中要修改的命令(匹配逻辑在 CheckIfCurrentCommandSatisfiesInclusionCriteria,支持2-5区间、Y/N包含排除语法)。
数组按 10000 行一块扩容(IncreaseArrCommandsSizeIfRequired),并设定约 100 万行 GCode 的上限——Excel 内存的实用主义边界。
第四步:自动补 Travel、回抽与换刀
主循环结束后,程序调用 AddTravelAndToolChangeCommandsToWholeArray 做"缝补":
- 从设定的初始坐标出发,逐条检查相邻命令之间是否有位移;
- 位移超过 0.001mm(L2929)就插入一条 Travel 线;
- 若开启自动回抽且移动距离超过阈值,则按"回抽 → Z-hop 抬起 → 移动 → 补料 → Z-hop 落下"五连击插入;
- 若工具号变化,插入
ToolGCODE表里预设的换刀宏,并把当前位置重置为原点,确保新喷头一定先走一条定位 Travel。
注意这些自动插入的命令 cID = 0,天然不会被重复/镜像规则选中——一个很聪明的防误伤设计。
第五步:GenerateGCODE——从数据到文本
最后一步 GenerateGCODE 把命令矩阵"翻译"成文本:
Print→G1,Travel→G0;- 速度去重:与上一行相同速度就不重复写
F,省文件体积(L3121-L3124);X/Y/Z 同理,只写变化的轴; - 首层加成:Z=0 的段自动乘以"第一层挤出/速度倍率"(L3076-L3085),对应切片软件的首层调参习惯;
- 回抽输出为
G1 F... E...,Z-hop 输出为G0 F... Z...。
生成的结果有三处出口:完整打印路径写进 Printpath 表(可直接可视化检查),GCode 拼上首尾宏后写入 GCODE 表并复制到剪贴板(L2353-L2396),弹窗还会汇报总耗时和总行数。
如何上手阅读这套源码
仓库为了开源审查,用 git hooks 把 .xlsm 里的 VBA 全部导出为纯文本(见 README.md 的 Contributing 一节):
- 📦 核心引擎:.vba/GenerateModel.bas —— 3569 行,含所有特征逻辑与几何工具(旋转、径向位移、镜像求解)
- 🔁 复制特征辅助:.vba/ReproduceFeature.bas
- ➕ 特征插入 UI:.vba/AddFeature.bas(特征类型清单其实来自表格
FeatParams的 B2:B42) - 📝 参数命名:.vba/Parameters.bas
- 📄 原理论文:FullControl GCode Designer - Author Version.pdf
- 🕘 版本演进:Changelog
建议阅读顺序:先跑一遍 GenerateModel 主流程 → 挑一种最熟悉的特征(如 Rectangle)顺藤摸瓜到 AddLine → 再回头看 Repeat rule 与特征树匹配,基本就能吃透整个引擎。
小结
GenerateModel 函数用最朴素的 VBA 数组 + if 分发,实现了一个"表格驱动的 GCode 编译器":公式定义几何、规则驱动重复、特征树追踪血缘、自动缝补移动。它证明了 GCode 生成不一定需要复杂的几何内核——对新手而言,这也正是最适合学习"从设计参数到机器代码"全链路的一条最短路径。想要亲手试试,下载 FullControl_GCODE_Designer_Heron02d.xlsm 并启用宏即可,配合 ParametricDesignDemos/ 里的参数化花瓶与波纹面演示文件,边改参数边看 Printpath 变化,收获最快 ✨。