SpotLight QML Type
장면의 스포트라이트를 정의합니다. 더 보기...
Import Statement: | import QtQuick3D |
Inherits: |
속성
- coneAngle : real
- constantFade : real
- innerConeAngle : real
- linearFade : real
- quadraticFade : real
자세한 설명
스팟 조명은 원뿔 모양으로 한 방향을 향해 빛을 방출하며, 이는 coneAngle 속성으로 정의됩니다. 빛의 강도는 coneAngle 에 접근하면 감소합니다. 빛의 강도가 감소하기 시작하는 각도는 innerConeAngle 에 의해 정의됩니다. 두 각도는 모두 도 단위로 정의됩니다.
innerConeAngle 내부에서 스팟 조명은 포인트 조명과 유사하게 작동합니다. 여기서 빛의 강도는 역제곱 법칙에 따라 감소합니다. 그러나 페이드오프(및 범위)는 constantFade, linearFade, quadraticFade 속성을 사용하여 제어할 수 있습니다. 빛 감쇠는 다음 공식을 사용하여 계산됩니다: constantFade + distance
* (linearFade * 0.01) + distance
* (quadraticFade * 0.0001)^2
간단한 예를 살펴보겠습니다. 여기서 스포트라이트는 카메라와 씬 중앙의 중간 지점인 Z축의 300에 배치되어 있습니다. 기본적으로 조명은 Z축 방향으로 발광합니다. brightness 을 10으로 늘려 일반적인 스포트라이트처럼 보이게 합니다.
import QtQuick import QtQuick3D View3D { anchors.fill: parent PerspectiveCamera { z: 600 } SpotLight { z: 300 brightness: 10 ambientColor: Qt.rgba(0.1, 0.1, 0.1, 1.0) } Model { source: "#Rectangle" scale: Qt.vector3d(10, 10, 10) z: -100 materials: PrincipledMaterial { } } Model { source: "#Sphere" scale: Qt.vector3d(2, 2, 2) materials: PrincipledMaterial { baseColor: "#40c060" roughness: 0.1 } } }
회전은 DirectionalLight 과 비슷하게 이루어집니다. 여기서는 조명이 오른쪽으로 더 많이 방출되도록 하므로 Y 축을 중심으로 -20도 회전합니다. coneAngle 을 기본값 40 대신 30으로 설정하여 원뿔을 줄입니다. 또한 innerConeAngle 을 10으로 변경하여 강도 시작을 더 일찍 감소시킵니다.
SpotLight { z: 300 brightness: 10 ambientColor: Qt.rgba(0.1, 0.1, 0.1, 1.0) eulerRotation.y: -20 coneAngle: 30 innerConeAngle: 10 }
추가 사용 예는 Qt Quick 3D - 조명 예시를 참조하세요.
DirectionalLight, PointLight, 섀도 매핑도참조하세요 .
프로퍼티 문서
coneAngle : real |
이 프로퍼티는 조명이 씬에 영향을 미치지 않는 컷오프 각도(가장자리에서 가장자리까지)를 정의합니다. 0
과 180
사이의 각도로 정의됩니다. 기본값은 40
입니다.
참고: 원뿔 각도가 180
도에 가까워지면 그림자 품질이 저하되기 시작합니다. 따라서 170
미만의 값을 사용하는 것이 좋습니다.
constantFade : real |
이 속성은 빛의 감쇠 항의 상수 계수입니다. 기본값은 1.0입니다.
innerConeAngle : real |
linearFade : real |
이 속성은 조명까지의 거리에 비례하여 조명 효과가 조명을 어둡게 하는 속도를 높입니다. 기본값은 0.0
이며, 이는 조명에 선형 페이드가 없음을 의미합니다. 여기서 사용되는 값은 0.01
을 곱한 후 빛 감쇠를 계산하는 데 사용됩니다.
quadraticFade : real |
이 속성은 역제곱 법칙에 비례하여 조명 효과가 빛을 어둡게 하는 속도를 증가시킵니다. 기본값은 1.0으로, 스팟 조명 페이드가 역제곱 법칙을 정확히 따르는 즉, 물체와의 거리가 두 배가 되면 빛의 강도가 1/4로 감소한다는 의미입니다. 여기서 사용되는 값은 0.0001
을 곱한 후 빛 감쇠를 계산하는 데 사용됩니다.
© 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.