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 でなければなりません。これらのファイルは、バルサムアセットインポートツールを使用して、ビルド時に.ktx ファイルに変換されます。

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

BASE とPREFIX を使用すると、Qt リソースシステム内の.ktx ファイルの共通相対パスを変更できますが、OUTPUTS を使用すると、ファイル名を含む.ktx ファイルのフルパスを制御できます。OUTPUTS を使用する場合、パスの数はFILES のパスの数と一致しなければなりません。

例

以下は、ビルド時に lightprobe マップを自動生成し、実行ファイルに:/maps/OpenfootageNET_garage-1024.ktx の下に含めます：

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

注意事項

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

これは特に静的ビルドに影響します。そこでは、異なるスタティック・ライブラリの同じリソース名が、消費ターゲットで衝突します。