# 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.