rinkplanner/tools/video
torsten ec3336550d feat: Video-Werkzeuge ins Repo (tools/video)
Die beiden allgemeinen Schnitt-Skripte lagen nur in der Werkbank und waren
damit nicht auf dem Mac verfügbar:

- `tools/video/cut_video.py` — exakter Schnitt aus einer MP4 (ffmpeg).
- `tools/video/downsample.py` — Bildrate reduzieren, auf 1920x1280 skalieren.
- `tools/video/README.md` — Kurzanleitung: Voraussetzungen, Ablauf vom
  Sichten bis zur Übergabe an Blender, Merksätze.

Die Analyse-Helfer `scan_takes.py` und `window_scan.py` bleiben in der
Werkbank: Sie enthalten feste Pfade und Zeitfenster der jeweiligen Aufnahme
(YOLO-Gewichte) und taugen nur für diese Sitzung.

In der Werkbank verweisen die beiden Skripte jetzt per Symlink hierher, damit
es keine zweite Fassung gibt. `docs/rotoscoping.md` nennt den neuen Ort.
2026-11-13 16:37:48 +01:00
..
cut_video.py feat: Video-Werkzeuge ins Repo (tools/video) 2026-11-13 16:37:48 +01:00
downsample.py feat: Video-Werkzeuge ins Repo (tools/video) 2026-11-13 16:37:48 +01:00
README.md feat: Video-Werkzeuge ins Repo (tools/video) 2026-11-13 16:37:48 +01:00

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/<name>.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

./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: <name>__cutted_<von>_<bis>.mp4, standardmäßig neben der Quelle.

4. Verkleinern

./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: <name>_fps_<ziel>.mp4.

5. In die Werkbank übernehmen

./tools/rotoscope.sh reference <pfad/zum/clip.mp4>

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.