SpotLight QML Type
Define un foco en la escena. Más información...
| Import Statement: | import QtQuick3D |
| Inherits: |
Propiedades
- coneAngle : real
- constantFade : real
- innerConeAngle : real
- linearFade : real
- quadraticFade : real
Descripción detallada
El foco emite luz en una sola dirección formando un cono, cuyo ángulo viene definido por la propiedad « coneAngle ». La intensidad de la luz disminuye a medida que se acerca al « coneAngle ». El ángulo a partir del cual la intensidad de la luz comienza a disminuir viene definido por « innerConeAngle ». Ambos ángulos se expresan en grados.
Dentro de innerConeAngle, el foco se comporta de forma similar a una luz puntual. Allí, la intensidad de la luz disminuye según la ley del inverso del cuadrado. Sin embargo, el desvanecimiento (y el alcance) se pueden controlar con las propiedades « constantFade », « linearFade » y « quadraticFade ». La atenuación de la luz se calcula mediante la fórmula: constantFade + distance * (linearFade * 0,01) + distance * (quadraticFade * 0,0001)^2
Veamos un ejemplo sencillo. Aquí se ha colocado un SpotLight a 300 en el eje Z, es decir, a mitad de camino entre la cámara y el centro de la escena. Por defecto, la luz se emite en la dirección del eje Z. Se ha aumentado el valor de « brightness » a 10 para que se parezca más a un foco típico.
import QtQuick
import QtQuick3D
View3D {
anchors.fill: parent
PerspectiveCamera { z: 600 }
SpotLight {
z: 300
brightness: 10
ambientColor: Qt.rgba(0.1, 0.1, 0.1, 1.0)
}
Model {
source: "#Rectangle"
scale: Qt.vector3d(10, 10, 10)
z: -100
materials: PrincipledMaterial { }
}
Model {
source: "#Sphere"
scale: Qt.vector3d(2, 2, 2)
materials: PrincipledMaterial {
baseColor: "#40c060"
roughness: 0.1
}
}
}
Las rotaciones se realizan de forma similar a la de « DirectionalLight ». En este caso, queremos que la luz se proyecte más hacia la derecha, por lo que la giramos alrededor del eje Y -20 grados. El cono se reduce estableciendo « coneAngle » en 30 en lugar del valor predeterminado de 40. También hacemos que la intensidad comience a disminuir antes, cambiando « innerConeAngle » a 10.
SpotLight {
z: 300
brightness: 10
ambientColor: Qt.rgba(0.1, 0.1, 0.1, 1.0)
eulerRotation.y: -20
coneAngle: 30
innerConeAngle: 10
}
Para ver más ejemplos de uso, consulta Qt Quick 3D - Ejemplo de luces.
Véase también DirectionalLight, PointLight y Mapeado de sombras.
Documentación de propiedades
coneAngle : real
Esta propiedad define el ángulo de corte (de borde a borde) más allá del cual la luz no afecta a la escena. Se define en grados entre 0 y 180. El valor por defecto es 40.
Nota: Cuando el ángulo del cono se aproxima a 180 grados, la calidad de las sombras comienza a deteriorarse. Por lo tanto, se recomienda un valor inferior a 170.
constantFade : real
Esta propiedad es un factor constante del término de atenuación de la luz. El valor por defecto es 1,0.
innerConeAngle : real
Esta propiedad define el ángulo (de borde a borde) en el que la intensidad de la luz comienza a disminuir gradualmente a medida que se aproxima a coneAngle. Se define en grados, entre 0 y 180. Si el valor establecido es mayor que coneAngle, se comportará como si tuviera el mismo valor que coneAngle. El valor por defecto es 30.
linearFade : real
Esta propiedad aumenta la velocidad a la que el efecto de iluminación atenúa la luz en proporción a la distancia a la fuente de luz. El valor por defecto es « 0.0 », lo que significa que la luz no presenta un atenuado lineal. El valor utilizado aquí se multiplica por « 0.01 » antes de emplearse para calcular la atenuación de la luz.
quadraticFade : real
Esta propiedad aumenta la velocidad a la que el efecto de iluminación atenúa la luz de forma proporcional a la ley del inverso del cuadrado. El valor por defecto es 1,0, lo que significa que el atenuado del foco sigue exactamente la ley del inverso del cuadrado; es decir, cuando la distancia a un objeto se duplica, la intensidad de la luz se reduce a una cuarta parte. El valor utilizado aquí se multiplica por 0.0001 antes de emplearse para calcular la atenuación de la luz.
© 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.