QWaylandBufferRef Class

成员函数文档

QWaylandBufferRef::QWaylandBufferRef()

构造一个空缓冲区 ref。

QWaylandBufferRef::QWaylandBufferRef(const QWaylandBufferRef &ref)

为ref 引用的缓冲区创建新引用。

[noexcept] QWaylandBufferRef::~QWaylandBufferRef()

取消引用缓冲区。

bool QWaylandBufferRef::hasBuffer() const

如果QWaylandBufferRef 引用了缓冲区，则返回 true。否则返回 false。

另请参阅 isNull() 和hasContent()。

bool QWaylandBufferRef::hasContent() const

如果QWaylandBufferRef 引用了有内容的缓冲区，则返回 true。否则返回 false。

另请参阅 isNull() 和hasBuffer()。

[since 6.2] bool QWaylandBufferRef::hasProtectedContent() const

如果QWaylandBufferRef 引用了具有受保护内容的缓冲区，则返回 true。否则返回 false。

此函数在 Qt 6.2 中引入。

另请参阅 hasContent()。

QImage QWaylandBufferRef::image() const

返回包含缓冲区内容的图像。

bool QWaylandBufferRef::isDestroyed() const

如果QWaylandBufferRef 引用的缓冲区已被销毁，则返回 true。否则返回 false。

bool QWaylandBufferRef::isNull() const

如果QWaylandBufferRef 未引用缓冲区，则返回 true。否则返回 false。

另请参阅 hasBuffer() 和hasContent()。

bool QWaylandBufferRef::isSharedMemory() const

如果缓冲区是共享内存缓冲区，则返回 true。否则返回 false。

quintptr QWaylandBufferRef::lockNativeBuffer()

返回此缓冲区的本地句柄，并将其标记为锁定状态，直到调用unlockNativeBuffer() 时才会释放。

如果缓冲区没有本地句柄，或锁定不成功，则返回 0。

QWaylandSurface::Origin QWaylandBufferRef::origin() const

返回缓冲区的原点。如果引用的缓冲区为空，则返回QWaylandSurface::OriginBottomLeft 。

QSize QWaylandBufferRef::size() const

返回缓冲区的大小。如果引用的缓冲区为空，则返回无效的 QSize()。

QOpenGLTexture *QWaylandBufferRef::toOpenGLTexture(int plane = 0) const

plane 是多平面格式（如 YUV）的索引。

返回的纹理归缓冲区所有。只要缓冲区引用存在，纹理就一直有效。此函数的调用者不得删除纹理，只要纹理还在使用，就必须保留对缓冲区的引用。

如果没有有效的缓冲区，或无法创建纹理，则返回nullptr 。

void QWaylandBufferRef::unlockNativeBuffer(quintptr handle)

将本地缓冲区标记为不再使用。handle 必须与之前调用lockNativeBuffer() 返回的值一致。

struct wl_resource *QWaylandBufferRef::wl_buffer() const

返回缓冲区的 Wayland 资源。

QWaylandBufferRef &QWaylandBufferRef::operator=(const QWaylandBufferRef &ref)

将ref 赋值给该缓冲区，并为其添加一个引用。之前引用的缓冲区将被取消引用。