qt_add_lightprobe_images

HDRIマップファイルをKTXファイルにベイクし、Qtリソースとして追加します。

このコマンドは、Qt6 パッケージのQuick3D コンポーネントに定義されており、次のように読み込むことができます：

find_package(Qt6 REQUIRED COMPONENTS Quick3D)

このコマンドは Qt 6.2 で導入されました。

概要

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

バージョン指定のないコマンドが無効になっている場合は、代わりに `qt6_add_lightprobe_images() ` を使用してください。このコマンドと同じ引数セットをサポートしています。

説明

このコマンドを使用して、FILES にリストされている.hdr ファイルを.ktx ファイルにベイクします。これらのファイルは、バイナリまたはライブラリのtarget 以下に含まれます。

FILES には、ローカルのHDRIマップファイルへのパスを指定してください。各ファイルの拡張子は、.hdr または.exr のいずれかでなければなりません。これらのファイルは、ビルド時にBalsam Asset Import Toolを使用して.ktx ファイルに変換されます。

デフォルトでは、.ktx ファイルは、ターゲットバイナリの埋め込みQtリソース内に、同じベース名と相対パスで表示されます。実行時に相対パスから共通ディレクトリを除外するには、BASE を使用します。つまり、FILES 配下のすべてのファイルパスが共通ディレクトリmaps/ を指している場合、BASE maps/ を使用することで、Qtリソースシステム内でそのディレクトリを非表示にすることができます。 同様に、PREFIX を使用することで、Qt リソースシステムに共通のプレフィックスディレクトリを追加できます。

BASE およびPREFIX を使用すると、Qt リソースシステム内の.ktx ファイルの共通の相対パスを変更できますが、OUTPUTS を使用すると、ファイル名を含めた.ktx ファイルのフルパスを制御できます。OUTPUTS を使用する場合、パスの数はFILES へのパスの数と一致している必要があります。

例

以下は、ビルド時にライトプローブマップを自動生成し、:/maps/OpenfootageNET_garage-1024.ktx 配下の実行ファイルに組み込む例です：

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

注意事項

複数のリソースを追加する場合、resource_name は、最終ターゲットにリンクされるすべてのリソース間で一意でなければなりません。

これは特に静的ビルドに影響します。静的ビルドでは、異なる静的ライブラリ内の同じリソース名が、それを参照するターゲット内で競合します。