skate-3-rust-engine/docs/visual-parity-status.md

Visual parity status — 2026-09-08

Implemented and compiled offline; game/recomp not launched. User-run checks are

still needed for the previously reported crash, shadow silhouette and performance.

No physics, collision, gameplay or animation logic was changed.

Authored distance fog

Observed: TU3 0x828012D0 loads the fog collection at manager +180. Schema

material_fog offsets are colour=0, power=16, near=20, max=24, far=28. The routine

writes ramp (1/(far-near), -near/(far-near), power) and colour

(colour.rgb*max, -max). The negative-one vector at 0x830BD4A0 is initialized by

0x82F825F0 from float -1 at 0x8216DEE0; its zero bytes in a static dump must

not be interpreted as the initialized value. Colour is not squared here.

The reference world shader applies f=pow(saturate(distance*scale+bias),power)

and linear*(1-max*f)+colour.rgb*max*f, before exposure. The exporter retains

both the authored inputs and these derived rows. All ten private sky metadata

files are refreshed. Regional transitions remain unimplemented.

Exposure

Observed: 0x827F0D00 reads the GPU measurement, scales the weighted mean by

2.515 (0x821A01E8), and evaluates

clamp(previous*(1 + damping*(target-measured)), min, max).

The tuning schema independently confirms offsets 120/124/128/132 for

auto_exposure_target_luminance/min/max/damping. The owned default collection

contains target .25, min .75, max 2.5, damping .5. 0x827F0B78 uses squared

1-abs(x*y) centre weighting. The comparison renderer normally pins exposure at

zone max because its resolve readbacks are disabled; that is not console adaptation.

Adapter: one 256-thread compute group meters a 16x16 bilinear sample grid of

linear HDR using Rec.709 luminance, native centre weighting and the native update

formula. It uses a 30 Hz time basis and caps hitch contribution at 50 ms. This is

not the native packed, resolved measurement surface or regional tuning selection.

The compute result stays on the GPU; the existing final tone pass consumes it.

There is no synchronous CPU readback and no per-material exposure update.

SKATE_FIXED_EXPOSURE=1 retains 2.5 for comparison. Missing metadata also retains

fixed exposure. No claim is made that this meter's measured values match console.

Water and other world materials

The material adapter now retains its shader key and loads authored VLT parameter

arrays from private/render-parameters.json. Additional supported families:

• 30, water.flowing*: two time-scrolled normal taps, mapped normal, refracted

  lightmap coordinates, player-shadow minimum clamp, sun specular, cube reflection

  and native alpha floor. Follows reference scene_water.hlsli's flowing shader.

  Texture row/UV flips are accounted for in scale, scroll and refraction offsets.

• 14, incandescent.backlituvscroll: authored uAnimationSpeed/vAnimationSpeed,

  squared diffuse and material multiplier, followed by fog/exposure.

• 32, ocean.reflection: shader support for squared horizon colour and the authored

  height fade. This is not the animated ocean-surface shader (family 31).

Global model export also includes authored environment.reflective_simple water

sheets previously excluded by the foliage-only filter. Their original GUID-bound

textures and mesh positions are retained in render-only supplements. These have

no collision and never enter physics. Three maps now have global supplements.

Ocean PCA follow-up: 0x827905B0 initializes a 30-frame table with means at

0x830118D8 (3 floats/frame) and weights at 0x83011A40 (24 floats/frame).

0x82790858 selects frames at 1/30-second intervals, scales mean/weights by

1/255, and publishes the seven rows. The reference shader binding swizzles mean

X/Z/Y and weight pairs R/B/G. The build-checked ocean_pca extractor preserves

those tables in a private sidecar. Family 31 now reconstructs normals from both

PCA component textures and these animated rows, then evaluates Fresnel cube

reflection, squared lightmap and Ward sun specular from the native shader.

The adapter selects the authored frame by elapsed time; native phase/reset and

hitch advancement are not reproduced. It requires the supported owned mapped

image for extraction; missing/invalid PCA metadata retains the prior fallback.

It does not invent procedural waves.

Still unported: the distinct non-flowing water.default/water.alpha shader.

The local reference also uses an empirical fallback for this family, so its exact

shader contract needs separate recovery.

Character and shadows

The native nearest-probe selection/cache remains intact. Displayed SH coefficients

now ease between samples using the same bounded .35-second adapter transition as

the shadow floor. All ten models retain their existing skinning and poses.

The GLB exporter now preserves the hair's raw second UV set. RX2 declaration 0x002C23A5 is format 37 (big-endian float2), confirmed against the native vertex decoder. The old skeleton parser incorrectly read it as four normalized shorts. That decoder is corrected, and glTF accessor shape checks now reject four-component data declared as VEC2. The character

sidecar references the original coverage texture; the shader samples its red

channel on that second UV, scales it by m_params[6].x (CAC hair c15.x), and uses

blended strand coverage. Its depth path retains strand holes with the world

30/255 threshold, an adapter choice. Existing dye/rim composition remains an

approximation: live CAC colour-register derivation is still outstanding.

The previous player-only shadow source and smooth shared shadow floor remain.

Its shared storage buffer is now 144 bytes to carry animation time and ocean PCA; neither

world materials nor their bind groups are rebuilt as these values change. Exact

console atlas/filtering and the per-frame shadow-colour controller remain pending.

Existing maps

Freshly decoded RX2 caches refreshed 2,019 of 7,204 texture payloads across ten

private maps. Each map passes the offline reader, and its entire geometry,

collision and metadata tail is byte-identical to the installed input. Material

prefixes are preserved. Original installed maps are untouched. New refresh tooling

publishes atomically and refuses in-place input overwrite.

Evidence and validation

PPC source and raw dump identity: base 0x82000000, SHA-256

F4AA113EB541BFBA03DBC108CF5AB43F58C965B20FA3B82F9C40938A0AD841C4.

Local native renderer reference commit

f6e0ae87fdfecbadb5c1e36c55d66a744187a3cd, shaders scene.hlsl,

scene_water.hlsli, scene_char.hlsli, plus skate3_native_render.cpp.

Private evidence lives under logs/renderer-work: exposure-evaluator.txt,

sub_828012D0-fog-candidate.txt, per-map texture reports and

visual-refresh-validation.json. Owned data is not committed.

Offline checks cover shader composition, exporter fog boundaries, invalid refresh

rollback and existing asset regressions, plus the windowless Rust rendering tests.

These do not validate GPU execution, visual parity, frame time or the prior crash.

Final offline validation: 20 Python regression tests, six filtered Rust tests, three render batching tests, six composed shaders and the release build passed. All ten refreshed maps passed the offline reader and preserved geometry tails.