QWaylandBufferRef Class
La classe QWaylandBufferRef contient la référence à un tampon de surface. Plus d'informations...
| En-tête : | #include <QWaylandBufferRef> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor) |
| qmake : | QT += waylandcompositor |
Fonctions publiques
| QWaylandBufferRef() | |
| QWaylandBufferRef(const QWaylandBufferRef &ref) | |
| ~QWaylandBufferRef() | |
| bool | hasBuffer() const |
| bool | hasContent() const |
(since 6.2) bool | hasProtectedContent() const |
| QImage | image() const |
| bool | isDestroyed() const |
| bool | isNull() const |
| bool | isSharedMemory() const |
| quintptr | lockNativeBuffer() |
| QWaylandSurface::Origin | origin() const |
| QSize | size() const |
| QOpenGLTexture * | toOpenGLTexture(int plane = 0) const |
| void | unlockNativeBuffer(quintptr handle) |
| struct wl_resource * | wl_buffer() const |
| QWaylandBufferRef & | operator=(const QWaylandBufferRef &ref) |
Non-membres apparentés
| bool | operator!=(const QWaylandBufferRef &lhs, const QWaylandBufferRef &rhs) |
| bool | operator==(const QWaylandBufferRef &lhs, const QWaylandBufferRef &rhs) |
Description détaillée
Cette classe peut être utilisée pour référencer un tampon de surface. Tant qu'une référence au tampon existe, il appartient au compositeur et le client ne peut pas le modifier.
Documentation des fonctions membres
QWaylandBufferRef::QWaylandBufferRef()
Construit un tampon null ref.
QWaylandBufferRef::QWaylandBufferRef(const QWaylandBufferRef &ref)
Crée une nouvelle référence au tampon référencé par ref.
[noexcept] QWaylandBufferRef::~QWaylandBufferRef()
Déréférence le tampon.
bool QWaylandBufferRef::hasBuffer() const
Retourne vrai si cette QWaylandBufferRef fait référence à un tampon. Sinon, il renvoie false.
Voir aussi isNull() et hasContent().
bool QWaylandBufferRef::hasContent() const
Retourne vrai si cette QWaylandBufferRef fait référence à un tampon qui a un contenu. Sinon, il renvoie false.
Voir aussi isNull() et hasBuffer().
[since 6.2] bool QWaylandBufferRef::hasProtectedContent() const
Retourne vrai si cette QWaylandBufferRef fait référence à un tampon dont le contenu est protégé. Sinon, il renvoie false.
Remarque : il s'agit d'un activateur qui suppose une prise en charge dans l'intégration de la mémoire tampon du client. Aucune des intégrations de tampons clients incluses dans Qt ne prend actuellement en charge les tampons à contenu protégé.
Cette fonction a été introduite dans Qt 6.2.
Voir aussi hasContent().
QImage QWaylandBufferRef::image() const
Renvoie une image contenant le contenu du tampon.
bool QWaylandBufferRef::isDestroyed() const
Retourne vrai si ce QWaylandBufferRef fait référence à un tampon qui a été détruit. Sinon, il renvoie false.
bool QWaylandBufferRef::isNull() const
Retourne vrai si cette adresse QWaylandBufferRef ne fait pas référence à un tampon. Sinon, il renvoie false.
Voir aussi hasBuffer() et hasContent().
bool QWaylandBufferRef::isSharedMemory() const
Retourne vrai si le tampon est un tampon à mémoire partagée. Dans le cas contraire, il renvoie la valeur false.
quintptr QWaylandBufferRef::lockNativeBuffer()
Renvoie l'identifiant natif de ce tampon et le marque comme verrouillé pour qu'il ne soit pas libéré avant que unlockNativeBuffer() ne soit appelé.
Renvoie 0 s'il n'y a pas d'identifiant natif pour ce tampon, ou si le verrouillage a échoué.
QWaylandSurface::Origin QWaylandBufferRef::origin() const
Renvoie l'origine du tampon. Si le tampon référencé est nul, QWaylandSurface::OriginBottomLeft est renvoyé.
QSize QWaylandBufferRef::size() const
Renvoie la taille du tampon. Si le tampon référencé est nul, une QSize() invalide est renvoyée.
QOpenGLTexture *QWaylandBufferRef::toOpenGLTexture(int plane = 0) const
Renvoie une texture OpenGL pour le tampon. plane est l'index pour les formats multi-plans, tels que YUV.
La texture renvoyée appartient au tampon. La texture n'est valide que tant que la référence au tampon existe. L'appelant de cette fonction ne doit pas supprimer la texture et doit conserver une référence au tampon tant que la texture est utilisée.
Retourne nullptr s'il n'y a pas de tampon valide ou si aucune texture ne peut être créée.
void QWaylandBufferRef::unlockNativeBuffer(quintptr handle)
Marque le tampon natif comme n'étant plus utilisé. handle doit correspondre à la valeur renvoyée par un appel précédent à lockNativeBuffer().
struct wl_resource *QWaylandBufferRef::wl_buffer() const
Renvoie la ressource Wayland pour le tampon.
QWaylandBufferRef &QWaylandBufferRef::operator=(const QWaylandBufferRef &ref)
Attribue ref à ce tampon et y ajoute une référence. Le tampon précédemment référencé est déréférencé.
Non-membres apparentés
[noexcept] bool operator!=(const QWaylandBufferRef &lhs, const QWaylandBufferRef &rhs)
Renvoie false si lhs fait référence au même tampon que rhs. Sinon, il renvoie true.
[noexcept] bool operator==(const QWaylandBufferRef &lhs, const QWaylandBufferRef &rhs)
Renvoie true si lhs fait référence au même tampon que rhs. Sinon, il renvoie false.
© 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.