KoreanFoodie's Study

가비지 컬렉션 언리얼에서 UProperty 를 붙인 객체는 언리얼 엔진이 자동으로 가비지 컬렉터를 이용해 메모리를 관리한다. 가비지 컬렉션을 수행함에 있어 리플렉션 시스템을 사용하는데, 엔진이 객체와 속성값을 알고 있으므로, 더 이상 사용되지 않아 삭제해도 괜찮은 객체들을 구분할 수 있기 때문이다. 언리얼 엔진에서는 Reference Graph 를 만들어 오브젝트들의 사용 여부를 구분한다. 이 그래프 루트에는 "Root Set" 이라 지정된 오브젝트 셋이 존재하며, "Root Set" 에 포함된 객체들은 가비지 컬렉션 대상에서 제외된다. UObject::BaseUtility::AddToRoot 함수를 이용하면 객체를 "Root Set" 에 추가시킬 수 있다. ( 예시 : UMyObject->AddToRo..

스마트 포인터 3대장 C++ 에는 대표적인 스마트 포인터 3 가지가 있는데, 언리얼에서는 이를 T로 시작하는 라이브러리로 제공한다. TUniquePtr TSharedPtr TWeakPointer 기본적인 원리와 기능은 C++ 와 비슷하다. 기본적인 메서드 차이만 잠깐 짚고 넘어가면, TUniquePtr : C++ 에서 std::move 를 이용해 소유권을 이전했다면, 언리얼에서는 MoveTemp 를 사용한다. TSharedPtr : C++ 에서 std::maked_shared 를 이용했다면, 언리얼에서는 MakeShared 을 사용한다. 해제 시 Reset( ) 을 호출한다. shared_ptr(new MyClass()) 같은 식으로 사용할 때는 MakeShareable 을 사용한다. MakeSharea..

시리얼라이제이션 시리얼라이제이션이라는 개념은, 텔레포트와 같다고 이해하면 쉽다. 텔레포트로 사람을 전송한다고 했을 때, 정상적으로 작동하는 텔레포터는 사람 전체를 온전히 주고받는 형태일 것이다. 즉, 절반만 보낸다거나, 나눠서 보내지 않는다는 뜻이다. (나눠서 보내면... 그건 텔레포터가 아니라 살상무기가 아닐까) 시리얼라이제이션은 언리얼 오브젝트를 한번에 안전하게 전달하기 위해 FArchive 클래스를 만들어 파일, 메모리 등등 데이터를 전송하는 모든 매체를 관리하고 있다. 실제로 데이터를 전송하는 모든 매체는 FArchive 클래스를 상속받아서 구현한다. FArchive 객체를 이용해 파일을 만들고 쓰기/읽기를 구현한 예제 코드를 보자. FString FullPath = FString::Printf(..

델리게이트 C# 에서는 발행자-구독자(Publisher-Subscriber) 패턴의 구현이 가능해, 특정 이벤트를 구독한 객체는 특정 이벤트가 발행되었을 때 원하는 콜백함수가 실행되도록 만들 수 있다. 이때, 앞서 이야기한 특정 이벤트를 다른 말로 "델리게이트"라고 한다. C++ 에서는 델리게이트 시스템이 없지만, 언리얼은 자체적으로 델리게이트를 제공하고 있다. 델리게이트를 이용하는 것은 기존에 함수 포인터 등을 이용했던 것보다 간편하며 안전하다. 대리자를 통해 함수를 호출하므로 호출할 함수나 이를 포함하는 객체가 없어져도 대리자가 체크해 안전하게 함수를 호출할 수 있으며, 동일한 형을 가진 함수 여러 개를 대리자가 묶어서 관리하고 필요할 때 동시에 모두 호출할 수도 있다. 델리게이트를 사용하기 위해서는..

하드 레퍼런싱 vs 소프트 레퍼런싱 CDO 생성시, 생성자에서 애셋의 유무를 확인하기 위해 ConstructorHelpers 함수를 호출해 애셋을 로드한다. 하지만 게임 시작 전에 반드시 존재하는지 체크할 필요가 없는 경우도 있는데, 전자의 경우를 하드 레퍼런싱(Hard Referencing), 후자를 소프트 레퍼런싱(Soft Referencing) 이라고 한다. 소프트 레퍼런싱 방식을 사용할 시 애셋의 정보를 가져올 때에는 FStringAssetReference 구조체를, 애셋의 클래스 정보를 가져올 때에는 FStringClassReference 구조체에 경로 정보를 지정해주면 된다. 여러 애셋을 가져올 때는 TArray 형식을 사용하면 된다. ABPawn.h (로딩한 애셋을 실제 사용할 언리얼 오브젝..

언리얼 INI 파일 설정 만약 캐릭터의 HP 를 편집하고 싶은데, HP 값을 변경하기 위해 매번 캐릭터를 에디터에서 수정해야 한다면 매우 비효율적일 것이다. 이를 위해, 언리얼은 INI 파일을 이용해 블루프린트나 별도의 에디터 작업이 없이도 속성값을 바꿀 수 있는 기능을 제공하고 있다. (원래 INI 파일은 윈도우에서 시스템 구성 요소의 설정을 위해 만들어진 파일 형식이다) INI 파일의 형식은 속성과 값, 그리고 이 두 가지를 포괄하는 섹션으로 구성되어 있다. 섹션 : 현재 프로젝트에서 사용하는 C++ 클래스 식별자 속성 : C++ 클래스에서 INI 를 사용하도록 지정한 UPROPERTY 멤버 변수 값 : 속성에 지정할 값 C++ 클래스 식별자는 고유한 식별자로 구분되며 다음과 같은 형식을 가진다. {..

언리얼 액터 생성 예시 참고로 액터 생성시에는 ConstructorHelpers 를 많이 사용한다. AWeapon::AWeapon() { // Set this actor to call Tick() every frame. You can turn this off to improve performance if you don't need it. PrimaryActorTick.bCanEverTick = true; Weapon = CreateDefaultSubobject(TEXT("WeaponHashValue")); RootComponent = Weapon; static ConstructorHelpers::FObjectFinder SK_BlackKnight(TEXT("SkeletalMesh'/Game/Infinit..

언리얼 오브젝트 생성 언리얼 오브젝트를 생성할 때는 기본적으로 NewObject( ) 를 사용한다. 이번에는 ABGameInstance 에서 WebConnection 이라는 DefaultSubobject 를 생성했다고 가정해 보자. ABGameInstance 에서는 GetDefaultSubobject 를 호출해 WebConnection 을 조회하고, WebConnection 에서는 GetOuter 를 호출해 ABGameInstance 를 조회할 수 있다. NewObject vs CreateDefaultSubobject 그렇다면 어떤 것을 써야 할까? 두 가지 모두 언리얼 오브젝트를 생성한다는 것은 같으나, 생성 방식에서 차이가 존재한다. 다음의 코드를 보자. ... #include "ABGameInsta..

리플렉션 : 런타임에 자기 자신을 조사하게 만들자 언리얼은 UHT(Unreal Header Tool) 을 이용해 클래스 계층 구조, 멤버 변수/함수 등의 정보를 UClass 에 저장한다. 이를 리플렉션이라고도 하고, 프로퍼티 시스템이라고도 부른다. 리플리케이션 시스템은 부가 기능으로, 리플렉션 시스템에 보이도록 했으면 하는 유형이나 프로퍼티에 주석을 달아두면 UHT 가 컴파일시 해당 정보를 수집하게 된다. 프로퍼티 시스템 계층 구조는 아래와 같다. (UField 아래에 UStruct, UEnum, UProperty 가 있음) 실제 예시 코드를 보자. #include "MyObject.generated.h" UCLASS(Blueprintable) class UMyObject : public UObject ..

CDO 는 무엇이고, 또 왜 사용할까 언리얼에서는 런타임에 빠른 타입 체킹과 클래스 검색을 위해, 컴파일 타임에서 클래스와 타입 등의 메타 정보를 생성한다. 이러한 메타 정보는 UClass 라는 언리얼 클래스에 보관된다. UClass 에는 클래스의 계층 구조나 멤버 변수/함수에 대한 정보가 들어있다. 이러한 UClass 를 이용하면, 단순히 타입을 검색하는 것을 넘어 런타임에서 인스턴스의 멤버 변수 값을 변경하거나 멤버 함수를 호출할 수도 있다. (Java, C# 에서는 이런 기능을 리플렉션[Reflection] 이라고 부른다) 런타임 과정에서는 언리얼 오브젝트를 초기화해야 하는데, 이때 생성되는 인스턴스가 CDO(Class Default Object), 클래스 기본 객체이다. 언리얼은 CDO 를 미리 ..