[Unreal] 헬로 언리얼 | 명명규칙

이득우의 언리얼 프로그래밍 Part1 - 언리얼 C++의 이해 강의 정리

 

 

1. GameInstance 상속받기

 

2. 에디터 설정 변경

 

 

 

헤더 파일

UCLASS()
class HELLOUNREAL_API UMyGameInstance : public UGameInstance
{
	GENERATED_BODY()
public:
	virtual void Init() override;
    // 선언 후 alt + enter를 하여, 정의를 자동으로 삽입해준다
};

 

소스 파일

void UMyGameInstance::Init()
{
	Super::Init();

	UE_LOG(LogTemp, Log, TEXT("%s"), TEXT("Hello Unreal"));
}

 

• Super::Init() 

부모 클래스에 있는 Init() 함수 내 모든 것을 세팅

 

• Init()

게임 실행 전, GameInstance 세팅을 위해 필요한 함수

 

•  UE_LOG(LogTemp, Log, TEXT("%s"), TEXT("Hello Unreal"));

DebugLog. 형식 지정자 필요

 

 

언리얼 엔진 코딩  표준

1. public은 private로 이어지는 클래스 체계를 준수

 

2. 명명규칙

👉 파스칼 케이싱을 사용한다. 예) UnrealEngine

👉 소문자를 가급적 사용하지 않고, 공백 및 언더스코어(_)가 없음

👉 모든 클래스와 구조체에는 고유한 접두사가 있음

 

3. 코드의 명확성

👉 파라미터에 가급적 In과 Out 접두사를 사용해 명시

👉 const 지시자의 적극적인 활용

👉 레퍼런스를 통한 복사 방지

👉 auto 키워드는 가급적 자제

 

4. Find In Files의 활용

👉 FShaderType* Ptr 규칙을 따르도록 한다. *의 위치가 중요

 

5. 헤더 파일 및 #include 구문은 의존성을 최소화시켜 주의 깊게 다뤄야 한다.

 

필기

명명규칙

파스칼 케이싱 : 합성의 첫 글자를 대문자를 사용해 명명

언리얼에서는 파스칼 케이싱만을 허용하고 있다. 예) UnrealEngine

 

cf. 카멜(낙타)케이싱 : unrealEngine

cf. 스네이크 케이싱 : unreal_engine

 

템플릿 클래스는 접두사 T를 포함

UObject에서 상속받은 클래스는 접두사 U를 포함 예) gameInstance : UMyGameInstance

AActor에서 상속받은 클래스는 접두사 A를 포함

Swidget에서 상속받은 클래스에는 접두사 S를 포함

추상적 인터페이스인 클래스에는 접두사 I를 포함

에픽의 개념이 유사한 클래스 타입은 접두사 C를 포함

열거형 = E

부울 변수 = b

그 외 대부분의 클래스는 접두사 F를 포함. 그러나 일부 열거 서브시스템에는 다른 글자도 사용

Typedef 의 경우 해당 타입에 적합한 접두사 사용

 

 cf. 파일 이름은 접두사를 빼는 것이 좋다.

예) UScene.cpp 보다는 Scene.cpp 가 낫다.

 

함수 파라미터가 참조로 전달된 후 함수 가 그 값에 쓸 것으로 예상되는 경우 이름 앞에 접두사 'Out'을 추가하는 것이 좋다. In 또는 Out 파라미터도 부울인 경우 bOutResult와 같이 In/Out 접두사 앞에 'b'를 붙인다. 항상 쓰이는 것은 아님

 

포터블 C++ 코드

int -> int32

char -> TCHAR 등

 

C++ 표준 라이브러리는 사용하지 않는 것이 기본원칙

 

const 적극적 사용

- 포인터에 const를 붙일 수 있음

- 레퍼런스에는 안됨

 

T * const Ptr =  ... ; // 포인터로의 재할당은 불가하나, T는 여전히 수정 가능하다.

T & const Ref = ...; // 문법적으로 틀림

 

enum은 namespace 보다 class가 낫다.

 

헤더 부분은 include할 때, 적은 수를 포함하도록 한다.

 

Find in Files를 할 때, FShaderType* Ptr 규칙을 따르도록 한다. *의 위치가 중요