AGameCameraManager 클래스 참조

#include <GameCameraManager.h>

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

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

Public 멤버 함수
	AGameCameraManager ()
virtual void	UpdateCamera (float DeltaTime) override
virtual void	ApplyCameraModifiers (float DeltaTime, FMinimalViewInfo &InOutPOV) override
void	NotifyHitConfirmed ()
void	AddPostProcessBlend (const FPostProcessSettings &InSettings, float InWeight)
void	SetHitStopActive (bool bActive)
void	PlayCameraEffectSequence (ACameraEffector *Effector, UTemplateSequence *Sequence=nullptr)
void	StopCameraEffectSequence ()
bool	IsPlayingSequence () const
void	ReleaseLockOn ()
bool	IsLockingOn () const
TScriptInterface< ITargetableInterface >	GetLockOnTarget ()
APawn *	GetCameraSubjectPawn () const
FRotator	GetMovementInputRotation () const
bool	ShouldStopCameraMovement () const
bool	ShouldStopCameraRotation () const
FORCEINLINE double	GetLastHitConfirmedTime () const
FORCEINLINE UCameraZoomComponent *	GetCameraZoomComponent () const
FORCEINLINE UCameraTargetingComponent *	GetPlayerTargetingComponent () const
FORCEINLINE UCameraBehaviorComponent *	GetCameraBehaviorComponent () const
FORCEINLINE APlayerController *	GetCameraOwnerController () const
FORCEINLINE UCameraCollisionComponent *	GetCameraCollisionComponent () const
FORCEINLINE UCameraPostProcessComponent *	GetCameraPostProcessComponent () const

Public 속성
TObjectPtr< UTemplateSequence >	CameraEffectSequence
FMovieSceneSequencePlaybackSettings	SequencePlaybackSettings
float	BaseDistance = 500.0f
float	PositionBlendSeconds = 0.1f
float	RotationBlendSeconds = 0.1f
float	FOVBlendSeconds = 0.1f
float	TimeScaleBlendSeconds = 0.1f
float	LocationLagStrength = 0.35f
bool	bApplyCameraRotationLag = false

Private 멤버 함수
void	OnSequenceFinished ()
void	ExecutePendingPlay ()
void	StartPlaySequence (ACameraEffector *Effector, UTemplateSequence *TargetSequence)
void	UpdateSequencerTimeDilationCompensation ()
bool	IsCinematicViewTarget () const
void	ReleaseTimeScaleRequest ()

Private 속성
TObjectPtr< UTemplateSequencePlayer >	PreviousSequencerPlayer
TWeakObjectPtr< ATemplateSequenceActor >	PreviousSequenceActor
TObjectPtr< UTemplateSequencePlayer >	SequencePlayer
TWeakObjectPtr< ATemplateSequenceActor >	SequenceActor
TWeakObjectPtr< ACameraEffector >	BoundEffector
TWeakObjectPtr< ACameraEffector >	PendingEffector
TWeakObjectPtr< UTemplateSequence >	PendingSequence
TObjectPtr< UCameraMotionBlender >	Blender
TObjectPtr< UCameraZoomComponent >	CameraZoomComponent
TObjectPtr< UCameraTargetingComponent >	PlayerTargetingComponent
TObjectPtr< UCameraBehaviorComponent >	CameraBehaviorComponent
TObjectPtr< UCameraCollisionComponent >	CameraCollisionComponent
TObjectPtr< UCameraPostProcessComponent >	CameraPostProcessComponent
double	LastHitConfirmedTime = -1.0
bool	bHasPendingPlay = false
bool	bHitStopActive = false

생성자 & 소멸자 문서화

AGameCameraManager()

AGameCameraManager::AGameCameraManager

(

)

{
    PrimaryActorTick.bCanEverTick = true;
 
    Blender = CreateDefaultSubobject<UCameraMotionBlender>(TEXT("MotionBlender"));
    CameraZoomComponent = CreateDefaultSubobject<UCameraZoomComponent>(TEXT("CameraDistance"));
    PlayerTargetingComponent = CreateDefaultSubobject<UCameraTargetingComponent>(TEXT("PlayerTargeting"));
    CameraBehaviorComponent = CreateDefaultSubobject<UCameraBehaviorComponent>(TEXT("CameraBehavior"));
    CameraCollisionComponent = CreateDefaultSubobject<UCameraCollisionComponent>(TEXT("CameraCollision"));
    CameraPostProcessComponent = CreateDefaultSubobject<UCameraPostProcessComponent>(TEXT("CameraPostProcess"));
}

멤버 함수 문서화

AddPostProcessBlend()

void AGameCameraManager::AddPostProcessBlend	(	const FPostProcessSettings &	InSettings,
		float	InWeight
	)

{
    FPostProcessSettings Settings = InSettings;
    AddCachedPPBlend(Settings, InWeight);
}

ApplyCameraModifiers()

void AGameCameraManager::ApplyCameraModifiers ( float  DeltaTime, FMinimalViewInfo &  InOutPOV  )

overridevirtual

{
    // 시네마틱 ViewTarget 이면 InOutPOV 가 이미 시네카메라의 POV — 가공하지 않고 그대로 통과시킴.
    if (IsCinematicViewTarget())
    {
        Super::ApplyCameraModifiers(DeltaTime, InOutPOV);
        return;
    }
 
    if (UCameraBehaviorComponent* BehaviorComponent = GetCameraBehaviorComponent())
    {
        SetCameraCachePOV(InOutPOV);
        BehaviorComponent->UpdateCameraBehavior(this, DeltaTime);
        InOutPOV = GetCameraCacheView();
    }
 
    Super::ApplyCameraModifiers(DeltaTime, InOutPOV);
}

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

ExecutePendingPlay()

void AGameCameraManager::ExecutePendingPlay ( )

private

{
    if (PreviousSequencerPlayer != nullptr)
    {
        PreviousSequencerPlayer->Stop();
    }
 
    PreviousSequencerPlayer = nullptr;
 
    if (PreviousSequenceActor.IsValid())
    {
        PreviousSequenceActor->Destroy();
    }
 
    PreviousSequenceActor = nullptr;
 
    if (bHasPendingPlay && PendingEffector.IsValid() && PendingSequence.IsValid())
    {
        StartPlaySequence(PendingEffector.Get(), PendingSequence.Get());
    }
 
    bHasPendingPlay = false;
    PendingEffector = nullptr;
    PendingSequence = nullptr;
}

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

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

GetCameraBehaviorComponent()

FORCEINLINE UCameraBehaviorComponent * AGameCameraManager::GetCameraBehaviorComponent ( ) const

inline

    {
        return CameraBehaviorComponent;
    }

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

GetCameraCollisionComponent()

FORCEINLINE UCameraCollisionComponent * AGameCameraManager::GetCameraCollisionComponent ( ) const

inline

    {
        return CameraCollisionComponent;
    }

GetCameraOwnerController()

FORCEINLINE APlayerController * AGameCameraManager::GetCameraOwnerController ( ) const

inline

    {
        return PCOwner;
    }

GetCameraPostProcessComponent()

FORCEINLINE UCameraPostProcessComponent * AGameCameraManager::GetCameraPostProcessComponent ( ) const

inline

    {
        return CameraPostProcessComponent;
    }

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

GetCameraSubjectPawn()

APawn * AGameCameraManager::GetCameraSubjectPawn

(

)

const

{
    if (PCOwner == nullptr)
    {
        return nullptr;
    }
    else
    {
        return PCOwner->GetPawn();
    }
}

GetCameraZoomComponent()

FORCEINLINE UCameraZoomComponent * AGameCameraManager::GetCameraZoomComponent ( ) const

inline

    {
        return CameraZoomComponent;
    }

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

GetLastHitConfirmedTime()

FORCEINLINE double AGameCameraManager::GetLastHitConfirmedTime ( ) const

inline

    {
        return LastHitConfirmedTime;
    }

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

GetLockOnTarget()

TScriptInterface< ITargetableInterface > AGameCameraManager::GetLockOnTarget

(

)

{
    if (UCameraTargetingComponent* Comp = GetPlayerTargetingComponent())
    {
        return Comp->GetCurrentTarget();
    }
    else
    {
        return nullptr;
    }
}

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

GetMovementInputRotation()

FRotator AGameCameraManager::GetMovementInputRotation

(

)

const

{
    if (const UCameraBehaviorComponent* BehaviorComponent = GetCameraBehaviorComponent())
    {
        return BehaviorComponent->GetSmoothPlayerRotation();
    }
    else
    {
        return FRotator::ZeroRotator;
    }
}

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

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

GetPlayerTargetingComponent()

FORCEINLINE UCameraTargetingComponent * AGameCameraManager::GetPlayerTargetingComponent ( ) const

inline

    {
        return PlayerTargetingComponent;
    }

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

IsCinematicViewTarget()

bool AGameCameraManager::IsCinematicViewTarget ( ) const

private

{
    // BP 에서 Set Cinematic Mode(true) 호출 시 PCOwner->bCinematicMode 가 set 됨 — 우선 yield.
    if (PCOwner && PCOwner->bCinematicMode)
    {
        return true;
    }
 
    const AActor* VT = ViewTarget.Target;
    if (VT == nullptr)
    {
        return false;
    }
 
    // ACineCameraActor 는 ACameraActor 상속이라 한 번에 커버됨.
    return VT->IsA<ACameraActor>() || VT->IsA<ALevelSequenceActor>();
}

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

IsLockingOn()

bool AGameCameraManager::IsLockingOn

(

)

const

{
    if (const UCameraTargetingComponent* Comp = GetPlayerTargetingComponent())
    {
        return Comp && Comp->IsTargeting();
    }
    else
    {
        return false;
    }
}

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

IsPlayingSequence()

bool AGameCameraManager::IsPlayingSequence

(

)

const

{
    return SequencePlayer && SequencePlayer->IsPlaying();
}

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

NotifyHitConfirmed()

void AGameCameraManager::NotifyHitConfirmed

(

)

{
    const UWorld* World = GetWorld();
 
    if (World == nullptr)
    {
        return;
    }
 
    LastHitConfirmedTime = World->GetTimeSeconds();
}

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

OnSequenceFinished()

void AGameCameraManager::OnSequenceFinished ( )

private

{
    const TWeakObjectPtr<ATemplateSequenceActor> SequenceActorToDestroy = SequenceActor;
    const TWeakObjectPtr<ACameraEffector> EffectorToDestroy = BoundEffector;
 
    SequenceActor = nullptr;
    SequencePlayer = nullptr;
    BoundEffector = nullptr;
 
    ReleaseTimeScaleRequest();
 
    auto Lambda = [SequenceActorToDestroy, EffectorToDestroy]()
    {
        if (SequenceActorToDestroy.IsValid())
        {
            SequenceActorToDestroy->Destroy();
        }
 
        if (EffectorToDestroy.IsValid())
        {
            EffectorToDestroy->Destroy();
        }
    };
 
    FTimerManager& Manager = GetWorldTimerManager();
    Manager.SetTimerForNextTick(Lambda);
}

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

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

PlayCameraEffectSequence()

void AGameCameraManager::PlayCameraEffectSequence	(	ACameraEffector *	Effector,
		UTemplateSequence *	Sequence = nullptr
	)

{
    UTemplateSequence* TargetSequence;
 
    if (Sequence)
    {
        TargetSequence = Sequence;
    }
    else
    {
        TargetSequence = CameraEffectSequence;
    }
 
    if (TargetSequence == nullptr)
    {
        LOG_ERROR(LogCK, "재생할 %s가 없습니다.", NAMEOF(UTemplateSequence));
        return;
    }
 
    if (Effector == nullptr)
    {
        LOG_ERROR(LogCK, "%s가 유효하지 않습니다.", NAMEOF(UCameraEffectSource));
        return;
    }
 
    if (IsPlayingSequence())
    {
        // MovieScene 평가 도중 Stop/Create 충돌을 피하기 위해 다음 틱으로 지연
        PendingEffector = Effector;
        PendingSequence = TargetSequence;
        bHasPendingPlay = true;
 
        StopCameraEffectSequence();
        GetWorldTimerManager().SetTimerForNextTick(this, &AGameCameraManager::ExecutePendingPlay);
    }
    else
    {
        StartPlaySequence(Effector, TargetSequence);
    }
}

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

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

ReleaseLockOn()

void AGameCameraManager::ReleaseLockOn

(

)

{
    UCameraTargetingComponent* Comp = GetPlayerTargetingComponent();
 
    if (Comp == nullptr)
    {
        return;
    }
 
    Comp->ReleaseTargeting();
}

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

ReleaseTimeScaleRequest()

void AGameCameraManager::ReleaseTimeScaleRequest ( )

private

{
    // 이펙트가 끝났으니 자기가 늦춰둔 시간을 되돌린다.
    // 아직 멈춰 있어야 하는 쪽은 OnTimeScaleRaised 를 받아 다시 주장한다.
    if (UTimeManagementSubsystem* TimeSubsystem = GetWorld()->GetSubsystem<UTimeManagementSubsystem>())
    {
        TimeSubsystem->ResetTimeScale();
    }
}

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

SetHitStopActive()

void AGameCameraManager::SetHitStopActive

(

bool

bActive

)

{
    bHitStopActive = bActive;
}

ShouldStopCameraMovement()

bool AGameCameraManager::ShouldStopCameraMovement

(

)

const

{
    if (BoundEffector.IsValid() == false)
    {
        return false;
    }
 
    return BoundEffector->bStopMovement;
}

ShouldStopCameraRotation()

bool AGameCameraManager::ShouldStopCameraRotation

(

)

const

{
    if (BoundEffector.IsValid() == false)
    {
        return false;
    }
 
    return BoundEffector->bStopRotation;
}

StartPlaySequence()

void AGameCameraManager::StartPlaySequence ( ACameraEffector *  Effector, UTemplateSequence *  TargetSequence  )

private

{
    ATemplateSequenceActor* NewSequenceActor = nullptr;
    SequencePlayer = UTemplateSequencePlayer::CreateTemplateSequencePlayer(this, TargetSequence, SequencePlaybackSettings, NewSequenceActor);
 
    if (SequencePlayer == nullptr || NewSequenceActor == nullptr)
    {
        LOG_ERROR(LogCK, "%s 생성에 실패했습니다.", NAMEOF(UTemplateSequencePlayer));
        return;
    }
 
    SequenceActor = NewSequenceActor;
    BoundEffector = Effector;
 
    Blender->BeginBlend(PositionBlendSeconds, RotationBlendSeconds, FOVBlendSeconds, TimeScaleBlendSeconds);
 
    NewSequenceActor->SetBinding(Effector);
 
    SequencePlayer->OnFinished.AddUniqueDynamic(this, &AGameCameraManager::OnSequenceFinished);
    SequencePlayer->Play();
 
    // HitStop 도중에 시퀀스가 시작되더라도 첫 프레임부터 정상 속도로 재생되도록 즉시 보정
    UpdateSequencerTimeDilationCompensation();
}

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

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

StopCameraEffectSequence()

void AGameCameraManager::StopCameraEffectSequence

(

)

{
    if (SequencePlayer == nullptr)
    {
        return;
    }
 
    // Stop() 전에 델리게이트를 해제해 OnSequenceFinished 재진입을 차단
    SequencePlayer->OnStop.RemoveAll(this);
    SequencePlayer->OnFinished.RemoveAll(this);
 
    if (SequencePlayer->IsPlaying())
    {
        PreviousSequencerPlayer = SequencePlayer;
    }
 
    if (SequenceActor.IsValid())
    {
        PreviousSequenceActor = SequenceActor;
    }
 
    if (BoundEffector.IsValid())
    {
        BoundEffector->ForceEndAllEffects();
        BoundEffector->Destroy();
    }
 
    SequenceActor = nullptr;
    SequencePlayer = nullptr;
    BoundEffector = nullptr;
 
    ReleaseTimeScaleRequest();
}

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

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

UpdateCamera()

void AGameCameraManager::UpdateCamera ( float  DeltaTime )

overridevirtual

{
    // 시네마틱 ViewTarget(레벨 시퀀스의 시네카메라 등) 인 동안에는 커스텀 카메라 로직을 건너뛰고
    // 엔진 기본 처리에 위임 — 그러지 않으면 매 틱 POV 를 덮어써서 카메라컷이 적용되지 않는다.
    if (IsCinematicViewTarget())
    {
        Super::UpdateCamera(DeltaTime);
        return;
    }
 
    float CameraDeltaTime = DeltaTime;
 
    if (UCameraTargetingComponent* TargetingComponent = GetPlayerTargetingComponent())
    {
        TargetingComponent->UpdateCameraBehavior(this, CameraDeltaTime);
    }
 
    if (UCameraZoomComponent* DistanceComponent = GetCameraZoomComponent())
    {
        DistanceComponent->UpdateCameraBehavior(this, CameraDeltaTime);
    }
 
    Super::UpdateCamera(DeltaTime);
 
    UpdateSequencerTimeDilationCompensation();
 
    if (UCameraPostProcessComponent* PostProcessComponent = GetCameraPostProcessComponent())
    {
        PostProcessComponent->ApplyCachedPostProcessBlend(this);
    }
 
    if (BoundEffector == nullptr)
    {
        return;
    }
 
    const float RealDeltaTime = static_cast<float>(FApp::GetDeltaTime());
 
    const FVector Position = Blender->AdvancePosition(BoundEffector->Position, RealDeltaTime);
    const FVector Rotation = Blender->AdvanceRotation(BoundEffector->GetEffectiveRotation(), RealDeltaTime);
    const float FieldOfViewOffset = Blender->AdvanceFieldOfViewOffset(BoundEffector->FieldOfViewOffset, RealDeltaTime);
 
    FMinimalViewInfo POV = GetCameraCacheView();
 
    if (Position.IsZero() == false)
    {
        POV.Location += Position;
    }
 
    if (Rotation.IsZero() == false)
    {
        POV.Rotation += FRotator(Rotation.Y, Rotation.Z, Rotation.X);
    }
 
    if (FMath::IsNearlyZero(FieldOfViewOffset) == false)
    {
        POV.FOV += FieldOfViewOffset;
    }
 
    SetCameraCachePOV(POV);
 
    if (bHitStopActive)
    {
        return;
    }
 
    const float TimeScale = Blender->AdvanceTimeScale(BoundEffector->WorldTimeScale, RealDeltaTime);
 
    if (FMath::IsNearlyZero(TimeScale))
    {
        return;
    }
 
    // 전역 시간은 TimeManagementSubsystem 이 합친다. 여기서는 원하는 배율만 요청한다.
    if (UTimeManagementSubsystem* TimeSubsystem = GetWorld()->GetSubsystem<UTimeManagementSubsystem>())
    {
        TimeSubsystem->ApplyTimeScale(TimeScale);
    }
}

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

UpdateSequencerTimeDilationCompensation()

void AGameCameraManager::UpdateSequencerTimeDilationCompensation ( )

private

{
    if (SequencePlayer == nullptr || !SequencePlayer->IsPlaying())
    {
        return;
    }
 
    const UWorld* World = GetWorld();
 
    if (World == nullptr)
    {
        return;
    }
 
    const AWorldSettings* WorldSettings = World->GetWorldSettings();
 
    if (WorldSettings == nullptr)
    {
        return;
    }
 
    const float Dilation = WorldSettings->GetEffectiveTimeDilation();
    const float BasePlayRate = SequencePlaybackSettings.PlayRate;
    const float TargetRate = (Dilation > KINDA_SMALL_NUMBER) ? (BasePlayRate / Dilation) : BasePlayRate;
 
    if (FMath::IsNearlyEqual(SequencePlayer->GetPlayRate(), TargetRate))
    {
        return;
    }
 
    SequencePlayer->SetPlayRate(TargetRate);
}

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

멤버 데이터 문서화

bApplyCameraRotationLag

bool AGameCameraManager::bApplyCameraRotationLag = false

BaseDistance

float AGameCameraManager::BaseDistance = 500.0f

플레이어와 카메라 사이 거리이자, 줌의 기준이 됨.

bHasPendingPlay

bool AGameCameraManager::bHasPendingPlay = false

private

bHitStopActive

bool AGameCameraManager::bHitStopActive = false

private

Blender

TObjectPtr<UCameraMotionBlender> AGameCameraManager::Blender

private

BoundEffector

TWeakObjectPtr<ACameraEffector> AGameCameraManager::BoundEffector

private

CameraBehaviorComponent

TObjectPtr<UCameraBehaviorComponent> AGameCameraManager::CameraBehaviorComponent

private

CameraCollisionComponent

TObjectPtr<UCameraCollisionComponent> AGameCameraManager::CameraCollisionComponent

private

CameraEffectSequence

TObjectPtr<UTemplateSequence> AGameCameraManager::CameraEffectSequence

CameraPostProcessComponent

TObjectPtr<UCameraPostProcessComponent> AGameCameraManager::CameraPostProcessComponent

private

CameraZoomComponent

TObjectPtr<UCameraZoomComponent> AGameCameraManager::CameraZoomComponent

private

FOVBlendSeconds

float AGameCameraManager::FOVBlendSeconds = 0.1f

LastHitConfirmedTime

double AGameCameraManager::LastHitConfirmedTime = -1.0

private

LocationLagStrength

float AGameCameraManager::LocationLagStrength = 0.35f

PendingEffector

TWeakObjectPtr<ACameraEffector> AGameCameraManager::PendingEffector

private

PendingSequence

TWeakObjectPtr<UTemplateSequence> AGameCameraManager::PendingSequence

private

PlayerTargetingComponent

TObjectPtr<UCameraTargetingComponent> AGameCameraManager::PlayerTargetingComponent

private

PositionBlendSeconds

float AGameCameraManager::PositionBlendSeconds = 0.1f

PreviousSequenceActor

TWeakObjectPtr<ATemplateSequenceActor> AGameCameraManager::PreviousSequenceActor

private

PreviousSequencerPlayer

TObjectPtr<UTemplateSequencePlayer> AGameCameraManager::PreviousSequencerPlayer

private

RotationBlendSeconds

float AGameCameraManager::RotationBlendSeconds = 0.1f

SequenceActor

TWeakObjectPtr<ATemplateSequenceActor> AGameCameraManager::SequenceActor

private

SequencePlaybackSettings

FMovieSceneSequencePlaybackSettings AGameCameraManager::SequencePlaybackSettings

SequencePlayer

TObjectPtr<UTemplateSequencePlayer> AGameCameraManager::SequencePlayer

private

TimeScaleBlendSeconds

float AGameCameraManager::TimeScaleBlendSeconds = 0.1f

---

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

• Source/CK_UE/Camera/GameCameraManager.h
• Source/CK_UE/Camera/GameCameraManager.cpp