프로젝트와 성능 설정
PlanetX의 Project Settings는 Edit > Project Settings > Plugins 아래에 있습니다. 두 설정 객체는 DefaultEngine.ini 계열 Config에 저장됩니다.
#PlanetX Runtime
RuntimeBudgetPolicy는 Bake된 Section Proxy, Transition Morph, Runtime Preview가 한 Frame과 한 streaming request에서 처리할 작업량을 정합니다. Proxy Bake Quality와는 독립적이므로 이 값을 바꿔도 Bake Asset이 다시 생성되지 않습니다.
| 정책 | 설명 |
|---|---|
Follow Engine Scalability | 기본값입니다. 현재 Unreal Scalability의 단일 Quality Level을 따릅니다. 여러 그룹이 섞여 있으면 가장 낮은 Quality Level을 보수적으로 사용합니다. |
Low | 가장 작은 Runtime streaming/realization budget을 고정합니다. |
Medium | 중간 budget을 고정합니다. |
High | PlanetX의 기본 제품 budget을 고정합니다. |
Epic | 가장 큰 bounded budget을 고정합니다. Cinematic Scalability도 Epic Profile로 해석됩니다. |
#Resolved Budget 값
| Profile | Payloads / request | Dependencies / request | Components / frame | Instances / frame | Correction vertices / frame | Transition deps / components | Time / frame |
|---|---|---|---|---|---|---|---|
| Low | 2 | 16 | 1 | 128 | 1,024 | 16 / 1 | 0.5 ms |
| Medium | 4 | 32 | 1 | 256 | 2,048 | 32 / 1 | 1.0 ms |
| High | 8 | 64 | 2 | 512 | 4,096 | 64 / 2 | 2.0 ms |
| Epic | 16 | 128 | 4 | 1,024 | 8,192 | 128 / 4 | 3.0 ms |
Engine Quality Level 0은 Low, 1은 Medium, 2는 High, 3 이상은 Epic으로 매핑됩니다.
#Actor별 Override 우선순위
다음 Override가 켜져 있으면 해당 Actor/Component가 Project Profile보다 우선합니다.
- Planet Proxy Component의
bOverrideSectionProxyRuntimeBudget - Transition Morph Component의
bOverrideTransitionRuntimeBudget - Runtime Preview Actor의
bOverrideRuntimeBudget
Override는 문제 진단이나 특정 Actor가 반드시 다른 처리량을 가져야 할 때만 사용하세요. 너무 큰 값은 Game Thread spike와 streaming burst를 만들 수 있고, 너무 작은 값은 Section이 완전히 나타날 때까지 여러 Frame이 더 필요하게 만듭니다.
#PlanetX Rendering
| 설정 | 기본값 / 범위 | 설명 |
|---|---|---|
bEnableLensFlares | true | PlanetX presentation을 위해 Unreal의 image-based Lens Flare 기능을 활성화합니다. |
LensFlareQuality | 3, 0–3 | r.LensFlareQuality에 대응합니다. 0=Off, 1=Low, 2=High, 3=Very High입니다. |
이 값은 Project Setting 우선순위로 Console Variable에 적용됩니다. 일반 Scalability 변경으로 조용히 낮아지지는 않지만, command line이나 더 높은 우선순위의 Runtime Override는 여전히 우선할 수 있습니다.
행성별 EnvironmentSettings.PostProcess.bEnableLensFlare와 LensFlareIntensity도 함께 적용됩니다. Project에서 Lens Flare가 꺼져 있으면 행성별 토글만 켜도 렌더러 기능이 활성화되지 않습니다.
#성능 조정 순서
- Project의
Follow Engine Scalability를 유지한 상태로 목표 플랫폼 Scalability에서 측정합니다. - Runtime diagnostics에서 payload, dependency, component, instance 중 어느 상한이 병목인지 확인합니다.
- 전체 프로젝트가 일관되게 더 작은/큰 budget을 필요로 할 때만 고정 Profile을 선택합니다.
- 한 Actor만 예외여야 할 때 Component Override를 사용합니다.
- Proxy 품질이나 triangle 수가 문제라면 Runtime Budget이 아니라 Proxy Bake Quality와 Source Scope를 조정하고 다시 Bake합니다.
#Config 검토
Project Settings를 바꾸면 소스 관리에 포함될 Config/DefaultEngine.ini 변경을 확인하세요. 사용자별 Saved/Config 값만 바뀌고 기본 Config에 반영되지 않으면 팀원과 패키징 빌드가 같은 값을 사용하지 않을 수 있습니다.