qt_add_lightprobe_images

Convierte archivos de mapas HDRI en archivos KTX, añadiéndolos como recursos Qt.

El comando está definido en el componente Quick3D del paquete Qt6, que puede cargarse así:

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, utilice qt6_add_lightprobe_images() en su lugar. Admite el mismo conjunto de argumentos que este comando.

Descripción

Utilice este comando para bakear archivos .hdr listados bajo FILES a archivos .ktx. Los archivos se incluirán en el binario o biblioteca target.

FILES debe enumerar las rutas a los archivos de mapas HDRI locales. Cada archivo debe tener el sufijo .hdr o .exr. Estos archivos se convertirán en tiempo de compilación en archivos .ktx mediante la herramienta de importación de activos de Balsam.

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. Utilice BASE para eliminar un directorio común de las rutas relativas en tiempo de ejecución. Es decir, si todas las rutas de archivos bajo FILES apuntan a un directorio común maps/, entonces puede usar BASE maps/ para ocultar el directorio en el sistema de recursos Qt. De forma similar, puedes usar PREFIX para añadir un directorio prefijo común en el sistema de recursos Qt.

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

Ejemplo

Lo siguiente autogenera el mapa lightprobe en tiempo de compilación y lo incluye en el ejecutable bajo :/maps/OpenfootageNET_garage-1024.ktx:

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

Advertencias

Cuando se añaden múltiples recursos, resource_name debe ser único para todos los recursos enlazados en el objetivo final.

Esto afecta especialmente a las compilaciones estáticas. Allí, el mismo nombre de recurso en diferentes bibliotecas estáticas entra en conflicto en el objetivo de consumo.