Qt3DRender::QPointLight Class
class Qt3DRender::QPointLightEncapsula un objeto Luz puntual en una escena Qt 3D. Más...
| Cabecera: | #include <QPointLight> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender)target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| En QML: | PointLight |
| Hereda: | Qt3DRender::QAbstractLight |
| Status: | Obsoleto |
Propiedades
- constantAttenuation : float
- linearAttenuation : float
- quadraticAttenuation : float
Funciones públicas
| QPointLight(Qt3DCore::QNode *parent = nullptr) | |
| float | constantAttenuation() const |
| float | linearAttenuation() const |
| float | quadraticAttenuation() const |
Ranuras públicas
| void | setConstantAttenuation(float value) |
| void | setLinearAttenuation(float value) |
| void | setQuadraticAttenuation(float value) |
Señales
| void | constantAttenuationChanged(float constantAttenuation) |
| void | linearAttenuationChanged(float linearAttenuation) |
| void | quadraticAttenuationChanged(float quadraticAttenuation) |
Descripción detallada
Una luz puntual es una fuente de luz que emite luz en todas direcciones, desde un único punto. Conceptualmente, es similar a la luz emitida por una bombilla estándar.
Una luz puntual utiliza tres factores de atenuación para describir cómo disminuye la intensidad de la luz con la distancia. Estos factores están diseñados para ser utilizados conjuntamente en el cálculo de la atenuación total. Para los materiales en Qt3D Extras se utiliza la siguiente fórmula, donde la distancia es la distancia de la luz a la superficie que se está renderizando:
totalAttenuation = 1.0 / (constantAttenuation + (linearAttenuation * distance) + (quadraticAttenuation * distance * distance));
Los materiales personalizados pueden elegir interpretar estos factores de forma diferente.
Documentación de Propiedades
constantAttenuation : float
Especifica la atenuación constante de la luz puntual.
Nota: El significado y uso exacto de esta propiedad depende de la implementación del material.
Funciones de acceso:
| float | constantAttenuation() const |
| void | setConstantAttenuation(float value) |
Señal notificadora:
| void | constantAttenuationChanged(float constantAttenuation) |
linearAttenuation : float
Especifica la atenuación lineal de la luz puntual.
Nota: El significado exacto y el uso de esta propiedad depende de la implementación del material.
Funciones de acceso:
| float | linearAttenuation() const |
| void | setLinearAttenuation(float value) |
Señal notificadora:
| void | linearAttenuationChanged(float linearAttenuation) |
quadraticAttenuation : float
Especifica la atenuación cuadrática de la luz puntual.
Nota: El significado exacto y el uso de esta propiedad depende de la implementación del material.
Funciones de acceso:
| float | quadraticAttenuation() const |
| void | setQuadraticAttenuation(float value) |
Señal notificadora:
| void | quadraticAttenuationChanged(float quadraticAttenuation) |
Documentación de la función miembro
[explicit] QPointLight::QPointLight(Qt3DCore::QNode *parent = nullptr)
Construye un nuevo QPointLight con la dirección parent especificada.
© 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.
