SimpleLight

概览

字段	值
Kind	Unit · 单位 Unit
Realm	common

继承关系

• Unit（4 属性 / 25 函数 / 6 事件）
  • [SimpleLight]（6 属性）
    • SimpleAreaLight（4 属性）
    • SimpleAreaShadowLight（3 属性）
    • SimpleLineLight（5 属性）
    • SimpleLineShadowLight（4 属性）
    • SimplePointLight（4 属性）
    • SimplePointShadowLight（3 属性）
    • SimpleSpotLight（5 属性）
    • SimpleSpotShadowLight（3 属性）

继承成员

1 个来源 / 4 属性 / 25 函数 / 6 事件

• 来自 Unit（4 属性 / 25 函数 / 6 事件）
  • 属性：AssetId、Name、Desc、Parent
  • 函数：ClearAllChildren、GetChildren、GetDescendants、IsAncestorOf、IsDescendantOf、FindFirstAncestor、FindFirstAncestorWhichIsA、FindFirstAncestorOfClass、FindFirstChild、FindFirstChildWhichIsA、FindFirstChildOfClass、HasChildren、GetChildCount、GetChildAtIndex、SetAttribute、GetAttribute、GetAllProps、Clone、IsA、Destroy、GetPropertyChangedSignal、GetAttributeChangedSignal、FindFromPath、GetFullPath、GetDebugId
  • 事件：ChildAdded、ChildRemoved、DescendantAdded、DescendantRemoving、AncestryChanged、Destroying

SimpleLight 是装饰性自发光单位的抽象基类，集中定义位置、旋转、缩放、启用状态和开关事件名等共有属性。

适用场景

用于理解 SimplePointLight、SimpleLineLight、SimpleAreaLight、SimpleSpotLight 及其暗调版本共享的基础契约。

使用要点

SimpleLight 的 creatable=false，不应直接创建；请根据外观选择一个可创建的具体 Simple*Light 子类，再设置继承属性。

注意事项

这些类型表现为自发光装饰，不保证照亮周围物体。OpenEvent 和 CloseEvent 是自定义事件名称字符串；具体视觉表现与挂载要求应在目标运行包验证。

属性 (6)

Name	类型	默认值	说明
Position	Vector3	[0.0, 0.0, 0.0]	SimpleLight 的位置属性，类型为 Vector3，表示该光源在场景中的空间坐标，可读可写。
Rotation	Quaternion	[0.0, 0.0, 0.0, 1.0]	SimpleLight 的旋转属性，类型为 Quaternion，用于描述该光源在场景中的朝向，可读可写。
Scale	Vector3	[1.0, 1.0, 1.0]	SimpleLight 的缩放属性，类型为 Vector3，用于描述该光源的缩放大小，可读可写。
Enabled	Bool	true	启用状态，控制灯光是否开启。
OpenEvent	String	""	开灯事件，用于指定当灯光开启时触发的自定义事件名称。
CloseEvent	String	""	关灯事件，用于指定当灯光关闭时触发的自定义事件名称。

关联类型

• Unit
• Quaternion
• Vector3