QRhiResourceUpdateBatch Class

멤버 함수 문서

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

desc 에 설명된 대로 src 에서 dst 로 텍스처 간 복사 작업을 큐에 등록합니다.

void QRhiResourceUpdateBatch::generateMips(QRhiTexture *tex)

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

2D 및 큐브 텍스처가 지원됩니다. 1D 및 3D 텍스처는 각각 QRhi::OneDimensionalTextureMipmaps 또는 QRhi::ThreeDimensionalTextureMipmaps 기능이 지원된다고 보고된 경우에만 지원됩니다.

bool QRhiResourceUpdateBatch::hasOptimalCapacity() const

이 배치에 큐에 등록된 버퍼 및 텍스처 연산 횟수가 적정 한도 미만이 될 때까지 true를 반환합니다.

이 배치에 추가된 버퍼 및/또는 텍스처 연산 횟수가 특정 한도에 도달했거나 곧 도달할 경우 반환 값은 false입니다. 이후에도 배치는 정상적으로 작동하지만, 추가 메모리를 할당해야 할 수도 있습니다. 따라서 프레임을 준비할 때 단일 배치에 많은 버퍼 및 텍스처 업데이트를 모으는 렌더러의 경우, 이 함수가 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 를 지정합니다. 그러나 현재 프레임의 스왑체인(swapchain)이 QRhiSwapChain::UsedAsTransferSource 를 통해 생성된 경우, 해당 스왑체인이 리드백(readback)의 소스가 될 수도 있습니다. 이를 위해서는 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 이 버퍼는 복사된 것이므로, 이 함수가 반환된 후에는 안전하게 파기하거나 변경할 수 있습니다.

[since 6.10] void QRhiResourceUpdateBatch::updateDynamicBuffer(QRhiBuffer *buf, quint32 offset, QByteArray data)

QRhiBuffer::Dynamic 유형으로 생성된 QRhiBuffer buf 의 특정 영역을 업데이트하는 작업을 큐에 추가합니다. .

data 이 오버로드에서는 복사하는 대신 배치로 이동됩니다.

이 함수는 Qt 6.10에서 도입되었습니다.

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

QRhiBuffer::Immutable 또는 QRhiBuffer::Static 유형으로 생성된 QRhiBuffer buf 의 특정 영역을 업데이트하는 작업을 대기열에 추가합니다.

해당 영역은 offset 및 size 에서 지정됩니다. 실제로 쓸 바이트는 data 로 지정되며, 이 영역에는 최소한 size 바이트의 여유 공간이 있어야 합니다.

data 이 함수가 반환되면 복사된 데이터는 안전하게 삭제하거나 변경할 수 있습니다.

[since 6.10] void QRhiResourceUpdateBatch::uploadStaticBuffer(QRhiBuffer *buf, QByteArray data)

QRhiBuffer::Immutable 또는 QRhiBuffer::Static 유형으로 생성된 QRhiBuffer buf 전체를 업데이트하는 작업을 큐에 추가합니다.

data 이 오버로드에서는 복사하는 대신 xml-ph-0000@deepl.internal을 배치로 이동시킵니다.

data size는 buf 의 크기와 같아야 합니다.

이 함수는 Qt 6.10에서 도입되었습니다.

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

QRhiBuffer::Immutable 또는 QRhiBuffer::Static 유형으로 생성된 전체 QRhiBuffer buf 에 대한 업데이트 작업을 대기열에 추가합니다.

[since 6.10] void QRhiResourceUpdateBatch::uploadStaticBuffer(QRhiBuffer *buf, quint32 offset, QByteArray data)

QRhiBuffer::Immutable 또는 QRhiBuffer::Static 유형으로 생성된 QRhiBuffer buf 의 특정 영역을 업데이트하는 작업을 큐에 추가합니다. 의 해당 영역은 이 오버로드에서 복사되는 대신 배치로 이동됩니다.

data 이 오버로드에서는 데이터가 복사되는 대신 배치로 이동됩니다.

이 함수는 Qt 6.10에서 도입되었습니다.

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

tex 텍스처의 레이어 0, 미프 레벨 0에 해당하는 이미지 데이터 업로드를 대기열에 추가합니다.

tex 압축되지 않은 형식이어야 합니다. 또한 이 형식은 image 의 QImage::format() 함수와 호환되어야 합니다. 소스 데이터는 image 에 명시되어 있습니다.

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

텍스처 tex 의 하나 이상의 레이어에 포함된 하나 이상의 미프 레벨에 대한 이미지 데이터를 업로드 대기열에 추가합니다.

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