# 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) ```