rinkplanner/docs/findings-2026-10-31-3d-vorschau.md
torsten 0325e53984 feat: 3D-Bande mit Sockel, Fugen und mehr Kontrast zum Eis
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).
2026-11-12 06:22:10 +01:00

5.5 KiB
Raw Blame History

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.