Asset과 Project Settings API
#UPlanetXPlanetAsset
헤더: PlanetX/Assets/PlanetXPlanetAsset.h
#Identity와 Revision 조회
| Category | 함수 |
|---|---|
| Planet Asset | GetPlanetId, GetRadiusCm |
| Bake Revision | GetBakeContractRevision, GetLastSuccessfulBakeRevision, IsProxyBakeStale |
| Visual·Material Revision | GetVisualSettingsRevision, GetMaterialBindingRevision, GetLastSuccessfulVisualBuildRevision, HasSuccessfulVisualBuild, IsVisualBuildStale |
| Environment·Preview Revision | GetEnvironmentSettingsRevision, GetLastSuccessfulPreviewRevision, IsVisualPreviewStale |
모두 Blueprint Pure 조회입니다. Revision이 0이면 대응하는 출력이 아직 한 번도 성공적으로 게시되지 않았다는 뜻일 수 있습니다.
#Visual Authoring 변경
아래 함수는 별도 표시가 없으면 PlanetX|Visual Blueprint Category에 속하며 bool을 반환합니다.
| 함수 | 계약 |
|---|---|
SetSurfaceCompletionSettings, SetProxyPaddingSettings, SetVisualGenerationSettings | Revision 추적 Setter를 통해 Completion과 Padding 입력을 변경합니다. |
SetEnvironmentSettings, SetActiveSurfacePreset | Environment 설정 또는 활성 Surface Preset을 변경합니다. |
SetSectionPlacement, SetSectionGroundProxyVisibility | 지정한 Section을 변경합니다. |
IsSectionPlacementLockedToNorthPole, IsSectionAtCanonicalNorthPole | 지정한 Section의 Same World Placement 계약을 읽습니다. |
ValidateSectionPlacement, ValidateLevelTopology | Placement 또는 전체 Topology를 검증하며 선언된 경우 Reason Text를 출력합니다. |
SetSectionSurfaceCorrectionSettings, RefreshSectionProxyBakeLink | Correction 설정을 변경하거나 권위 있는 Bake Data를 다시 연결합니다. |
MarkVisualPreviewBuildSucceeded는 PlanetX|Revision Category의 void Blueprint-callable 함수입니다. Preview Build가 성공한 뒤에만 호출하세요. Revision과 Staleness 추적을 일관되게 유지하려면 직접 Field를 바꾸기보다 이 함수와 Planet Asset Editor를 사용합니다.
#UPlanetXSurfacePreset
헤더: PlanetX/Visual/Assets/PlanetXSurfacePreset.h
이 Blueprint Type에는 Blueprint-callable 함수가 없습니다. 편집 가능한 Field는 PresetId, DisplayName, PresetType, CompletionSettings, PaddingSettings, BaseSurfaceMaterial, OptionalBiomeMask, OptionalHeightMask입니다. PresetId를 안정적으로 유지하고 참조한 Material과 Texture가 Cook에 포함되는지 확인하세요.
#Project Settings
UPlanetXRuntimeDeveloperSettings는 PlanetX/Settings/PlanetXRuntimeDeveloperSettings.h에 선언됩니다. Project-wide Config Field는 RuntimeBudgetPolicy이며 기본값은 EPlanetXRuntimeBudgetPolicy::FollowEngineScalability입니다.
UPlanetXRenderingDeveloperSettings는 PlanetX/Settings/PlanetXRenderingDeveloperSettings.h에 선언됩니다. Config Field는 기본값이 true인 bEnableLensFlares와 기본값이 3이고 유효 범위가 0~3인 LensFlareQuality입니다. ApplyConsoleVariables는 C++ Member이며 Blueprint 함수가 아닙니다.