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
This commit is contained in:
parent
723e1bc84a
commit
7f35162966
10 changed files with 1091 additions and 3 deletions
103
docs/findings-2026-10-31-rotoscoping.md
Normal file
103
docs/findings-2026-10-31-rotoscoping.md
Normal file
|
|
@ -0,0 +1,103 @@
|
|||
# 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)
|
||||
```
|
||||
Loading…
Add table
Add a link
Reference in a new issue