PlanetX Docsv1.0.1
문서 언어: KO최종 감사: 2026-08-23
데이터 모델과 핵심 개념원문 검증 완료

전환 모델

이 페이지 받기Markdown

PlanetX 전환은 표시 Alpha만 바꾸는 효과가 아니라 Section, runtime context, Actor pose와 travel state를 연결하는 수명 주기입니다.

#전환 참여 요소

  • APlanetXTransitionEndpoint: Section과 endpoint 역할, cylinder 설정, 참가 Actor 정책
  • UPlanetXViewpointComponent: 관찰 위치와 transition presentation 기준
  • UPlanetXTransitionMorphComponent: flat/curved mesh 전환 표현
  • UPlanetXPlanetProxyComponent: Section proxy와 residency
  • UPlanetXSubsystem: query, capture, Same World/Level Handoff facade

FPlanetXTransitionCylinderSettings은 표면 거리와 고도 offset으로 상태와 Alpha를 평가합니다.

#Same World

같은 World 안에서 Orbit Actor가 Ground pose로 이동합니다. 자동 진입은 Coordinate Component의 Spatial Entry policy가 켜진 참가 Actor에만 적용됩니다. 반환 정책은 captured pose 또는 현재 Section-relative pose 중 선택할 수 있습니다.

#Level Handoff

서로 다른 World 사이에서는 BeginLevelHandoff 또는 PrepareTravel이 Ticket을 만들고, 게임 코드가 OpenLevel과 Pawn 정책을 소유합니다. 도착 World에서 ResumePendingTravel 또는 정확한 Ticket을 사용하는 CompleteLevelHandoff가 pose를 적용합니다.

Ticket generation이 오래됐거나 현재 World에 matching pending travel이 여러 개면 적용하지 않습니다. Journey ID는 왕복 상태를 이어주며 완료된 Journey도 진단을 위해 조회할 수 있습니다.

#이동 연속성

Movement Handoff는 linear/angular velocity를 coordinate frame에 맞춰 캡처하고 적용합니다. Consume, Cancel과 rollback 결과를 확인해 중복 적용을 막으세요.