Files
Neutron/docs/gameplay/rocketship-impact-render.md

114 lines
6.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Rocketship wall-impact render correction
2026-11-03, user-reported wall-hit distortion. **Recovered fact: the four
impact values are material diffuse RGBA, not geometry scale.** The earlier
Rocketship lifecycle report, source-projection naming and supplied friend's
`C3DRocketShip.md` called these values scale; that semantic interpretation was
wrong. The copied-original numeric observations remain valid.
## Ownership and source chain
Authoritative EXE SHA256:
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
Authoritative OMT2.dll SHA256:
`3ec41ead011adf56387a6dbd4580e5b5a9721b5f8020c8a56420f42824354943`.
The friend's different DLL is not used. Analysis reads generated copies only.
1. EXE40DCA0 allocates0x8C bytes;40DCC0 calls IAT48D18C, whose imported name
is `OMedia3DMaterial::OMedia3DMaterial()`.40DCCA stores this pointer in
`complete+5C0+textureIndex*4`.40DCD1/40DCD4 initialize its blend fields30/34.
This is the inherited indexed material array, not an object transform.
2. Rocket43E76E loads `game-interface+500`, equal to `complete+5C0`, material0.
43E780 adds4C. Stores43E78B,43E795,43E7A4,43E7A7 write offsets4C,50,54,58
respectively as `(1,pulse,pulse,1)`. No passenger, Goddard or flame pointer
is traversed by these writes.
3. DLL exported `OMedia3DMaterial::set_color` at10001320 writes the three RGB
components into offsets4C/50/54 (among its other material colors), proving
the fields belong to a color. Its name comes from our DLL export table.
4. DLL exported `OMediaDXRenderPort::draw_shape` at100374B0 consumes the same
material fields.100376A6 passes material+4C to render-port set_material
as its diffuse color. The unlit branch1003787C..100378F6 reads+58 first,
then+4C,+50,+54, multiplies components by255 and packs ARGB diffuse.
Thus offsets4C/50/54 are RGB and58 is alpha. Geometric vertices are not
scaled by this code.
5. Existing REA40E4A0 independently writes `(1,1,1,alpha)` at these same
material offsets while changing blend state. Existing Shrink Ray and
Invisible evidence already identified this as opacity rather than scale.
EXE text raw offsets above are VA−400000; the cited DLL code ranges have raw
offsets VA−10000000. Full bytes/hash guards are retained in
`artifacts/rocket-impact-render/material-byte-guards.json`:
| Source range, exclusive end | Raw start | SHA256 |
| --- | --- | --- |
| EXE43E76E..43E7AA |3E76E|52fb46c6a2271fd06691be976a277a53350aaf6dd2b7083a623ffa797eb8819f|
| EXE40DCA0..40DCF6 |DCA0|fd3810ec3db075e35a81025c0ebec5bd0c2504072306dafac78e5a818c817aff|
| DLL10001320..1000139B |1320|071ee5efa77f876b08994ddc3750a4b8e6f2581b741f1e4c8202285b12ff6a65|
| DLL10037694..100376B3 |37694|d9784e68b81bf68a5ef9df686fc4535675915f21643898bcda0dc1ade43562d5|
| DLL10037874..100378FA |37874|32a2fea66ca6438d44061ba85730509d8c7509ac045001688273c65042619ae4|
## REA evidence and probe interpretation
New local REA/Ghidra queries of the generated authoritative DLL copy succeeded;
complete replies, export bundle and closed snapshot are under
`artifacts/rocket-impact-render/rea-material/`:
- 10001320 set_color: `ev_71e12ebb8e6f6994553fe33606a358b7cd5a0277e50f8190b022e28216ced8ef`.
- 10036F70 DX set_material: `ev_991aa57164839ac125a6cfd9ea309896ef8e525037debed8aeb7f413da71c72c`.
- 100619C0 pipeline set_material: `ev_50a751ce5c2dae8b884f31c0f4da52b6f792054c9d30b74fa64739c84ffa1a76`.
Prior40E4A0 evidence:
`ev_615030aa60b2346083853c40aa719ebc466e9f393fd870ea9722536a4f64cfac`,
`artifacts/invisible/rea-invisible-ipc/01.json`. The DX set_material decompiler
loses stack-copy detail; exact draw_shape disassembly supplies the downstream
packed-color ordering. This is static shipped-artifact evidence, not observed
original gameplay.
The eight earlier impact-tail probes stubbed the material object and printed
the four writes under the misleading output label `scale`. They measured
values, timing, strict expiry and impulses; they did not execute a renderer
and therefore never established scaling. Preserve the old raw fixture field
for provenance, but interpret the observations as color.
## Implementation implication and verification boundary
Apply `(1,pulse,pulse,1)` only to the ship's diffuse tint, retain unit geometric
scale, and restore white when the source impact interval expires. Keep the
existing source pulse and strict timer comparison. The result is a red/white
damage flash with opaque alpha, not a squash/stretch animation. Passenger,
Goddard and fire transforms/tints remain independent.
The binary investigation performs no target execution. Primary integrated
ImpactColor(Vector4), ship-only vertex RGB/opaque alpha and unit model geometry.
Python projections now name the field color; future probes print rgba while
retained raw observations keep their old label. Three independent byte spans
guard the writer, material constructor and DLL diffuse consumer in regression.
The13-group managed suite passes. Its new regression drives the live static-wall
callback twice against a synthetic triangle, samples all four original resource layers over130 frames, checks
every vertex against unit geometry, checks ship-only red tint and verifies
re-rendering does not accumulate color. It also verifies expiry and reset restore
white.12 lifecycle Python groups pass, including all eight numeric references.
Main .NET build passes. The existing1920×1080 ten-phase headless flight replay
passes with validation enabled and zero Vulkan errors; that replay has no wall
impact and is not a GPU wall-hit comparison. All539 original hashes verify.
Logs: artifacts/rocket-impact-render/{managed.log,python-material.log,build.log,
replay.log,originals.log}.
Full original wall-hit rendering and native Windows comparison remain separate
evidence categories.
## Release verification
Linux/Windows self-contained packages rebuilt from clean source
62e908e26d6452e18a2d0d5aab6627b0e8275dda; both BUILD-INFO.txt files record
source_dirty=no. All18 Rocketship resource files match the prepared originals.
Standalone Linux from /tmp on GTX1070/private Xvfb1920×1080 passes all10
flight/control phases with actual injected SDL keys and zero Vulkan errors,
validation enabled. This is the ordinary flight replay; wall-hit geometry/tint
is checked in the managed regression above.22 Rocketship Python source/projection
tests pass. All539 original hashes verify after packaging. Native Windows runtime
for this correction remains pending. Logs: artifacts/rocket-impact-render/
{package.log,package-resources.log,package-runtime.log,python-all-final.log,
originals-final.log}. Subsequent documentation-only changes retain this binary
source provenance.