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 });

Dokumentation der Mitgliedsfunktionen

[constexpr noexcept default] QRhiTextureRenderTargetDescription::QRhiTextureRenderTargetDescription()

Erstellt eine leere Beschreibung für ein Textur-Renderziel.

QRhiTextureRenderTargetDescription::QRhiTextureRenderTargetDescription(const QRhiColorAttachment &colorAttachment)

Erstellt eine Beschreibung für ein Textur-Render-Target mit einem Anhang, der durch ` colorAttachment` definiert ist.

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

Erstellt eine Beschreibung für ein Textur-Renderziel mit zwei Anhängen: einem Farb-Anhang, der durch colorAttachment beschrieben wird, und einem Tiefen-/Stencil-Anhang mit depthStencilBuffer.

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

Erstellt eine Beschreibung für ein Textur-Renderziel mit zwei Anhängen: einem Farb-Anhang, der durch colorAttachment beschrieben wird, und einem Tiefen-Anhang mit depthTexture.

const QRhiColorAttachment *QRhiTextureRenderTargetDescription::cbeginColorAttachments() const

Gibt einen konstanten Iterator zurück, der auf das erste Element der Anhangsliste verweist.

const QRhiColorAttachment *QRhiTextureRenderTargetDescription::cendColorAttachments() const

Gibt einen const-Iterator zurück, der direkt auf das Element nach dem letzten Element in der Anhangsliste zeigt.

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

Gibt die Farbzuordnung an der angegebenen Adresse „ index “ zurück.

qsizetype QRhiTextureRenderTargetDescription::colorAttachmentCount() const

Gibt die Anzahl der derzeit festgelegten Farbbezeichnungen zurück.

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

Gibt den Index des Array-Ausschnitts zurück, der für die Depth/Stencil-Zuordnung verwendet werden soll, oder standardmäßig -1.

Diese Funktion wurde in Qt 6.12 eingeführt.

Siehe auch „ setDepthLayer()“ und „ setDepthTexture()“.

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

Gibt die Textur zurück, in die eine Multisample-Tiefen- (oder Tiefen-Stencil-)Textur (bzw. ein Textur-Array) aufgelöst wird. „ nullptr “, falls keine vorhanden ist, was der häufigste Fall ist.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch setDepthResolveTexture(), QRhiColorAttachment::resolveTexture() und depthTexture().

QRhiRenderBuffer *QRhiTextureRenderTargetDescription::depthStencilBuffer() const

Gibt den als Depth-Stencil-Buffer verwendeten Renderbuffer zurück oder „ nullptr “, falls keiner festgelegt wurde.

Siehe auch setDepthStencilBuffer().

QRhiTexture *QRhiTextureRenderTargetDescription::depthTexture() const

Gibt die aktuell referenzierte Tiefentextur zurück oder „ nullptr “, falls keine festgelegt wurde.

Siehe auch „ setDepthTexture()“.

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

Legt die „ list “ der Farbanhänge fest.

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

Legt die Liste der Farbanhänge über die Iteratoren first und last fest.

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

Legt den Index des Array-Slices fest, der für die Zuordnung von Tiefe und Schablone verwendet werden soll.

Übergeben Sie -1 (Standardwert), um keine bestimmte Ebene anzusteuern. Bei Angabe eines nicht-negativen Werts fügt das Renderziel eine Ansicht hinzu, die genau diese Ebene (diesen Ausschnitt) der Tiefentextur ansteuert. Dies wirkt sich nur aus, wenn eine 2D-Array-Tiefentextur über ` setDepthTexture()` bereitgestellt wird; andernfalls wird der Wert ignoriert.

Der Wert muss innerhalb der Array-Größe der Tiefentextur liegen; die Übergabe eines Index außerhalb dieses Bereichs führt zu undefiniertem Verhalten. Der Index ist absolut in Bezug auf die zugrunde liegende Textur, unabhängig von einem möglicherweise bei der Erstellung der Textur festgelegten Array-Bereich.

Die Angabe von ` depthLayer ` deaktiviert das Layered-/Multiview-Rendering für den Tiefen-Anhang.

Diese Funktion wurde in Qt 6.12 eingeführt.

Siehe auch ` depthLayer()` und ` setDepthTexture()`.

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

Legt die Textur für die Tiefen- (oder Tiefen-Stencil-)Auflösung fest: tex.

tex Es wird erwartet, dass es sich um eine 2D-Textur oder ein 2D-Textur-Array handelt, dessen Format mit der über ` setDepthTexture()` festgelegten Textur übereinstimmt.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch „ depthResolveTexture()“, „ QRhiColorAttachment::setResolveTexture()“ und „ setDepthTexture()“.

void QRhiTextureRenderTargetDescription::setDepthStencilBuffer(QRhiRenderBuffer *renderBuffer)

Legt den Wert „ renderBuffer “ für Depth-Stencil fest. Dies ist nicht zwingend erforderlich; wenn beispielsweise in keiner Grafikpipeline in einem der Render-Durchläufe für dieses Renderziel Depth-Tests/-Schreibvorgänge oder stencilbezogene Funktionen verwendet werden, kann der Wert auf „ nullptr “ belassen werden.

Die Verwendung eines „ QRhiRenderBuffer “ anstelle eines 2D-„ QRhiTexture “ als Tiefen- oder Tiefen-/Stencil-Puffer ist sehr verbreitet und wird für Anwendungen empfohlen. Die Verwendung eines „ QRhiTexture “ und damit von „ setDepthTexture()“ wird relevant, wenn später auf die Tiefendaten zugegriffen werden soll (z. B. Abtastung in einem Shader) oder wenn „ multiview rendering “ zum Einsatz kommt (da die Tiefentextur dann ein Textur-Array sein muss).

Siehe auch depthStencilBuffer() und setDepthTexture().

void QRhiTextureRenderTargetDescription::setDepthTexture(QRhiTexture *texture)

Legt die „ texture “ für Depth-Stencil fest. Dies ist eine Alternative zu „ setDepthStencilBuffer()“, bei der anstelle eines „ QRhiRenderBuffer “ ein „ QRhiTexture “ mit einem geeigneten Typ (z. B. „ QRhiTexture::D32F “) bereitgestellt wird.

texture kann entweder eine 2D-Textur oder ein 2D-Textur-Array sein (sofern Textur-Arrays unterstützt werden). Die Angabe eines Textur-Arrays ist insbesondere bei multiview rendering relevant.

Siehe auch „ depthTexture()“ und „ setDepthStencilBuffer()“.

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

Wird mit dem angegebenen „ QRhiShadingRateMap “ verknüpft: map. Diese Funktion ist nur verfügbar, wenn die Funktion „ QRhi::VariableRateShadingMap “ als unterstützt gemeldet wird.

Wird zusätzlich „ QRhiCommandBuffer::setShadingRate()“ aufgerufen, wird für jede Kachel die höhere der beiden Shading-Raten verwendet. Derzeit gibt es keine Möglichkeit, das Verhalten des Kombinators zu steuern.

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch shadingRateMap().

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

Gibt den aktuell eingestellten Wert für „ QRhiShadingRateMap “ zurück. Standardmäßig ist dies „ nullptr “.

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch ` setShadingRateMap()`.