QRhiSwapChain Class

void init()
{
    sc = rhi->newSwapChain();
    ds = rhi->newRenderBuffer(QRhiRenderBuffer::DepthStencil,
                              QSize(), // no need to set the size here due to UsedWithSwapChainOnly
                              1,
                              QRhiRenderBuffer::UsedWithSwapChainOnly);
    sc->setWindow(window);
    sc->setDepthStencil(ds);
    rp = sc->newCompatibleRenderPassDescriptor();
    sc->setRenderPassDescriptor(rp);
    resizeSwapChain();
}

void resizeSwapChain()
{
    hasSwapChain = sc->createOrResize();
}

void render()
{
    if (!hasSwapChain || notExposed)
        return;

    if (sc->currentPixelSize() != sc->surfacePixelSize() || newlyExposed) {
        resizeSwapChain();
        if (!hasSwapChain)
            return;
        newlyExposed = false;
    }

    rhi->beginFrame(sc);
    // ...
    rhi->endFrame(sc);
}

void releaseSwapChain()
{
    if (hasSwapChain) {
        sc->destroy();
        hasSwapChain = false;
    }
}

// assuming Window is our QWindow subclass
bool Window::event(QEvent *e)
{
    switch (e->type()) {
    case QEvent::UpdateRequest: // for QWindow::requestUpdate()
        render();
        break;
    case QEvent::PlatformSurface:
        if (static_cast<QPlatformSurfaceEvent *>(e)->surfaceEventType() == QPlatformSurfaceEvent::SurfaceAboutToBeDestroyed)
            releaseSwapChain();
        break;
    default:
        break;
    }
    return QWindow::event(e);
}

void Window::exposeEvent(QExposeEvent *)
{
    // initialize and start rendering when the window becomes usable for graphics purposes
    if (isExposed() && !running) {
        running = true;
        init();
    }

    // stop pushing frames when not exposed or size becomes 0
    if ((!isExposed() || (hasSwapChain && sc->surfacePixelSize().isEmpty())) && running)
        notExposed = true;

    // continue when exposed again and the surface has a valid size
    if (isExposed() && running && notExposed && !sc->surfacePixelSize().isEmpty()) {
        notExposed = false;
        newlyExposed = true;
    }

    if (isExposed() && !sc->surfacePixelSize().isEmpty())
        render();
}

멤버 함수 문서

[pure virtual] bool QRhiSwapChain::createOrResize()

아직 스왑체인을 생성하지 않은 경우 스왑체인 버퍼의 크기를 대상 서페이스의 현재 크기와 일치하도록 조정합니다. 대상 서페이스의 크기가 이전과 다를 때마다 이 함수를 호출합니다.

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

[pure virtual] QRhiCommandBuffer *QRhiSwapChain::currentFrameCommandBuffer()

이 스왑체인으로 beginFrame()이 호출되었다는 가정 하에 beginFrame - endFrame 블록 내에서 렌더링 명령과 리소스 업데이트를 기록할 수 있는 명령 버퍼를 반환합니다.

[pure virtual] QRhiRenderTarget *QRhiSwapChain::currentFrameRenderTarget()

스왑체인의 현재 백버퍼를 렌더링하기 위해 beginPass()와 함께 사용할 수 있는 렌더 타깃을 반환합니다. 이 스왑체인으로 beginFrame()이 호출된 QRhi::beginFrame() - QRhi::endFrame() 블록 내에서만 유효합니다.

[virtual] QRhiRenderTarget *QRhiSwapChain::currentFrameRenderTarget(QRhiSwapChain::StereoTargetBuffer targetBuffer)

스왑체인의 왼쪽 또는 오른쪽 백버퍼에 렌더링하기 위해 beginPass()와 함께 사용할 수 있는 렌더 타깃을 반환합니다. 이 오버로드는 스테레오스코픽 렌더링, 즉 연결된 QWindow 이 하나가 아닌 각 눈마다 하나씩 두 개의 컬러 버퍼로 지원되는 경우에만 사용해야 합니다.

스테레오스코픽 렌더링이 지원되지 않는 경우 반환값은 기본 타겟이 됩니다. 런타임에 그래픽 및 디스플레이 드라이버 스택에서 지원된다는 가정 하에 Metal을 제외한 모든 하드웨어 백엔드에서 QSurfaceFormat::StereoBuffers 과 함께 지원됩니다. Metal 및 Null 백엔드는 이 오버로드에서 기본 렌더링 타깃을 반환합니다.

QSize QRhiSwapChain::currentPixelSize() const

스왑체인이 마지막으로 성공적으로 빌드된 크기를 반환합니다. createOrResize ()를 다시 호출해야 하는지 여부를 결정할 때 사용합니다. currentPixelSize() != surfacePixelSize() 이면 스왑체인의 크기를 조정해야 합니다.

대부분의 경우 이 값은 QWindow::size() * QWindow::devicePixelRatio() 과 동일하지만 QWindow-보고된 크기에 의존하는 것은 모든 플랫폼 및 그래픽 API 구현에서 정확하다고 보장할 수 없습니다. 따라서 출력 레이어 또는 서페이스의 크기를 픽셀 단위로 식별해야 할 때마다 이 함수를 사용하는 것이 좋습니다.

또한 전용 렌더링 스레드에서 QRhi 을 사용하면 메인 스레드에서 업데이트된 데이터에 액세스할 수 있는 QWindow 함수를 호출할 필요가 없으므로 잠재적인 데이터 경합을 피할 수 있다는 추가적인 이점도 있습니다.

surfacePixelSize()도 참조하세요 .

QRhiRenderBuffer *QRhiSwapChain::depthStencil() const

현재 연결된 뎁스 스텐실에 대한 렌더버퍼를 반환합니다.

setDepthStencil()도 참조하세요 .

QRhiSwapChain::Flags QRhiSwapChain::flags() const

현재 설정된 플래그를 반환합니다.

setFlags()도 참조하세요 .

QRhiSwapChain::Format QRhiSwapChain::format() const

현재 설정된 형식을 반환합니다.

setFormat()도 참조하세요 .

[virtual] QRhiSwapChainHdrInfo QRhiSwapChain::hdrInfo()

연결된 디스플레이에 대한 HDR 정보를 반환합니다.

이 함수가 저렴한 작업이라고 가정하지 마세요. 플랫폼에 따라 이 함수는 성능에 영향을 줄 수 있는 다양한 플랫폼 쿼리를 수행합니다.

QRhiSwapChainHdrInfo도 참조하세요 .

[pure virtual] bool QRhiSwapChain::isFormatSupported(QRhiSwapChain::Format f)

지정된 스왑체인 형식( f )이 지원되면 참을 반환합니다. SDR은 항상 지원됩니다.

이 함수의 주요 용도는 창이 이미 설정된 후 첫 번째 createOrResize() 앞에 호출하는 것입니다. 이렇게 하면 QRhi 백엔드에서 플랫폼 또는 창 시스템별 쿼리를 수행하여 창(및 창이 있는 화면)이 지정된 포맷으로 진정한 HDR 출력이 가능한지 확인할 수 있습니다.

형식이 지원되는 것으로 보고되면 setFormat()를 호출하여 요청된 형식을 설정하고 createOrResize()를 호출합니다. 그러나 HDR 포맷을 성공적으로 요청하려면 다른 색 공간을 처리해야 하고, HDR을 인식하지 못하는 콘텐츠에 대해 화이트 레벨 보정을 수행하고, 톤 매핑 방법을 조정하고, 오프스크린 렌더링 대상 설정을 조정하는 등의 작업이 필요할 수 있으므로 결과에 유의하세요.

setFormat()도 참조하세요 .

[pure virtual] QRhiRenderPassDescriptor *QRhiSwapChain::newCompatibleRenderPassDescriptor()

이 스왑체인과 호환되는 새로운 QRhiRenderPassDescriptor 을 반환합니다.

반환된 값은 setRenderPassDescriptor() 및 QRhiGraphicsPipeline::setRenderPassDescriptor()에 전달할 수 있습니다. 렌더 패스 설명자는 flags()의 영향을 받을 수 있는 어태치먼트(색상, 깊이/스텐실)와 로드/저장 동작을 설명합니다. QRhiGraphicsPipeline 는 compatible QRhiRenderPassDescriptor 가 설정된 스왑체인과 함께만 사용할 수 있습니다.

createOrResize()도 참조하세요 .

QRhiSwapChainProxyData QRhiSwapChain::proxyData() const

현재 설정된 프록시 데이터를 반환합니다.

setProxyData()도 참조하세요 .

QRhiRenderPassDescriptor *QRhiSwapChain::renderPassDescriptor() const

현재 연결된 QRhiRenderPassDescriptor 객체를 반환합니다.

setRenderPassDescriptor()도 참조하세요 .

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

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

리소스 타입을 리턴합니다.

int QRhiSwapChain::sampleCount() const

현재 설정된 샘플 수를 반환합니다. 1은 다중 샘플 앤티앨리어싱이 없음을 의미합니다.

setSampleCount()도 참조하세요 .

void QRhiSwapChain::setDepthStencil(QRhiRenderBuffer *ds)

렌더버퍼 ds 를 뎁스 스텐실 버퍼로 사용하도록 설정합니다.

depthStencil()도 참조하세요 .

void QRhiSwapChain::setFlags(QRhiSwapChain::Flags f)

플래그를 설정합니다 f.

flags()도 참조하세요 .

void QRhiSwapChain::setFormat(QRhiSwapChain::Format f)

f 형식을 설정합니다.

isFormatSupported()에서 지원되지 않는다고 보고된 형식은 설정하지 마세요. 특정 포맷에 대한 지원 여부는 스왑체인의 관련 창이 열리는 화면에 따라 달라질 수 있다는 점에 유의하세요. Windows 및 macOS와 같은 일부 플랫폼에서 HDR 출력이 작동하려면 디스플레이 설정에서 HDR 출력을 사용하도록 설정해야 합니다.

하이 다이나믹 레인지 출력에 대한 자세한 내용은 isFormatSupported(), QRhiSwapChainHdrInfo, Format 을 참조하세요.

format()도 참조하세요 .

void QRhiSwapChain::setProxyData(const QRhiSwapChainProxyData &d)

프록시 데이터를 설정합니다 d.

proxyData() 및 QRhi::updateSwapChainProxyData()도 참조하세요 .

void QRhiSwapChain::setRenderPassDescriptor(QRhiRenderPassDescriptor *desc)

QRhiRenderPassDescriptor desc .

renderPassDescriptor()도 참조하세요 .

void QRhiSwapChain::setSampleCount(int samples)

샘플 수를 설정합니다. samples 의 일반적인 값은 1(MSAA 없음), 4(MSAA 4배) 또는 8(MSAA 8배)입니다.

sampleCount() 및 QRhi::supportedSampleCounts()도 참조하세요 .

void QRhiSwapChain::setWindow(QWindow *window)

window.

window()도 참조하세요 .

[pure virtual] QSize QRhiSwapChain::surfacePixelSize()

창과 연관된 서페이스 또는 레이어의 크기를 반환합니다.

currentPixelSize()도 참조하세요 .

QWindow *QRhiSwapChain::window() const

현재 설정된 창을 반환합니다.

setWindow()도 참조하세요 .