C++Porting_UMG

1. 개요

전체적인 작업의 큰 틀은 다음 3단계로 이루어진다        

2. UMG Blueprint 배치

2-1. Widget BluePrint를 생성

우클릭 후 Widget Blueprint 생성

   

여기서 그냥 User Widget 선택

   

누른 뒤에 여러 아이템들을 추가한다.

   

데이터 변경을 C++과 연동할 아이템들은 C++에서도 변수명이 같아야 한다!

       

3. C++에서 UI 포팅 작업

3-1. UserWidget을 상속받아서 C++ 클래스 생성

   

3-2. 위에서 만든 아이템과 동일한 변수이름으로 선언

Widget 의 item과 동기화 문구

UPROPERTY(meta = (BindWidget))

UCLASS()
class D1_API UUI_MainHUD : public UUserWidget
{
	GENERATED_BODY()
public:
	UPROPERTY(meta = (BindWidget))
	TObjectPtr<class UUI_StatBar> HealthBar; //블루프린트와 이름이 같아야 함
	UPROPERTY(meta = (BindWidget))
	TObjectPtr<class UUI_StatBar> StaminaBar; //블루프린트와 이름이 같아야 함
};

   

UCLASS()
class D1_API UUI_StatBar : public UUserWidget
{

	GENERATED_BODY()
protected:
	virtual void NativeConstruct() override;
public:	//Delegate
	void StatBarStatValueUpdated(EStats stat, float value);
public:
	UPROPERTY(EditAnywhere, BlueprintReadWrite, meta = (BindWidget))
	class UProgressBar* StatBar; //블루프린트와 이름이 같아야 함

	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category=Initialization , meta=(AllowPrivateAccess="true"))
	EStats StatType; //블루프린트에서 수정 가능

	UPROPERTY(visibleAnywhere, BlueprintReadWrite, Category=Initialization , meta=(AllowPrivateAccess="true"))
	TObjectPtr<UStatsComponent> StatsComponent; // 블루프린트에서 수정 가능
};

   

3-3. Widget의 기능 셋팅

//Widget 생성 시 호출
void UUI_StatBar::NativeConstruct()
{
	APawn* pplayer = GetOwningPlayerPawn();
	if (pplayer)
	{
		StatsComponent = pplayer->GetComponentByClass<UStatsComponent>();
		if (IsValid(StatsComponent))
			StatsComponent->OnCurrentStatValueUpdated.AddUObject(this, &UUI_StatBar::StatBarStatValueUpdated);
	}
}

//Widget에서 bind할 Delegate 함수
void UUI_StatBar::StatBarStatValueUpdated(EStats stat, float value)
{
	if (StatType != stat)
		return;

	if (!IsValid(StatsComponent))
		return;

	float fPercent = value / StatsComponent->GetMaxStatValue(StatType);
	StatBar->SetPercent(fPercent);
}

       

4. BluePrint UI에서 부모 변경

4-1. C++ 파일로 부모를 변경

부모를 변경해서 C++에서 정의한 기능을 사용할 수 있게 됨

       

5. 화면 띄우는 방법

5-1. Player Controller에서 설정

UCLASS()
class D1_API ACombatPlayerController : public APlayerController
{
	GENERATED_BODY()
	
public:
	virtual void BeginPlay() override;

private:
	UPROPERTY(EditDefaultsOnly, Category = UI)
	TSubclassOf<class UUI_MainHUD> MainHUDClass;
};

   

#include "CombatPlayerController.h"
#include "UI/UI_MainHUD.h"

void ACombatPlayerController::BeginPlay()
{
	if (MainHUDClass)
	{
		UUI_MainHUD* mainHUD = CreateWidget<UUI_MainHUD>(this, MainHUDClass);
		mainHUD->AddToViewport();
	}
}

만든 Widget을 여기서 생성하는 코드를 넣어주고 AddToViewport를 호출

   

5-2. Blueprint로 PlayerController 상속 후 작업

C++로 만든 PlayerController를 Blueprint로 상속해서 Blueprint로 변경 그 후에 설정해주었던 TSubclassOf를 이용해서

다음과 같이 UI 셋팅을 해준다    

5-3. World Setting

World Setting에서 사용하는 PlayerController를 셋팅

       

6. HUD 설정

6-1. HUD 란?

다른 UI들을 포함하는 Root UI를 따로 Actor로 만들어서 관리가능 Player Controller에서 해주는 방법 말고 이 방법으로도 가능하다    

6-2. HUD 생성

Class선택 시에 Actor 산하에 있는 HUD를 상속받아서 만들면 됨    

UCLASS()
class D1_API ACombatHUD : public AHUD
{
	GENERATED_BODY()
	
protected:
	virtual void BeginPlay() override;
private:
	UPROPERTY(EditDefaultsOnly, Category = UI)
	TSubclassOf<class UUI_MainHUD> MainUI;
};

#include "UI/CombatHUD.h"
#include "UI/UI_MainHUD.h"

void ACombatHUD::BeginPlay()
{
	Super::BeginPlay();

	UWorld* World = GetWorld();
	if (World)
	{
		APlayerController* Contorller = World->GetFirstPlayerController();
		if (Contorller && MainUI)
		{
			UUI_MainHUD* outputUI = CreateWidget<UUI_MainHUD>(Contorller, MainUI);
			outputUI->AddToViewport();
		}
	}
}

   

6-3. Blueprint로 작업

BluePrint로 만든 C++ 파일을 상속하고 TSubclassOf를 이용해서 Blueprint Widget UI를 셋팅    

6-4. World 셋팅

World 셋팅에서 만든 Blueprint HUD를 셋팅