QRhiD3D12InitParams Struct

Direct3D 12 固有の初期化パラメータ。詳細...

Header:	`#include <rhi/qrhi.h>`
CMake:	`find_package(Qt6 REQUIRED COMPONENTS Gui)` `target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate)`
qmake:	`QT += gui-private`
Inherits:	QRhiInitParams

継承メンバを含む全メンバ一覧

パブリック変数

bool	enableDebugLayer

詳細説明

注意: これは互換性が限定的に保証された RHI API です。詳細はQRhi を参照してください。

D3D12ベースのQRhi 、初期化に特別なパラメータは必要ありません。必要であれば、enableDebugLayer をtrue に設定することで、Direct3D デバッグレイヤーを有効にすることができます。これは開発時には便利ですが、製品ビルドでは避けるべきです。

QRhiD3D12InitParams params;
params.enableDebugLayer = true;
rhi = QRhi::create(QRhi::D3D12, &params);

注意: QRhiSwapChain は、サーフェスタイプがQSurface::Direct3DSurface に設定されているQWindow インスタンスと組み合わせてのみ使用してください。

既存の Direct3D 12 デバイスとの連携

別のグラフィックエンジンと相互運用する場合、同じ Direct3D デバイスを使用するQRhi インスタンスを取得する必要があります。これは、QRhiD3D12NativeHandles へのポインタをQRhi::create() に渡すことで実現できます。QRhi は、外部オブジェクトの所有権を一切持ちません。

例えば、QRhi を OpenXR と組み合わせて使用する場合、デバイスの作成はQRhi に任せ、使用するアダプタと、オプションでデバイスに要求する機能レベルを指定したいことがあります。これは、アダプタの LUID と機能レベルを指定する一方で、デバイスポインタを NULL に設定することで実現できます。

オプションとして、commandQueue に NULL 以外の値を設定することで、ID3D12CommandQueue も指定することができる。

メンバ変数ドキュメント

bool QRhiD3D12InitParams::enableDebugLayer

trueに設定すると、デバッグレイヤーがインストールされていて利用可能な場合、デバッグレイヤーが有効になります。デフォルト値はfalseです。

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の商標です。その他すべての商標は、それぞれの所有者に帰属します。