Qt3DRender::QTextureImage Class
class Qt3DRender::QTextureImageEnthält die erforderlichen Informationen, um aus einer Bildquelle ein OpenGL-Texturbild zu erstellen. Mehr...
| Header: | #include <qtextureimage.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| In QML: | TextureImage |
| Erbt von: | Qt3DRender::QAbstractTextureImage |
| Status: | Veraltet |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Öffentliche Typen
| enum | Status { None, Loading, Ready, Error } |
Eigenschaften
Öffentliche Funktionen
| QTextureImage(Qt3DCore::QNode *parent = nullptr) | |
| bool | isMirrored() const |
| QUrl | source() const |
| Qt3DRender::QTextureImage::Status | status() const |
Öffentliche Slots
| void | setMirrored(bool mirrored) |
| void | setSource(const QUrl &source) |
Signale
| void | mirroredChanged(bool mirrored) |
| void | sourceChanged(const QUrl &source) |
| void | statusChanged(Qt3DRender::QTextureImage::Status status) |
Geschützte Funktionen
| void | setStatus(Qt3DRender::QTextureImage::Status status) |
Detaillierte Beschreibung
Sie enthält die erforderlichen Informationen – Mipmap-Ebene, Ebene, Würfelseite und Quell-URL –, um Daten an der richtigen Stelle in eine OpenGL-Textur zu laden.
Dokumentation zum Mitgliedstyp
enum QTextureImage::Status
Diese Aufzählung gibt die Statuswerte für das Laden von Texturbildern an.
| Konstante | Wert | Beschreibung |
|---|---|---|
Qt3DRender::QTextureImage::None | 0 | Das Laden des Texturbildes wurde noch nicht gestartet. |
Qt3DRender::QTextureImage::Loading | 1 | Das Laden des Texturbildes wurde gestartet, ist aber noch nicht abgeschlossen. |
Qt3DRender::QTextureImage::Ready | 2 | Das Laden des Texturbildes ist abgeschlossen. |
Qt3DRender::QTextureImage::Error | 3 | Beim Laden des Texturbildes ist ein Fehler aufgetreten. |
Dokumentation der Eigenschaft
mirrored : bool
Diese Eigenschaft legt fest, ob das Bild beim Laden gespiegelt werden soll. Dies ist eine Erleichterung, um zu vermeiden, dass Bilder angepasst werden müssen, damit sie mit dem Ursprung der von der Rendering-API verwendeten Texturkoordinaten übereinstimmen. Standardmäßig ist diese Eigenschaft auf „true“ gesetzt. Bei Verwendung von GPU-komprimierten Texturformaten hat dies keine Auswirkung.
Warnung: Diese Eigenschaft führt zu Leistungseinbußen zur Laufzeit beim Laden unkomprimierter oder CPU-komprimierter Bildformate wie PNG. Um diese Leistungseinbußen zu vermeiden, ist es besser, diese Eigenschaft auf „false“ zu setzen und Textur-Assets zu laden, die bereits gespiegelt wurden.
Hinweis: OpenGL legt den Ursprung der Texturkoordinaten in der unteren linken Ecke fest, während DirectX die obere linke Ecke verwendet.
Hinweis: Bei der Verwendung von Cube-Map-Texturen sollten Sie die Spiegelung wahrscheinlich deaktivieren, da der Cube-Map-Sampler eine Richtung anstelle regulärer Texturkoordinaten verwendet.
Zugriffsfunktionen:
| bool | isMirrored() const |
| void | setMirrored(bool mirrored) |
Notifier-Signal:
| void | mirroredChanged(bool mirrored) |
source : QUrl
Diese Eigenschaft enthält die Quell-URL, von der die Daten für das Texturbild geladen werden.
Zugriffsfunktionen:
Benachrichtigungssignal:
| void | sourceChanged(const QUrl &source) |
[read-only] status : Status
Diese Eigenschaft gibt den Status des Ladevorgangs des Texturbildes an.
- TextureImage.None
- TextureImage.Loading
- TextureImage.Ready
- TextureImage.Error
Zugriffsfunktionen:
| Qt3DRender::QTextureImage::Status | status() const |
Notifier-Signal:
| void | statusChanged(Qt3DRender::QTextureImage::Status status) |
Dokumentation zu den Member-Funktionen
[explicit] QTextureImage::QTextureImage(Qt3DCore::QNode *parent = nullptr)
Erstellt eine neue Instanz von „ Qt3DRender::QTextureImage “ mit „ parent “ als übergeordneter Instanz.
bool QTextureImage::isMirrored() const
Gibt zurück, ob die Spiegelung aktiviert ist oder nicht.
Hinweis: Getter -Funktion für die Eigenschaft „ mirrored “.
[slot] void QTextureImage::setMirrored(bool mirrored)
Stellt die Spiegelung auf „ mirrored “ ein.
Hinweis: Dies löst intern einen Aufruf zur Aktualisierung des Datengenerators aus.
Hinweis: Setter -Funktion für die Eigenschaft ` mirrored`.
Siehe auch isMirrored().
[slot] void QTextureImage::setSource(const QUrl &source)
Legt die Quell-URL des Texturbildes auf source fest.
Hinweis: Dies löst intern einen Aufruf zur Aktualisierung des Datengenerators aus.
Hinweis: Setter -Funktion für die Eigenschaft „ source “.
Siehe auch source().
[protected] void QTextureImage::setStatus(Qt3DRender::QTextureImage::Status status)
Setzt den Status auf „ status “. status
Siehe auch status().
QUrl QTextureImage::source() const
Gibt die Quell-URL zurück, von der die Daten für das Texturbild geladen werden.
Hinweis: Getter -Funktion für die Eigenschaft „source“.
Siehe auch „ setSource()“.
Qt3DRender::QTextureImage::Status QTextureImage::status() const
Gibt den aktuellen Status zurück.
Hinweis: Getter -Funktion für die Eigenschaft „status“.
Siehe auch „ setStatus()“.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
