Light QML类型

所有灯的不可创建的抽象基类型。更多...

导入语句	import QtQuick3D
继承自	Node
被以下继承	DirLight, PointLight, 以及 SpotLight

属性

Light本身是其所有子类型的不可创建的基类。子类型提供了多种选项来确定光线的样式。

有关使用示例，请参阅Qt Quick 3D - 光光源示例。

另请参阅DirLight 和 PointLight。

ambientColor : 颜色

该属性定义了在照亮此光线之前应用于材质的环境颜色。默认值为黑色，rgb(0, 0, 0)。

bakeMode : 枚举

该属性控制光线是否在烘焙光照（例如生成光照贴图时）中激活。

常量	描述
`Light.BakeModeDisabled`	光线不用于烘焙光照。
`Light.BakeModeIndirect`	为此光线烘焙间接光照贡献（用于全局光照）。直接光照（漫反射、镜面高光、实时阴影贴图）在运行时正常计算。在运行时，如果不处于烘焙模式，渲染器将尝试采样光照贴图以获取间接光照数据，并将其与实时计算的结果组合。
`Light.BakeModeAll`	针对该光源，已烘焙直接（漫反射、阴影）和间接光照。该光源不会有镜面贡献，也不会生成实时阴影贴图，但始终会具有烘焙阴影。在运行时，当不在烘焙模式时，渲染器将尝试在漫反射光照和阴影映射的标准实时计算中使用光照贴图。

默认值为Light.BakeModeDisabled

注意：与Model::usedInBakedLighting一样，设计人员和开发人员必须始终按光源分别评估光源是否适合参与烘焙光照。

警告：具有动态变化属性的光源，例如，动画位置、旋转或其他属性，不适合参与烘焙光照。

此属性在烘焙和使用光照贴图时都适用。烘焙运行和后续使用生成数据的运行之间的状态一致性至关重要。更改值为不同的值不会更改先前生成并持久存储在光照贴图中的数据，但引擎的渲染行为将遵循属性当前值。

有关如何烘焙光照贴图的更多信息，请参阅光照贴图和全局照明。

亮度 : 实数

此属性为此光源的效果定义了一个整体乘数。默认值为1。

投射阴影 : 布尔

当此属性启用时，光源将投射（实时）阴影。默认值是false。

注意：当bakeMode设置为Light.BakeModeAll时，此属性无效果。完全烘焙的光源始终具有烘焙阴影，但永远不会参与实时阴影映射。

颜色 : 颜色

此属性定义了应用于受此光源照射的模型的颜色。默认值是白色，rgb(255, 255, 255)。

作用范围 : 节点

此属性允许选择场景中的一个节点。只有该节点及其子节点受此光照影响。默认值为null，表示未选择作用范围。

注意：作用域光源无法投射实时阴影，这意味着设置了作用范围的Light不应将castsShadow设置为true。但是，当bakeMode设置为Light.BakeModeAll时，它们可以生成烘焙阴影。

阴影偏移 : 实数

此属性用于调整物体在自身投射阴影时的阴影效果。值范围为[-1.0, 1.0]。通常，[−0.1, 0.1]范围内的值就足够了。默认值为0。

阴影因子 : 实数

此属性确定投射的阴影应该有多暗。值范围为[0, 100]，其中0表示无阴影，100表示光源完全被阴影。默认值为5。

阴影滤镜 : 实数

此属性设置应用于阴影的模糊程度。默认值是5。

阴影贴图远距离 : 实数

此属性确定阴影贴图的最大距离。较小的值可以提高图的精度和效果。默认值是5000，单位是局部坐标系中的点。

阴影贴图质量 : 枚举

该属性设置用于阴影渲染创建的阴影贴图的品质。低品质使用更少的资源，但生成的阴影品质较低；而高品质则使用更多的资源，但生成的阴影品质较好。

支持的品质值有

常量	描述
`Light.ShadowMapQualityLow`	使用256x256纹理渲染阴影贴图。
`Light.ShadowMapQualityMedium`	使用512x512纹理渲染阴影贴图。
`Light.ShadowMapQualityHigh`	使用1024x1024纹理渲染阴影贴图。
`Light.ShadowMapQualityVeryHigh`	使用2048x2048纹理渲染阴影贴图。

默认值为 Light.ShadowMapQualityLow