拼豆图纸生成器

一个简单易用的工具，将 MagicaVoxel .vox 体素模型导出为拼豆堆叠图纸。只需打开文件，点击保存，就能获得包含所有分层切片和 3D 预览的完整图纸！

---

🚀 快速开始

第一步：打开工具

直接双击 index.html 文件即可在浏览器中打开（无需安装任何软件）。

第二步：打开模型

点击左侧的 📁 打开本地 .vox 文件 按钮，选择你的 .vox 模型文件。

第三步：导出图纸

1. 确认 分层模式 已开启（默认开启）
2. 点击右侧的 💾 保存拼豆图纸 按钮
3. 图纸会自动下载为 PNG 图片

---

📸 图纸说明

导出的图纸包含以下内容：

部分	说明
左侧区域	所有层的切片网格，每层标注层号
右侧区域	3D 模型预览图，展示拼好后的效果
坐标数字	每个格子显示坐标 (x,y)，方便定位
网格线	清晰的像素边界，方便对照

---

🎮 操作指南

旋转模型

• 电脑：鼠标左键拖动
• 手机/平板：单指拖动

缩放模型

• 电脑：鼠标滚轮
• 手机/平板：双指捏合/张开

分层查看

• 点击 下一层：从下往上逐层叠加
• 点击 上一层：从上往下逐层减少
• 点击 重置：回到第一层
• 层数显示：层数: X/Y（当前层/总层数）

显示网格

• 开启 显示网格 可以看到每个像素的边界线

---

💡 小提示

1. 白色像素：图纸中的白色像素会以纯白色显示，方便识别
2. 空位置：没有体素的位置显示为浅灰色，且不显示坐标
3. 图纸尺寸：根据模型大小自动生成，确保清晰度
4. 直接打开：无需安装任何软件，双击 index.html 即可使用

---

🛠️ 高级功能（可选）

使用 HTTP 服务器

如果需要通过网络访问，可以启动 HTTP 服务器：

# Python 用户
python -m http.server

# Node.js 用户
npx serve

然后访问 http://localhost:8000

仅显示外表面

默认开启，会自动简化模型内部，只保留外部可见的体素，减少拼豆数量同时保持外观不变。

---

❓ 常见问题

Q: 为什么双击打开后看不到模型？

A: 请点击左侧的 📁 打开本地 .vox 文件 按钮选择你的模型文件。

Q: 导出的图片在哪里？

A: 图片会自动下载到你的下载文件夹，文件名为 模型名_layers.png。

Q: 支持哪些文件格式？

A: 目前只支持 MagicaVoxel 的 .vox 格式。

Q: 可以在手机上使用吗？

A: 可以！工具支持手机和平板，自动适配触摸操作。

---

📄 文件说明

voxelView/
├── index.html          # 电脑版界面（双击打开）
├── mobile.html         # 手机版界面（自动跳转）
├── js/
│   ├── main.js         # 主程序
│   ├── vox-parser.js   # 文件解析器
│   └── models-catalog.js # 模型列表（已隐藏）
└── models/             # 模型文件存放处（可选）

---

👨‍🏫 关于

由像素熊老师开发，专为拼豆爱好者设计。

© 2025 像素熊老师