烘焙光照贴图 QML 类型

指定模型的烘焙光照贴图设置。更多信息...

导入语句	import QtQuick3D
自从	Qt 6.4

所有成员列表，包括继承的成员

属性

enabled : bool
key : string
loadPrefix : string

详细描述

可以使用 BakedLightmap 对象来启用

Persistently storing the baked lightmap data - during baking, or
loading the previously generated and stored lightmaps - at run time.

一个将 usedInBakedLighting 设置为 true 的模型被认为是在烘焙光照贴图时射线追踪场景的一部分，这意味着模型的几何形状和材质对直接和间接光照有贡献。但是，这本身并不启用生成，包括完全计算反弹间接光照，并最终为模型保存光照贴图。为此，模型还需要与一个具有唯一键设置的 enabled BakedLightmap 对象关联。

在正常模式下运行时，同一个 BakedLightmap 对象表明模型具有光照贴图数据，并且引擎应该尝试根据唯一键加载此数据并在渲染时使用它。

有关烘焙光照贴图的更多信息，请参阅 Lightmapper 文档。

注意：截至 Qt 6.4，光照贴图烘焙处于早期技术预览状态。功能、质量和 API 的更改可能在未来的版本中发生。

另请参阅：Lightmapper 和 Model::usedInBakedLighting。

属性文档

enabled : bool

当为 false 时，即使在设置 key 为非空值时，也不会在光照贴图烘焙期间存储为模型生成的光照贴图。

默认值是 true。

key : string

当不为空并且 enabled 为 true 时，在光照贴图烘焙期间会持久存储为模型生成的光照贴图。该值应该是一个适合包含在文件系统文件名中的唯一字符串。场景中的其他任何模型都不能使用相同的键。

默认值是空。

另请参阅：loadPrefix。

loadPrefix : 字符串

当不为空时，在加载模型的光照贴图时，将此值作为路径添加到 key 的值之前。这使得可以通过Qt资源系统将其生成的光照贴图分发到不同于写入位置的不同位置，例如作为嵌入式资源。

例如，下面的代码为静态模型启用光照贴图生成，使用独特的键来识别烘焙和应用程序实际运行之间的光照贴图数据。一旦进行烘焙，生成的文件可以在应用程序的CMake项目中作为位于 /lightmaps 前缀下的资源进行列出，以便在构建过程中拾取该文件并将其包含在可执行文件中。

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。