Document VR ownership and GLFW platform hooks

This commit is contained in:
2026-06-16 07:53:27 +02:00
parent 73c13f8cde
commit 34e2747867
5 changed files with 65 additions and 13 deletions

View File

@@ -100,7 +100,9 @@ Current architecture mismatches that must be treated as real blockers:
remain, even though iOS keyboard visibility and prepared-file save handoff
now also route through explicit Apple bridge callbacks and Apple render-
context hooks plus iOS main-render-target binding now route through the same
bridge style, as do Apple crash-test, app-close, and iOS SonarPen hooks.
bridge style, as do Apple crash-test, app-close, and iOS SonarPen hooks,
while Linux/Web GLFW render-context acquire/present and Linux app-close now
route through retained local GLFW callback hooks.
- `src/platform_legacy/legacy_platform_services.*` is still part of the live
app shell.
- `pp_panopainter_ui` still depends on `pp_legacy_app`.
@@ -109,7 +111,9 @@ Current architecture mismatches that must be treated as real blockers:
display resolve, cache-to-screen composite, post-draw mask/grid/current-mode
sequencing, per-layer/per-plane retained draw execution, and shared
checkerboard background setup now route through retained draw-merge helpers,
with the cache-to-screen checkerboard-plane callback setup also reduced.
with the cache-to-screen checkerboard-plane callback setup also reduced and
the merged-path per-plane merged-texture draw now routed through the same
retained helper family.
- `app_layout.cpp` and `app_dialogs.cpp` are still mixed shell/controller files
rather than thin composition/binding surfaces.
- `App`, `Canvas`, `Node`, retained workers, and platform entrypoints still use
@@ -119,8 +123,9 @@ Current architecture mismatches that must be treated as real blockers:
launches now use owned `std::jthread` or service-owned worker queues and
`AppRuntime` now owns render/UI workers with explicit `std::jthread`
shutdown semantics while the Windows splash-dialog and HMD renderer workers
also use owned `std::jthread` lifecycle and `LogRemote` now uses the same
ownership model.
also use owned `std::jthread` lifecycle, `LogRemote` now uses the same
ownership model, and the Windows VR device now has explicit `std::unique_ptr`
ownership instead of raw global lifetime.
- Modern C++23 usage exists in extracted components, especially `std::span`,
explicit result/status objects, and a few concepts, but the live app still
does not consistently express ownership, thread affinity, or renderer