Light QML Type
Un tipo base abstracto no creable para todas las luces. Más...
| Import Statement: | import QtQuick3D |
| Inherits: | |
| Inherited By: |
Propiedades
- ambientColor : color
- bakeMode : enumeration
- brightness : real
- castsShadow : bool
- color : color
- pcfFactor : real
(since 6.8) - scope : Node
- shadowBias : real
- shadowFactor : real
- shadowMapFar : real
- shadowMapQuality : enumeration
- softShadowQuality : enumeration
(since 6.8) - use32BitShadowmap : bool
(since 6.9)
Descripción detallada
La luz en sí misma es una base no creable para todos sus subtipos. Los subtipos ofrecen múltiples opciones para determinar el estilo de la luz.
Para ver ejemplos de uso, consulta el ejemplo de luces en 3D deQt Quick .
Véase también DirectionalLight y PointLight.
Documentación de propiedades
ambientColor : color
Esta propiedad define el color de fondo que se aplica a los materiales antes de que sean iluminados por esta luz. El valor por defecto es el negro, rgb(0, 0, 0).
bakeMode : enumeration
Esta propiedad controla si la luz está activa en la iluminación precalculada, como por ejemplo al generar mapas de luz.
| Constante | Descripción |
|---|---|
Light.BakeModeDisabled | La luz no se utiliza en la iluminación precalculada. |
Light.BakeModeIndirect | La contribución de la iluminación indirecta (para la iluminación global) se hornea para esta luz. La iluminación directa (difusa, especular y mapeado de sombras en tiempo real) se calcula normalmente para la luz en tiempo de ejecución. En tiempo de ejecución, cuando no se está en modo de horneado, el renderizador intentará muestrear el mapa de luces para obtener los datos de iluminación indirecta y combinarlos con los resultados de los cálculos en tiempo real. |
Light.BakeModeAll | Tanto la iluminación directa (difusa, sombras) como la indirecta se hornean para esta luz. La luz no tendrá contribución especular y no generará mapas de sombras en tiempo real, pero siempre tendrá sombras horneadas. En tiempo de ejecución, cuando no se está en modo de horneado, el renderizador intentará muestrear el mapa de luz en lugar de realizar los cálculos estándar en tiempo real para la iluminación difusa y el mapeado de sombras. |
El valor por defecto es Light.BakeModeDisabled
Nota: Al igual que con Model::usedInBakedLighting, los diseñadores y desarrolladores deben evaluar siempre, luz por luz, si la luz es adecuada para participar en la iluminación preprocesada.
Advertencia: Las luces con propiedades que cambian dinámicamente —por ejemplo, posición animada, rotación u otras propiedades— no son adecuadas para participar en la iluminación precalculada.
Esta propiedad es relevante tanto al realizar el «baking» como al utilizar mapas de luz. Es esencial que haya un estado coherente entre la ejecución del «baking» y las ejecuciones posteriores que utilicen los datos generados. Cambiar a un valor diferente no modificará los datos generados previamente y almacenados de forma persistente en los mapas de luz; sin embargo, el comportamiento de renderizado del motor seguirá el valor actual de la propiedad.
Para obtener más información sobre cómo hornear mapas de luz, consulta la sección «Mapas de luz e iluminación global».
Véase también « Model::usedInBakedLighting» , « Model::bakedLightmap », « Lightmapper » y «Lightmaps and Global Illumination».
brightness : real
Esta propiedad define un multiplicador general para los efectos de esta luz. El valor por defecto es 1.
castsShadow : bool
Cuando esta propiedad está activada, la luz proyectará sombras (en tiempo real). El valor por defecto es «false».
Nota: Cuando « bakeMode » está configurado en «Light.BakeModeAll», esta propiedad no tiene ningún efecto. Una luz totalmente horneada siempre tiene sombras horneadas, pero nunca participará en el mapeado de sombras en tiempo real.
color : color
Esta propiedad define el color que se aplica a los modelos iluminados por esta luz. El valor por defecto es el blanco, rgb(255, 255, 255).
pcfFactor : real [since 6.8]
Esta propiedad controla el factor PCF (filtrado por porcentaje de proximidad). Este valor intenta aproximar el radio de un filtrado PCF en el espacio del mundo.
Nota: Para que esta propiedad surta efecto, es necesario configurarel PCF en « softShadowQuality ».
Valor por defecto: 2.0
Esta propiedad se introdujo en Qt 6.8.
Véase también Light::softShadowQuality.
scope : Node
Esta propiedad permite seleccionar un nodo de la escena. Solo ese nodo y sus hijos se ven afectados por esta luz. Por defecto, el valor es nulo, lo que indica que no se ha seleccionado ningún ámbito.
Nota: Las lucescon ámbito no pueden proyectar sombras en tiempo real, lo que significa que una luz con un ámbito establecido no debe tener el parámetro « castsShadow » (Proyectar sombras en tiempo real) activado. Sin embargo, pueden generar sombras precalculadas cuando el parámetro « bakeMode » (Modo de horneado de la luz) está establecido en «Light.BakeModeAll».
shadowBias : real
Esta propiedad se utiliza para ajustar el efecto de sombra cuando los objetos proyectan sombras sobre sí mismos. El valor intenta aproximar el desplazamiento en el espacio mundial, por lo que debe ajustarse en función del tamaño de la escena.
El valor por defecto es 10
shadowFactor : real
Esta propiedad determina el grado de oscuridad que deben tener las sombras proyectadas. El rango de valores es [0, 100], donde 0 significa que no hay sombras y 100 significa que la luz queda totalmente en sombra.
El valor por defecto es 75.
shadowMapFar : real
Esta propiedad determina la distancia máxima del mapa de sombras. Cuanto menor sea el valor, mayor será la precisión y mejor será el resultado del mapa. El valor por defecto es 5000. La unidad es «puntos» en el espacio de coordenadas local.
shadowMapQuality : enumeration
Esta propiedad establece la calidad del mapa de sombras creado para el renderizado de sombras. Una calidad más baja consume menos recursos, pero produce sombras de menor calidad, mientras que una calidad más alta consume más recursos, pero produce sombras de mejor calidad.
Los valores de calidad admitidos son:
| Constante | Descripción |
|---|---|
Light.ShadowMapQualityLow | Renderiza el mapa de sombras utilizando una textura de 256x256. |
Light.ShadowMapQualityMedium | Renderiza el mapa de sombras utilizando una textura de 512x512. |
Light.ShadowMapQualityHigh | Renderiza el mapa de sombras utilizando una textura de 1024x1024. |
Light.ShadowMapQualityVeryHigh | Renderiza el mapa de sombras utilizando una textura de 2048x2048. |
Light.ShadowMapQualityUltra | Renderiza el mapa de sombras utilizando una textura de 4096x4096. |
El valor por defecto es Light.ShadowMapQualityLow
softShadowQuality : enumeration [since 6.8]
Esta propiedad indica el nivel de suavidad de las sombras que debe utilizarse cuando las sombras están activadas. El número real de muestras que se utilizan al renderizar las sombras viene determinado por el nivel de calidad más alto establecido por cualquiera de las luces utilizadas por un material.
| Constante | Descripción |
|---|---|
Light.Hard | Sin sombras suaves. |
Light.PCF4 | Filtrado de sombras suaves «porcentaje más cercano» con 4 muestras. |
Light.PCF8 | Sombras suaves con filtrado «porcentaje más cercano» y 8 muestras. |
Light.PCF16 | Filtrado de sombras suaves «porcentaje más cercano» con 16 muestras. |
Light.PCF32 | Filtrado de sombras suaves «porcentaje más cercano» con 32 muestras. |
Light.PCF64 | Filtrado de sombras suaves con 64 muestras según el porcentaje más cercano. |
Valor predeterminado: Light.PCF4
Nota: Actualmente , los valores superiores a 16 muestras se tratarán como 16 muestras.
Esta propiedad se introdujo en Qt 6.8.
Véase también Light::pcfFactor y Light::shadowFilter.
use32BitShadowmap : bool [since 6.9]
Esta propiedad determina si se debe utilizar un búfer de profundidad de mapa de sombras de 32 bits para la luz.
Valor por defecto: false
Esta propiedad se introdujo en Qt 6.9.
Véase también Light::castsShadow.
© 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.