QWindowCapture Class

Description détaillée

La classe capture une fenêtre. Elle est gérée par la classe QMediaCaptureSession, qui permet d'afficher la fenêtre capturée dans un objet de prévisualisation vidéo ou de l'enregistrer dans un fichier.

L'extrait de code suivant montre comment sélectionner l'une des fenêtres pouvant être capturées et afficher le résultat dans une instance de ` QVideoWidget` :

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();
}

Limitations de la capture de fenêtre

Les limitations suivantes s'appliquent à l'utilisation de QWindowCapture :

• QWindowCapture n’est pris en charge qu’avec le backend FFmpeg.
• Sur certaines plateformes, aucune nouvelle image vidéo n’est émise tant que le contenu de la fenêtre capturée reste inchangé. Les applications ne doivent donc pas compter sur la réception d’un flux continu d’images à la fréquence d’images demandée.

Les limitations suivantes s’appliquent lors de l’utilisation d’ QWindowCapture sur les systèmes X11 :

• Sur les systèmes Linux X11, lorsqu’une fenêtre est déplacée partiellement en dehors de la zone visible de l’écran, seule la région visible est capturée. Par conséquent, les images vidéo émises peuvent avoir une taille inférieure à la géométrie de la fenêtre.
• Les fenêtres situées en dehors de la zone visible de l’écran ne peuvent pas être capturées, et un signal d’erreur est émis dans ce cas.
• Le comportement des fenêtres minimisées ou situées sur un espace de travail virtuel invisible dépend du gestionnaire de fenêtres. Par exemple, ces fenêtres peuvent être capturées sous GNOME, tandis que sous WindowMaker ou Xfwm, cette capture n’est pas autorisée et l’instance de capture de fenêtre génère une erreur.