BasePostEffect

概览

字段	值
Kind	Unit · 单位 Unit
Realm	common

继承关系

• Unit（4 属性 / 25 函数 / 6 事件）
  • [BasePostEffect]（1 属性）
    • AmbientOcclusionEffect（3 属性）
    • BloomEffect（4 属性）
    • ColorGradingEffect（15 属性）
    • ComicEffect（8 属性）
    • DepthOfFieldEffect（2 属性）
    • InkWashEffect（5 属性）
    • LensRainEffect（8 属性）
    • PixelateEffect（1 属性）
    • SketchEffect（15 属性）

继承成员

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

BasePostEffect 是所有后处理特效的基类，提供统一的启用开关。它本身不可直接创建，必须通过其子类（如 BloomEffect、ColorGradingEffect 等）来使用，并挂载到 LightingService 下才能生效。

适用场景

当需要为场景添加全屏滤镜、泛光、景深等视觉效果时，通过创建具体的后处理子类实例并设置其 Enabled 属性来激活特效。

使用要点

通过 game:CreateUnit 创建具体的后处理子类实例（如 BloomEffect），然后将其 Parent 设置为 LightingService；读写 Enabled 属性控制效果开关。

注意事项

BasePostEffect 本身不可直接创建，必须使用其公开子类。实例通常需要挂载到 LightingService 下才能生效。

属性 (1)

Name	类型	默认值	说明
Enabled	Bool	true	控制后处理效果是否启用。

关联类型

• Unit