2026-10-31 13:02:46 +01:00
|
|
|
|
# Rotoscoping-Workflow
|
|
|
|
|
|
|
|
|
|
|
|
Stand: 2026-10-31
|
|
|
|
|
|
|
|
|
|
|
|
Die Rotoscoping-Werkbank liegt in Blender, nicht in Godot. Godot konsumiert
|
|
|
|
|
|
nur die exportierten GLB-Clips. Videomaterial und Arbeitsdateien bleiben im
|
|
|
|
|
|
Workbench-Archiv; das Repo enthält die Skripte und die Dokumentation.
|
|
|
|
|
|
|
|
|
|
|
|
## Voraussetzungen
|
|
|
|
|
|
|
|
|
|
|
|
- Blender 5.2 mit AutoRigPro (für die Control-Rig-Bones).
|
|
|
|
|
|
- Das Produktions-Rig:
|
2026-11-12 06:12:27 +01:00
|
|
|
|
`workbench/source/characters/skater/skater_rig_v008.blend` (Rig der
|
|
|
|
|
|
jeweils aktiven Figur, siehe `docs/assets.md`).
|
2026-10-31 13:02:46 +01:00
|
|
|
|
- Für den synthetischen Testfilm: `ffmpeg`.
|
|
|
|
|
|
- Für den FTP-Upload: `docs/credentials.txt` wie beim Asset-Sync.
|
|
|
|
|
|
|
2026-10-31 15:38:56 +01:00
|
|
|
|
Der Default ist nur die **Quelldatei für neue Arbeitsdateien**. Das
|
|
|
|
|
|
eigentliche Rotoscoping (Posen setzen, keyframen) bleibt manuell. Eine
|
|
|
|
|
|
bereits vorhandene `rotoscope_work.blend` wird nicht automatisch auf ein
|
|
|
|
|
|
neues Rig migriert.
|
|
|
|
|
|
|
2026-10-31 13:02:46 +01:00
|
|
|
|
## Einmal einrichten
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
./tools/rotoscope.sh setup
|
|
|
|
|
|
./tools/rotoscope.sh open
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
`setup` legt an:
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
workbench/source/characters/skater/rotoscope/
|
|
|
|
|
|
├── rotoscope_work.blend # Arbeitsdatei (nicht überschreiben)
|
|
|
|
|
|
└── references/ # Videos und Standbilder
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
`setup` überschreibt eine vorhandene Arbeitsdatei nur mit `--force`.
|
|
|
|
|
|
**`--force` löscht den Arbeitsstand**; für ein neues Video in derselben Datei
|
|
|
|
|
|
`./tools/rotoscope.sh reference <pfad>` verwenden.
|
|
|
|
|
|
|
|
|
|
|
|
Die Arbeitsdatei enthält:
|
|
|
|
|
|
|
|
|
|
|
|
- `RotoscopeCamera` mit `CameraTarget` (Track-To-Constraint),
|
|
|
|
|
|
- `RinkGuide`: 60 × 30 m Rink als Drahtgitter, Mittellinie, Mittelkreis,
|
|
|
|
|
|
5-m-Raster und 2-m-Höhenachse am Ursprung,
|
|
|
|
|
|
- das Skater-Rig und Modell, Pose auf Ruhezustand zurückgesetzt,
|
|
|
|
|
|
- die vorhandene `Glide`-Aktion als Fake-User (bleibt exportierbar).
|
|
|
|
|
|
|
|
|
|
|
|
Die Kamera steht standardmäßig auf einer ganzen-Rink-Ansicht
|
|
|
|
|
|
(28 mm, 55 m entfernt). Für eine Nahaufnahme die Kamera näher an den
|
|
|
|
|
|
Skater schieben; das `CameraTarget` bleibt der Blickpunkt.
|
|
|
|
|
|
|
|
|
|
|
|
## Referenz laden
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
./tools/rotoscope.sh reference /pfad/zum/video.mp4
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
Unterstützt werden Videos (`.mp4`, `.mov`, `.avi`, `.mkv`, `.webm`) und
|
|
|
|
|
|
Standbilder (`.png`, `.jpg`, `.exr`, `.tif`). Das Video erscheint als
|
|
|
|
|
|
Kamera-Hintergrund (nur in der Kameraansicht, nicht im finalen Render).
|
|
|
|
|
|
Bildrate und Frame-Bereich werden aus dem Video übernommen.
|
|
|
|
|
|
|
|
|
|
|
|
In Blender:
|
|
|
|
|
|
|
|
|
|
|
|
1. `Numpad 0` – Kameraansicht.
|
|
|
|
|
|
2. Rink-Guide an den Banden des Videos ausrichten (Kamera verschieben,
|
|
|
|
|
|
drehen, Brennweite ändern).
|
|
|
|
|
|
3. Bei einer Nahaufnahme den Rink-Guide ausblenden und den Skater im Bild
|
|
|
|
|
|
zentrieren.
|
|
|
|
|
|
|
|
|
|
|
|
Die Kamera bleibt während eines Clips **fest**. Für eine bewegte Kamera
|
|
|
|
|
|
muss die Kamera in Blender manuell getrackt werden (Movie Clip Editor,
|
|
|
|
|
|
Motion Tracking); die Werkbank automatisiert das bewusst nicht.
|
|
|
|
|
|
|
|
|
|
|
|
## Clips animieren
|
|
|
|
|
|
|
|
|
|
|
|
Im Action Editor eine neue Aktion anlegen und mit den ARP-Controls poseweise
|
|
|
|
|
|
keyframen. Empfohlene Namen:
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
Glide, Forward, Backward,
|
|
|
|
|
|
CrossoverL, CrossoverR,
|
|
|
|
|
|
ThreeTurnL, ThreeTurnR,
|
|
|
|
|
|
Spin, Jump, Landing
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
Konventionen:
|
|
|
|
|
|
|
|
|
|
|
|
- **In-Place:** Keine Translation des Root-Controls. Die Fortbewegung kommt
|
|
|
|
|
|
in Godot aus der Kür-Kurve. Ein Clip beschreibt nur die Körperbewegung.
|
|
|
|
|
|
- **Loop:** Bei zyklischen Clips (Glide, Forward, Backward) sind erster und
|
|
|
|
|
|
letzter Frame identisch.
|
|
|
|
|
|
- **Framerate:** 24 fps, wie die bestehenden Clips.
|
|
|
|
|
|
- **Fake User:** Jede Aktion mit `use_fake_user` sichern, damit sie beim
|
|
|
|
|
|
Schließen der Datei nicht verloren geht und exportiert wird.
|
|
|
|
|
|
- **Nicht löschen:** Die `Glide`-Aktion bleibt als Basis im Export.
|
|
|
|
|
|
|
|
|
|
|
|
Der referenzierte Skater im Video und das Rig müssen nicht deckungsgleich
|
|
|
|
|
|
sein; wichtig ist die Pose, nicht die absolute Position im Rink.
|
|
|
|
|
|
|
|
|
|
|
|
## Exportieren
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
./tools/rotoscope.sh export --out /tmp/meine_clips.glb
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
Der Export:
|
|
|
|
|
|
|
|
|
|
|
|
- schreibt eine GLB mit **allen** Aktionen,
|
|
|
|
|
|
- backt die Constraints,
|
|
|
|
|
|
- exportiert nur die 30 Deform-Bones,
|
|
|
|
|
|
- schreibt eine JSON-Metadatendatei neben die GLB (Clipnamen, Dauer,
|
|
|
|
|
|
SHA-256, Quelle).
|
|
|
|
|
|
|
|
|
|
|
|
## In das Projekt übernehmen
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
./tools/rotoscope.sh promote --version 4
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
`promote` exportiert nach
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
workbench/library/characters/skater_figure_clips_v004.glb
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
aktualisiert `rinkplanner/assets/asset_manifest.json` (Version, Quelle,
|
|
|
|
|
|
Ziel, FTP-Pfad, Hash, Clips), kopiert die Datei nach `assets/external/` und
|
|
|
|
|
|
stößt den Godot-Import an. Mit `--publish` wird sie zusätzlich auf den
|
|
|
|
|
|
FTP-Spiegel geladen.
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
./tools/rotoscope.sh promote --version 4 --publish
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
Vor dem Schreiben des Manifests prüfen:
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
./tools/rotoscope.sh promote --version 4 --dry-run
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## Godot
|
|
|
|
|
|
|
|
|
|
|
|
Die 3D-Vorschau lädt die GLB über die Manifest-ID
|
2026-11-12 06:31:38 +01:00
|
|
|
|
`character.skater.figure_tripo_glide`. Derzeit spielt sie den Clip `Glide`. Weitere Clips
|
2026-10-31 13:02:46 +01:00
|
|
|
|
stehen nach dem Import im `AnimationPlayer` zur Verfügung; die Zuordnung
|
|
|
|
|
|
Element → Clip (z. B. `Spin` bei einer Pirouette) ist der nächste Schritt.
|
|
|
|
|
|
|
|
|
|
|
|
## Synthetischer Testfilm
|
|
|
|
|
|
|
|
|
|
|
|
Ohne eigenes Videomaterial lässt sich die Pipeline vollständig prüfen:
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
./tools/rotoscope.sh test-reference
|
|
|
|
|
|
./tools/rotoscope.sh setup \
|
2026-11-01 13:47:06 +01:00
|
|
|
|
--reference "$HOME/Dokumente/workbench_rinkplanner/source/characters/skater/rotoscope/references/test_reference.mp4" \
|
2026-10-31 13:02:46 +01:00
|
|
|
|
--out /tmp/rotoscope_test.blend --force
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
Der Testfilm ist 8 s lang, 1280 × 720, 24 fps und enthält einen bewegten
|
|
|
|
|
|
Punkt. Nach dem Setup:
|
|
|
|
|
|
|
|
|
|
|
|
- Frame-Bereich 1–192,
|
|
|
|
|
|
- Kamera-Hintergrund `MOVIE_CLIP`,
|
|
|
|
|
|
- Rink-Guide sichtbar,
|
|
|
|
|
|
- Rig in Ruhepose.
|
|
|
|
|
|
|
|
|
|
|
|
Export-Test:
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
./tools/rotoscope.sh export --out /tmp/rotoscope_test.glb
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
Erwartet: GLB mit den vorhandenen Aktionen (mindestens `Glide`) und eine
|
|
|
|
|
|
JSON-Metadatendatei daneben.
|
|
|
|
|
|
|
|
|
|
|
|
## Grenzen
|
|
|
|
|
|
|
|
|
|
|
|
- Die Kamera wird manuell ausgerichtet; es gibt keinen automatischen
|
|
|
|
|
|
Kamera-Solve.
|
|
|
|
|
|
- AutoRigPro und die Gewichtung sind bereits erledigt; die Werkbank
|
|
|
|
|
|
automatisiert keine neuen Meshes.
|
|
|
|
|
|
- Der Export enthält alle Aktionen der Arbeitsdatei. Nicht gewünschte
|
|
|
|
|
|
Aktionen vorher löschen oder ohne Fake User ablegen.
|
|
|
|
|
|
- Root-Motion-Clips sind möglich, aber die Godot-Vorschau erwartet
|
|
|
|
|
|
In-Place-Clips.
|
|
|
|
|
|
- Das Referenzvideo wird nicht versioniert und nicht in die GLB gebacken.
|