qt_add_lightprobe_images

Convertit les fichiers HDRI en fichiers KTX et les ajoute aux ressources de 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 qt6_add_lightprobe_images() à la place. Elle prend en charge le même ensemble d'arguments que cette commande.

Description de la commande

Utilisez la commande pour convertir les fichiers .hdr listés sous FILES en fichiers .ktx. Les fichiers seront inclus dans le binaire ou la bibliothèque target.

FILES doit énumérer les chemins d'accès aux fichiers de cartes HDRI locales. Chaque fichier doit avoir le suffixe .hdr ou .exr. Ces fichiers seront convertis au moment de la construction en fichiers .ktx, à l'aide de l'outil d'importation de ressources Balsam.

Par défaut, les fichiers .ktx apparaîtront dans les ressources Qt XML 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 au moment de l'exécution. En d'autres termes, si tous les chemins de fichiers sous FILES pointent vers un répertoire commun maps/, vous pouvez utiliser BASE maps/ pour masquer le répertoire dans le système de ressources Qt. De même, 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

L'exemple suivant génère automatiquement la carte lightprobe au moment de la compilation et l'inclut dans l'exécutable sous :/maps/OpenfootageNET_garage-1024.ktx:

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

Avertissements

Lors de l'ajout de ressources multiples, resource_name doit être unique pour toutes les ressources liées à la cible finale.

Ceci affecte particulièrement les constructions statiques. Dans ce cas, le même nom de ressource dans différentes bibliothèques statiques entre en conflit dans la cible de consommation.