Extend viewport AO to the existing virtual ground (#3413) (#11979)

* claim: #3413

* feat(gpu): extend viewport AO to the virtual ground

* test(gpu): retain measured AO render attachments

* perf: initialize ground AO pipeline with concurrent jobs

* fix(gpu): size ground AO receiver for the current frame radius

* fix(viewport): retain orbit caches when ground AO visibility changes
This commit is contained in:
takuto-NA
2026-11-04 19:42:01 +00:00
committed by GitHub
parent a43cd99e55
commit ef2f485e15
13 changed files with 621 additions and 11 deletions
+15 -1
View File
@@ -3,7 +3,9 @@
Enable **Ambient occlusion** in the viewport's **View settings** menu or in
**Preferences → Graphics**. It adds soft contact shading at corners, recesses and
nearby opaque surfaces. It is off by default, applies immediately, and is saved
between runs. The shared **Graphics Preset** selector in both settings surfaces
between runs. It also shades contacts with the viewport's virtual ground, independently
of the Ground shadow setting. Turning Ground shadow off leaves AO contacts enabled.
The shared **Graphics Preset** selector in both settings surfaces
combines AO with the display-quality and supersampling controls from #1319 and #1321:
| Preset | Ambient occlusion | Display quality | Supersampling |
@@ -43,6 +45,18 @@ It supports orthographic and perspective cameras and respects section clipping.
Wireframe, transparent bodies, overlays and surface-analysis colours are unaffected.
Disabling it skips the depth prepass and sampling and releases the full-size depth map.
The ground follows the existing ellipse's visible-body bounds and up-axis convention,
slightly below their lowest point; it is not the origin grid or a saved floor object.
It appears only in shaded views from above. The receiver adds two triangles to the
existing depth prepass and draws contact opacity over the background, without another
texture or body-mesh copy. Its fragment sampling still adds GPU work, especially on
software adapters and with supersampling. The existing structured SSAO bands remain
a separate quality issue (#3407).
Live-preview bounds update the small receiver through frame metadata, without changing
the model scene's cache key or re-uploading unchanged model colours. Only its extent
grows to cover the preview; the existing ground height remains unchanged.
This is screen-space shading: off-screen and hidden surfaces cannot contribute.
The software fallback and CPU model snapshots do not apply this GPU effect. Capture
the actual window with `ui.screenshot` when reviewing it.