QRhiResourceUpdateBatch Class

멤버 함수 문서

void QRhiResourceUpdateBatch::copyTexture(QRhiTexture *dst, QRhiTexture *src, const QRhiTextureCopyDescription &desc = QRhiTextureCopyDescription())

desc 에 설명된 대로 src 에서 dst 으로 텍스처 간 복사 작업을 대기열에 넣습니다.

void QRhiResourceUpdateBatch::generateMips(QRhiTexture *tex)

지정된 텍스처에 대한 밉맵 생성 작업을 대기열에 넣습니다 tex.

2D 텍스처와 큐브 텍스처가 모두 지원됩니다.

bool QRhiResourceUpdateBatch::hasOptimalCapacity() const

이 배치에 큐에 대기 중인 버퍼 및 텍스처 작업의 수가 적정 한도 이하가 될 때까지 참을 반환합니다.

이 배치에 추가된 버퍼 및/또는 텍스처 작업의 수가 특정 한계에 도달했거나 곧 도달할 경우 반환값은 거짓입니다. 이 배치는 이후에도 완전히 작동하지만 추가 메모리를 할당해야 할 수 있습니다. 따라서 프레임을 준비할 때 많은 버퍼 및 텍스처 업데이트를 단일 배치로 수집하는 렌더러는 이 함수가 false를 반환할 때 submitting the batch 및 starting a new one 을 고려할 수 있습니다.

void QRhiResourceUpdateBatch::merge(QRhiResourceUpdateBatch *other)

other 배치에서 대기 중인 모든 작업을 이 배치로 복사합니다.

이렇게 하면 초기화 단계에서 이미 알려진 리소스 업데이트를 배치로 수집한 다음 나중에 첫 번째 렌더 패스를 시작할 때 다른 배치로 병합하는 편리한 패턴을 사용할 수 있습니다:

void init()
{
    initialUpdates = rhi->nextResourceUpdateBatch();
    initialUpdates->uploadStaticBuffer(vbuf, vertexData);
    initialUpdates->uploadStaticBuffer(ibuf, indexData);
    // ...
}

void render()
{
    QRhiResourceUpdateBatch *resUpdates = rhi->nextResourceUpdateBatch();
    if (initialUpdates) {
        resUpdates->merge(initialUpdates);
        initialUpdates->release();
        initialUpdates = nullptr;
    }
    // resUpdates->updateDynamicBuffer(...);
    cb->beginPass(rt, clearCol, clearDs, resUpdates);
}

void QRhiResourceUpdateBatch::readBackBuffer(QRhiBuffer *buf, quint32 offset, quint32 size, QRhiReadbackResult *result)

QRhiBuffer buf 의 영역 읽기를 대기열에 추가합니다. 영역의 크기는 size (바이트)로 지정되며 offset 은 읽기를 시작할 오프셋 (바이트)입니다.

읽기백은 비동기식입니다. result 에는 작업이 완료되면 호출되는 콜백이 포함되어 있습니다. 데이터는 QRhiReadbackResult::data 에 제공됩니다. 성공적으로 완료되면 QByteArray 은 size 과 같은 크기를 갖습니다. 실패하면 QByteArray 은 비어 있습니다.

readBackTexture(), QRhi::isFeatureSupported() 및 QRhi::resourceLimit()도 참조하세요 .

void QRhiResourceUpdateBatch::readBackTexture(const QRhiReadbackDescription &rb, QRhiReadbackResult *result)

rb 에 설명된 대로 텍스처-호스트 복사 작업을 대기열에 넣습니다.

일반적으로 rb 은 QRhiTexture 을 소스로 지정합니다. 그러나 현재 프레임의 스왑체인이 QRhiSwapChain::UsedAsTransferSource 로 생성된 경우, 이 스왑체인이 읽기백의 소스가 될 수도 있습니다. 이를 위해 rb 에서 텍스처를 null로 설정합니다.

다른 연산과 달리 여기서의 결과는 애플리케이션에서 처리해야 합니다. 따라서 result 은 데이터뿐만 아니라 배치에 대한 작업이 본질적으로 비동기적이므로 콜백도 제공합니다:

rhi->beginFrame(swapchain);
cb->beginPass(swapchain->currentFrameRenderTarget(), colorClear, dsClear);
// ...
QRhiReadbackResult *rbResult = new QRhiReadbackResult;
rbResult->completed = [rbResult] {
    {
        const QImage::Format fmt = QImage::Format_RGBA8888_Premultiplied; // fits QRhiTexture::RGBA8
        const uchar *p = reinterpret_cast<const uchar *>(rbResult->data.constData());
        QImage image(p, rbResult->pixelSize.width(), rbResult->pixelSize.height(), fmt);
        image.save("result.png");
    }
    delete rbResult;
};
QRhiResourceUpdateBatch *u = nextResourceUpdateBatch();
QRhiReadbackDescription rb; // no texture -> uses the current backbuffer of sc
u->readBackTexture(rb, rbResult);
cb->endPass(u);
rhi->endFrame(swapchain);

단일 읽기백 작업은 한 번에 한 레이어(큐브맵 면 또는 3D 슬라이스 또는 텍스처 배열 요소)의 밉 레벨을 한 번에 하나씩 복사합니다. 레벨과 레이어는 rb 의 각 필드에 의해 지정됩니다.

readBackBuffer() 및 QRhi::resourceLimit()도 참조하십시오 .

void QRhiResourceUpdateBatch::release()

배치를 풀로 반환합니다. 이 함수는 QRhiCommandBuffer::beginPass(), QRhiCommandBuffer::endPass() 또는 QRhiCommandBuffer::resourceUpdate() 중 하나에 배치를 전달하지 않은 경우에만 사용해야 하는데, 이 함수는 암시적으로 destroy()를 호출하기 때문입니다.

void QRhiResourceUpdateBatch::updateDynamicBuffer(QRhiBuffer *buf, quint32 offset, quint32 size, const void *data)

QRhiBuffer::Dynamic 유형으로 생성된 QRhiBuffer buf 의 리전 업데이트를 큐에 넣습니다.

영역은 offset 및 size 으로 지정됩니다. 실제 쓸 바이트는 data 으로 지정되며, 최소 size 바이트가 있어야 합니다. data 는 이 함수가 반환되면 안전하게 삭제하거나 변경할 수 있습니다.

void QRhiResourceUpdateBatch::uploadStaticBuffer(QRhiBuffer *buf, quint32 offset, quint32 size, const void *data)

QRhiBuffer::Immutable 또는 QRhiBuffer::Static 유형으로 생성된 QRhiBuffer buf 의 리전 업데이트를 큐에 넣습니다.

영역은 offset 및 size 으로 지정됩니다. 실제 쓸 바이트는 data 으로 지정되며 최소 size 바이트가 있어야 합니다. data 은 이 함수가 반환되면 안전하게 삭제하거나 변경할 수 있습니다.

void QRhiResourceUpdateBatch::uploadStaticBuffer(QRhiBuffer *buf, const void *data)

이 함수는 과부하된 함수입니다.

QRhiBuffer::Immutable 또는 QRhiBuffer::Static 유형으로 생성된 QRhiBuffer buf 전체 업데이트를 큐에 넣습니다.

void QRhiResourceUpdateBatch::uploadTexture(QRhiTexture *tex, const QImage &image)

텍스처 0 레이어의 밉 레벨 0에 대한 이미지 데이터 업로드를 대기열에 추가합니다 tex.

tex 압축되지 않은 형식이어야 합니다. 형식은 image 의 QImage::format()와도 호환되어야 합니다. 소스 데이터는 image 에 제공됩니다.

void QRhiResourceUpdateBatch::uploadTexture(QRhiTexture *tex, const QRhiTextureUploadDescription &desc)

텍스처의 하나 이상의 레이어에 있는 하나 이상의 밉 레벨에 대한 이미지 데이터를 업로드 대기열에 넣습니다 tex.

사본의 세부 사항(소스 QImage 또는 압축 텍스처 데이터, 영역, 타깃 레이어 및 레벨)은 desc 에 설명되어 있습니다.