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 de l'hôte.

Il s'agit d'un raccourci pour les tampons uniformes dynamiques de taille moyenne à grande dont le contenu entier (ou au moins toutes les régions qui sont lues par les shaders dans la trame courante) est modifié à chaque trame et le mécanisme de mise à jour basé sur QRhiResourceUpdateBatch est considéré comme trop lourd en raison de la quantité de données copiées impliquées.

L'appel à cette fonction doit être suivi d'un appel à endFullDynamicUniformBufferUpdateForCurrentFrame(), avant d'enregistrer toute passe de rendu ou de calcul qui s'appuie sur ce tampon.

[pure virtual] bool QRhiBuffer::create()

Crée les ressources graphiques natives correspondantes. Si des ressources sont déjà présentes en raison d'un create() antérieur sans destroy() correspondant, alors destroy() est appelé implicitement en premier.

Retourne true en cas de succès, false en cas d'échec de l'opération graphique. Quelle que soit la valeur de retour, l'appel à destroy() est toujours sûr.

[virtual] void QRhiBuffer::endFullDynamicBufferUpdateForCurrentFrame()

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

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

Renvoie les ressources natives sous-jacentes pour 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 QRhiBuffer peut être soutenu par plusieurs objets tampons natifs, en fonction du type() et du backend QRhi utilisé. Lorsque c'est le cas, ils sont tous renvoyés dans le tableau d'objets de la structure renvoyée, slotCount spécifiant le nombre d'objets tampons natifs. Alors que recording a frame, QRhi::currentFrameSlot() peut être utilisé pour déterminer lequel des tampons natifs QRhi utilise pour les opérations qui lisent ou écrivent à partir de ce QRhiBuffer dans l'image en cours d'enregistrement.

Dans certains cas, un QRhiBuffer n'est pas du tout soutenu par un objet tampon natif. Dans ce cas, slotCount est mis à 0 et aucun objet natif valide n'est renvoyé. Il ne s'agit pas d'une erreur, et c'est parfaitement valable lorsqu'un backend donné n'utilise pas de tampons natifs pour les QRhiBuffers avec certains types ou usages.

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)

Fixe 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 paramètres, la taille ne prend effet que lors 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 sous le capot.

Les backends peuvent choisir d'allouer des tampons plus grands que sz afin de répondre aux exigences d'alignement. Ceci est caché aux applications et size() indiquera toujours la taille demandée dans sz.

Voir également size().

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

Définit le type du tampon à t.

Voir aussi type().

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

Définit les drapeaux d'utilisation du tampon à u.

Voir aussi usage().

quint32 QRhiBuffer::size() const

Renvoie la taille du tampon en octets.

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

Voir aussi setSize().

QRhiBuffer::Type QRhiBuffer::type() const

Renvoie le type de tampon.

Voir aussi setType().

QRhiBuffer::UsageFlags QRhiBuffer::usage() const

Renvoie les drapeaux d'utilisation du tampon.

Voir aussi setUsage().