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:
torsten 2026-11-13 16:37:48 +01:00
parent 89e77a43cc
commit ec3336550d
4 changed files with 576 additions and 1 deletions

View file

@ -12,7 +12,8 @@ Workbench-Archiv; das Repo enthält die Skripte und die Dokumentation.
- Das Produktions-Rig:
`workbench/source/characters/skater/skater_rig_v008.blend` (Rig der
jeweils aktiven Figur, siehe `docs/assets.md`).
- Für den synthetischen Testfilm: `ffmpeg`.
- `ffmpeg` zum Sichten und Schneiden der Referenzclips
(siehe `tools/video/README.md`).
- Für den FTP-Upload: `docs/credentials.txt` wie beim Asset-Sync.
Der Default ist nur die **Quelldatei für neue Arbeitsdateien**. Das
@ -51,6 +52,21 @@ Die Kamera steht standardmäßig auf einer ganzen-Rink-Ansicht
(28 mm, 55 m entfernt). Für eine Nahaufnahme die Kamera näher an den
Skater schieben; das `CameraTarget` bleibt der Blickpunkt.
## Referenz vorbereiten
Lange Aufnahmen werden vor dem Rotoscoping geschnitten und verkleinert. Die
beiden Skripte dafür liegen in `tools/video/`, die Kurzanleitung daneben:
```bash
tools/video/cut_video.py DJI_0002.MP4 0:16 0:32
tools/video/downsample.py DJI_0002__cutted_16_32.mp4 24
```
Ein Clip zeigt eine Bewegung; 1920 × 1280 bei 24 fps reichen für die
Blender-Vorschau. Die Suche nach dem passenden Zeitfenster (Kontaktabzüge,
Figurengröße je Take) übernehmen `scan_takes.py` und `window_scan.py` aus der
Werkbank.
## Referenz laden
```bash