QDepthTest Class

class Qt3DRender::QDepthTest

Die Klasse QDepthTest testet den Tiefenwert des Fragment-Shaders gegen die Tiefe eines Samples, in das geschrieben wird. Mehr...

Kopfzeile: #include <QDepthTest>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
In QML: DepthTest
Vererbt: Qt3DRender::QRenderState
Status: Veraltet

Öffentliche Typen

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

Eigenschaften

Öffentliche Funktionen

QDepthTest(Qt3DCore::QNode *parent = nullptr)
Qt3DRender::QDepthTest::DepthFunction depthFunction() const

Öffentliche Slots

void setDepthFunction(Qt3DRender::QDepthTest::DepthFunction depthFunction)

Signale

void depthFunctionChanged(Qt3DRender::QDepthTest::DepthFunction depthFunction)

Detaillierte Beschreibung

Eine QDepthTest-Klasse wird verwendet, um einen Tiefentest mit einer bestimmten Tiefentestfunktion zu ermöglichen. Die Tiefenprüfung ermöglicht das Schreiben von Fragment-Farbwerten, wenn die Tiefenprüfung bestanden wird, und das Zurückweisen von Fragmenten, die die Prüfung nicht bestehen. Der Tiefentest verwendet die Tiefenfunktion, um den Tiefenwert des Fragments gegen den Wert des z-Puffers zu testen. Wenn die zugrundeliegende Oberfläche keinen z-Puffer hat, dann macht QDepthTest nichts.

Siehe auch QAlphaTest und QStencilTest.

Dokumentation der Mitgliedstypen

enum QDepthTest::DepthFunction

Aufzählung für die Werte der Tiefenfunktion

KonstanteWertBeschreibung
Qt3DRender::QDepthTest::Never0x0200Tiefenprüfung nie bestehen
Qt3DRender::QDepthTest::Always0x0207Tiefenprüfung immer bestehen
Qt3DRender::QDepthTest::Less0x0201Besteht den Tiefentest, wenn die Fragmenttiefe kleiner als der Z-Puffer-Wert ist
Qt3DRender::QDepthTest::LessOrEqual0x0203Besteht den Tiefentest, wenn die Fragmenttiefe kleiner oder gleich dem Z-Puffer-Wert ist
Qt3DRender::QDepthTest::Equal0x0202Besteht den Tiefentest, wenn die Fragmenttiefe gleich dem Z-Buffer-Wert ist
Qt3DRender::QDepthTest::GreaterOrEqual0x0206Test bestanden, wenn die Fragmenttiefe größer oder gleich dem Z-Puffer-Wert ist
Qt3DRender::QDepthTest::Greater0x0204Test bestanden, wenn die Fragmenttiefe größer als der Z-Puffer-Wert ist
Qt3DRender::QDepthTest::NotEqual0x0205Test bestehen, wenn Fragmenttiefe nicht gleich dem Z-Puffer-Wert ist

Dokumentation der Eigenschaft

depthFunction : DepthFunction

Enthält die aktuelle Funktion, die von der Tiefenprüfung verwendet wird. Der Standardwert ist Nie.

Zugriffsfunktionen:

Qt3DRender::QDepthTest::DepthFunction depthFunction() const
void setDepthFunction(Qt3DRender::QDepthTest::DepthFunction depthFunction)

Benachrichtigungssignal:

void depthFunctionChanged(Qt3DRender::QDepthTest::DepthFunction depthFunction)

Mitgliederfunktion Dokumentation

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

Der Konstruktor erstellt eine neue QDepthTest::QDepthTest Instanz mit der angegebenen parent.

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