Scene Settings

Provides scene-wide configuration settings.

The Scene Settings component is a scene-wide singleton for Flora behavior.

What This Affects

• Scene render enable/disable

• Terrain foliage integration and auto-registration

• Scene-level occlusion, motion vectors, light probes, density gating

• Terrain detail streaming controls

---

Properties

OverrideCullingPipeline (Obsolete)

• Kept for migration compatibility.

• Has no effect in current Flora.

CullingPipelineOverride (Obsolete)

• Kept for migration compatibility.

• Has no effect in current Flora.

---

EnableRendering

• Master scene toggle for Flora rendering.

EnableTerrainFoliage

• Enables Flora rendering for terrain trees/details.

AutoRegisterTerrains

• Automatically registers active terrains using FloraTerrainProvider.

---

AllowGPUOcclusionCulling

• Scene-level gate for GPU occlusion.

AllowPerObjectMotionVectors

• Scene-level gate for per-object motion vectors.

AllowPerTreeMotionVectors

• Tree motion vectors; requires AllowPerObjectMotionVectors.

AllowPerDetailMotionVectors

• Detail motion vectors; requires AllowPerObjectMotionVectors.

AllowPerTreeLightProbes

• Enables per-tree probe sampling.

AllowPerDetailLightProbes

• Enables per-detail probe sampling.

AllowDensityCulling

• Enables density systems in this scene.

AllowLegacyLightProbes

• Enables legacy baked light-probe usage for scene content.

---

DetailStreamingMode

• Controls the overall terrain detail streaming behavior.

• Immediate spends as much work as needed to make visible details appear quickly.

• Streamed is the default mode and uses the responsiveness slider to control how aggressively Flora spends its per-frame streaming budget.

• Custom exposes Flora's internal per-frame rebuild and structural budgets directly for advanced tuning.

DetailStreamingResponsiveness

• Controls how aggressively Flora spends its streaming budget.

• Higher values make visible details catch up faster.

• Lower values spread work across more frames to reduce spikes.

• Ignored when DetailStreamingMode is Immediate or Custom.

CustomDetailPatchLayerBudgetPerFrame

• Advanced-only control used when DetailStreamingMode is Custom.

• Limits how many detail patch-layer rebuilds Flora may schedule per frame.

• 0 means unbounded.

CustomDetailStructuralInstanceBudgetPerFrame

• Advanced-only control used when DetailStreamingMode is Custom.

• Limits how many detail create/destroy instance operations Flora may apply per frame.

• 0 means unbounded.

DetailUnloadHysteresisSeconds

• Acts as an unload grace period.

• Flora keeps terrain details alive for this many seconds after they leave range before unloading them.

• Increasing it reduces rapid disappear/reappear popping when hovering near the detail distance boundary.

Runtime User Settings Workflow

You can apply user-controlled render/density values at Start (or any runtime point) via the global Flora volume components:

var sceneSettings = FloraSceneSettings.GetOrCreate();

var render = sceneSettings.GetGlobalRenderSettings();
render.MaxRenderDistance.Override(userRenderDistance);

var density = sceneSettings.GetGlobalDensitySettings();
density.GlobalDensityMode.Override(FloraDensityMode.RenderersOnly);
density.GlobalDensity.Override(userDensity);

Use Override(...) instead of assigning .value directly, so the volume parameter is actually active.

How To Verify

• Disable EnableRendering and confirm Flora-rendered content disappears.

• Disable EnableTerrainFoliage and confirm terrain foliage returns to non-Flora behavior.

• Change the detail streaming controls and verify streaming behavior near distance boundaries.