ChromaPrint3D 可以把图片转换成多色 3D 打印可用的 3MF 模型。
支持 Bambu Studio 预设参数自动写入（覆盖全部 13 款 BBL 机型：P2S/P1P/P1S/X1C/X1/X1E/A1/A1 mini/H2D/H2D Pro/H2C/H2S/X2D，每机型 × 0.2mm/0.4mm 喷嘴 × 观赏面朝上/朝下），3MF 含同拓扑同 nozzle 的跨机型兼容群，BambuStudio 切换机型时可保留切片参数；自动将模型颜色匹配到最接近的耗材丝槽位。
如果你只是想先体验效果，不需要先读一堆文档，直接从下面三种方式里选一种就行。
- 图片 / SVG → 多色 3MF，13 款 BBL 机型 × 0.2/0.4mm 喷嘴 × 观赏面朝上/朝下的 Bambu Studio 预设自动注入
- 模型颜色自动匹配到耗材丝槽位（RGB 欧氏距离）
- 深度学习抠图（ONNX Runtime 推理）
- 矢量化处理：抗锯齿检测、边缘感知 SLIC 分割、逐像素标签细化
- 交互式配方编辑器：逐色重选、实时预览
- 校准板生成 + 拍照构建 ColorDB（支持 4/8 色板工作流）
- 高级几何控制：底板层数（
base_layers）、双面打印（double_sided）、透明镀层（transparent_layer_mm，FaceDown 专属） - 运维公告系统：双语 banner、HTTPS 写入、token 鉴权
打开 ChromaPrint3D。
这个站点会和最新 Release 的功能保持同步，最适合第一次体验。
前往 Releases 页面下载对应平台安装包：
https://github.com/neroued/ChromaPrint3D/releases
docker run -d -p 8080:8080 --name chromaprint3d neroued/chromaprint3d:latest启动后访问 http://localhost:8080。
镜像标签：
latest（一体，开箱即用）、api（仅 API，分体部署）、preview/preview-api（预览版，发布前测试）。
分体部署与预览版双轨部署详见 docs/deployment.md。
| 命令 | 说明 |
|---|---|
raster_to_3mf |
图像转多色 3MF 模型 |
gen_calibration_board |
生成校准板 3MF |
build_colordb |
从校准板照片构建 ColorDB |
完整可执行文件列表（含
gen_stage、svg_to_3mf等）见 docs/build.md。
矢量化 CLI 工具（raster_to_svg、evaluate_svg）已迁移至独立库 neroued_vectorizer。
- 构建与打包：docs/build.md
- 本地开发与调试：docs/development.md
- 发布流程：docs/development.md#8-发布流程
- 部署：docs/deployment.md
- 运维公告（升级预告/维护通知）：docs/deployment.md#公告系统announcements
- 协作导航：AGENTS.md
- 模块索引：docs/agents/README.md
- 任务手册：docs/agents/tasks/README.md
ChromaPrint3D 构建在众多优秀开源项目之上，特别感谢：
- C++ 核心 / 算法：OpenCV、spdlog、Clipper2、lunasvg、nlohmann/json、earcut.hpp、ONNX Runtime、jemalloc、Little CMS
- Web 后端：Drogon
- Web 前端：Vue、Naive UI、Pinia、Vue I18n、Chart.js、Vite
- 桌面壳：Electron
- Python 建模：NumPy、SciPy、OpenCV、msgpack、matplotlib
- 运行时系统依赖：Potrace（通过 neroued_vectorizer）
本项目采用 Apache License 2.0，完整文本见 LICENSE。
欢迎通过 Issue / Pull Request 参与。提交前请阅读 AGENTS.md 与 Git 分支与 PR 规范。
ChromaPrint3D turns images into multi-color 3MF models for 3D printing.
It supports automatic Bambu Studio preset injection across all 13 BBL machines (P2S/P1P/P1S/X1C/X1/X1E/A1/A1 mini/H2D/H2D Pro/H2C/H2S/X2D) at 0.2mm/0.4mm nozzles × face-up/face-down, with cross-machine compatibility groups so BambuStudio retains slicer parameters when switching printers, and auto-matches model colors to the closest filament slot.
If you only want a quick hands-on try, pick one of the options below.
- Image / SVG to multi-color 3MF with auto-injected Bambu Studio presets (13 BBL machines × 0.2/0.4mm nozzles × face-up/face-down)
- Auto-match model colors to filament slots (RGB Euclidean distance)
- Deep-learning matting (ONNX Runtime inference)
- Vectorization: anti-aliasing detection, edge-aware SLIC, per-pixel label refinement
- Interactive recipe editor: per-color replacement with live preview
- Calibration board generation + photo-based ColorDB build (4/8-color workflows)
- Advanced geometry controls: base layers (
base_layers), double-sided printing (double_sided), transparent coating (transparent_layer_mm, FaceDown only) - Announcement system: bilingual banner, HTTPS-only writes, token-gated mutations
Open ChromaPrint3D.
The hosted site tracks the latest Release feature set.
Get the installer for your platform from Releases:
https://github.com/neroued/ChromaPrint3D/releases
docker run -d -p 8080:8080 --name chromaprint3d neroued/chromaprint3d:latestThen open http://localhost:8080.
Image tags:
latest(all-in-one),api(API only, split deployment),preview/preview-api(pre-release testing).
See docs/deployment.md for split deployment and preview dual-track deployment details.
| Command | Description |
|---|---|
raster_to_3mf |
Convert image to multi-color 3MF model |
gen_calibration_board |
Generate calibration board 3MF |
build_colordb |
Build ColorDB from calibration photo |
Full list of executables (including
gen_stage,svg_to_3mf, etc.) is in docs/build.md.
Vectorization CLI tools (raster_to_svg, evaluate_svg) have been migrated to the standalone library neroued_vectorizer.
- Build and packaging: docs/build.md
- Local development and debugging: docs/development.md
- Release workflow: docs/development.md#8-发布流程
- Deployment: docs/deployment.md
- Operations announcements (upgrade notices / maintenance banners): docs/deployment.md#公告系统announcements
- Collaboration guide: AGENTS.md
- Module indexes: docs/agents/README.md
- Task playbooks: docs/agents/tasks/README.md
ChromaPrint3D builds on many excellent open-source projects. Special thanks to:
- C++ core / algorithms: OpenCV, spdlog, Clipper2, lunasvg, nlohmann/json, earcut.hpp, ONNX Runtime, jemalloc, Little CMS
- Web backend: Drogon
- Web frontend: Vue, Naive UI, Pinia, Vue I18n, Chart.js, Vite
- Desktop shell: Electron
- Python modeling: NumPy, SciPy, OpenCV, msgpack, matplotlib
- Runtime system dependency: Potrace (via neroued_vectorizer)
This project is licensed under the Apache License 2.0. See LICENSE for the full text.
Issues and pull requests are welcome. Please read AGENTS.md and the Git branch & PR policy before submitting.