fix(render): #226 detail overlay uses retail's single-pass combine; drop the dead distance fade (Campaign VM VM1)
VM2's live cdb read against the PDB-paired retail client (GUID 9e847e2f-777c-4bd9-886c-22256bb87f32) proved m_caps.bCanDoSinglePassDetailing = 1 and trysinglepass = 1 on real hardware, so D3DPolyRender::RenderMeshSubset (0x0059ca10) never falls back to the two-pass framebuffer blend the earlier #226 port reproduced. Every loaded CGfxObj sets use_built_mesh = 1 (CGfxObj::InitLoad 0x005346b0), so buildings and EnvCells always take the single-pass texture-stage combine set up in D3DPolyRender::SetSurface (0x0059c4d0): result = lerp(base * diffuse, detail.rgb, detail.a * diffuse.a) RenderMeshSubset lights opaque built-mesh subsets with tmpmaterial.Diffuse.a = 1, so on the live Dereth category texture 0x06006D58 (mean rgb 0.165, mean alpha 0.132) the combine works out to ~0.868 * base + 0.022 — a mild darkening, the opposite sign of the fallback DstColor blend's brightening. Also removes the invented 10 m / 50 m distance fade. Retail's ACRender::get_alpha_for_z (0x006b6230) is only evaluated in D3DPolyRender::DrawPolyInternal (0x0059d7c0, the immediate-polygon path) and only when the static noFadeDetail (0x00820e38, initialised to 1) is 0 — unreachable for built meshes. Attenuation is the sampler's linear mip chain converging to the texture mean, not a scripted ramp. Changes: - mesh_detail.vert/.frag: drop vDetailFade and its distance term; add vDetailOpacity mirroring mesh_modern.vert's InstanceAlphaBuf (binding 7) read, and output detail.rgb with alpha = detail.a * vDetailOpacity under the corrected pipeline blend. - VulkanViewportMapping.BlendFactorsOf / GpuEnums.GpuBlendMode.RetailDetail: SrcAlpha + OneMinusSrcAlpha instead of DstColor + OneMinusSrcAlpha. - RetailDetailTextureContract: replaced the distance-fade constants and FramebufferFactor with Expected(base, detail, opacity) and IsNeutral, matching the lerp; contract tests cover zero-alpha/zero-opacity no-ops, the measured darkening on the live category texture, and full-alpha replacement. - Regenerated mesh_detail's committed SPIR-V and the shader manifest (tools/compile-shaders.ps1); no other shader pair changed. - Docs: #226's pseudocode note, the docs/ISSUES.md #226 entry, and the retired TS-52 divergence-register row corrected from the two-pass DESTCOLOR description to the single-pass path and the darkening expectation, each citing the VM2 cdb note. Verified: dotnet build AcDream.slnx -c Release (0 warnings, 0 errors); dotnet test on AcDream.App.Tests and AcDream.Core.Tests (Release, hermetic lanes) both green. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Erik
parent
30e72a2af8
commit
059703066f
13 changed files with 266 additions and 128 deletions
|
|
@ -9207,7 +9207,11 @@ the full 6,558-pass / 5-skip suite remains green.
|
|||
|
||||
## #226 — Retail building/EnvCell detail-texture overlay is not rendered
|
||||
|
||||
**Status:** IMPLEMENTED + CONNECTED-VISUAL-VERIFIED 2026-08-21
|
||||
**Status:** IMPLEMENTED + CONNECTED-VISUAL-VERIFIED 2026-08-21; re-ported to
|
||||
the single-pass path 2026-08-22 by Campaign VM VM1 after VM2's live cdb read
|
||||
found retail hardware never takes the two-pass fallback this issue originally
|
||||
ported (see
|
||||
[`docs/research/2026-08-22-vm2-retail-detail-path-cdb.md`](research/2026-08-22-vm2-retail-detail-path-cdb.md)).
|
||||
**Severity:** LOW
|
||||
**Filed:** 2026-07-20
|
||||
**Component:** rendering / building and environment materials
|
||||
|
|
@ -9224,8 +9228,12 @@ mechanisms. `bb5acab9` ported the behavior that produced the observed mismatch:
|
|||
`TexMerge::CopyAndTile`/`Merge` pass each source's authored base tiling into the
|
||||
terrain composition. #226 now resolves Dereth category 1/2 detail surfaces,
|
||||
uploads their authored texture/tiling with retail wrap/linear sampling, and
|
||||
replays building and EnvCell built-mesh subsets with the exact
|
||||
`DESTCOLOR + INVSRCALPHA` blend. This includes opaque, ClipMap, straight-alpha,
|
||||
replays building and EnvCell built-mesh subsets with retail's single-pass
|
||||
detail combine (VM1/VM2, 2026-08-22): `SRCALPHA + INVSRCALPHA` compositing
|
||||
`lerp(base * diffuse, detail.rgb, detail.a * diffuseAlpha)`, matching the
|
||||
`bCanDoSinglePassDetailing = 1` path real hardware runs — not the two-pass
|
||||
`DESTCOLOR + INVSRCALPHA` fallback the port originally reproduced. This
|
||||
includes opaque, ClipMap, straight-alpha,
|
||||
additive, and inverse-alpha material subsets; transparent base/detail commands
|
||||
remain adjacent in acdream's authoritative shared alpha order with depth writes
|
||||
disabled (retail bypasses delayed alpha while detail is installed; retaining
|
||||
|
|
@ -9253,10 +9261,12 @@ its evidence source is
|
|||
|
||||
**Acceptance:** Toggling the existing “Building Detail Textures” checkbox
|
||||
visibly changes nearby building and interior surfaces without a restart.
|
||||
Enabled detail is full through 10 m positive view depth, fades linearly to an
|
||||
exact no-op at 50 m, and preserves retail's measured slight brightening.
|
||||
Disabling it submits no detail replay and preserves the already-accepted base
|
||||
render. Landscape, ordinary objects, physics, and collision remain unchanged.
|
||||
There is no distance fade (VM1/VM2: retail's `get_alpha_for_z` is unreachable
|
||||
for built meshes; attenuation is the sampler's linear mip chain), and the
|
||||
single-pass combine darkens the live category texture by roughly 10% on
|
||||
mid-tones rather than brightening it. Disabling it submits no detail replay
|
||||
and preserves the already-accepted base render. Landscape, ordinary objects,
|
||||
physics, and collision remain unchanged.
|
||||
The automated gates cover the setting gate, data/blend/fade contract,
|
||||
built-mesh subset eligibility, opaque command filtering and A2C coverage,
|
||||
transparent depth/order seam, Vulkan descriptor
|
||||
|
|
|
|||
|
|
@ -457,7 +457,7 @@ AP-94..AP-112 for the confirmed retail-UI completion gaps.
|
|||
| TS-49 | Hidden-object availability is bridged through `TargetManager.NotifyVoyeurOfEventAndClear(ExitWorld)` because acdream has not ported retail's DetectionManager. Retail `CObjCell::hide_object` sends `LeftDetection` to detection voyeurs; acdream instead withholds Hidden hosts from ordinary `GetObjectA` relationship creation and uses the existing non-Ok target update to tear down MoveTo/Sticky consumers and clear watched-role subscriptions while preserving the hidden object's own watcher role. | `src/AcDream.App/Physics/EntityPhysicsHost.cs` (`NotifyHidden`); `src/AcDream.App/Physics/LiveEntityMotionRuntimeController.cs` (`ResolvePhysicsHost`); `src/AcDream.Core/Physics/Motion/TargetManager.cs` (`NotifyVoyeurOfEventAndClear`) | The current movement consumers already share TargetManager's status fan-out; the bridge prevents pursuit of an unavailable object without inventing a second partial detection database. | Plugins or future systems listening specifically for retail detection enter/leave events receive no `LeftDetection`; only movement/sticky target consumers observe the equivalent availability loss. | `CObjCell::hide_object @ 0x0052BE30`; retire by porting DetectionManager/CObjCell detection-voyeur delivery and routing Hidden through `LeftDetection` |
|
||||
| TS-50 | `AnimationDone` executes semantically at each owner's retail `CPhysicsObj::process_hooks` boundary, but all other animation hooks are retained in `AnimationHookFrameQueue` until final root/part/equipped-child pose publication. Retail executes the complete hook stream before transition and the Target/Movement/PartArray/Position manager tail because its current CPartArray pose already exists in-place. Static owners correctly reach `process_hooks` only after their root, parts, and children are current. | `src/AcDream.App/Rendering/Vfx/AnimationHookFrameQueue.cs`; `src/AcDream.App/Rendering/RetailStaticAnimatingObjectScheduler.cs`; shared frame drain in `src/AcDream.App/Update/LiveObjectFrameController.cs` (`LiveEffectFrameController`) | The modern renderer publishes immutable effect-pose snapshots after all root/child composition; deferred visual sinks avoid attaching particles/lights/audio to the previous pose. Semantic `AnimationDone` is split out and exact, so motion completion and manager behavior are not delayed. Pose-owner lifetime tokens prevent deferred hooks from crossing delete/local-ID reuse. | A non-AnimationDone hook with same-quantum semantic consequences (notably `CallPES`, default-script chaining, audio/particle creation relative to a transition) runs later than retail and can observe post-tail state or start one render frame late. | `CPhysicsObj::process_hooks @ 0x00511550`; `CPhysicsObj::UpdatePositionInternal @ 0x00512C30`; `CPhysicsObj::animate_static_object @ 0x00513DF0`; retire by publishing the current per-object/child pose before hook routing or splitting semantic and presentation sinks without changing authored hook order |
|
||||
| TS-51 | Particle and PhysicsScript tails advance once per render frame after the complete ordinary/static object worksets. Retail advances each ordinary object's ParticleManager then ScriptManager inside every admitted `UpdateObjectInternal` quantum; `animate_static_object` instead advances that static owner's ScriptManager then ParticleManager and only then `process_hooks`, using its whole admitted elapsed interval. acdream's shared tail is Particle → Script after static hook capture. | `src/AcDream.App/Update/LiveObjectFrameController.cs` (`LiveObjectFrameController` + `LiveEffectFrameController` shared `_particles.Tick` / `_scripts.Tick` tail); `src/AcDream.App/Rendering/RetailStaticAnimatingObjectScheduler.cs` | The current managers are shared presentation/runtime owners rather than per-object manager instances. R6 makes root motion, animation, object clocks, workset membership, and ordinary manager order faithful without pretending the shared tails have per-owner timing or static-tail order. Splitting ownership safely requires a later effect-lifetime slice. | A render fragment below retail's minimum object quantum can advance an effect while its owner waits; a catch-up frame advances an owner's root through several quanta but its effect tail only once; static hooks can route before their script/particle managers and static default scripts/particles use render elapsed in Particle → Script order rather than `animate_static_object` elapsed/discard and Script → Particle → hooks timing. | `CPhysicsObj::UpdateObjectInternal @ 0x005156B0`; `CPhysicsObj::animate_static_object @ 0x00513DF0`; retire by giving live/static owners incarnation-bound particle/script managers and ticking each manager in the owning object quantum/order |
|
||||
| ~~TS-52~~ | **RETIRED 2026-08-21 (#226).** The row's landscape premise was wrong: the reachable Sept-2013 `ChangeRegion` caller passes zero LANDSCAPE detail surfaces and enables the building/environment categories. acdream now resolves those authored category detail textures and tiling, replays eligible building-shell and EnvCell subsets with retail's `DESTCOLOR + INVSRCALPHA` blend and 10–50 m viewer-depth fade, and consumes the existing Building Detail Textures preference. The earlier experimental landscape array remains correctly reverted; there is no missing user-visible landscape pass to track. | `src/AcDream.App/Rendering/TerrainAtlas.cs`; `src/AcDream.App/Rendering/Wb/WbDrawDispatcher.Rhi.cs`; `src/AcDream.App/Rendering/Wb/EnvCellRenderer.Rhi.cs`; `src/AcDream.App/Rendering/Shaders/mesh_detail.vert`; `src/AcDream.App/Rendering/Shaders/mesh_detail.frag` | Retired on measured caller/category evidence and the connected on/off/restored visual gate. | None; disabling the preference submits no detail replay, while enabling it visibly changes nearby building/EnvCell surfaces. Landscape remains unchanged, matching the reachable retail caller. | `docs/research/2026-08-21-retail-building-detail-texturing-pseudocode.md`; `LScape::ChangeRegion`; `SmartBox::SetDetailTexturing`; issue #226 |
|
||||
| ~~TS-52~~ | **RETIRED 2026-08-21 (#226); re-ported 2026-08-22 (Campaign VM VM1/VM2).** The row's landscape premise was wrong: the reachable Sept-2013 `ChangeRegion` caller passes zero LANDSCAPE detail surfaces and enables the building/environment categories. acdream now resolves those authored category detail textures and tiling, and replays eligible building-shell and EnvCell subsets with retail's **single-pass** detail combine — `SRCALPHA + INVSRCALPHA` compositing `lerp(base·diffuse, detail.rgb, detail.a·diffuseAlpha)` — which VM2's live cdb read proved is the path real hardware runs (`m_caps.bCanDoSinglePassDetailing = 1`), not the two-pass `DESTCOLOR + INVSRCALPHA` fallback this row originally described. There is no viewer-depth fade: retail's `get_alpha_for_z` is unreachable for built meshes (`noFadeDetail = 1`); attenuation is the sampler's linear mip chain. acdream consumes the existing Building Detail Textures preference. The earlier experimental landscape array remains correctly reverted; there is no missing user-visible landscape pass to track. | `src/AcDream.App/Rendering/TerrainAtlas.cs`; `src/AcDream.App/Rendering/Wb/WbDrawDispatcher.Rhi.cs`; `src/AcDream.App/Rendering/Wb/EnvCellRenderer.Rhi.cs`; `src/AcDream.App/Rendering/Shaders/mesh_detail.vert`; `src/AcDream.App/Rendering/Shaders/mesh_detail.frag` | Retired on measured caller/category evidence and the connected on/off/restored visual gate; blend/fade re-ported on VM2's live cdb evidence. | None; disabling the preference submits no detail replay, while enabling it visibly changes nearby building/EnvCell surfaces (a mild darkening, not the earlier-assumed brightening). Landscape remains unchanged, matching the reachable retail caller. | `docs/research/2026-08-21-retail-building-detail-texturing-pseudocode.md`; `docs/research/2026-08-22-vm2-retail-detail-path-cdb.md`; `LScape::ChangeRegion`; `SmartBox::SetDetailTexturing`; issue #226 |
|
||||
| TS-53 | acdream advances retained UI time on the draw seam and local teleport/UI-camera presentation after its SmartBox-shaped object → inbound network → CommandInterpreter barrier. Retail `Client::UseTime` calls `UIElementManager::UseTime` first, whose global time message reaches `gmSmartBoxUI::UseTime`, and publishes player-camera work from the physics/player callback rather than one post-network camera tail. Slices 6–7 preserve the accepted host order as ownership-only extractions. | `src/AcDream.App/Update/UpdateFrameOrchestrator.cs` (post-live-frame teleport/camera phases); `src/AcDream.App/Rendering/PrivatePresentationRenderer.cs` (`RetainedGameplayUiFrame.Render`); `docs/plans/2026-07-21-gamewindow-slice-6-update-frame-orchestration.md`; `docs/plans/2026-07-22-gamewindow-slice-7-render-frame-orchestration.md` | Current retained UI, portal transit, reveal, camera, and connected movement traces are accepted; changing cross-subsystem host order while extracting ownership would combine a behavior change with the structural cutover. | Retained UI, teleport, and camera presentation can observe same-frame object/inbound/player state one host update earlier or later than retail at transition boundaries; a future exact host-order port must prove UI, input, reveal, and camera consequences together. | `Client::UseTime @ 0x00411C40`; `UIElementManager::UseTime`; `gmSmartBoxUI::UseTime @ 0x004D6E30`; `CPhysics::UseTime @ 0x00509950`; retire only with a focused host-order port and connected portal/camera comparison |
|
||||
| ~~TS-54~~ | **RETIRED 2026-08-08 (Campaign A slice A4).** The AdminEnvirons stingers now play. `UiSoundController.PlayEnvironCue` maps the change type through `EnvironSoundCueMap` — an EXPLICIT table read case-by-case out of `CPlayerSystem::Handle_Admin__Environs` @ `0x0055DE20` (`0x0055E0C6..0x0055E2C7`), not an offset: codes `0x65..0x72` sit 0x11 below their SoundType but `0x73`/`0x74` have no case at all, so `0x75` lands on `UI_Squeal` (0x84) where arithmetic would give 0x86, and the switch ends at `0x7B`/`UI_Thunder6` with no `0x7C` case. All 21 cases are pinned by conformance tests. The bank itself is no longer a blocker either: the UI sound table's DID is resolved by walking the dats' EnumIDMap chain (`UiSoundTableResolver`, master → slot-7 map → `0x2000004B`), which is how retail finds it — `GetUISoundTable` holds no literal. | retired | — | — | `CPlayerSystem::Handle_Admin__Environs @ 0x0055DE20`; `SoundManager::PlaySoundFromCenter @ 0x00550950`; `ClientUISystem::GetUISoundTable @ 0x00563FB0`; `docs/research/2026-08-08-audio-retail-music-absence.md` §5 |
|
||||
| TS-55 | AdminEnvirons fog values remain a color-only `WeatherSystem.Override` approximation. Retail values 1..5 install authored ambient color/level plus fog color/max; value 6 also forces transition/min/max and blanks radar; Clear restores all override fields and radar; `0x270F` installs a separate authored override. | `src/AcDream.App/World/WorldEnvironmentController.cs` (`ApplyAdminEnvirons`); `src/AcDream.Core/World/WeatherState.cs` (`EnvironOverrideColor`) | Preserves the already accepted enum bridge while Slice 8 moves ownership; porting the complete environment/radar presentation is a separate behavior change requiring focused visual gates. | Forced-fog hue, density, scene ambient, and radar blanking differ from retail; `0x270F` is ignored. | `CPlayerSystem::Handle_Admin__Environs @ 0x0055DE20` (`0x0055DE2B..0x0055E344`) |
|
||||
|
|
|
|||
|
|
@ -1,7 +1,14 @@
|
|||
# Retail building and environment detail texturing — #226 port note
|
||||
|
||||
**Date:** 2026-08-21
|
||||
**Status:** IMPLEMENTED + CONNECTED-VISUAL-VERIFIED
|
||||
**Date:** 2026-08-21 · **Amended:** 2026-08-22 (Campaign VM, VM1)
|
||||
**Status:** IMPLEMENTED + CONNECTED-VISUAL-VERIFIED; re-ported to retail's
|
||||
single-pass detail combine by VM1 after
|
||||
[VM2's live cdb read](2026-08-22-vm2-retail-detail-path-cdb.md) proved real
|
||||
hardware never takes the two-pass framebuffer fallback this note originally
|
||||
described. The "Exact two-pass pseudocode" and "Brightening decision"
|
||||
sections below are corrected in place; everything about the reachable
|
||||
setting/caller chain, the authored source data, and material coverage is
|
||||
unchanged and still applies.
|
||||
|
||||
This note is the implementation handoff requested by #226. The measurements
|
||||
below come from the already-completed
|
||||
|
|
@ -59,11 +66,17 @@ magnification, and mip filtering. Detail UV is `baseUv * tiling`. The port
|
|||
therefore uploads each live category as a one-layer RGBA8 texture array with a
|
||||
full mip chain and the existing repeat/linear world sampler.
|
||||
|
||||
## Exact two-pass pseudocode
|
||||
## Exact single-pass pseudocode
|
||||
|
||||
Retail has both a single-pass multitexture route and a two-pass fallback. The
|
||||
Vulkan port uses the fallback because it preserves the already-accepted base
|
||||
pass byte-for-byte and expresses the retail framebuffer blend directly.
|
||||
Retail has both a single-pass multitexture route and a two-pass framebuffer
|
||||
fallback for adapters that cannot advertise `D3DTEXOPCAPS_PREMODULATE`.
|
||||
[VM2's live cdb read](2026-08-22-vm2-retail-detail-path-cdb.md) on the
|
||||
PDB-paired retail client found `m_caps.bCanDoSinglePassDetailing = 1` and the
|
||||
file-static `trysinglepass = 1` on real (AMD) hardware, so
|
||||
`D3DPolyRender::RenderMeshSubset` (`0x0059ca10`) never falls back for built
|
||||
meshes — every loaded `CGfxObj` sets `use_built_mesh = 1`
|
||||
(`CGfxObj::InitLoad` `0x005346b0`). The port below matches the path players
|
||||
actually saw.
|
||||
|
||||
```text
|
||||
enabled = DisplaySettings.BuildingDetailTextures // existing setting; no new option
|
||||
|
|
@ -83,31 +96,47 @@ for each replayed fragment:
|
|||
reject ordinary objects / landscape / scenery
|
||||
accept opaque, ClipMap, alpha, additive and inverse-alpha subsets
|
||||
|
||||
zMetres = positive_view_space_depth_in_metres
|
||||
fade = clamp((50 m - zMetres) / (50 m - 10 m), 0, 1)
|
||||
// full through 10 m; linear 10–50 m; exactly zero at/after 50 m
|
||||
// No distance term. ACRender::get_alpha_for_z (0x006b6230) is only
|
||||
// evaluated in D3DPolyRender::DrawPolyInternal (0x0059d7c0, the
|
||||
// immediate-polygon path) and only when the static noFadeDetail
|
||||
// (0x00820e38, initialised to 1) is 0 — unreachable for built meshes.
|
||||
// Attenuation is the LINEAR mip chain converging to the texture mean.
|
||||
|
||||
detail = sample(categoryTexture, baseUv * categoryTiling)
|
||||
src.rgb = detail.rgb * fade
|
||||
src.a = detail.a * fade
|
||||
diffuseAlpha = base_subset_diffuse_alpha // 1 for opaque; the
|
||||
// translucency-fade multiplier
|
||||
// for a fading subset
|
||||
// (tmpmaterial.Diffuse.a in
|
||||
// RenderMeshSubset)
|
||||
|
||||
// D3DPolyRender::SetSurface (0x0059c4d0) texture-stage setup:
|
||||
// stage 0 colour = MODULATE(TEXTURE, DIFFUSE) = base.rgb * diffuse.rgb
|
||||
// stage 0 alpha = PREMODULATE(DIFFUSE, DIFFUSE) = diffuseAlpha * detail.a
|
||||
// stage 1 colour = BLENDCURRENTALPHA(TEXTURE, CURRENT) = lerp(current.rgb, detail.rgb, stage0.a)
|
||||
src.rgb = detail.rgb
|
||||
src.a = detail.a * diffuseAlpha
|
||||
|
||||
depth test = EQUAL opaque; LESS_OR_EQUAL transparent
|
||||
depth write = preserve base class // ON opaque; OFF transparent
|
||||
alpha-to-coverage = OFF // detail alpha is blend input
|
||||
blend op = ADD
|
||||
source = DEST_COLOR
|
||||
source = SRC_ALPHA
|
||||
destination = ONE_MINUS_SRC_ALPHA
|
||||
```
|
||||
|
||||
Scaling **both** RGB and alpha by the fade is load-bearing. The resulting
|
||||
framebuffer multiplier is:
|
||||
The pixel this produces is `lerp(base * diffuse, detail.rgb, detail.a *
|
||||
diffuseAlpha)` — a blend **toward** the detail colour by
|
||||
`detail.a * diffuseAlpha`:
|
||||
|
||||
```text
|
||||
factor = 1 + fade * (detail.rgb - detail.a)
|
||||
result = base * (1 - detail.a * diffuseAlpha) + detail.rgb * (detail.a * diffuseAlpha)
|
||||
```
|
||||
|
||||
Thus fade zero is an exact no-op and the full-strength neutral point is
|
||||
`detail.rgb == detail.a` channel-by-channel. It is not 0.5 gray.
|
||||
`detail.a * diffuseAlpha == 0` is an exact no-op (fully-transparent detail
|
||||
texel, or a translucency fade that has reached zero). At `detail.a *
|
||||
diffuseAlpha == 1` the result is exactly the detail colour. There is no
|
||||
"neutral gray" point — this is a lerp, not the fallback's multiplicative
|
||||
`1 + fade * (detail.rgb - detail.a)` factor.
|
||||
|
||||
### Built-mesh material coverage and order
|
||||
|
||||
|
|
@ -147,19 +176,22 @@ change base coverage/blend/depth behavior; it avoids making the checkbox
|
|||
reorder the default transparent scene. The connected acceptance matrix must
|
||||
still exercise overlapping transparent building/EnvCell surfaces.
|
||||
|
||||
## Brightening decision
|
||||
## Darkening, not brightening
|
||||
|
||||
The port keeps retail's `DEST_COLOR + ONE_MINUS_SRC_ALPHA` verbatim. The
|
||||
findings measured factors **1.177**, **1.204**, and **1.033** for the three
|
||||
Dereth textures; the live Dereth building/environment category uses the
|
||||
1.033-factor texture. That slight brightening is intentional retail parity,
|
||||
not an acceptance failure.
|
||||
|
||||
Changing the destination factor to `ZERO` would be a visual correction rather
|
||||
than a port. Exposing both behaviors behind one retail checkbox would also
|
||||
make the option ambiguous. If a roughening-corrected material is wanted later,
|
||||
it belongs as an explicitly named opt-in enhancement/shader-pack policy with a
|
||||
registered divergence. It is not part of #226.
|
||||
The earlier version of this note read the two-pass fallback's `DEST_COLOR +
|
||||
ONE_MINUS_SRC_ALPHA` as retail's blend and reported the findings doc's
|
||||
**1.177**, **1.204**, and **1.033** framebuffer-multiplier measurements for
|
||||
the three Dereth textures as intentional retail brightening. VM2 showed that
|
||||
factor formula belongs to the fallback only, which real hardware does not
|
||||
run. The single-pass lerp above has the opposite sign: with the live
|
||||
Dereth building/environment category texture (mean rgb 0.165, mean alpha
|
||||
0.132) and opaque diffuse (`diffuseAlpha = 1`), the combine is
|
||||
`≈ 0.868 × base + 0.022` — a mild **darkening** of roughly 10% on mid-tones,
|
||||
not a brightening. This is retail's actual on-screen behavior on the
|
||||
hardware the game shipped on; it is not a visual correction and carries no
|
||||
opt-out. See
|
||||
[`RetailDetailTextureContract`](../../src/AcDream.App/Rendering/RetailDetailTextureContract.cs)
|
||||
and the VM2 note for the exact numbers.
|
||||
|
||||
## What the reverted experiment got wrong
|
||||
|
||||
|
|
@ -201,10 +233,15 @@ current Vulkan-only RHI.
|
|||
- Opaque object replay submits only command runs containing a building; mixed
|
||||
commands are filtered per instance. Depth equality inherits the base pass's
|
||||
per-sample ClipMap coverage without applying A2C to detail alpha.
|
||||
- Detail is full through positive view depth 10 m, fades linearly over 10–50
|
||||
m, and is an exact no-op at and beyond 50 m.
|
||||
- There is no distance fade (VM1, VM2): `noFadeDetail` gates
|
||||
`get_alpha_for_z` to the immediate-polygon path only, which built meshes
|
||||
never reach. Attenuation is the sampler's linear mip chain converging to
|
||||
the texture mean; a building reads the same well past 50 m as it does at
|
||||
10 m, not a hard step.
|
||||
- Category source, 256 x 256 size, tiling 4, repeat addressing, and linear mip
|
||||
sampling match the measured Dereth data.
|
||||
- The retail 1.033 live-category brightening is expected. There is no
|
||||
`dst=ZERO` correction mode hidden behind the retail checkbox.
|
||||
- The retail single-pass combine darkens the live category texture by
|
||||
roughly 10% on mid-tones (VM2); this is expected. There is no
|
||||
`dst=ZERO` correction mode and no brightening two-pass fallback hidden
|
||||
behind the retail checkbox.
|
||||
- Physics, collision, walkability, and geometry are untouched.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue