En esta página

SpotLight QML Type

Encapsular un objeto «Spot Light» en una escena « Qt 3D ». Más información...

Import Statement: import Qt3D.Render 2.12
In C++: QSpotLight
Inherits:

Light

Status: Deprecated

Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.

Propiedades

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 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á representando:

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 : real

Especifica la atenuación constante del foco.

Nota: El significado y el uso exactos de esta propiedad dependen de la implementación del material.

cutOffAngle : real

Especifica el ángulo de corte del foco.

Nota: El significado y el uso exactos de esta propiedad dependen de la implementación concreta.

linearAttenuation : real

Especifica la atenuación lineal del foco.

Nota: El significado y el uso exactos de esta propiedad dependen de la implementación del material.

localDirection : vector3d

Especifica la dirección local del foco.

Nota: El significado exacto y el uso de esta propiedad dependen de la implementación del material.

quadraticAttenuation : real

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.

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