Repository navigation
Description
What
Add a self-registering '3d convert IN... OUT' command: 1 or N inputs, format inferred from extension (inputs scad/stl/3mf/usdz/obj; outputs stl/3mf/usdz/png), extensionless output names filled from the detected format. scad→3mf is multicolor-aware: color() groups become one object per color in a true Orca/Bambu project 3MF assembled via lib/orca_project_3mf.py, each object carrying per-object extruder metadata. 3mf→3mf accepts the retarget options (--to/--set/--preset/...) delegated to slicing/retarget_3mf.py. Collision policy: same-extension output that would overwrite an input auto-appends a suffix; an existing target fails (exit 2) with the exact ready-to-run command using a free name unless --force; existence re-checked at write time.
Why (motivation)
Converting between model formats today means hand-assembling 3d export (single object, single color), 3d usdz, 3d import wrappers and 3d retarget; nothing turns a colored OpenSCAD assembly into a true multicolor Orca project 3MF even though all pieces exist (orca_project_3mf per-object extruder metadata, OpenSCAD's per-triangle color() 3MF export read by dimension_model). Related: #89
User impact
Makers and agents can go from a colored scad to a slicer-ready multicolor project, or between mesh formats, with one command instead of a hand-rolled pipeline per pair.
Cost of inaction
Every multicolor print keeps needing manual per-color STL exports and hand-assembly in the slicer; format juggling stays a multi-command, error-prone ritual.
Acceptance criteria
- 3d convert model.scad out.3mf on a colored scad produces an Orca project 3MF with one object per color group and per-object extruder metadata (verifiable by unzipping the 3MF) — proof:
- 3d convert works for stl/3mf/usdz inputs and stl/usdz/png outputs through the supported libs; unsupported routes fail with a structured error listing accepted formats — proof:
- an existing target without --force exits 2 with a ready-to-run command naming a free output; --force overwrites; out==input auto-suffixes; write-time re-check covered by tests — proof:
- 3d convert file.3mf file-u1.3mf --to u1 delegates to the retarget machinery (unit test with the retarget run monkeypatched) — proof:
- unit + e2e tests per repo convention pass; docs/commands/convert.md in sync with --help (help-docs-sync) — proof:
Screenshots
(none)
Deploy
Deployed: no
Links
- PR: feat(convert): 3d convert — multicolour scad→3MF Orca project, format conversion, retarget alias (Refs #741) #746
- Merge commit: 66a4b8f
Skipped gates
- links: bare refs are the convert syntax IN/OUT examples and format lists, not entities; the one real relation (3d arrange/export: no multi-part 3MF with per-part extruder; arrange explodes multi-colour objects and drops extruder metadata #89) is linked in --why
- screenshots: CLI command, no UI; proof is the e2e test output and the produced 3MF
Activity
feat(convert): 3d convert — multicolour scad→3MF Orca project, format…
feat(convert): 3d convert — multicolour scad→3MF Orca project, format…
feat(convert): 3d convert — multicolour scad→3MF Orca project, format…
alex-mextner commentedon Nov 6, 2026
screenshot:
alex-mextner commentedon Nov 6, 2026
screenshot:
alex-mextner commentedon Nov 6, 2026
screenshot:
alex-mextner commentedon Nov 6, 2026
screenshot:
alex-mextner commentedon Nov 6, 2026
screenshot:
feat(convert): 3d convert — multicolour scad→3MF Orca project, format…
alex-mextner commentedon Nov 6, 2026
Shipped: merged via #746.
Merge commit: 66a4b8f
This does NOT close the ticket — acceptance still needs proof. Run
task read #741for the outstanding criteria, thentask check/task done.