QSSGRhiContext Class

Dokumentation der Mitgliedsfunktionen

void QSSGRhiContext::checkAndAdjustForNPoT(QRhiTexture *texture, QSSGRhiSamplerDescription *samplerDescription)

Passt die Kachel- und Filtermodi von samplerDescription auf der Grundlage der Pixelgröße von texture an.

In den meisten Fällen wird samplerDescription nicht geändert. Bei älteren, veralteten 3D-APIs besteht jedoch die Möglichkeit, dass Kachelungsmodi wie QRhiSampler::Repeat für Texturen mit einer Breite oder Höhe, die keine Zweierpotenz ist, nicht unterstützt werden.

Diese Komfortfunktion hilft bei der Erstellung robuster Anwendungen, die auch dann noch funktionieren, wenn Merkmale wie QRhi::NPOTTextureRepeat von einer OpenGL ES 2.0- oder WebGL 1-Implementierung zur Laufzeit nicht unterstützt werden.

QRhiCommandBuffer *QSSGRhiContext::commandBuffer() const

Gibt den Befehlspuffer des aktuellen Frames zurück, der vom Renderer Qt Quick 3D verwendet wird.

QRhiCommandBuffer::BeginPassFlags QSSGRhiContext::commonPassFlags() const

Gibt die empfohlenen Flags beim Aufruf von QRhiCommandBuffer::beginPass() zurück.

QRhiTexture *QSSGRhiContext::dummyTexture(QRhiTexture::Flags flags, QRhiResourceUpdateBatch *rub, const QSize &size = QSize(64, 64), const QColor &fillColor = Qt::black, int arraySize = 0)

Gibt eine Textur zurück, die die angegebene flags und Pixel size hat.

Dies ist dazu gedacht, effizient auf eine "Dummy"-Textur zuzugreifen, die mit einer bestimmten fillColor gefüllt ist und an verschiedenen Stellen im Rendering-Stack wiederverwendet wird.

rub muss eine gültige QRhiResourceUpdateBatch sein, da diese Funktion eine neue Textur erstellt und Inhalte dafür generiert, wenn kein geeignetes Objekt im Cache gefunden wird. Die notwendigen Upload-Operationen werden dann in die Warteschlange dieses gegebenen Aktualisierungsstapels gestellt.

Wenn arraySize 2 oder mehr ist, wird ein 2D-Textur-Array zurückgegeben.

Das Eigentum an der zurückgegebenen Textur verbleibt bei Qt Quick 3D.

bool QSSGRhiContext::isValid() const

Gibt true zurück, wenn der Renderer erfolgreich initialisiert wurde.

int QSSGRhiContext::mainPassSampleCount() const

Gibt die Anzahl der im Haupt-Rendering-Durchgang verwendeten Samples zurück.

int QSSGRhiContext::mainPassViewCount() const

Gibt die Anzahl der im Haupt-Rendering-Durchgang verwendeten Multiviews zurück. Dies ist entweder 2, wenn Multiview-Rendering verwendet wird, oder 1 (keine Multiview-Ansicht).

QRhiRenderPassDescriptor *QSSGRhiContext::mainRenderPassDescriptor() const

Gibt die QRhiRenderPassDescriptor zurück, die vom Haupt-Rendering-Durchgang des Qt Quick 3D Renderers verwendet wird.

QRhiRenderTarget *QSSGRhiContext::renderTarget() const

Gibt das Rendering-Ziel zurück, das der Renderer Qt Quick 3D für seinen Haupt-Rendering-Durchgang im aktuellen Frame verwendet.

Dies kann tatsächlich ein Rendering-Ziel aus einer Swapchain sein, wenn View3D einen anderen RenderMode als Offscreen verwendet. In der Regel bezieht sich das Rendering-Ziel auf eine Textur (d.h. es ist ein QRhiTextureRenderTarget), z.B. weil der RenderMode der Standard Offscreen ist oder weil Nachbearbeitungseffekte verwendet werden.

QRhi *QSSGRhiContext::rhi() const

Rückgabe Das QRhi Objekt, das vom Qt Quick 3D Renderer verwendet wird.

QRhiSampler *QSSGRhiContext::sampler(const QSSGRhiSamplerDescription &samplerDescription)

Gibt einen Sampler mit den in samplerDescription angegebenen Filter- und Kachelmodi zurück.

Die erzeugten QRhiSampler Objekte werden zwischengespeichert und wiederverwendet. Dies ist also eine bequeme Möglichkeit, auf ein QRhiSampler mit den angegebenen Einstellungen zuzugreifen, ohne ständig ein neues, dediziertes Objekt erstellen zu müssen.

Das Eigentum am zurückgegebenen QRhiSampler verbleibt bei Qt Quick 3D.