Auf dieser Seite

Qt3DRender::QAlphaTest Class

class Qt3DRender::QAlphaTest

Die Klasse „QAlphaTest“ definiert den Alpha-Referenztest. Mehr...

Header: #include <qalphatest.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
In QML: AlphaTest
Erbt von: Qt3DRender::QRenderState
Status: Veraltet

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

Öffentliche Typen

enum AlphaFunction { Never, Always, Less, LessOrEqual, Equal, …, NotEqual }

Eigenschaften

Öffentliche Funktionen

Qt3DRender::QAlphaTest::AlphaFunction alphaFunction() const
float referenceValue() const

Öffentliche Slots

void setAlphaFunction(Qt3DRender::QAlphaTest::AlphaFunction alphaFunction)
void setReferenceValue(float referenceValue)

Signale

void alphaFunctionChanged(Qt3DRender::QAlphaTest::AlphaFunction alphaFunction)
void referenceValueChanged(float referenceValue)

Ausführliche Beschreibung

Wie in der OpenGL-Dokumentation erläutert, verwirft der Alpha-Test ein Fragment in Abhängigkeit vom Ergebnis eines Vergleichs zwischen dem Alpha-Wert des eingehenden Fragments und einem konstanten Referenzwert.

Dokumentation zum Mitgliedstyp

enum QAlphaTest::AlphaFunction

Aufzählung der Werte der Alpha-Funktion

KonstanteWertBeschreibung
Qt3DRender::QAlphaTest::Never0x0200Alpha-Test wird niemals bestanden
Qt3DRender::QAlphaTest::Always0x0207Alpha-Test immer bestehen
Qt3DRender::QAlphaTest::Less0x0201Alpha-Test bestanden, wenn das Fragment-Alpha kleiner als der Referenzwert ist
Qt3DRender::QAlphaTest::LessOrEqual0x0203Besteht den Alpha-Test, wenn das Fragment-Alpha kleiner oder gleich dem Referenzwert ist
Qt3DRender::QAlphaTest::Equal0x0202Der Alpha-Test ist bestanden, wenn das Fragment-Alpha dem Referenzwert entspricht
Qt3DRender::QAlphaTest::GreaterOrEqual0x0206Der Alpha-Test ist bestanden, wenn der Fragment-Alpha-Wert größer oder gleich dem Referenzwert ist
Qt3DRender::QAlphaTest::Greater0x0204Der Alpha-Test ist bestanden, wenn der Fragment-Alpha-Wert größer als der Referenzwert ist
Qt3DRender::QAlphaTest::NotEqual0x0205Der Alpha-Test ist bestanden, wenn der Fragment-Alpha-Wert nicht dem Referenzwert entspricht

Eigenschaftsdokumentation

alphaFunction : AlphaFunction

Enthält die vom Alpha-Test verwendete Alpha-Funktion. Der Standardwert ist „Nie“.

Zugriffsfunktionen:

Qt3DRender::QAlphaTest::AlphaFunction alphaFunction() const
void setAlphaFunction(Qt3DRender::QAlphaTest::AlphaFunction alphaFunction)

Benachrichtigungssignal:

void alphaFunctionChanged(Qt3DRender::QAlphaTest::AlphaFunction alphaFunction)

referenceValue : float

Enthält den vom Alpha-Test verwendeten Referenzwert. Der Standardwert ist 0,0. Wenn dieser Wert festgelegt wird, wird er auf einen Wert zwischen 0 und 1 begrenzt.

Zugriffsfunktionen:

float referenceValue() const
void setReferenceValue(float referenceValue)

Benachrichtigungssignal:

void referenceValueChanged(float referenceValue)

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