qt_add_lightprobe_images

Convertit les fichiers de cartes HDRI en fichiers KTX, puis les ajoute en tant que ressources Qt.

La commande est définie dans le composant « Quick3D » du paquet « Qt6 », qui peut être chargé comme suit :

find_package(Qt6 REQUIRED COMPONENTS Quick3D)

Cette commande a été introduite dans Qt 6.2.

Synopsis

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

Si les commandes sans version sont désactivées, utilisez plutôt « qt6_add_lightprobe_images() ». Elle prend en charge le même ensemble d’arguments que cette commande.

Description

Utilisez cette commande pour convertir les fichiers « .hdr » répertoriés sous « FILES » en fichiers « .ktx ». Ces fichiers seront inclus dans le binaire ou la bibliothèque « target ».

FILES doit répertorier les chemins d’accès aux fichiers de cartes HDRI locaux. Chaque fichier doit porter l’extension .hdr ou .exr. Ces fichiers seront convertis au moment de la compilation en fichiers .ktx, à l’aide de l’ outil Balsam Asset Import Tool.

Par défaut, les fichiers .ktx apparaîtront dans les ressources Qt intégrées du binaire cible sous le même nom de base et le même chemin relatif. Utilisez BASE pour supprimer un répertoire commun des chemins relatifs lors de l’exécution. Autrement dit, si tous les chemins de fichiers sous FILES pointent vers un répertoire commun maps/, vous pouvez alors utiliser BASE maps/ pour masquer ce répertoire dans le système de ressources Qt. De la même manière, vous pouvez utiliser PREFIX pour ajouter un répertoire préfixe commun dans le système de ressources Qt.

Alors que BASE et PREFIX vous permettent de modifier les chemins relatifs communs des fichiers .ktx dans le système de ressources Qt, OUTPUTS vous permet de contrôler le chemin complet des fichiers .ktx, y compris le nom du fichier. Si vous utilisez OUTPUTS, le nombre de chemins doit correspondre au nombre de chemins vers FILES.

Exemple

Le code suivant génère automatiquement la carte des sondes de lumière lors de la compilation et l’intègre à l’exécutable sous :/maps/OpenfootageNET_garage-1024.ktx:

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

Remarques

Lors de l’ajout de plusieurs ressources, l’ resource_name doit être unique parmi toutes les ressources liées à la cible finale.

Cela concerne tout particulièrement les compilations statiques. Dans ce cas, un même nom de ressource présent dans différentes bibliothèques statiques entraîne un conflit dans la cible qui les utilise.