Auf dieser Seite

Qt3DRender::QDepthTest Class

class Qt3DRender::QDepthTest

Die Klasse „QDepthTest“ vergleicht den Tiefenwert des Fragment-Shaders mit der Tiefe eines Samples, in das geschrieben wird. Mehr...

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

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

Ö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)

Ausführliche Beschreibung

Eine QDepthTest-Klasse wird verwendet, um Tiefenprüfungen mit einer vorgegebenen Tiefenprüfungsfunktion zu ermöglichen. Die Tiefenprüfung ermöglicht das Schreiben von Fragmentfarbwerten, wenn die Tiefenprüfung bestanden wird, und verwirft Fragmente, die die Prüfung nicht bestehen. Der Tiefentest verwendet die Tiefenfunktion, um den Tiefenwert der Fragmente mit dem Wert im Z-Puffer zu vergleichen. Verfügt die zugrunde liegende Oberfläche nicht über einen Z-Puffer, führt QDepthTest keine Aktion aus.

Siehe auch QAlphaTest und QStencilTest.

Dokumentation zum Mitgliedstyp

enum QDepthTest::DepthFunction

Aufzählung der Werte der Tiefenfunktion

KonstanteWertBeschreibung
Qt3DRender::QDepthTest::Never0x0200Tiefentest wird niemals bestanden
Qt3DRender::QDepthTest::Always0x0207Besteht den Tiefentest immer
Qt3DRender::QDepthTest::Less0x0201Tiefentest bestanden, wenn die Fragmenttiefe kleiner als der Z-Buffer-Wert ist
Qt3DRender::QDepthTest::LessOrEqual0x0203Tiefentest bestanden, wenn die Fragmenttiefe kleiner oder gleich dem Z-Buffer-Wert ist
Qt3DRender::QDepthTest::Equal0x0202Tiefentest bestanden, wenn die Fragmenttiefe gleich dem Z-Buffer-Wert ist
Qt3DRender::QDepthTest::GreaterOrEqual0x0206Tiefenprüfung bestehen, wenn die Fragmenttiefe größer oder gleich dem Z-Buffer-Wert ist
Qt3DRender::QDepthTest::Greater0x0204Der Tiefentest ist bestanden, wenn die Fragmenttiefe größer als der Z-Buffer-Wert ist
Qt3DRender::QDepthTest::NotEqual0x0205Der Tiefentest ist bestanden, wenn die Fragmenttiefe nicht dem Z-Buffer-Wert entspricht

Dokumentation der Eigenschaft

depthFunction : DepthFunction

Enthält die aktuell vom Tiefentest verwendete Funktion. Die Standardeinstellung ist „Never“.

Zugriffsfunktionen:

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

Notifier-Signal:

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

Dokumentation der Mitgliedsfunktionen

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

Der Konstruktor erstellt eine neue Instanz von „ QDepthTest::QDepthTest “ mit dem angegebenen „ parent “.

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