QRhiSwapChain 类

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

成员函数文档

[纯虚函数] bool QRhiSwapChain::createOrResize()

如果尚未创建，则创建交换链，并调整交换链缓冲区的大小以匹配目标表面的当前尺寸。当目标表面的尺寸与之前不同时，请调用此函数。

成功时返回 true，图形操作失败时返回 false。无论返回值如何，调用 destroy() 总是安全的。

[纯虚函数] QRhiCommandBuffer *QRhiSwapChain::currentFrameCommandBuffer()

返回一个可以在 beginFrame - endFrame 块内记录渲染命令和资源更新的命令缓冲区，前提是使用此交换链调用了 beginFrame()。

[纯虚函数] QRhiRenderTarget *QRhiSwapChain::currentFrameRenderTarget()

返回一个可以与 beginPass() 一起使用以便渲染交换链当前后缓冲区的渲染目标。仅在调用 beginFrame() 时使用此交换链的 QRhi::beginFrame() - QRhi::endFrame() 块内有效。

[虚拟] QRhiRenderTarget *QRhiSwapChain::currentFrameRenderTarget(QRhiSwapChain::StereoTargetBuffer targetBuffer)

返回一个可以通过 beginPass() 用于将渲染到交换链的左或右后缓冲区的渲染目标。此重载只有在立体渲染时才应使用，即在关联的 QWindow 由两个颜色缓冲区支持时，每个眼睛一个，而不是只有一个。

当不支持立体渲染时，返回值将是默认目标。Metal和Null后端不支持立体渲染，仅当运行时图形和显示驱动程序堆栈支持时才支持，除非是Metal，与 QSurfaceFormat::StereoBuffers 结合使用。

QSize QRhiSwapChain::currentPixelSize() const

返回上次成功构建swapchain时的大小。使用此信息来决定是否需要再次调用createOrResize()：如果currentPixelSize() != surfacePixelSize()，则需要调整swapchain的大小。

虽然在不 nombreuses情况下，这个值与QWindow::size() * QWindow::devicePixelRatio()相同，但依赖于QWindow报告的大小并不保证在所有平台和图形API实现上都正确。因此，在需要识别输出层或表面的像素尺寸时，强烈建议使用此函数。

此外，这还有一个好处，可以避免在专用的渲染线程中使用QRhi时潜在的竞态条件，因为避免了调用可能会访问主线程上更新的数据的QWindow函数。

另请参阅surfacePixelSize。

QRhiRenderBuffer *QRhiSwapChain::depthStencil() const

返回当前关联的用于深度-模板的rendebuffer。

另请参阅setDepthStencil。

QRhiSwapChain::Flags QRhiSwapChain::flags() const

返回当前设置的标志。

另请参阅setFlags。

QRhiSwapChain::Format QRhiSwapChain::format() const

返回当前设置的格式。

另请参阅setFormat。

[虚拟] QRhiSwapChainHdrInfo QRhiSwapChain::hdrInfo()

返回关联显示的高动态范围信息。

不要假设这是一个便宜的操作。根据平台的不同，此函数会执行各种平台查询，可能会影响性能。

另请参阅QRhiSwapChainHdrInfo。

[纯净虚拟] 布尔值 QRhiSwapChain::isFormatSupported(QRhiSwapChain::Format f)

如果给定的swapchain格式f受支持，则返回true。SDR始终受支持。

该函数的主要用途是在设置窗口之后调用createOrResize()之前调用它。这允许QRhi后端执行平台或窗口系统特定的查询，以确定窗口（及其屏幕）是否能够使用指定的格式输出真正的HDR。

当格式报告为支持时，调用setFormat()设置请求的格式，并调用createOrResize()。但是请注意后果：成功请求HDR格式将涉及处理不同的色彩空间，可能需要对非HDR感知内容进行白场校正，调整色调映射方法，调整离屏渲染目标设置等。

另请参阅setFormat。

[纯虚函数] QRhiRenderPassDescriptor *QRhiSwapChain::newCompatibleRenderPassDescriptor()

返回一个与新swapchain兼容的QRhiRenderPassDescriptor。

返回值有两种用途：它可以传递给setRenderPassDescriptor()和QRhiGraphicsPipeline::setRenderPassDescriptor()。渲染通道描述符描述了附件（颜色、深度/模板）和加载/存储行为，这些行为可以受到flags的影响。一个QRhiGraphicsPipeline只能与设置有兼容QRhiRenderPassDescriptor的swapchain一起使用。

另请参阅 createOrResize。

QRhiSwapChainProxyData QRhiSwapChain::proxyData() const

返回当前设置的代理数据。

另请参阅 setProxyData。

QRhiRenderPassDescriptor *QRhiSwapChain::renderPassDescriptor() const

返回当前关联的QRhiRenderPassDescriptor对象。

另请参阅 setRenderPassDescriptor。

[重写虚函数] 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（4x MSAA）或8（8x MSAA）。

另请参阅 sampleCount和QRhi::supportedSampleCounts。

void QRhiSwapChain::setWindow(QWindow *window)

设置window。

另请参阅 window。

[纯虚函数] QSize QRhiSwapChain::surfacePixelSize()

返回窗口关联的表面或层的尺寸。

另请参阅：currentPixelSize().

QWindow *QRhiSwapChain::window() const

返回当前已设置的窗口。

另请参阅：setWindow().