Integrate source airborne tilt and logical-root rendering

This commit is contained in:
UnixNight committed 2026-11-05 10:19:12 -05:00
1 parent a61f1b0284
commit 27be8ed630
36 files changed
+1953 -62

No files matched your search

@@ -0,0 +1,9 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup><OutputType>Exe</OutputType><TargetFramework>net10.0</TargetFramework><ImplicitUsings>enable</ImplicitUsings><Nullable>enable</Nullable><EnableDefaultCompileItems>false</EnableDefaultCompileItems></PropertyGroup>
<ItemGroup>
<Compile Include="Program.cs"/>
<Compile Include="../../src/GamePort/Game/JimmyRenderTransform.cs"/>
<Compile Include="../../src/GamePort/Game/RocketOrientation.cs"/>
<None Include="original-render-reference.json" CopyToOutputDirectory="PreserveNewest"/>
</ItemGroup>
</Project>
@@ -0,0 +1,54 @@
using System.Numerics;
using System.Text.Json;
using GamePort.Game;
using var doc=JsonDocument.Parse(File.ReadAllText(Path.Combine(AppContext.BaseDirectory,"original-render-reference.json")));
int angles=0,transforms=0;float largestRenderDeviation=0;
foreach(var c in doc.RootElement.GetProperty("angles").EnumerateArray())
{
var p=c.GetProperty("input").EnumerateArray().Select(x=>x.GetSingle()).ToArray();
var o=c.GetProperty("observed").EnumerateArray().Select(x=>x.GetInt32()).ToArray();
for(int i=0;i<3;i++)Check(JimmyRenderTransform.AngleUnits(p[i])==o[i],$"degree cache {c.GetProperty("name")}, axis{i}");
angles++;
}
foreach(var c in doc.RootElement.GetProperty("models").EnumerateArray())
{
var p=c.GetProperty("input").EnumerateArray().Select(x=>x.GetSingle()).ToArray();
var o=c.GetProperty("observed").EnumerateArray().Select(x=>x.GetSingle()).ToArray();
var render=c.GetProperty("render").EnumerateArray().Select(x=>x.GetSingle()).ToArray();
var root=new Vector3(p[3],p[4],p[5]);var euler=new Vector3(p[0],p[1],p[2])*(360f/16384);
var m=JimmyRenderTransform.Source(root,euler);var a=Values(m);
for(int i=0;i<15;i++)Near(a[i],o[i],.000001f,$"original hxform {c.GetProperty("name")}, value{i}");
//The source's render consumer decomposes and re-quantizes the basis. The
//hierarchical model bridge intentionally defers that final precision step.
for(int i=0;i<16;i++)largestRenderDeviation=Math.Max(largestRenderDeviation,Math.Abs(a[i]-render[i]));
Check(new Vector3(m.M41,m.M42,m.M43)==root,"Euler must not rotate root translation");
Near(m.GetDeterminant(),1,.000001f,"unit-scale proper rotation");transforms++;
}
Check(angles==12&&transforms==14,"complete original transform fixture");
Console.WriteLine("PASS12 copied-original degree/short cache and14 OMT hierarchical transform observations");
Near(largestRenderDeviation,.007286334f,.000002f,"recorded final render consumer deviation remains an explicit precision gate");
Console.WriteLine($"RECOVERED14 final render matrices: hierarchical bridge max deviation={largestRenderDeviation:G9}; final decomposition remains separate");
const float minimum=-64.6165f,height=75.9f;float correction=-minimum-height;
var actorRoot=new Vector3(123,height,456);
var upright=JimmyRenderTransform.Aligned(actorRoot,Vector3.Zero,correction);
Near(Vector3.Transform(new(0,minimum,0),upright).Y,0,.00002f,"upright baseline sole placement");
foreach(var euler in new[]{new Vector3(-40,45,-15),new Vector3(10,220,15),new Vector3(0,0,90)})
{
var model=JimmyRenderTransform.Aligned(actorRoot,euler,correction);
Check(Vector3.Distance(Vector3.Transform(new(0,-correction,0),model),actorRoot)<.00004f,
"compatibility correction is local: the logical pivot remains fixed under combined tilt");
}
Console.WriteLine("PASS modern local sole correction preserves upright placement and the logical tilt pivot");
foreach(var bad in new[]{float.NaN,float.PositiveInfinity,float.NegativeInfinity})
{
Throws(()=>JimmyRenderTransform.AngleUnits(bad));
Throws(()=>JimmyRenderTransform.Source(new(bad,0,0),Vector3.Zero));
Throws(()=>JimmyRenderTransform.Source(Vector3.Zero,new(0,bad,0)));
Throws(()=>JimmyRenderTransform.Aligned(Vector3.Zero,Vector3.Zero,bad));
}
Console.WriteLine("PASS nonfinite transform inputs rejected");
static float[] Values(Matrix4x4 m)=>[m.M11,m.M12,m.M13,m.M14,m.M21,m.M22,m.M23,m.M24,m.M31,m.M32,m.M33,m.M34,m.M41,m.M42,m.M43,m.M44];
static void Check(bool value,string message){if(!value)throw new Exception(message);}
static void Near(float value,float expected,float tolerance,string message)=>Check(float.IsFinite(value)&&Math.Abs(value-expected)<=tolerance,$"{message}: {value} != {expected}");
static void Throws(Action action){try{action();}catch(ArgumentOutOfRangeException){return;}throw new Exception("nonfinite input accepted");}
@@ -0,0 +1,925 @@
{
"exe": {
"sha256": "f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8",
"ranges": [
{
"va": "0x4624b0",
"file_offset": "0x624b0",
"length": 64,
"sha256": "be80b2bde09dde5d668389d64d330c3b996e8a3cbd50cda5eb1394bb9be99515"
},
{
"va": "0x462500",
"file_offset": "0x62500",
"length": 30,
"sha256": "71f83f2a073bd2458d3c7b31e6398fb9af5f92a6139ee6364b4339c68d60458d"
},
{
"va": "0x473540",
"file_offset": "0x73540",
"length": 154,
"sha256": "145007991bf3514edba29d8df8c94eae069cf2d0d21034dea24d69eb611e9ab0"
},
{
"va": "0x4723f0",
"file_offset": "0x723f0",
"length": 48,
"sha256": "ae10074b5ae2ff3d2d2ce8c16358476acdba2f2a166be8ad5c9f05e3f55ffc23"
},
{
"va": "0x47f940",
"file_offset": "0x7f940",
"length": 39,
"sha256": "d0a2aca68648a0ae9d5cbfae1b276d4a64d4f797fc0c60f28b64096cdfa3148c"
},
{
"va": "0x4802ca",
"file_offset": "0x802ca",
"length": 40,
"sha256": "a0dc90a444c3cd46550d18d44ab2a72c8569644044248528c9979457e88ffd3e"
}
]
},
"dll": {
"sha256": "3ec41ead011adf56387a6dbd4580e5b5a9721b5f8020c8a56420f42824354943",
"ranges": [
{
"va": "0x1003fa60",
"file_offset": "0x3fa60",
"length": 400,
"sha256": "3032a99d8c5781eca782d91ea4aa06c2e30531aca01f869f6986d01eeb972e6d"
},
{
"va": "0x1003fc00",
"file_offset": "0x3fc00",
"length": 868,
"sha256": "cbec74de9d7e4fc064a3100d450e28147e29cceddab5c9a5d5d01caf7897a624"
},
{
"va": "0x10041d50",
"file_offset": "0x41d50",
"length": 512,
"sha256": "127a0e34d2ca6d9769fa9609b7ac22a58b743a0b2ac0564164f68240796f4696"
}
]
},
"bindings": [
{
"table": "0x4a373c",
"slot": "0x310",
"target": "0x472300"
},
{
"table": "0x4a373c",
"slot": "0x328",
"target": "0x4723f0"
},
{
"table": "0x4a373c",
"slot": "0x3dc",
"target": "0x4624b0"
},
{
"table": "0x4a373c",
"slot": "0x3e0",
"target": "0x4624f0"
},
{
"table": "0x4a373c",
"slot": "0x3e4",
"target": "0x462500"
}
],
"degree_constants": {
"0x4d6408": 45.51111111111111,
"0x4d6410": 360.0
},
"models": [
{
"name": "upright",
"input": [
0.0,
0.0,
0.0,
100.0,
75.9000015,
-200.0
],
"observed": [
1.0,
0.0,
0.0,
0.0,
0.0,
1.0,
0.0,
0.0,
0.0,
0.0,
1.0,
0.0,
100.0,
75.9000015,
-200.0
],
"render": [
1.0,
0.0,
0.0,
0.0,
0.0,
1.0,
0.0,
0.0,
0.0,
0.0,
1.0,
0.0,
100.0,
75.9000015,
-200.0,
1.0,
6.0
]
},
{
"name": "pitch90",
"input": [
4096.0,
0.0,
0.0,
100.0,
75.9000015,
-200.0
],
"observed": [
1.0,
0.0,
0.0,
0.0,
0.0,
0.0,
-1.0,
0.0,
0.0,
1.0,
0.0,
0.0,
100.0,
75.9000015,
-200.0
],
"render": [
1.0,
0.0,
0.0,
0.0,
0.0,
0.0,
-1.0,
0.0,
0.0,
1.0,
0.0,
0.0,
100.0,
75.9000015,
-200.0,
1.0,
6.0
]
},
{
"name": "yaw90",
"input": [
0.0,
4096.0,
0.0,
100.0,
75.9000015,
-200.0
],
"observed": [
0.0,
0.0,
1.0,
0.0,
0.0,
1.0,
0.0,
0.0,
-1.0,
0.0,
0.0,
0.0,
100.0,
75.9000015,
-200.0
],
"render": [
0.0,
0.0,
1.0,
0.0,
0.0,
1.0,
0.0,
0.0,
-1.0,
0.0,
0.0,
0.0,
100.0,
75.9000015,
-200.0,
1.0,
6.0
]
},
{
"name": "roll90",
"input": [
0.0,
0.0,
4096.0,
100.0,
75.9000015,
-200.0
],
"observed": [
0.0,
-1.0,
0.0,
0.0,
1.0,
0.0,
0.0,
0.0,
0.0,
0.0,
1.0,
0.0,
100.0,
75.9000015,
-200.0
],
"render": [
0.0,
-1.0,
0.0,
0.0,
1.0,
0.0,
0.0,
0.0,
0.0,
0.0,
1.0,
0.0,
100.0,
75.9000015,
-200.0,
1.0,
6.0
]
},
{
"name": "air_forward",
"input": [
14564.0,
2048.0,
15702.0,
100.0,
500.0,
-200.0
],
"observed": [
0.565557301,
0.198106021,
0.800561607,
0.0,
-0.621811032,
0.740098596,
0.256134927,
0.0,
-0.541752696,
-0.642657042,
0.541752696,
0.0,
100.0,
500.0,
-200.0
],
"render": [
0.565611005,
0.198169738,
0.800507903,
0.0,
-0.621610343,
0.740336657,
0.255934209,
0.0,
-0.54192692,
-0.642363191,
0.54192692,
0.0,
100.0,
500.0,
-200.0,
1.0,
6.0
]
},
{
"name": "air_brake",
"input": [
455.0,
2048.0,
682.0,
100.0,
500.0,
-200.0
],
"observed": [
0.651317656,
-0.254645705,
0.714801311,
0.0,
0.301421434,
0.951323569,
0.0642546937,
0.0,
-0.696369469,
0.173606217,
0.696369469,
0.0,
100.0,
500.0,
-200.0
],
"render": [
0.651386678,
-0.254662871,
0.71473223,
0.0,
0.301163465,
0.951387763,
0.06451267,
0.0,
-0.696416497,
0.173228532,
0.696416497,
0.0,
100.0,
500.0,
-200.0,
1.0,
6.0
]
},
{
"name": "full_axes",
"input": [
1365.0,
2503.0,
910.0,
-123.5,
811.25,
70.125
],
"observed": [
0.399019778,
-0.296150625,
0.867800713,
0.0,
0.580931485,
0.813882947,
0.0106347203,
0.0,
-0.709437668,
0.499889284,
0.496798605,
0.0,
-123.5,
811.25,
70.125
],
"render": [
0.399112821,
-0.29621619,
0.867735505,
0.0,
0.580675781,
0.814063072,
0.0108137615,
0.0,
-0.709594667,
0.499557108,
0.496908575,
0.0,
-123.5,
811.25,
70.125,
1.0,
6.0
]
},
{
"name": "negative_units",
"input": [
-1820.0,
-2048.0,
-682.0,
-123.5,
811.25,
70.125
],
"observed": [
0.800561607,
0.198106021,
-0.565557301,
0.0,
0.256134927,
0.740098596,
0.621811032,
0.0,
0.541752696,
-0.642657042,
0.541752696,
0.0,
-123.5,
811.25,
70.125
],
"render": [
0.800507903,
0.198169738,
-0.565611005,
0.0,
0.255934209,
0.740336657,
0.621610343,
0.0,
0.54192692,
-0.642363191,
0.54192692,
0.0,
-123.5,
811.25,
70.125,
1.0,
6.0
]
},
{
"name": "seam",
"input": [
16383.0,
16383.0,
16383.0,
0.0,
0.0,
0.0
],
"observed": [
0.999999881,
0.000383495149,
-0.000383348088,
0.0,
-0.000383348088,
0.999999881,
0.000383642182,
0.0,
0.000383495149,
-0.000383495179,
0.999999881,
0.0,
0.0,
0.0,
0.0
],
"render": [
0.99994123,
0.00766982883,
-0.00766960345,
0.0,
-0.00766960345,
0.999970615,
5.88262737e-05,
0.0,
0.00766982883,
0.0,
0.999970615,
0.0,
0.0,
0.0,
0.0,
1.0,
6.0
]
},
{
"name": "canonical360",
"input": [
16384.0,
16384.0,
16384.0,
0.0,
0.0,
0.0
],
"observed": [
1.0,
0.0,
0.0,
0.0,
0.0,
1.0,
0.0,
0.0,
0.0,
0.0,
1.0,
0.0,
0.0,
0.0,
0.0
],
"render": [
1.0,
0.0,
0.0,
0.0,
0.0,
1.0,
0.0,
0.0,
0.0,
0.0,
1.0,
0.0,
0.0,
0.0,
0.0,
1.0,
6.0
]
},
{
"name": "halfturn",
"input": [
8192.0,
8192.0,
8192.0,
0.0,
0.0,
0.0
],
"observed": [
1.0,
0.0,
0.0,
0.0,
0.0,
1.0,
0.0,
0.0,
-0.0,
-0.0,
1.0,
0.0,
0.0,
0.0,
0.0
],
"render": [
1.0,
0.0,
0.0,
0.0,
0.0,
1.0,
0.0,
0.0,
0.0,
0.0,
1.0,
0.0,
0.0,
0.0,
0.0,
1.0,
6.0
]
},
{
"name": "tiny",
"input": [
1.0,
2.0,
3.0,
0.0,
0.0,
0.0
],
"observed": [
0.999999046,
-0.00115048536,
0.000767431164,
0.0,
0.00115077931,
0.999999285,
-0.000382612576,
0.0,
-0.000766990415,
0.000383495353,
0.999999642,
0.0,
0.0,
0.0,
0.0
],
"render": [
0.99994123,
-0.00766982883,
0.00766960345,
0.0,
0.00766960345,
0.999970615,
5.88262737e-05,
0.0,
-0.00766982883,
0.0,
0.999970615,
0.0,
0.0,
0.0,
0.0,
1.0,
6.0
]
},
{
"name": "zero_root",
"input": [
14564.0,
2048.0,
15702.0,
0.0,
0.0,
0.0
],
"observed": [
0.565557301,
0.198106021,
0.800561607,
0.0,
-0.621811032,
0.740098596,
0.256134927,
0.0,
-0.541752696,
-0.642657042,
0.541752696,
0.0,
0.0,
0.0,
0.0
],
"render": [
0.565611005,
0.198169738,
0.800507903,
0.0,
-0.621610343,
0.740336657,
0.255934209,
0.0,
-0.54192692,
-0.642363191,
0.54192692,
0.0,
0.0,
0.0,
0.0,
1.0,
6.0
]
},
{
"name": "other_root",
"input": [
14564.0,
2048.0,
15702.0,
1000.0,
1011.25,
-2500.0
],
"observed": [
0.565557301,
0.198106021,
0.800561607,
0.0,
-0.621811032,
0.740098596,
0.256134927,
0.0,
-0.541752696,
-0.642657042,
0.541752696,
0.0,
1000.0,
1011.25,
-2500.0
],
"render": [
0.565611005,
0.198169738,
0.800507903,
0.0,
-0.621610343,
0.740336657,
0.255934209,
0.0,
-0.54192692,
-0.642363191,
0.54192692,
0.0,
1000.0,
1011.25,
-2500.0,
1.0,
6.0
]
}
],
"angles": [
{
"name": "zero",
"input": [
0.0,
0.0,
0.0
],
"observed": [
0,
0,
0
]
},
{
"name": "forward",
"input": [
-40.0,
45.0,
-15.0
],
"observed": [
14564,
2048,
15702
]
},
{
"name": "backward",
"input": [
10.0,
45.0,
15.0
],
"observed": [
455,
2048,
682
]
},
{
"name": "quarter",
"input": [
90.0,
180.0,
270.0
],
"observed": [
4096,
8192,
12288
]
},
{
"name": "revolutions",
"input": [
360.0,
720.0,
-360.0
],
"observed": [
0,
0,
0
]
},
{
"name": "negative",
"input": [
-0.5,
-40.0,
-359.998993
],
"observed": [
16362,
14564,
1
]
},
{
"name": "fractional",
"input": [
0.00100000005,
359.998993,
-0.00100000005
],
"observed": [
0,
16383,
0
]
},
{
"name": "arbitrary",
"input": [
0.0166666675,
30.0,
7.30000019
],
"observed": [
0,
1365,
332
]
},
{
"name": "large",
"input": [
1440.75,
-725.25,
9999.99023
],
"observed": [
34,
16146,
12742
]
},
{
"name": "exact_units",
"input": [
0.0219726562,
0.0439453125,
0.0659179688
],
"observed": [
1,
2,
3
]
},
{
"name": "canonical",
"input": [
360.0,
360.0,
360.0
],
"observed": [
0,
0,
0
]
},
{
"name": "seam",
"input": [
359.98999,
-0.00999999978,
-720.01001
],
"observed": [
16383,
0,
0
]
}
],
"scope": "Original OMT compute_hxform and compute_model_matrix with synthetic zero-offset element/identity parent; original EXE473540\u2192462500 with synthetic Euler getter and original finite remainder primitive; CRT exception dispatch bypassed. No game/render entrypoint or whole-game trajectory.",
"files": {
"tools/binary/jimmy_model_bridge.py": "c2270f046fc35ecd6e52af94df075ecce99d7309a5d66bcae2e46094665dab35",
"tools/binary/jimmy_model_bridge_probe.c": "71a186c9132d9378216b7291f0eea494dad7aa060bec410c7e0bc2f48abd2539",
"tools/binary/jimmy_model_bridge_angles_probe.c": "4bbb8de48806e33c9aeb4402f369e7d2212ea4a0710fb111dec41c3d8eaa910d",
"artifacts/jimmy-model-bridge/jimmy_model_bridge_probe.exe": "897ba58d9c6231587a20638b197304fa421880d46f7eb2516188caeed2a82a4d",
"artifacts/jimmy-model-bridge/jimmy_model_bridge_angles_probe.exe": "574323679fbea46a8bc072eba4c485158ede3371e152e359d9c00f33baf1cc4d",
"artifacts/jimmy-model-bridge/probe/wine.log": "fd0d486c2e416ae08623d583fbf7e856b2170918ebb57c984ca91cb9d5fe0060",
"artifacts/jimmy-model-bridge/angles.log": "9d34919b022183db096b6555c2e54c5c51dbab012ba53b45607c21b9a8777fb3"
}
}