QRhiTextureRenderTargetDescription Class

QRhiTexture *texture = rhi->newTexture(QRhiTexture::RGBA8, QSize(256, 256), 1, QRhiTexture::RenderTarget);
texture->create();
QRhiTextureRenderTarget *rt = rhi->newTextureRenderTarget({ texture }));

QRhiTexture *texture = rhi->newTexture(QRhiTexture::RGBA8, QSize(512, 512), 1, QRhiTexture::RenderTarget | QRhiTexture::MipMapped);
texture->create();
QRhiColorAttachment colorAtt(texture);
colorAtt.setLevel(2);
QRhiTextureRenderTarget *rt = rhi->newTextureRenderTarget({ colorAtt });

QRhiTexture *shadowMap = rhi->newTexture(QRhiTexture::D32F, QSize(1024, 1024), 1, QRhiTexture::RenderTarget);
shadowMap->create();
QRhiTextureRenderTargetDescription rtDesc;
rtDesc.setDepthTexture(shadowMap);
QRhiTextureRenderTarget *rt = rhi->newTextureRenderTarget(rtDesc);

QRhiTexture *texture = rhi->newTexture(QRhiTexture::RGBA8, QSize(512, 512), 1, QRhiTexture::RenderTarget);
texture->create();
QRhiRenderBuffer *depthStencil = rhi->newRenderBuffer(QRhiRenderBuffer::DepthStencil, QSize(512, 512));
depthStencil->create();
QRhiTextureRenderTargetDescription rtDesc({ texture }, depthStencil);
QRhiTextureRenderTarget *rt = rhi->newTextureRenderTarget(rtDesc);

QRhiRenderBuffer *colorBuffer = rhi->newRenderBuffer(QRhiRenderBuffer::Color, QSize(512, 512), 4); // 4x MSAA
colorBuffer->create();
QRhiRenderBuffer *depthStencil = rhi->newRenderBuffer(QRhiRenderBuffer::DepthStencil, QSize(512, 512), 4);
depthStencil->create();
QRhiTexture *texture = rhi->newTexture(QRhiTexture::RGBA8, QSize(512, 512), 1, QRhiTexture::RenderTarget);
texture->create();
QRhiColorAttachment colorAtt(colorBuffer);
colorAtt.setResolveTexture(texture);
QRhiTextureRenderTarget *rt = rhi->newTextureRenderTarget({ colorAtt, depthStencil });

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

[constexpr noexcept default] QRhiTextureRenderTargetDescription::QRhiTextureRenderTargetDescription()

空のテクスチャ・レンダーターゲット記述を作成します。

QRhiTextureRenderTargetDescription::QRhiTextureRenderTargetDescription(const QRhiColorAttachment &colorAttachment)

colorAttachment で定義される1つのアタッチメントを持つテクスチャ・レンダリングターゲットの記述を構築します。

QRhiTextureRenderTargetDescription::QRhiTextureRenderTargetDescription(const QRhiColorAttachment &colorAttachment, QRhiRenderBuffer *depthStencilBuffer)

colorAttachment で記述されるカラーアタッチメントと、depthStencilBuffer で記述される深度／ステンシルアタッチメントの2つのアタッチメントを持つテクスチャ・レンダリングターゲット記述を構築します。

QRhiTextureRenderTargetDescription::QRhiTextureRenderTargetDescription(const QRhiColorAttachment &colorAttachment, QRhiTexture *depthTexture)

2つのアタッチメントを持つテクスチャ・レンダリング・ターゲット記述を構築します。1つはcolorAttachment で記述されるカラー・アタッチメント、もう1つはdepthTexture で記述される深度アタッチメントです。

const QRhiColorAttachment *QRhiTextureRenderTargetDescription::cbeginColorAttachments() const

添付リストの最初の項目を指す const イテレータを返します。

const QRhiColorAttachment *QRhiTextureRenderTargetDescription::cendColorAttachments() const

添付リストの最後の項目の直後を指す const イテレータを返します。

const QRhiColorAttachment *QRhiTextureRenderTargetDescription::colorAttachmentAt(qsizetype index) const

指定されたindex の位置にあるカラーアタッチメントを返します。

qsizetype QRhiTextureRenderTargetDescription::colorAttachmentCount() const

現在設定されているカラーアタッチメントの数を返します。

[since 6.12] int QRhiTextureRenderTargetDescription::depthLayer() const

深度/ステンシルアタッチメントに使用される配列スライスのインデックスを返します。デフォルトでは -1 を返します。

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

setDepthLayer() およびsetDepthTexture()も参照してください 。

[since 6.8] QRhiTexture *QRhiTextureRenderTargetDescription::depthResolveTexture() const

マルチサンプル深度（または深度・ステンシル）テクスチャ（またはテクスチャ配列）が解決されるテクスチャを返します。該当するテクスチャがない場合は `nullptr ` を返します。これは最も一般的なケースです。

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

setDepthResolveTexture()、QRhiColorAttachment::resolveTexture()、およびdepthTexture()も参照してください 。

QRhiRenderBuffer *QRhiTextureRenderTargetDescription::depthStencilBuffer() const

深度・ステンシルバッファとして使用されるレンダリングバッファを返します。設定されていない場合は、nullptr を返します。

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

QRhiTexture *QRhiTextureRenderTargetDescription::depthTexture() const

現在参照されている深度テクスチャを返します。設定されていない場合は、nullptr を返します。

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

void QRhiTextureRenderTargetDescription::setColorAttachments(std::initializer_list<QRhiColorAttachment> list)

カラーアタッチメントのlist を設定します。

template <typename InputIterator> void QRhiTextureRenderTargetDescription::setColorAttachments(InputIterator first, InputIterator last)

イテレータ `first ` および `last` を使用して、カラーアタッチメントのリストを設定します。

[since 6.12] void QRhiTextureRenderTargetDescription::setDepthLayer(int depthLayer)

深度/ステンシルアタッチメントに使用する配列のスライスインデックスを設定します。

特定のレイヤーをターゲットにしない場合は、-1（デフォルト）を渡します。非負の値に設定すると、レンダリングターゲットは、深度テクスチャのそのレイヤー（スライス）を正確にターゲットとするビューをアタッチします。これは、setDepthTexture() を通じて 2D 配列の深度テクスチャが提供された場合にのみ有効です。それ以外の場合は、この値は無視されます。

値は深度テクスチャの配列サイズ範囲内である必要があります。範囲外のインデックスを指定すると、未定義の挙動となります。インデックスは、テクスチャの作成時に指定された配列範囲に関係なく、基になるテクスチャに対して絶対的なものです。

depthLayer を指定すると、深度アタッチメントに対するレイヤード／マルチビューレンダリングが無効になります。

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

depthLayer() およびsetDepthTexture()も参照してください 。

[since 6.8] void QRhiTextureRenderTargetDescription::setDepthResolveTexture(QRhiTexture *tex)

tex を使用して、深度（または深度・ステンシル）解像度テクスチャを設定します。

tex setDepthTexture() を通じて設定されたテクスチャとフォーマットが一致する 2D テクスチャまたは 2D テクスチャ配列であることが期待されます。

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

関連項目： depthResolveTexture()、QRhiColorAttachment::setResolveTexture()、およびsetDepthTexture()。

void QRhiTextureRenderTargetDescription::setDepthStencilBuffer(QRhiRenderBuffer *renderBuffer)

深度・ステンシル用のrenderBuffer を設定します。必須ではありません。例えば、このレンダリングターゲットのいずれかのレンダリングパスにおいて、グラフィックスパイプライン内で深度テスト／書き込みやステンシル関連の機能が一切使用されていない場合は、nullptr に設定したままにしておくことができます。

2DQRhiTexture ではなく、QRhiRenderBuffer を深度または深度/ステンシルバッファとして使用することは非常に一般的であり、アプリケーションではこのアプローチが推奨されます。QRhiTexture を使用する場合、深度データに後でアクセスする（たとえば、シェーダーでサンプリングする）場合や、multiview rendering が関与する場合（その場合は深度テクスチャがテクスチャ配列でなければならないため）、setDepthTexture()が重要になります。

depthStencilBuffer() およびsetDepthTexture()も参照してください 。

void QRhiTextureRenderTargetDescription::setDepthTexture(QRhiTexture *texture)

深度・ステンシル用のtexture を設定します。これはsetDepthStencilBuffer()の代替手段であり、QRhiRenderBuffer の代わりに、適切な型（例：QRhiTexture::D32F ）を持つQRhiTexture を指定します。

texture は、2Dテクスチャか、2Dテクスチャ配列（テクスチャ配列がサポートされている場合）のいずれかです。テクスチャ配列の指定は、特にmultiview rendering に関連します。

depthTexture() およびsetDepthStencilBuffer()も参照してください 。

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

指定されたQRhiShadingRateMap map と関連付けられます。これは、QRhi::VariableRateShadingMap 機能がサポートされていると報告されている場合にのみ機能します。

QRhiCommandBuffer::setShadingRate() も呼び出された場合、各タイルに対して 2 つのシェーディングレートのうち高い方が使用されます。現在、コンバイナの動作を制御する手段は提供されていません。

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

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

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

現在設定されているQRhiShadingRateMap を返します。デフォルトでは、nullptr です。

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

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