QQuickGraphicsConfiguration Class

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);

    QQuickGraphicsConfiguration config;
    config.setDebugLayer(true);

    QQuickView *view = new QQuickView;
    view->setGraphicsConfiguration(config);

    view->setSource(QUrl::fromLocalFile("myqmlfile.qml"));
    view->show();
    return app.exec();
}

Total time spent on pipeline creation during the lifetime of the QRhi was 123 ms

Attempting to seed pipeline cache from 'filename'

Writing pipeline cache contents to 'filename'

メンバ関数のドキュメント

QQuickGraphicsConfiguration::QQuickGraphicsConfiguration()

シーングラフを考慮するための追加設定を指定しないデフォルトの QQuickGraphicsConfiguration を構築します。

[noexcept] QQuickGraphicsConfiguration::~QQuickGraphicsConfiguration()

デストラクタ。

QByteArrayList QQuickGraphicsConfiguration::deviceExtensions() const

要求された追加デバイス拡張のリストを返します。

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

[since 6.5] bool QQuickGraphicsConfiguration::isAutomaticPipelineCacheEnabled() const

自動パイプラインキャッシュが有効な場合、true を返します。

デフォルトでは、特定のアプリケーション属性または環境変数が設定されていない限り、これは true です。詳細はThe Automatic Pipeline Cache を参照してください。

この関数は Qt 6.5 で導入されました。

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

bool QQuickGraphicsConfiguration::isDebugLayerEnabled() const

デバッグ/検証レイヤーを有効にする場合、true を返します。

デフォルトでは false です。

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

bool QQuickGraphicsConfiguration::isDebugMarkersEnabled() const

デバッグマーカーを有効にする場合に true を返します。

デフォルトでは false です。

setDebugMarkers() も参照 。

bool QQuickGraphicsConfiguration::isDepthBufferEnabledFor2D() const

2D コンテンツで深度バッファの使用が有効になっている場合に true を返します。

デフォルトでは、QSG_NO_DEPTH_BUFFER 環境変数が設定されていない限り、値は true です。

QString QQuickGraphicsConfiguration::pipelineCacheLoadFile() const

パイプラインキャッシュを読み込むために現在設定されているファイル名を返します。

デフォルトでは、値は空文字列です。

setPipelineCacheLoadFile()も参照 。

QString QQuickGraphicsConfiguration::pipelineCacheSaveFile() const

パイプライン・キャッシュを保存するために現在設定されているファイル名を返します。

既定では、値は空文字列です。

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

[static, since 6.1] QByteArrayList QQuickGraphicsConfiguration::preferredInstanceExtensions()

Qt Quick が VkInstance で有効にすることを好む Vulkan インスタンス拡張のリストを返します。

ほとんどの場合、Qt Quick はQVulkanInstance を作成します。 その場合、この関数は関係ありません。一方、QQuickRenderControl を Vulkan ベースのレンダリングと組み合わせて使用する場合、QVulkanInstance を作成し、（画面外の）QQuickWindow と関連付けるのはアプリケーションの責任です。この場合、QVulkanInstance::create() を呼び出す前に、アプリケーションが有効にするインスタンス拡張のリストを照会し、QVulkanInstance::setExtensions() に渡すことが期待されます。

この関数は Qt 6.1 で導入されました。

bool QQuickGraphicsConfiguration::prefersSoftwareDevice() const

ソフトウェア・ラスタライザー・ベースのグラフィック・デバイスが優先される場合、true を返します。

デフォルトでは false です。

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

[since 6.5] void QQuickGraphicsConfiguration::setAutomaticPipelineCache(bool enable)

enable に基づいて、自動パイプラインキャッシュの使用方法を変更します。

特定のアプリケーション属性または環境変数が設定されていない限り、デフォルト値はtrueです。詳細はThe Automatic Pipeline Cache を参照してください。

この関数は Qt 6.5 で導入されました。

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

[since 6.5] void QQuickGraphicsConfiguration::setDebugLayer(bool enable)

グラフィックス API 実装のデバッグレイヤーまたは検証レイヤーがあれば、それを有効にします。

実際には、必要なサポート（検証レイヤー、Windows SDK）がインストールされ、実行時に利用可能であれば、Vulkan と Direct 3D 11 でサポートされます。enable が true の場合、Qt は VkInstance 上で標準の検証レイヤーを有効にするか、グラフィックデバイスにD3D11_CREATE_DEVICE_DEBUG を設定しようとします。

macOS 上の Metal の場合は、アプリケーションを起動する前に、代わりに環境変数METAL_DEVICE_WRAPPER_TYPE=1 を設定します。

enable を true に設定してこの関数を呼び出すことは、環境変数QSG_RHI_DEBUG_LAYER を 0 以外の値に設定することと同じです。

デフォルト値はfalseです。

この関数は Qt 6.5 で導入されました。

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

[since 6.5] void QQuickGraphicsConfiguration::setDebugMarkers(bool enable)

該当する場合、enable は、デバッグマーカーとオブジェクト名をグラフィックスコマンドストリームに挿入することを制御します。

Qt Quick 3Dのようないくつかのフレームワークでは、作成されたグラフィックオブジェクト（バッファ、テクスチャ）に名前を付けたり、レンダリングパスの開始と終了をコマンドバッファに表示したりすることができます。これらは、RenderDocやXCodeのようなツールで作成されたフレームキャプチャで見ることができます。

これがサポートされることが期待されるグラフィックスAPIは、Vulkan（VK_EXT_debug_utilsが利用可能な場合）、Direct 3D 11、およびMetalです。

enable を true に設定してこの関数を呼び出すことは、環境変数QSG_RHI_PROFILE を 0 以外の値に設定することと同じです。

デフォルト値はfalseです。

この関数は Qt 6.5 で導入されました。

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

void QQuickGraphicsConfiguration::setDepthBufferFor2D(bool enable)

2D コンテンツの深度バッファの使用率をenable に設定します。無効にすると、Qt Quick のシーングラフは深度バッファに書き込まれません。

デフォルトでは、QSG_NO_DEPTH_BUFFER 環境変数が設定されていない限り、この値は true です。

デフォルト値の true は、大半のシーンで最も最適な設定です。深度バッファの使用を無効にすると、シーングラフのバッチ処理の効率が低下します。

しかし、2D コンテンツの深度バッファへの書き込みを許可することが理想的でない場合もあります。View3D renderMode をOverlay に設定した Qt Quick 3D を使用してレンダリングした、2D シーン上の「オーバーレイ」としての 3D シーンを考えてみましょう。この場合、2D コンテンツによって深度バッファが満たされると、予期しない結果を引き起こす可能性があります。これは、2D シーン グラフ レンダラーが深度値を生成して処理する方法が、3D シーンの動作方法と必ずしも互換性がないためです。このため、深度値の衝突、衝突、予期しない深度テストの失敗が発生する可能性があります。したがって、enable を false に設定してこの関数を呼び出し、QQuickWindow の 2D コンテンツの深度バッファ書き込みを無効にするのが、堅牢なアプローチです。

void QQuickGraphicsConfiguration::setDeviceExtensions(const QByteArrayList &extensions)

グラフィックスデバイス（VkDevice など）で有効にする追加extensions のリストを設定します。

この概念が適用されないグラフィックス API でレンダリングする場合、extensions は無視されます。

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

[since 6.5] void QQuickGraphicsConfiguration::setPipelineCacheLoadFile(const QString &filename)

QQuickWindow がグラフィックス/計算パイプラインキャッシュの初期コンテンツをロードするfilename を設定します。デフォルト値は空で、これはパイプラインキャッシュのロードが無効であることを意味します。

パイプラインキャッシュについては、Pipeline Cache Save and Load を参照してください。

パイプラインキャッシュを永続的に保存すると、高価なシェーダコンパイルとパイ プライン構築のステップを回避できるため、アプリケーションの将来 の実行における性能向上につながる可能性があります。

ファイルの内容のロードがいつ行われるかは定義されていません。QQuickWindow のシーングラフの初期化中のある時点で行われます。したがって、この関数を呼び出した後も、ファイルは存在し続けなければなりません。QQuickGraphicsConfiguration はファイル名を保存するだけで、それ自体で実際の入出力やグラフィック操作を実行することはできません。実際の作業は、後で、場合によっては別のスレッドで行われる。

パイプライン・キャッシュ（またはシェーダー／プログラム・バイナリ）の取得と再読み込みが適用できないか、サポートされていないグラフィックスAPIで実行する場合、この関数を呼び出しても何の効果もありません。

この関数を呼び出すことは、環境変数QSG_RHI_PIPELINE_CACHE_LOAD をfilename に設定することとほぼ同じですが、1つ重要な違いがあります。この関数は、関連するQQuickWindow のパイプライン・キャッシュ・ストレージのみを制御します。したがって、複数のQQuickWindow またはQQuickView インスタンスを持つアプリケーションは、各ウィンドウ専用のファイルによってキャッシュの内容を保存し、後で再読み込みすることができます。環境変数はこれを許さない。

この関数は Qt 6.5 で導入されました。

pipelineCacheLoadFile() およびsetPipelineCacheSaveFile()も参照してください 。

[since 6.5] void QQuickGraphicsConfiguration::setPipelineCacheSaveFile(const QString &filename)

QQuickWindow がグラフィックス/計算パイプラインキャッシュの内容を格納するfilename を設定します。デフォルト値は空で、これはパイプラインキャッシュの読み込みが無効であることを意味します。

パイプラインキャッシュについては、Pipeline Cache Save and Load を参照してください。

パイプラインキャッシュを永続的に保存すると、高価なシェーダコンパイルとパイプ ライン構築のステップを回避できるため、アプリケーションの将来の実行でパフ ォーマンスが向上する可能性があります。

ファイルの書き込みがいつ行われるかは定義されていません。おそらく、ウィンドウを閉じるためにシーングラ フをテールダウンするときに起こるでしょう。したがって、アプリケーションは、QQuickWindow が完全にデストラクトされるまで、ファイルが利用可能であると仮定すべきではありません。QQuickGraphicsConfiguration は、ファイル名を保存するだけで、実際のI/Oやグラフィックス操作は行いません。

パイプライン・キャッシュ（またはシェーダー／プログラム・バイナリ）の取得が適用できないか、サポートされていないグラフィックスAPIで実行する場合、この関数を呼び出しても何の効果もありません。

この関数を呼び出すことは、環境変数QSG_RHI_PIPELINE_CACHE_SAVE をfilename に設定することとほぼ同じですが、1つ重要な違いがあります。この関数は、関連するQQuickWindow のパイプライン・キャッシュ・ストレージのみを制御します。したがって、複数のQQuickWindow またはQQuickView インスタンスを持つアプリケーションは、各ウィンドウ専用のファイルによってキャッシュの内容を保存し、後で再読み込みすることができます。環境変数はこれを許しません。

この関数は Qt 6.5 で導入されました。

pipelineCacheSaveFile(),pipelineCacheLoadFile(), setPipelineCacheSaveFile()も参照してください 。

[since 6.5] void QQuickGraphicsConfiguration::setPreferSoftwareDevice(bool enable)

ソフトウェアベースのラスタライズを使用するアダプタまたは物理デバイスの選択を要求します。基礎となる API がアダプタの列挙をサポートしている場合にのみ適用され (たとえば、Direct 3D や Vulkan)、それ以外の場合は無視されます。

グラフィックスAPIの実装にそのようなグラフィックスアダプターや物理デバイスがない場合、リクエストは無視されます。Direct 3D では、WARP ベースのラスタライザが常に利用可能であることが期待できます。Vulkan では、このフラグは Mesa のlavapipe 、またはVK_PHYSICAL_DEVICE_TYPE_CPU を報告する他の物理デバイスが利用可能な場合にのみ効果があります。

enable を true に設定してこの関数を呼び出すことは、環境変数QSG_RHI_PREFER_SOFTWARE_RENDERER を 0 以外の値に設定することと同じです。

デフォルト値は false です。

この関数は Qt 6.5 で導入されました。

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

[since 6.6] void QQuickGraphicsConfiguration::setTimestamps(bool enable)

有効にすると、これがサポートされているプラットフォームと 3D API 上で、GPU タイミングデータがコマンドバッファから収集されます。このデータは、QSG_RENDER_TIMING 環境変数や、qt.scenegraph.time.renderloop などのロギングカテゴリで有効にできるレンダラーのログに出力され、Qt Quick 3D のDebugView アイテムなど、他のモジュールからも見えるようになります。

デフォルトでは、これは無効になっています。なぜなら、データを収集するには、コマンドストリームにタイムスタンプクエリを挿入するなど、基礎となるグラフィックスAPIによって追加の作業が必要になる場合があるからです。有効にするには、enable を true に設定してこの関数を呼び出すか、QSG_RHI_PROFILE 環境変数を 0 以外の値に設定します。

これがサポートされることが期待できるグラフィックスAPIは、Direct 3D 11、Direct 3D 12、Vulkan（基盤となるVulkan実装がタイムスタンプクエリをサポートしている限り）、Metal、およびバージョン3.3以降のコアまたは互換性プロファイルコンテキストを持つOpenGLです。タイムスタンプはOpenGL ESではサポートされていません。

この関数は Qt 6.6 で導入されました。

timestampsEnabled() およびsetDebugMarkers()も参照してください 。

[since 6.6] bool QQuickGraphicsConfiguration::timestampsEnabled() const

GPU タイミング収集が有効な場合に true を返します。

デフォルトでは false です。

この関数は Qt 6.6 で導入されました。

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