このページでは

BakedLightmap QML Type

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

Import Statement: import QtQuick3D
Since: Qt 6.4
Inherits:

QtObject

プロパティ

詳細な説明

BakedLightmap オブジェクトを使用すると、以下の機能を実現できます:

  • ベイク処理中にベイク済みライトマップデータを永続的に保存する、あるいは
  • 実行時に、以前に生成・保存されたライトマップを読み込むこと。

usedInBakedLighting がtrueに設定されているモデルは、ライトマップのベイク時にレイトレーシングされたシーンの一部とみなされます。つまり、そのモデルのジオメトリとマテリアルが、直接光および間接光に寄与することになります。 ただし、これだけでは、バウンスした間接照明の完全な計算を含め、そのモデルのライトマップを生成・保存することはできません。そのためには、そのモデルを、一意のキーが設定された「enabled 」BakedLightmapオブジェクトに関連付ける必要があります。

通常モードで実行する場合、同じ BakedLightmap オブジェクトは、そのモデルにライトマップデータが存在すること、およびエンジンが(一意のキーに基づいて)このデータを読み込み、レンダリング時にそれを使用すべきであることを示します。

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

注: Qt 6.4の時点では 、ライトマップのベイク機能は初期の技術プレビュー段階にあります。今後のリリースにおいて、機能、品質、および API に変更が加えられる可能性があります。

関連項目: Lightmapper およびModel::usedInBakedLighting 。

プロパティのドキュメント

enabled : bool

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

デフォルト値は true です。

key : string

このキーが空でなく、かつenabled がtrueの場合、そのモデル用に生成されたライトマップは、ライトマップのベイク処理中に永続的に保存されます。シーン内の他のモデルでは、このキーを使用してはなりません。

デフォルト値は空です。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.