feat: schreibgeschuetzte 3D-Vorschau mit Glide-Clip
- Presentation3D mit Rink, Folge-/Uebersichtskamera und Skater - 2D/3D-Umschalter, Esc-Rueckweg, geteilte Playback-Steuerung - Skater laedt GLB ueber Manifest-ID, Platzhalter als Fallback - Glide-Clip (2 s) als v003, Manifest und FTP-Spiegel aktualisiert - 44 Praesentations-Assertions (1173 gesamt) - Doku, Architektur (D14) und Roadmap aktualisiert
This commit is contained in:
parent
697274ce1b
commit
723e1bc84a
20 changed files with 1282 additions and 34 deletions
|
|
@ -3,13 +3,14 @@
|
|||
Stand: 2026-10-31
|
||||
Grundlage: `rinkplanner/rinkplanner_definition_agent_guidelines.md`
|
||||
Übergeordnete Reihenfolge: `docs/roadmap.md`
|
||||
Letzte Session: `docs/findings-2026-10-31-asset-ftp.md`
|
||||
(Session davor: `docs/findings-2026-10-31-arp-rig.md`)
|
||||
Letzte Session: `docs/findings-2026-10-31-3d-vorschau.md`
|
||||
(Session davor: `docs/findings-2026-10-31-asset-ftp.md`)
|
||||
|
||||
## 1. Leitentscheidung
|
||||
|
||||
Phase 1 ist eine eigenständige 2D-Anwendung. Sie muss ohne 3D-Renderer,
|
||||
ohne `Node3D` und ohne Blender-Assets lauffähig sein.
|
||||
ohne `Node3D` und ohne Blender-Assets lauffähig sein. Die optionale
|
||||
3D-Vorschau wird erst beim Öffnen geladen (D14) und verändert keine Daten.
|
||||
|
||||
Der bisherige 3D-Test ist ein Machbarkeitsnachweis und liegt isoliert unter
|
||||
`rinkplanner/prototype/3d_test/`. Er ist nicht Teil der Phase-1-Runtime und
|
||||
|
|
@ -27,6 +28,7 @@ wird nicht weiterentwickelt. Phase 2 konsumiert später dasselbe Datenmodell
|
|||
├── src/
|
||||
│ ├── core/model/ # reine Daten-Resources
|
||||
│ ├── core/rules/ # ISU-Katalog (JSON + Lookup)
|
||||
│ ├── presentation3d/ # 3D-Vorschau, lazy geladen
|
||||
│ └── whiteboard/ # Phase 1: view / ctrl / io
|
||||
├── scenes/ # dünne Szenen, die Views zusammensetzen
|
||||
├── assets/
|
||||
|
|
@ -187,6 +189,18 @@ Dateien zusätzlich auf den bestehenden FTP-Server der Kür-Synchronisation;
|
|||
`--sync` lädt sie bei Bedarf und prüft sie gegen den Manifest-Hash. Der
|
||||
FTP-Spiegel ist eine Verteilungskopie, keine zweite Quelle der Wahrheit.
|
||||
|
||||
**D14 – Die 3D-Vorschau ist eine isolierte, schreibgeschützte
|
||||
Präsentationsschicht.**
|
||||
`Presentation3D` liegt unter `src/presentation3d/` und wird erst beim ersten
|
||||
Klick auf **3D** geladen. Phase 1 startet weiterhin ohne `Node3D`; der
|
||||
2D-Workflow kennt nur den Button und den Moduswechsel. Die Vorschau liest
|
||||
`Routine` und den Playback-Zustand, schreibt aber keine Daten. Koordinaten:
|
||||
2D `(x, y)` wird zu 3D `(x, 0, -y)`, die Blickrichtung entsprechend. Der
|
||||
Skater kommt über die Manifest-ID `character.skater.figure`; fehlt die GLB,
|
||||
wird ein Platzhalter gebaut. Der Modus ist bewusst kein Editor: Auswahl,
|
||||
Zeichnen und Elementdialoge bleiben in 2D. Die Kamera folgt dem Skater oder
|
||||
zeigt eine Übersicht; der Wechsel läuft über den Button „Kamera".
|
||||
|
||||
## 4. View- und Controller-Grenzen
|
||||
|
||||
- **View** (`Node2D`/`Control`) liest das Modell und zeichnet. Sie verändert
|
||||
|
|
@ -456,9 +470,12 @@ Aktueller Stand:
|
|||
PASV/EPSV/MDTM-Parsing, Sync-Stand und die Einstellungs-Verdrahtung.
|
||||
Der FTP-Client wurde zusätzlich gegen den echten Zielserver geprüft
|
||||
(Upload, Download, Übernahme, Konflikt, Aufräumen).
|
||||
- **3D-Assets:** 53 Assertions für Manifest-Schema, Pfade, FTP-Pfade,
|
||||
Platzierung, Rig-Metadaten, Hashes und – falls synchronisiert – Größe und
|
||||
SHA-256 der GLB-Datei.
|
||||
- **3D-Assets:** 54 Assertions für Manifest-Schema, Pfade, FTP-Pfade,
|
||||
Platzierung, Rig-Metadaten, Animationen, Hashes und – falls synchronisiert
|
||||
– Größe und SHA-256 der GLB-Datei.
|
||||
- **3D-Vorschau:** 44 Assertions für Koordinatenabbildung, Rink-Geometrie,
|
||||
Kamera-Modi, Platzhalter-Fallback und den 2D/3D-Moduswechsel samt
|
||||
geteilter Playback-Position.
|
||||
|
||||
Autosave/Restore wird zusätzlich in einem isolierten `XDG_DATA_HOME`
|
||||
end-to-end geprüft.
|
||||
|
|
|
|||
|
|
@ -125,15 +125,15 @@ eine still veränderte Workbench-Datei wird nicht kopiert, sondern gemeldet.
|
|||
```json
|
||||
{
|
||||
"id": "character.skater.figure",
|
||||
"version": 2,
|
||||
"version": 3,
|
||||
"kind": "character",
|
||||
"format": "glb",
|
||||
"source": "library/characters/skater_figure_rigged_deform_v002.glb",
|
||||
"target": "assets/external/characters/skater_figure_rigged_deform_v002.glb",
|
||||
"remote": "characters/skater_figure_rigged_deform_v002.glb",
|
||||
"sha256": "1c1f0646…",
|
||||
"bytes": 8345424,
|
||||
"source_scene": "source/characters/skater/skater_rig_v002.blend",
|
||||
"source": "library/characters/skater_figure_glide_v003.glb",
|
||||
"target": "assets/external/characters/skater_figure_glide_v003.glb",
|
||||
"remote": "characters/skater_figure_glide_v003.glb",
|
||||
"sha256": "f45858cd…",
|
||||
"bytes": 8420244,
|
||||
"source_scene": "source/characters/skater/skater_rig_v003.blend",
|
||||
"placement": {
|
||||
"up_axis": "Y",
|
||||
"facing": "+Z",
|
||||
|
|
@ -147,7 +147,9 @@ eine still veränderte Workbench-Datei wird nicht kopiert, sondern gemeldet.
|
|||
"deform_bones": 30,
|
||||
"bind": "PSEUDO_VOXELS"
|
||||
},
|
||||
"animations": []
|
||||
"animations": [
|
||||
"Glide"
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
|
|
@ -186,7 +188,11 @@ eine still veränderte Workbench-Datei wird nicht kopiert, sondern gemeldet.
|
|||
|
||||
| ID | Datei | Größe | Rig | Clips |
|
||||
| :--- | :--- | ---: | :--- | :--- |
|
||||
| `character.skater.figure` | `skater_figure_rigged_deform_v002.glb` | 8,35 MB | 226 Control / 30 Deform | keine (Produktion) |
|
||||
| `character.skater.figure` | `skater_figure_glide_v003.glb` | 8,42 MB | 226 Control / 30 Deform | `Glide` (2-s-Loop) |
|
||||
|
||||
Die 3D-Vorschau lädt die Datei über die Manifest-ID
|
||||
`character.skater.figure`. Fehlt sie, erscheint ein Platzhalter aus
|
||||
Kapsel und Kopf, damit ein frischer Checkout und die Tests laufen.
|
||||
|
||||
Testdateien (nicht im Manifest): `skater_figure_anim_test_v001.glb` mit dem
|
||||
2-Sekunden-Clip `TestWave`.
|
||||
|
|
@ -201,10 +207,13 @@ Testdateien (nicht im Manifest): `skater_figure_anim_test_v001.glb` mit dem
|
|||
exakt auf dem Mesh. Der erste Auto-Rig-Lauf hatte die Füße bei x = 0,24
|
||||
statt 0,10.
|
||||
5. Animationen auf dem Control-Rig erstellen (IK/FK, Fußrollen, Root Motion).
|
||||
Der erste Clip ist `Glide`: Arme unten, 2-s-Loop, im `.blend`
|
||||
`skater_rig_v003.blend`.
|
||||
6. Export mit `export_def_bones=True`; der Exporter backt Constraints
|
||||
automatisch. Im GLB landen nur die 30 Deform-Bones.
|
||||
7. Ergebnis in Godot prüfen (`tests/manual/inspect_rig.gd`,
|
||||
`tests/manual/capture_rig.gd`).
|
||||
`tests/manual/capture_rig.gd`); die 3D-Vorschau mit
|
||||
`tests/manual/capture_3d.gd`.
|
||||
|
||||
Details und Messwerte: `docs/findings-2026-10-31-arp-rig.md`.
|
||||
|
||||
|
|
@ -218,7 +227,7 @@ Details und Messwerte: `docs/findings-2026-10-31-arp-rig.md`.
|
|||
|
||||
## Tests
|
||||
|
||||
`tests/run_asset_manifest_tests.gd` prüft Schema, Pfade, FTP-Pfade, Hashes
|
||||
und – falls synchronisiert – Größe und SHA-256 der Zieldatei. Fehlt das
|
||||
Asset (z. B. in CI), wird der Dateicheck übersprungen, der Schema-Test bleibt
|
||||
aktiv. Aktuell: 53 Assertions.
|
||||
`tests/run_asset_manifest_tests.gd` prüft Schema, Pfade, FTP-Pfade, Hashes,
|
||||
Animationen und – falls synchronisiert – Größe und SHA-256 der Zieldatei.
|
||||
Fehlt das Asset (z. B. in CI), wird der Dateicheck übersprungen, der
|
||||
Schema-Test bleibt aktiv. Aktuell: 54 Assertions.
|
||||
|
|
|
|||
109
docs/findings-2026-10-31-3d-vorschau.md
Normal file
109
docs/findings-2026-10-31-3d-vorschau.md
Normal file
|
|
@ -0,0 +1,109 @@
|
|||
# Findings 2026-10-31 – 3D-Vorschau und Glide-Clip
|
||||
|
||||
## Ziel
|
||||
|
||||
Eine schreibgeschützte 3D-Ansicht, die dieselbe Kür mit denselben
|
||||
Playback-Zeiten und Kurven zeigt wie das 2D-Whiteboard. Kein 3D-Editor,
|
||||
keine Änderung am Phase-1-Workflow.
|
||||
|
||||
## Umsetzung
|
||||
|
||||
```
|
||||
src/presentation3d/
|
||||
├── presentation_3d.gd # Kamera, Licht, Modus, Playback-Pose
|
||||
├── rink_3d.gd # Eisfläche, Bande, Markierungen
|
||||
└── skater_3d.gd # GLB aus dem Manifest + Platzhalter-Fallback
|
||||
|
||||
scenes/presentation3d/presentation_3d.tscn
|
||||
```
|
||||
|
||||
- **Lazy Load:** Die Szene wird erst beim ersten Klick auf **3D** geladen.
|
||||
Phase 1 startet weiterhin ohne `Node3D`.
|
||||
- **Koordinaten:** 2D `(x, y)` → 3D `(x, 0, -y)`. Blickrichtung `(hx, hy)`
|
||||
→ `(hx, 0, -hy)`; der Skater wird per `rotation.y` ausgerichtet.
|
||||
- **Rink:** 60 × 30 m aus `RinkDimensions`, abgerundete Ecken mit
|
||||
`corner_radius_m = 8,5`, Bande 1,1 m, rote Reling, Mittellinie und
|
||||
Mittelkreis.
|
||||
- **Kamera:** Folgekamera 8 m hinter und 5,5 m über dem Skater; Übersicht
|
||||
aus 36 m Höhe. Weicher Übergang, Snap bei großen Sprüngen (Scrubbing).
|
||||
- **Playback:** `_update_playback_state()` schiebt Position und Blickrichtung
|
||||
direkt an die Vorschau. Start/Pause, Reset, Timeline und Geschwindigkeit
|
||||
bleiben die bestehenden Controls.
|
||||
- **UI:** In 3D werden Rink-Canvas, Sections-Panel, Timing-Leiste und
|
||||
Bearbeitungsbuttons ausgeblendet. Die Playback-Leiste bleibt. Der Button
|
||||
wechselt zwischen **3D** und **2D**; Esc schließt die Vorschau.
|
||||
- **Statusleiste:** zeigt im 3D-Modus Abschnitt, Dauer, Kamera und
|
||||
„Esc: 2D".
|
||||
- **Fallback:** Fehlt die GLB, baut `Skater3D` einen Platzhalter aus Kapsel,
|
||||
Kopf und Richtungsmarker. Tests und ein frischer Checkout laufen dadurch
|
||||
ohne Asset-Sync.
|
||||
|
||||
## Glide-Clip
|
||||
|
||||
Der Skater hatte im GLB nur die T-Pose. Für die Vorschau entstand der erste
|
||||
Produktionsclip:
|
||||
|
||||
- ARP-Control-Rig aus `skater_rig_v002.blend`.
|
||||
- Arme über die Hand-IK nach unten, 2-s-Loop mit leichtem Schwanken.
|
||||
- Export mit `export_def_bones=True`, 30 Deform-Bones, eine Animation
|
||||
`Glide`, 90 Kanäle, Dauer 2,0 s.
|
||||
- Neue Datei `skater_figure_glide_v003.glb`, 8.420.244 Bytes,
|
||||
SHA-256 `f45858cd…`.
|
||||
- Manifest auf Version 3 aktualisiert; lokal synchronisiert und per
|
||||
`--publish` auf den FTP-Spiegel geladen.
|
||||
|
||||
`Skater3D` liest die Manifest-ID `character.skater.figure`, spielt `Glide`
|
||||
mit `LOOP_LINEAR` und fällt bei fehlender Datei auf den Platzhalter zurück.
|
||||
|
||||
## Gefundene und behobene Fehler
|
||||
|
||||
1. **Eisfläche unsichtbar:** Die Triangulation war nach der 2D→3D-Abbildung
|
||||
falsch gewickelt. Indizes werden jetzt gedreht; die Fläche zeigt nach
|
||||
oben.
|
||||
2. **Kamera am falschen Ort:** Beim Öffnen wurde die Kamera auf den
|
||||
Skater-Ursprung gesetzt, bevor die Playback-Pose kam. Jetzt wird die Pose
|
||||
vor `set_active()` gesetzt; bei Sprüngen über 4 m snappt die Kamera.
|
||||
3. **Top-Leiste zu breit bei 1024 px:** Der 3D-Button und der Separator
|
||||
sprengten die Tablet-Breite. Im Compact-Modus heißt „Einpassen" jetzt
|
||||
„Fit" (56 px), der 3D-Button ist 56 px breit, Undo/Redo sind 72 px breit
|
||||
und der Separator entfällt. Der Touch-Test ist wieder grün.
|
||||
|
||||
## Tests
|
||||
|
||||
- Neu: `tests/run_presentation3d_tests.gd` mit **44 Assertions**:
|
||||
- Koordinatenabbildung inkl. Blickrichtung
|
||||
- Eisgröße 60 × 30, Mittelkreis, Skater-Instanz
|
||||
- Kamera-Modi und deutsche Labels
|
||||
- Platzhalter-/Modell-Fallback
|
||||
- 2D/3D-Wechsel, Ausblenden der 2D-Controls, erhaltene Playback-Leiste
|
||||
- Skater folgt `get_playback_position()` beim Öffnen und beim Scrubbing
|
||||
- Kamera-Button, Esc-Rückweg
|
||||
- Manifest-Test: 54 Assertions (neue `Glide`-Animation).
|
||||
- Gesamtsuite: **1173 Assertions** grün.
|
||||
|
||||
## Visuelle Prüfung
|
||||
|
||||
- `tests/manual/capture_3d.gd` rendert die Vorschau mit einer Testkür.
|
||||
- Geprüft bei 1400 × 900: Folgekamera, Übersicht, Glide-Pose, Schatten,
|
||||
Bande und Markierungen.
|
||||
- Der Skater steht mit den Füßen auf dem Eis; die Kameraposition folgt der
|
||||
Blickrichtung.
|
||||
|
||||
## Offen
|
||||
|
||||
- Weitere Clips: Vorwärts/Rückwärts, Kantenwechsel, Pirouette, Sprünge.
|
||||
- Freie Kamera/Orbit und eine dritte Ansicht (z. B. von vorn).
|
||||
- 3D-Auswahl oder Bearbeitung ist bewusst nicht enthalten.
|
||||
- Android: 8,42-MB-GLB und 2K-Texturen prüfen, bevor die Vorschau in einen
|
||||
Mobile-Build wandert.
|
||||
|
||||
## Dateien
|
||||
|
||||
```
|
||||
rinkplanner/src/presentation3d/{presentation_3d,rink_3d,skater_3d}.gd
|
||||
rinkplanner/scenes/presentation3d/presentation_3d.tscn
|
||||
rinkplanner/tests/run_presentation3d_tests.gd
|
||||
rinkplanner/tests/manual/capture_3d.gd
|
||||
workbench/source/characters/skater/skater_rig_v003.blend
|
||||
workbench/library/characters/skater_figure_glide_v003.glb
|
||||
```
|
||||
|
|
@ -12,6 +12,48 @@ App über den Button **?** in der Statusleiste erreichbar.
|
|||
3. Elemente aufs Eis setzen: Linie, Bogen oder Element-Marker.
|
||||
4. Im Element-Dialog **Kürzel**, **Features** und ggf. **Standzeit** festlegen.
|
||||
5. **Prüfen** öffnen: Prüfliste, Befunde und Punktschätzung ansehen.
|
||||
6. Optional **3D** in der oberen Leiste öffnen, um die Kür als Vorschau
|
||||
abzuspielen.
|
||||
|
||||
## 3D-Vorschau
|
||||
|
||||
Der Button **3D** in der oberen Leiste wechselt in eine schreibgeschützte
|
||||
3D-Ansicht. Die 2D-Bearbeitung bleibt unverändert; beim Zurückwechseln steht
|
||||
der bisherige Bearbeitungsstand wieder da.
|
||||
|
||||
- **Playback geteilt:** Start/Pause, Reset, Timeline und Geschwindigkeit
|
||||
wirken auf den 2D-Marker und den 3D-Skater gleichzeitig.
|
||||
- **Kamera:** Der Button „Kamera: Folge" wechselt zwischen der
|
||||
Folgekamera (hinter dem Skater) und der Übersicht (ganzes Rink).
|
||||
- **Zurück:** erneut **2D** drücken oder **Esc**.
|
||||
- **Statusleiste:** zeigt im 3D-Modus den Hinweis „Esc: 2D" und die aktive
|
||||
Kamera.
|
||||
- **Inhalt:** Rink mit Bande, Mittelkreis und Mittellinie; der Skater fährt
|
||||
dieselben `Curve2D`-Bahnen wie der 2D-Marker, inklusive Blickrichtung und
|
||||
Standzeiten.
|
||||
|
||||
Die 3D-Ansicht ist eine Präsentationsschicht, kein Editor. Elemente werden
|
||||
weiterhin ausschließlich in 2D gesetzt und bearbeitet.
|
||||
|
||||
### Voraussetzungen
|
||||
|
||||
Die 3D-Ansicht lädt die Skater-GLB über das Asset-Manifest aus
|
||||
`assets/external/`. Auf einem frischen Checkout zuerst:
|
||||
|
||||
```bash
|
||||
./tools/sync_assets.sh --sync
|
||||
```
|
||||
|
||||
Fehlt die Datei, zeigt die Vorschau einen Platzhalter aus Kapsel und Kopf;
|
||||
die 2D-Funktionen sind davon nicht betroffen.
|
||||
|
||||
### Aktuelle Grenzen
|
||||
|
||||
- Der Skater spielt den 2s-Clip `Glide`. Sprünge, Pirouetten und Kantenwechsel
|
||||
haben noch keine eigenen Animationen.
|
||||
- Die Folgekamera schaut von hinten; eine frei drehbare Kamera gibt es noch
|
||||
nicht.
|
||||
- Es gibt keine Bearbeitung und keine Auswahl in 3D.
|
||||
|
||||
## Kürzel und Base Value
|
||||
|
||||
|
|
|
|||
|
|
@ -186,8 +186,10 @@ UI-Feedback der Tester ohnehin noch ausstehen.
|
|||
- [x] FTP-Spiegel für Rechner ohne Workbench (`--publish` / `--sync`-Fallback)
|
||||
- [x] Geriggter Skater (AutoRigPro, 226 Control-/30 Deform-Bones, glTF-Export)
|
||||
- [x] Animations-Bake und Godot-Import eines Testclips (`TestWave`)
|
||||
- [ ] 3D-Rink und Skater auf Basis desselben Datenmodells im Godot-Prototyp
|
||||
- [ ] Rotoscoping-Workflow und erste echte Animationsclips
|
||||
- [x] 3D-Rink, Kamera und Skater auf denselben Kurven (schreibgeschützte Vorschau)
|
||||
- [x] Erster Produktionsclip `Glide` als 2-s-Loop
|
||||
- [ ] 3D-Bearbeitung, freie Kamera und Orbit-Steuerung
|
||||
- [ ] Rotoscoping-Workflow und weitere echte Animationsclips
|
||||
- [ ] NLA-/Animations-Tracks aus Blender
|
||||
- [ ] Blender-MCP und Godot-Editor-MCP für den Asset-Workflow
|
||||
- [x] Klare Trennung: Phase 1 bleibt ohne 3D-Abhängigkeiten lauffähig
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue