Engine: native presets K and M in the D3D12 shim, wider game coverage

A standalone Vulkan inference engine (engine/) for DLSS presets K and M that
runs from weights extracted from the user's own nvngx_dlss.dll, with d4r's
own input, network and reconstruction shaders or the native HIP network
layers, recorded into the game's command list by the shim. Opt-in
([Engine] Enabled / D4R_ENGINE=1); anything uncovered falls back to the
CUDA/ZLUDA path with the reason logged.

Byte-identical to NGX's CUDA backend under the phase-capable reference
(1706x960 -> 2560x1440, native HIP network, eleven frames, RX 9070 XT):
- K render- and display-resolution motion vectors, HDR and LDR
- K game-supplied exposure and automatic exposure with any pre-exposure
  and exposure scale (one residual: effective exposure exactly 2 or 4)
- K and M with the DLSS indicator's inverted-axis parameters
- M with any exposure settings (NGX ignores them for M)
K packages need the current compile_k.py (marker D4RO0003).

Also: HIP shared buffers are pooled across feature recreation (ROCm leaks
destroyed imports), hipnet.bin must match the preset, M-only games do not
load the K model, install_d4r_runtime.sh stages k, k-ldr, m, m-ldr with
hip/, the activation table has a generator (gen_activation_m.py), and
package_release.sh can bundle the engine's shaders (never its weights).

Signed-off-by: woutermans <[email protected]>

tests/test_optiscaler_packaging.py

@@ -147,6 +147,11 @@ class OptiScalerConfigTests(unittest.TestCase):
                        D4R_BUNDLE_DLSS=str(dlss), D4R_BUNDLE_NGX=str(core), D4R_BUNDLE_TEX=str(inputs / 'tex'))
             version = (repo / 'packaging/VERSION').read_text().strip()
             configs = []
+            # A compiled engine model: only d4r's shaders and marker may reach a zip.
+            for name in ('input_k.spv', 'output_k.spv', 'exposure_k0.spv', 'exposure_k1.spv', 'enc0.spv',
+                         'direct_origins.bin', 'weights.bin', 'offsets.bin', 'lut.bin', 'hipnet.bin', 'model.json'):
+                fixture(inputs / 'engine' / name)
+            env['D4R_BUNDLE_ENGINE'] = str(inputs / 'engine')
             for bundled in ('1', '0'):
                 with self.subTest(bundled=bundled):
                     env['D4R_BUNDLE_NVIDIA'] = bundled
@@ -165,6 +170,10 @@ class OptiScalerConfigTests(unittest.TestCase):
                         self.assertNotIn('d4r/_nvngx.dll', archive.namelist())
                         self.assertEqual('d4r/ngx/_nvngx.dll' in archive.namelist(), bundled == '1')
                         self.assertEqual('d4r/nvngx_dlss.dll' in archive.namelist(), bundled == '1')
+                        engine = sorted(n for n in archive.namelist() if n.startswith('d4r/engine/'))
+                        self.assertEqual(engine, ['d4r/engine/k/' + n for n in (
+                            'README.txt', 'direct_origins.bin', 'enc0.spv', 'exposure_k0.spv', 'exposure_k1.spv',
+                            'input_k.spv', 'output_k.spv')])
                         self.assertEqual(archive.read('d4r/d4r-check.sh'), (ROOT / 'packaging/d4r-check.sh').read_bytes())
             self.assertEqual(configs[0], configs[1])