En esta página

Qt3DRender::QDepthTest Class

class Qt3DRender::QDepthTest

La clase `QDepthTest` compara el valor de profundidad del sombreador de fragmentos con la profundidad de una muestra en la que se está escribiendo. Más información...

Encabezado: #include <qdepthtest.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
En QML: DepthTest
Heredado de: Qt3DRender::QRenderState
Estado: Obsoleto

Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.

Tipos públicos

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

Propiedades

Funciones públicas

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

Ranuras públicas

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

Señales

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

Descripción detallada

La clase QDepthTest se utiliza para habilitar la comprobación de profundidad con una función de comprobación de profundidad determinada. La comprobación de profundidad permite escribir los valores de color de los fragmentos cuando la comprobación se supera, y rechaza los fragmentos que no la superan. La prueba de profundidad utiliza la función de profundidad para comparar el valor de profundidad de los fragmentos con el valor del búfer Z. Si la superficie subyacente no dispone de búfer Z, QDepthTest no realiza ninguna acción.

Véase también QAlphaTest y QStencilTest.

Documentación sobre tipos de miembros

enum QDepthTest::DepthFunction

Enumeración de los valores de la función de profundidad

ConstanteValorDescripción
Qt3DRender::QDepthTest::Never0x0200Nunca supera la prueba de profundidad
Qt3DRender::QDepthTest::Always0x0207Siempre supera la prueba de profundidad
Qt3DRender::QDepthTest::Less0x0201Supera la prueba de profundidad si la profundidad del fragmento es menor que el valor del búfer Z
Qt3DRender::QDepthTest::LessOrEqual0x0203Supera la prueba de profundidad si la profundidad del fragmento es menor o igual que el valor del búfer Z
Qt3DRender::QDepthTest::Equal0x0202Supera la prueba de profundidad si la profundidad del fragmento es igual al valor del búfer Z
Qt3DRender::QDepthTest::GreaterOrEqual0x0206Supera la prueba de profundidad si la profundidad del fragmento es mayor o igual que el valor del búfer Z
Qt3DRender::QDepthTest::Greater0x0204Supera la prueba de profundidad si la profundidad del fragmento es mayor que el valor del búfer Z
Qt3DRender::QDepthTest::NotEqual0x0205Supera la prueba de profundidad si la profundidad del fragmento no es igual al valor del búfer Z

Documentación de la propiedad

depthFunction : DepthFunction

Almacena la función actual utilizada por la prueba de profundidad. El valor por defecto es «Nunca».

Funciones de acceso:

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

Señal del notificador:

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

Documentación de la función miembro

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

El constructor crea una nueva instancia de ` QDepthTest::QDepthTest ` con el ` parent` especificado.

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