Unreal Engine 5 분석 - Proxy
언리얼 엔진 5.7 소스 코드 분석
· 1 min read
Proxy? #
UObject(정확히는 UPrimitiveComponent)에 대응되는 Render Thread의 mirroring 객체이다.
렌더링에 필요한 데이터들을 담는 객체이기 때문에 당연하게도 모든 컴포넌트가 Proxy 객체를 정의하고 있지는 않으며, 다음과 같은 객체들이 Proxy 데이터를 가지는 대표적인 객체들이다.
Component(UPrimitiveComponent의 자식 객체) | 렌더 스레드 Proxy클래스 | 설명 |
|---|---|---|
| UStaticMeshComponent | FStaticMeshSceneProxy | 정적 메쉬의 Vertex/Index Buffer 및 머티리얼 렌더링 상태 관리, LOD전환 및 배칭 처리 등 |
| USkeletalMeshComponent | FSkeletalMeshSceneProxy | 스켈레탈 애니메이션의 Bone Transform 데이터를 렌더 스레드로 전송, Skinned Mesh의 동적 Vertex 업데이트 등 |
| UInstancedStaticMeshComponent | FInstancedStaticMeshSceneProxy | 인스턴싱 처리, 인스턴스별 Transform Buffer 관리 |
| ULightComponent | FLightSceneProxy | 광원의 형태(Point, Spot, Directional 등), 색상, 감쇠 등의 라이팅 및 쉐도우 맵 렌더링 파라미터 관리 |
Proxy 생성 흐름 #
UWorld::SpawnActor()
↓
/*Called after the actor is spawned in the world.
Responsible for setting up actor for play.*/
AActor::PostSpawnInitialize()
↓
AActor::RegisterAllComponent()
↓
if (Actor::PreRegisterAllCOmponents() && HasPreRegisteredAllComponents())
than: AActor::IncrementalRegisterComponents(0)
↓
UActorComponent::RegisterComponentWithWorld()
↓
UActorComponent::ExecuteRegisterEvents()
↓
UPrimitiveComponent::CretaeRenderState_Concurrent()
↓
...
UPrimitiveComponent::CretaeRenderState_Concurrent()
↓
FScene::AddPrimitive()
↓
FScene::BatchAddPrimitivesInternal()
↓
...
FScene::BatchAddPrimitivesInternal() 에서 SceneData를 이용하는데, 이는 FPrimitiveSceneInfoData타입의 객체이다.
이 안에도 SceneProxy가 있고, UPrimitiveComponent에도 SceneProxy가 있는데, UE 5.7 기준 현재로서는 이 SceneData에 담긴 SceneProxy를 사용하는 것이 권장되며, 다음과 같이 UPrimitiveComponent::FPrimitiveSceneProxy쪽에도 주석으로 표기되어 있는 내용이다.