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 イテレータを返します。

const QRhiColorAttachment *QRhiTextureRenderTargetDescription::cendColorAttachments() const

添付リストの最後の項目の直後を指す 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()も参照してください 。