QRhiColorAttachment Class

Dokumentation zu den Member-Funktionen

[constexpr noexcept default] QRhiColorAttachment::QRhiColorAttachment()

Erstellt eine leere Beschreibung für einen Farbanhang.

QRhiColorAttachment::QRhiColorAttachment(QRhiRenderBuffer *renderBuffer)

Erstellt eine Beschreibung für eine Farbzuordnung, die „ renderBuffer “ als zugehörigen Farbpuffer angibt.

QRhiColorAttachment::QRhiColorAttachment(QRhiTexture *texture)

Erstellt eine Beschreibung einer Farbzuordnung, die „ texture “ als zugehörigen Farbpuffer angibt.

int QRhiColorAttachment::layer() const

Gibt den Layer-Index zurück (Cubemap-Fläche oder Array-Layer). Standardwert: 0.

Siehe auch „ setLayer()“.

int QRhiColorAttachment::level() const

Gibt die Mip-Stufe zurück. Standardwert ist 0.

Siehe auch „ setLevel()“.

[since 6.7] int QRhiColorAttachment::multiViewCount() const

Gibt die aktuell festgelegte Anzahl von Ansichten zurück. Der Standardwert ist 0, was bedeutet, dass das Renderziel mit dieser Farbzuordnung nicht für das Multiview-Rendering verwendet wird.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch ` setMultiViewCount()`.

QRhiRenderBuffer *QRhiColorAttachment::renderBuffer() const

Gibt den Renderbuffer zurück, auf den sich diese Attachment-Beschreibung bezieht, oder nullptr, falls keiner vorhanden ist.

In der Praxis ist die Verknüpfung eines „ QRhiRenderBuffer “ mit einem „ QRhiColorAttachment “ am sinnvollsten, wenn Multisample-Rendering über einen Multisample-Renderbuffer („ color “) eingerichtet wird, der am Ende des Renderdurchgangs in eine Nicht-Multisample-Textur aufgelöst wird.

Siehe auch setRenderBuffer().

int QRhiColorAttachment::resolveLayer() const

Gibt die aktuell eingestellte Textur-Auflösungs-Ebene zurück. Der Standardwert ist 0.

Siehe auch „ setResolveLayer()“.

int QRhiColorAttachment::resolveLevel() const

Gibt die aktuell eingestellte Mip-Stufe der Resolve-Textur zurück. Der Standardwert ist 0.

Siehe auch „ setResolveLevel()“.

QRhiTexture *QRhiColorAttachment::resolveTexture() const

Gibt die „resolve“-Textur zurück, auf die diese Anhangsbeschreibung verweist, oder „ nullptr “, falls keine vorhanden ist.

Das Festlegen einer von „null“ verschiedenen Resolve-Textur ist dann sinnvoll, wenn der Anhang auf eine Multisample-Textur oder einen Renderbuffer verweist. Die „ QRhiTexture “ in der Funktion „resolveTexture()“ ist dann eine nicht-Multisample-2D-Textur (oder ein Textur-Array) mit derselben Größe (jedoch einer Sample-Anzahl von 1). Der Multisample-Inhalt wird am Ende jedes Render-Durchlaufs automatisch in diese Textur aufgelöst.

Siehe auch ` setResolveTexture()`.

void QRhiColorAttachment::setLayer(int layer)

Legt den Index „ layer “ fest.

Siehe auch layer().

void QRhiColorAttachment::setLevel(int level)

Legt den Mip- level fest.

Siehe auch level().

[since 6.7] void QRhiColorAttachment::setMultiViewCount(int count)

Legt die Ansicht „ count “ fest. Ein Wert größer als 1 bedeutet, dass das Renderziel mit diesem Farb-Attachment für das Multiview-Rendering verwendet wird. Der Standardwert ist 0. Werte kleiner als 2 bedeuten, dass kein Multiview-Rendering erfolgt.

Wenn „ count “ auf „ 2 “ oder höher gesetzt ist, muss der Farb-Anhang mit einem 2D-Textur-Array verknüpft sein. „ layer()“ und „ multiViewCount()“ definieren gemeinsam den Bereich der Textur-Array-Elemente, die beim Multiview-Rendering als Ziel dienen.

Wenn beispielsweise ` layer ` auf ` 0 ` und ` multiViewCount ` auf ` 2` gesetzt ist, muss das Textur-Array 2 (oder mehr) Elemente enthalten, und das Multiview-Rendering zielt auf die Elemente 0 und 1 ab. Die Variable ` gl_ViewIndex ` in den Shadern hat dann den Wert ` 0 ` oder ` 1 `, wobei die Ansicht ` 0 ` dem Textur-Array-Element ` 0` entspricht und die Ansicht ` 1 ` dem Array-Element ` 1`.

Weitere Details zum Multiview-Rendering finden Sie unter GL_OVR_multiview. Beachten Sie, dass Qt bei der Ausführung unter OpenGL (ES) zusätzlich GL_OVR_multiview2 erfordert.

Multiview-Rendering ist nur verfügbar, wenn die Funktion „ MultiView “ laut isFeatureSupported() als unterstützt gemeldet wird.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch ` multiViewCount()`.

void QRhiColorAttachment::setRenderBuffer(QRhiRenderBuffer *rb)

Legt den Renderbuffer „ rb “ fest.

Siehe auch ` renderBuffer()`.

void QRhiColorAttachment::setResolveLayer(int layer)

Legt die zu verwendende Auflösungstextur „ layer “ fest.

Siehe auch ` resolveLayer()`.

void QRhiColorAttachment::setResolveLevel(int level)

Legt den zu verwendenden Mip- level für die Resolve-Textur fest.

Siehe auch „ resolveLevel()“.

void QRhiColorAttachment::setResolveTexture(QRhiTexture *tex)

Legt die Auflösung der Textur tex fest.

tex Es wird erwartet, dass es sich um eine 2D-Textur oder ein 2D-Textur-Array handelt. In beiden Fällen zielt die Auflösung auf eine einzelne Mip-Stufe einer einzelnen Ebene (Array-Element) von ` tex` ab. Die Mip-Stufe und die Array-Ebene werden durch ` resolveLevel()` und ` resolveLayer()` festgelegt.

Eine Ausnahme bildet ` multiview`: Wenn der Farb-Attachment einem Textur-Array zugeordnet ist und „Multiview“ aktiviert ist, muss die aufgelöste Textur ebenfalls ein Textur-Array mit ausreichend Elementen für alle Ansichten sein. In diesem Fall werden alle Elemente, die den Ansichten entsprechen, automatisch aufgelöst; das Verhalten ähnelt dem folgenden Pseudocode:

for (i = 0; i < multiViewCount(); ++i)
    resolve texture's layer() + i into resolveTexture's resolveLayer() + i

Das Festlegen einer Nicht-Multisample-Textur, um eine Multisample-Textur oder einen Renderbuffer am Ende des Render-Durchgangs automatisch aufzulösen, ist oft der Arbeit mit Multisample-Texturen (und dem Verzicht auf eine „resolve“-Textur) vorzuziehen, da dadurch das Schreiben spezieller Fragment-Shader vermieden wird, die ausschließlich mit Multisample-Texturen arbeiten (sampler2DMS, texelFetch, usw.) und ermöglicht stattdessen die Verwendung desselben Shaders, wie man ihn verwenden würde, wenn die Textur des Attachments von vornherein kein Multisample wäre. Dies geht zu Lasten einer zusätzlichen Ressource (der Nicht-Multisample- tex).

Siehe auch resolveTexture().

void QRhiColorAttachment::setTexture(QRhiTexture *tex)

Legt die Textur „ tex “ fest.

Siehe auch ` texture()`.

QRhiTexture *QRhiColorAttachment::texture() const

Gibt die Textur zurück, auf die sich diese Anhangsbeschreibung bezieht, oder „ nullptr “, falls keine vorhanden ist.

Siehe auch setTexture().