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.
This commit is contained in:
parent
89e77a43cc
commit
ec3336550d
4 changed files with 576 additions and 1 deletions
90
tools/video/README.md
Normal file
90
tools/video/README.md
Normal file
|
|
@ -0,0 +1,90 @@
|
|||
# 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.
|
||||
Loading…
Add table
Add a link
Reference in a new issue