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

Documentation des fonctions membres

[virtual] char *QRhiBuffer::beginFullDynamicBufferUpdateForCurrentFrame()

Renvoie un pointeur vers un bloc de mémoire contenant les données du tampon visible par l'hôte.

Il s'agit d'un raccourci destiné aux tampons uniformes dynamiques de taille moyenne à grande dont l'intégralité du contenu (ou au moins toutes les régions lues par les shaders dans l'image en cours) est modifiée à chaque image et pour lesquels le mécanisme de mise à jour basé sur ` QRhiResourceUpdateBatch` est jugé trop lourd en raison du volume de données à copier.

L'appel de cette fonction doit être suivi, au plus tard, d'un appel à endFullDynamicUniformBufferUpdateForCurrentFrame(), avant l'enregistrement de tout passage de rendu ou de calcul s'appuyant sur ce tampon.

[pure virtual] bool QRhiBuffer::create()

Crée les ressources graphiques natives correspondantes. Si des ressources existent déjà en raison d’un appel antérieur à `create()` sans ` destroy()` correspondant, alors la fonction ` destroy()` est d’abord appelée implicitement.

Renvoie ` true ` en cas de réussite, et ` false ` lorsqu’une opération graphique a échoué. Quelle que soit la valeur renvoyée, l’appel à ` destroy()` est toujours sans risque.

[virtual] void QRhiBuffer::endFullDynamicBufferUpdateForCurrentFrame()

À appeler lorsque l'intégralité du contenu des données du tampon a été mise à jour dans le bloc de mémoire renvoyé par la fonction ` beginFullDynamicBufferUpdateForCurrentFrame()`.

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

Renvoie les ressources natives sous-jacentes de ce tampon. La valeur renvoyée sera vide si l'exposition des ressources natives sous-jacentes n'est pas prise en charge par le backend.

Un objet « QRhiBuffer » peut être adossé à plusieurs objets de tampon natifs, selon les fonctions ` type()` et le backend ` QRhi ` utilisés. Dans ce cas, tous ces objets sont renvoyés dans le tableau `objects` de la structure renvoyée, `slotCount` spécifiant le nombre d’objets de tampon natifs. Bien que ` recording a frame`, ` QRhi::currentFrameSlot()` puisse être utilisé pour déterminer lequel des tampons natifs ` QRhi ` utilise pour les opérations de lecture ou d’écriture à partir de ce ` QRhiBuffer ` au sein de l’image en cours d’enregistrement.

Dans certains cas, un ` QRhiBuffer ` ne sera pas du tout associé à un objet tampon natif. Dans ce cas, `slotCount` sera défini sur 0 et aucun objet natif valide ne sera renvoyé. Il ne s’agit pas d’une erreur, et cela est tout à fait valable lorsqu’un backend donné n’utilise pas de tampons natifs pour les `QRhiBuffers` présentant certains types ou certaines utilisations.

Voir également QRhi::currentFrameSlot() et QRhi::FramesInFlight.

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

Réimplémente : ` QRhiResource::resourceType()` const.

Renvoie le type de ressource.

void QRhiBuffer::setSize(quint32 sz)

Définit la taille du tampon en octets. La taille est normalement spécifiée dans ` QRhi::newBuffer()`, cette fonction n’est donc utilisée que lorsque la taille doit être modifiée. Comme pour les autres méthodes de configuration, la taille ne prend effet qu’au moment de l’appel à ` create()`, et pour les tampons déjà créés, cela implique de libérer la ressource native précédente et d’en créer de nouvelles en arrière-plan.

Les backends peuvent choisir d’allouer des tampons plus grands que sz afin de respecter les exigences d’alignement. Ce comportement est masqué aux applications et size() renverra toujours la taille demandée dans sz.

Voir également size().

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

Définit le type du tampon sur « t ».

Voir aussi type().

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

Définit les indicateurs d'utilisation du tampon sur « u ».

Voir aussi usage().

quint32 QRhiBuffer::size() const

Renvoie la taille du tampon en octets.

Il s'agit toujours de la valeur qui a été transmise à setSize() ou QRhi::newBuffer(). En interne, les tampons natifs peuvent être plus grands si l'API graphique sous-jacente l'exige.

Voir également setSize().

QRhiBuffer::Type QRhiBuffer::type() const

Renvoie le type du tampon.

Voir aussi setType().

QRhiBuffer::UsageFlags QRhiBuffer::usage() const

Renvoie les indicateurs d'utilisation du tampon.

Voir aussi setUsage().