QRhiBuffer Class

QRhiBuffer *ubuf = rhi->newBuffer(QRhiBuffer::Dynamic, QRhiBuffer::UniformBuffer, 64);
if (!ubuf->create()) { error(); }
QRhiResourceUpdateBatch *batch = rhi->nextResourceUpdateBatch();
QMatrix4x4 mvp;
// ... set up the modelview-projection matrix
batch->updateDynamicBuffer(ubuf, 0, 64, mvp.constData());
// ...
commandBuffer->resourceUpdate(batch); // or, alternatively, pass 'batch' to a beginPass() call

const float vertices[] = { -1.0f, -1.0f, 1.0f, -1.0f, 0.0f, 1.0f };
QRhiBuffer *vbuf = rhi->newBuffer(QRhiBuffer::Immutable, QRhiBuffer::VertexBuffer, sizeof(vertices));
if (!vbuf->create()) { error(); }
QRhiResourceUpdateBatch *batch = rhi->nextResourceUpdateBatch();
batch->uploadStaticBuffer(vbuf, vertices);
// ...
commandBuffer->resourceUpdate(batch); // or, alternatively, pass 'batch' to a beginPass() call

static const quint16 indices[] = { 0, 1, 2 };
QRhiBuffer *ibuf = rhi->newBuffer(QRhiBuffer::Immutable, QRhiBuffer::IndexBuffer, sizeof(indices));
if (!ibuf->create()) { error(); }
QRhiResourceUpdateBatch *batch = rhi->nextResourceUpdateBatch();
batch->uploadStaticBuffer(ibuf, indices);
// ...
commandBuffer->resourceUpdate(batch); // or, alternatively, pass 'batch' to a beginPass() call

if (buf->size() < newSize) {
    buf->setSize(newSize);
    if (!buf->create()) { error(); }
}
// continue using buf, fill it with new data

const int N = 2;
const int UB_SIZE = 64 + 4; // assuming a uniform block with { mat4 matrix; float opacity; }
const int ONE_UBUF_SIZE = rhi->ubufAligned(UB_SIZE);
const int TOTAL_UBUF_SIZE = N * ONE_UBUF_SIZE;
QRhiBuffer *ubuf = rhi->newBuffer(QRhiBuffer::Dynamic, QRhiBuffer::UniformBuffer, TOTAL_UBUF_SIZE);
if (!ubuf->create()) { error(); }
QRhiResourceUpdateBatch *batch = rhi->nextResourceUpdateBatch();
for (int i = 0; i < N; ++i) {
    batch->updateDynamicBuffer(ubuf, i * ONE_UBUF_SIZE, 64, matrix.constData());
    batch->updateDynamicBuffer(ubuf, i * ONE_UBUF_SIZE + 64, 4, &opacity);
}
// ...
// beginPass(), set pipeline, etc., and then:
for (int i = 0; i < N; ++i) {
    QRhiCommandBuffer::DynamicOffset dynOfs[] = { { 0, i * ONE_UBUF_SIZE } };
    cb->setShaderResources(srb, 1, dynOfs);
    cb->draw(36);
}

Documentación de las funciones miembro

[virtual] char *QRhiBuffer::beginFullDynamicBufferUpdateForCurrentFrame()

Devuelve un puntero a un bloque de memoria con los datos del búfer visible del host.

Este es un atajo para buffers uniformes dinámicos de tamaño medio-grande cuyo contenido completo (o al menos todas las regiones que son leídas por los shaders en el frame actual) cambia en cada frame y el mecanismo de actualización basado en QRhiResourceUpdateBatch se ve demasiado pesado debido a la cantidad de copia de datos que implica.

La llamada a esta función debe ser eventualmente seguida por una llamada a endFullDynamicUniformBufferUpdateForCurrentFrame(), antes de grabar cualquier render o compute pass que dependa de este buffer.

[pure virtual] bool QRhiBuffer::create()

Crea los recursos gráficos nativos correspondientes. Si ya hay recursos presentes debido a un create() anterior sin destroy() correspondiente, entonces destroy() se llama implícitamente primero.

Devuelve true en caso de éxito, false en caso de fallo de la operación gráfica. Independientemente del valor de retorno, la llamada a destroy() es siempre segura.

[virtual] void QRhiBuffer::endFullDynamicBufferUpdateForCurrentFrame()

Se llamará cuando se haya actualizado todo el contenido de los datos del búfer en el bloque de memoria devuelto por beginFullDynamicBufferUpdateForCurrentFrame().

[virtual] QRhiBuffer::NativeBuffer QRhiBuffer::nativeBuffer()

Devuelve los recursos nativos subyacentes para este búfer. El valor devuelto estará vacío si el backend no admite la exposición de los recursos nativos subyacentes.

Un QRhiBuffer puede estar respaldado por múltiples objetos de búfer nativos, dependiendo del type() y del backend QRhi en uso. Cuando este es el caso, todos ellos se devuelven en la matriz de objetos de la estructura devuelta, con slotCount especificando el número de objetos de búfer nativos. Mientras que recording a frame, QRhi::currentFrameSlot() se puede utilizar para determinar cuál de los búferes nativos QRhi está utilizando para las operaciones que leen o escriben desde este QRhiBuffer dentro del fotograma que se está grabando.

En algunos casos un QRhiBuffer no estará respaldado por un objeto buffer nativo en absoluto. En este caso slotCount se pondrá a 0 y no se devolverá ningún objeto nativo válido. Esto no es un error, y es perfectamente válido cuando un backend dado no utiliza buffers nativos para QRhiBuffers con ciertos tipos o usos.

Véase también QRhi::currentFrameSlot() y QRhi::FramesInFlight.

[override virtual] QRhiResource::Type QRhiBuffer::resourceType() const

Reimplementa: QRhiResource::resourceType() const.

Devuelve el tipo de recurso.

void QRhiBuffer::setSize(quint32 sz)

Establece el tamaño del búfer en bytes. El tamaño se especifica normalmente en QRhi::newBuffer() por lo que esta función sólo se utiliza cuando hay que cambiar el tamaño. Al igual que con otros setters, el tamaño sólo tiene efecto cuando se llama a create(), y para los buffers ya creados esto implica liberar el recurso nativo anterior y crear nuevos bajo el capó.

Los backends pueden optar por asignar buffers mayores que sz para cumplir con los requisitos de alineación. Esto se oculta a las aplicaciones y size() siempre informará del tamaño solicitado en sz.

Véase también size().

void QRhiBuffer::setType(QRhiBuffer::Type t)

Establece el tipo del búfer en t.

Véase también type().

void QRhiBuffer::setUsage(QRhiBuffer::UsageFlags u)

Establece los indicadores de uso del búfer en u.

Véase también usage().

quint32 QRhiBuffer::size() const

Devuelve el tamaño del búfer en bytes.

Este es siempre el valor que se pasó a setSize() o QRhi::newBuffer(). Internamente, los buffers nativos pueden ser mayores si así lo requiere la API gráfica subyacente.

Véase también setSize().

QRhiBuffer::Type QRhiBuffer::type() const

Devuelve el tipo de búfer.

Véase también setType().

QRhiBuffer::UsageFlags QRhiBuffer::usage() const

Devuelve los indicadores de uso del búfer.

Véase también setUsage().