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);
}

Dokumentation der Mitgliedsfunktionen

[virtual] char *QRhiBuffer::beginFullDynamicBufferUpdateForCurrentFrame()

Gibt einen Zeiger auf einen Speicherblock mit den Daten des sichtbaren Host-Puffers zurück.

Dies ist eine Abkürzung für mittelgroße bis große dynamische einheitliche Puffer, deren gesamter Inhalt (oder zumindest alle Regionen, die von den Shadern im aktuellen Frame gelesen werden) in jedem Frame geändert wird und der QRhiResourceUpdateBatch-basierte Aktualisierungsmechanismus aufgrund der Menge an Datenkopien als zu schwerfällig angesehen wird.

Auf den Aufruf dieser Funktion muss schließlich ein Aufruf von endFullDynamicUniformBufferUpdateForCurrentFrame() folgen, bevor ein Render- oder Berechnungsdurchlauf aufgezeichnet wird, der sich auf diesen Puffer stützt.

[pure virtual] bool QRhiBuffer::create()

Erzeugt die entsprechenden nativen Grafikressourcen. Wenn aufgrund eines früheren create() ohne entsprechende destroy() bereits Ressourcen vorhanden sind, wird destroy() implizit zuerst aufgerufen.

Gibt bei Erfolg true zurück, bei einem fehlgeschlagenen Grafikvorgang false. Unabhängig vom Rückgabewert ist der Aufruf von destroy() immer sicher.

[virtual] void QRhiBuffer::endFullDynamicBufferUpdateForCurrentFrame()

Wird aufgerufen, wenn der gesamte Inhalt der Pufferdaten in dem von beginFullDynamicBufferUpdateForCurrentFrame() zurückgegebenen Speicherblock aktualisiert wurde.

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

Gibt die zugrunde liegenden nativen Ressourcen für diesen Puffer zurück. Der zurückgegebene Wert ist leer, wenn die zugrundeliegenden nativen Ressourcen vom Backend nicht unterstützt werden.

Ein QRhiBuffer kann von mehreren nativen Pufferobjekten unterstützt werden, je nach type() und dem verwendeten QRhi Backend. Wenn dies der Fall ist, werden alle diese Objekte im Array objects in der zurückgegebenen Struktur zurückgegeben, wobei slotCount die Anzahl der nativen Pufferobjekte angibt. Während recording a frame, QRhi::currentFrameSlot() verwendet werden kann, um festzustellen, welcher der nativen Puffer QRhi für Operationen verwendet wird, die von diesem QRhiBuffer innerhalb des aufgezeichneten Frames lesen oder schreiben.

In einigen Fällen wird ein QRhiBuffer überhaupt nicht durch ein natives Pufferobjekt unterstützt. In diesem Fall wird slotCount auf 0 gesetzt und es werden keine gültigen nativen Objekte zurückgegeben. Dies ist kein Fehler und ist durchaus zulässig, wenn ein bestimmtes Backend keine nativen Puffer für QRhiBuffers mit bestimmten Typen oder Verwendungen verwendet.

Siehe auch QRhi::currentFrameSlot() und QRhi::FramesInFlight.

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

Reimplements: QRhiResource::resourceType() const.

Gibt den Ressourcentyp zurück.

void QRhiBuffer::setSize(quint32 sz)

Legt die Größe des Puffers in Bytes fest. Die Größe wird normalerweise in QRhi::newBuffer() angegeben, so dass diese Funktion nur verwendet wird, wenn die Größe geändert werden muss. Wie bei anderen Setzern wird die Größe nur beim Aufruf von create() wirksam, und für bereits erstellte Puffer bedeutet dies die Freigabe der vorherigen nativen Ressource und die Erstellung neuer Ressourcen unter der Haube.

Backends können sich dafür entscheiden, Puffer zuzuweisen, die größer sind als sz, um die Ausrichtungsanforderungen zu erfüllen. Dies bleibt vor den Anwendungen verborgen, und size() wird immer die in sz angeforderte Größe melden.

Siehe auch size().

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

Setzt den Typ des Puffers auf t.

Siehe auch type().

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

Setzt die Verwendungskennzeichen des Puffers auf u.

Siehe auch usage().

quint32 QRhiBuffer::size() const

Gibt die Größe des Puffers in Bytes zurück.

Dies ist immer der Wert, der an setSize() oder QRhi::newBuffer() übergeben wurde. Intern können die nativen Puffer größer sein, wenn dies von der zugrundeliegenden Grafik-API verlangt wird.

Siehe auch setSize().

QRhiBuffer::Type QRhiBuffer::type() const

Gibt den Puffertyp zurück.

Siehe auch setType().

QRhiBuffer::UsageFlags QRhiBuffer::usage() const

Gibt die Verwendungskennzeichen des Puffers zurück.

Siehe auch setUsage().