CardWidget.h

이 파일의 문서화 페이지로 가기

// Fill out your copyright notice in the Description page of Project Settings.
 
#pragma once
 
#include "CoreMinimal.h"
#include "UI/UserWidgetBase.h"
#include "CardWidget.generated.h"
 
enum class ESituationTag : uint8;
 
class UWrapBox;
class UCardTagWidget;
class UButton;
class UImage;
class UCardWidget;
class USituationBase;
class UTextBlock;
class UTexture2D;
 
 
DECLARE_MULTICAST_DELEGATE_OneParam(FOnSituationCardChosen, UCardWidget* /*Card*/);
 
UCLASS()
class CK_UE_API UCardWidget : public UUserWidgetBase
{
    GENERATED_BODY()
 
public:
    void SetupCard(USituationBase* InSituation, UTexture2D* InIllustration);
 
public:
    // 아래 세 개는 USituationBase 의 완전한 형식이 필요해 .cpp 에서 정의한다.
    USituationBase* GetSituation() const;
 
    // 상황이 비어 있으면 NAME_None.
    FName GetSituationID() const;
 
    // 이 카드의 방송 태그. 상황이 비어 있으면 ESituationTag::None.
    ESituationTag GetBroadcastTags() const;
 
public:
    // SetupCard 로 받은 아이콘. 선택 진행 표시가 같은 그림을 그대로 쓰기 위해 노출한다.
    FORCEINLINE UTexture2D* GetIconTexture() const
    {
        return IconTexture;
    }
 
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;
 
protected:
    UFUNCTION(BlueprintImplementableEvent, Category = "UI|Situation")
    void OnCardSetup();
 
    UFUNCTION()
    void HandleChooseClicked();
 
    // 상황이 가진 방송 태그를 CardTags 에 나열한다.
    void SetupCardTags();
 
protected:
    // 커서 위치를 카드 중심 기준 -1 ~ 1 로 정규화해 보관한다.
    void UpdateCursorOffset(const FGeometry& InGeometry, const FPointerEvent& InMouseEvent);
 
    // 목표 변형값을 현재 값으로 부드럽게 따라가게 한다. 매 프레임 호출.
    void UpdateHoverTransform(float InDeltaTime);
 
public:
    FOnSituationCardChosen OnCardChosen;
 
protected:
    UPROPERTY(BlueprintReadOnly, Category = "UI|Situation", meta = (BindWidget))
    TObjectPtr<UImage> SituationIcon;
 
    UPROPERTY(BlueprintReadOnly, Category = "UI|Situation", meta = (BindWidget))
    TObjectPtr<UImage> SituationIllustration;
 
    UPROPERTY(BlueprintReadOnly, Category = "UI|Situation", meta = (BindWidget))
    TObjectPtr<UTextBlock> SituationNameText;
 
    UPROPERTY(BlueprintReadOnly, Category = "UI|Situation", meta = (BindWidget))
    TObjectPtr<UWrapBox> CardTags;
 
    UPROPERTY(BlueprintReadOnly, Category = "UI|Situation", meta = (BindWidget))
    TObjectPtr<UTextBlock> SituationDescriptionText;
 
protected:
    // 커서를 올렸을 때 카드가 커지는 배율.
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "UI|Situation|Hover")
    float HoverScale = 1.08f;
 
    // 커서가 카드 좌우 끝에 있을 때의 최대 회전각(도).
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "UI|Situation|Hover")
    float MaxTiltAngle = 6.0f;
 
    // 커서의 세로 위치로 만드는 최대 기울임(도). 카드가 앞뒤로 눕는 듯한 입체감을 준다.
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "UI|Situation|Hover")
    float MaxShearAngle = 4.0f;
 
    // 커서가 멈춰 있어도 계속 도는 좌우 흔들림의 진폭(도)과 속도.
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "UI|Situation|Hover")
    float IdleSwayAngle = 1.5f;
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "UI|Situation|Hover")
    float IdleSwaySpeed = 2.5f;
 
    // 목표값을 따라가는 속도. 클수록 즉각적이고 작을수록 늘어진다.
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "UI|Situation|Hover")
    float TransformInterpSpeed = 12.0f;
 
protected:
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "UI|Situation")
    TSubclassOf<UCardTagWidget> CardTagClass;
 
    // 표 행 사본 대신 상황 인스턴스를 든다.
    // 카드가 떠 있는 동안 후보가 GC 되지 않게 강참조로 잡는다.
    UPROPERTY(Transient, BlueprintReadOnly, Category = "UI|Situation")
    TObjectPtr<USituationBase> Situation;
 
    // 표시 중인 아이콘 텍스처. 브러시에서 되꺼내지 않고 받은 그대로 들고 있는다.
    UPROPERTY(Transient, BlueprintReadOnly, Category = "UI|Situation")
    TObjectPtr<UTexture2D> IconTexture;
 
protected:
    // 카드 중심을 0 으로 둔 커서 위치. 좌상단이 (-1, -1), 우하단이 (1, 1).
    FVector2D CursorOffset = FVector2D::ZeroVector;
 
    // 지금 화면에 적용 중인 변형. 매 프레임 목표값으로 보간한다.
    FVector2D CurrentScale = FVector2D::UnitVector;
    FVector2D CurrentShear = FVector2D::ZeroVector;
    float CurrentAngle = 0.0f;
 
    // 흔들림 위상. 카드마다 다르게 시작해 세 장이 한 몸처럼 움직이지 않게 한다.
    float SwayTime = 0.0f;
 
    uint8 bHovered : 1 = false;
};