rinkplanner/docs/findings-2026-10-31-rotoscoping.md
torsten 7f35162966 feat: Rotoscoping-Werkbank ohne vorhandenes Videomaterial
- Blender-Setup mit Kamera, Rink-Guide und Video-Referenz
- CLI fuer setup/reference/open/export/promote/test-reference
- Multi-Clip-GLB-Export und Manifest-Uebernahme inkl. FTP-Option
- synthetischer Testfilm validiert Szene, Export und Promote
- Doku, Architektur (D15) und Roadmap aktualisiert
2026-10-31 13:02:46 +01:00

3.8 KiB
Raw Blame History

Findings 2026-10-31 – Rotoscoping-Werkbank

Ziel

Die Rotoscoping-Pipeline vollständig aufsetzen, ohne dass bereits Videomaterial vorliegt. Die Werkbank muss später nur noch ein Video laden, eine Aktion animieren und die Clips ins Asset-Manifest übernehmen.

Umsetzung

tools/blender/rotoscope.py     # Szene, Referenz, GLB-Export
tools/rotoscope.sh             # CLI: setup, reference, open, export,
                               #      promote, test-reference, status
tools/promote_rotoscope.py     # GLB + Sidecar -> Manifest -> Sync/FTP
docs/rotoscoping.md            # Workflow und Konventionen

Vorbereitete Szene

setup öffnet skater_rig_v003.blend und legt eine Arbeitsdatei an:

  • RotoscopeCamera (28 mm) mit CameraTarget und Track-To,
  • RinkGuide: 60 × 30 m Drahtgitter mit Bande, Mittellinie, Mittelkreis, 5-m-Raster und 2-m-Höhenachse,
  • Rig und Modell, Pose auf Ruhezustand zurückgesetzt,
  • alle Aktionen mit Fake User, insbesondere Glide,
  • optional ein Referenzvideo als Kamera-Hintergrund.

Die Arbeitsdatei liegt unter workbench/source/characters/skater/rotoscope/rotoscope_work.blend und wird nur mit --force überschrieben.

Referenzvideo

  • Videos werden als MOVIE_CLIP in den Kamera-Hintergrund gelegt (nur Kameraansicht, nicht im finalen Render).
  • Bildrate und Frame-Bereich kommen aus dem Clip.
  • Standbilder werden als IMAGE unterstützt.
  • Die Kamera bleibt pro Clip fest; bewegte Kameras müssen manuell getrackt werden.

Export und Übernahme

export exportiert alle Aktionen als GLB:

  • export_def_bones=True (30 Deform-Bones),
  • Constraints werden gebacken,
  • Sidecar-JSON mit Clipnamen, Dauer, SHA-256 und Größe.

promote:

  1. exportiert nach library/characters/skater_figure_clips_vNNN.glb,
  2. aktualisiert Version, Quelle, Ziel, FTP-Pfad, Hash, Clips und source_scene im Manifest,
  3. synchronisiert nach assets/external/ und importiert in Godot,
  4. optional --publish auf den FTP-Spiegel.

Synthetischer Testfilm

tools/rotoscope.sh test-reference erzeugt mit ffmpeg einen 8-s-Film (1280 × 720, 24 fps, 192 Frames) mit Rink-Rahmen und bewegtem Punkt.

Damit geprüft:

Schritt Ergebnis
setup --reference test_reference.mp4 Frame 1–192, fps 24, Kamera-Hintergrund MOVIE_CLIP
Szene RotoscopeCamera, CameraTarget, RinkGuide (145 Vertices, 127 Kanten), Rig/Modell
Rig Pose T-Pose, Glide mit Fake User, keine aktive Aktion
export GLB mit Glide (2,0 s), Sidecar geschrieben
Zusatzclip TestClip Export mit Glide (2,0 s) und TestClip (1,0 s)
promote --dry-run Version 99, Ziel, Clips und Hash korrekt in temporärem Manifest

Der Test bestätigt auch, dass der Export ohne aktive Aktion funktioniert: Fake-User-Aktionen werden mitgenommen.

Konventionen

  • Clips sind in-place; die Fortbewegung kommt aus der Kür-Kurve.
  • 24 fps, Loop-Clips mit identischem ersten und letzten Frame.
  • Namen: Glide, Forward, Backward, CrossoverL/R, ThreeTurnL/R, Spin, Jump, Landing.
  • Die Glide-Aktion bleibt als Basis im Export, bis sie ersetzt wird.
  • Nicht gewünschte Aktionen vor dem Export löschen; der Export nimmt alle Aktionen mit.

Offen

  • Erste echte Clips aus Referenzmaterial.
  • Zuordnung Element → Clip in Godot (Pirouette → Spin, Sprung → Jump).
  • Kamera-Solve für bewegte Aufnahmen (manuell über Blender Motion Tracking).
  • Automatische Prüfung, ob ein Clip loop-fähig ist.
  • Referenzvideo-Offset beim Trimm aus einem längeren Video komfortabler machen.

Dateien

workbench/source/characters/skater/rotoscope/rotoscope_work.blend
workbench/source/characters/skater/rotoscope/references/test_reference.mp4
workbench/library/characters/skater_figure_clips_v004.glb   (nach promote)