ColorGradingEffect

概览

字段	值
Kind	Unit · 单位 Unit
Realm	common

继承关系

• Unit（4 属性 / 25 函数 / 6 事件）
  • BasePostEffect（1 属性）
    • [ColorGradingEffect]（15 属性）

继承成员

2 个来源 / 5 属性 / 25 函数 / 6 事件

• 来自 BasePostEffect（1 属性）
  • 属性：Enabled
• 来自 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

色彩分级效果是一种后处理特效，用于调整场景的整体色彩风格。它支持预设滤镜、基础调色（色相、明度、饱和度、对比度）以及分区域染色（阴影、中间调、高光），可快速改变画面氛围。

适用场景

在需要统一场景视觉风格时使用，例如为恐怖地图添加冷色调滤镜，或为梦幻主题增强饱和度与暖色染色。

使用要点

通过 game:CreateUnit("ColorGradingEffect", { Enabled = true }) 创建实例，将 Parent 设置为 LightingService，再读写 Filter、Hue、Saturation 等属性。

注意事项

实例必须挂载到 LightingService 下才能参与后处理；Filter 使用 Enums.ColorGradingFilter 命名成员。

代码示例

创建色彩分级并设置滤镜

-- @runtime client
local Lighting = game:GetService('LightingService')
local grading = game:CreateUnit('ColorGradingEffect', {
    Enabled = true,
    Filter = Enums.ColorGradingFilter.RedNegative,
    FilterStrength = 0.5,
    Saturation = 0.8,
    Contrast = 1.2,
})
grading.Parent = Lighting

grading.Enabled = true
print('色彩分级已启用:', grading.Filter)

属性 (15)

Name	类型	默认值	说明
Filter	ColorGradingFilter	Enums.ColorGradingFilter.None	选择预设的 LUT 滤镜效果。
FilterStrength	Float	1.0	控制滤镜效果的强度。
Hue	Float	0.0	调整画面的色相偏移。
Brightness	Float	1.0	调整画面的整体明度。
Saturation	Float	1.0	调整画面的饱和度。
Contrast	Float	1.0	调整画面的对比度。
ToningStrength	Float	0.0	控制整体染色效果的强度。
ShadowsColor	Color	Color.New(0, 0, 0, 255)	阴影区域的颜色调整，用于为画面暗部叠加指定色调。
ShadowsStrength	Float	1.0	控制阴影区域染色的强度。
MidtonesColor	Color	Color.New(0, 0, 0, 255)	中间调区域的颜色调整，用于为画面中间亮度部分叠加指定色调。
MidtonesStrength	Float	1.0	控制中间调区域染色的强度。
HighlightsColor	Color	Color.New(0, 0, 0, 255)	高光区域的颜色调整，用于为画面亮部叠加指定色调。
HighlightsStrength	Float	1.0	控制高光区域染色的强度。
Temperature	Float	0.0	调整画面的色温。
Tint	Float	0.0	调整画面的色调偏移。

关联类型

• BasePostEffect
• Color
• ColorGradingFilter