ATrolley 클래스 참조

#include <Trolley.h>

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

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

Public 멤버 함수
	ATrolley ()
virtual void	Tick (float DeltaTime) override

Public 속성
float	CollisionPushMultiplier = 0.5f
	충돌 시 추가되는 힘의 배율 (PushForce 대비)
float	Deceleration = 300.0f
	감속도 (cm/s²)
TObjectPtr< class UInteractableComponent >	InteractableComp
	상호작용 컴포넌트
TObjectPtr< class UStaticMeshComponent >	MeshComp
	수레 메시
float	MinVelocityThreshold = 5.0f
	정지 판정 속도 임계값 (cm/s)
float	PushForce = 500.0f
	밀었을 때 추가되는 힘 (cm/s)

Protected 멤버 함수
virtual void	BeginPlay () override

Private 멤버 함수
void	OnOutlineStateChanged (bool bShouldShowOutline)
	InteractableComponent의 아웃라인 상태 변경 이벤트 핸들러
void	OnPushed (AActor *Interactor)
	플레이어가 수레를 밀었을 때 호출
void	OnTrolleyHit (UPrimitiveComponent *HitComponent, AActor *OtherActor, UPrimitiveComponent *OtherComp, FVector NormalImpulse, const FHitResult &Hit)
	수레 메시에 충돌이 발생했을 때 호출

Private 속성
FVector	CurrentVelocity
	현재 속도 벡터

상세한 설명

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

생성자 & 소멸자 문서화

ATrolley()

ATrolley::ATrolley

(

)

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

{
    // Set this actor to call Tick() every frame.  You can turn this off to improve performance if you don't need it.
    PrimaryActorTick.bCanEverTick = true;
 
    // Create root mesh component
    MeshComp = CreateDefaultSubobject<UStaticMeshComponent>(TEXT("MeshComp"));
    RootComponent = MeshComp;
    MeshComp->SetSimulatePhysics(false); // Custom velocity control, no physics simulation
    MeshComp->SetCollisionEnabled(ECollisionEnabled::QueryAndPhysics);
    MeshComp->SetCollisionProfileName(TEXT("BlockAllDynamic")); // Block physics objects like Food
    MeshComp->SetMobility(EComponentMobility::Movable); // Must be movable to change location at runtime
    MeshComp->SetNotifyRigidBodyCollision(true); // Enable hit events for OnComponentHit
 
    // Create interactable component
    InteractableComp = CreateDefaultSubobject<UInteractableComponent>(TEXT("InteractableComp"));
    InteractableComp->InteractionType = EInteractionType::Button; // Use Button type for pushing
    InteractableComp->InteractionPrompt = TEXT("Press E to Push");
 
    // Initialize velocity
    CurrentVelocity = FVector::ZeroVector;
}

다음을 참조함 : CurrentVelocity, InteractableComp, MeshComp.

멤버 함수 문서화

BeginPlay()

void ATrolley::BeginPlay ( )

overrideprotectedvirtual

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

{
    Super::BeginPlay();
 
    // Bind interaction delegate
    if (InteractableComp)
    {
        InteractableComp->OnInteractionTriggered.AddDynamic(this, &ATrolley::OnPushed);
        InteractableComp->OnOutlineStateChanged.AddDynamic(this, &ATrolley::OnOutlineStateChanged);
    }
 
    // Bind collision delegate
    if (MeshComp)
    {
        MeshComp->OnComponentHit.AddDynamic(this, &ATrolley::OnTrolleyHit);
    }
}

다음을 참조함 : InteractableComp, MeshComp, OnOutlineStateChanged(), OnPushed(), OnTrolleyHit().

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

OnOutlineStateChanged()

void ATrolley::OnOutlineStateChanged ( bool  bShouldShowOutline )

private

InteractableComponent의 아웃라인 상태 변경 이벤트 핸들러

매개변수

bShouldShowOutline

[in] true면 아웃라인 표시, false면 숨김

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

{
    if (MeshComp)
    {
        MeshComp->SetRenderCustomDepth(bShouldShowOutline);
    }
}

다음을 참조함 : MeshComp.

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

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

OnPushed()

void ATrolley::OnPushed ( AActor *  Interactor )

private

플레이어가 수레를 밀었을 때 호출

매개변수

Interactor

상호작용한 액터 (플레이어)

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

{
    if (!Interactor) return;
 
    // Get push direction from interactor's forward vector
    FVector PushDirection = Interactor->GetActorForwardVector();
    PushDirection.Z = 0.0f; // Keep it parallel to ground
    PushDirection.Normalize();
 
    // Add velocity in push direction
    CurrentVelocity += PushDirection * PushForce;
}

다음을 참조함 : CurrentVelocity, PushForce.

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

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

OnTrolleyHit()

void ATrolley::OnTrolleyHit ( UPrimitiveComponent *  HitComponent, AActor *  OtherActor, UPrimitiveComponent *  OtherComp, FVector  NormalImpulse, const FHitResult &  Hit  )

private

수레 메시에 충돌이 발생했을 때 호출

매개변수

HitComponent	충돌한 컴포넌트
OtherActor	충돌한 다른 액터
OtherComp	충돌한 다른 컴포넌트
NormalImpulse	충돌 임펄스
Hit	충돌 정보

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

{
    if (!OtherActor)
        return;
 
    // Check if the other actor is a player character
    ACharacter* Character = Cast<ACharacter>(OtherActor);
    if (!Character || !Character->IsPlayerControlled())
        return;
 
    // Calculate push direction (from player to trolley)
    FVector PushDirection = GetActorLocation() - OtherActor->GetActorLocation();
    PushDirection.Z = 0.0f; // Keep it parallel to ground
    PushDirection.Normalize();
 
    // Add velocity in push direction with reduced force
    CurrentVelocity += PushDirection * PushForce * CollisionPushMultiplier;
}

다음을 참조함 : CollisionPushMultiplier, CurrentVelocity, PushForce.

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

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

Tick()

void ATrolley::Tick ( float  DeltaTime )

overridevirtual

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

{
    Super::Tick(DeltaTime);
 
    // Check if moving
    if (CurrentVelocity.SizeSquared() > MinVelocityThreshold * MinVelocityThreshold)
    {
        // Keep velocity parallel to ground (ignore Z axis)
        FVector HorizontalVelocity = CurrentVelocity;
        HorizontalVelocity.Z = 0.0f;
 
        // Calculate movement delta
        FVector DeltaMovement = HorizontalVelocity * DeltaTime;
 
        // Move the trolley
        FVector OldLocation = GetActorLocation();
        FVector NewLocation = OldLocation + DeltaMovement;
        SetActorLocation(NewLocation, true); // true = sweep for collision
 
        // Apply deceleration
        FVector DecelerationVector = HorizontalVelocity.GetSafeNormal() * Deceleration * DeltaTime;
        CurrentVelocity -= DecelerationVector;
 
        // Stop if velocity is too small
        if (CurrentVelocity.SizeSquared() < MinVelocityThreshold * MinVelocityThreshold)
        {
            CurrentVelocity = FVector::ZeroVector;
        }
    }
}

다음을 참조함 : CurrentVelocity, Deceleration, MinVelocityThreshold.

멤버 데이터 문서화

CollisionPushMultiplier

float ATrolley::CollisionPushMultiplier = 0.5f

충돌 시 추가되는 힘의 배율 (PushForce 대비)

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

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

CurrentVelocity

FVector ATrolley::CurrentVelocity

private

현재 속도 벡터

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

다음에 의해서 참조됨 : ATrolley(), OnPushed(), OnTrolleyHit(), Tick().

Deceleration

float ATrolley::Deceleration = 300.0f

감속도 (cm/s²)

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

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

InteractableComp

TObjectPtr<class UInteractableComponent> ATrolley::InteractableComp

상호작용 컴포넌트

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

다음에 의해서 참조됨 : ATrolley(), BeginPlay().

MeshComp

TObjectPtr<class UStaticMeshComponent> ATrolley::MeshComp

수레 메시

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

다음에 의해서 참조됨 : ATrolley(), BeginPlay(), OnOutlineStateChanged().

MinVelocityThreshold

float ATrolley::MinVelocityThreshold = 5.0f

정지 판정 속도 임계값 (cm/s)

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

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

PushForce

float ATrolley::PushForce = 500.0f

밀었을 때 추가되는 힘 (cm/s)

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

다음에 의해서 참조됨 : OnPushed(), OnTrolleyHit().

---

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

• Source/Onepiece/Prop/Public/Trolley.h
• Source/Onepiece/Prop/Private/Trolley.cpp