QWaylandBufferRef Class
Die Klasse „QWaylandBufferRef“ enthält einen Verweis auf einen Oberflächenpuffer. Mehr...
| Header: | #include <QWaylandBufferRef> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor) target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor) |
| qmake: | QT += waylandcompositor |
Öffentliche Funktionen
| 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) |
Zugehörige Nicht-Mitglieder
| bool | operator!=(const QWaylandBufferRef &lhs, const QWaylandBufferRef &rhs) |
| bool | operator==(const QWaylandBufferRef &lhs, const QWaylandBufferRef &rhs) |
Ausführliche Beschreibung
Diese Klasse kann verwendet werden, um auf einen Oberflächenpuffer zu verweisen. Solange ein Verweis auf den Puffer besteht, gehört dieser dem Compositor und kann vom Client nicht geändert werden.
Dokumentation der Mitgliedsfunktionen
QWaylandBufferRef::QWaylandBufferRef()
Erstellt eine Null-Puffer-Referenz.
QWaylandBufferRef::QWaylandBufferRef(const QWaylandBufferRef &ref)
Erstellt eine neue Referenz auf den Puffer, auf den „ ref “ verweist.
[noexcept] QWaylandBufferRef::~QWaylandBufferRef()
Hebt die Referenz auf den Puffer auf.
bool QWaylandBufferRef::hasBuffer() const
Gibt „true“ zurück, wenn dieses ` QWaylandBufferRef ` auf einen Puffer verweist. Andernfalls wird „false“ zurückgegeben.
Siehe auch „ isNull()“ und „ hasContent()“.
bool QWaylandBufferRef::hasContent() const
Gibt „true“ zurück, wenn dieses ` QWaylandBufferRef ` auf einen Puffer verweist, der Inhalt enthält. Andernfalls wird „false“ zurückgegeben.
Siehe auch ` isNull()` und ` hasBuffer()`.
[since 6.2] bool QWaylandBufferRef::hasProtectedContent() const
Gibt „true“ zurück, wenn dieser „ QWaylandBufferRef “ auf einen Puffer verweist, der geschützte Inhalte enthält. Andernfalls wird „false“ zurückgegeben.
Hinweis: Hierbei handelt es sich um einen Aktivierungsmechanismus, der die Unterstützung durch die Client-Puffer-Integration voraussetzt. Derzeit unterstützt keine der in Qt enthaltenen Client-Puffer-Integrationen Puffer mit geschützten Inhalten.
Diese Funktion wurde in Qt 6.2 eingeführt.
Siehe auch „ hasContent()“.
QImage QWaylandBufferRef::image() const
Gibt ein Bild mit dem Inhalt des Puffers zurück.
bool QWaylandBufferRef::isDestroyed() const
Gibt „true“ zurück, wenn diese ` QWaylandBufferRef ` auf einen Puffer verweist, der zerstört wurde. Andernfalls wird „false“ zurückgegeben.
bool QWaylandBufferRef::isNull() const
Gibt „true“ zurück, wenn dieses „ QWaylandBufferRef “ nicht auf einen Puffer verweist. Andernfalls wird „false“ zurückgegeben.
Siehe auch ` hasBuffer()` und ` hasContent()`.
bool QWaylandBufferRef::isSharedMemory() const
Gibt „true“ zurück, wenn es sich bei dem Puffer um einen Shared-Memory-Puffer handelt. Andernfalls wird „false“ zurückgegeben.
quintptr QWaylandBufferRef::lockNativeBuffer()
Gibt das native Handle für diesen Puffer zurück und markiert ihn als gesperrt, sodass er erst freigegeben wird, wenn „ unlockNativeBuffer()“ aufgerufen wird.
Gibt 0 zurück, wenn kein natives Handle für diesen Puffer vorhanden ist oder wenn die Sperrung fehlgeschlagen ist.
QWaylandSurface::Origin QWaylandBufferRef::origin() const
Gibt den Ursprung des Puffers zurück. Ist der referenzierte Puffer null, wird „ QWaylandSurface::OriginBottomLeft “ zurückgegeben.
QSize QWaylandBufferRef::size() const
Gibt die Größe des Puffers zurück. Ist der referenzierte Puffer null, wird ein ungültiger QSize()-Wert zurückgegeben.
QOpenGLTexture *QWaylandBufferRef::toOpenGLTexture(int plane = 0) const
Gibt eine OpenGL-Textur für den Puffer zurück. ` plane ` ist der Index für Multi-Plane-Formate wie beispielsweise YUV.
Die zurückgegebene Textur gehört dem Puffer. Die Textur ist nur so lange gültig, wie die Pufferreferenz existiert. Der Aufrufer dieser Funktion darf die Textur nicht löschen und muss eine Referenz auf den Puffer beibehalten, solange die Textur verwendet wird.
Gibt ` nullptr ` zurück, wenn kein gültiger Puffer vorhanden ist oder wenn keine Textur erstellt werden kann.
void QWaylandBufferRef::unlockNativeBuffer(quintptr handle)
Markiert den nativen Puffer als nicht mehr in Gebrauch. ` handle ` muss mit dem Wert übereinstimmen, der von einem vorherigen Aufruf von ` lockNativeBuffer()` zurückgegeben wurde.
struct wl_resource *QWaylandBufferRef::wl_buffer() const
Gibt die Wayland-Ressource für den Puffer zurück.
QWaylandBufferRef &QWaylandBufferRef::operator=(const QWaylandBufferRef &ref)
Weist diesem Puffer die Adresse „ ref “ zu und fügt einen Verweis darauf hinzu. Der zuvor referenzierte Puffer wird entreferenziert.
Verwandte Nicht-Mitglieder
[noexcept] bool operator!=(const QWaylandBufferRef &lhs, const QWaylandBufferRef &rhs)
Gibt „ false “ zurück, wenn „ lhs “ auf denselben Puffer verweist wie „ rhs “. Andernfalls wird „ true “ zurückgegeben.
[noexcept] bool operator==(const QWaylandBufferRef &lhs, const QWaylandBufferRef &rhs)
Gibt „ true “ zurück, wenn „ lhs “ auf denselben Puffer verweist wie „ rhs “. Andernfalls wird „ false “ zurückgegeben.
© 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.