Skip to content

3d convert: format conversion command (scad/stl/3mf/usdz/png) with multicolor scad→3MF Orca project #741

Closed

Description

@alex-mextner

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: 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: 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: proof
  • 3d convert file.3mf file-u1.3mf --to u1 delegates to the retarget machinery (unit test with the retarget run monkeypatched) — proof: proof
  • unit + e2e tests per repo convention pass; docs/commands/convert.md in sync with --help (help-docs-sync) — proof: proof

Screenshots

(none)

Deploy

Deployed: no

Links

Skipped gates

Activity

  1. alex-mextner commented on Nov 6, 2026

    @alex-mextner
    OwnerAuthor

    screenshot: fbb4894994d0e923eaa539755704d57b

  2. alex-mextner commented on Nov 6, 2026

    @alex-mextner
    OwnerAuthor

    screenshot: 8fed4ae6efe3b6c72326b8c195086794

  3. alex-mextner commented on Nov 6, 2026

    @alex-mextner
    OwnerAuthor

    screenshot: 856cd680e1025b6e6cd38b1656154409

  4. alex-mextner commented on Nov 6, 2026

    @alex-mextner
    OwnerAuthor

    screenshot: 856cd680e1025b6e6cd38b1656154409

  5. alex-mextner commented on Nov 6, 2026

    @alex-mextner
    OwnerAuthor

    screenshot: 84ef3075898754c7872dd64f05de1ee1

  6. alex-mextner commented on Nov 6, 2026

    @alex-mextner
    OwnerAuthor

    Shipped: merged via #746.
    Merge commit: 66a4b8f
    This does NOT close the ticket — acceptance still needs proof. Run task read #741 for the outstanding criteria, then task check/task done.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions