FullControl GCode Designer GCode生成核心算法深潜:GenerateModel函数拆解

原创2026-11-18 22:09:261,442 阅读

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 做"缝补":

  1. 从设定的初始坐标出发,逐条检查相邻命令之间是否有位移;
  2. 位移超过 0.001mm(L2929)就插入一条 Travel 线;
  3. 若开启自动回抽且移动距离超过阈值,则按"回抽 → Z-hop 抬起 → 移动 → 补料 → Z-hop 落下"五连击插入;
  4. 若工具号变化,插入 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 一节):

建议阅读顺序:先跑一遍 GenerateModel 主流程 → 挑一种最熟悉的特征(如 Rectangle)顺藤摸瓜到 AddLine → 再回头看 Repeat rule 与特征树匹配,基本就能吃透整个引擎。

小结

GenerateModel 函数用最朴素的 VBA 数组 + if 分发,实现了一个"表格驱动的 GCode 编译器":公式定义几何、规则驱动重复、特征树追踪血缘、自动缝补移动。它证明了 GCode 生成不一定需要复杂的几何内核——对新手而言,这也正是最适合学习"从设计参数到机器代码"全链路的一条最短路径。想要亲手试试,下载 FullControl_GCODE_Designer_Heron02d.xlsm 并启用宏即可,配合 ParametricDesignDemos/ 里的参数化花瓶与波纹面演示文件,边改参数边看 Printpath 变化,收获最快 ✨。

登录后查看全文
FullControl-GCode-Designer