rinkplanner/docs/findings-2026-10-31-rotoscoping.md

104 lines
3.8 KiB
Markdown
Raw Normal View 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)
```