Qt3DRender::QSpotLight Class
class Qt3DRender::QSpotLightIncluir un objeto «Spot Light» en una escena de « Qt 3D ». Más...
| Encabezado: | #include <qspotlight.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| En QML: | SpotLight |
| Heredado de: | Qt3DRender::QAbstractLight |
| Estado: | Obsoleto |
Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.
Propiedades
|
|
Funciones públicas
| QSpotLight(Qt3DCore::QNode *parent = nullptr) | |
| float | constantAttenuation() const |
| float | cutOffAngle() const |
| float | linearAttenuation() const |
| QVector3D | localDirection() const |
| float | quadraticAttenuation() const |
Ranuras públicas
| void | setConstantAttenuation(float value) |
| void | setCutOffAngle(float cutOffAngle) |
| void | setLinearAttenuation(float value) |
| void | setLocalDirection(const QVector3D &localDirection) |
| void | setQuadraticAttenuation(float value) |
Señales
| void | constantAttenuationChanged(float constantAttenuation) |
| void | cutOffAngleChanged(float cutOffAngle) |
| void | linearAttenuationChanged(float linearAttenuation) |
| void | localDirectionChanged(const QVector3D &localDirection) |
| void | quadraticAttenuationChanged(float quadraticAttenuation) |
Descripción detallada
Un foco es una fuente de luz que emite un cono de luz en una dirección concreta.
Un foco 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 en el cálculo de 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 del foco.
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) |
cutOffAngle : float
Especifica el ángulo de corte del haz de luz.
Nota: El significado exacto y el uso de esta propiedad dependen de la implementación concreta.
Funciones de acceso:
| float | cutOffAngle() const |
| void | setCutOffAngle(float cutOffAngle) |
Señal de notificación:
| void | cutOffAngleChanged(float cutOffAngle) |
linearAttenuation : float
Especifica la atenuación lineal del haz de luz.
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) |
localDirection : QVector3D
Especifica la dirección local del foco.
Nota: El significado y el uso exactos de esta propiedad dependen de la implementación del material.
Funciones de acceso:
| QVector3D | localDirection() const |
| void | setLocalDirection(const QVector3D &localDirection) |
Señal de notificación:
| void | localDirectionChanged(const QVector3D &localDirection) |
quadraticAttenuation : float
Especifica la atenuación cuadrática del haz de luz.
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 funciones de miembro
[explicit] QSpotLight::QSpotLight(Qt3DCore::QNode *parent = nullptr)
Crea un nuevo objeto QSpotLight 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.