- 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
3.8 KiB
3.8 KiB
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) mitCameraTargetund 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_CLIPin den Kamera-Hintergrund gelegt (nur Kameraansicht, nicht im finalen Render). - Bildrate und Frame-Bereich kommen aus dem Clip.
- Standbilder werden als
IMAGEunterstü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:
- exportiert nach
library/characters/skater_figure_clips_vNNN.glb, - aktualisiert Version, Quelle, Ziel, FTP-Pfad, Hash, Clips und
source_sceneim Manifest, - synchronisiert nach
assets/external/und importiert in Godot, - optional
--publishauf 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)