# Lighting

Lighting : `Instance`

## Overview

게임 내 전체 조명 효과를 관리하는 시스템으로, 조명 설정을 통해 게임의 분위기를 정교하게 연출할 수 있습니다.

Atmosphere와 함께 사용하면 안개, 색상 조절 등 사실적인 대기 효과를 구현할 수 있습니다.

## Properties

### AmbientSkyBrightness

`number`

낮과 밤 전역의 주변광 밝기를 설정합니다.

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.AmbientSkyBrightness = 7
```

### AmbientSkyColor

`Color3`

낮과 밤 전역의 하늘색을 지정합니다.

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.AmbientSkyColor = Color3.fromRGB(255, 0, 0)
```

### AutoTimeCycle

`number`

낮과 밤의 주기를 자동으로 순환시키는 기능입니다.

활성화하면 Time Flow Speed에 따라 시간이 자연스럽게 변화합니다. 단, 시간 흐름은 런타임 환경에서만 적용됩니다.

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.AutoTimeCycle = true
```

### ClockTime

`number`

시간 설정을 통한 낮/밤 표현이 가능하며, 시간에 따라 전역 조명의 방향과 밝기가 조정됩니다.

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.ClockTime = 20
```

### Contrast

`number`

하늘의 명암 대비를 조정하여 구름, 대기층, 색상의 깊이감을 높이고 시각적인 몰입도를 강화합니다.

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.Contrast = 1.6
```

### GroundReflectionColor

`Color3`

지면에서 반사되는 빛의 색상을 조정합니다.

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.GroundReflectionColor = Color3.fromRGB(255, 0, 0)
```

### MoonBrightness

`number`

달빛의 밝기를 조정합니다.

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.MoonBrightness = 0.5
```

### MoonCastShadow

`bool`

달빛에 의해 그림자가 생성될지 여부를 설정합니다.

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.MoonCastShadow = false
```

### MoonLightColor

`Color3`

달빛의 색상을 지정합니다. 밤 시간대의 자연광 색감을 구현할 수 있습니다.

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.MoonLightColor = Color3.fromRGB(255, 0, 0)
```

### MoonMaterialColor

`Color3`

달의 표면 색상과 구름 색상을 설정합니다.

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.MoonMaterialColor = Color3.fromRGB(255, 0, 0)
```

### MoonMaxHeight

`number`

달이 도달할 수 있는 최대 고도를 설정합니다.

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.MoonMaxHeight = -60
```

### MoonPathAngle

`number`

달이 이동하는 경로의 각도를 설정합니다. 달의 궤도 변화나 위치를 표현할 때 사용됩니다.

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.MoonPathAngle = 120
```

### MoonPhase

`number`

달의 위상(보름달, 반달, 초승달 등)을 조정하여 달의 형태를 변경합니다.

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.MoonPhase = 7.5
```

### NightBrightness

`number`

야간 시간대의 전체 조명 밝기를 설정합니다. 어두운 분위기나 달빛 효과 연출 시 사용됩니다.

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.NightBrightness = 1.6
```

### RealTimeDayDuration

`number`

현재 설정된 Time Flow Speed에 따른 실제 낮/밤 주기 지속 시간입니다. *(읽기 전용, 예: 20 m / 00 s)*

#### Code Samples

### Saturation

`number`

전역 색상의 채도 수준을 조정합니다. 낮은 값일수록 흐릿하고 높은 값일수록 선명한 색감을 제공합니다.

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.Saturation = 0.2
```

### ShadowDetailLevel

`Enum.ShadowDetailLevel`

씬에 렌더링되는 그림자의 전체 디테일 수준을 설정합니다. 값이 높을수록 더 정교한 그림자를 표현할 수 있지만, 환경에 따라 성능 비용이 증가할 수 있습니다.

#### Code Samples

### SkyColorInfluence

`number`

안개가 하늘 색상을 얼마나 반영할지를 조절합니다.

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Atmosphere.SkyColorInfluence = 0.8
```

### StarsBrightness

`number`

별의 밝기를 설정합니다. 밤하늘의 별이 얼마나 잘 보이는지를 결정합니다.

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.StarsBrightness = 2
```

### StarsColor

`Color3`

별빛의 색상을 지정합니다.

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.StarsColor = Color3.fromRGB(255, 0, 0)
```

### SunBrightness

`number`

태양광의 밝기를 설정합니다. 값이 높을수록 더 강한 일광 효과를 냅니다.

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.SunBrightness = 10
```

### SunCastShadow

`number`

태양광이 그림자를 생성할지 여부를 설정합니다.

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.SunCastShadow = false
```

### SunLightColor

`Color3`

태양광의 색상을 지정합니다. 낮 시간대의 자연광 색감을 구현할 수 있습니다.

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.SunLightColor = Color3.fromRGB(255, 0, 0)
```

### SunMaxHeight

`number`

태양이 도달할 수 있는 최대 높이(고도)를 설정합니다.

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.SunMaxHeight = 100
```

### SunPathAngle

`number`

태양이 이동하는 경로의 각도를 설정합니다. 계절별 태양 고도나 일조 방향 표현에 사용됩니다.

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.SunPathAngle = 120
```

### TimeFlowSpeed

`number`

낮/밤 주기의 진행 속도를 설정합니다. 값이 높을수록 시간 변화가 짧은 주기로 반복됩니다.

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.TimeFlowSpeed = 500
```

## Methods

## Events

## See also

{% content-ref url="../../../manual/studio-manual/object/lighting" %}
[lighting](https://docs.overdare.com/korean/manual/studio-manual/object/lighting)
{% endcontent-ref %}