UObjectPoolManager 클래스 참조

액터를 재활용하여 런타임에 액터 스폰 비용을 최소화하는 오브젝트 풀링(Object Pooling) 관리 서브시스템입니다. 더 자세히 ...

#include <UObjectPoolManager.h>

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

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

Public 멤버 함수
	DEFINE_SUBSYSTEM_GETTER_INLINE (UObjectPoolManager)
virtual void	Deinitialize () override
AActor *	GetPoolItem (const UObject *WorldContextObject, TSubclassOf< AActor > InClass)
AActor *	GetPoolItemLocationRotator (const UObject *WorldContextObject, const TSubclassOf< AActor > InClass, const FVector Location, const FRotator Rotator)
virtual void	Initialize (FSubsystemCollectionBase &Collection) override
void	ReturnActorToPool (AActor *Actor)

Private 속성
TMap< UClass *, TArray< AActor * > >	PoolMap

상세한 설명

액터를 재활용하여 런타임에 액터 스폰 비용을 최소화하는 오브젝트 풀링(Object Pooling) 관리 서브시스템입니다.

비활성화된 액터를 풀에 저장했다가 필요 시 재활성화하여 제공함으로써, 동적 액터 생성 및 소멸로 인한 성능 저하를 방지합니다.

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

멤버 함수 문서화

DEFINE_SUBSYSTEM_GETTER_INLINE()

UObjectPoolManager::DEFINE_SUBSYSTEM_GETTER_INLINE

(

UObjectPoolManager

)

Deinitialize()

void UObjectPoolManager::Deinitialize ( )

overridevirtual

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

{
    for (auto& Elem : PoolMap)
    {
        for (AActor* Actor : Elem.Value)
        {
            if (IsValid(Actor))
            {
                Actor->Destroy();
            }
        }
    }
    PoolMap.Empty();
    
    Super::Deinitialize();
}

다음을 참조함 : PoolMap.

GetPoolItem()

AActor * UObjectPoolManager::GetPoolItem	(	const UObject *	WorldContextObject,
		TSubclassOf< AActor >	InClass
	)

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

{
    return GetPoolItemLocationRotator(WorldContextObject, InClass, FVector::ZeroVector, FRotator::ZeroRotator );
}

다음을 참조함 : GetPoolItemLocationRotator().

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

GetPoolItemLocationRotator()

AActor * UObjectPoolManager::GetPoolItemLocationRotator	(	const UObject *	WorldContextObject,
		const TSubclassOf< AActor >	InClass,
		const FVector	Location,
		const FRotator	Rotator
	)

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

{
    if (!InClass)
    {
        UE_LOG(LogTemp, Error, TEXT("GetPoolItem failed: InClass is null."));
        return nullptr;
    }
    
    TArray<AActor*>* Pool = PoolMap.Find(InClass);
    if (Pool && Pool->Num() > 0)
    {
        AActor* Actor = Pool->Pop();
        Actor->SetActorLocationAndRotation(Location, Rotator);
 
        Actor->SetActorHiddenInGame(false);
        Actor->SetActorEnableCollision(true);
        Actor->SetActorTickEnabled(true);
        
        return Actor;
    }
 
    if (UWorld* World = GEngine->GetWorldFromContextObject(WorldContextObject, EGetWorldErrorMode::LogAndReturnNull))
        return World->SpawnActor<AActor>(InClass, Location, Rotator);
 
    return nullptr;
}

다음을 참조함 : PoolMap.

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

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

Initialize()

void UObjectPoolManager::Initialize ( FSubsystemCollectionBase &  Collection )

overridevirtual

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

{
    Super::Initialize(Collection);
 
    UE_LOG(LogTemp, Log, TEXT("ObjectPoolManager Initialized."));
}

ReturnActorToPool()

void UObjectPoolManager::ReturnActorToPool

(

AActor *

Actor

)

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

{
    if ( Actor == nullptr )
        return;
        
    Actor->SetActorHiddenInGame(true);
    Actor->SetActorEnableCollision(false);
    Actor->SetActorTickEnabled(false);
 
    // 타이머/수명 정리
    if (UWorld* World = Actor->GetWorld())
    {
        World->GetTimerManager().ClearAllTimersForObject(Actor);
    }
    Actor->SetLifeSpan(0.f);
 
    if (UProjectileMovementComponent* Proj = Actor->FindComponentByClass<UProjectileMovementComponent>())
    {
        Proj->StopMovementImmediately();
        Proj->Deactivate();
    }
    if (UCharacterMovementComponent* CharMove = Actor->FindComponentByClass<UCharacterMovementComponent>())
    {
        CharMove->StopMovementImmediately();
        CharMove->Velocity = FVector::ZeroVector;
    }
    if (UPrimitiveComponent* Prim = Cast<UPrimitiveComponent>(Actor->GetRootComponent()))
    {
        Prim->SetPhysicsLinearVelocity(FVector::ZeroVector, true);
        Prim->SetPhysicsAngularVelocityInDegrees(FVector::ZeroVector, true);
        Prim->PutRigidBodyToSleep();
    }
 
    TSubclassOf<AActor> ActorClass = Actor->GetClass();
    TArray<AActor*>& Pool = PoolMap.FindOrAdd(ActorClass);
    Pool.Add(Actor);
}

다음을 참조함 : PoolMap.

멤버 데이터 문서화

PoolMap

TMap<UClass*, TArray<AActor*> > UObjectPoolManager::PoolMap

private

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

다음에 의해서 참조됨 : Deinitialize(), GetPoolItemLocationRotator(), ReturnActorToPool().

---

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

• Source/LatteLibrary/Manager/Public/UObjectPoolManager.h
• Source/LatteLibrary/Manager/Private/UObjectPoolManager.cpp