QTextureImage Class
class Qt3DRender::QTextureImageKapselt die notwendigen Informationen, um ein OpenGL-Texturbild aus einer Bildquelle zu erzeugen. Mehr...
| Kopfzeile: | #include <QTextureImage> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender)target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| In QML: | TextureImage |
| Vererbt: | Qt3DRender::QAbstractTextureImage |
| Status: | Veraltet |
Ö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
Enthält die notwendigen Informationen mipmap level, layer, cube face und source URL um an der richtigen Stelle Daten in eine OpenGL Textur zu laden.
Member Typ Dokumentation
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 hat begonnen, 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. |
Eigenschaft Dokumentation
mirrored : bool
Diese Eigenschaft gibt an, ob das Bild beim Laden gespiegelt werden soll. Damit wird vermieden, dass Bilder manipuliert werden müssen, um mit dem Ursprung der von der Rendering-API verwendeten Texturkoordinaten übereinzustimmen. Standardmäßig ist diese Eigenschaft auf true gesetzt. Bei der Verwendung von GPU-komprimierten Texturformaten hat dies keine Auswirkung.
Warnung: Diese Eigenschaft hat zur Folge, dass beim Laden von unkomprimierten oder CPU-komprimierten Bildformaten wie PNG zur Laufzeit ein Preis für die Leistung gezahlt werden muss. Um diese Leistungseinbußen zu vermeiden, ist es besser, diese Eigenschaft auf false zu setzen und Textur-Assets zu laden, die zuvor gespiegelt wurden.
Hinweis: OpenGL legt den Ursprung der Texturkoordinaten in der unteren linken Ecke fest, während DirectX die obere linke Ecke verwendet.
Hinweis: Wenn Sie Cube-Map-Texturen verwenden, sollten Sie die Spiegelung wahrscheinlich deaktivieren, da der Cube-Map-Sampler eher eine Richtung als reguläre Texturkoordinaten nimmt.
Zugriffsfunktionen:
| bool | isMirrored() const |
| void | setMirrored(bool mirrored) |
Benachrichtigungssignal:
| void | mirroredChanged(bool mirrored) |
source : QUrl
Diese Eigenschaft enthält die Quell-URL, aus der die Daten für das Texturbild geladen werden.
Zugriffsfunktionen:
Benachrichtigungssignal:
| void | sourceChanged(const QUrl &source) |
[read-only] status : const Status
Diese Eigenschaft enthält den Status des Ladens des Texturbildes.
- TextureImage.keine
- TextureImage.ladend
- TextureImage.bereit
- TextureImage.Fehler
Zugriffsfunktionen:
| Qt3DRender::QTextureImage::Status | status() const |
Benachrichtigungssignal:
| void | statusChanged(Qt3DRender::QTextureImage::Status status) |
Member Function Dokumentation
[explicit] QTextureImage::QTextureImage(Qt3DCore::QNode *parent = nullptr)
Erzeugt eine neue Instanz von Qt3DRender::QTextureImage mit parent als übergeordnetem Element.
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)
Setzt die Spiegelung auf mirrored.
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)
Setzt die Quell-URL des Texturbildes auf source.
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, aus 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().
© 2025 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.
