QOpenGLBuffer Class

成员函数文档

QOpenGLBuffer::QOpenGLBuffer()

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

注意：此构造函数仅创建 QOpenGLBuffer 实例。在调用create() 之前，OpenGL 服务器中的实际缓冲区对象不会被创建。

另请参阅 create()。

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

创建一个新的type 缓冲区对象。

注意：此构造函数仅创建 QOpenGLBuffer 实例。直到调用create() 之后，OpenGL 服务器中的实际缓冲区对象才会被创建。

另请参阅 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 上下文。如果无法进行绑定（通常是因为该 OpenGL 实现不支持type()），则返回false 。

该缓冲区必须绑定到调用create() 时当前的QOpenGLContext ，或者绑定到与其共享的另一个QOpenGLContext 。否则，本函数将返回 false。

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

GLuint QOpenGLBuffer::bufferId() const

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

另请参阅 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)

将该缓冲区的内容映射到应用程序的内存空间中，并返回指向该内存区域的指针。如果无法进行内存映射，则返回 null。access 参数指定要执行的访问类型。

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

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

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 上下文中释放与该对象关联的缓冲区。

调用此函数时，必须使用与在该缓冲区上调用 `bind()` 时相同的 `QOpenGLContext ` 当前上下文。

另请参阅 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)

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

假设已对该缓冲区调用了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 都会受到影响。