DebugSettings QML Type
디버그 설정을 구성하는 데 사용됩니다. 더 보기...
| Import Statement: | import QtQuick3D |
| Inherits: |
속성
- disableShadowCameraUpdate : bool
(since 6.8) - drawCascades : bool
(since 6.8) - drawDirectionalLightShadowBoxes : bool
(since 6.8) - drawPointLightShadowBoxes : bool
(since 6.9) - drawSceneCascadeIntersection : bool
(since 6.8) - drawShadowCastingBounds : bool
(since 6.8) - drawShadowReceivingBounds : bool
(since 6.8) - materialOverride : enumeration
(since 6.5) - wireframeEnabled : bool
(since 6.5)
상세 설명
렌더러는 디버깅을 용이하게 하기 위해 다양한 뷰를 출력하도록 구성할 수 있습니다. 이 컴포넌트는 이러한 디버그 뷰를 구성하는 데 사용됩니다.
프로그래밍 방식의 제어 외에도, 애플리케이션에서 해당 인스턴스를 Qt Quick 장면에 추가한 경우, materialOverride 및 wireframeEnabled 와 같은 속성을 DebugView 항목을 통해 대화형으로 제어할 수도 있습니다.
속성 설명서
disableShadowCameraUpdate : bool [since 6.8]
이 속성이 활성화되면 섀도우맵에 대한 카메라 업데이트가 비활성화됩니다. 즉, 섀도우맵 계산 시에만 뷰 프러스텀이 공간 내에서 고정됩니다. 이는 카메라 프러스텀과 섀도우맵을 다양한 각도에서 볼 수 있도록 해주는 디버그 도구일 뿐입니다.
기본값은 ` false`입니다.
이 속성은 Qt 6.8에서 도입되었습니다.
drawCascades : bool [since 6.8]
이 속성이 활성화되면 섀도맵 캐스케이드가 시작되고 끝나는 위치를 나타내는 분할선이 포함된 프러스텀이 그려집니다.
기본값은 ` false`입니다.
이 속성은 Qt 6.8에서 도입되었습니다.
drawDirectionalLightShadowBoxes : bool [since 6.8]
이 속성이 활성화되면 모든 방향광의 섀도우맵에 대해 바운딩 박스가 그려집니다.
기본값은 false 입니다.
이 속성은 Qt 6.8에서 도입되었습니다.
drawPointLightShadowBoxes : bool [since 6.9]
이 속성이 활성화되면 각 포인트 라이트의 섀도우 맵에 바운딩 박스가 그려집니다.
기본값은 false 입니다.
이 속성은 Qt 6.9에서 도입되었습니다.
drawSceneCascadeIntersection : bool [since 6.8]
이 속성이 활성화되면 섀도우맵 캐스케이드와 씬 내의 캐스팅 및 리시빙 오브젝트 간의 교차 영역이 렌더링됩니다.
기본값은 ' false'입니다.
이 속성은 Qt 6.8에서 도입되었습니다.
drawShadowCastingBounds : bool [since 6.8]
이 속성이 활성화되면 그림자를 드리우는 오브젝트에 대해 바운딩 박스가 그려집니다.
기본값은 false 입니다.
이 속성은 Qt 6.8에서 도입되었습니다.
drawShadowReceivingBounds : bool [since 6.8]
이 속성이 활성화되면 그림자가 투영되는 오브젝트에 대해 바운딩 박스가 그려집니다.
기본값은 false 입니다.
이 속성은 Qt 6.8에서 도입되었습니다.
materialOverride : enumeration [since 6.5]
이 속성은 전체 렌더링 프로세스 중 특정 측면만 반영되도록 모든 머티리얼의 렌더링 방식을 변경합니다. 이는 머티리얼이 왜 그런 모습으로 보이는지 더 잘 이해하기 위한 디버깅 도구로 사용할 수 있습니다.
기본값은 DebugSettings.None
| 상수 | 설명 |
|---|---|
DebugSettings.None | 머티리얼 재정의가 무시되고, 렌더링은 평소와 같이 진행됩니다. |
DebugSettings.BaseColor | 머티리얼의 BaseColor 또는 Diffuse 색상이 조명 처리 없이 그대로 전달됩니다. |
DebugSettings.Roughness | 머티리얼의 거칠기(Roughness)는 조명이 적용되지 않은 그레이스케일 값으로 전달됩니다. |
DebugSettings.Metalness | 머티리얼의 Metalness는 조명이 적용되지 않은 그레이스케일 값으로 그대로 전달됩니다. |
DebugSettings.Diffuse | 모든 조명이 적용된 후의 머티리얼의 디퓨즈 기여도만 반영됩니다. |
DebugSettings.Specular | 모든 조명이 적용된 후 머티리얼의 스페큘러 기여도만 반영됩니다. |
DebugSettings.ShadowOcclusion | 그림자로 인한 오클루전(Occlusion)을 그레이스케일 값으로 표현한 것입니다. |
DebugSettings.Emission | 머티리얼의 발광 기여도만 포함됩니다. |
DebugSettings.AmbientOcclusion | 머티리얼의 앰비언트 오클루전만 포함됩니다. |
DebugSettings.Normals | 머티리얼의 보간된 월드 스페이스 법선 값을 RGB 색상으로 매핑한 값입니다. |
DebugSettings.Tangents | 머티리얼의 보간된 월드 스페이스 탄젠트 값을 RGB 색상으로 매핑한 값입니다. 이 값은 탄젠트 값이 사용될 때만 표시됩니다. |
DebugSettings.Binormals | 머티리얼의 보간된 월드 스페이스 바이노멀 값을 RGB 색상으로 매핑한 것입니다. 바이노멀 값을 사용하는 경우에만 표시됩니다. |
DebugSettings.F0 | 이는 0도에서의 프레넬 반사율을 나타냅니다. F0 값을 계산하는 머티리얼에서만 표시됩니다. |
예를 들어, Sponza 모델이 포함된 다음 장면을 살펴보겠습니다. 이 장면은 ‘ SceneEnvironment::lightProbe ’을 통해 이미지 기반 조명을 사용하며, 방향성 조명도 포함되어 있습니다.
DebugSettings.BaseColor 설정:
DebugSettings.Roughness 설정:
DebugSettings.Metalness 설정:
DebugSettings.Diffuse 설정:
DebugSettings.Specular 설정 :
DebugSettings.Normals 설정:
이 속성은 Qt 6.5에서 도입되었습니다.
wireframeEnabled : bool [since 6.5]
이 속성은 폴리곤 채우기 모드를 ‘채우기’ 대신 ‘선’으로 변경하여 모든 머티리얼의 렌더링 방식을 바꿉니다. 이 경우 와이어프레임 형태로 표시되지만, 음영 색상은 여전히 메쉬의 각 머티리얼을 반영합니다.
기본값은 ` false`입니다.
이 속성은 Qt 6.5에서 도입되었습니다.
© 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.
