En esta página

Qt Quick 3D - Ejemplo de mapa de luces horneado

Muestra el uso de mapas de luz «bakeados» en una escena 3D.

Caja de Cornell con dos cajas y una luz de techo que muestra la iluminación mediante un mapa de luces horneado

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

Proyecto de ejemplo en code.qt.io

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