Lightmapper QML Type
Especifica los ajustes de cálculo de mapas de luz para una escena. Más...
| Import Statement: | import QtQuick3D |
| Since: | Qt 6.4 |
| Inherits: |
Propiedades
- adaptiveBiasEnabled : bool
- bias : real
- bounces : int
- denoiseSigma : real
(since 6.10) - indirectLightEnabled : bool
- indirectLightFactor : real
- indirectLightWorkgroupSize : int
- opacityThreshold : real
- samples : int
- source : url
(since 6.10) - texelsPerUnit : real
(since 6.10)
Descripción detallada
Se utiliza al realizar el «bake» de la iluminación directa e indirecta. La mayoría de estos ajustes no son relevantes en otros casos, como cuando se utilizan mapas de luz ya generados para renderizar una escena. La excepción es ` source`, aunque este tiene un valor por defecto adecuado para el desarrollo.
Si el «bake» se realiza con éxito, se generará un único archivo con el valor especificado en « source ». Este archivo binario contiene los resultados del «bake», incluidos los mapas de luz por modelo y los archivos de malla con coordenadas UV compatibles con los mapas de luz. Se accede a los datos de cada modelo a través de « BakedLightmap::key ».
Los datos contenidos en el archivo de mapa de luz resultante están estrechamente vinculados entre sí y con el estado actual de la escena. Esto significa que cualquier modificación de los archivos de malla originales, de la configuración de Lightmapper u otros cambios en la escena requerirá que se ejecute un nuevo proceso de «bake» para ver el resultado actualizado.
Nota: A partir de Qt 6.4, el «bake» de mapas de luz se encuentra en una fase inicial de vista previa tecnológica. Es probable que se produzcan cambios en las funcionalidades, la calidad y la API en futuras versiones.
El objeto Lightmapper funciona en combinación con:
- Model::bakedLightmap y los archivos asociados « BakedLightmap »,
- Model::usedInBakedLighting y Model::texelsPerUnit,
- Light::bakeMode,
- el generador de mapas de luz integrado en el motor.
Véase también «Lightmaps y iluminación global», «Qt Quick 3D - Ejemplo de mapa de luces horneado» y «Qt Quick 3D - Ejemplo de mapa de luces SSGI».
Documentación de propiedades
adaptiveBiasEnabled : bool
Permite aplicar un sesgo adicional y dinámico basado en la normal de la superficie.
El valor por defecto es «true».
bias : real
Sesgo de raycasting utilizado durante el «baking». Ajusta el valor en caso de que se produzcan artefactos, por ejemplo, para reducir patrones de sombras no deseados. En muchos casos, el valor por defecto es suficiente.
El valor por defecto es 0,005.
bounces : int
El número máximo de rebotes de luz indirecta por muestra. El valor debe ser, como mínimo, 1; de lo contrario, no tiene sentido realizar el cálculo de la luz indirecta.
El valor por defecto es 3.
Este valor influye considerablemente tanto en el rendimiento como en la calidad de los mapas de luz resultantes durante el proceso de horneado de los mapas de luz.
denoiseSigma : real [default: 8, since 6.10]
Esta propiedad define el valor sigma del filtro de eliminación de ruido basado en medias no locales. Esto significa que, cuanto mayor sea este valor, más intenso será el efecto de desenfoque. Intenta mantener este valor lo más bajo posible para evitar perder detalles visuales sin dejar de eliminar el ruido.
Esta propiedad se introdujo en Qt 6.10.
indirectLightEnabled : bool
Normalmente no es necesario modificar este valor. El valor por defecto es «true». Si se establece esta propiedad en «false», se desactiva el cálculo de la luz indirecta durante el horneado del mapa de luces. De este modo, los mapas de textura resultantes solo contendrán información sobre la luz directa. En tiempo de ejecución, el motor seguirá utilizando los mapas con normalidad, dando por hecho que contienen tanto iluminación directa como indirecta.
indirectLightFactor : real
Multiplicador de la cantidad de luz indirecta. Aunque el valor 1 (es decir, el que no afecta al cálculo de la cantidad de luz indirecta) es el que ofrece resultados de renderizado estrictamente correctos, un valor ligeramente superior suele dar lugar a resultados más atractivos cuando se utiliza el mapa de luz, incluso con un número menor de rebotes.
El valor por defecto es 1.
indirectLightWorkgroupSize : int
El tamaño de los grupos de trabajo de muestra. Se intenta ejecutar estos grupos de trabajo en paralelo. (El comportamiento exacto depende del número de núcleos de CPU y de la configuración de QThreadPool )
El valor por defecto es 32. Con el recuento de muestras por defecto de 256, esto significa que se intenta ejecutar 8 grupos en paralelo por modelo.
opacityThreshold : real
El umbral de opacidad (alfa) por debajo del cual se ignora un objeto en las intersecciones entre rayos y mallas al calcular la iluminación mediante trazado de rayos. Cuando la opacidad es inferior al umbral, el modelo (submalla) no ocultará las luces y, por lo tanto, tampoco generará sombras.
El valor por defecto es 0,5.
Nota: El generador de mapas de luz tiene en cuenta el valor de « material's opacity » y el de « baseColor alpha », junto con el de « base color map's alpha ». Otras fuentes de semitransparencia, como el mapa de opacidad o los ajustes de corte alfa, se ignoran durante el proceso de horneado del mapa de luz.
samples : int
El número de muestras por texel del mapa de luces.
El valor por defecto es 256.
Este valor influye considerablemente tanto en el rendimiento como en la calidad de los mapas de luz resultantes durante el proceso de horneado de los mapas de luz.
source : url [default: file:lightmaps.bin, since 6.10]
La URL para cargar el archivo de mapa de luces en tiempo de ejecución y la ruta del archivo de salida cuando el proceso de «bake» se complete con éxito.
Al realizar el «bake», la ruta de salida se deducirá de la URL y debe corresponder a una ubicación de archivo normal en la que se pueda escribir. Por defecto, el valor es file:lightmaps.bin, lo que significa que el archivo se guardará en el directorio de trabajo actual y el resultado final aparecerá al instante si el «bake» se realiza correctamente.
En el mismo directorio que el archivo de salida, se crea un archivo .raw que contiene datos adicionales del mapa de luces utilizados antes de crear el archivo final del mapa de luces. Esto permite realizar únicamente la eliminación de ruido sin tener que procesar toda la escena entre ejecuciones, siempre que el archivo .raw esté presente.
Si deseas leer el mapa de luces como un recurso QRC, debes incrustarlo de la forma habitual y añadir el prefijo :/ o qrc:/ a la URL. El siguiente ejemplo intenta siempre cargar el archivo de mapa de luces incrustado a través de recursos. Primero, establece el valor en una ubicación en la que se pueda escribir y realiza el horneado. A continuación, copia el archivo generado en el directorio fuente. A continuación, al incluir el archivo en el proyecto CMake de la aplicación como un recurso bajo el prefijo /lightmaps, se permite que el proceso de compilación detecte el archivo y lo incluya en el ejecutable.
Lightmapper {
source: "qrc:/lightmaps/lightmaps.bin"
// will attempt to load from :/lightmaps/lightmaps.bin at runtime
// and write a file to lightmaps/lightmaps.bin when baking.
}Esta propiedad se introdujo en Qt 6.10.
texelsPerUnit : real [default: 1, since 6.10]
Esta propiedad define la escala de la unidad a texel, lo que significa que un cuadrado de 1x1 con un valor de texelsPerUnit de 32 ocupará aproximadamente 32x32 texels en el mapa de luces.
Esta propiedad se introdujo en Qt 6.10.
Véase también Model::texelsPerUnit.
© 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.