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

Documentación de la función miembro

[pure virtual] bool QRhiSwapChain::createOrResize()

Crea la cadena de intercambio si aún no se ha hecho y redimensiona los búferes de la cadena de intercambio para que coincidan con el tamaño actual de la superficie objetivo. Llama a esto siempre que el tamaño de la superficie objetivo sea diferente al anterior.

Devuelve true cuando tiene éxito, false cuando falla una operación gráfica. Independientemente del valor de retorno, llamar a destroy() es siempre seguro.

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

Devuelve un buffer de comandos en el que se pueden grabar comandos de renderizado y actualizaciones de recursos dentro de un bloque beginFrame - endFrame, asumiendo que beginFrame() fue llamado con este swapchain.

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

Devuelve un objetivo de renderizado que puede utilizarse con beginPass() para renderizar el backbuffer actual de la cadena de intercambio. Sólo válido dentro de un bloque QRhi::beginFrame() - QRhi::endFrame() donde beginFrame() fue llamado con esta swapchain.

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

Devuelve un objetivo de renderizado que puede utilizarse con beginPass() para renderizar en la memoria intermedia izquierda o derecha de la cadena de intercambio. Esta sobrecarga sólo debe utilizarse con renderizado estereoscópico, es decir, cuando el QWindow asociado está respaldado por dos buffers de color, uno para cada ojo, en lugar de uno solo.

Cuando el renderizado estereoscópico no está soportado, el valor devuelto será el objetivo por defecto. Es soportado por todos los backends de hardware excepto Metal, en combinación con QSurfaceFormat::StereoBuffers, asumiendo que es soportado por la pila de controladores gráficos y de pantalla en tiempo de ejecución. Los backends Metal y Null devolverán el objetivo de renderizado por defecto desde esta sobrecarga.

QSize QRhiSwapChain::currentPixelSize() const

Devuelve el tamaño con el que la swapchain fue construida con éxito por última vez. Use esto para decidir si createOrResize() necesita ser llamado de nuevo: si currentPixelSize() != surfacePixelSize() entonces la swapchain necesita ser redimensionada.

Aunque en muchos casos el valor es el mismo que QWindow::size() * QWindow::devicePixelRatio(), confiar en el tamaño devuelto por QWindow no garantiza que sea correcto en todas las plataformas e implementaciones de la API gráfica. Por lo tanto, se recomienda encarecidamente utilizar esta función siempre que sea necesario identificar las dimensiones, en píxeles, de la capa o superficie de salida.

Esto también tiene la ventaja añadida de evitar posibles carreras de datos cuando QRhi se utiliza en un hilo de renderizado dedicado, ya que se evita la necesidad de llamar a funciones QWindow, que pueden acceder a datos actualizados en el hilo principal.

Véase también surfacePixelSize().

QRhiRenderBuffer *QRhiSwapChain::depthStencil() const

Devuelve el renderbuffer actualmente asociado para el depth-stencil.

Véase también setDepthStencil().

QRhiSwapChain::Flags QRhiSwapChain::flags() const

Devuelve las banderas configuradas actualmente.

Véase también setFlags().

QRhiSwapChain::Format QRhiSwapChain::format() const

Devuelve el formato configurado actualmente.

Véase también setFormat().

[virtual] QRhiSwapChainHdrInfo QRhiSwapChain::hdrInfo()

Devuelve la información HDR de la pantalla asociada.

No asuma que se trata de una operación barata. Dependiendo de la plataforma, esta función realiza varias consultas a la plataforma que pueden tener un impacto en el rendimiento.

Véase también QRhiSwapChainHdrInfo.

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

Devuelve true si se admite el formato de cadena de intercambio f. SDR siempre es compatible.

El uso principal de esta función es llamarla antes del primer createOrResize() después de que la ventana ya esté configurada. Esto permite a los backends de QRhi realizar consultas específicas a la plataforma o al sistema de ventanas para determinar si la ventana (y la pantalla en la que se encuentra) es capaz de emitir HDR real con el formato especificado.

Cuando el formato es reportado como soportado, se llama a setFormat() para establecer el formato solicitado y se llama a createOrResize(). Sin embargo, ten en cuenta las consecuencias: solicitar con éxito un formato HDR implicará tener que lidiar con un espacio de color diferente, posiblemente haciendo corrección de nivel de blanco para contenido no compatible con HDR, ajustando métodos de mapeado tonal, ajustando la configuración de destino de renderizado fuera de pantalla, etc.

Véase también setFormat().

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

Devuelve un nuevo QRhiRenderPassDescriptor que es compatible con esta swapchain.

El valor devuelto se utiliza de dos maneras: se puede pasar a setRenderPassDescriptor() y QRhiGraphicsPipeline::setRenderPassDescriptor(). Un descriptor de pase de renderizado describe los archivos adjuntos (color, profundidad/esténcil) y el comportamiento de carga/almacenamiento que pueden verse afectados por flags(). Un QRhiGraphicsPipeline sólo puede utilizarse en combinación con un swapchain que tenga establecido un compatible QRhiRenderPassDescriptor .

Véase también createOrResize().

QRhiSwapChainProxyData QRhiSwapChain::proxyData() const

Devuelve los datos proxy configurados actualmente.

Véase también setProxyData().

QRhiRenderPassDescriptor *QRhiSwapChain::renderPassDescriptor() const

Devuelve el objeto QRhiRenderPassDescriptor asociado actualmente.

Véase también setRenderPassDescriptor().

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

Reimplementa: QRhiResource::resourceType() const.

Devuelve el tipo de recurso.

int QRhiSwapChain::sampleCount() const

Devuelve el número de muestras actual. 1 significa que no hay antialiasing multimuestra.

Véase también setSampleCount().

void QRhiSwapChain::setDepthStencil(QRhiRenderBuffer *ds)

Establece el búfer de render ds para su uso como búfer de profundidad.

Véase también depthStencil().

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

Establece las banderas f.

Véase también flags().

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

Establece el formato f.

Evita configurar formatos que isFormatSupported() indique que no son compatibles. Tenga en cuenta que la compatibilidad con un formato determinado puede depender de la pantalla en la que se abra la ventana asociada a la cadena intercambiable. En algunas plataformas, como Windows y macOS, para que la salida HDR funcione es necesario tener activada la salida HDR en la configuración de pantalla.

Consulte isFormatSupported(), QRhiSwapChainHdrInfo, y Format para obtener más información sobre la salida de alto rango dinámico.

Véase también format().

void QRhiSwapChain::setProxyData(const QRhiSwapChainProxyData &d)

Establece los datos proxy d.

Véase también proxyData() y QRhi::updateSwapChainProxyData().

void QRhiSwapChain::setRenderPassDescriptor(QRhiRenderPassDescriptor *desc)

Asociado a QRhiRenderPassDescriptor desc .

Véase también renderPassDescriptor().

void QRhiSwapChain::setSampleCount(int samples)

Establece el recuento de muestras. Los valores habituales para samples son 1 (sin MSAA), 4 (4x MSAA) u 8 (8x MSAA).

Véase también sampleCount() y QRhi::supportedSampleCounts().

[since 6.9] void QRhiSwapChain::setShadingRateMap(QRhiShadingRateMap *map)

Se asocia con el QRhiShadingRateMap especificado map. Esto es funcional sólo cuando la característica QRhi::VariableRateShadingMap es reportada como soportada.

Cuando también se llama a QRhiCommandBuffer::setShadingRate(), se utiliza la mayor de las dos tasas de sombreado para cada mosaico. Actualmente no se ofrece ningún control sobre el comportamiento del combinador.

Esta función se introdujo en Qt 6.9.

Véase también shadingRateMap().

void QRhiSwapChain::setWindow(QWindow *window)

Establece la dirección window.

Véase también window().

[since 6.9] QRhiShadingRateMap *QRhiSwapChain::shadingRateMap() const

Devuelve el valor actual de QRhiShadingRateMap. Por defecto es nullptr.

Esta función se introdujo en Qt 6.9.

Véase también setShadingRateMap().

[pure virtual] QSize QRhiSwapChain::surfacePixelSize()

Devuelve El tamaño de la superficie o capa asociada a la ventana.

Véase también currentPixelSize().

QWindow *QRhiSwapChain::window() const

Devuelve la ventana configurada actualmente.

Véase también setWindow().