光映射 QML 类型

指定场景的光映射烘焙设置。更多信息...

导入语句	import QtQuick3D
自	Qt 6.4

属性

在烘焙直接和间接照明时使用。在其他时候，如使用已生成的光映射来渲染场景时，这些设置是不相关的。

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

Lightmapper 对象与以下功能协同工作

adaptiveBiasEnabled : bool

启用根据表面法线应用额外的动态偏差。

默认值为 true。

bias : float

在烘焙期间使用的光线投射偏差。如果出现伪影，则根据需要调整此值，例如，为了减少不希望的阴影模式。在许多情况下，默认值就足够了。

默认值为 0.005。

bounces : int

每个样本间接光照弹跳的最大次数。此值至少应为 1，否则无间接光照计算的必要。

默认值为 3。

该值严重影响光映射烘焙过程中生成的光映射的性能和品质。

间接光照启用 : bool

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

间接光照因子 : float

间接光照数量的乘数。虽然值为 1（即，不影响间接光照数量计算）可以提供严格正确的渲染结果，但在使用光照贴图时，通常可以提供更好的视觉效果，即使反弹次数较少。

默认值为 1。

间接光照工作组大小 : int

样本工作组的大小。这些工作组将被尝试并行执行。（确切的执行行为取决于 CPU 内核数量和 QThreadPool 的配置）

默认值为 32。在默认的样本数量为 256 的情况下，这意味着每个模型尝试并行运行 8 组。

不透明度阈值 : float

当通过光线追踪计算光照时，对象在射线-网格交集中被忽略的不透明度（alpha）阈值。当不透明度低于阈值时，模型（子网格）将不会阻挡光源，因此也不会生成阴影。

默认值为 0.5。

注意： 光贴图器将考虑材质的不透明度、基本颜色 alpha 以及基本颜色贴图 alpha 的组合。在光贴图烘焙过程中忽略其他半透明度来源，例如不透明度贴图或 alpha 截断设置。

样本 : int

每个光照贴图 texel 的样本数量。

默认值为 256。

该值严重影响光映射烘焙过程中生成的光映射的性能和品质。