En esta página

Qt3DRender::QPointLight Class

class Qt3DRender::QPointLight

Incorpora 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

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.