En esta página

qt_add_lightprobe_images

Convierte archivos de mapas HDRI a archivos KTX y los añade como recursos de Qt.

Nota: Este comando se encuentra en fase de vista previa tecnológica y puede sufrir cambios en futuras versiones.

El comando está definido en el componente « Quick3D » del paquete « Qt6 », que se puede cargar de la siguiente manera:

find_package(Qt6 REQUIRED COMPONENTS Quick3D)

Este comando se introdujo en Qt 6.2.

Sinopsis

qt_add_lightprobe_images(target resource_name
                    [PREFIX prefix]
                    [BASE base]
                    FILES file1.hdr, file2.hdr ..
                    [OUTPUTS file1.ktx, file2.ktx ..]
)

Si los comandos sin versión están desactivados, utiliza en su lugar qt6_add_lightprobe_images(). Admite el mismo conjunto de argumentos que este comando.

Descripción

Utilice este comando para convertir los archivos ` .hdr ` que figuran en ` FILES ` a archivos ` .ktx `. Los archivos se incluirán en el binario o la biblioteca ` target`.

FILES debe incluir las rutas a los archivos de mapas HDRI locales. Cada archivo debe tener el sufijo « .hdr » o « .exr ». Estos archivos se convertirán en el momento de la compilación a archivos « .ktx », utilizando la herramienta Balsam Asset Import Tool.

Por defecto, los archivos .ktx aparecerán en los recursos Qt incrustados del binario de destino con el mismo nombre base y la misma ruta relativa. Utiliza BASE para eliminar un directorio común de las rutas relativas en tiempo de ejecución. Es decir, si todas las rutas de los archivos bajo FILES apuntan a un directorio común maps/, puedes utilizar BASE maps/ para ocultar dicho directorio en el sistema de recursos de Qt. Del mismo modo, puedes utilizar PREFIX para añadir un directorio prefijo común en el sistema de recursos de Qt.

Mientras que BASE y PREFIX permiten cambiar las rutas relativas comunes de los archivos .ktx en el sistema de recursos de Qt, OUTPUTS permite controlar la ruta completa de los archivos .ktx, incluido el nombre del archivo. Si se utiliza OUTPUTS, el número de rutas debe coincidir con el número de rutas a FILES.

Ejemplo

Lo siguiente genera automáticamente el mapa de sondas de luz en el momento de la compilación y lo incluye en el ejecutable en :/maps/OpenfootageNET_garage-1024.ktx:

qt_add_lightprobe_images(principledmaterial "ibl_assets"
    PREFIX
         "/"
    FILES
        "maps/OpenfootageNET_garage-1024.hdr"
)

Advertencias

Al añadir varios recursos, resource_name debe ser único en todos los recursos vinculados al objetivo final.

Esto afecta especialmente a las compilaciones estáticas. En este caso, el mismo nombre de recurso en diferentes bibliotecas estáticas entra en conflicto en el objetivo que lo consume.

Véase también «Pregeneración del mapa cúbico IBL».

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