rinkplanner/tools/video/README.md

91 lines
3.2 KiB
Markdown
Raw Normal View History

# 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.