QDepthTest 类

class Qt3DRender::QDepthTest

QDepthTest 类用于测试片段着色器深度值与写入样本的深度进行对比。(更多...)

头文件	#include <QDepthTest>
CMake	find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake	QT += 3drender
由以下实例化	DepthTest
继承自	Qt3DRender::QRenderState

公共类型

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

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

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

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

QDepthTest 类用于启用具有给定深度测试函数的深度测试。深度测试在深度测试通过时写入片段颜色值，拒绝测试失败的片段。深度测试使用深度函数将片段深度值与 z 缓冲区值进行比较。如果底层表面没有 z 缓冲区，则 QDepthTest 不执行任何操作。

另请参阅 QAlphaTest 和 QStencilTest。

深度函数值的枚举

常量	值	描述
`Qt3DRender::QDepthTest::Never`	`0x0200`	永远不会通过深度测试
`Qt3DRender::QDepthTest::Always`	`0x0207`	总是通过深度测试
`Qt3DRender::QDepthTest::Less`	`0x0201`	如果片段深度小于 z 缓冲区值则通过深度测试
`Qt3DRender::QDepthTest::LessOrEqual`	`0x0203`	如果片段深度小于或等于 z 缓冲区值则通过深度测试
`Qt3DRender::QDepthTest::Equal`	`0x0202`	如果片段深度等于 z 缓冲区值则通过深度测试
`Qt3DRender::QDepthTest::GreaterOrEqual`	`0x0206`	当片元深度大于或等于深度缓冲区值时通过深度测试
`Qt3DRender::QDepthTest::Greater`	`0x0204`	当片元深度大于深度缓冲区值时通过深度测试
`Qt3DRender::QDepthTest::NotEqual`	`0x0205`	当片元深度不等于深度缓冲区值时通过深度测试

保存深度测试当前使用的函数。默认为Never。

访问函数

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

通知信号

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

构造函数创建一个新的 QDepthTest::QDepthTest 实例，带指定的 parent。