Unreal - Material Parameter Collection 사용하기

 

드래곤으로 변신하기위한 프로그래스바 게이지를 만들어줍니다

2025.06.20 - [Unreal 팁] - Unreal - 원형 프로그래스바 반원으로 바꾸기

 

Unreal - 원형 프로그래스바 반원으로 바꾸기

 

반원의 프로그래스바를 만들어줍니다

 

 

해당칸은 총 14칸입니다

 

해당 반원 프로그래스바를 인게임에서 값을 변경하기위해 MaterialParameterCollection을 사용해줍니다

 

사용할 MaterialParameterCollection을  위젯에 Property에 할당

그리고 해당 progressbar의 값을 변경하기위한 함수 SetSoulCollectionBar함수를 선언

UPROPERTY(EditAnywhere, Category = "MPC")
UMaterialParameterCollection* soulParameterCollection;

UMaterialParameterCollectionInstance* soulCollectionInstance;

UFUNCTION()
void SetSoulCollectionBar(float gaze);

 

위젯에서 할당해줍니다

 

메테리얼 파라미터 컬렉션에서 인덱스0을 Progress로 설정

 

SetSoulCollectionBar함수입니다

14칸을 기준으로 float 가변인자값으로 게이지를 바꾸는 함수를 만들어줍니다

void USwordCharacterWidget::SetSoulCollectionBar(float gaze)
{
	if (!soulCollectionInstance)
	{
		soulCollectionInstance = GetWorld()->GetParameterCollectionInstance(soulParameterCollection);
		if (!soulCollectionInstance) return;
	}
	float totalSteps = 14;
	float clampedGaze = FMath::Clamp(gaze, 0, totalSteps); // 0 ~ 14
	soulProgress = clampedGaze / 14.f;
	soulCollectionInstance->SetScalarParameterValue(FName("Progress"), soulProgress);
}

 

 

0.5씩 게이지가 증가하도록 하는 함수를 만들어줍니다

또한 clamp로 제 0 ~ 14값으로 제한합니다

UFUNCTION()
void IncreaseSoulCollectionBar();

float currentSoulGaze = 0;

 

void USwordCharacterWidget::IncreaseSoulCollectionBar()
{
	currentSoulGaze = FMath::Clamp(currentSoulGaze + 0.5, 0, 14);
	SetSoulCollectionBar(currentSoulGaze);
}

 

 

적을 죽이면 영혼이 드랍됩니다 영혼을 먹으면 IncreaseSoulCollectionBar함수를 호출하여 게이지를 0.5를 증가시켜줍니다

(호출하는예시)

 

APlayerController* playerCon;

playerCon = Cast<APlayerController>(UGameplayStatics::GetPlayerController(GetWorld(), 0));
ASwordCharacter* swordChar = Cast<ASwordCharacter>(playerCon->GetPawn());
swordChar->characterWidget->IncreaseSoulCollectionBar();

 

 

영혼액터를 UI 이미지 2D로 연출을 할려고하지만

위젯에서 이미지는 Emissive값을 전부무시해버리고 강제로 넣어도 이상해집니다

이미지를 기반으로 메테리얼을 만들어줍니다

 

 

UI위젯에서의 결과물

 

 

영혼 한개당 0.5 즉 두개를 먹으면 한칸이 차는걸 볼수있습니다