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

swapchain の現在のバックバッファをレンダリングするために beginPass() で使用できるレンダーターゲットを返します。このスワップチェーンで beginFrame() が呼び出されたQRhi::beginFrame() -QRhi::endFrame() ブロック内でのみ有効です。

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

スワップチェーンの左または右のバックバッファにレンダリングするために beginPass() で使用できるレンダーターゲットを返します。このオーバーロードは、ステレオスコピックレンダリング、つまり、関連するQWindow が、1 つだけでなく、それぞれの目に対して 1 つずつ、2 つのカラーバッファによってバックアップされている場合にのみ使用する必要があります。

ステレオスコピックレンダリングがサポートされていない場合、戻り値はデフォルトのターゲットになります。これは、実行時にグラフィックスとディスプレイのドライバスタックでサポートされていることを前提に、QSurfaceFormat::StereoBuffers と組み合わせて、Metal を除くすべてのハードウェアバックエンドでサポートされています。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 がサポートされている場合に true を返す。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 (4x MSAA)、または 8 (8x MSAA) である。

sampleCount() およびQRhi::supportedSampleCounts()も参照 。

void QRhiSwapChain::setWindow(QWindow *window)

window を設定する。

window()も参照 。

[pure virtual] QSize QRhiSwapChain::surfacePixelSize()

戻り値 ウィンドウに関連付けられたサーフェスまたはレイヤーのサイズ。

currentPixelSize()も参照 。

QWindow *QRhiSwapChain::window() const

現在設定されているウィンドウを返します。

setWindow()も参照してください 。