Eis und Bande waren fast gleich hell, die Kante war kaum zu sehen. Die Bande ist jetzt dreiteilig und deutlich abgesetzt: - petrolfarbener Sockel (0,22 m) als dunkle Trennlinie zum Eis - Bandfläche in kühlerem Graublau mit prozeduraler Fugen-Textur; die Fugen wiederholen sich per world-triplanar alle 2,4 m, auch in den Kurven - rote Reling als obere Kante, leicht abgedunkelt - Eisfläche etwas dunkler, damit sie nicht ausbrennt Tests prüfen Sockel, Textur, Weltkoordinaten-Fugen und Helligkeitsabstand; Sichtprüfung über tests/manual/capture_rink_boards.gd (vier Blickwinkel).
129 lines
5.5 KiB
Markdown
129 lines
5.5 KiB
Markdown
# 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
|
||
```
|
||
|
||
## Nachtrag: Bande mit mehr Kontrast (2026-11-12)
|
||
|
||
Eis und Bande waren beide nahezu weiß (`e8f3ff` bzw. `f4f7fa`), bei flachem
|
||
Licht war die Kante kaum zu sehen. Die Bande ist jetzt dreiteilig:
|
||
|
||
- **Sockel (Kickplate):** 0,22 m hoch, petrolfarben (`0f3b46`), sitzt leicht
|
||
vor der Bande und trennt Eis und Bande als dunkle Linie.
|
||
- **Bandfläche:** `bccddd`, also deutlich kühler und dunkler als das Eis
|
||
(`d3e6f5`), mit einer prozedural erzeugten Fugen-Textur
|
||
(`BOARD_PANEL_WIDTH_M = 2,4`). Die Textur läuft über
|
||
`uv1_world_triplanar`, damit die Panelbreite auf geraden Stücken und in den
|
||
Kurven gleich bleibt – BoxMesh-UVs hätten die Fugen pro Segment gestreckt.
|
||
- **Reling:** rot (`b3261e`) als obere Kante.
|
||
|
||
Sichtprüfung mit vier Blickwinkeln (Übersicht, Bande nah, Folgekamera,
|
||
Innenansicht): `tests/manual/capture_rink_boards.gd`. Die Tests prüfen, dass
|
||
jede Bande einen Sockel hat, die Bande eine Textur trägt, die Fugen in
|
||
Weltkoordinaten wiederholen und sich Bande und Eis in der Helligkeit
|
||
unterscheiden.
|