Lightmapper QML Type

指定场景的光贴图烘焙设置。更多

Import Statement: import QtQuick3D
Since: Qt 6.4
Inherits:

QtObject

属性

详细说明

在烘焙直接和间接光照时使用。这些设置在其他时候(如使用已生成的光贴图渲染场景时)并不相关。

注意: 截至 Qt 6.4,光贴图烘焙还处于早期技术预览状态。在未来的版本中,功能、质量和 API 很可能会发生变化。

Lightmapper 对象与

另请参阅 光贴图和全局照明以及Qt Quick 3D - 烤制光贴图示例

属性文档

adaptiveBiasEnabled : bool

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

默认值为 true。


bias : real

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

默认值为 0.005。


bounces : int

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

默认值为 3。

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


indirectLightEnabled : bool

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


indirectLightFactor : real

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

默认值为 1。


indirectLightWorkgroupSize : int

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

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


opacityThreshold : real

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

默认值为 0.5。

注: 光照贴图会将material's opacitybaseColor alpha 以及base color map's alpha 考虑在内。在光贴图烘焙过程中,其他半透明来源(如不透明度贴图或 alpha 截止设置)将被忽略。


samples : int

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

默认值为 256。

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


© 2025 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.