이 페이지에서

Qt3DRender::QDepthTest Class

class Qt3DRender::QDepthTest

QDepthTest 클래스는 프래그먼트 셰이더의 깊이 값을, 쓰기 작업이 수행되는 샘플의 깊이와 비교하여 검사합니다. 더 보기...

헤더: #include <qdepthtest.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
QML에서: 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도 참조하십시오 .

멤버 유형 문서

enum QDepthTest::DepthFunction

깊이 함수 값에 대한 열거

상수값설명
Qt3DRender::QDepthTest::Never0x0200깊이 테스트를 절대 통과하지 않음
Qt3DRender::QDepthTest::Always0x0207항상 깊이 테스트를 통과
Qt3DRender::QDepthTest::Less0x0201프래그먼트 깊이가 z-버퍼 값보다 작을 경우 깊이 테스트 통과
Qt3DRender::QDepthTest::LessOrEqual0x0203프래그먼트 깊이가 z-버퍼 값보다 작거나 같을 경우 깊이 테스트 통과
Qt3DRender::QDepthTest::Equal0x0202프래그먼트 깊이가 z-버퍼 값과 같을 때 깊이 테스트를 통과함
Qt3DRender::QDepthTest::GreaterOrEqual0x0206프래그먼트 깊이가 z-버퍼 값보다 크거나 같을 때 깊이 테스트를 통과
Qt3DRender::QDepthTest::Greater0x0204프래그먼트 깊이가 z-버퍼 값보다 크면 깊이 테스트를 통과
Qt3DRender::QDepthTest::NotEqual0x0205프래그먼트 깊이가 z-버퍼 값과 같지 않은 경우 깊이 테스트를 통과

속성 설명서

depthFunction : DepthFunction

깊이 테스트에서 현재 사용 중인 함수를 보관합니다. 기본값은 Never입니다.

액세스 함수:

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

알림 신호:

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

멤버 함수 설명서

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

이 생성자는 지정된 ` parent`을 사용하여 새로운 ` QDepthTest::QDepthTest ` 인스턴스를 생성합니다.

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