En esta página

Mapas de luz e iluminación global

Introducción

Nota: A partir de Qt 6.4, el horneado 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.

Los mapas de luz horneados permiten generar previamente la iluminación directa procedente de luces como DirectionalLight, PointLight y SpotLight, incluidas las sombras proyectadas por las luces. En tiempo de ejecución, en lugar de realizar los cálculos correspondientes en el sombreador de fragmentos y, en el caso de las sombras, generar los mapas de sombras —que pueden resultar costosos— en tiempo real, se muestrea el mapa de imagen pregenerado.

Se genera un mapa de luz por cada Model. Aunque un Model tenga varias submallas y, por lo tanto, esté asociado a varios materiales, se generará un único mapa de luz para todo el modelo.

Los mapas de luz se generan mediante trazado de rayos, lo que por naturaleza proporciona una oclusión adecuada («la luz no atraviesa las paredes») y, posiblemente, sombras más realistas que las técnicas en tiempo real para la iluminación y el mapeado de sombras.

Y lo que es más importante, los mapas de luz también permiten «hornear» la iluminación indirecta, lo que ofrece una solución para la iluminación global. Esto tiene en cuenta los rayos de luz reflejados desde otras superficies de la escena.

A continuación se muestra un ejemplo sencillo. La escena contiene cuatro modelos «Rectangle» y un modelo «Sphere», con un « DirectionalLight » orientado hacia abajo y un « PointLight ». Los modelos «Rectangle» están girados 0 y 90 grados, lo que exagera las limitaciones de los cálculos de iluminación en tiempo real, ya que todos ellos son paralelos o perpendiculares a la dirección del « DirectionalLight ».

En la segunda imagen, la escena se ha renderizado con el mapeado de luces activado, tras haber horneado los mapas de luces para los cinco modelos. Ambas luces están configuradas como «totalmente horneadas», lo que significa que se ha horneado tanto la iluminación directa como la indirecta. La iluminación indirecta utiliza 256 « samples » y un máximo de 3 « bounces ». A continuación, se eliminó el ruido de los mapas de luz resultantes. Esto proporciona una imagen significativamente más realista.

Iluminación en tiempo real

Escena sencilla con una esfera, rectángulos y dos luces

Iluminación totalmente horneada

La misma escena con ambas luces configuradas en «fully baked»

A continuación se muestra un fragmento de código que ilustra cómo se obtuvieron los resultados con mapas de luz. La diferencia radica en las propiedades « usedInBakedLighting », « bakeMode » y « bakedLightmap ». Para este ejemplo, se ha reducido el tamaño del mapa de luz mediante la propiedad « texelsPerUnit », con el fin de ahorrar espacio en disco y reducir los tiempos de carga de la aplicación.

DirectionalLight {
    bakeMode: Light.BakeModeAll

    eulerRotation.x: -90
    brightness: 0.5
    castsShadow: true
    shadowFactor: 75
}
PointLight {
    bakeMode: Light.BakeModeAll

    y: 200
    z: 100
    color: "#d9c62b"
    castsShadow: true
    shadowFactor: 75
}
Model {
    usedInBakedLighting: true
    bakedLightmap: BakedLightmap {
        enabled: true
        key: "sphere1"
    }

    source: "#Sphere"
    materials: PrincipledMaterial { }
    y: 100
}
Model {
    usedInBakedLighting: true
    bakedLightmap: BakedLightmap {
        enabled: true
        key: "rect1"
    }

    source: "#Rectangle"
    materials: PrincipledMaterial { }
    eulerRotation.x: -90
    scale: Qt.vector3d(10, 10, 10)
}

// ... three additional Rectangle models, with rotations 0, 90, and -90

En el ejemplo anterior se utilizaron luces totalmente preprocesadas. También se puede configurar una luz para que utilice la iluminación precalculada únicamente para la iluminación indirecta, mientras se realiza la iluminación directa y el mapeado de sombras en tiempo real. En la escena siguiente hay 5 luces puntuales, todas ellas configuradas en « BakeModeIndirect » (Iluminación precalculada) para la segunda captura de pantalla. Aunque la iluminación directa y las sombras parecen idénticas, la segunda imagen tiene un aspecto significativamente mejor debido al grado de iluminación global añadido.

Iluminación en tiempo real

Escena con los modelos Sponza y Suzanne y 5 puntos de luz

Con iluminación indirecta precalculada añadida

La misma escena con iluminación indirecta precalculada y iluminación directa en tiempo real

Consideraciones importantes al trabajar con mapas de luz

Las luces que contribuyen a la iluminación precalculada tienen su propiedad « bakeMode » configurada como « Light.BakeModeIndirect » o « Light.BakeModeAll ». Esta última indica que tanto la contribución directa como la indirecta de esa luz en concreto provienen del mapa de luces. La contribución directa siempre incluye también las sombras. Por otro lado, si la intención con el mapa de luz es únicamente añadir iluminación indirecta a la escena para una luz concreta, sin dejar de calcular la iluminación directa (y realizar el mapeado de sombras) en tiempo real, entonces la luz debería utilizar « Light.BakeModeIndirect » en su lugar.

Nota: Los mapas de luz son, en términos generales, adecuados para modelos que son estáticos en cuanto a transformación, geometría y materiales. Lo mismo se aplica a las luces que participan en la iluminación preprocesada.

Por ejemplo, una escena en la que se hace girar un « Model » animando la propiedad « eulerRotation » dará resultados visualmente incorrectos al aplicar un mapa de luz a ese « Model ». Los resultados de renderizado para ese « Model » concreto serán incorrectos, ya que el mapa de luz pregenerado solo captura un único estado de rotación del objeto. Lo mismo ocurriría, por poner otro ejemplo, si el material de una de las submallas del modelo cambiara dinámicamente su propiedad baseColor en función del tiempo (animación) o de alguna interacción del usuario. El mapa de luces solo puede capturar un material determinado baseColor. Lo mismo ocurre con las luces. Por ejemplo, una luz DirectionalLight que gira, cambia de brillo, de color, etc., con el paso del tiempo, no es adecuada para la iluminación horneada.

Nota: Por otra parte, la decisión de cuándo utilizar el mapeado de luces siempre recae en el diseñador. Especialmente con las luces BakeModeIndirect, es probable que haya escenas en las que los resultados sigan siendo visualmente satisfactorios, aunque algunos de los objetos de la escena con mapa de luces presenten un comportamiento dinámico.

El mapeado de luz es una característica compleja del motor y de las herramientas. Sustituye y reimplementa varias partes del proceso de renderizado del motor. Funciona con un modelo de renderizado fundamentalmente diferente al hornear los mapas de luz, al tiempo que sigue utilizando e interactuando con la misma estructura de escena, los datos de los activos y las estructuras de datos del motor. Los resultados basados en el trazado de rayos suelen superar a las alternativas en tiempo real, a veces de forma significativa, lo que conlleva ciertas limitaciones, como la obligatoriedad de que los modelos y las luces implicados sean estáticos y, en ocasiones, problemas de calidad y artefactos de renderizado específicos del mapeo de luz.

En la práctica, será una elección artística de los diseñadores qué tipo de iluminación utilizar y cuándo. Las tres configuraciones de « bakeMode » tienen sus usos, y las escenas complejas y de mayor tamaño pueden muy bien utilizar las tres para diferentes luces, dependiendo de lo que se considere adecuado para una sección determinada de la escena, y del tipo de modelos, materiales y comportamiento dinámico que haya presente. El mapeado de luces no es un simple interruptor de tipo «encendido/apagado» que se pueda activar para cualquier escena y aplicación, sino una potente función que requiere una evaluación cuidadosa de las necesidades de iluminación de una escena determinada y que, a menudo, exige que el contenido y el comportamiento de la escena se diseñen en consecuencia, junto con un ciclo de prueba y ajuste en el que se exploran y prueban diferentes configuraciones de horneado y calidad de los mapas de luz antes de decidir el enfoque definitivo y los ajustes correspondientes.

Nota: Los mapas de luz no admiten superficies de doble cara. Con la iluminación en tiempo real, un material con una « cull mode » (orientación de la superficie) de « Material.NoCulling » invierte automáticamente la normal según corresponda, en función de la orientación del fragmento. Esto no es una opción para los mapas de luz, ya que el horneado de mapas de luz no opera en el espacio de vista. Por lo tanto, evita la iluminación horneada para modelos que dependan de esto.

Horneado de mapas de luz

Propiedades y tipos relevantes para el horneado de mapas de luz, es decir, el proceso fuera de línea de generar los mapas de imagen que capturan la iluminación directa e indirecta y que el renderizador puede utilizar en ejecuciones posteriores de la aplicación:

A partir de Qt 6.4, el proceso de «baking» de los mapas de luz debe iniciarse manualmente. Siempre que esté presente el argumento de línea de comandos --bake-lightmaps, o la variable de entorno QT_QUICK3D_BAKE_LIGHTMAPS esté establecida en 1 (u otro valor distinto de cero), el motor funcionará en modo «baking» y cerrará la aplicación una vez que haya finalizado el proceso. Los pasos del proceso de horneado pueden seguirse consultando los mensajes que aparecen en la salida de depuración. El resultado es un archivo binario (lightmaps.bin por defecto) que se guarda en el directorio de trabajo actual y que contiene todos los mapas de luz horneados de la escena. También se creará un archivo « .raw » que contiene el mapa de luces completo y algunos datos adicionales necesarios para la eliminación de ruido. Cada mapa de luces se identifica de forma única en el archivo mediante la clave única de BakedLightmap::key.

La preparación de una escena con mapas de luz consta de los siguientes pasos principales:

  • Identificar qué modelos deben utilizar un mapa de luz y cuáles deben contribuir a dicho mapa. Los modelos que formen parte de la escena con mapa de luz deben establecer Model::usedInBakedLighting en «true». Los modelos a los que se les aplicará un mapa de luz (es decir, para los que se va a «hornear» un mapa de luz) deben, además, establecer ` Model::bakedLightmap ` en un objeto ` BakedLightmap ` habilitado, que proporcione una clave única que identifique de forma persistente la instancia concreta del objeto `Model` (esto se debe a que Qt necesita una clave para identificar los datos del modelo en el almacenamiento persistente en disco). Solo se garantiza que los modelos con geometría, transformación y materiales estáticos obtengan resultados correctos al generarse el mapa de luces en tiempo de ejecución. Por lo general, cualquier elemento que provoque una transformación del mundo no estática a lo largo del tiempo —como una posición, rotación o escala modificada dinámicamente o animada— impedirá que el modelo participe en el proceso. No obstante, las necesidades artísticas pueden prevalecer sobre esto, especialmente en el caso de modelos que solo contribuyen a la iluminación indirecta precalculada, pero que no se someten ellos mismos a la aplicación de mapas de luz. En estos casos, a menudo puede resultar visualmente aceptable que haya transformaciones dinámicas, aunque esto siempre depende del modelo y de la escena en cuestión.
  • Identifica qué luces deben contribuir y en qué medida. « Light::bakeMode » ofrece tres opciones:
    • Light.BakeModeDisabled, el valor predeterminado, que hace que la luz se ignore a efectos del mapeado de luces.
    • Light.BakeModeIndirect suele ser la opción «segura» si el único objetivo es conseguir un nivel de iluminación global (iluminación indirecta) en la escena, sin que ello afecte de otro modo a los resultados del renderizado de la luz. En este modo, el renderizador seguirá realizando toda la iluminación —incluidas las contribuciones difusa, especular, del cielo y del entorno, así como el mapeado de sombras— para esta luz utilizando las técnicas estándar en tiempo real. Sin embargo, la luz contribuirá a la iluminación indirecta utilizando los datos pre-bake, lo que podría dar lugar a la iluminación de superficies que, de otro modo, no se verían afectadas por los cálculos estándar de iluminación en tiempo real.
    • Light.BakeModeAll es una opción que probablemente se utilizará solo para determinadas luces, en función de la evaluación de los diseñadores sobre lo que se considere adecuado para una escena concreta. En este modo, toda la contribución de la luz se hornea, incluidas las sombras. A partir de Qt 6.4, la iluminación especular no es compatible como parte de la iluminación precalculada, por lo que dichas luces no tendrán contribuciones especulares. Por otro lado, generarán sombras horneadas mediante trazado de rayos y tendrán una oclusión adecuada para la luz (no «atravesarán las paredes», por ejemplo), ya que aquí todas las contribuciones de iluminación directa resultantes de la luz se trazan mediante trazado de rayos en el momento de hornear el mapa de luz, en lugar de calcularse en tiempo de ejecución. Además, la iluminación indirecta se hornea, al igual que con «BakeModeIndirect».
  • Ejecutar la escena (aplicación) en modo de horneado, asegurándose de que los mapas de luz se generen correctamente. A partir de Qt 6.4, se espera que las aplicaciones estén estructuradas de tal forma que la escena con mapa de luz sea la primera vista que se muestre, o que la escena en cuestión se pueda cargar con un visor QML como la herramienta qml. Una vez finalizado el horneado —cuyo progreso se puede seguir en la salida de la consola o de depuración—, la aplicación se cierra.
  • Ejecuta la escena (aplicación) con normalidad para ver cómo se ve con los mapas de luz cargados. A continuación, puede comenzar el ajuste:
    • Para algunos modelos, tendrá sentido reducir el valor predeterminado de « texelsPerUnit » a uno más pequeño. Esto se aplica especialmente a las primitivas integradas y a cualquier elemento con una geometría lo suficientemente simple. De este modo se obtienen mapas de luz más pequeños y tiempos de «bake» más rápidos. Al realizar el «bake» por primera vez, el valor predeterminado debería ser suficiente; el valor se puede ajustar posteriormente.
    • El objeto Lightmapper ofrece numerosos ajustes con valores predeterminados razonables, pero no es raro que algunos de ellos deban ajustarse para que se ajusten a las expectativas de los diseñadores. Por ejemplo, « samples » y « bounces » pueden modificarse para influir en la calidad de la iluminación indirecta, mientras que « indirectLightFactor » permite que la contribución indirecta sea más destacada. Si aparecen artefactos, especialmente alrededor de las sombras, se puede ajustar « bias ».
    • Es esencial eliminar el ruido de los mapas de luz generados. La iluminación indirecta se calcula mediante el trazado de trayectorias, lo que produce imágenes con ruido en función del número de « samples » utilizados. Aumentar el número de muestras reduce el ruido, pero aumenta el tiempo necesario para generar el mapa de luz. Independientemente del número de muestras, casi siempre tendrá sentido aplicar un filtro de eliminación de ruido a los mapas de luz generados, que son imágenes RGBA de 32 bits en coma flotante almacenadas en un archivo binario.

A partir de Qt 6.5, se ofrece una solución en tiempo de ejecución de forma interactiva a través de la herramienta « DebugView ». En el menú «Herramientas» hay ahora un botón que, al pulsarlo, inicia el proceso de «baking». Aparecerá una ventana que muestra el proceso en curso. Para cancelar el proceso, basta con pulsar el botón «Cancelar» o cerrar esta ventana. Una vez finalizado, se guardará el archivo binario del mapa de luces en el directorio actual.

Eliminación de ruido

A continuación se muestra un ejemplo de una escena con la caja de Cornell, renderizada primero utilizando el mapa de luces horneado con 256 « samples » y un máximo de 3 « bounces ». En el segundo ejemplo, se ha eliminado el ruido del archivo de imagen generado, y los resultados se ven significativamente mejor, ya que el ruido ha desaparecido casi por completo.

Original

Escena de la caja de Cornell con un punto de luz, mapa de luces totalmente calculado

Sin ruido

Escena de la caja de Cornell con los mapas de luz sin ruido

La eliminación de ruido se realiza automáticamente en todos los mapas de luz horneados. Es posible aplicar únicamente la eliminación de ruido, si existe un archivo de mapa de luz horneado .raw en el directorio de trabajo, haciendo clic en el botón Denoise en el DebugView. También es posible eliminar el ruido ejecutando la aplicación con el argumento --denoise-lightmaps. Para ajustar la intensidad de la eliminación de ruido, se puede utilizar la propiedad denoiseSigma.

Coordenadas UV de los mapas de luz

Las coordenadas UV de los mapas de luz no utilizan los mismos datos UV que el texturizado habitual. Al renderizar con mapas de luz, el renderizador no utiliza ni los datos UV0 ni los UV1 al muestrear el mapa de luz. En su lugar, existe un canal UV adicional y específico en la malla, que contiene diagramas UV dispuestos de una manera adecuada para los fines del mapeado de luz. Esto implica evitar solapamientos e incluir relleno donde sea necesario. En el caso de los datos UV normales no existen tales requisitos, y es muy posible que se desee utilizar las mismas coordenadas U y V para más de un vértice.

El proceso de generar un conjunto de coordenadas UV adecuado se denomina «desenrollado UV para mapas de luz». Qt llevará a cabo este proceso al hornear los mapas de luz y almacenará la malla resultante en el archivo de mapas de luz, de modo que siempre se cargue y utilice una malla compatible para el mapa de luz generado. Esto significa que, si un modelo va a utilizar siempre iluminación horneada, no es necesario incluir el archivo de malla original con la aplicación.

Tamaño de la textura del mapa de luz

Para cada modelo, incluidas todas sus submallas, el proceso de «baking» de mapas de luz determinará un tamaño adecuado para la textura del mapa de luz durante la fase de generación de coordenadas UV del mapa de luz. Esto influye en la calidad, el rendimiento y el uso de recursos (tanto en disco como en memoria).

El valor por defecto suele ser adecuado y no requiere ajustes, especialmente para modelos de complejidad media a alta.

Sin embargo, en el caso de modelos muy sencillos, puede ser conveniente reducir manualmente el tamaño, ya que un mapa de luz más pequeño podría seguir ofreciendo resultados visualmente atractivos, al tiempo que la reducción del tamaño de los recursos (imagen del mapa de luz) ahorra tanto espacio en disco como memoria. Para ello, establece el valor de « texelsPerUnit » en un número adecuadamente pequeño. El ancho y la altura reales del mapa de luces intentarán entonces, en función del tamaño y la geometría del modelo, aproximarse a la densidad de texeles para que coincida con texelsPerUnit.

Al cambiar el valor, siempre se deben volver a generar los mapas de luz e inspeccionar visualmente los resultados para evaluar los efectos del cambio en el tamaño del mapa de luz.

Uso de mapas de luz en tiempo de ejecución

Propiedades y tipos relevantes al utilizar los mapas de luz pre-generados en tiempo de ejecución:

Una vez que el proceso de pre-baking se haya completado con éxito, al ejecutar la aplicación de forma normal (sin el argumento de línea de comandos ni la variable de entorno establecidas) se utilizarán las imágenes de mapa de luz generadas y se renderizarán correctamente, lo cual no es posible hasta que los mapas de luz se hayan pre-baked previamente. Si se desea, la aplicación puede colocarlos en una ubicación diferente o incluirlos como parte del ejecutable a través del sistema de recursos de Qt. Esto se habilita mediante la propiedad source.

Tomando como ejemplo el código anterior con la esfera y los cuatro rectángulos, el proceso de horneado genera un archivo « lightmaps.bin » que contiene todas las mallas y mapas de luz horneados. La aplicación debe incluir este archivo, de modo que el motor pueda encontrarlo, en la ubicación especificada por « source ».

Véase también Qt Quick 3D - Ejemplo de mapa de luces horneado y Qt Quick 3D - Ejemplo de mapa de luces SSGI.

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