qt_add_lightprobe_images

Konvertiert HDRI-Kartendateien in KTX-Dateien und fügt sie als Qt-Ressourcen hinzu.

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

find_package(Qt6 REQUIRED COMPONENTS Quick3D)

Dieser Befehl wurde in Qt 6.2 eingeführt.

Übersicht

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

Wenn versionsunabhängige Befehle deaktiviert sind, verwenden Sie stattdessen „ qt6_add_lightprobe_images() “. Dieser Befehl unterstützt dieselben Argumente wie der vorliegende Befehl.

Beschreibung

Verwenden Sie den Befehl, um die unter „ FILES “ aufgeführten „ .hdr “-Dateien in „ .ktx “-Dateien zu konvertieren. Die Dateien werden in die Binär- oder Bibliotheksdatei „ target “ eingebunden.

FILES sollte die Pfade zu lokalen HDRI-Kartendateien enthalten. Jede Datei muss entweder die Endung .hdr oder .exr haben. Diese Dateien werden zur Erstellungszeit mithilfe des Balsam Asset Import Tools in .ktx -Dateien konvertiert.

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

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

Beispiel

Der folgende Code generiert die Lightprobe-Map automatisch beim Erstellen und bindet sie unter „ :/maps/OpenfootageNET_garage-1024.ktx “ in die ausführbare Datei ein:

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

Hinweise

Beim Hinzufügen mehrerer Ressourcen muss „ resource_name “ über alle in das endgültige Ziel eingebundenen Ressourcen hinweg eindeutig sein.

Dies betrifft insbesondere statische Builds. Dort kommt es im aufrufenden Ziel zu Konflikten, wenn derselbe Ressourcenname in verschiedenen statischen Bibliotheken vorkommt.