Lightmapper QML Type

启用基于表面法线的额外动态偏置。

默认值为 true。

烘焙过程中使用的光投射偏置。调整该值以防出现伪影，例如减少不希望出现的阴影模式。在很多情况下，默认值已经足够。

默认值为 0.005。

每个样本间接光反弹的最大次数。该值至少应为 1，否则没有必要计算间接光。

默认值为 3。

该值会严重影响光贴图烘焙过程中生成的光贴图的性能和质量。

该属性定义了基于非本地均值的去噪器的 sigma 值。这意味着该值越高，模糊效果就越强。请尽量降低该值，以避免在去除噪点的同时丢失视觉特征。

此属性在 Qt 6.10 中引入。

通常无需更改此值。默认值为 true。将此属性设置为 false 会在光贴图烘焙过程中禁用间接光计算。因此，生成的纹理贴图将只包含直接光线信息。在运行时，引擎将继续正常使用贴图，假定它们同时包含直接和间接光照。

间接光量的乘数。虽然 1 的值（即不影响间接光量计算）能提供严格意义上正确的渲染结果，但在使用光贴图时，即使反弹次数较少，稍高的值通常也能带来更好的效果。

默认值为 1。

样本工作组的大小。尝试并行执行这些工作组。(具体行为取决于 CPU 内核数和QThreadPool 配置）。

默认值为 32。默认样本数为 256，这意味着每个模型将尝试并行运行 8 个工作组。

不透明度（alpha）阈值，通过光线追踪计算光照时，如果物体的不透明度低于阈值，则在光线与网格交汇处会被忽略。当不透明度低于阈值时，模型（子网格）不会遮挡光线，因此也不会产生阴影。

默认值为 0.5。

每个光贴图像素的样本数。

默认值为 256。

该值会严重影响光贴图烘焙过程中生成的光贴图的性能和质量。

运行时加载光贴图文件的网址，以及烘焙成功后的输出文件路径。

烘焙时，输出路径将从 url 中推导出来，需要解析到一个可写的常规文件位置。默认情况下，该值为file:lightmaps.bin ，这意味着文件将放在当前工作目录下，最终结果将在成功烘焙后立即显示。

在输出文件的同一目录下，会创建一个.raw 文件，其中包含在创建最终光绘文件前使用的额外光绘数据。这样，如果.raw 文件存在，就可以只进行去噪处理，而无需在运行之间对整个场景进行烘焙。

如果要以 QRC 资源的形式读取光图，则需要以常规方式嵌入光图，并在 url 中添加:/ 或qrc:/ 前缀。下面的示例总是尝试加载通过资源嵌入的灯光贴图文件。首先将值设置为可写位置并烘焙。然后将生成的文件复制到源代码目录中。然后在应用程序的 CMake 项目中将该文件列为/lightmaps PREFIX 下的资源，让构建过程获取该文件并将其包含在可执行文件中。

Lightmapper {
    source: "qrc:/lightmaps/lightmaps.bin"
    // will attempt to load from :/lightmaps/lightmaps.bin at runtime
    // and write a file to lightmaps/lightmaps.bin when baking.
}

该属性在 Qt 6.10 中引入。

该属性定义了单位到色标的比例，这意味着1x1 quad（texelsPerUnit 为32 ）将在光贴图中占用大约32x32 色标。

该属性在 Qt 6.10 中引入。

另请参阅 Model::texelsPerUnit 。