QSGTexture Class

Dokumentation der Member-Funktionen

QSGTexture::QSGTexture()

Erstellt die Basisklasse „QSGTexture“.

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

Zerstört die „ QSGTexture “.

QSGTexture::AnisotropyLevel QSGTexture::anisotropyLevel() const

Gibt den für die Filterung dieser Textur verwendeten Anisotropiegrad zurück.

Siehe auch „ setAnisotropyLevel()“.

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

Rufen Sie diese Funktion auf, um Bild-Upload-Vorgänge an resourceUpdates in die Warteschlange zu stellen, falls noch ausstehende Vorgänge vorhanden sind. Wenn keine neuen Daten vorliegen (beispielsweise weil seit dem letzten Aufruf dieser Funktion kein setImage()-Aufruf stattgefunden hat), führt die Funktion keine Aktion aus.

Materialien, die Texturen von rhi verwenden, sollten diese Funktion aus ihrer ` updateSampledImage()`-Implementierung aufrufen – in der Regel ohne Bedingungen – und dabei ` state.rhi() ` und ` state.resourceUpdateBatch() ` aus dem ` 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 zum Vergleichen von Texturen geeignet ist. Wird typischerweise in Implementierungen von ` QSGMaterial::compare()` verwendet.

Der bloße Vergleich von ` QSGTexture `-Zeigern reicht nicht immer aus, da zwei ` QSGTexture `-Instanzen, die auf dasselbe zugrunde liegende native Texturobjekt verweisen, ebenfalls als gleich angesehen werden sollten. Daher ist diese Funktion erforderlich.

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

Ein ` QSGTexture `, dem kein natives Texturobjekt zugrunde liegt, ist in der Regel mit keinem anderen ` QSGTexture` gleich, daher muss der Rückgabewert entsprechend gestaltet werden. Hiervon gibt es Ausnahmen, insbesondere bei der Verwendung von Atlas-Techniken (bei denen sich mehrere Texturen hinter den Kulissen dieselbe Atlas-Textur teilen); dies ist dann den Implementierungen der Unterklassen überlassen, die entsprechend damit umgehen müssen.

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

Gibt „ rect “ in normalisierten Koordinaten zurück.

Siehe auch ` normalizedTextureSubRect()`.

QSGTexture::Filtering QSGTexture::filtering() const

Gibt den für diese Textur zu verwendenden Abtastmodus 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 Atlas ist oder nicht.

Die Standardimplementierung gibt „false“ zurück.

QSGTexture::Filtering QSGTexture::mipmapFiltering() const

Gibt zurück, ob beim Abtasten dieser Textur Mipmapping 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 ermöglicht den Zugriff auf plattformspezifische Funktionen von „ QSGTexture “, wie sie im Namespace „ QNativeInterface “ deklariert sind:

Dies ermöglicht den Zugriff auf das zugrunde liegende native Texturobjekt, wie beispielsweise die Textur-ID „ GLuint “ bei OpenGL oder das Handle „ VkImage “ bei Vulkan.

Ist die angeforderte Schnittstelle nicht verfügbar, wird ein „ 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, sodass die Texturkoordinaten nicht aktualisiert werden müssen.

Das Entfernen einer Textur aus einem Atlas ist vor allem dann sinnvoll, wenn sie an einen Shader übergeben wird, der mit den Texturkoordinaten 0–1 arbeitet, anstatt mit dem Textur-Teilbereich innerhalb des Atlas.

Ist die Textur nicht Teil eines Texturatlas, gibt diese Funktion 0 zurück.

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

resourceUpdates ist ein optionaler Ressourcen-Update-Batch, in den eventuelle Texturoperationen eingereiht werden. Materialien können eine Instanz über ` QSGMaterialShader::RenderState` abrufen. Ist der Wert null, erstellt die `removedFromAtlas()`-Implementierung einen eigenen Batch und übergibt ihn sofort. Wird jedoch eine gültige Instanz angegeben, übergibt diese Funktion den Update-Batch nicht.

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

Gibt die „ QRhiTexture “ für diese „ QSGTexture “ zurück oder null, falls keine vorhanden ist (entweder, weil intern noch keine gültige Textur erstellt wurde, oder weil das Konzept für das verwendete Szenengraph-Backend nicht anwendbar ist).

Es wird nicht erwartet, dass diese Funktion eine neue ` QRhiTexture ` erstellt, falls keine vorhanden ist. In diesem Fall sollte sie `null` zurückgeben. Vom Renderer wird erwartet, dass bei einer `null`-Textur stattdessen eine transparente Dummy-Textur verwendet wird.

Diese Funktion wurde in Qt 6.0 eingeführt.

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

Legt die Stärke der anisotropen Filterung auf „ level “ fest. Der Standardwert ist „ QSGTexture::AnisotropyNone “, was bedeutet, dass keine anisotrope Filterung aktiviert ist.

Siehe auch anisotropyLevel().

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

Stellt den Abtastmodus auf „ filter “ ein.

Siehe auch „ filtering()“.

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

Legt den horizontalen Zeilenumbruchmodus auf hwrap

Siehe auch horizontalWrapMode().

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

Stellt den Mipmap-Abtastmodus auf „ filter “ ein.

Die Einstellung der Mipmap-Filterung hat keine Auswirkung, wenn die Textur keine Mipmaps enthält.

Siehe auch „ mipmapFiltering()“ und „ hasMipmaps()“.

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

Stellt den vertikalen Zeilenumbruchmodus 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()“.