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

멤버 함수 문서

[virtual] char *QRhiBuffer::beginFullDynamicBufferUpdateForCurrentFrame()

호스트에서 볼 수 있는 버퍼 데이터가 포함된 메모리 블록에 대한 포인터를 반환합니다.

이는 매 프레임마다 전체 내용(또는 적어도 현재 프레임에서 셰이더가 읽는 모든 영역)이 변경되며, 데이터 복사량이 많아 ` QRhiResourceUpdateBatch` 기반 업데이트 메커니즘이 너무 부담스럽게 느껴지는 중대형 동적 균일 버퍼를 위한 지름길입니다.

이 함수를 호출한 후에는, 이 버퍼에 의존하는 렌더링 또는 컴퓨트 패스를 기록하기 전에 반드시 endFullDynamicUniformBufferUpdateForCurrentFrame()을 호출해야 합니다.

[pure virtual] bool QRhiBuffer::create()

해당 네이티브 그래픽 리소스를 생성합니다. 이전에 destroy() 호출 없이 create()를 호출하여 이미 리소스가 존재하는 경우, 먼저 destroy()가 암시적으로 호출됩니다.

성공 시 true 을 반환하고, 그래픽 작업이 실패한 경우 false 을 반환합니다. 반환 값과 관계없이 destroy()을 호출하는 것은 항상 안전합니다.

[virtual] void QRhiBuffer::endFullDynamicBufferUpdateForCurrentFrame()

beginFullDynamicBufferUpdateForCurrentFrame()에서 반환된 메모리 블록 내의 버퍼 데이터 전체가 업데이트되었을 때 호출됩니다.

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

이 버퍼에 대한 기본 네이티브 리소스를 반환합니다. 백엔드에서 기본 네이티브 리소스의 노출을 지원하지 않는 경우, 반환된 값은 비어 있습니다.

QRhiBuffer 는 사용 중인 type() 및 QRhi 백엔드에 따라 여러 네이티브 버퍼 객체로 구성될 수 있습니다. 이 경우, 반환된 구조체의 objects 배열에 모든 네이티브 버퍼 객체가 포함되며, slotCount는 네이티브 버퍼 객체의 수를 나타냅니다. 또한 recording a frame, QRhi::currentFrameSlot()를 사용하여, 기록 중인 프레임 내에서 이 QRhiBuffer 에서 읽기 또는 쓰기 작업을 수행할 때 QRhi 가 어떤 네이티브 버퍼를 사용하는지 확인할 수 있습니다.

경우에 따라 QRhiBuffer 는 네이티브 버퍼 객체로 전혀 뒷받침되지 않을 수 있습니다. 이 경우 slotCount는 0으로 설정되며 유효한 네이티브 객체가 반환되지 않습니다. 이는 오류가 아니며, 특정 유형이나 용도의 QRhiBuffer에 대해 해당 백엔드가 네이티브 버퍼를 사용하지 않는 경우 완전히 유효한 동작입니다.

QRhi::currentFrameSlot() 및 QRhi::FramesInFlight도 참조하십시오 .

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

QRhiResource::resourceType() const를 재구현합니다.

리소스 유형을 반환합니다.

void QRhiBuffer::setSize(quint32 sz)

버퍼의 크기를 바이트 단위로 설정합니다. 크기는 일반적으로 ` QRhi::newBuffer()`에서 지정되므로, 이 함수는 크기를 변경해야 할 때만 사용됩니다. 다른 설정 함수와 마찬가지로, 이 크기는 ` create()`를 호출할 때만 적용되며, 이미 생성된 버퍼의 경우 내부적으로 기존 네이티브 리소스를 해제하고 새로운 리소스를 생성하는 과정을 거칩니다.

백엔드는 정렬 요구 사항을 충족하기 위해 sz 보다 큰 버퍼를 할당할 수 있습니다. 이는 애플리케이션에 노출되지 않으며, size()는 항상 sz 에서 요청된 크기를 반환합니다.

size()도 참조하십시오 .

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

버퍼의 유형을 ` t`로 설정합니다.

type()도 참조하십시오 .

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

버퍼의 사용 플래그를 u 로 설정합니다.

usage()도 참조하십시오 .

quint32 QRhiBuffer::size() const

버퍼의 크기를 바이트 단위로 반환합니다.

이 값은 항상 setSize() 또는 QRhi::newBuffer()에 전달된 값과 동일합니다. 내부적으로는 기본 그래픽 API에서 요구하는 경우 네이티브 버퍼의 크기가 더 클 수 있습니다.

setSize()도 참조하십시오 .

QRhiBuffer::Type QRhiBuffer::type() const

버퍼 유형을 반환합니다.

setType()도 참조하십시오 .

QRhiBuffer::UsageFlags QRhiBuffer::usage() const

버퍼의 사용 플래그를 반환합니다.

setUsage()도 참조하십시오 .