UConstellationBuffHUDWidget 클래스 참조

#include <ConstellationBuffHUDWidget.h>

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

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

클래스
struct	FTrackedSlot

Protected 멤버 함수
virtual void	NativeConstruct () override
virtual void	NativeDestruct () override
virtual void	NativeTick (const FGeometry &MyGeometry, float InDeltaTime) override
void	HandleBuffApplied (USituationBase *Situation)
void	HandleBuffRemoved (USituationBase *Situation)
UConstellationBuffSlotWidget *	FindSlot (const USituationBase *Situation) const
void	ReflowSlots ()
UUserWidgetBase(으)로부터 상속된 Protected 멤버 함수
virtual void	OnWidgetActivated ()
virtual void	OnWidgetDeactivated ()
void	OnPushedToLayer_Internal ()
void	OnPoppedFromLayer_Internal ()
void	OnActivated_Internal ()
void	OnDeactivated_Internal ()

Protected 속성
TObjectPtr< UPanelWidget >	BuffSlotContainer
TSubclassOf< UConstellationBuffSlotWidget >	BuffSlotClass
int32	SlotsPerRow = 5
UUserWidgetBase(으)로부터 상속된 Protected 속성
EWidgetState	WidgetState
TObjectPtr< UAbilitySystemComponent >	ASC
FGameplayTag	LayerTag
bool	bPrimary = false
TObjectPtr< UWidgetAnimation >	AppearanceAnim
TObjectPtr< UWidgetAnimation >	DisappearanceAnim

Private 속성
TArray< FTrackedSlot >	TrackedSlots

추가로 상속된 멤버들
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

상세한 설명

채팅창 아래에 걸리는 활성 버프 아이콘 줄. 슬롯 생성/제거와 남은 시간 갱신을 담당한다.

버프는 성좌가 아니라 상황 카드가 소유하므로, 슬롯 하나는 장착된 상황 하나에 대응한다.

멤버 함수 문서화

FindSlot()

UConstellationBuffSlotWidget * UConstellationBuffHUDWidget::FindSlot ( const USituationBase *  Situation ) const

protected

{
    auto MatchesSituation = [Situation](const FTrackedSlot& Tracked)
    {
        return Tracked.Situation == Situation;
    };
 
    const FTrackedSlot* Found = TrackedSlots.FindByPredicate(MatchesSituation);
 
    return Found ? Found->Slot.Get() : nullptr;
}

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

HandleBuffApplied()

void UConstellationBuffHUDWidget::HandleBuffApplied ( USituationBase *  Situation )

protected

{
    if (Situation == nullptr || BuffSlotContainer == nullptr)
    {
        return;
    }
 
    // 같은 카드가 다음 주기에 또 발동한 경우엔 슬롯을 새로 만들지 않는다. 남은 시간은 틱에서 알아서 따라간다.
    auto MatchesSituation = [Situation](const FTrackedSlot& Tracked)
    {
        return Tracked.Situation == Situation;
    };
 
    if (TrackedSlots.ContainsByPredicate(MatchesSituation))
    {
        return;
    }
 
    if (BuffSlotClass == nullptr)
    {
        LOG_WARNING(LogCK, "BuffSlotClass 가 비어 있어 버프 슬롯을 만들 수 없습니다.");
        return;
    }
 
    UConstellationBuffSlotWidget* NewSlot = CreateWidget<UConstellationBuffSlotWidget>(GetOwningPlayer(), BuffSlotClass);
 
    if (NewSlot == nullptr)
    {
        return;
    }
 
    // 일러스트는 소프트 참조라 표시 직전에 로드한다.
    NewSlot->SetupSlot(Situation, Situation->GetSituationData().Illustration_Path.LoadSynchronous());
 
    // 자식 하나만 받는 패널(Border/SizeBox/ScaleBox 등)이면 두 번째부터 nullptr 을 돌려주고 조용히 실패한다.
    if (BuffSlotContainer->AddChild(NewSlot) == nullptr)
    {
        LOG_ERROR(LogCK, "BuffSlotContainer(%s)에 슬롯을 붙이지 못했습니다. 자식을 여러 개 받는 패널(HorizontalBox 등)로 바꿔야 합니다.", *BuffSlotContainer->GetClass()->GetName());
        return;
    }
 
    FTrackedSlot Tracked;
    Tracked.Situation = Situation;
    Tracked.Slot = NewSlot;
    TrackedSlots.Add(Tracked);
 
    ReflowSlots();
}

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

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

HandleBuffRemoved()

void UConstellationBuffHUDWidget::HandleBuffRemoved ( USituationBase *  Situation )

protected

{
    if (Situation == nullptr)
    {
        return;
    }
 
    if (UConstellationBuffSlotWidget* RemovedSlot = FindSlot(Situation))
    {
        RemovedSlot->RemoveFromParent();
    }
 
    auto MatchesSituation = [Situation](const FTrackedSlot& Tracked)
    {
        return Tracked.Situation == Situation;
    };
 
    TrackedSlots.RemoveAll(MatchesSituation);
 
    // 중간 슬롯이 빠지면 뒤 슬롯을 앞으로 당겨 빈칸을 없앤다.
    ReflowSlots();
}

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

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

NativeConstruct()

void UConstellationBuffHUDWidget::NativeConstruct ( )

overrideprotectedvirtual

{
    Super::NativeConstruct();
 
    USituationManagementSubsystem* SituationSubsystem = GetWorld()->GetSubsystem<USituationManagementSubsystem>();
 
    if (SituationSubsystem == nullptr)
    {
        return;
    }
 
    SituationSubsystem->OnSituationBuffApplied.AddUObject(this, &UConstellationBuffHUDWidget::HandleBuffApplied);
    SituationSubsystem->OnSituationBuffRemoved.AddUObject(this, &UConstellationBuffHUDWidget::HandleBuffRemoved);
 
    // HUD 가 뒤늦게 생성돼도 이미 걸려 있는 버프를 놓치지 않도록 초기 상태를 채운다.
    for (USituationBase* Situation : SituationSubsystem->GetActiveSituations())
    {
        HandleBuffApplied(Situation);
    }
}

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

NativeDestruct()

void UConstellationBuffHUDWidget::NativeDestruct ( )

overrideprotectedvirtual

{
    if (USituationManagementSubsystem* SituationSubsystem = GetWorld()->GetSubsystem<USituationManagementSubsystem>())
    {
        SituationSubsystem->OnSituationBuffApplied.RemoveAll(this);
        SituationSubsystem->OnSituationBuffRemoved.RemoveAll(this);
    }
 
    TrackedSlots.Empty();
 
    Super::NativeDestruct();
}

NativeTick()

void UConstellationBuffHUDWidget::NativeTick ( const FGeometry &  MyGeometry, float  InDeltaTime  )

overrideprotectedvirtual

{
    Super::NativeTick(MyGeometry, InDeltaTime);
 
    if (TrackedSlots.IsEmpty())
    {
        return;
    }
 
    const APlayerController* OwningPlayer = GetOwningPlayer();
 
    for (const FTrackedSlot& Tracked : TrackedSlots)
    {
        if (Tracked.Situation.IsValid() == false || Tracked.Slot.IsValid() == false)
        {
            continue;
        }
 
        // 남은 시간과 총 지속 시간 모두 GE 가 소유하므로 매번 직접 물어본다.
        // 캐싱해두면 재적용이나 무기 교체로 지속 시간이 바뀔 때 비율이 어긋난다.
        const float RemainingSeconds = Tracked.Situation->GetBuffRemainingTime(OwningPlayer);
        const float Duration = Tracked.Situation->GetBuffDuration(OwningPlayer);
 
        const bool bIsPermanent = Duration <= 0.0f;
        const float NormalizedRemaining = bIsPermanent ? 1.0f : FMath::Clamp(RemainingSeconds / Duration, 0.0f, 1.0f);
 
        Tracked.Slot->UpdateRemaining(NormalizedRemaining, FMath::Max(RemainingSeconds, 0.0f), bIsPermanent);
    }
}

ReflowSlots()

void UConstellationBuffHUDWidget::ReflowSlots ( )

protected

{
    // 스스로 흐르는 패널(WrapBox 등)이면 UMG 가 알아서 배치한다.
    if (Cast<UUniformGridPanel>(BuffSlotContainer) == nullptr)
    {
        return;
    }
 
    const int32 ColumnCount = FMath::Max(SlotsPerRow, 1);
 
    int32 Index = 0;
 
    for (const FTrackedSlot& Tracked : TrackedSlots)
    {
        if (Tracked.Slot.IsValid() == false)
        {
            continue;
        }
 
        UUniformGridSlot* GridSlot = Cast<UUniformGridSlot>(Tracked.Slot->Slot);
 
        if (GridSlot == nullptr)
        {
            continue;
        }
 
        GridSlot->SetRow(Index / ColumnCount);
        GridSlot->SetColumn(Index % ColumnCount);
 
        ++Index;
    }
}

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

멤버 데이터 문서화

BuffSlotClass

TSubclassOf<UConstellationBuffSlotWidget> UConstellationBuffHUDWidget::BuffSlotClass

protected

BuffSlotContainer

TObjectPtr<UPanelWidget> UConstellationBuffHUDWidget::BuffSlotContainer

protected

SlotsPerRow

int32 UConstellationBuffHUDWidget::SlotsPerRow = 5

protected

TrackedSlots

TArray<FTrackedSlot> UConstellationBuffHUDWidget::TrackedSlots

private

---

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

• Source/CK_UE/UI/HUD/Constellation/ConstellationBuffHUDWidget.h
• Source/CK_UE/UI/HUD/Constellation/ConstellationBuffHUDWidget.cpp