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 für den Host sichtbaren Pufferdaten zurück.

Dies ist eine Abkürzung für mittelgroße bis große dynamische Uniform-Puffer, deren gesamter Inhalt (oder zumindest alle Bereiche, die von den Shadern im aktuellen Frame gelesen werden) in jedem Frame geändert wird und bei denen der auf „ QRhiResourceUpdateBatch “ basierende Aktualisierungsmechanismus aufgrund des damit verbundenen Datenkopieraufwands als zu ressourcenintensiv angesehen wird.

Auf den Aufruf dieser Funktion muss schließlich ein Aufruf von `endFullDynamicUniformBufferUpdateForCurrentFrame()` folgen, bevor ein Render- oder Compute-Pass aufgezeichnet wird, der auf diesem Puffer basiert.

[pure virtual] bool QRhiBuffer::create()

Erstellt die entsprechenden nativen Grafikressourcen. Wenn aufgrund eines früheren Aufrufs von `create()` bereits Ressourcen vorhanden sind, für die kein entsprechender Aufruf von ` destroy()` vorliegt, wird zunächst implizit ` destroy()` aufgerufen.

Gibt bei Erfolg ` true ` zurück, bei einem Fehler bei einer Grafikoperation ` 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 das Backend die Offenlegung der zugrunde liegenden nativen Ressourcen nicht unterstützt.

Ein „ QRhiBuffer “ kann von mehreren nativen Pufferobjekten gestützt werden, abhängig von der verwendeten Funktion „ type()“ und dem Backend „ QRhi “. Ist dies der Fall, werden alle diese Objekte im Array „objects“ der zurückgegebenen Struktur zurückgegeben, wobei „slotCount“ die Anzahl der nativen Pufferobjekte angibt. Mit „ recording a frame “ und „ QRhi::currentFrameSlot()“ lässt sich ermitteln, welche der nativen Puffer „ QRhi “ für Lese- oder Schreibvorgänge an diesem „ QRhiBuffer “ innerhalb des gerade aufgezeichneten Frames verwendet.

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

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

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

Implementiert neu: ` QRhiResource::resourceType()` const.

Gibt den Ressourcentyp zurück.

void QRhiBuffer::setSize(quint32 sz)

Legt die Größe des Puffers in Byte fest. Die Größe wird normalerweise in ` QRhi::newBuffer()` angegeben, sodass diese Funktion nur verwendet wird, wenn die Größe geändert werden muss. Wie bei anderen Setter-Funktionen wird die Größe erst beim Aufruf von ` create()` wirksam; bei bereits erstellten Puffern bedeutet dies, dass die bisherige native Ressource freigegeben und im Hintergrund eine neue erstellt wird.

Backends können Puffer zuweisen, die größer sind als in ` sz ` angegeben, um Ausrichtungsanforderungen zu erfüllen. Dies bleibt für die Anwendungen verborgen, und ` size()` meldet stets die in ` sz` angeforderte Größe.

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 Nutzungsflags des Puffers auf „ u “.

Siehe auch ` usage()`.

quint32 QRhiBuffer::size() const

Gibt die Größe des Puffers in Byte 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 zugrunde liegenden Grafik-API gefordert wird.

Siehe auch ` setSize()`.

QRhiBuffer::Type QRhiBuffer::type() const

Gibt den Puffertyp zurück.

Siehe auch „ setType()“.

QRhiBuffer::UsageFlags QRhiBuffer::usage() const

Gibt die Nutzungsflags des Puffers zurück.

Siehe auch ` setUsage()`.