Project Settings Reference¶
Last generated: 2026-04-05
Purpose¶
Use this reference to map Gaussian Splatting project setting keys to source definitions and runtime lookup paths.
Usage¶
| Task | Action |
|---|---|
| Regenerate this reference | Run python3 scripts/generate_project_settings_reference.py. |
| Audit key usage in module code | Run rg -n "rendering/gaussian_splatting/" modules/gaussian_splatting --glob '*.{h,cpp}'. |
API¶
Registered keys¶
These settings are registered with GLOBAL_DEF(...) and grouped by key prefix.
| Coverage | Count |
|---|---|
| Registered keys | 112 |
| Runtime-only keys | 39 |
| Registered keys without additional literal lookup | 8 |
Core¶
| Setting | Default | Defined In |
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
Import¶
| Setting | Default | Defined In |
|---|---|---|
|
|
|
|
|
|
Quality¶
| Setting | Default | Defined In |
|---|---|---|
|
|
|
|
|
|
|
|
|
Streaming¶
| Setting | Default | Defined In |
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Culling¶
| Setting | Default | Defined In |
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Cull¶
| Setting | Default | Defined In |
|---|---|---|
|
|
|
Lod¶
| Setting | Default | Defined In |
|---|---|---|
|
|
|
|
|
|
|
|
|
Sorting¶
| Setting | Default | Defined In |
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Debug¶
| Setting | Default | Defined In |
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Logging¶
| Setting | Default | Defined In |
|---|---|---|
|
|
|
|
|
|
Diagnostics¶
| Setting | Default | Defined In |
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Other¶
| Setting | Default | Defined In |
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Runtime-only keys¶
These keys are used by module code but are not registered with GLOBAL_DEF(...).
| Setting | First reference |
|---|---|
rendering/gaussian_splatting/cull/frustum_plane_slack |
modules/gaussian_splatting/interfaces/gpu_culler.cpp:224 |
rendering/gaussian_splatting/debug/enable_pipeline_trace |
modules/gaussian_splatting/renderer/render_debug_state_orchestrator.cpp:324 |
rendering/gaussian_splatting/debug/enable_splat_audit |
modules/gaussian_splatting/renderer/render_debug_state_orchestrator.cpp:328 |
rendering/gaussian_splatting/debug/enable_state_guardrails |
modules/gaussian_splatting/renderer/render_debug_state_orchestrator.cpp:326 |
rendering/gaussian_splatting/debug/force_unclustered_lights |
modules/gaussian_splatting/renderer/gpu_debug_utils.h:74 |
rendering/gaussian_splatting/debug/layout_hint_validation_strict |
modules/gaussian_splatting/core/gaussian_streaming.cpp:166 |
rendering/gaussian_splatting/debug/show_density_heatmap |
modules/gaussian_splatting/core/gaussian_splat_settings_manager.cpp:10 |
rendering/gaussian_splatting/debug/show_performance_hud |
modules/gaussian_splatting/core/gaussian_splat_settings_manager.cpp:11 |
rendering/gaussian_splatting/debug/show_residency_hud |
modules/gaussian_splatting/core/gaussian_splat_settings_manager.cpp:12 |
rendering/gaussian_splatting/debug/show_tile_grid |
modules/gaussian_splatting/core/gaussian_splat_settings_manager.cpp:9 |
rendering/gaussian_splatting/debug/splat_audit_sample_count |
modules/gaussian_splatting/renderer/render_debug_state_orchestrator.cpp:369 |
rendering/gaussian_splatting/gpu_sorting/target_sort_time_ms |
modules/gaussian_splatting/renderer/sorting_settings_utils.h:19 |
rendering/gaussian_splatting/import/ply_ascii_strict_parse |
modules/gaussian_splatting/io/ply_loader.cpp:58 |
rendering/gaussian_splatting/lighting/dc_logit |
modules/gaussian_splatting/renderer/render_pipeline_stages.cpp:325 |
rendering/gaussian_splatting/lighting/direct_light_scale |
modules/gaussian_splatting/renderer/render_pipeline_stages.cpp:322 |
rendering/gaussian_splatting/lighting/indirect_sh_scale |
modules/gaussian_splatting/renderer/render_pipeline_stages.cpp:323 |
rendering/gaussian_splatting/lighting/shadow_receiver_bias_max |
modules/gaussian_splatting/renderer/render_pipeline_stages.cpp:328 |
rendering/gaussian_splatting/lighting/shadow_receiver_bias_min |
modules/gaussian_splatting/renderer/render_pipeline_stages.cpp:327 |
rendering/gaussian_splatting/lighting/shadow_receiver_bias_scale |
modules/gaussian_splatting/renderer/render_pipeline_stages.cpp:326 |
rendering/gaussian_splatting/lighting/shadow_strength |
modules/gaussian_splatting/renderer/render_pipeline_stages.cpp:324 |
rendering/gaussian_splatting/lod/bias |
modules/gaussian_splatting/interfaces/gpu_culler.cpp:222 |
rendering/gaussian_splatting/lod/enabled |
modules/gaussian_splatting/renderer/gaussian_splat_renderer.cpp:740 |
rendering/gaussian_splatting/lod/importance_threshold |
modules/gaussian_splatting/interfaces/gpu_culler.cpp:223 |
rendering/gaussian_splatting/lod/min_screen_size_pixels |
modules/gaussian_splatting/interfaces/gpu_culler.cpp:218 |
rendering/gaussian_splatting/logging/command_buffer |
modules/gaussian_splatting/logger/gs_logger.cpp:77 |
rendering/gaussian_splatting/logging/compositor |
modules/gaussian_splatting/logger/gs_logger.cpp:75 |
rendering/gaussian_splatting/logging/general |
modules/gaussian_splatting/logger/gs_logger.cpp:65 |
rendering/gaussian_splatting/logging/gpu_memory |
modules/gaussian_splatting/logger/gs_logger.cpp:73 |
rendering/gaussian_splatting/logging/gpu_sort |
modules/gaussian_splatting/logger/gs_logger.cpp:71 |
rendering/gaussian_splatting/logging/renderer |
modules/gaussian_splatting/logger/gs_logger.cpp:67 |
rendering/gaussian_splatting/logging/streaming |
modules/gaussian_splatting/logger/gs_logger.cpp:69 |
rendering/gaussian_splatting/logging/tests |
modules/gaussian_splatting/logger/gs_logger.cpp:79 |
rendering/gaussian_splatting/sorting/strict_global_sort |
modules/gaussian_splatting/renderer/gpu_sorting_config.cpp:53 |
rendering/gaussian_splatting/sorting/target_sort_time_ms |
modules/gaussian_splatting/renderer/sorting_settings_utils.h:14 |
rendering/gaussian_splatting/sorting/validate_sorted_output |
modules/gaussian_splatting/renderer/gpu_sorting_config.cpp:54 |
rendering/gaussian_splatting/streaming/layout_hint_validation_strict |
modules/gaussian_splatting/core/gaussian_streaming.cpp:163 |
rendering/gaussian_splatting/streaming/max_sync_fallback_loads_per_frame |
modules/gaussian_splatting/core/streaming_upload_pipeline.cpp:285 |
rendering/gaussian_splatting/streaming/max_sync_fallback_queue_size |
modules/gaussian_splatting/core/streaming_upload_pipeline.cpp:289 |
rendering/gaussian_splatting/streaming/sh_progressive_load |
modules/gaussian_splatting/renderer/sh_config.h:28 |
Registered keys without additional literal lookup¶
These registered keys have no additional string-literal references beyond their registration line.
| Setting | Registered in |
|---|---|
rendering/gaussian_splatting/cull/overflow_autotune_enabled |
modules/gaussian_splatting/core/gaussian_splat_manager.cpp:1037 |
rendering/gaussian_splatting/culling/cluster_frustum_slack |
modules/gaussian_splatting/core/gaussian_splat_manager.cpp:1025 |
rendering/gaussian_splatting/culling/opacity_aware_bounds |
modules/gaussian_splatting/core/gaussian_splat_manager.cpp:1032 |
rendering/gaussian_splatting/culling/visibility_threshold |
modules/gaussian_splatting/core/gaussian_splat_manager.cpp:1033 |
rendering/gaussian_splatting/debug/enable_mainloop_probes |
modules/gaussian_splatting/core/gaussian_splat_manager.cpp:1043 |
rendering/gaussian_splatting/max_gpu_buffer_count |
modules/gaussian_splatting/core/gaussian_splat_manager.cpp:993 |
rendering/gaussian_splatting/streaming/async_io_enabled |
modules/gaussian_splatting/core/gaussian_splat_manager.cpp:1119 |
rendering/gaussian_splatting/streaming/io_source_path |
modules/gaussian_splatting/core/gaussian_splat_manager.cpp:1120 |
Examples¶
python3 scripts/generate_project_settings_reference.py
rg -n "rendering/gaussian_splatting/" modules/gaussian_splatting --glob '*.{h,cpp}'
Troubleshooting¶
| Issue | Cause | Fix |
|---|---|---|
| A key exists in code but not under registered sections | The key is read at runtime without GLOBAL_DEF(...). |
Check the Runtime-only keys section and decide whether to register it. |
| A registered key appears unconsumed | No extra string-literal lookup path is present in module runtime code. | Verify lookup paths or remove stale registration. |
| Line references are stale | Source moved after docs were generated. | Regenerate this file after code changes. |