UCardWidget 클래스 참조

#include <CardWidget.h>

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

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

Public 멤버 함수
void	SetupCard (USituationBase *InSituation, UTexture2D *InIllustration)
USituationBase *	GetSituation () const
FName	GetSituationID () const
ESituationTag	GetBroadcastTags () const
FORCEINLINE UTexture2D *	GetIconTexture () const
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

Public 속성
FOnSituationCardChosen	OnCardChosen

Protected 멤버 함수
virtual void	NativeConstruct () override
virtual void	NativeTick (const FGeometry &MyGeometry, float InDeltaTime) override
virtual void	NativeOnMouseEnter (const FGeometry &InGeometry, const FPointerEvent &InMouseEvent) override
virtual void	NativeOnMouseLeave (const FPointerEvent &InMouseEvent) override
virtual FReply	NativeOnMouseMove (const FGeometry &InGeometry, const FPointerEvent &InMouseEvent) override
virtual FReply	NativeOnMouseButtonDown (const FGeometry &InGeometry, const FPointerEvent &InMouseEvent) override
virtual FReply	NativeOnMouseButtonUp (const FGeometry &InGeometry, const FPointerEvent &InMouseEvent) override
void	OnCardSetup ()
void	HandleChooseClicked ()
void	SetupCardTags ()
void	UpdateCursorOffset (const FGeometry &InGeometry, const FPointerEvent &InMouseEvent)
void	UpdateHoverTransform (float InDeltaTime)
UUserWidgetBase(으)로부터 상속된 Protected 멤버 함수
virtual void	OnWidgetActivated ()
virtual void	OnWidgetDeactivated ()
void	OnPushedToLayer_Internal ()
void	OnPoppedFromLayer_Internal ()
void	OnActivated_Internal ()
void	OnDeactivated_Internal ()

Protected 속성
TObjectPtr< UImage >	SituationIcon
TObjectPtr< UImage >	SituationIllustration
TObjectPtr< UTextBlock >	SituationNameText
TObjectPtr< UWrapBox >	CardTags
TObjectPtr< UTextBlock >	SituationDescriptionText
float	HoverScale = 1.08f
float	MaxTiltAngle = 6.0f
float	MaxShearAngle = 4.0f
float	IdleSwayAngle = 1.5f
float	IdleSwaySpeed = 2.5f
float	TransformInterpSpeed = 12.0f
TSubclassOf< UCardTagWidget >	CardTagClass
TObjectPtr< USituationBase >	Situation
TObjectPtr< UTexture2D >	IconTexture
FVector2D	CursorOffset = FVector2D::ZeroVector
FVector2D	CurrentScale = FVector2D::UnitVector
FVector2D	CurrentShear = FVector2D::ZeroVector
float	CurrentAngle = 0.0f
float	SwayTime = 0.0f
uint8	bHovered: 1 = false
UUserWidgetBase(으)로부터 상속된 Protected 속성
EWidgetState	WidgetState
TObjectPtr< UAbilitySystemComponent >	ASC
FGameplayTag	LayerTag
bool	bPrimary = false
TObjectPtr< UWidgetAnimation >	AppearanceAnim
TObjectPtr< UWidgetAnimation >	DisappearanceAnim

상세한 설명

레벨업 선택창의 카드 한 장.

표 행을 복사해 들고 있지 않고 상황 인스턴스를 그대로 가리킨다. 이름 / 설명뿐 아니라 버프 수치와 방송 태그까지 카드가 직접 물어볼 수 있게 하기 위함이다.

멤버 함수 문서화

GetBroadcastTags()

ESituationTag UCardWidget::GetBroadcastTags

(

)

const

{
    return Situation ? Situation->GetSituationTags() : ESituationTag::None;
}

GetIconTexture()

FORCEINLINE UTexture2D * UCardWidget::GetIconTexture ( ) const

inline

    {
        return IconTexture;
    }

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

GetSituation()

USituationBase * UCardWidget::GetSituation

(

)

const

{
    return Situation;
}

GetSituationID()

FName UCardWidget::GetSituationID

(

)

const

{
    return Situation ? Situation->GetSituationID() : NAME_None;
}

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

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

HandleChooseClicked()

void UCardWidget::HandleChooseClicked ( )

protected

{
    OnCardChosen.Broadcast(this);
}

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

NativeConstruct()

void UCardWidget::NativeConstruct ( )

overrideprotectedvirtual

{
    Super::NativeConstruct();
 
    // 카드 세 장이 같은 위상으로 흔들리면 한 덩어리처럼 보인다. 시작 위상을 흩어 둔다.
    SwayTime = FMath::FRandRange(0.0f, 2.0f * PI);
 
    // 회전과 확대는 카드 중앙을 기준으로 돌아야 한다.
    SetRenderTransformPivot(FVector2D(0.5f, 0.5f));
}

NativeOnMouseButtonDown()

FReply UCardWidget::NativeOnMouseButtonDown ( const FGeometry &  InGeometry, const FPointerEvent &  InMouseEvent  )

overrideprotectedvirtual

{
    // 좌클릭만 선택으로 본다. 나머지 버튼은 상위 위젯이 처리하게 넘긴다.
    if (InMouseEvent.GetEffectingButton() != EKeys::LeftMouseButton)
    {
        return Super::NativeOnMouseButtonDown(InGeometry, InMouseEvent);
    }
 
    // 선택은 뗄 때 확정한다. 여기서는 클릭이 뒤로 새지 않게 잡아만 둔다.
    return FReply::Handled();
}

NativeOnMouseButtonUp()

FReply UCardWidget::NativeOnMouseButtonUp ( const FGeometry &  InGeometry, const FPointerEvent &  InMouseEvent  )

overrideprotectedvirtual

{
    if (InMouseEvent.GetEffectingButton() != EKeys::LeftMouseButton)
    {
        return Super::NativeOnMouseButtonUp(InGeometry, InMouseEvent);
    }
 
    // 이 이벤트는 커서가 카드 위에 있을 때만 온다. 눌렀다가 밖에서 떼면 선택되지 않는다.
    HandleChooseClicked();
    return FReply::Handled();
}

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

NativeOnMouseEnter()

void UCardWidget::NativeOnMouseEnter ( const FGeometry &  InGeometry, const FPointerEvent &  InMouseEvent  )

overrideprotectedvirtual

{
    Super::NativeOnMouseEnter(InGeometry, InMouseEvent);
 
    bHovered = true;
    UpdateCursorOffset(InGeometry, InMouseEvent);
}

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

NativeOnMouseLeave()

void UCardWidget::NativeOnMouseLeave ( const FPointerEvent &  InMouseEvent )

overrideprotectedvirtual

{
    Super::NativeOnMouseLeave(InMouseEvent);
 
    // 목표값만 되돌린다. 실제 복귀는 Tick 의 보간이 맡아 뚝 끊기지 않는다.
    bHovered = false;
    CursorOffset = FVector2D::ZeroVector;
}

NativeOnMouseMove()

FReply UCardWidget::NativeOnMouseMove ( const FGeometry &  InGeometry, const FPointerEvent &  InMouseEvent  )

overrideprotectedvirtual

{
    UpdateCursorOffset(InGeometry, InMouseEvent);
 
    // 이동 자체는 소비하지 않는다. 상위 위젯의 처리를 막지 않기 위함.
    return Super::NativeOnMouseMove(InGeometry, InMouseEvent);
}

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

NativeTick()

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

overrideprotectedvirtual

{
    Super::NativeTick(MyGeometry, InDeltaTime);
 
    UpdateHoverTransform(InDeltaTime);
}

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

OnCardSetup()

void UCardWidget::OnCardSetup ( )

protected

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

SetupCard()

void UCardWidget::SetupCard	(	USituationBase *	InSituation,
		UTexture2D *	InIllustration
	)

{
    Situation = InSituation;
 
    if (Situation == nullptr)
    {
        LOG_WARNING(LogCK, "상황이 비어 있어 카드를 채울 수 없습니다.");
        return;
    }
 
    const FDT_SituationTable& SituationData = Situation->GetSituationData();
 
    // UserWidget 기본값은 SelfHitTestInvisible 이라 그대로는 마우스 이벤트가 카드까지 오지 않는다.
    // 뒤에 불리는 OnCardSetup 에서 BP 가 다시 바꿀 수 있다.
    SetVisibility(ESlateVisibility::Visible);
 
    if (SituationIcon)
    {
        IconTexture = InSituation->GetSituationIcon();
        ensureAlwaysMsgf(IconTexture, TEXT("%s이 정상적으로 가져와지지 않았습니다. "), NAMEOF_VAR(IconTexture));
        SituationIcon->SetBrushFromTexture(IconTexture);
    }
 
    if (SituationIllustration)
    {
        SituationIllustration->SetBrushFromTexture(InIllustration);
        SituationIllustration->SetVisibility(ESlateVisibility::HitTestInvisible);
    }
 
    if (SituationNameText)
    {
        SituationNameText->SetText(SituationData.Name);
    }
 
    if (SituationDescriptionText)
    {
        // {{name1}} / {{value1}} 치환자를 현재 무기 기준 수치로 채운다.
        SituationDescriptionText->SetText(Situation->BuildBuffDescription(GetOwningPlayer()));
    }
 
    SetupCardTags();
    OnCardSetup();
}

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

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

SetupCardTags()

void UCardWidget::SetupCardTags ( )

protected

{
    if (CardTags == nullptr)
    {
        return;
    }
 
    // 카드는 재사용될 수 있으므로 이전 태그를 먼저 걷어낸다.
    CardTags->ClearChildren();
 
    if (CardTagClass == nullptr)
    {
        LOG_WARNING(LogCK, "%s 가 비어 있어 카드 태그를 만들 수 없습니다.", NAMEOF_VAR(CardTagClass));
        return;
    }
 
    TArray<ESituationTag> Tags;
    BroadcastTag::Split(Situation->GetSituationTags(), Tags);
 
    for (const ESituationTag Tag : Tags)
    {
        UCardTagWidget* TagWidget = CreateWidget<UCardTagWidget>(GetOwningPlayer(), CardTagClass);
        TagWidget->SetupTag(Tag);
        CardTags->AddChild(TagWidget);
    }
}

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

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

UpdateCursorOffset()

void UCardWidget::UpdateCursorOffset ( const FGeometry &  InGeometry, const FPointerEvent &  InMouseEvent  )

protected

{
    const FVector2D LocalSize = InGeometry.GetLocalSize();
 
    if (LocalSize.X <= 0.0 || LocalSize.Y <= 0.0)
    {
        return;
    }
 
    const FVector2D LocalPosition = InGeometry.AbsoluteToLocal(InMouseEvent.GetScreenSpacePosition());
 
    // 카드 중심을 0 으로 두고 -1 ~ 1 로 정규화한다. 카드 크기가 달라도 기울기가 같아진다.
    CursorOffset.X = FMath::Clamp(LocalPosition.X / LocalSize.X * 2.0 - 1.0, -1.0, 1.0);
    CursorOffset.Y = FMath::Clamp(LocalPosition.Y / LocalSize.Y * 2.0 - 1.0, -1.0, 1.0);
}

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

UpdateHoverTransform()

void UCardWidget::UpdateHoverTransform ( float  InDeltaTime )

protected

{
    const bool bAtRest = CurrentScale.Equals(FVector2D::UnitVector, 0.001) && CurrentShear.IsNearlyZero(0.001) && FMath::IsNearlyZero(CurrentAngle, 0.01f);
 
    // 커서도 없고 이미 원래 크기로 돌아왔으면 손대지 않는다. 매 프레임 변형을 다시 넣으면 카드가 계속 다시 그려진다.
    if (bHovered == false && bAtRest)
    {
        return;
    }
 
    SwayTime += InDeltaTime;
 
    // 커서가 멈춰 있어도 좌우로 천천히 흔들려, 카드가 멈춰 죽어 보이지 않게 한다.
    const float Sway = bHovered ? FMath::Sin(SwayTime * IdleSwaySpeed) * IdleSwayAngle : 0.0f;
 
    const FVector2D TargetScale = bHovered ? FVector2D(HoverScale, HoverScale) : FVector2D::UnitVector;
    const float TargetAngle = bHovered ? static_cast<float>(CursorOffset.X * MaxTiltAngle) + Sway : 0.0f;
 
    // 세로 오프셋은 회전이 아니라 기울임으로 준다. 2D 위젯이 앞뒤로 눕는 것처럼 보이게 하는 부분.
    const FVector2D TargetShear = bHovered ? FVector2D(-CursorOffset.Y * MaxShearAngle, 0.0f) : FVector2D::ZeroVector;
 
    CurrentScale = FMath::Vector2DInterpTo(CurrentScale, TargetScale, InDeltaTime, TransformInterpSpeed);
    CurrentShear = FMath::Vector2DInterpTo(CurrentShear, TargetShear, InDeltaTime, TransformInterpSpeed);
    CurrentAngle = FMath::FInterpTo(CurrentAngle, TargetAngle, InDeltaTime, TransformInterpSpeed);
 
    FWidgetTransform CardTransform;
    CardTransform.Scale = CurrentScale;
    CardTransform.Shear = CurrentShear;
    CardTransform.Angle = CurrentAngle;
 
    SetRenderTransform(CardTransform);
}

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

멤버 데이터 문서화

bHovered

uint8 UCardWidget::bHovered

protected

CardTagClass

TSubclassOf<UCardTagWidget> UCardWidget::CardTagClass

protected

CardTags

TObjectPtr<UWrapBox> UCardWidget::CardTags

protected

CurrentAngle

float UCardWidget::CurrentAngle = 0.0f

protected

CurrentScale

FVector2D UCardWidget::CurrentScale = FVector2D::UnitVector

protected

CurrentShear

FVector2D UCardWidget::CurrentShear = FVector2D::ZeroVector

protected

CursorOffset

FVector2D UCardWidget::CursorOffset = FVector2D::ZeroVector

protected

HoverScale

float UCardWidget::HoverScale = 1.08f

protected

IconTexture

TObjectPtr<UTexture2D> UCardWidget::IconTexture

protected

IdleSwayAngle

float UCardWidget::IdleSwayAngle = 1.5f

protected

IdleSwaySpeed

float UCardWidget::IdleSwaySpeed = 2.5f

protected

MaxShearAngle

float UCardWidget::MaxShearAngle = 4.0f

protected

MaxTiltAngle

float UCardWidget::MaxTiltAngle = 6.0f

protected

OnCardChosen

FOnSituationCardChosen UCardWidget::OnCardChosen

Situation

TObjectPtr<USituationBase> UCardWidget::Situation

protected

SituationDescriptionText

TObjectPtr<UTextBlock> UCardWidget::SituationDescriptionText

protected

SituationIcon

TObjectPtr<UImage> UCardWidget::SituationIcon

protected

SituationIllustration

TObjectPtr<UImage> UCardWidget::SituationIllustration

protected

SituationNameText

TObjectPtr<UTextBlock> UCardWidget::SituationNameText

protected

SwayTime

float UCardWidget::SwayTime = 0.0f

protected

TransformInterpSpeed

float UCardWidget::TransformInterpSpeed = 12.0f

protected

---

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

• Source/CK_UE/UI/Popup/Situation/CardWidget.h
• Source/CK_UE/UI/Popup/Situation/CardWidget.cpp