Sur cette page

Qt3DRender::QDepthTest Class

class Qt3DRender::QDepthTest

La classe QDepthTest teste la valeur de profondeur du fragment shader par rapport à la profondeur d'un échantillon en cours d'écriture. Plus d'informations...

En-tête : #include <QDepthTest>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake : QT += 3drender
En QML : DepthTest
Hérite : Qt3DRender::QRenderState
Statut : Déclassé

Types publics

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

Propriétés

Fonctions publiques

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

Emplacements publics

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

Signaux

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

Description détaillée

Une classe QDepthTest est utilisée pour activer le test de profondeur avec une fonction de test de profondeur donnée. Le test de profondeur permet d'écrire les valeurs de couleur des fragments lorsque le test de profondeur est réussi, et de rejeter les fragments qui échouent au test. Le test de profondeur utilise la fonction depth pour tester la valeur de profondeur des fragments par rapport à la valeur du z-buffer. Si la surface sous-jacente n'a pas de tampon z, QDepthTest ne fait rien.

Voir également QAlphaTest et QStencilTest.

Documentation sur les types de membres

enum QDepthTest::DepthFunction

Enumération des valeurs de la fonction de profondeur

ConstanteValeurDescription
Qt3DRender::QDepthTest::Never0x0200Ne réussit jamais le test de profondeur
Qt3DRender::QDepthTest::Always0x0207Passe toujours le test de profondeur
Qt3DRender::QDepthTest::Less0x0201Test de profondeur réussi si la profondeur du fragment est inférieure à la valeur du tampon z
Qt3DRender::QDepthTest::LessOrEqual0x0203Test de profondeur réussi si la profondeur du fragment est inférieure ou égale à la valeur du tampon z
Qt3DRender::QDepthTest::Equal0x0202Test de profondeur réussi si la profondeur du fragment est égale à la valeur du tampon z
Qt3DRender::QDepthTest::GreaterOrEqual0x0206Test de profondeur réussi si la profondeur du fragment est supérieure ou égale à la valeur du tampon z
Qt3DRender::QDepthTest::Greater0x0204Test de profondeur réussi si la profondeur du fragment est supérieure à la valeur du tampon z
Qt3DRender::QDepthTest::NotEqual0x0205Test de profondeur réussi si la profondeur du fragment n'est pas égale à la valeur du tampon z

Documentation sur les propriétés

depthFunction : DepthFunction

Indique la fonction actuelle utilisée par le test de profondeur. La valeur par défaut est Jamais.

Fonctions d'accès :

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

Signal du notificateur :

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

Member Function Documentation

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

Le constructeur crée une nouvelle instance QDepthTest::QDepthTest avec l'adresse parent spécifiée.

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