Sky Controller System — 환경 라이팅 통합 제어 시스템

01 / OVERVIEW

시스템 개요

두 가지 문제를 하나의 시스템으로 해결

환경 라이팅을 구성하는 요소는 각각 별도의 액터다. 시간대나 분위기를 바꾸려면 Directional Light, Sky Light, Sky Atmosphere, Exponential Height Fog 네 개를 각각 열어 수동으로 조정해야 했다. 작업자마다 조정 순서와 기준이 달랐고, 협업에서 세팅을 이어받거나 공유하기 어려웠다.

문제는 두 가지였다. 하나는 분산 제어 구조 — 하나의 환경을 구성하는 요소들을 개별로 열어 조정하는 비효율. 다른 하나는 시간대 테스트의 반복 작업 — 한 요소를 바꾸면 나머지가 연쇄적으로 따라와야 하는 연동 관계를 수동으로 처리했다. 두 문제를 하나의 Blueprint 시스템으로 해결했다.

통합 액터

4개

단일 BP 인터페이스로 통합

제어 모드 조합

5가지

Auto/Adjust × Template/Custom + Manual

커브 연동 파라미터

5종

광량·색온도·SkyLight·Fog밀도·태양각도

Before / After — 분산 제어 → 단일 BP 통합

02 / BP INTEGRATION LOGIC

Blueprint 통합 구조

4개 액터 참조 방식 · 핵심 파라미터 선별 노출 · 모드 분기 구현

네 개의 환경 액터를 Blueprint 하나에서 제어하려면 각 액터를 BP 내부에서 참조할 수 있어야 한다. 참조 방식 선택이 중요했다. Get All Actors Of Class를 EventTick 내부에서 반복 호출하면 매 프레임마다 씬 전체를 탐색해 비용이 누적된다. BeginPlay에서 한 번 호출해 변수에 캐싱하는 방식도 있지만, 레벨 배치 시점에 각 액터를 BP 변수에 직접 할당하는 Direct Reference 방식은 초기 탐색 자체를 생략한다.

Sky Controller BP 내부 구조 — Actor Reference · Mode Enum · Curve 연결

제목 1	제목 2	제목 3	제목

1

Actor Direct Reference — 씬 탐색 없이 직접 할당

4개 환경 액터를 각 타입의 Object Reference 변수로 BP 내에 선언하고, 레벨 배치 시점에 Details 패널에서 직접 할당한다. Get All Actors Of Class를 EventTick 내부에서 반복 호출하면 매 프레임 씬 전체를 탐색하는 비용이 누적된다. BeginPlay에서 한 번 캐싱하는 방식도 있지만, Direct Reference는 초기 탐색 자체가 없다.

BP 변수 선언: DirectionalLightRef (Directional Light Actor Reference)
BP 변수 선언: SkyLightRef (Sky Light Actor Reference)
BP 변수 선언: SkyAtmosphereRef / HeightFogRef

환경 업데이트는 값 변경 시마다 호출된다. EventTick에서 매 프레임 Set 함수를 호출하는 방식은 탐색 비용은 없어도 불필요한 Set 호출이 초당 수십 회 발생한다. 슬라이더·변수 변경 이벤트 기반 호출을 권장한다.

2

Enum_SkyControlMode — Switch on Enum으로 모드 분기

Auto / Adjust / Manual 세 값을 가진 Enum을 BP 내에 정의하고, Switch on Enum 노드로 분기한다. 각 분기에서 다른 값 소스(커브 출력 / 커브+오프셋 / 직접 입력)를 사용해 동일한 Set 함수에 넘긴다.

Enum_SkyControlMode → Switch on Enum → [Auto|Adjust|Manual] → SetIntensity(FinalValue)

3

핵심 파라미터만 선별 노출

4개 액터가 가진 수십 개 파라미터 중 아티스트가 실제로 조정하는 핵심 파라미터만 BP Details 패널에 노출한다. 세부 설정이 필요할 때는 Manual Mode에서 직접 접근할 수 있다.

Details 노출 대상: 광량 · 색온도 · SkyLight강도 · Fog밀도 · 태양각도

디테일 패널에 수십 개가 나열되면 작업자마다 다른 파라미터를 건드린다. 선별 노출이 일관성의 시작이다.

03 / TIME OF DAY SYSTEM

커브 기반 자동화 구조

CurveFloat × 5 → 시간값 하나로 전체 환경 연동

시간대 변화 테스트에서 가장 큰 비효율은 연쇄 수정이었다. 태양 각도를 바꾸면 광량이 달라지고, 광량이 달라지면 Sky Light 강도도 조정해야 하며, Fog 색상도 따라온다. 이 연동 관계를 수동으로 처리하면 한 요소를 바꿀 때마다 나머지를 순서대로 수정해야 한다. 각 파라미터를 시간 축에 대응하는 CurveFloat로 연결하면 시간값 하나가 바뀔 때 모든 파라미터가 자동으로 갱신된다.

CurveFloat → GetFloatValue → Set* 연결 구조

각 환경 파라미터에 CurveFloat 에셋을 하나씩 연결했다. 커브 X축은 시간(0~24), Y축은 해당 파라미터 값이다. 시간 변수 하나가 바뀌면 GetFloatValue(Time)가 각 커브를 평가하고, 그 결과를 각 액터의 Set 함수에 넘긴다.

CurveFloat → GetFloatValue → Actor Set 함수 연결 구조

기본 커브(Template) 값 — Relative Exposure 기준과의 연결

시간	광량 (상대값)	색온도 (K)	SkyLight 강도	비고
0시	0	4,100	0.1	야간 — 달빛(반사된 햇빛) 기준 색온도
6시	1	3,500	0.4	일출 — 주황빛 저각도
12시	10	5,500	1.0	정오 기준점 — PBL Relative Exposure 기준값 (물리 스케일 아닌 축소값)
18시	2	3,000	0.5	일몰 — 붉은빛 저각도
24시	0	4,100	0.1	야간 순환 완료

커브 제어점 수에 대해 — 위 표는 주요 시간대 5개 키프레임을 기준값으로 요약한 것이다. 실제 CurveFloat 에셋은 일출·일몰 과도 구간, 새벽·황혼 색온도 변화 등을 자연스럽게 보간하기 위해 더 많은 제어점을 포함한다. 표의 수치는 각 시간대의 목표값이며 커브 에셋의 전체 키프레임과 1:1 대응하지 않는다.

Time of Day 시뮬레이션

슬라이더 또는 자동 재생으로 시간대 변화 확인

12:00

04 / THREE CONTROL MODES

Auto / Adjust / Manual

작업 단계에 따라 제어 수준을 선택 — 룩데브에서 최종 제작까지 순서대로 대응

하나의 모드로 초기 탐색과 정밀 제작을 동시에 해결하려 하면 어느 쪽도 제대로 충족하지 못한다. Auto → Adjust → Manual로 이어지는 흐름이 룩데브 시작부터 제작 완료까지의 작업 단계와 대응되도록 설계했다.

Mode 01 — AUTO

초기 탐색 · 시간대 확인

커브 기반으로 자동 제어. 시간값 하나만 바꾸면 모든 환경이 연동 갱신된다. 아무 설정 없이도 안정적인 기본 라이팅이 제공된다.

// BP 노드 구조
CurveFloat_Intensity → GetFloatValue(CurrentTime)
→ DirectionalLightRef → SetIntensity(ReturnValue)

Mode 02 — ADJUST

기준 유지 · 세부 조정

Auto 커브 값을 그대로 유지하면서 오프셋을 더하거나 뺀다. 기준을 손대지 않아 전체 밸런스를 유지한 채로 특정 방향으로 조정할 수 있다.

// BP 노드 구조
CurveVal = GetFloatValue(CurrentTime)
FinalVal = CurveVal + AdjustOffset (float 변수)
→ SetIntensity(FinalVal)

Mode 03 — MANUAL

정밀 제어 · 최종 세팅

커브 자동화에서 벗어나 각 파라미터를 직접 입력한다. 커브는 참조하지 않는다. Auto → Adjust로 방향을 잡은 뒤 Manual에서 마무리하는 흐름이 일반적이다.

// BP 노드 구조
ManualInputValue (float 변수, Details 노출)
→ SetIntensity(ManualInputValue)
// GetFloatValue 호출 없음

실제 워크플로 예시 — 저녁 씬 제작

1

Auto Mode — 18시로 슬라이더 이동

시간 슬라이더를 18시로 설정하면 커브에서 평가된 광량·색온도·SkyLight 강도가 자동 적용된다. 저녁 전반적인 분위기가 즉시 확인된다. 수동 조정 없음.

2

Adjust Mode — 색온도를 더 따뜻하게

Auto 커브 기준값에서 색온도 오프셋을 낮춰 더 따뜻한 분위기로 조정한다. 광량과 SkyLight는 Auto 커브 그대로 유지된다. 커브 에셋 자체는 수정하지 않는다.

ColorTemp_AdjustOffset = -500 (float 변수)

3

Manual Mode — Fog 밀도 정밀 조정

커브 기반 Fog 밀도가 씬의 특정 카메라 앵글에서 의도와 다르게 나온다. Manual에서 FogDensity를 직접 입력해 최종 세팅을 완성한다.

FogDensity_ManualInput = 0.032

Adjust Mode가 "기준을 유지"하는 구조적 이유 — Adjust Mode는 CurveFloat 에셋 자체를 수정하지 않는다. GetFloatValue로 커브 출력값을 읽고 별도 float 변수(AdjustOffset)를 더한 결과를 Set 함수에 넘길 뿐이다. 커브는 그대로이기 때문에 Auto Mode로 돌아가면 원래 커브 값이 즉시 복원된다. 오프셋은 언제든 0으로 초기화할 수 있다.

05 / TEMPLATE & CUSTOM MODE

Template / Custom — 커브 출처의 분리

Auto·Adjust와 독립적인 두 번째 선택 차원 — Manual은 커브와 무관

Auto/Adjust/Manual이 "어떻게 제어할 것인가"를 결정한다면, Template/Custom은 "어떤 커브 데이터를 기반으로 할 것인가"를 결정한다. 단, 이 두 번째 차원은 Auto와 Adjust에서만 유효하다. Manual Mode는 커브를 참조하지 않으므로 Template/Custom 선택에 관계없이 동일하게 동작한다. 실질적인 조합은 6가지가 아니라 5가지다.

조합 관계 — 실질적으로 유효한 5가지

Template Mode

Custom Mode

Auto

가장 빠른 시작. 표준 커브로 즉시 시간대 탐색 가능. 설정 불필요.

프로젝트 특화 자동화. 커스텀 커브를 만든 뒤 시간 슬라이더로 탐색.

Adjust

가장 흔한 작업 패턴. Template 기준에서 오프셋으로 방향 조정.

프로젝트 기준 + 미세 조정. Custom 커브 위에 오프셋 추가.

Manual

커브 참조 없음. Template / Custom 구분 무의미. 직접 값 입력만 사용.

← 동일 동작

Template Mode

미리 정의된 표준 커브 사용 (Auto / Adjust 전용)

설정 없이 바로 쓸 수 있다. 정오 기준 광량 10, PBL Relative Exposure 기준과 동일한 스케일. 초기 룩 탐색이나 빠른 환경 테스트에 사용한다. 커브 에셋 수정 없음. 표준 자연광 패턴(일출~정오~일몰~야간)이 기본 제공된다.

Custom Mode

프로젝트별 커브 직접 편집 (Auto / Adjust 전용)

특정 프로젝트의 분위기나 설정(예: 극지방 백야, 판타지 이중 태양)에 맞게 커브를 직접 수정한다. CurveFloat 에셋 편집으로 각 시간대의 값을 자유롭게 조정. 방향이 정해진 뒤 Template에서 Custom으로 전환하는 흐름이 일반적이다.

1

Template으로 빠른 방향 확인

Auto + Template 조합으로 시간대 슬라이더를 움직이며 전반적인 분위기를 탐색한다. 설정 시간 없이 시작 가능하다.

2

Custom으로 전환 — 프로젝트 커브 구성

방향이 정해지면 Custom Mode로 전환해 CurveFloat 에셋을 열고 해당 프로젝트에 맞는 값으로 커브를 편집한다. 이 커브가 이후 Auto/Adjust의 기준이 된다.

커브를 프로젝트 에셋으로 저장하면 팀 내 공유와 버전 관리가 가능하다. Template은 건드리지 않아 언제든 기준점으로 되돌아갈 수 있다.

3

Adjust / Manual로 씬별 미세 조정

Custom 커브를 기반으로 Adjust로 오프셋을 주거나, 커브와 무관하게 특정 파라미터를 완전히 직접 제어할 때는 Manual을 사용해 최종 세팅을 완성한다.

06 / SUMMARY

핵심 설계 결정 정리

두 가지 문제 · 두 차원의 해결 구조

설계 결정

Direct Reference — 탐색 비용 제거

4개 환경 액터를 BP 변수에 직접 할당한다. GetAllActorsOfClass를 EventTick 내부에서 반복 호출하면 매 프레임 씬 탐색 비용이 누적된다. BeginPlay 캐싱도 대안이지만, Direct Reference는 초기 탐색 자체가 없다.

CurveFloat × 5 — 연동 관계 자동화

각 파라미터에 CurveFloat를 연결해 GetFloatValue(Time)으로 평가한다. 시간 변수 하나가 바뀌면 광량·색온도·SkyLight·Fog·태양각도가 동시에 갱신된다. 수동 연쇄 수정 없음.

Adjust Mode — BaseVal + Offset 구조

커브 출력값에 AdjustOffset(float 변수)을 더한 결과를 Set 함수에 넘긴다. CurveFloat 에셋 자체를 수정하지 않아 Auto Mode로 돌아가면 원래 값이 복원된다.

Auto/Adjust/Manual — 작업 단계별 대응

초기 탐색(Auto) → 방향 조정(Adjust) → 정밀 제어(Manual)로 이어지는 흐름이 룩데브부터 제작 완료까지의 작업 단계와 대응된다. 단계마다 적합한 제어 수준이 제공된다.

Template 광량 10 — PBL 기준과 연결

Template 커브의 정오 기준값 10은 물리 스케일(100,000 Lux)이 아닌 Case 04 PBL Relative Exposure 파이프라인의 축소 기준값이다. 노출을 12.7 EV에서 1.73 EV로 재설정해 동일한 시각 결과를 유지한다.

Template / Custom — Auto·Adjust 전용 두 번째 차원

커브 출처를 선택하는 차원으로, Auto와 Adjust에서만 유효하다. Manual은 커브를 참조하지 않아 Template/Custom 구분 없이 동일하게 동작한다. 실질 조합은 5가지.

이 시스템이 만드는 핵심 변화는 "무엇을 할 것인가"와 "어떻게 할 것인가"를 분리한다는 점이다. 작업자는 어떤 시간대, 어떤 분위기를 원하는지만 결정하면 된다. 어느 액터의 어느 파라미터를 얼마나 바꿔야 하는지 계산하는 작업은 시스템이 한다. 결과적으로 다른 작업자가 세팅을 이어받아도 같은 구조 안에서 일관된 방식으로 작업할 수 있다.

Sky Controller System환경 라이팅 통합 제어 시스템

CurveFloat → GetFloatValue → Set* 연결 구조

기본 커브(Template) 값 — Relative Exposure 기준과의 연결

실제 워크플로 예시 — 저녁 씬 제작

조합 관계 — 실질적으로 유효한 5가지

Sky Controller System
환경 라이팅 통합 제어 시스템