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