BakedLightmap QML Type

モデルのベイクドライトマップ設定を指定します。詳細...

Import Statement: import QtQuick3D
Since: Qt 6.4

プロパティ

詳細説明

BakedLightmapオブジェクトを使用すると、次のことが可能になります:

  • ベイクされたライトマップデータを永続的に保存する - ベイク中、または
  • 以前に生成され保存されたライトマップを実行時にロードする。

usedInBakedLighting が true に設定された Model は、ライトマップをベイクする際にレイトレースされたシーンの一部とみなされます。しかし、これだけでは、バウンスされた間接照明の完全な計算を含む生成はできず、最終的にモデルのライトマップを保存します。そのためには、モデルも一意のキーセットを持つenabled BakedLightmapオブジェクトと関連付ける必要があります。

通常モードで実行する場合、同じBakedLightmapオブジェクトは、Modelがライトマップデータを持っていることを示し、エンジンがこのデータを(一意のキーに基づいて)ロードし、レンダリング時に使用することを試みる必要があることを示します。

ライトマップをベイクする方法の詳細については、Lightmapper のドキュメントを参照してください。

注意: Qt 6.4 現在、ライトマップのベイクは初期のテクニカルプレビューの状態です。機能、品質、API の変更は将来のリリースで行われる可能性があります。

LightmapperModel::usedInBakedLightingも参照して ください。

プロパティの説明

enabled : bool

false の場合、key が空でない値に設定されていても、モデルのために生成されたライトマップは、ライトマップベイク中に保存されません。

デフォルト値はtrueです。


key : string

空でなく、enabled が true の場合、モデルのために生成されたライトマップは、ライトマップベイク中に永続的に保存されます。この値は、ファイルシステム内のファイル名に含めるのに適したユニークな文字列でなければなりません。シーン内の他のModelが同じキーを使用してはいけません。

デフォルト値は空です。

loadPrefixも参照してください


loadPrefix : string

空でない場合、この値は、モデルのライトマップをロードする際に、key の値のパスとしてプリペンドされます。これにより、生成されたライトマップを、Qtリソースシステム経由の埋め込みリソースなど、書き込まれた場所とは異なる場所に出荷することができます。

例えば、次のようにすると、アプリケーションのベイクと実際の実行の間でライトマップデータを識別するための一意のキーを使用して、静的モデルのライトマップ生成が可能になります。ベイクが実行されると、生成されたファイルはアプリケーションのCMakeプロジェクトで/lightmaps PREFIXの下にリソースとしてリストされ、ビルドプロセスがファイルをピックアップして実行ファイルに含めることができます。

Model {
    source: "model.mesh"
    y: 10
    bakedLightmap: BakedLightmap {
        key: "model34156"
        loadPrefix: "qrc:/lightmaps"
        // will attempt to load from :/lightmaps/qlm_model34156.exr at run time
    }
}

デフォルト値は空です。

keyも参照してください


本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。