[UE5] UE5 프로그래밍 입문 (3) - 함수

개발단에 가입하여 베르의 게임 개발 유튜브를 후원해주세요!

베르의 게임 개발 유튜브

 

안녕하세요! 여러분들과 함께 게임 개발을 공부하는 베르입니다!

이번에는 프로그래밍의 함수에 대해서 알아보고 언리얼 프로그래밍에서 함수를 만들고 사용하는 방법을 배워봅시다.

 

사용 엔진 버전 : 5.0.1

 

타임라인

0:00 인트로

0:12 함수란?

2:05 프로젝트 및 클래스 생성

2:39 변수 선언

3:36 함수 선언 및 구현

4:29 함수 만들어보기

5:15 함수 호출하기

7:52 아웃트로

스크립트

인트로

안녕하세요. 여러분들과 함께 게임 개발을 공부하는 베르입니다.

이번 영상에서는 함수의 기본적인 내용과 함께 언리얼 프로그래밍에서 함수를 만들고 호출하는 방법을 알아보도록 합시다.

함수란?

프로그래밍에서 함수는 일정한 동작을 수행하는 코드들을 묶어놓은 것을 이야기하며 이 함수는 반환형, 이름, 매개변수, 몸체를 가집니다.

차례대로 살펴보자면 먼저 반환형은 이 함수가 모든 과정을 수행하고 나서 어떤 타입의 결과값을 돌려주는지 알려주는 부분입니다.

반환형이 int로 되어있다면 이 함수가 모든 동작을 끝내고나서 돌려줄 결과 값의 타입이 정수형이라는 뜻입니다.

언리얼 프로그래밍에서 사용되는 모든 자료형은 반환형으로 사용할 수 있습니다.

또한 함수가 동작을 끝내고 나서 결과값을 돌려줄 필요가 없다면 void라는 타입으로 결과값을 돌려주지 않을 것임을 알려줄 수도 있습니다.

그리고 함수 이름은 이 함수를 호출하는데 사용되는 것으로 개발자가 원하는 대로 이름을 지어주면 됩니다.

다만 함수의 이름을 지을 때는 이 함수가 어떤 작업을 하는 함수인지 이름만 보고도 알 수 있게 하는 것이 좋습니다.

매개변수 부분은 괄호로 묶여있는데 이 부분을 통해서 함수가 동작하는데 필요한 변수를 함수 외부에서 받아와서 함수 내부에서 사용할 수 있게 됩니다.

이렇게 매개변수 괄호가 비어있을 때는 함수에 필요한 외부 변수가 없다는 뜻이 됩니다.

외부에서 변수를 받아와서 사용할 필요가 있을 때는 이렇게 매개변수의 타입과 이름을 넣어주면 됩니다.

만약 여러 개의 매개변수가 필요하다면 끝에 쉼표를 찍고 다음 매개변수의 타입과 이름을 적어주면 됩니다.

마지막으로 함수의 몸체는 이 함수가 실제로 해야할 일을 처리하는 코드를 작성하는 부분입니다.

예를 들어 캐릭터를 원하는 위치로 이동시키는 함수를 구현한다고 가정하면 반환형으로는 남은 거리를 돌려주기 위해서 float으로 하고 함수 이름은 Move로 정하게 될겁니다.

그리고 매개변수는 목적지의 좌표를 받게 되겠죠.

그 다음 함수의 몸체에서는 함수가 호출될 때마다 목적지를 향해서 캐릭터의 이동속도와 시간을 이용해서 조금씩 이동시키고 남은 거리를 반환하는 코드를 작성하게 될 겁니다.

이렇게 프로그래밍에서 함수는 어떠한 작업을 하나의 묶음으로 만들어서 필요할 때마다 재사용할 수 있게 되는데, 작업 효율을 위해서는 필요한 기능 별로 함수를 잘 만들어서 사용해야 합니다.

프로젝트 생성 및 클래스 생성

그럼 이제 언리얼 엔진에서 함수를 만들어보기 위해서 언리얼 엔진을 실행하고 새 프로젝트를 생성합니다.

카테고리는 게임으로 하고, 다른 코드 없이 완전히 비어있는 기본 템플릿을 선택하겠습니다.

그리고 프로젝트 타입을 C++로 변경한 다음 프로젝트를 생성합니다.

프로젝트가 생성되면 지난 영상인 언리얼 프로그래밍 입문 1편에서 배운 것처럼 Actor 클래스를 상속받아서 C++ 클래스를 하나 생성합니다.

클래스의 이름은 언리얼 엔진이 기본으로 추천해주는 MyActor를 그대로 쓰도록 하겠습니다.

변수 선언

클래스 생성이 끝나고 나면 헤더 파일로 가서 몇 가지 변수를 선언해주겠습니다.

int32 타입으로 TotalDamage를 선언하고 UPROPERTY 매크로를 붙여준 뒤 지정자로 EditAnywhere, BlueprintReadWrite, Category=”Damage”를 넣어줍니다.

그리고 float 타입으로 DamageTimeInSeconds와 DamagePerSecond 변수를 선언하고 UPROPERTY 매크로 붙여주되 DamageTimeInSeconds에는 TotalDamage 변수와 같은 지정자를 넣어주고 DamagePerSecond에는 지정자로 BlueprintReadOnly, VisibleAnywhere, Transient, Category="Damage”를 넣어줍니다.

그리고 생성자 함수로 가서 간단하게 변수들의 기본값을 지정해줍니다.

하지만 이중에서 DamagePerSecond 프로퍼티는 기본값을 넣지 않고 그냥 놔두겠습니다.

함수 선언 및 구현

그 다음 클래스에 함수를 만들기 위해서는 두 단계의 과정을 거쳐야 합니다.

바로 함수 선언과 구현입니다.

자세하게 설명해보자면 우선 헤더 파일에서 이 클래스에 새로 생성할 함수의 원래 형태, 즉 원형을 적어서 알려야 합니다.

이것을 함수의 선언이라고 합니다.

다시 말해서 함수 원형 선언은 이 클래스에 이런 함수가 있음을 알리는 것으로 함수의 반환형, 이름, 매개변수까지만 적고 세미콜론을 찍어주면 됩니다.

그리고 소스 파일로 가서 함수를 구현해야 합니다.

함수를 구현할 때는 반환형과 이 함수를 소유하고 있는 클래스의 이름을 적은 뒤 콜론을 두 개 찍어주고 함수 이름을 적습니다.

그리고 매개변수를 적은 뒤 중괄호를 열어서 함수의 몸체를 만들고 이 몸체 안에 실제 함수가 동작할 코드를 작성해야 합니다.

함수 만들어보기

그럼 이제 간단한 함수를 만들어 봅시다.

우선 앞에서 변수들에 기본 값을 넣어주면서 DamagePerSecond는 제외한 것을 기억할 겁니다.

TotalDamage 변수와 DamageTimeInSeconds 변수를 이용해서 이 DamagePerSecond 변수의 값을 바꿔주는 함수를 만들어 보겠습니다.

헤더 파일에서 CalculateDPS라는 이름으로 함수의 원형을 선언합니다.

함수의 원형을 완성하고 나면 소스 파일로 이동해서 함수를 실제로 구현해야 합니다.

소스 파일에서는 앞에서 한 번 이야기한 것처럼 반환형, 클래스 이름, 함수 이름, 괄호와 매개변수를 입력하고 중괄호로 함수의 몸체를 만들어주면 됩니다.

함수의 내용에는 TotalDamage를 DamageTimeInSeconds로 나눠서 DamagePerSecond 변수에 넣어주도록 코드를 작성합니다.

함수 호출하기

이렇게 함수를 작성하고 나면 이 함수가 특정한 시점에 자동으로 호출되게 해주겠습니다.

그 시점으로 알맞은 것은 TotalDamage나 DamageTimeInSeconds와 같은 변수가 초기화되거나 변경될 때 일 겁니다.

언리얼 엔진에서 오브젝트의 변수가 초기화될 때 호출되는 함수는 PostInitProperties이고 변수가 수정될 때 호출되는 함수는 PostEditChangeProperty입니다.

AMyActor의 헤더 파일로 가서 두 함수의 원형을 작성합니다.

이 두 함수는 AMyActor의 부모 클래스인 AActor에서 상속받는 함수이기 때문에 부모 클래스의 함수를 자식 클래스인 AMyActor에서 덮어쓴다는 의미로 virtual 키워드와 override 키워드를 사용해줘야 합니다.

이렇게 두 함수의 원형을 선언하고 나면 다시 소스 파일로 가서 함수를 구현해야 하는데 아까 전의 CalculateDPS 함수처럼 직접 작성할 수도 있지만, 초록색 밑줄이 그어진 함수 이름에 커서를 두고 [Ctrl + .] 단축키를 누르고 [PostInitProperties에서 'AMyActor.cpp' 정의 만들기]를 선택하면 빈 함수의 구현을 스크립트 에디터가 자동으로 해줍니다.

PostInitProperties 함수의 내용은 간단하게 Super::PostInitProperties 함수를 호출한 다음에 CalculateDPS 함수를 호출하게 만들어 줍니다.

참고로 언리얼 C++에서 Super 키워드는 클래스가 상속받은 부모 클래스에 있는 원본 프로퍼티나 함수를 가져오는데 사용되는 키워드입니다.

AMyActor에 override로 선언한 PostInitProperties 함수는 부모 클래스인 AActor 클래스의 PostInitProperties를 덮어씌워서 만든 것이기 때문에 이렇게 AMyActor에서 만든 PostInitProperties 함수에서 부모 클래스의 PostInitProperties를 다시 호출해주지 않으면 부모 클래스의 PostInitProperties에서 실제로 처리하는 작업이 실행되지 않아서 문제가 발생할 수도 있습니다.

그래서 이렇게 부모 클래스의 함수를 덮어씌워서 만드는 경우에는 Super 키워드를 이용해서 부모 클래스의 원본 함수를 한 번 실행시켜주는 것이 좋습니다.

PostInitProperties 함수를 모두 작성하고 나면 PostEditChangeProperty 함수도 역시 똑같이 작성해줍니다.

다만 PostEditChangeProperty 함수에서는 원본 PostEditChangeProperty 함수보다 CalculateDPS 함수를 먼저 호출해주도록 작성하겠습니다.

코드를 모두 작성하면 변경사항을 저장하고 에디터로 돌아가서 [Ctrl + Alt + F11] 단축키를 이용해 수정사항을 컴파일 해줍니다.

코드가 컴파일되고 나서 MyActor 클래스를 레벨에 배치해보면 디테일 패널에서 DamagePerSecond의 값이 계산되어 표시되는 것을 볼 수 있습니다.

그리고 TotalDamage 프로퍼티와 DamageTimeInSeconds 프로퍼티의 값을 변경하면 DamagePerSecond의 값도 곧바로 변경되는 것을 볼 수 있습니다.

아웃트로

이번 영상에서는 함수가 무엇인지 배우고 언리얼 프로그래밍에서 함수를 만들고 사용하는 방법을 알아보았습니다.

이 강좌는 시청자 여러분들의 시청과 후원으로 제작되었습니다.

이상 베르의 게임 개발 유튜브였습니다. 감사합니다.

 

[투네이션]

-

[Patreon]

WER's GAME DEVELOP CHANNEL님이 Game making class videos 창작 중 | Patreon

[디스코드 채널]

Join the 베르의 게임 개발 채널 Discord Server!