Lighting

Lighting 光照服务。通过 editor:GetService("Lighting") 获取，读写场景光照属性（环境光、主光源、阴影淡化、反射贴图、天空背景）。

概览

场景光照服务，通过 editor:GetService("Lighting") 获取。属性名与运行时 LightingService 一致，直接读写属性即可调整场景光照：环境光颜色/强度、主光源颜色/强度/朝向、阴影淡化、反射立方体贴图、电影色调映射、天空背景。属性修改支持撤销/重做。颜色属性以打包整数 0xRRGGBB 读写，写入时也接受 Color3 / Color 实例（如 Color3.New(r, g, b)）。

Get by:

-- @runtime editor
local service = editor:GetService("Lighting")

函数

GetSkyBackgrounds

返回当前所有可选择的天空背景（官方预设），每项包含 id 与 name。

返回值

类型	说明
Array	每项 { id = 天空背景 ID, name = 天空背景名称 }

调用 GetSkyBackgrounds

-- @runtime editor
local lighting = editor:GetService("Lighting")
local result = lighting:GetSkyBackgrounds()  -- 返回 Array
if result ~= nil then
    for index, item in ipairs(result) do
        print(index, item)
    end
end

属性

名称	类型	默认值	说明
AmbientColor	Color3	6842472	环境光颜色。读回为打包整数 0xRRGGBB；写入接受整数或 Color3 实例（如 Color3.New(r, g, b)）。
AmbientIntensity	Float	1.0	环境光强度，取值范围 0~2。
Color	Color	14803425	主光源颜色。读回为打包整数 0xRRGGBB；写入接受整数或 Color 实例（如 Color.New(r, g, b, a)）。
Intensity	Float	2.0	主光源强度，取值范围 0~8。
Orientation	Vector3	[45, -45, 0]	主光源朝向，通过 Vector3.New(x, y, z) 构造。
FilmicTonemapEnabled	Bool	false	是否开启电影色调映射。
EnvironmentMap	String	official://cube/28	场景反射立方体贴图资源（立方体资源 id）。
ShadowFade	Float	0.0	阴影淡化程度，取值范围 0~1。
SkyBackground	Int	-1	场景天空背景。传官方预设的数字 ID；可用 GetSkyBackgrounds 获取全部可选值。