Auf dieser Seite

Qt3DRender::QAbstractTextureImage Class

class Qt3DRender::QAbstractTextureImage

Enthält die erforderlichen Informationen zum Erstellen eines OpenGL-Texturbildes. Mehr...

Header: #include <qabstracttextureimage.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
In QML: AbstractTextureImage
Erbt von: Qt3DCore::QNode
Vererbt an:

Qt3DRender::QPaintedTextureImage und Qt3DRender::QTextureImage

Status: Veraltet

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Eigenschaften

Öffentliche Funktionen

QAbstractTextureImage(Qt3DCore::QNode *parent = nullptr)
Qt3DRender::QAbstractTexture::CubeMapFace face() const
int layer() const
int mipLevel() const

Öffentliche Slots

void setFace(Qt3DRender::QAbstractTexture::CubeMapFace face)
void setLayer(int layer)
void setMipLevel(int level)

Signale

void faceChanged(Qt3DRender::QAbstractTexture::CubeMapFace face)
void layerChanged(int layer)
void mipLevelChanged(int mipLevel)

Geschützte Funktionen

virtual Qt3DRender::QTextureImageDataGeneratorPtr dataGenerator() const = 0
void notifyDataGeneratorChanged()

Ausführliche Beschreibung

QAbstractTextureImage sollte verwendet werden, um Bilddaten an einen „ QAbstractTexture “ zu übergeben. Es enthält die erforderlichen Informationen: Mipmap-Ebene, Ebene und Würfelseite, um die Daten an der richtigen Stelle in eine OpenGL-Textur zu laden.

Die eigentlichen Daten werden über ein ` QTextureImageDataGenerator ` bereitgestellt, das im Backend von Aspect-Jobs ausgeführt wird. `QAbstractTextureImage` sollte unterklassifiziert werden, um einen Funktor und gegebenenfalls zusätzliche Eigenschaften bereitzustellen, die der Funktor zum Laden der eigentlichen Daten benötigt.

Hinweis: QAbstractTextureImage darf niemals gemeinsam genutzt werden. Wenn diese Regel nicht beachtet wird, ist im besten Fall mit Abstürzen oder undefiniertem Verhalten zu rechnen.

Dokumentation der Eigenschaften

face : Qt3DRender::QAbstractTexture::CubeMapFace

Enthält die Cube-Map-Fläche des Texturbildes.

Hinweis: Die Cube-Map-Fläche ist nur für „ TargetCubeMap “ und „ TargetCubeMapArray “ von Bedeutung.

Zugriffsfunktionen:

Qt3DRender::QAbstractTexture::CubeMapFace face() const
void setFace(Qt3DRender::QAbstractTexture::CubeMapFace face)

Notifier-Signal:

void faceChanged(Qt3DRender::QAbstractTexture::CubeMapFace face)

layer : int

Gibt die Ebene des Texturbildes zurück.

Zugriffsfunktionen:

int layer() const
void setLayer(int layer)

Notifier-Signal:

void layerChanged(int layer)

mipLevel : int

Enthält die Mipmap-Stufe des Texturbildes.

Zugriffsfunktionen:

int mipLevel() const
void setMipLevel(int level)

Notifier-Signal:

void mipLevelChanged(int mipLevel)

Dokumentation der Mitgliedsfunktionen

[explicit] QAbstractTextureImage::QAbstractTextureImage(Qt3DCore::QNode *parent = nullptr)

Erstellt eine neue Instanz von `QAbstractTextureImage` mit ` parent ` als übergeordneter Instanz.

[pure virtual protected] Qt3DRender::QTextureImageDataGeneratorPtr QAbstractTextureImage::dataGenerator() const

Implementieren Sie diese Methode, um die Instanz von `QTextureImageDataGeneratorPtr` zurückzugeben, die die Daten für das Texturbild bereitstellt.

[protected] void QAbstractTextureImage::notifyDataGeneratorChanged()

Löst eine Aktualisierung des Datengenerators aus, der an das Backend gesendet wird.

[slot] void QAbstractTextureImage::setFace(Qt3DRender::QAbstractTexture::CubeMapFace face)

Setzt die Texturbildseite auf „ face “. face

Hinweis: Setter -Funktion für die Eigenschaft „ face “.

Siehe auch ` face()`.

[slot] void QAbstractTextureImage::setLayer(int layer)

Setzt die Ebene einer Textur auf „ layer “. layer

Hinweis: Setter -Funktion für die Eigenschaft „ layer “.

Siehe auch „ layer()“.

[slot] void QAbstractTextureImage::setMipLevel(int level)

Setzt die Mip-Stufe einer Textur auf „ level “. level

Hinweis: Setter -Funktion für die Eigenschaft „ mipLevel “.

Siehe auch ` mipLevel()`.

© 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.