QSGTexture Class

Dokumentation der Mitgliedsfunktionen

QSGTexture::QSGTexture()

Konstruiert die QSGTexture-Basisklasse.

[override virtual noexcept] QSGTexture::~QSGTexture()

Zerstört die QSGTexture.

QSGTexture::AnisotropyLevel QSGTexture::anisotropyLevel() const

Gibt den Anisotropie-Level zurück, der für die Filterung dieser Textur verwendet wird.

Siehe auch setAnisotropyLevel().

[virtual, since 6.0] void QSGTexture::commitTextureOperations(QRhi *rhi, QRhiResourceUpdateBatch *resourceUpdates)

Rufen Sie diese Funktion auf, um das Hochladen von Bildern auf resourceUpdates in die Warteschlange zu stellen, falls es noch ausstehende Vorgänge gibt. Wenn es keine neuen Daten gibt (z.B. weil es seit dem letzten Aufruf dieser Funktion kein setImage() gab), tut die Funktion nichts.

Von Materialien, die rhi Texturen beinhalten, wird erwartet, dass sie diese Funktion von ihrer updateSampledImage()-Implementierung aus aufrufen, typischerweise ohne irgendwelche Bedingungen, indem sie state.rhi() und state.resourceUpdateBatch() von QSGMaterialShader::RenderState übergeben.

Diese Funktion wurde in Qt 6.0 eingeführt.

[pure virtual] qint64 QSGTexture::comparisonKey() const

Gibt einen Schlüssel zurück, der für den Vergleich von Texturen geeignet ist. Wird typischerweise in QSGMaterial::compare()-Implementierungen verwendet.

Ein einfacher Vergleich von QSGTexture Zeigern ist nicht immer ausreichend, da zwei QSGTexture Instanzen, die auf das gleiche native Texturobjekt verweisen, auch als gleich angesehen werden sollten. Daher die Notwendigkeit für diese Funktion.

Von Implementierungen dieser Funktion wird nicht erwartet, dass sie Grafikressourcen (native Texturobjekte) erzeugen, falls noch keine vorhanden sind, und sie sollten dies auch nicht tun.

Ein QSGTexture, unter dem sich kein natives Texturobjekt befindet, ist in der Regel nicht gleich einem anderen QSGTexture, so dass der Rückgabewert entsprechend gestaltet werden muss. Es gibt Ausnahmen, insbesondere wenn Atlasing verwendet wird (wo mehrere Texturen die gleiche Atlas-Textur unter der Haube teilen), das ist dann bis zu den Unterklassen-Implementierungen zu behandeln, wie angemessen.

QRectF QSGTexture::convertToNormalizedSourceRect(const QRectF &rect) const

Gibt rect umgewandelt in normalisierte Koordinaten zurück.

Siehe auch normalizedTextureSubRect().

QSGTexture::Filtering QSGTexture::filtering() const

Gibt den für diese Textur zu verwendenden Sampling-Modus zurück.

Siehe auch setFiltering().

[pure virtual] bool QSGTexture::hasAlphaChannel() const

Gibt true zurück, wenn die Texturdaten einen Alphakanal enthalten.

[pure virtual] bool QSGTexture::hasMipmaps() const

Gibt true zurück, wenn die Texturdaten Mipmap-Ebenen enthalten.

QSGTexture::WrapMode QSGTexture::horizontalWrapMode() const

Gibt den horizontalen Umbruchmodus zurück, der für diese Textur verwendet werden soll.

Siehe auch setHorizontalWrapMode().

[virtual] bool QSGTexture::isAtlasTexture() const

Gibt zurück, ob diese Textur Teil eines Atlasses ist oder nicht.

Die Standardimplementierung gibt false zurück.

QSGTexture::Filtering QSGTexture::mipmapFiltering() const

Gibt zurück, ob Mipmapping beim Sampling von dieser Textur verwendet werden soll.

Siehe auch setMipmapFiltering().

template <typename QNativeInterface> QNativeInterface *QSGTexture::nativeInterface() const

Gibt eine native Schnittstelle des angegebenen Typs für die Textur zurück.

Diese Funktion bietet Zugriff auf die plattformspezifische Funktionalität von QSGTexture, wie im QNativeInterface Namespace deklariert:

Dies ermöglicht den Zugriff auf das zugrundeliegende native Texturobjekt, z. B. die GLuint Textur-ID bei OpenGL oder das VkImage -Handle bei Vulkan.

Wenn die angeforderte Schnittstelle nicht verfügbar ist, wird nullptr zurückgegeben.

[virtual] QRectF QSGTexture::normalizedTextureSubRect() const

Gibt das Rechteck innerhalb von textureSize() zurück, das diese Textur in normalisierten Koordinaten darstellt.

Die Standardimplementierung gibt ein Rechteck an der Position (0, 0) mit einer Breite und Höhe von 1 zurück.

[virtual] QSGTexture *QSGTexture::removedFromAtlas(QRhiResourceUpdateBatch *resourceUpdates = nullptr) const

Diese Funktion gibt eine Kopie der aktuellen Textur zurück, die aus ihrem Atlas entfernt wird.

Die aktuelle Textur bleibt unverändert, so dass die Texturkoordinaten nicht aktualisiert werden müssen.

Das Entfernen einer Textur aus einem Atlas ist vor allem dann nützlich, wenn sie an einen Shader weitergegeben wird, der mit den Texturkoordinaten 0-1 anstelle des Textursubrekts innerhalb des Atlas arbeitet.

Wenn die Textur nicht Teil eines Texturatlasses ist, gibt diese Funktion 0 zurück.

Es wird empfohlen, dass Implementierungen dieser Funktion bei mehreren Aufrufen dieselbe Instanz zurückgeben, um die Speichernutzung zu begrenzen.

resourceUpdates ist ein optionaler Ressourcen-Aktualisierungsstapel, für den Texturoperationen, falls vorhanden, in die Warteschlange gestellt werden. Materialien können eine Instanz von QSGMaterialShader::RenderState abrufen. Wenn null, erstellt die removedFromAtlas()-Implementierung ihren eigenen Stapel und sendet ihn sofort. Wenn jedoch eine gültige Instanz angegeben ist, wird diese Funktion den Aktualisierungsstapel nicht übermitteln.

[virtual, since 6.0] QRhiTexture *QSGTexture::rhiTexture() const

Gibt die QRhiTexture für diese QSGTexture zurück oder null, wenn es keine gibt (entweder weil intern noch keine gültige Textur erstellt wurde oder weil das Konzept nicht auf das verwendete Scenegraph-Backend anwendbar ist).

Von dieser Funktion wird nicht erwartet, dass sie eine neue QRhiTexture erstellt, wenn es keine gibt. In diesem Fall sollte sie null zurückgeben. Die Erwartung an den Renderer ist, dass eine Null-Textur dazu führt, dass stattdessen eine transparente Dummy-Textur verwendet wird.

Diese Funktion wurde in Qt 6.0 eingeführt.

void QSGTexture::setAnisotropyLevel(QSGTexture::AnisotropyLevel level)

Setzt den Grad der anisotropen Filterung auf level. Der Standardwert ist QSGTexture::AnisotropyNone, was bedeutet, dass keine anisotrope Filterung aktiviert ist.

Siehe auch anisotropyLevel().

void QSGTexture::setFiltering(QSGTexture::Filtering filter)

Setzt den Abtastmodus auf filter.

Siehe auch filtering().

void QSGTexture::setHorizontalWrapMode(QSGTexture::WrapMode hwrap)

Setzt den horizontalen Umbruchmodus auf hwrap

Siehe auch horizontalWrapMode().

void QSGTexture::setMipmapFiltering(QSGTexture::Filtering filter)

Setzt den Mipmap-Sampling-Modus auf filter.

Die Einstellung der Mipmap-Filterung hat keine Auswirkungen, wenn die Textur keine Mipmaps hat.

Siehe auch mipmapFiltering() und hasMipmaps().

void QSGTexture::setVerticalWrapMode(QSGTexture::WrapMode vwrap)

Setzt den vertikalen Umbruchmodus auf vwrap

Siehe auch verticalWrapMode().

[pure virtual] QSize QSGTexture::textureSize() const

Gibt die Größe der Textur in Pixeln zurück.

QSGTexture::WrapMode QSGTexture::verticalWrapMode() const

Gibt den vertikalen Umbruchmodus zurück, der für diese Textur verwendet werden soll.

Siehe auch setVerticalWrapMode().