#include <CompassWidget.h>

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

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

Public 멤버 함수
UImage *	AddCompassMarker (ECompassMarkerType MarkerType)

UTexture2D *	GetTextureForMarkerType (ECompassMarkerType MarkerType)

void	RotateCompass (float ZRotation)

void	SetMarkerDistance (UImage *InMarker, float Distance)
	마커 거리 설정 (미터 단위)

void	SetMarkerPosition (UImage *InMarker, float TargetRotation, bool bSideLock)

void	SetMarkerVisibility (UImage *InMarker, ESlateVisibility InVisibility)
	마커와 거리 텍스트의 Visibility 동시 설정

Public 속성
class UImage *	Img_Compass

TMap< UImage , class UTextBlock >	MarkerDistanceMap
	마커별 거리 텍스트 매핑

TArray< UImage * >	Markers

TMap< ECompassMarkerType, UTexture2D * >	MarkerTextureMap

class UCanvasPanel *	Pnl_Compass

Protected 멤버 함수
virtual void	NativeConstruct () override

상세한 설명

CompassWidget.h 파일의 25 번째 라인에서 정의되었습니다.

멤버 함수 문서화

◆ AddCompassMarker()

UImage * UCompassWidget::AddCompassMarker ( ECompassMarkerType MarkerType )

CompassWidget.cpp 파일의 44 번째 라인에서 정의되었습니다.

{
    UImage* NewMarker = NewObject<UImage>(this);
    if (NewMarker)
    {
        UTexture2D* CompassTex = GetTextureForMarkerType(MarkerType);
        if (CompassTex)
        {
            NewMarker->SetBrushFromTexture(CompassTex);
        }
 
        Pnl_Compass->AddChild(NewMarker);
 
        UCanvasPanelSlot* MarkerSlot = Cast<UCanvasPanelSlot>(NewMarker->Slot);
        if (MarkerSlot)
        {
            MarkerSlot->SetAnchors(FAnchors(0.5, 0.5, 0.5, 0.5));
            MarkerSlot->SetSize(FVector2D(60.f, 60.f));
            MarkerSlot->SetAlignment(FVector2D(0.5f, 0.5f));
            MarkerSlot->SetPosition(FVector2D(0.f, 0.f));
        }
 
        // 거리 텍스트 생성
        UTextBlock* DistanceText = NewObject<UTextBlock>(this);
        if (DistanceText)
        {
            Pnl_Compass->AddChild(DistanceText);
 
            UCanvasPanelSlot* TextSlot = Cast<UCanvasPanelSlot>(DistanceText->Slot);
            if (TextSlot)
            {
                TextSlot->SetAnchors(FAnchors(0.5, 0.5, 0.5, 0.5));
                TextSlot->SetSize(FVector2D(100.f, 20.f));
                TextSlot->SetAlignment(FVector2D(0.5f, -0.8f)); // 하단 중앙 정렬
                TextSlot->SetPosition(FVector2D(0.f, -5.f)); // 마커 위에 배치
                TextSlot->SetZOrder(100); // 최상위로 설정
            }
 
            // 텍스트 스타일 설정
            FSlateFontInfo FontInfo = DistanceText->GetFont();
            FontInfo.Size = 14;
            DistanceText->SetFont(FontInfo);
            DistanceText->SetJustification(ETextJustify::Center);
            DistanceText->SetColorAndOpacity(FLinearColor::White);
            DistanceText->SetText(FText::FromString(TEXT("0m")));
            DistanceText->SetVisibility(ESlateVisibility::Visible);
 
            // 텍스트에 그림자 추가 (가독성 향상)
            DistanceText->SetShadowOffset(FVector2D(1.f, 1.f));
            DistanceText->SetShadowColorAndOpacity(FLinearColor::Black);
 
            MarkerDistanceMap.Add(NewMarker, DistanceText);
        }
 
        Markers.Add(NewMarker);
 
        return NewMarker;
    }
 
    return nullptr;
}

다음을 참조함 : GetTextureForMarkerType(), MarkerDistanceMap, Markers, Pnl_Compass.

다음에 의해서 참조됨 : APlayerActor::UpdateCompassMarkers().

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

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

◆ GetTextureForMarkerType()

UTexture2D * UCompassWidget::GetTextureForMarkerType ( ECompassMarkerType MarkerType )

CompassWidget.cpp 파일의 106 번째 라인에서 정의되었습니다.

{
    UTexture2D** FoundTexture = MarkerTextureMap.Find(MarkerType);
    if (FoundTexture && *FoundTexture)
    {
        return *FoundTexture;
    }
 
    return LoadObject<UTexture2D>(nullptr, TEXT("/Game/StarterBundle/Image/mark1.mark1"));
}

다음을 참조함 : MarkerTextureMap.

다음에 의해서 참조됨 : AddCompassMarker(), APlayerActor::UpdateCompassMarkers().

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

◆ NativeConstruct()

void UCompassWidget::NativeConstruct ( )

overrideprotectedvirtual

CompassWidget.cpp 파일의 11 번째 라인에서 정의되었습니다.

{
    Super::NativeConstruct();
 
    if (MarkerTextureMap.Num() == 0)
    {
        MarkerTextureMap.Add(ECompassMarkerType::QuestStart,
            LoadObject<UTexture2D>(nullptr, TEXT("/Game/CustomContents/UI/Texture/Resource/Icon_Listen.Icon_Listen")));
        MarkerTextureMap.Add(ECompassMarkerType::QuestEnd,
            LoadObject<UTexture2D>(nullptr, TEXT("/Game/StarterBundle/Image/mark1.mark1")));
        MarkerTextureMap.Add(ECompassMarkerType::Wheatly,
            LoadObject<UTexture2D>(nullptr, TEXT("/Game/CustomContents/UI/Texture/Resource/Icon_Whitney.Icon_Whitney")));
        MarkerTextureMap.Add(ECompassMarkerType::Teleporter,
            LoadObject<UTexture2D>(nullptr, TEXT("/Game/CustomContents/UI/Texture/Resource/resource_score.resource_score")));
        MarkerTextureMap.Add(ECompassMarkerType::FinalResult,
            LoadObject<UTexture2D>(nullptr, TEXT("/Game/CustomContents/UI/Texture/Resource/Icon_Overall.Icon_Overall")));
        MarkerTextureMap.Add(ECompassMarkerType::OtherPlayer,
            LoadObject<UTexture2D>(nullptr, TEXT("/Game/CustomContents/UI/Texture/Resource/Icon_RedOwl.Icon_RedOwl")));
    }
}

다음을 참조함 : FinalResult, MarkerTextureMap, OtherPlayer, QuestEnd, QuestStart, Teleporter, Wheatly.

◆ RotateCompass()

void UCompassWidget::RotateCompass ( float ZRotation )

CompassWidget.cpp 파일의 32 번째 라인에서 정의되었습니다.

{
    FVector2D DesiredSize = Img_Compass->GetDesiredSize();
    
    UCanvasPanelSlot* CanvasSlot = Cast<UCanvasPanelSlot>(Img_Compass->Slot);
    if (CanvasSlot)
    {
        float PositionX = -ZRotation * (DesiredSize.X / 360.f);
        CanvasSlot->SetPosition(FVector2D(PositionX, 0.f));
    }
}

다음을 참조함 : Img_Compass.

다음에 의해서 참조됨 : APlayerActor::Tick().

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

◆ SetMarkerDistance()

void UCompassWidget::SetMarkerDistance	(	UImage *	InMarker,
		float	Distance
	)

마커 거리 설정 (미터 단위)

CompassWidget.cpp 파일의 168 번째 라인에서 정의되었습니다.

{
    if (UTextBlock** FoundText = MarkerDistanceMap.Find(InMarker))
    {
        // 거리를 미터 단위로 변환 (언리얼은 센티미터 단위)
        float DistanceInMeters = Distance / 100.f;
 
        FString DistanceStr;
        if (DistanceInMeters >= 1000.f)
        {
            // 1km 이상이면 km 단위로 표시
            DistanceStr = FString::Printf(TEXT("%.1fkm"), DistanceInMeters / 1000.f);
        }
        else
        {
            // 1m 이상이면 m 단위로 표시
            DistanceStr = FString::Printf(TEXT("%.0fm"), DistanceInMeters);
        }
 
        (*FoundText)->SetText(FText::FromString(DistanceStr));
    }
}

다음을 참조함 : MarkerDistanceMap.

다음에 의해서 참조됨 : APlayerActor::UpdateCompassMarkers().

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

◆ SetMarkerPosition()

void UCompassWidget::SetMarkerPosition	(	UImage *	InMarker,
		float	TargetRotation,
		bool	bSideLock
	)

CompassWidget.cpp 파일의 117 번째 라인에서 정의되었습니다.

{
    float CompassSize = Img_Compass->GetDesiredSize().X;
    float MarkerRotation = TargetRotation * (CompassSize/360.f);
 
    UCanvasPanelSlot* MarkerSlot = Cast<UCanvasPanelSlot>(InMarker->Slot);
    if (MarkerSlot)
    {
        FVector2D FinalPosition = FVector2D::ZeroVector;
 
        if (!bSideLock)
        {
            FinalPosition = FVector2D(MarkerRotation, 0.f);
            MarkerSlot->SetPosition(FinalPosition);
        }
        else
        {
            UCanvasPanelSlot* CompassSlot = Cast<UCanvasPanelSlot>(Pnl_Compass->Slot);
            if (CompassSlot)
            {
                float PositionX = (CompassSlot->GetSize().X / 2);
 
                if (FMath::Abs(MarkerRotation) < PositionX)
                {
                    FinalPosition = FVector2D(MarkerRotation, 0.f);
                }
                else if (MarkerRotation > PositionX)
                {
                    FinalPosition = FVector2D(PositionX, 0.f);
                }
                else
                {
                    FinalPosition = FVector2D(-PositionX, 0.f);
                }
 
                MarkerSlot->SetPosition(FinalPosition);
            }
        }
 
        // 거리 텍스트도 같이 이동
        if (UTextBlock** FoundText = MarkerDistanceMap.Find(InMarker))
        {
            UCanvasPanelSlot* TextSlot = Cast<UCanvasPanelSlot>((*FoundText)->Slot);
            if (TextSlot)
            {
                TextSlot->SetPosition(FVector2D(FinalPosition.X, -5.f)); // 마커 위에 배치
            }
        }
    }
}

다음을 참조함 : Img_Compass, MarkerDistanceMap, Pnl_Compass.

다음에 의해서 참조됨 : APlayerActor::UpdateCompassMarkers().

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

◆ SetMarkerVisibility()

void UCompassWidget::SetMarkerVisibility	(	UImage *	InMarker,
		ESlateVisibility	InVisibility
	)

마커와 거리 텍스트의 Visibility 동시 설정

CompassWidget.cpp 파일의 191 번째 라인에서 정의되었습니다.

{
    if (InMarker)
    {
        InMarker->SetVisibility(InVisibility);
    }
 
    // 거리 텍스트도 같은 Visibility 적용
    if (UTextBlock** FoundText = MarkerDistanceMap.Find(InMarker))
    {
        if (*FoundText)
        {
            (*FoundText)->SetVisibility(InVisibility);
        }
    }
}

다음을 참조함 : MarkerDistanceMap.

다음에 의해서 참조됨 : APlayerActor::UpdateCompassMarkers().

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

멤버 데이터 문서화

◆ Img_Compass

class UImage* UCompassWidget::Img_Compass

CompassWidget.h 파일의 37 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : RotateCompass(), SetMarkerPosition().

◆ MarkerDistanceMap

TMap<UImage*, class UTextBlock*> UCompassWidget::MarkerDistanceMap

마커별 거리 텍스트 매핑

CompassWidget.h 파일의 50 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : AddCompassMarker(), SetMarkerDistance(), SetMarkerPosition(), SetMarkerVisibility().

◆ Markers

TArray<UImage*> UCompassWidget::Markers

CompassWidget.h 파일의 43 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : AddCompassMarker().

◆ MarkerTextureMap

TMap<ECompassMarkerType, UTexture2D*> UCompassWidget::MarkerTextureMap

CompassWidget.h 파일의 46 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : GetTextureForMarkerType(), NativeConstruct().

◆ Pnl_Compass

class UCanvasPanel* UCompassWidget::Pnl_Compass

CompassWidget.h 파일의 34 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : AddCompassMarker(), SetMarkerPosition().

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

Source/Onepiece/UI/Public/CompassWidget.h
Source/Onepiece/UI/Private/CompassWidget.cpp

Public 멤버 함수

Public 속성

Protected 멤버 함수

상세한 설명

멤버 함수 문서화

◆ AddCompassMarker()

◆ GetTextureForMarkerType()

◆ NativeConstruct()

◆ RotateCompass()

◆ SetMarkerDistance()

◆ SetMarkerPosition()

◆ SetMarkerVisibility()

멤버 데이터 문서화

◆ Img_Compass

◆ MarkerDistanceMap

◆ Markers

◆ MarkerTextureMap

◆ Pnl_Compass