Qt3DRender::QPointLight Class
class Qt3DRender::QPointLightIncorpora un objeto «Point Light» en una escena de « Qt 3D ». Más información...
| Encabezado: | #include <qpointlight.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| En QML: | PointLight |
| Heredado de: | Qt3DRender::QAbstractLight |
| Estado: | Obsoleto |
Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.
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 las direcciones desde un único punto. Conceptualmente, es similar a la luz que emite 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 utilizarse conjuntamente a la hora de calcular la atenuación total. Para los materiales de Qt3D Extras se utiliza la siguiente fórmula, donde «distancia» es la distancia desde la luz hasta la superficie que se está renderizando:
totalAttenuation = 1.0 / (constantAttenuation + (linearAttenuation * distance) + (quadraticAttenuation * distance * distance));Los materiales personalizados pueden optar por 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 el uso exactos de esta propiedad dependen de la implementación del material.
Funciones de acceso:
| float | constantAttenuation() const |
| void | setConstantAttenuation(float value) |
Señal de notificación:
| void | constantAttenuationChanged(float constantAttenuation) |
linearAttenuation : float
Especifica la atenuación lineal de la luz puntual.
Nota: El significado y el uso exactos de esta propiedad dependen de la implementación del material.
Funciones de acceso:
| float | linearAttenuation() const |
| void | setLinearAttenuation(float value) |
Señal de notificación:
| void | linearAttenuationChanged(float linearAttenuation) |
quadraticAttenuation : float
Especifica la atenuación cuadrática de la luz puntual.
Nota: El significado y el uso exactos de esta propiedad dependen de la implementación del material.
Funciones de acceso:
| float | quadraticAttenuation() const |
| void | setQuadraticAttenuation(float value) |
Señal de notificación:
| void | quadraticAttenuationChanged(float quadraticAttenuation) |
Documentación de las funciones de miembro
[explicit] QPointLight::QPointLight(Qt3DCore::QNode *parent = nullptr)
Crea un nuevo objeto `QPointLight` con el ` parent` especificado.
© 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.