Sur cette page

Qt3DRender::QDepthTest Class

class Qt3DRender::QDepthTest

La classe `QDepthTest` compare la valeur de profondeur fournie par le shader de fragment à la profondeur d'un échantillon en cours d'écriture. En savoir plus...

En-tête : #include <qdepthtest.h>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake : QT += 3drender
En QML : DepthTest
Hérite de : Qt3DRender::QRenderState
Statut : Obsolète

Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

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

La classe QDepthTest permet d’activer le test de profondeur à l’aide d’une fonction de test de profondeur donnée. Le test de profondeur permet d’écrire les valeurs de couleur des fragments lorsque le test est réussi, et de rejeter ceux qui échouent au test. Le test de profondeur utilise la fonction de profondeur pour comparer la valeur de profondeur des fragments à celle du tampon z. Si la surface sous-jacente ne dispose pas de tampon z, alors QDepthTest n'effectue aucune opération.

Voir également QAlphaTest et QStencilTest.

Documentation sur les types de membres

enum QDepthTest::DepthFunction

Énumération des valeurs de la fonction de profondeur

ConstanteValeurDescription
Qt3DRender::QDepthTest::Never0x0200Ne jamais réussir le test de profondeur
Qt3DRender::QDepthTest::Always0x0207Réussit toujours le test de profondeur
Qt3DRender::QDepthTest::Less0x0201Réussir le test de profondeur si la profondeur du fragment est inférieure à la valeur du tampon z
Qt3DRender::QDepthTest::LessOrEqual0x0203Réussir le test de profondeur si la profondeur du fragment est inférieure ou égale à la valeur du tampon Z
Qt3DRender::QDepthTest::Equal0x0202Réussir le test de profondeur si la profondeur du fragment est égale à la valeur du tampon Z
Qt3DRender::QDepthTest::GreaterOrEqual0x0206Réussir le test de profondeur si la profondeur du fragment est supérieure ou égale à la valeur du tampon z
Qt3DRender::QDepthTest::Greater0x0204Réussir le test de profondeur si la profondeur du fragment est supérieure à la valeur du tampon Z
Qt3DRender::QDepthTest::NotEqual0x0205Réussir le test de profondeur si la profondeur du fragment n'est pas égale à la valeur du tampon Z

Documentation sur les propriétés

depthFunction : DepthFunction

Contient la fonction actuellement utilisée par le test de profondeur. La valeur par défaut est « Never ».

Fonctions d'accès :

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

Signal de notification :

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

Documentation des fonctions membres

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

Le constructeur crée une nouvelle instance de ` QDepthTest::QDepthTest ` avec l'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.