104 lines
3.8 KiB
Markdown
104 lines
3.8 KiB
Markdown
|
|
# 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)
|
|||
|
|
```
|