Qt3DRender::QPointLight Class
class Qt3DRender::QPointLightQt 3D 장면에서 포인트 라이트 오브젝트를 캡슐화합니다. 더 보기...
| 헤더: | #include <qpointlight.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| QML에서: | PointLight |
| 상속: | Qt3DRender::QAbstractLight |
| 상태: | 사용 중단됨 |
이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.
속성
- constantAttenuation : float
- linearAttenuation : float
- quadraticAttenuation : float
공개 함수
| QPointLight(Qt3DCore::QNode *parent = nullptr) | |
| float | constantAttenuation() const |
| float | linearAttenuation() const |
| float | quadraticAttenuation() const |
공개 슬롯
| void | setConstantAttenuation(float value) |
| void | setLinearAttenuation(float value) |
| void | setQuadraticAttenuation(float value) |
신호
| void | constantAttenuationChanged(float constantAttenuation) |
| void | linearAttenuationChanged(float linearAttenuation) |
| 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) |
linearAttenuation : float
점광원의 선형 감쇠를 지정합니다.
참고: 이 속성의 정확한의미와 사용법은 해당 소재의 구현 방식에 따라 달라집니다.
액세스 함수:
| float | linearAttenuation() const |
| void | setLinearAttenuation(float value) |
알림 신호:
| void | linearAttenuationChanged(float linearAttenuation) |
quadraticAttenuation : float
점 광원의 2차 감쇠를 지정합니다.
참고: 이 속성의 정확한의미와 사용법은 소재 구현에 따라 달라집니다.
액세스 함수:
| float | quadraticAttenuation() const |
| void | setQuadraticAttenuation(float value) |
알림 신호:
| void | quadraticAttenuationChanged(float quadraticAttenuation) |
멤버 함수 문서
[explicit] QPointLight::QPointLight(Qt3DCore::QNode *parent = nullptr)
지정된 ` parent`를 사용하여 새로운 `QPointLight` 객체를 생성합니다.
© 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.
