> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/german/funktionsblocke/blocks-reference/input-output/outputs-exports/record-video.md).

# Record Video

Dieser Funktionsblock speichert eingehende Bildframes in einer Videodatei. Du kannst die Aufnahme mit einem booleschen Trigger starten/stoppen oder die eingebaute Spacebar-Auslösung verwenden. Es gibt mehrere Qualitätsmodi, einschließlich einer hochkomprimierenden Option, die ffmpeg verwendet, falls installiert.

## 📥 Eingänge <a href="#inputs" id="inputs"></a>

`Frame` Die Eingangsbilder (Frames), die aufgezeichnet werden sollen.

`Record` Boolescher Steuerwert zum Starten/Stoppen der Aufnahme (abhängig vom gewählten Auslösemodus verwendet).

`Folder Path` Der Ordner, in dem die aufgezeichneten Videos gespeichert werden.

`File Name (no extension)` Optionaler Dateiname-Basis. Wird dieses Feld leer gelassen, wird ein Zeitstempel verwendet.

## 📤 Ausgänge <a href="#outputs" id="outputs"></a>

Dieser Funktionsblock liefert keine Ausgänge.

## 🕹️ Steuerungen <a href="#controls" id="controls"></a>

`Video Quality` Wähle zwischen Qualitätsmodi:

* `Compressed` kleinere Dateien, schnell.
* `High Quality` weniger Kompression, bessere Bildqualität.
* `High-Compress(requires ffmpeg)` beste Kompression, erfordert aber ffmpeg auf dem System.

`Trigger Mode` Wähle, wie die Aufnahme gestartet/gestoppt wird:

* `Spacebar` Drücke die Leertaste zum Umschalten Start/Stop (erfordert ggf. Verfügbarkeit eines Keyboard-Hooks auf deinem OS).
* `Continuous` TRUE starten, FALSE stoppen.
* `Once` Ein ansteigendes TRUE startet die Aufnahme, ein weiteres TRUE stoppt und speichert.

`Recording` LED-Anzeige, die zeigt, ob gerade aufgenommen wird.

## 🎯 Hauptfunktionen <a href="#features" id="features"></a>

* Start/Stop der Aufnahme mit drei Auslösemodi (Spacebar, Continuous, Once).
* Mehrere Qualitätsmodi, einschließlich einer optionalen ffmpeg-basierten Hochkompression.
* Automatische Auswahl verfügbarer Video-Codecs und Container für bessere Portabilität.
* Verhindert Öffnen der Videodatei während der Aufnahme (um Datei-Konflikte zu vermeiden).
* Hintergrundkonvertierung für den High-Compress-Modus, sodass die Kompression die Echtzeitaufnahme nicht blockiert (erfordert ffmpeg).

## 📝 Verwendung <a href="#usage" id="usage"></a>

1. Versorge das Feld `Frame` mit Bildframes (z. B. von `Camera USB`, `Camera IP (ONVIF)` oder `Stream Reader`).
2. Lege den `Folder Path` fest, in dem die Videos gespeichert werden sollen.
3. Optional: Trage einen `File Name (no extension)` ein oder lasse das Feld leer, damit ein Zeitstempel verwendet wird.
4. Wähle die gewünschte `Video Quality`. Für kleinste Dateien und höchste Kompression wähle den High-Compress-Modus und stelle sicher, dass ffmpeg installiert ist.
5. Wähle den `Trigger Mode`:
   * Für schnelle Tastatursteuerung nutze `Spacebar` (funktioniert, wenn vom OS erlaubt).
   * Für programmatische Steuerung nutze `Continuous` oder `Once` und speise boolesche Werte in `Record` ein.
6. Starte die Aufnahme gemäß dem gewählten Auslösemodus. Die `Recording`-LED leuchtet während der Aufnahme.
7. Stoppe die Aufnahme und lasse den Block die Videodatei finalisieren. Wenn High-Compress gewählt wurde, kann die finale Kompression im Hintergrund laufen.

## 📊 Verhalten während der Ausführung <a href="#evaluation" id="evaluation"></a>

* Während der Aufnahme werden eingehende Frames aus `Frame` an die offene Videodatei angehängt.
* Beim Stoppen wird die Datei geschlossen. Falls der High-Compress-Modus gewählt wurde und ffmpeg vorhanden ist, kann eine optionale Hintergrundkonvertierung gestartet werden, um eine kleinere, hochkomprimierte Datei zu erzeugen.
* Wenn der Spacebar-Trigger nicht verfügbar ist (z. B. bei manchen Linux-Setups ohne Root-Rechte), warnt der Block und du kannst stattdessen die Modi `Continuous` oder `Once` verwenden.

## 💡 Tipps und Tricks <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Um von einer lokalen Kamera aufzuzeichnen, verbinde `Camera USB` oder `Camera USB External` mit dem Eingang `Frame`.
* Für Netzwerk-Kameras nutze `Camera IP (ONVIF)` oder `Stream Reader` als Quelle für ein stabileres Hintergrund-Frame-Fetching.
* Zeige Frames live an, indem du dieselbe Quelle parallel an den `Show Image`-Block sendest.
* Speichere einzelne Frames zur Inspektion parallel mit `Image Logger` oder `Image Write`, während der Block das Video aufzeichnet.
* Starte die Aufnahme automatisch, wenn etwas Wichtiges erscheint, indem du Erkennungsblöcke (z. B. `Object Detection` oder `Mask Detection`) mit einer Logik verbindest, die das `Record`-Eingangssignal steuert.
* Verwende `Keyboard/Barcode Reader`, wenn du komplexere Tastatur- oder externe Eingaben als Trigger über das `Record`-Eingangssignal brauchst.
* Wenn du niedrigen Speicherbedarf bei guter Qualität möchtest, wähle `High-Compress(requires ffmpeg)` und installiere ffmpeg im System-PATH.

## 🛠️ Fehlersuche <a href="#troubleshooting" id="troubleshooting"></a>

* Spacebar-Trigger funktioniert unter Linux nicht: Starte Studio mit erhöhten Rechten (oder verwende `Continuous`/`Once`).
* Kompression nicht verfügbar: Stelle sicher, dass ffmpeg installiert und im System-PATH zugänglich ist, um den High-Compress-Modus zu aktivieren. Fehlt ffmpeg, fällt der Block auf einen nicht-ffmpeg-Modus zurück und warnt dich.
* Datei in Verwendung während der Aufnahme: Die Videodatei kann während der Aufnahme nicht von anderen Anwendungen geöffnet werden. Warte, bis die Aufnahme beendet ist.
* Keine Frames gespeichert: Überprüfe, ob die Quelle am Feld `Frame` gültige Bilder liefert (Voransicht mit `Show Image` kann helfen).