QOpenGLBuffer Class

成员函数文档

QOpenGLBuffer::QOpenGLBuffer()

构造一个类型为QOpenGLBuffer::VertexBuffer 的新缓冲区对象。

注意：该构造函数只是创建 QOpenGLBuffer 实例。OpenGL 服务器中的实际缓冲区对象要到调用create() 时才会创建。

另请参阅 create() 。

[explicit] QOpenGLBuffer::QOpenGLBuffer(QOpenGLBuffer::Type type)

构造一个type 的新缓冲区对象。

注意：此构造函数只是创建 QOpenGLBuffer 实例。OpenGL 服务器中的实际缓冲区对象要到调用create() 时才会创建。

另请参阅 create() 。

QOpenGLBuffer::QOpenGLBuffer(const QOpenGLBuffer &other)

构造other 的浅层副本。

注意：QOpenGLBuffer 没有实现写入时复制语义，因此只要修改副本，other 就会受到影响。

[noexcept, since 6.5] QOpenGLBuffer::QOpenGLBuffer(QOpenGLBuffer &&other)

Move- 从other 构建一个新的 QOpenGLBuffer。

此函数在 Qt 6.5 中引入。

[noexcept] QOpenGLBuffer::~QOpenGLBuffer()

销毁此缓冲对象，包括 OpenGL 服务器中正在使用的存储空间。

void QOpenGLBuffer::allocate(const void *data, int count)

为缓冲区分配count 字节的空间，初始化为data 的内容。之前的内容将被删除。

假定create() 已在此缓冲区上调用过，且已绑定到当前上下文。

另请参阅 create()、read() 和write()。

void QOpenGLBuffer::allocate(int count)

这是一个重载函数。

为缓冲区分配count 字节的空间。之前的内容将被删除。

假定create() 已在此缓冲区上调用过，且已与当前上下文绑定。

另请参阅 create() 和write()。

bool QOpenGLBuffer::bind()

将与此对象关联的缓冲区绑定到当前 OpenGL 上下文。如果无法绑定，则返回false ，通常是因为该 OpenGL 实现不支持type()。

缓冲区必须绑定到调用create() 时的同一个QOpenGLContext 或与之共享的另一个QOpenGLContext 。否则，此函数将返回 false。

另请参阅 release() 和create()。

GLuint QOpenGLBuffer::bufferId() const

返回与此缓冲区相关的 OpenGL 标识符；如果缓冲区尚未创建，则返回 0。

另请参阅 isCreated().

bool QOpenGLBuffer::create()

在 OpenGL 服务器中创建缓冲区对象。如果对象已创建，则返回true ；否则返回 false。

调用此函数时必须使用当前QOpenGLContext 。缓冲区将绑定到该上下文（或与其共享的任何其他上下文），且只能在该上下文中使用。

如果 OpenGL 实现不支持缓冲区，或当前没有QOpenGLContext ，则此函数将返回 false。

另请参阅 isCreated(),allocate(),write() 和destroy().

void QOpenGLBuffer::destroy()

销毁此缓冲对象，包括 OpenGL 服务器中使用的存储空间。所有对缓冲区的引用都将失效。

bool QOpenGLBuffer::isCreated() const

如果缓冲区已创建，则返回true ；否则返回 false。

另请参阅 create() 和destroy() 。

void *QOpenGLBuffer::map(QOpenGLBuffer::Access access)

将此缓冲区的内容映射到应用程序的内存空间，并返回一个指针。如果无法进行内存映射，则返回空值。access 参数指示要执行的访问类型。

假定已在此缓冲区上调用create() 并将其绑定到当前上下文。

另请参阅 unmap()、create()、bind() 和mapRange()。

void *QOpenGLBuffer::mapRange(int offset, int count, QOpenGLBuffer::RangeAccessFlags access)

将offset 和count 指定的缓冲区内容范围映射到应用程序的内存空间，并返回一个指针。如果无法进行内存映射，则返回空值。access 参数指定了访问标志组合。

假定create() 已在此缓冲区上调用，且已绑定到当前上下文。

另请参阅 unmap()、create() 和bind()。

bool QOpenGLBuffer::read(int offset, void *data, int count)

从offset 开始，将该缓冲区中的count 字节读入data 。成功时返回true ；如果不支持从缓冲区读取，则返回 false。OpenGL/ES 不支持缓冲区读取。

假定此缓冲区已绑定到当前上下文。

另请参阅 write() 和bind() 。

void QOpenGLBuffer::release()

从当前 OpenGL 上下文中释放与此对象相关联的缓冲区。

调用此函数时，必须使用与在缓冲区上调用bind() 时相同的QOpenGLContext current。

另请参阅 bind()。

[static] void QOpenGLBuffer::release(QOpenGLBuffer::Type type)

释放当前QOpenGLContext 中与type 相关联的缓冲区。

该函数是对glBindBuffer(type, 0) 的直接调用，用于调用者不知道哪个QOpenGLBuffer 已绑定到上下文，但又想确保它已被释放的情况。

QOpenGLBuffer::release(QOpenGLBuffer::VertexBuffer);

void QOpenGLBuffer::setUsagePattern(QOpenGLBuffer::UsagePattern value)

将此缓冲区对象的使用模式设置为value 。必须在调用allocate() 或write() 之前调用此函数。

另请参阅 usagePattern()、allocate() 和write()。

int QOpenGLBuffer::size() const

返回该缓冲区中数据的大小，用于读取操作。如果不支持获取缓冲区大小，或缓冲区尚未创建，则返回-1。

假定此缓冲区已绑定到当前上下文。

另请参阅 isCreated() 和bind()。

[noexcept, since 6.5] void QOpenGLBuffer::swap(QOpenGLBuffer &other)

将此缓冲区与other 互换。该操作速度非常快，而且不会失败。

此函数在 Qt 6.5 中引入。

QOpenGLBuffer::Type QOpenGLBuffer::type() const

返回此对象所代表的缓冲区类型。

bool QOpenGLBuffer::unmap()

在调用map() 将缓冲区映射到应用程序的内存空间后，将其解除映射。如果取消映射成功，则返回true ；否则返回 false。

假定该缓冲区已绑定到当前上下文，并且之前已通过map() 映射过。

另请参阅 map() 。

QOpenGLBuffer::UsagePattern QOpenGLBuffer::usagePattern() const

返回此缓冲区对象的使用模式。默认值是StaticDraw 。

另请参阅 setUsagePattern() 。

void QOpenGLBuffer::write(int offset, const void *data, int count)

用data 的内容替换缓冲区中从offset 开始的count 字节。缓冲区中的其他字节将保持不变。

假定create() 已在此缓冲区上调用，且已绑定到当前上下文。

另请参阅 create()、read() 和allocate()。

[noexcept, since 6.5] QOpenGLBuffer &QOpenGLBuffer::operator=(QOpenGLBuffer &&other)

移动--将other 赋值给此QOpenGLBuffer 实例。

此函数在 Qt 6.5 中引入。

QOpenGLBuffer &QOpenGLBuffer::operator=(const QOpenGLBuffer &other)

将other 的浅层副本分配给此对象。

注意：QOpenGLBuffer 没有实现写入时复制语义，因此只要修改副本，other 就会受到影响。