Qt3DRender::QSpotLight Class
class Qt3DRender::QSpotLightQt 3D 장면에서 스포트라이트 오브젝트를 캡슐화합니다. 더 보기...
| 헤더: | #include <qspotlight.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| QML에서: | SpotLight |
| 상속: | Qt3DRender::QAbstractLight |
| 상태: | 사용 중단됨 |
이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.
속성
|
|
공개 함수
| QSpotLight(Qt3DCore::QNode *parent = nullptr) | |
| float | constantAttenuation() const |
| float | cutOffAngle() const |
| float | linearAttenuation() const |
| QVector3D | localDirection() const |
| float | quadraticAttenuation() const |
공개 슬롯
| void | setConstantAttenuation(float value) |
| void | setCutOffAngle(float cutOffAngle) |
| void | setLinearAttenuation(float value) |
| void | setLocalDirection(const QVector3D &localDirection) |
| void | setQuadraticAttenuation(float value) |
신호
| void | constantAttenuationChanged(float constantAttenuation) |
| void | cutOffAngleChanged(float cutOffAngle) |
| void | linearAttenuationChanged(float linearAttenuation) |
| void | localDirectionChanged(const QVector3D &localDirection) |
| void | quadraticAttenuationChanged(float quadraticAttenuation) |
상세 설명
스포트라이트는 특정 방향으로 원뿔 모양의 빛을 방출하는 광원입니다.
스포트라이트는 거리에 따라 빛의 강도가 어떻게 감소하는지를 설명하기 위해 세 가지 감쇠 계수를 사용합니다. 이 계수들은 총 감쇠량을 계산할 때 함께 사용되도록 설계되었습니다. Qt3D Extras의 재질에서는 다음 공식이 사용되며, 여기서 거리는 광원과 렌더링되는 표면 사이의 거리를 의미합니다:
totalAttenuation = 1.0 / (constantAttenuation + (linearAttenuation * distance) + (quadraticAttenuation * distance * distance));사용자 정의 재질의 경우 이러한 계수를 다르게 해석할 수 있습니다.
속성 설명서
constantAttenuation : float
스팟 라이트의 일정한 감쇠량을 지정합니다.
참고: 이 속성의 정확한의미와 사용법은 해당 소재의 구현 방식에 따라 달라집니다.
액세스 함수:
| float | constantAttenuation() const |
| void | setConstantAttenuation(float value) |
알림 신호:
| void | constantAttenuationChanged(float constantAttenuation) |
cutOffAngle : float
스포트라이트의 컷오프 각도를 지정합니다.
참고: 이 속성의 정확한의미와 사용법은 해당 소재의 구현 방식에 따라 다릅니다.
액세스 함수:
| float | cutOffAngle() const |
| void | setCutOffAngle(float cutOffAngle) |
알림 신호:
| void | cutOffAngleChanged(float cutOffAngle) |
linearAttenuation : float
스팟 라이트의 선형 감쇠를 지정합니다.
참고: 이 속성의 정확한의미와 사용법은 해당 소재의 구현 방식에 따라 달라집니다.
액세스 함수:
| float | linearAttenuation() const |
| void | setLinearAttenuation(float value) |
알림 신호:
| void | linearAttenuationChanged(float linearAttenuation) |
localDirection : QVector3D
스포트라이트의 국소 방향을 지정합니다.
참고: 이 속성의 정확한의미와 사용법은 머티리얼 구현에 따라 다릅니다.
액세스 함수:
| QVector3D | localDirection() const |
| void | setLocalDirection(const QVector3D &localDirection) |
알림 신호:
| void | localDirectionChanged(const QVector3D &localDirection) |
quadraticAttenuation : float
스팟 라이트의 2차 감쇠를 지정합니다.
참고: 이 속성의 정확한의미와 사용법은 해당 소재의 구현 방식에 따라 달라집니다.
액세스 함수:
| float | quadraticAttenuation() const |
| void | setQuadraticAttenuation(float value) |
알림 신호:
| void | quadraticAttenuationChanged(float quadraticAttenuation) |
멤버 함수 문서
[explicit] QSpotLight::QSpotLight(Qt3DCore::QNode *parent = nullptr)
지정된 ` parent`를 사용하여 새로운 QSpotLight 객체를 생성합니다.
© 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.
