QOpenGLBuffer 类

成员函数文档

QOpenGLBuffer::QOpenGLBuffer()

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

注意：此构造函数仅创建QOpenGLBuffer实例。实际在OpenGL服务器中的缓冲区对象只有当调用create()后才会创建。

另请参阅create()。

[显式] QOpenGLBuffer::QOpenGLBuffer(QOpenGLBuffer::Type type)

构造一个指定类型的缓冲区对象。

注意：此构造函数仅创建QOpenGLBuffer实例。实际在OpenGL服务器中的缓冲区对象只有当调用create()后才会创建。

另请参阅create()。

QOpenGLBuffer::QOpenGLBuffer(const QOpenGLBuffer &other)

构造一个对other的浅拷贝。

注意：QOpenGLBuffer不实现延迟拷写的语义，因此每当修改拷贝时，other都会受到影响。

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

从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。

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

另请参阅()和()。

GLuint QOpenGLBuffer::bufferId() const

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

另请参阅()。

bool QOpenGLBuffer::create()

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

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

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

另请参阅()，()，和。

void QOpenGLBuffer::destroy()

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

bool QOpenGLBuffer::isCreated() const

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

另请参阅()和。

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

将此缓冲区的内容映射到应用程序的内存空间，并返回对该内容的指针。如果内存映射不可行，则返回null。参数access指定要执行的类型。

假设已对当前缓冲区调用create()，并且它已绑定到当前上下文中。

另请参阅()，()，和。

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

将此缓冲区内容的offset和count指定的范围映射到应用程序的内存空间，并返回对该内容的指针。如果内存映射不可行，则返回null。参数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 上下文。

该函数必须在调用 QOpenGLContext 的 bind() 时使用的同一个当前 QOpenGLContext 上调用。

另请参阅bind()。

[静态] 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)

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

假设已对当前缓冲区调用create()，并且它已绑定到当前上下文中。

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

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

将other的浅拷贝分配给此对象。

注意：QOpenGLBuffer未实现写时复制语义，因此每次修改拷贝时other都会受到影响。

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

移动分配other到此QOpenGLBuffer实例。

此函数自Qt 6.5引入。