Proxy Bake 설정 · PlanetX Docs

Basic/Advanced 전환 상태, Bake Quality, 요청한 Source Representation은 Editor 사용자 설정에 저장됩니다.

#1 Target Planet Asset

설정	설명
`Planet Asset`	생성될 Section과 Bake 링크를 소유하는 Asset입니다. 행성 반지름, 출력 ID, Projection과 최종 `ProxyBakeData` 연결의 기준입니다.

Planet Asset이나 Source World가 바뀌면 기존 Scan Plan은 stale 상태가 됩니다. 새 대상에 대해 다시 Scan Sources를 실행하세요.

#2 Runtime Role

설정	기본값	설명
`Presentation`	`Same World`	`Same World`는 Planet과 Ground가 같은 World Package에 있고 표시만 전환합니다. `External Level`은 코드의 `LevelHandoff`이며 별도 Ground World와 시각 전용 Runtime Preview World를 사용합니다.
`Ground World`	현재 Source World	Scan/Bake 대상 World에서 자동 결정되는 읽기 전용 값입니다.
`Planet World`	None	External Level에서만 표시됩니다. Ground로부터 돌아올 Planet Actor가 있는 Orbit World를 지정합니다. Ground World와 다른 저장된 World여야 합니다.

Level Handoff의 backend 계약 기본값은 OpenLevel입니다. PlanetX는 상태를 capture/resume하지만 실제 Open Level, Pawn 생성, Possess 흐름은 게임이 수행합니다.

#3 Source Scope

설정	기본값	설명
`Selected Actors`		현재 Outliner/Viewport에서 선택한 Actor만 검색합니다. 의도적인 부분 Bake에 적합합니다.
`Current Level`	선택됨	현재 Persistent Level 소유 Actor만 검색하고 Streaming Level은 제외합니다.
`Loaded Levels`		현재 Level, 로드된 Streaming Level과 Level Instance를 함께 검색합니다.
`Reviewed Set`		현재 Plan에서 명시적으로 검토한 stable source membership을 재사용합니다. 먼저 다른 Scope로 Scan을 완료해야 합니다.
`Source Representation: Prefer HLOD`	선택됨	유효성이 확인된 World Partition HLOD를 우선 사용하고 계약상 필요하면 원본 Actor로 fallback합니다.
`Source Representation: Original Actors`		원본 Actor/Component만 사용합니다. HLOD 결과 비교나 fidelity 진단에 유용합니다.
`Include all tags`	비어 있음	쉼표로 구분한 모든 Actor Tag를 가진 Source만 포함합니다. 비어 있으면 포함 필터를 적용하지 않습니다.
`Exclude any tag`	비어 있음	나열한 Tag 중 하나라도 가진 Source를 제외합니다.

Selected Actors, Reviewed Set 또는 Tag Filter처럼 정확한 membership이 필요한 계약에서는 Prefer HLOD를 요청해도 effective 정책이 Original Actors로 바뀔 수 있습니다. UI의 Source Representation summary에서 requested/effective 결과를 확인하세요.

#Source Review

항목	설명
`Use`	Source를 현재 Bake에 포함하거나 제외합니다.
`Role: Auto`	Scan 분류 결과를 사용합니다.
`ProxyGeometry`	Static Mesh 등 일반 기하를 Proxy 메시로 만듭니다.
`LandscapeProxy`	Landscape 전용 capture와 material 경로를 사용합니다.
`InstanceBatch`	ISM/HISM/Foliage 반복 인스턴스를 batch output으로 처리합니다.
`Discard`	사용자가 의도적으로 출력에서 제외합니다.
`ManualReview`	자동으로 안전성을 확정하지 못했습니다. 이유를 확인하고 수정하거나 제외해야 합니다.
`Unsupported`	현재 파이프라인이 안전한 결과를 만들 수 없습니다. 활성 상태로 남으면 Bake가 차단됩니다.
Group Scope	Actor, Folder, Data Layer, Level/Level Instance 단위로 선택 변경을 적용합니다.

Use나 Role을 변경한 뒤에는 Apply Source Changes로 Plan에 반영하세요. WPO/displacement, private material dependency, unsupported deformation 같은 안전성 경고는 단순 경고가 아니라 명시적인 제외 또는 수정이 필요한 차단 조건일 수 있습니다.

#Bake Quality

Quality는 생성 결과에 기록되는 immutable authoring preset입니다.

Preset	Static Mesh triangle budget	Projection scale / max segments	Landscape spacing / resolution
Low	coarsest LOD의 1배	4.0 / 8	800 cm / 17–129
Medium	coarsest LOD의 2배	2.0 / 12	600 cm / 25–193
High (Recommended)	coarsest LOD의 4배	1.0 / 16	400 cm / 33–257

High도 무제한 원본 LOD를 뜻하지 않습니다. 가장 거친 유효 LOD의 triangle count에 배수를 적용한 범위에서 가장 정밀한 LOD를 선택해 기하 증가를 제한합니다.

#Advanced Projection과 Output Plan

설정	기본값 / 범위	설명
`Partition X`, `Partition Y`	자동 Plan 값, 최소 1 cm	output partition 크기입니다. World Partition Auto-size가 켜져 있으면 직접 편집할 수 없습니다.
`Planet Radius`	Target Asset 값, 읽기 전용	AEQD Projection, 곡률 분류와 subdivision에 사용하는 cm 반지름입니다.
`Source Grid`	false	Low proxy grid 대신 Source Landscape의 vertex resolution을 사용합니다. 출력 크기와 처리량이 크게 늘 수 있습니다.
`Surface Datum World Z: Auto`	켜짐	참여 Source Bounds의 최소 World Z를 altitude 0과 Ground Sync 기준으로 사용합니다.
`Surface Datum World Z`	Plan 값, cm	Auto를 끈 경우 altitude 0으로 사용할 World-space Z입니다. 바꾸면 Plan을 다시 계산해야 합니다.
`Auto-size World Partition Output`	WP에서 true	Source bounds와 work density로 PlanetX output shard 크기를 계산합니다. World Partition cell을 1:1 복제하지 않습니다.
`Recalculate`		최신 Scan 결과로 자동 grid를 다시 계산합니다.

Output path, Target Section, Bake ID, Source/Partition/Geometry summary는 계산 결과입니다. 출력 대상이 기존 Asset과 충돌하면 Editor가 명시적인 overwrite/rebuild 확인을 요구합니다.

#Advanced Execution Budget

설정	기본값 / 범위	설명
`Auto Memory Budget`	true	현재 사용 가능한 physical memory에서 안전한 RAM budget을 계산합니다. 일반 작업에 권장합니다.
`Safe`	선택됨	Proxy Bake가 사용할 수 없는 physical memory 4 GiB를 남깁니다.
`High Utilization`		1 GiB만 남깁니다. 전용 Bake 작업에서 명시적으로 사용하세요. Commit/finalization guard는 유지됩니다.
`Manual GiB`	Auto일 때 비활성, 0.5–1024	Auto를 끈 경우의 전체 수동 memory budget입니다.
`Workers`	0, 0–64	geometry worker 상한입니다. 0은 memory governor가 concurrency를 선택합니다.
`Queued`	8, 1–128	동시에 대기할 수 있는 bounded work packet 상한입니다.
`GT Finalize`	4, 1–32	Game Thread publication/finalization backlog 상한입니다.
`Worker Geometry`	true	UObject read와 publication은 Game Thread에 남겨 두고 value-only geometry 계산을 worker task에서 수행합니다.

더 높은 값이 항상 빠른 것은 아닙니다. Scan 뒤 표시되는 top contributor와 remediation을 확인하고, 메모리 부족 시 Worker/Queued/GT Finalize보다 먼저 Auto Memory Budget과 Partition Plan을 점검하세요.

#공개 고급 옵션: `FPlanetXProxyBakePartitionDesc`

이 구조체는 Transition Morph나 공개 C++ 경로의 projection 계약입니다. 일반 Proxy Bake UI에서는 Target Asset과 Plan으로부터 생성됩니다.

설정	기본값	설명
`PartitionOrigin`	(0,0,0)	평면 partition frame의 원점입니다.
`PartitionEast` / `PartitionNorth` / `PartitionUp`	Forward / Right / Up	서로 직교하는 partition frame 축입니다.
`PlanetRadius`	100,000, 최소 1	곡면 projection의 행성 반지름입니다.
`PartitionRadius`	10,000, 최소 1	partition의 유효 반경입니다.
`SphereLatitudeSegments` / `SphereLongitudeSegments`	250 / 250, 최소 3	고정 구 표면 표본 해상도입니다.

#공개 고급 옵션: `FPlanetXProxyBakeOptions`

Editor의 품질 preset과 source classification이 일반 사용자 경로에서 이 값을 해결합니다. 직접 API를 구성하는 도구만 명시적으로 설정하세요.

설정	기본값	설명
`LODIndex`	0, 최소 0	명시적인 Static Mesh source LOD입니다. Editor quality selection과 혼용하지 마세요.
`bSkipHiddenComponents`	true	숨겨진 Component를 제외합니다.
`bWarnOnNonUniformScale`	true	비균일 Scale Source를 진단합니다.
`bSkipNoBakeTaggedActors`	true	PlanetX NoBake Tag가 있는 Actor를 제외합니다.
`bRequireBakeSourceTagForSingleLevel`	false	Single Level bake에서도 BakeSource Tag가 있는 Actor만 허용합니다.
`bFailOnAeqdRangeExceeded`	true	AEQD projection 안전 범위를 넘으면 실패합니다. 품질 손상을 숨기지 않으므로 기본값 유지가 권장됩니다.
`bClipTrianglesToPartitionRadius`	false	partition 반경에서 triangle을 자릅니다. 기본 pipeline의 canonical ownership과 의도적으로 다른 출력이 필요할 때만 사용합니다.
`LandscapeProxyMaterial`	None	Source Landscape Material을 Static Mesh에 사용할 수 없을 때의 fallback Material입니다.
`SubdivisionWorldStep`	275 cm, 0 이상	기본 world-space subdivision 간격입니다.
`AdaptiveSubdivisionMaxProjectedEdgeDeviationCm`	5 cm, 0 이상	곡면 projection edge 오차 허용치입니다.
`MaxSubdivisionDivisionsPerTriangle`	24, 최소 1	한 Source triangle의 subdivision 상한입니다.
`MaxOutputTrianglesPerBakeJob`	5,000,000, 최소 1	한 Bake job의 최종 triangle 안전 상한입니다.

FPlanetXProjectionResult, material remap, heightfield, mesh page, partition output과 instance batch 구조체는 결과 payload입니다. 속성이 reflected되어 있어도 사용자 설정으로 편집하지 마세요.