Planet·Transition Component API

#UPlanetXPlanetComponent

헤더: PlanetX/Components/PlanetXPlanetComponent.h

반환형	함수
`bool`	`RegisterToPlanetXRuntime`, `RefreshRuntimeRegistration`, `GetGravityAccelerationAtWorldLocation`
`void`	`UnregisterFromPlanetXRuntime`, `SetTransitionMorphAlpha`, `SetTransitionMorphActive`, `SetTransitionMorphVisible`, `SetTransitionMorphState`
값 또는 Object	`GetPlanetId`, `GetPlanetBindingId`, `GetPlanetAsset`, `GetPlanetToWorldTransform`, `GetGravitySettings`, `GetTransitionMorphState`

등록하려면 유효한 World, Planet Asset과 Identity가 필요합니다. 여러 Component가 같은 Planet ID를 사용한다면 Binding ID로 대상을 명확하게 구분하세요.

#UPlanetXPlanetProxyComponent

헤더: PlanetX/Components/PlanetXPlanetProxyComponent.h

#Planet 전체 표현

Source 설정·조회: SetPlanetAsset, GetPlanetAsset, SetPlanetMaterialOverride, GetPlanetMaterialOverride, SetPlanetSphereMeshOverride, GetPlanetSphereMeshOverride
표현 Rebuild·제거: RefreshProxy, RebuildPlanetProxy, RebuildSectionProxiesFromPlanetAsset, ClearSectionProxies
Visibility: SetPlanetProxyVisible, SetSectionProxiesVisible, SetSectionProxyMorphAlpha, GetSectionProxyMorphAlpha
상태 조회: GetPlanetSphereComponent, GetSectionProxyResidencyState, GetSectionProxyRealizedComponentCount

RebuildSectionProxiesFromPlanetAsset은 생성 수를 반환합니다. 이 그룹의 나머지 Rebuild, Clear와 Visibility Command는 void이므로 결과가 중요하다면 Residency와 Count를 확인하세요.

#Section과 Layer 표현

반환형	함수
`int32`	`SetSectionProxyBakeData`, `ClearSectionProxyBakeData`, `SetProxyLayerVisible`, `SetSectionProxyPartitionVisible`, `RemoveProxyLayer`, `GetSectionProxyLayerCount`, `GetProxyLayerCount`
`bool`	`SetSectionProxyLayer`, `SetSectionProxyMesh`, `RemoveSectionProxyLayer`, `SetSectionProxyLayerVisible`, `HasSectionProxyLayer`
`void`	`RemoveSectionProxyLayers`
Array	`GetSectionProxyLayerIds`, `GetSectionProxySectionIds`

Count를 반환하는 변경 함수에서 0은 일치해 변경된 Entry가 없다는 뜻입니다. Boolean 변경 함수는 요청 작업의 성공 여부를 반환합니다.

Debug 표현에는 SetDebugOverlaySettings, GetDebugOverlaySettings, SetDebugOverlaysVisible를 사용합니다.

#UPlanetXTransitionMorphComponent

헤더: PlanetX/Components/PlanetXTransitionMorphComponent.h

반환형	함수
`void`	`SetProxyBakeData`, `SetProxyMeshOverride`, `SetTransitionResources`
Object	`GetProxyBakeData`, `GetProxyMeshOverride`, `GetTransitionResources`
`bool`	`HasCompatibleTransitionResources`, `IsUsingGpuMorph`, `IsUsingStaticMeshGpuMorph`, `HasRenderableTransitionPresentation`
`void`	`BuildMorphMesh`, `ApplyMorphState`, `SetTransitionAlpha`, `SetTransitionActive`, `SetMorphVisible`, `ApplyMorphRenderPolicy`

Build와 Apply Command는 void입니다. Compatibility와 Renderability Query로 실제 선택된 표현 경로를 확인하세요.

#Viewpoint와 Travel Receiver

UPlanetXViewpointComponent는 PlanetX/Components/PlanetXViewpointComponent.h에 선언됩니다. GetTransitionFrame과 MapViewDirectionToMovement는 bool을 반환하며 성공했을 때만 출력을 사용합니다.

UPlanetXTravelReceiverComponent는 PlanetX/Components/PlanetXTravelReceiverComponent.h에 선언됩니다. Blueprint-callable 함수는 없습니다. bAutoResumePendingTravel, bApplyControlRotation, ArrivalRetryTimeoutSeconds를 설정하고 bLastResumeSucceeded, LastResumeError, State를 확인하거나 OnTravelResumed, OnTravelResumeFailed에 Bind합니다. 이 Component는 Level Open, Spawn, Possess 또는 GameMode 선택을 담당하지 않습니다.