43 lines
2.0 KiB
Markdown
43 lines
2.0 KiB
Markdown
# syncro_multi_agente
|
|
|
|
Pipeline **Autodesk Fusion 360 → Blender → GLB** + contratto di interfaccia per il viewer **Three.js**.
|
|
|
|
Repository condiviso tra:
|
|
- **Agent A** (questo repo) — produce `plotter.glb` e `joints.json` da Fusion.
|
|
- **Agent B** (altro workspace) — consuma il GLB in un viewer web con `FusionRig.js`.
|
|
|
|
## Contenuto
|
|
|
|
| File | Scopo |
|
|
|---|---|
|
|
| [FUSION_GLB_CONTRACT.md](FUSION_GLB_CONTRACT.md) | **Fonte di verità.** Schema `joints.json`, convenzioni `userData` nel GLB, unità di misura, lista dei 5 driver pilotati. |
|
|
| [BRIDGE_NOTES.md](BRIDGE_NOTES.md) | Risposte ai problemi `[OPEN]` del contratto e stato della checklist. |
|
|
| [THREEJS_USAGE.md](THREEJS_USAGE.md) | Snippet copia-incolla per caricare e pilotare `plotter.glb` in Three.js. |
|
|
| [AGENTS.md](AGENTS.md) | Regole operative per Copilot Chat (entrambi gli agent). |
|
|
| `ExportKinematicGraph.py` | Add-in/script Fusion 360: produce `hierarchy.json` + `joints.json` + meshes OBJ. |
|
|
| `build_glb_from_fusion_export.py` | Script Blender: importa la mesh, ricostruisce la gerarchia con `userData`, embedda il manifest, esporta `plotter.glb`. |
|
|
| `build_glb.bat` | Wrapper Windows per lanciare Blender headless. |
|
|
|
|
## Quick start (lato produttore)
|
|
|
|
1. In **Fusion 360**: `Utilities → ADD-INS → Scripts → ExportKinematicGraph → Run`.
|
|
2. Lo script chiede una cartella di output (default: `C:\Users\croce\OneDrive\Desktop\export`).
|
|
3. Da PowerShell:
|
|
```powershell
|
|
cd "C:\Users\croce\OneDrive\Desktop\export grafo fusion"
|
|
.\build_glb.bat "C:\Users\croce\OneDrive\Desktop\export"
|
|
```
|
|
4. Output: `plotter.glb` pronto per il viewer.
|
|
|
|
## Lato consumatore (Three.js)
|
|
|
|
Vedi [THREEJS_USAGE.md](THREEJS_USAGE.md) e [FUSION_GLB_CONTRACT.md §3-§5](FUSION_GLB_CONTRACT.md).
|
|
|
|
## Convenzioni di lavoro
|
|
|
|
Vedi [AGENTS.md](AGENTS.md) — in particolare le regole su branch, commit message e cosa NON committare.
|
|
|
|
## Stato attuale
|
|
|
|
Vedi sezione "Stato attuale dell'export" in [BRIDGE_NOTES.md](BRIDGE_NOTES.md).
|