QSpotLight Class
class Qt3DRender::QSpotLightQt 3D 장면에서 스포트라이트 오브젝트를 캡슐화합니다. 더 보기...
| 헤더: | #include <QSpotLight> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender)target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| QML에서: | SpotLight |
| 상속합니다: | Qt3DRender::QAbstractLight |
| 상태: | Deprecated |
속성
|
|
공용 기능
| 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를 생성합니다.
© 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.
