"""Build nx2navi_dlssg.dll (runtime/dlssg/nx2_sl.cpp, DLSS Frame Generation through NVIDIA Streamline) with MSVC. python tools/build_dlssg.py --sl [--out build/dlssg] python tools/build_dlssg.py --check Streamline's C++ types have MSVC's ABI, so this one DLL is built with Visual Studio's compiler (the Build Tools are enough; vswhere finds them), against the SDK's headers, which stay where they are. The Vulkan headers are MSYS2's. A launcher release and the build kit ship the DLL ready-made beside Streamline's own runtime DLLs (tools/make_launcher.py and tools/make_kit.py --dlssg, with the Streamline files tools/streamline_pin.py pins), and tools/make_game.py place_dlssg puts them beside the game. The built DLL must export every function runtime/dlssg/nx2_sl.h declares (each PFN_nx2sl_ is the export nx2sl_), or the build fails naming the ones it lacks: the runtime takes a missing optional export for an older DLL and leaves its feature out without an error. --check makes the same check of a DLL built before, such as the one a release is about to ship; tools/make_launcher.py and tools/make_kit.py make it on their --dlssg DLL first and stop on one that fails. """ import argparse import os import re import shutil import struct import subprocess import sys import tempfile from pathlib import Path ROOT = Path(__file__).resolve().parents[1] HEADER = ROOT / 'runtime' / 'dlssg' / 'nx2_sl.h' VSWHERE = Path(os.environ.get('ProgramFiles(x86)', r'C:\Program Files (x86)')) / 'Microsoft Visual Studio' / 'Installer' / 'vswhere.exe' def vcvars(): if not VSWHERE.is_file(): sys.exit('Visual Studio (or its Build Tools) is not installed: vswhere.exe is missing') path = subprocess.run([str(VSWHERE), '-latest', '-products', '*', '-requires', 'Microsoft.VisualStudio.Component.VC.Tools.x86.x64', '-property', 'installationPath'], capture_output=True, text=True).stdout.strip() bat = Path(path) / 'VC' / 'Auxiliary' / 'Build' / 'vcvars64.bat' if not bat.is_file(): sys.exit(f'no vcvars64.bat under {path or "(no Visual Studio with the C++ tools)"}') return bat def declared_exports(header=HEADER): """The exports nx2_sl.h declares: nx2sl_ for each function pointer type PFN_nx2sl_.""" text = Path(header).read_text(encoding='utf-8') return {'nx2sl_' + name for name in re.findall(r'\(\s*\*\s*PFN_nx2sl_(\w+)\s*\)', text)} def pe_exports(path): """The names a PE file (PE32 or PE32+) exports: its export directory's name table. Empty without one.""" d = Path(path).read_bytes() pe = struct.unpack_from('nul && cl /nologo /LD /O2 /EHsc /std:c++17 /W3 /DNOMINMAX /DWIN32_LEAN_AND_MEAN ' f'/I"{a.sl / "include"}" /I"{inc}" /I"{src.parent}" "{src}" /Fo"{a.out}\\\\" ' f'/Fe"{a.out / "nx2navi_dlssg.dll"}" /link /NOLOGO') with tempfile.NamedTemporaryFile('w', suffix='.cmd', delete=False) as f: # vcvars64.bat runs vswhere itself and needs it on PATH f.write('@echo off\r\nset "PATH=%PATH%;' + str(VSWHERE.parent) + '"\r\n' + cmd + '\r\n') script = f.name try: r = subprocess.run(['cmd', '/c', script]) finally: os.unlink(script) if r.returncode or not (a.out / 'nx2navi_dlssg.dll').is_file(): sys.exit(f'the build failed ({r.returncode})') check(a.out / 'nx2navi_dlssg.dll') print(a.out / 'nx2navi_dlssg.dll') if __name__ == '__main__': main()