QWaylandBufferRef 类

QWaylandBufferRef class holds the reference to a surface buffer 更多...

头: #include <QWaylandBufferRef>
qmake: QT += waylandcompositor
Since: Qt 5.8

公共类型

enum BufferFormatEgl { BufferFormatEgl_Null, BufferFormatEgl_RGB, BufferFormatEgl_RGBA, BufferFormatEgl_EXTERNAL_OES, ..., BufferFormatEgl_Y_XUXV }
enum BufferType { BufferType_Null, BufferType_SharedMemory, BufferType_Egl }

公共函数

QWaylandBufferRef ()
QWaylandBufferRef (const QWaylandBufferRef & ref )
~QWaylandBufferRef ()
BufferFormatEgl bufferFormatEgl () const
BufferType bufferType () const
bool hasBuffer () const
bool hasContent () 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 )
bool operator!= (const QWaylandBufferRef & ref )
QWaylandBufferRef & operator= (const QWaylandBufferRef & ref )
bool operator== (const QWaylandBufferRef & ref )

详细描述

QWaylandBufferRef class holds the reference to a surface buffer

This class can be used to reference a surface buffer. As long as a reference to the buffer exists, it is owned by the compositor and the client cannot modify it.

成员类型文档编制

enum QWaylandBufferRef:: BufferFormatEgl

enum QWaylandBufferRef:: BufferType

成员函数文档编制

QWaylandBufferRef:: QWaylandBufferRef ()

构造 null 缓冲 ref 引用。

QWaylandBufferRef:: QWaylandBufferRef (const QWaylandBufferRef & ref )

Creates a new reference to the buffer referenced by ref .

QWaylandBufferRef:: ~QWaylandBufferRef ()

解引用缓冲。

BufferFormatEgl QWaylandBufferRef:: bufferFormatEgl () const

BufferType QWaylandBufferRef:: bufferType () const

bool QWaylandBufferRef:: hasBuffer () const

返回 true,若此 QWaylandBufferRef 引用缓冲。否则返回 false。

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

bool QWaylandBufferRef:: hasContent () const

返回 true,若此 QWaylandBufferRef references a buffer that has content. Otherwise returns false.

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

QImage QWaylandBufferRef:: image () const

Returns an image with the contents of the buffer.

bool QWaylandBufferRef:: isDestroyed () const

返回 true,若此 QWaylandBufferRef references a buffer that has been destroyed. Otherwise returns false.

bool QWaylandBufferRef:: isNull () const

返回 true,若此 QWaylandBufferRef does not reference a buffer. Otherwise returns false.

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

bool QWaylandBufferRef:: isSharedMemory () const

Returns true if the buffer is a shared memory buffer. Otherwise returns false.

quintptr QWaylandBufferRef:: lockNativeBuffer ()

Returns the native handle for this buffer, and marks it as locked so it will not be released until unlockNativeBuffer () 被调用。

Returns 0 if there is no native handle for this buffer, or if the lock was unsuccessful.

QWaylandSurface::Origin QWaylandBufferRef:: origin () const

Returns the origin of the buffer. If the buffer referenced is null, QWaylandSurface::OriginBottomLeft 被返回。

QSize QWaylandBufferRef:: size () const

Returns the size of the buffer. If the buffer referenced is null, an invalid QSize() is returned.

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

Returns an OpenGL texture for the buffer. plane is the index for multi-plane formats, such as YUV.

The returned texture is owned by the buffer. The texture is only valid for as long as the buffer reference exists. The caller of this function must not delete the texture, and must keep a reference to the buffer for as long as the texture is being used.

返回 nullptr if there is no valid buffer, or if no texture can be created.

void QWaylandBufferRef:: unlockNativeBuffer ( quintptr handle )

Marks the native buffer as no longer in use. handle must correspond to the value returned by a previous call to lockNativeBuffer ().

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

返回 false,若此 QWaylandBufferRef 引用相同缓冲如 ref 。否则返回 true。

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

赋值 ref to this buffer and adds a reference to it. The previously referenced buffer is dereferenced.

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

返回 true,若此 QWaylandBufferRef 引用相同缓冲如 ref 。否则返回 false。