QWindowCapture Class

Ausführliche Beschreibung

Die Klasse erfasst ein Fenster. Sie wird von der Klasse „ QMediaCaptureSession “ verwaltet, wo das erfasste Fenster in einem Video-Vorschau-Objekt angezeigt oder in eine Datei aufgezeichnet werden kann.

Der folgende Codeausschnitt zeigt, wie man eines der erfassbaren Fenster auswählt und das Ergebnis in einem „ QVideoWidget “ anzeigt:

QMediaCaptureSession session;
QWindowCapture windowCapture;
session.setWindowCapture(&windowCapture);

QVideoWidget videoWidget;
session.setVideoOutput(&videoWidget);
videoWidget.show();

// A window must be selected before capturing can start.
const QList<QCapturableWindow> windows = QWindowCapture::capturableWindows();
if (!windows.isEmpty()) {
    windowCapture.setWindow(windows.first());
    windowCapture.start();
}

Einschränkungen bei der Fenstererfassung

Für die Verwendung von `QWindowCapture` gelten folgende Einschränkungen:

• QWindowCapture wird nur mit dem FFmpeg-Backend unterstützt.
• Auf einigen Plattformen werden keine neuen Videobilder ausgegeben, solange der Inhalt des erfassten Fensters unverändert bleibt. Anwendungen sollten sich daher nicht darauf verlassen, einen kontinuierlichen Bildstrom mit der angeforderten Bildrate zu erhalten.

Bei der Verwendung von „ QWindowCapture “ auf X11-Systemen gelten die folgenden Einschränkungen:

• Auf Linux-X11-Systemen wird, wenn ein Fenster teilweise außerhalb des sichtbaren Bildschirmbereichs verschoben wird, nur der sichtbare Bereich erfasst. Infolgedessen können die ausgegebenen Videobilder eine geringere Größe als die Geometrie des Fensters haben.
• Fenster, die sich außerhalb des sichtbaren Bildschirmbereichs befinden, können nicht erfasst werden; in diesem Fall wird ein Fehlersignal ausgegeben.
• Das Verhalten minimierter Fenster oder solcher, die sich auf einem unsichtbaren virtuellen Arbeitsbereich befinden, hängt vom Fenstermanager ab. Beispielsweise können solche Fenster unter GNOME erfasst werden, während dies unter WindowMaker oder Xfwm nicht zulässig ist und die Fenstererfassungsinstanz einen Fehler ausgibt.