En esta página

Qt3DRender::QSpotLight Class

class Qt3DRender::QSpotLight

Incluir 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.