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

103 lines
3.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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