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

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

const QRhiColorAttachment *QRhiTextureRenderTargetDescription::cbeginColorAttachments() const

添付ファイルリストの最初の項目を指す定数イテレータを返します。

const QRhiColorAttachment *QRhiTextureRenderTargetDescription::cendColorAttachments() const

添付ファイルリストの最後のアイテムの直後を指す定数イテレータを返します。

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

指定 し たindex での添付色を返 し ます。

qsizetype QRhiTextureRenderTargetDescription::colorAttachmentCount() const

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

[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.8] void QRhiTextureRenderTargetDescription::setDepthResolveTexture(QRhiTexture *tex)

デプス（またはデプス-ステンシル）リゾルブテクスチャを設定するtex 。

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

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

depthResolveTexture(),QRhiColorAttachment::setResolveTexture(),setDepthTexture()も参照してください 。

void QRhiTextureRenderTargetDescription::setDepthStencilBuffer(QRhiRenderBuffer *renderBuffer)

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

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

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

void QRhiTextureRenderTargetDescription::setDepthTexture(QRhiTexture *texture)

depth-stencil のtexture を設定する。これはsetDepthStencilBuffer() の代替で、QRhiRenderBuffer の代わりに、適切な型 (たとえばQRhiTexture::D32F) を持つQRhiTexture を指定する。

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

depthTexture() およびsetDepthStencilBuffer()も参照 。