如何为keygen新增一种钥匙类型从Inkscape描摹SVG到3D建模全流程【免费下载链接】keygenOpenSCAD tools for generating physical keys项目地址: https://gitcode.com/gh_mirrors/ke/keygenkeygen 是一款基于 OpenSCAD 的开源工具能根据钥匙编码bitting和轮廓参数自动生成可 3D 打印的物理钥匙模型。内置钥匙类型有限而本文正是官方贡献指南的完整解读教你如何为 keygen 新增一种钥匙类型——从 Inkscape 描摹 SVG到用 OpenSCAD 建模再到让网页前端识别新钥匙全程只需 6 步。 先看懂 keygen 的工作链路在动手之前先明白数据是怎么流动的这样每一步你都知道自己在哪一站阶段你做什么产出文件所在目录1. 描摹Inkscape 中描出钥匙轮廓、齿槽、刻字*.svgresources/2. 转换运行make自动把路径转为多边形数据*.gen.scadscad/3. 建模参照模板编写钥匙的.scad模块*.scadscad/4. 注册在 Makefile 中登记新文件—根目录5. 发布make生成钥匙数据库供网页使用keys.jsonbuild/两个关键文件值得先翻一遍官方建模指南doc/how_to_model_keys.md核心公共模块提供key_blank、key_bitting等函数scad/keygen.scad 第 1 步获取钥匙素材——侧面照 齿尖照你需要两张清晰的钥匙照片侧面照side决定钥匙整体轮廓、钥匙柄bow形状和刻字齿尖照tip决定齿槽warding形状也就是钥匙插入锁芯后被磨削出的截面轮廓。 两个实用技巧推荐用平板扫描仪拍摄透视变形最小如果能找到锁具制造商发布的钥匙剖面 PDF直接取矢量轮廓只需清理路径工作量大幅降低。✏️ 第 2 步在 Inkscape 中描摹并命名路径把照片导入 Inkscape依次描摹三部分内容钥匙轮廓outline——整把钥匙的外边界包括柄部齿槽截面warding——钥匙齿尖的侧面截面形状刻字engraving——柄部上的凹槽文字可省略。描摹完成后为每条路径改名是最关键的一步选中一条路径按Control-Shift-O打开路径属性输入有语义的名字例如outline、warding、engraving。这个名称会原样写入后续生成的 OpenSCAD 变量名中形如路径名_points、路径名_pathsbin/paths2openscad.py 正是靠它建立 SVG 路径与代码变量的对应关系。名字起得清楚后面建模会轻松很多。最后把文件保存为SVG放入resources/目录可参考现有的 resources/kwikset.svg。⚙️ 第 3 步运行 make把 SVG 路径变成多边形数据在仓库根目录执行makeMakefile 会扫描resources/下的所有 SVG调用 bin/paths2openscad.py 把每条路径转换为一组多边形坐标点输出到scad/下的*.gen.scad文件如 scad/kwikset.gen.scad。生成的文件长这样——每条命名路径对应两个变量// Automatically generated using the Inkscape to OpenSCAD Converter warding_kw1_points [[28.2, -1.3], ...]; warding_kw1_paths [[0, 1, 2, ...]]; outline_points ...;⚠️ 注意路径必须是闭合多边形才能正确转换。如果文字路径转换不理想可在 Inkscape 中用路径 → 合并路径把文字合并为单一路径。 第 4 步查询钥匙的机械参数描摹只解决了形状还需要查清几个数字参数可在网络上查阅对应钥匙体系资料锁芯直径plug diameter决定钥匙柄部厚度方向的圆弧切削位置cut locations每个齿距的纵向间距切削深度表depth table编码 0–9 各自对应的切割深度。 第 5 步编写钥匙的 .scad 模块以 scad/kwikset.scad 为模板新建自己的.scad文件。它包含四个固定要素use keygen.scad include your_key.gen.scad module your_key(...) { name 你的钥匙名称; /* 描述bitting 的书写规则与示例 */ // 1. 用 key_lkup 按名字取出 outline / warding 变量 // 2. 定义 cut_locations切削位置与 depth_table深度表 // 3. heights key_code_to_heights(bitting, depth_table); // 4. difference() { key_blank(...); key_bitting(...); } } // 这些默认值会被命令行 -D 参数覆盖 bitting default-bitting; outline default-outline; warding default-warding; your_key(...);三个核心函数各司其职定义均见 scad/keygen.scadkey_code_to_heights把字符串编码逐位映射成切割高度key_blank由轮廓 齿槽截面挤出钥匙坯料并处理刻字key_bitting按位置和高度切出一个个齿槽。文件末尾必须保留bitting/outline/warding三个默认值变量和模块调用语句——解析器 bin/parse.py 依赖这个固定结构来提取钥匙元信息。 第 6 步注册到 Makefile 并验证打开根目录的 Makefile把新文件追加进SCAD_SRC变量当前登记了 schlage_classic、kwikset、best 等 7 种钥匙SCAD_SRC $(SCAD_DIR)/schlage_classic.scad \ $(SCAD_DIR)/kwikset.scad \ ... $(SCAD_DIR)/your_key.scad再次运行makebin/parse.py 会解析你的模块与其余钥匙合并生成build/keys.json。之后启动 bin/serve.py 并提供 web/ 前端网页下拉框里就会出现你的新钥匙输入 bitting 即可在线预览 3D 模型——至此新钥匙类型正式上架。✅ 流程速查清单步骤检查项描摹轮廓、齿槽两条路径已闭合并命名SVG已保存到resources/且路径名有意义makescad/*.gen.scad已生成变量名与 SVG 路径一致参数plug diameter、cut locations、depth table 已查证模块末尾含 bitting/outline/warding 默认值与模块调用MakefileSCAD_SRC已登记build/keys.json中出现新钥匙完成以上 6 步你就为 keygen 贡献了一种全新的钥匙类型。整个过程最耗时的通常是 Inkscape 描摹——如果找到制造商的矢量 PDF体验会好很多。祝打印顺利 【免费下载链接】keygenOpenSCAD tools for generating physical keys项目地址: https://gitcode.com/gh_mirrors/ke/keygen创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
如何为keygen新增一种钥匙类型从Inkscape描摹SVG到3D建模全流程【免费下载链接】keygenOpenSCAD tools for generating physical keys项目地址: https://gitcode.com/gh_mirrors/ke/keygenkeygen 是一款基于 OpenSCAD 的开源工具能根据钥匙编码bitting和轮廓参数自动生成可 3D 打印的物理钥匙模型。内置钥匙类型有限而本文正是官方贡献指南的完整解读教你如何为 keygen 新增一种钥匙类型——从 Inkscape 描摹 SVG到用 OpenSCAD 建模再到让网页前端识别新钥匙全程只需 6 步。 先看懂 keygen 的工作链路在动手之前先明白数据是怎么流动的这样每一步你都知道自己在哪一站阶段你做什么产出文件所在目录1. 描摹Inkscape 中描出钥匙轮廓、齿槽、刻字*.svgresources/2. 转换运行make自动把路径转为多边形数据*.gen.scadscad/3. 建模参照模板编写钥匙的.scad模块*.scadscad/4. 注册在 Makefile 中登记新文件—根目录5. 发布make生成钥匙数据库供网页使用keys.jsonbuild/两个关键文件值得先翻一遍官方建模指南doc/how_to_model_keys.md核心公共模块提供key_blank、key_bitting等函数scad/keygen.scad 第 1 步获取钥匙素材——侧面照 齿尖照你需要两张清晰的钥匙照片侧面照side决定钥匙整体轮廓、钥匙柄bow形状和刻字齿尖照tip决定齿槽warding形状也就是钥匙插入锁芯后被磨削出的截面轮廓。 两个实用技巧推荐用平板扫描仪拍摄透视变形最小如果能找到锁具制造商发布的钥匙剖面 PDF直接取矢量轮廓只需清理路径工作量大幅降低。✏️ 第 2 步在 Inkscape 中描摹并命名路径把照片导入 Inkscape依次描摹三部分内容钥匙轮廓outline——整把钥匙的外边界包括柄部齿槽截面warding——钥匙齿尖的侧面截面形状刻字engraving——柄部上的凹槽文字可省略。描摹完成后为每条路径改名是最关键的一步选中一条路径按Control-Shift-O打开路径属性输入有语义的名字例如outline、warding、engraving。这个名称会原样写入后续生成的 OpenSCAD 变量名中形如路径名_points、路径名_pathsbin/paths2openscad.py 正是靠它建立 SVG 路径与代码变量的对应关系。名字起得清楚后面建模会轻松很多。最后把文件保存为SVG放入resources/目录可参考现有的 resources/kwikset.svg。⚙️ 第 3 步运行 make把 SVG 路径变成多边形数据在仓库根目录执行makeMakefile 会扫描resources/下的所有 SVG调用 bin/paths2openscad.py 把每条路径转换为一组多边形坐标点输出到scad/下的*.gen.scad文件如 scad/kwikset.gen.scad。生成的文件长这样——每条命名路径对应两个变量// Automatically generated using the Inkscape to OpenSCAD Converter warding_kw1_points [[28.2, -1.3], ...]; warding_kw1_paths [[0, 1, 2, ...]]; outline_points ...;⚠️ 注意路径必须是闭合多边形才能正确转换。如果文字路径转换不理想可在 Inkscape 中用路径 → 合并路径把文字合并为单一路径。 第 4 步查询钥匙的机械参数描摹只解决了形状还需要查清几个数字参数可在网络上查阅对应钥匙体系资料锁芯直径plug diameter决定钥匙柄部厚度方向的圆弧切削位置cut locations每个齿距的纵向间距切削深度表depth table编码 0–9 各自对应的切割深度。 第 5 步编写钥匙的 .scad 模块以 scad/kwikset.scad 为模板新建自己的.scad文件。它包含四个固定要素use keygen.scad include your_key.gen.scad module your_key(...) { name 你的钥匙名称; /* 描述bitting 的书写规则与示例 */ // 1. 用 key_lkup 按名字取出 outline / warding 变量 // 2. 定义 cut_locations切削位置与 depth_table深度表 // 3. heights key_code_to_heights(bitting, depth_table); // 4. difference() { key_blank(...); key_bitting(...); } } // 这些默认值会被命令行 -D 参数覆盖 bitting default-bitting; outline default-outline; warding default-warding; your_key(...);三个核心函数各司其职定义均见 scad/keygen.scadkey_code_to_heights把字符串编码逐位映射成切割高度key_blank由轮廓 齿槽截面挤出钥匙坯料并处理刻字key_bitting按位置和高度切出一个个齿槽。文件末尾必须保留bitting/outline/warding三个默认值变量和模块调用语句——解析器 bin/parse.py 依赖这个固定结构来提取钥匙元信息。 第 6 步注册到 Makefile 并验证打开根目录的 Makefile把新文件追加进SCAD_SRC变量当前登记了 schlage_classic、kwikset、best 等 7 种钥匙SCAD_SRC $(SCAD_DIR)/schlage_classic.scad \ $(SCAD_DIR)/kwikset.scad \ ... $(SCAD_DIR)/your_key.scad再次运行makebin/parse.py 会解析你的模块与其余钥匙合并生成build/keys.json。之后启动 bin/serve.py 并提供 web/ 前端网页下拉框里就会出现你的新钥匙输入 bitting 即可在线预览 3D 模型——至此新钥匙类型正式上架。✅ 流程速查清单步骤检查项描摹轮廓、齿槽两条路径已闭合并命名SVG已保存到resources/且路径名有意义makescad/*.gen.scad已生成变量名与 SVG 路径一致参数plug diameter、cut locations、depth table 已查证模块末尾含 bitting/outline/warding 默认值与模块调用MakefileSCAD_SRC已登记build/keys.json中出现新钥匙完成以上 6 步你就为 keygen 贡献了一种全新的钥匙类型。整个过程最耗时的通常是 Inkscape 描摹——如果找到制造商的矢量 PDF体验会好很多。祝打印顺利 【免费下载链接】keygenOpenSCAD tools for generating physical keys项目地址: https://gitcode.com/gh_mirrors/ke/keygen创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
