Auf dieser Seite

Qt3DExtras::QTextureMaterial Class

class Qt3DExtras::QTextureMaterial

Das QTextureMaterial bietet eine Standardimplementierung eines einfachen, unbeleuchteten Texturmaterials. Mehr...

Header: #include <qtexturematerial.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3dextras)
target_link_libraries(mytarget PRIVATE Qt6::3dextras)
qmake: QT += 3dextras
Erbt von: Qt3DRender::QMaterial
Status: Veraltet

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

Eigenschaften

Öffentliche Funktionen

QTextureMaterial(Qt3DCore::QNode *parent = nullptr)
virtual ~QTextureMaterial()
bool isAlphaBlendingEnabled() const
Qt3DRender::QAbstractTexture *texture() const
QVector2D textureOffset() const
QMatrix3x3 textureTransform() const

Öffentliche Slots

void setAlphaBlendingEnabled(bool enabled)
void setTexture(Qt3DRender::QAbstractTexture *texture)
void setTextureOffset(QVector2D textureOffset)
void setTextureTransform(const QMatrix3x3 &matrix)

Signale

void alphaBlendingEnabledChanged(bool enabled)
void textureChanged(Qt3DRender::QAbstractTexture *texture)
void textureOffsetChanged(QVector2D textureOffset)
void textureTransformChanged(const QMatrix3x3 &textureTransform)

Ausführliche Beschreibung

Dieses Material verwendet einen Effekt mit einem einzigen Render-Pass. Es werden Techniken für OpenGL 2, OpenGL 3 oder höher sowie für OpenGL ES 2 bereitgestellt.

Dokumentation der Eigenschaften

alphaBlending : bool

Gibt an, ob die aus der Eigenschaft „diffuse“ stammenden Alpha-Informationen beim Rendern berücksichtigt werden. Der Standardwert ist „false“.

Zugriffsfunktionen:

bool isAlphaBlendingEnabled() const
void setAlphaBlendingEnabled(bool enabled)

Notifier-Signal:

void alphaBlendingEnabledChanged(bool enabled)

texture : Qt3DRender::QAbstractTexture*

Enthält die aktuelle Textur, die vom Material verwendet wird.

Zugriffsfunktionen:

Qt3DRender::QAbstractTexture *texture() const
void setTexture(Qt3DRender::QAbstractTexture *texture)

Notifier-Signal:

void textureChanged(Qt3DRender::QAbstractTexture *texture)

textureOffset : QVector2D

Dies ist eine Hilfs-Eigenschaft. Sie legt die Translationskomponente der allgemeinen Textur-Transformationsmatrix fest

Zugriffsfunktionen:

QVector2D textureOffset() const
void setTextureOffset(QVector2D textureOffset)

Benachrichtigungssignal:

void textureOffsetChanged(QVector2D textureOffset)

textureTransform : QMatrix3x3

Enthält die aktuelle Texturtransformation. Diese wird zum Zeitpunkt des Renderings auf die Texturkoordinaten angewendet. Standardmäßig ist die Einheitsmatrix eingestellt.

Zugriffsfunktionen:

QMatrix3x3 textureTransform() const
void setTextureTransform(const QMatrix3x3 &matrix)

Notifier-Signal:

void textureTransformChanged(const QMatrix3x3 &textureTransform)

Dokumentation der Mitgliedsfunktionen

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

Erstellt eine neue QTextureMaterial-Instanz mit dem übergeordneten Objekt „ parent “.

[virtual noexcept] QTextureMaterial::~QTextureMaterial()

Löscht die „ QTextureMaterial “-Instanz.

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