Structure

Mark as Draft

정의

Unreal Engine 내부에서 서로 다른 Type의 데이터를 하나의 논리적인 단위로 묶어 관리하고 Memory 접근 효율을 극대화하기 위해 사용하는 사용자 정의 Data Type이다.

C++ struct 문법을 바탕으로 Epic Games가 엔진 고유의 Reflection System과 연동되도록 설계했다.

Class인 UObject와 달리 Garbage Collection의 추적을 받지 않고 주로 Stack Memory에 할당되는 Value Type으로 작동하여 생성과 소멸에 따르는 Overhead가 극도로 적다.

USTRUCT 매크로를 선언하여 C++의 Data 형태를 가상 머신에 등록하고 Blueprint Editor에서 시각적으로 접근하고 수정할 수 있게 만든다.

Reference 형태로 Memory 주소를 가리키는 Class와 달리 변수 선언 시 Data 자체를 복사하여 넘겨주는 방식을 채택하여 Memory 파편화를 방지한다.

Serialization 기능을 기본 지원하여 내부 Data를 Byte 배열로 변환한 뒤 Hard Disk에 저장하거나 Server로 송출하는 가벼운 통신 규격으로 작동한다.

Excel이나 CSV 파일의 Column 항목들을 엔진으로 가져올 때 각 Column의 Type을 1대1로 매칭 시키는 기준 Row 표맷 역할을 완벽히 수행한다.


struct FAudioData
{
	GENERATED_BODY()
	UPROPERTY()
	float Volume;
};

Metasound나 Wwise에 전달할 수십 개의 변수를 낱개로 연결하면 코드가 엉킨다. 이를 FAudioParameter로 묶어 Audio Folder에 보관한 뒤 Event에 단일 핀으로 넘겨 누락 사고를 방지하는 Pipeline을 구축한다.

수백 개의 Item이 가진 이름이나 Icon 경로 등을 하나의 Structure로 정의한다. 이를 바탕으로 Data Table Asset을 만들어 Excel 파일과 연동하면 프로그래머 개입 없이 Data만 교체되어 밸런스를 실시간 수정할 수 있다.

플레이어의 위치나 Quest 진행도 등 다양한 Type의 Data를 Hard Disk에 저장할 때 쓴다. 개별 변수 대신 거대한 FSaveDataStruct에 담아 Save Game Object에 넘기면 단일 파일로 빠르고 안전하게 압축 저장된다.

Mark as Published