Sur cette page

QWaylandSurfaceGrabber Class

La classe `QWaylandSurfaceGrabber` permet de lire le contenu d'une surface ` QWaylandSurface`. En savoir plus...

En-tête : #include <QWaylandSurfaceGrabber>
CMake : find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)
target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor)
qmake : QT += waylandcompositor
Hérite de : QObject

Types publics

enum Error { InvalidSurface, NoBufferAttached, UnknownBufferType, RendererNotReady }

Fonctions publiques

QWaylandSurfaceGrabber(QWaylandSurface *surface, QObject *parent = nullptr)
void grab()
QWaylandSurface *surface() const

Description détaillée

Il est parfois nécessaire d'obtenir le contenu d'une surface, par exemple pour fournir une capture d'écran à l'utilisateur. La classe QWaylandSurfaceGrabber fournit une méthode simple pour y parvenir, sans avoir à se soucier du type de tampon sous-jacent à la surface, qu'il s'agisse de mémoire partagée, d'OpenGL ou d'autre chose.

Documentation sur les types de membres

enum QWaylandSurfaceGrabber::Error

L'énumération « Error » décrit la cause d'un échec de capture.

ConstanteValeurDescription
QWaylandSurfaceGrabber::InvalidSurface0La surface est nulle ou non valide.
QWaylandSurfaceGrabber::NoBufferAttached1Le client n’a pas encore associé de tampon à la surface.
QWaylandSurfaceGrabber::UnknownBufferType2Le tampon associé à la surface est d’un type inconnu.
QWaylandSurfaceGrabber::RendererNotReady3Le moteur de rendu du compositeur n'est pas prêt à récupérer le contenu de la surface.

Documentation des fonctions membres

[explicit] QWaylandSurfaceGrabber::QWaylandSurfaceGrabber(QWaylandSurface *surface, QObject *parent = nullptr)

Créez un objet QWaylandSurfaceGrabber avec l'surface on fournie et parent

void QWaylandSurfaceGrabber::grab()

Récupérez le contenu de l'ensemble de surfaces associé à cet objet. Cette opération pouvant ne pas être possible immédiatement, il convient d'utiliser les signaux « success » et « failed » pour être averti lorsque la récupération est terminée.

QWaylandSurface *QWaylandSurfaceGrabber::surface() const

Renvoie l'ensemble des surfaces associées à cet objet

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.