erik/acdream
1
0
Fork 0
Code Issues Pull requests Projects Releases 6 Packages Wiki Activity Actions

docs(overhaul): correct S5 c1 null-root truth

Browse source 
State the actual visibility transaction: normal non-login world frames participate, PView contributes the exact walk landscape set, and null-root completes an empty set without reconstruction. Login and portal-space remain without a completed world view.

Prose only. Core particle tests 47/47; combined App visibility/terrain/frame/renderer plus AP-116 41/41; git diff --check clean.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
Erik 2026-09-04 16:42:08 +02:00
parent 3f17c9131d
commit 6bbb9e117a
2 changed files with 17 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

10
docs/research/2026-09-01-overhaul/s5-consumers-material-closeout-packet.md
View file

@ -395,3 +395,13 @@ change code behavior, tests, register/architecture prose, or any other file.
Run `git diff --check`, Core particle 47/47, and the combined App/AP-116 41/41;
commit once and return to the same narrow retail lens. Any further finding that
would require a third fix round stops S5-c1 and is written up.
### 11.1 Fix-round-2 implementation result
`UseWorldView` now states the production transaction exactly: every non-login
world frame participates; a PView walk contributes its exact landscape set,
while a null-root safety frame completes `hasCompletedView=true` with an empty
set and no reconstructed fallback. Login and portal-space frames retain
`hasCompletedView=false`. No behavior or assertion changed. Core particle tests
passed 47/47, the combined App visibility/terrain/frame/renderer plus AP-116
lane passed 41/41, and `git diff --check` is clean.

12
src/AcDream.App/Rendering/Vfx/ParticleVisibilityController.cs
View file

@ -41,11 +41,13 @@ public sealed class ParticleVisibilityController : IWorldSceneParticleVisibility
}
/// <summary>
/// Declares that this frame has the completed retail PView product: one
/// viewer position plus its exact walk-owned landscape-cell set. Frames
/// without that PView product, including login, portal space, and the
/// null-root terrain safety draw, deliberately omit it; dedicated-pass and
/// examination emitters carry explicit bypass policies.
/// Marks an open non-login world frame as participating in the completed
/// visibility transaction. When a retail PView walk exists, its exact
/// landscape-cell set is added separately. A null-root safety frame still
/// completes with <c>hasCompletedView=true</c> and an empty landscape set;
/// it never reconstructs a fallback. Login and portal-space frames retain
/// <c>hasCompletedView=false</c>. Dedicated-pass and examination emitters
/// carry explicit bypass policies.
/// </summary>
public void UseWorldView()
{