Qt Quick 3D - Ejemplo de mapa de luces horneado
Muestra el uso de mapas de luz «bakeados» en una escena 3D.

Este ejemplo muestra el uso de iluminación totalmente preprocesada en una escena. Como resultado, la escena renderizada tiene un aspecto mucho más realista, principalmente gracias a la iluminación indirecta añadida. Mediante una casilla de selección, también permite desactivar el mapeado de luz, lo que permite comparar los resultados de renderizado de los enfoques en tiempo real y totalmente preprocesados.
Configuración de la luz
La escena cuenta con una única luz puntual. Cuando la casilla de selección está marcada, la propiedad « bakeMode » de la luz se establece en «Light.BakeModeAll».
PointLight {
bakeMode: root.lightBakeMode
y: 190
brightness: brightnessSlider.value
castsShadow: true
shadowFactor: 75
shadowBias: 20
}Establecer la propiedad en un valor distinto de Light.BakeModeDisabled tiene una doble finalidad: en el momento del horneado del mapa de luces, indica que la luz forma parte de la escena con mapa de luces, contribuyendo a ella. En tiempo de ejecución, al renderizar la escena normalmente, indica que la luz es una luz horneada total o parcialmente, lo que lleva a desactivar ciertos cálculos en tiempo real en los materiales de los modelos con mapa de luz. Por eso, la casilla de verificación alterna both la propiedad «bakeMode» de la luz y también la propiedad «enabled» de la « BakedLightmap » asociada a los objetos «Model».
Configuración del modelo
La caja de Cornell es un modelo con 8 submallas. Está encapsulada como el tipo «Box», del que se crea una instancia en la escena principal.
Box {
usedInBakedLighting: true
bakedLightmap: BakedLightmap {
enabled: root.lmEnabled
key: "box"
}
scale: Qt.vector3d(100, 100, 100)
}Este modelo forma parte de la escena con mapa de luces y, además, tiene un mapa de luces horneado para él. Lo primero se indica mediante la propiedad « usedInBakedLighting ». Esto por sí solo no garantiza que nuestra miniescena de la caja tenga un mapa de luz horneado, sino solo que participa en el mapeado de luz (es decir, que los rayos de luz pueden rebotar en el modelo al calcular la iluminación indirecta).
Para que el mapa de luz se genere por completo y se almacene durante el proceso de horneado, también se configura un objeto ` BakedLightmap ` con la propiedad ` enabled ` establecida en ` true `. La propiedad ` key ` especifica un identificador único.
Para facilitar la implementación, la aplicación puede empaquetar los mapas de luz generados (archivo «lightmaps.bin ») en el ejecutable a través del sistema de recursos de Qt. Al volver a «hornear» el mapa de luz, es necesario volver a compilar la aplicación para que se tenga en cuenta el archivo modificado. La ruta de origen del archivo de mapas de luz se configura en « Lightmapper » mediante la propiedad « source ».
© 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.