WindowCapture QML Type

Dieser Typ wird zum Erfassen eines Fensters verwendet. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• active : bool
• error : enumeration
• errorString : string
• window : Window

Methoden

• list<CapturableWindow> capturableWindows()
• void start()
• void stop()

Detaillierte Beschreibung

WindowCapture nimmt ein Fenster auf. Es wird von MediaCaptureSession verwaltet, wo das erfasste Fenster in einem Videovorschauobjekt angezeigt oder in einer Datei aufgezeichnet werden kann.

Einschränkungen für WindowCapture

Die folgenden Einschränkungen gelten für die Verwendung von WindowCapture:

• WindowCapture wird nur mit dem FFmpeg-Backend unterstützt.

Die folgenden Einschränkungen gelten bei der Verwendung von QWindowCapture auf X11-Systemen:

• Wenn auf Linux X11-Systemen ein Fenster teilweise außerhalb des sichtbaren Bildschirmbereichs verschoben wird, wird nur der sichtbare Bereich aufgezeichnet. Daher kann es vorkommen, dass die Größe der ausgegebenen Videobilder kleiner ist als die Geometrie des Fensters.
• Fenster, die außerhalb des sichtbaren Bildschirmbereichs liegen, können nicht erfasst werden, und in diesem Fall wird ein Fehlersignal ausgegeben.
• Das Verhalten von minimierten Fenstern oder solchen, die sich auf einer unsichtbaren virtuellen Arbeitsfläche befinden, hängt vom Fenstermanager ab. Beispielsweise können solche Fenster unter GNOME erfasst werden, während unter WindowMaker oder Xfwm ein solches Erfassen nicht erlaubt ist und die Fenstererfassungsinstanz einen Fehler ausgibt.

Siehe auch CaptureSession und CapturableWindow.

Dokumentation der Eigenschaften

active : bool

Beschreibt, ob die Aufzeichnung gerade aktiv ist.

error : enumeration [read-only]

Gibt einen Code für den letzten Fehler zurück.

errorString : string [read-only]

Gibt eine von Menschen lesbare Zeichenfolge zurück, die die Fehlerursache beschreibt.

window : Window

Beschreibt das Fenster zum Erfassen.

Siehe auch QtMultimedia::WindowCapture::capturableWindows.

Methode Dokumentation

list<CapturableWindow> capturableWindows()

Gibt eine Liste von CapturableWindow Objekten zurück, die für die Erfassung verfügbar sind.

void start()

Startet die Erfassung der window.

Dies ist gleichbedeutend mit der Einstellung der Eigenschaft active auf true.

void stop()

Beendet die Aufzeichnung.

Dies entspricht der Einstellung der Eigenschaft active auf false.