How gggz114514-oss/re8-b580-nr-xess works
This repository adds a RE8-specific neural-residual stage before XeSS: the game’s render inputs are bridged from D3D12 into the Python/XPU runtime, processed under loopback-web controls, and returned for XeSS upscaling. The documented user workflow is to open the local control page during gameplay, select NR options, and confirm active processing and timing. Major branches include input-format bridging, configurable model modes and history, and presentation integration. The README and sampled files support the high-level wiring; unsampled host and OptiScaler code limit finer call-level detail.
Main entry points: nr_game_pre_xess_host.py Pre-XeSS host · fullsize_session_v1.py NR session · nr_live_present.cpp OptiScaler hook · nr_game_fullsize.py Mode selection
Components 20
Game integration
- RE8 renderer
- OptiScaler hook
optiscaler/added/nr_live_present.cpp - Pre-XeSS host
game/nr_game_pre_xess_host.py - Residual output
game/nr_game_pre_xess_host.py - Present bridge
optiscaler/added/nr_live_present.h
Web controls
- Control panel
game/nr_game_controls.py - Validated settings
game/nr_game_controls.py - Processing status
game/nr_game_controls.py
NR processing
- Mode selection
game/nr_game_fullsize.py - NR session
game/fullsize_session_v1.py - Geometry contracts
game/re4_session_v1.py - History and replay
game/nr_game_history_fused.py - NR model runtime
- Model weights
GPU texture bridge
- Texture bridge API
native/nr_texture_bridge_v1.h - D3D12 texture bridge
native/nr_texture_bridge_re8_v1.cpp - Python bridge wrapper
game/nr_texture_bridge_v1.py
Other components
- Player
- Local browser
- XeSS upscaler
Connections 22
- Player → RE8 renderer: renders
- RE8 renderer → OptiScaler hook: presents frames
- OptiScaler hook → Pre-XeSS host: dispatches input
- Pre-XeSS host → Python bridge wrapper: prepares textures
- Python bridge wrapper → Texture bridge API: calls API
- Texture bridge API → D3D12 texture bridge: dispatches GPU work
- Local browser → Control panel: sets options
- Control panel → Validated settings: validates settings
- Pre-XeSS host → Validated settings: reads settings
- Pre-XeSS host → Mode selection: selects mode
- Mode selection → Geometry contracts: sets geometry
- Mode selection → NR session: opens session
- Pre-XeSS host → NR session: processes frame
- NR session → History and replay: uses history
- NR session → NR model runtime: runs inference
- Model weights → NR model runtime: provides weights
- Pre-XeSS host → Python bridge wrapper: exports output
- Pre-XeSS host → Residual output: forms residual
- Residual output → XeSS upscaler: returns input
- Pre-XeSS host → Processing status: updates status
- Processing status → Control panel: reports timing
- OptiScaler hook → Present bridge: hooks presentation