rinkplanner/tools/video/README.md
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

90 lines
3.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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
```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: `<name>__cutted_<von>_<bis>.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: `<name>_fps_<ziel>.mp4`.
### 5. In die Werkbank übernehmen
```bash
./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.