Inkscape Unicorn G-Code 输出扩展教程
项目介绍
Inkscape Unicorn 是一个专为 MakerBot Unicorn 笔式绘图仪设计的 Inkscape 扩展,能够将矢量图形转换为适用于 CNC 机器的 G-Code 文件。该扩展最初由 Marty McGuire 开发,现已开源供用户自由使用和修改。
核心功能
- 矢量转G-Code:将Inkscape中的矢量图形转换为G-Code指令
- 多平台支持:兼容Windows、Linux和macOS操作系统
- 参数化配置:支持自定义画笔角度、延迟时间、进给速率等参数
快速安装指南
获取项目文件
git clone https://gitcode.com/gh_mirrors/in/inkscape-unicorn
安装到Inkscape
将 src/ 目录中的所有文件复制到Inkscape的扩展目录:
- Windows系统:
C:\Program Files\Inkscape\share\extensions - Linux系统:
/usr/share/inkscape/extensions - macOS系统:
/Applications/Inkscape.app/Contents/Resources/extensions
使用教程
准备工作
在开始使用扩展前,请确保你的图形已正确设置:
- 绘图平台尺寸为100mm x 100mm(适用于CupCake CNC)
- 在Inkscape中将单位设置为mm以便精确控制尺寸
- 扩展会自动尝试将所有内容居中对齐
文本处理
所有文本对象必须转换为路径:
- 选择所有文本对象
- 选择菜单 Path | Object to Path
保存G-Code文件
- 选择 File | Save a Copy
- 在文件类型中选择 MakerBot Unicorn G-Code (*.gcode)
- 保存文件
预览和打印
- 预览工具:推荐使用Pleasant3D来预览生成的G-Code文件
- 打印流程:
- 在ReplicatorG中打开
.gcode文件 - 设置Unicorn和画笔
- 居中构建平台
- 点击 Build 按钮开始绘图
- 在ReplicatorG中打开
参数配置详解
绘图仪设置
扩展提供丰富的参数配置选项,包括:
- 画笔抬起角度:默认50.0度
- 画笔落下角度:默认30.0度
- 延迟时间:画笔动作前后的等待时间
- 进给速率:XY轴和Z轴的移动速度
画笔注册检查
该功能在绘图开始时添加快速的画笔下/上动作,用于检查画笔是否接触到纸张。ReplicatorG会暂停并询问注册是否成功,如果选择"否",将中止绘图以便重新开始。
起始位置设置
根据你的平台设置起始位置:
- X=0, Y=0:如果平台在画笔下居中开始
- X=50, Y=50:如果平台在Cupcake CNC的前左角开始
技术架构
核心模块
项目采用模块化设计,主要包含以下核心文件:
- unicorn.py:主程序文件,处理Inkscape扩展接口
- unicorn.inx:Inkscape扩展配置文件
- context.py:G-Code上下文管理,负责生成G-Code指令
- svg_parser.py:SVG解析器,处理Inkscape文档结构
- entities.py:实体定义,管理图形元素
G-Code生成流程
- 解析SVG文档结构
- 提取图形实体信息
- 根据配置参数生成G-Code指令
- 输出完整的G-Code文件
注意事项
兼容性说明
重要提醒:此扩展不再受支持或维护。最后测试的Inkscape版本是0.48.5。请根据自己的需求自由分叉和改进此扩展。
使用风险
警告:将此扩展生成的G-Code用于除带有Unicorn笔式绘图仪附件的MakerBot CupCake CNC之外的机器的用户需自行承担风险。
最佳实践
图形优化技巧
- 精简路径节点以提高绘图效率
- 使用曲线近似而非直接路径转换
- 合理设置绘图顺序,减少不必要的移动
效率提升建议
- 批量处理多个设计文件
- 利用预设模板快速开始新项目
- 定期预览G-Code确保路径符合预期
通过本教程,你可以快速掌握Inkscape Unicorn扩展的使用方法,将你的创意从数字世界带入物理现实。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



