# Video sichten und schneiden Werkzeuge für den ersten Schritt der Rotoscoping-Kette: Aus langen Aufnahmen die Sekunden herausschneiden, die als Referenz für die Blender-Werkbank dienen — und sie so verkleinern, dass Blender sie flüssig abspielt. Die Referenzen selbst bleiben im Workbench-Archiv (`docs/assets.md`); hier liegen nur die Skripte. Maßgeblich ist **dieses Verzeichnis**: In der Werkbank verweisen `cut_video.py` und `downsample.py` per Symlink hierher, damit es keine zweite Fassung gibt. ## Voraussetzungen - **`ffmpeg` und `ffprobe`** im Pfad. macOS: `brew install ffmpeg`. - Python 3.8 oder neuer (keine zusätzlichen Pakete für diese beiden Skripte). Die beiden Analyse-Skripte (siehe unten) brauchen zusätzlich `opencv-python`, `numpy` und `ultralytics` samt YOLOv8x-Pose-Gewichten. ## Die Skripte | Datei | Zweck | Abhängigkeiten | | :--- | :--- | :--- | | `cut_video.py` | schneidet einen Abschnitt aus einer MP4 | `ffmpeg` | | `downsample.py` | reduziert die Bildrate, skaliert auf 1920 × 1280 | `ffmpeg` | Zwei weitere Helfer liegen bewusst **nicht** hier, sondern in der Werkbank (`workbench_rinkplanner/tools/`): `scan_takes.py` und `window_scan.py`. Sie enthalten feste Pfade und Zeitfenster der jeweiligen Aufnahme (plus YOLO-Gewichte) und taugen nur für diese eine Sitzung. ## Ablauf ### 1. Takes sichten `scan_takes.py` misst über alle Dateien die Figurengröße (nur Keyframes, daher schnell) und schreibt `take_scan/.csv` nach `/tmp`. Aus der Tabelle sieht man, in welchen Dateien die Läuferin groß genug ist. ### 2. Kandidaten prüfen `window_scan.py` legt für fest eingetragene Zeitfenster Kontaktabzüge an (Crops um die Läuferin, 5 Bilder/s). Damit findet man den Moment mit bloßem Auge — etwa einen Sprung, bei dem beide Füße in der Luft sind. ### 3. Schneiden ```bash ./cut_video.py DJI_0002.MP4 16 32 ./cut_video.py DJI_0002.MP4 0:16 0:32 --outdir ~/Dokumente/clips ./cut_video.py DJI_0002.MP4 16 32 --copy # verlustfrei, aber Keyframe-genau ``` Ohne `--copy` wird neu kodiert: exakter Schnitt, Hardware-Decode wenn vorhanden. Mit `--copy` bleibt der Stream unverändert — schnell und verlustfrei, aber der Schnitt landet auf dem Keyframe davor (bei den Drohnen-Dateien im 1-Sekunden-Raster). Ausgabe: `__cutted__.mp4`, standardmäßig neben der Quelle. ### 4. Verkleinern ```bash ./downsample.py DJI_0002__cutted_16_32.mp4 24 ``` Ziel ist 1920 × 1280 bei 24 fps. Das Zielformat ist 3:2, das Material meist 16:9 — Standard ist `--fit pad` (unverzerrt, schwarze Balken), alternativ `crop` oder `stretch`. Dauer und Farben bleiben erhalten, Ton wird übernommen. Ausgabe: `_fps_.mp4`. ### 5. In die Werkbank übernehmen ```bash ./tools/rotoscope.sh reference ``` Details zum Rig, zu den Posen und zum Export stehen in `docs/rotoscoping.md`. ## Merksätze - **Ein Clip = eine Bewegung.** Lieber drei kurze Referenzen als eine lange Aufnahme, in der drei Elemente vorkommen. - **Immer verkleinern, bevor Blender geöffnet wird.** 4K-Material ruckelt in der Vorschau, ohne dass es beim Keyframing hilft. - **Originale nicht überschreiben.** `cut_video.py` und `downsample.py` legen neue Dateien an; `--overwrite` nur bewusst.