qt_add_lightprobe_images

Backt HDRI-Map-Dateien zu KTX-Dateien und fügt sie als Qt-Ressourcen hinzu.

Der Befehl ist in der Komponente Quick3D des Pakets Qt6 definiert, die wie folgt geladen werden kann:

find_package(Qt6 REQUIRED COMPONENTS Quick3D)

Dieser Befehl wurde in Qt 6.2 eingeführt.

Synopse

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

Wenn versionslose Befehle deaktiviert sind, verwenden Sie stattdessen qt6_add_lightprobe_images(). Es unterstützt den gleichen Satz von Argumenten wie dieser Befehl.

Beschreibung

Verwenden Sie diesen Befehl, um .hdr Dateien, die unter FILES aufgelistet sind, in .ktx Dateien umzuwandeln. Die Dateien werden in die Binärdatei oder Bibliothek target aufgenommen.

FILES sollte Pfade zu lokalen HDRI-Map-Dateien auflisten. Jede Datei muss entweder das Suffix .hdr oder .exr haben. Diese Dateien werden zur Erstellungszeit mit dem Balsam Asset Import Tool in .ktx Dateien konvertiert.

Standardmäßig werden die .ktx Dateien in den eingebetteten Qt-Ressourcen der Ziel-Binärdatei unter demselben Basisnamen und relativen Pfad angezeigt. Verwenden Sie BASE, um ein gemeinsames Verzeichnis aus den relativen Pfaden zur Laufzeit zu entfernen. Das heißt, wenn alle Dateipfade unter FILES auf ein gemeinsames Verzeichnis maps/ verweisen, dann können Sie BASE maps/ verwenden, um das Verzeichnis im Qt-Ressourcensystem zu verstecken. In ähnlicher Weise können Sie PREFIX verwenden, um ein gemeinsames Präfixverzeichnis im Qt-Ressourcensystem hinzuzufügen.

Während BASE und PREFIX es Ihnen ermöglichen, die gemeinsamen relativen Pfade der .ktx Dateien im Qt-Ressourcensystem zu ändern, können Sie mit OUTPUTS den vollständigen Pfad der .ktx Dateien kontrollieren, einschließlich des Dateinamens. Wenn Sie OUTPUTS verwenden, muss die Anzahl der Pfade mit der Anzahl der Pfade zu FILES übereinstimmen.

Beispiel

Das folgende Beispiel generiert die Lightprobe-Map zur Build-Zeit automatisch und fügt sie in die ausführbare Datei unter :/maps/OpenfootageNET_garage-1024.ktx ein:

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

Vorsichtsmaßnahmen

Wenn mehrere Ressourcen hinzugefügt werden, muss resource_name für alle Ressourcen, die mit dem endgültigen Ziel verbunden sind, eindeutig sein.

Dies betrifft insbesondere statische Builds. Dort führt der gleiche Ressourcenname in verschiedenen statischen Bibliotheken zu Konflikten im konsumierenden Ziel.