UWaveInfoWidget 클래스 참조

#include <WaveInfoWidget.h>

UWaveInfoWidget에 대한 상속 다이어그램 :

UWaveInfoWidget에 대한 협력 다이어그램:

Protected 멤버 함수
virtual void	NativeConstruct () override
virtual void	NativeDestruct () override
void	UpdateEnemyCount (const int32 Count)
void	UpdateCountdownTime (const float SecondsRemaining)
UUserWidgetBase(으)로부터 상속된 Protected 멤버 함수
virtual void	OnWidgetActivated ()
virtual void	OnWidgetDeactivated ()
void	OnPushedToLayer_Internal ()
void	OnPoppedFromLayer_Internal ()
void	OnActivated_Internal ()
void	OnDeactivated_Internal ()

Protected 속성
TObjectPtr< UTextBlock >	RemainingEnemyCount
TObjectPtr< UTextBlock >	CurrentWaveIndex
TObjectPtr< UTextBlock >	NextWaveCountdown
UUserWidgetBase(으)로부터 상속된 Protected 속성
EWidgetState	WidgetState
TObjectPtr< UAbilitySystemComponent >	ASC
FGameplayTag	LayerTag
bool	bPrimary = false
TObjectPtr< UWidgetAnimation >	AppearanceAnim
TObjectPtr< UWidgetAnimation >	DisappearanceAnim

Private 멤버 함수
void	ApplyRemainingEnemyCount (int32 Count)
void	UpdateCountdownText ()
void	StartCountdown (float Seconds)
void	StopCountdown ()
void	TickCountdown ()
void	OnEnemyRemainingCountChanged (int32 RemainingCount)
void	OnSpawnedEnemyKilled (const AEnemyCharacterBase *DiedEnemy, const int32 RemainingCount)
void	OnUpdateWave (const FWaveDataCollection &WaveDataCollection, const int32 CurrentWaveIdx)

Private 속성
float	NextWaveCountdownSeconds = 0.0f
int32	WidgetRemainingTotal = 0
int32	LastEnemyCountBroadcast = 0
int32	WidgetTotalBeforeLastBroadcast = 0
FTimerHandle	CountdownTimerHandle

정적 Private 속성
static constexpr float	CountdownTickInterval = 0.1f

추가로 상속된 멤버들
UUserWidgetBase(으)로부터 상속된 Public 멤버 함수
virtual void	SetAbilitySystemComponent (AActor *InOwner)
virtual UAbilitySystemComponent *	GetAbilitySystemComponent () const override
virtual void	OnPushedToLayer ()
virtual void	OnPoppedFromLayer ()
virtual void	OnActivated ()
virtual void	OnDeactivated ()
void	Activate ()
void	Deactivate ()
FORCEINLINE FGameplayTag	GetLayerTag () const
FORCEINLINE void	SetLayerTag (const FGameplayTag InTag)
FORCEINLINE bool	IsPrimary () const
FORCEINLINE void	SetPrimary (const bool InPrimary)
FORCEINLINE EWidgetState	GetWidgetState () const
FORCEINLINE void	SetWidgetState (const EWidgetState InState)
FORCEINLINE UWaitForWidgetActivation *	GetActivationHandle ()
FORCEINLINE bool	HasAppearanceAnim () const
FORCEINLINE bool	HasDisappearanceAnim () const

멤버 함수 문서화

ApplyRemainingEnemyCount()

void UWaveInfoWidget::ApplyRemainingEnemyCount ( int32  Count )

private

{
    if (UTextBlock* CountBlock = RemainingEnemyCount.Get())
    {
        CountBlock->SetText(FText::FromString(FString::FromInt(Count)));
    }
    else
    {
        LOG_ERROR(LogCK, "%s(%s)의 RemainingEnemyCount BindWidget 연결이 없습니다.", *GetName(), *GetClass()->GetPathName());
    }
 
    UpdateEnemyCount(Count);
}

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

NativeConstruct()

void UWaveInfoWidget::NativeConstruct ( )

overrideprotectedvirtual

{
    Super::NativeConstruct();
 
    // 첫 브로드캐스트 전 빈 화면을 막기 위해 1-based 1번 웨이브로 초기 표시.
    if (UTextBlock* WaveText = CurrentWaveIndex.Get())
    {
        WaveText->SetText(FText::FromString(TEXT("Wave : 1")));
    }
 
    UpdateCountdownText();
    UWorld* World = GetWorld();
 
    if (World == nullptr)
    {
        return;
    }
 
    UStageManagementSubsystem* StageManager = World->GetSubsystem<UStageManagementSubsystem>();
 
    if (StageManager == nullptr)
    {
        return;
    }
 
    StageManager->OnEnemyRemainingCountChanged.AddDynamic(this, &UWaveInfoWidget::OnEnemyRemainingCountChanged);
    StageManager->OnSpawnedEnemyKilled.AddDynamic(this, &UWaveInfoWidget::OnSpawnedEnemyKilled);
    StageManager->OnWaveStarted.AddDynamic(this, &UWaveInfoWidget::OnUpdateWave);
    StageManager->OnNextWaveCountdownStarted.AddDynamic(this, &UWaveInfoWidget::StartCountdown);
    StageManager->OnNextWaveCountdownStopped.AddDynamic(this, &UWaveInfoWidget::StopCountdown);
 
    const int32 InitialRemainingCount = StageManager->GetTotalSpawnRemainingCount();
    WidgetRemainingTotal = InitialRemainingCount;
    LastEnemyCountBroadcast = InitialRemainingCount;
    WidgetTotalBeforeLastBroadcast = 0;
    ApplyRemainingEnemyCount(InitialRemainingCount);
 
    const float CountdownRemaining = StageManager->GetNextWaveCountdownRemainingTime();
 
    if (CountdownRemaining > KINDA_SMALL_NUMBER)
    {
        StartCountdown(CountdownRemaining);
    }
}

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

NativeDestruct()

void UWaveInfoWidget::NativeDestruct ( )

overrideprotectedvirtual

{
    StopCountdown();
 
    if (UWorld* World = GetWorld())
    {
        if (UStageManagementSubsystem* StageManager = World->GetSubsystem<UStageManagementSubsystem>())
        {
            StageManager->OnEnemyRemainingCountChanged.RemoveDynamic(this, &UWaveInfoWidget::OnEnemyRemainingCountChanged);
            StageManager->OnSpawnedEnemyKilled.RemoveDynamic(this, &UWaveInfoWidget::OnSpawnedEnemyKilled);
            StageManager->OnWaveStarted.RemoveDynamic(this, &UWaveInfoWidget::OnUpdateWave);
            StageManager->OnNextWaveCountdownStarted.RemoveDynamic(this, &UWaveInfoWidget::StartCountdown);
            StageManager->OnNextWaveCountdownStopped.RemoveDynamic(this, &UWaveInfoWidget::StopCountdown);
        }
    }
 
    Super::NativeDestruct();
}

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

OnEnemyRemainingCountChanged()

void UWaveInfoWidget::OnEnemyRemainingCountChanged ( int32  RemainingCount )

private

{
    LOG_INFO(LogCK, "남은 몬스터 카운트 업데이트 (%d)", RemainingCount);
 
    // StageManager의 CurrentWaveRemainingEnemyCount는 새 웨이브 시작 시 덮어쓰기되고
    // 잔존 누적은 추적하지 않으므로 위젯 총합을 그대로 따라가지 않는다.
    // 위젯 총합 갱신은 OnSpawnedEnemyKilled(킬당 1 감소) 및 OnUpdateWave(새 웨이브 합산)에서 처리하고,
    // 본 핸들러는 OnUpdateWave가 합산에 사용할 값(이전 잔존, 새 웨이브 예정 스폰)을 캐싱만 한다.
    WidgetTotalBeforeLastBroadcast = WidgetRemainingTotal;
    LastEnemyCountBroadcast = RemainingCount;
}

이 함수를 호출하는 함수들에 대한 그래프입니다.:

OnSpawnedEnemyKilled()

void UWaveInfoWidget::OnSpawnedEnemyKilled ( const AEnemyCharacterBase *  DiedEnemy, const int32  RemainingCount  )

private

{
    // 잔존 몬스터가 죽을 때마다 위젯 총합을 1씩 감소시킨다.
    // (StageManager의 카운트는 새 웨이브에서 덮어쓰기되어 잔존 누적을 잃을 수 있으므로
    // 킬 1건당 1 감소시키는 본 신호를 권위로 사용한다.)
    WidgetRemainingTotal = FMath::Max(WidgetRemainingTotal - 1, 0);
    ApplyRemainingEnemyCount(WidgetRemainingTotal);
}

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

OnUpdateWave()

void UWaveInfoWidget::OnUpdateWave ( const FWaveDataCollection &  WaveDataCollection, const int32  CurrentWaveIdx  )

private

{
    if (UTextBlock* WaveText = CurrentWaveIndex.Get())
    {
        const int32 CurrentWave = CurrentWaveIdx + 1;
        WaveText->SetText(FText::FromString("Wave : " + FString::FromInt(CurrentWave)));
    }
    else
    {
        LOG_ERROR(LogCK, "%s(%s)의 CurrentWaveIndex BindWidget 연결이 없습니다.", *GetName(), *GetClass()->GetPathName());
    }
 
    // 새 웨이브 시작: 직전 OnEnemyRemainingCountChanged 도착 직전의 잔존(WidgetTotalBeforeLastBroadcast)에
    // 새 웨이브의 예정 스폰 수(LastEnemyCountBroadcast = 직전 브로드캐스트 값)를 더해 총합을 갱신한다.
    const int32 CombinedCount = WidgetTotalBeforeLastBroadcast + LastEnemyCountBroadcast;
    WidgetRemainingTotal = CombinedCount;
    ApplyRemainingEnemyCount(CombinedCount);
 
    // 다음 웨이브 카운트다운은 StageManagementSubsystem의 별도 알림으로 처리한다.
}

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

StartCountdown()

void UWaveInfoWidget::StartCountdown ( float  Seconds )

private

{
    if (Seconds <= KINDA_SMALL_NUMBER)
    {
        StopCountdown();
        return;
    }
 
    NextWaveCountdownSeconds = Seconds;
    UpdateCountdownText();
 
    UWorld* World = GetWorld();
 
    if (World == nullptr)
    {
        return;
    }
 
    // 기존 타이머는 SetTimer 가 자동 교체.
    World->GetTimerManager().SetTimer(CountdownTimerHandle, this, &UWaveInfoWidget::TickCountdown, CountdownTickInterval, true);
}

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

StopCountdown()

void UWaveInfoWidget::StopCountdown ( )

private

{
    NextWaveCountdownSeconds = 0.f;
 
    if (UWorld* World = GetWorld())
    {
        World->GetTimerManager().ClearTimer(CountdownTimerHandle);
    }
 
    UpdateCountdownText();
}

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

TickCountdown()

void UWaveInfoWidget::TickCountdown ( )

private

{
    NextWaveCountdownSeconds = FMath::Max(NextWaveCountdownSeconds - CountdownTickInterval, 0.f);
    UpdateCountdownText();
 
    if (NextWaveCountdownSeconds > 0.f)
    {
        return;
    }
 
    StopCountdown();
}

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

UpdateCountdownText()

void UWaveInfoWidget::UpdateCountdownText ( )

private

{
    if (UTextBlock* CountdownBlock = NextWaveCountdown.Get())
    {
        if (NextWaveCountdownSeconds > KINDA_SMALL_NUMBER)
        {
            CountdownBlock->SetText(FText::FromString(FString::Printf(TEXT("Next Wave : %.1fs"), NextWaveCountdownSeconds)));
        }
        else
        {
            CountdownBlock->SetText(FText::FromString(TEXT("0.0")));
        }
    }
 
    UpdateCountdownTime(NextWaveCountdownSeconds);
}

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

UpdateCountdownTime()

void UWaveInfoWidget::UpdateCountdownTime ( const float  SecondsRemaining )

protected

이 함수를 호출하는 함수들에 대한 그래프입니다.:

UpdateEnemyCount()

void UWaveInfoWidget::UpdateEnemyCount ( const int32  Count )

protected

이 함수를 호출하는 함수들에 대한 그래프입니다.:

멤버 데이터 문서화

CountdownTickInterval

constexpr float UWaveInfoWidget::CountdownTickInterval = 0.1f

staticconstexprprivate

CountdownTimerHandle

FTimerHandle UWaveInfoWidget::CountdownTimerHandle

private

CurrentWaveIndex

TObjectPtr<UTextBlock> UWaveInfoWidget::CurrentWaveIndex

protected

LastEnemyCountBroadcast

int32 UWaveInfoWidget::LastEnemyCountBroadcast = 0

private

NextWaveCountdown

TObjectPtr<UTextBlock> UWaveInfoWidget::NextWaveCountdown

protected

NextWaveCountdownSeconds

float UWaveInfoWidget::NextWaveCountdownSeconds = 0.0f

private

RemainingEnemyCount

TObjectPtr<UTextBlock> UWaveInfoWidget::RemainingEnemyCount

protected

WidgetRemainingTotal

int32 UWaveInfoWidget::WidgetRemainingTotal = 0

private

WidgetTotalBeforeLastBroadcast

int32 UWaveInfoWidget::WidgetTotalBeforeLastBroadcast = 0

private

---

이 클래스에 대한 문서화 페이지는 다음의 파일들로부터 생성되었습니다.:

• Source/CK_UE/UI/HUD/Wave/WaveInfoWidget.h
• Source/CK_UE/UI/HUD/Wave/WaveInfoWidget.cpp