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.
90 lines
3.2 KiB
Markdown
90 lines
3.2 KiB
Markdown
# 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.
|