# janblade/optiscaler-f5-dlssnr-multipass architecture

> Architecture diagram of the GitHub repository janblade/optiscaler-f5-dlssnr-multipass, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/janblade/optiscaler-f5-dlssnr-multipass
- Repository: https://github.com/janblade/optiscaler-f5-dlssnr-multipass

## Overview

OptiScaler is a Windows game mod centered here on NVIDIA DLSS Neural Rendering: it loads into a game, intercepts graphics and upscaler interfaces, accepts settings through an in-game menu, and applies configurable neural-rendering passes. The tree also shows frame-generation, latency, Vulkan/DX12 bridging, and plugin capabilities. The workflow and some feature links are documented or visible in the excerpts; unsampled implementation details are left unconnected rather than inferred.

Main entry points: [`OptiScaler/dllmain.cpp`](https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/dllmain.cpp) (DLL entry and loading), [`OptiScaler/dlssnr/DlssNrFeature_Dx12.h`](https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/dlssnr/DlssNrFeature_Dx12.h) (DLSS NR DX12 feature), [`OptiScaler/Config.h`](https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/Config.h) (Settings), [`OptiScaler/hooks/VulkanwDx12_Hooks.cpp`](https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/hooks/VulkanwDx12_Hooks.cpp) (Graphics and API hooks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Injection and configuration"]
  node_dll["DLL entry and loading<br/>[dllmain.cpp]"]
  node_config["Settings<br/>[Config.h]"]
  node_state["Runtime state<br/>[State.h]"]
  node_menu["In-game menu<br/>[menu_common.cpp]"]
end

subgraph group_render["Graphics interception"]
  node_hooks["Graphics and API hooks"]
  node_res_track["DX12 resource tracking<br/>[ResTrack_dx12.cpp]"]
  node_fsr_inputs["FSR2 input adapter<br/>[FSR2_Dx12.cpp]"]
  node_upscalers["Upscaler adapters"]
  node_native["Native frame pipeline"]
end

subgraph group_neural["Neural rendering"]
  node_nrmenu["Neural settings UI<br/>[DlssNr_Menu.cpp]"]
  node_nr_dx12["DLSS NR DX12 feature"]
  node_nr_vk["DLSS NR Vulkan feature"]
  node_detail_reuse["Temporal detail reuse"]
  node_lut["Colour LUT chain<br/>[DlssNr_LutChain.h]"]
  node_profiles["Pass profiles<br/>[DlssNr_Profiles.h]"]
end

subgraph group_features["Game-facing features"]
  node_framegen["Frame generation"]
  node_low_latency["Low-latency inputs<br/>[input_common.cpp]"]
  node_plugins["Plugin registry<br/>[PluginRegistry.h]"]
end

subgraph group_support["Runtime support"]
  node_support["Shared runtime utilities<br/>[SysUtils.h]"]
  node_logger["Logging<br/>[Logger.h]"]
  node_latency_rule["Latency configuration rules"]
end

node_game(("Game"))

node_game -->|"loads mod"| node_dll
node_dll -->|"reads settings"| node_config
node_dll -->|"installs hooks"| node_hooks
node_dll -->|"loads plugins"| node_plugins
node_game -.->|"dispatches upscaling"| node_fsr_inputs
node_fsr_inputs -->|"adapts dispatch"| node_nr_dx12
node_hooks -.->|"tracks resources"| node_res_track
node_hooks -->|"intercepts Vulkan"| node_nr_vk
node_nr_dx12 -.->|"reuses detail"| node_detail_reuse
node_nrmenu -->|"edits settings"| node_config
node_menu -.->|"opens controls"| node_nrmenu
node_config -->|"configures runtime"| node_state
node_nr_dx12 -.->|"uses profiles"| node_profiles
node_nr_dx12 -.->|"applies colour"| node_lut
node_game -.->|"requests frame generation"| node_framegen
node_game -.->|"requests latency control"| node_low_latency
node_dll -->|"uses runtime helpers"| node_support
node_dll -->|"logs startup"| node_logger
node_config -->|"includes rules"| node_latency_rule
node_native -.->|"supports native mode"| node_nr_dx12

click node_dll "https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/dllmain.cpp"
click node_config "https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/Config.h"
click node_state "https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/State.h"
click node_menu "https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/menu/menu_common.cpp"
click node_nrmenu "https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/dlssnr/DlssNr_Menu.cpp"
click node_hooks "https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/hooks/VulkanwDx12_Hooks.cpp"
click node_res_track "https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/resource_tracking/ResTrack_dx12.cpp"
click node_fsr_inputs "https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/inputs/FSR2_Dx12.cpp"
click node_upscalers "https://github.com/janblade/optiscaler-f5-dlssnr-multipass/tree/main/OptiScaler/upscalers"
click node_nr_dx12 "https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/dlssnr/DlssNrFeature_Dx12.h"
click node_nr_vk "https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/dlssnr/DlssNrFeature_Vk.cpp"
click node_detail_reuse "https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/dlssnr/DlssNrDetailReuseHost.h"
click node_lut "https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/dlssnr/DlssNr_LutChain.h"
click node_profiles "https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/dlssnr/DlssNr_Profiles.h"
click node_framegen "https://github.com/janblade/optiscaler-f5-dlssnr-multipass/tree/main/OptiScaler/framegen"
click node_low_latency "https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/low_latency/input/input_common.cpp"
click node_plugins "https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/plugins/PluginRegistry.h"
click node_native "https://github.com/janblade/optiscaler-f5-dlssnr-multipass/tree/main/OptiScaler/native"
click node_support "https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/SysUtils.h"
click node_logger "https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/Logger.h"
click node_latency_rule "https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/native/NativeLowLatencyRule.h"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dll,node_config,node_state,node_menu toneBlue
class node_hooks,node_res_track,node_fsr_inputs,node_upscalers,node_native toneAmber
class node_nrmenu,node_nr_dx12,node_nr_vk,node_detail_reuse,node_lut,node_profiles toneMint
class node_framegen,node_low_latency,node_plugins toneRose
class node_support,node_logger,node_latency_rule,node_game toneIndigo
```

## Components

### Injection and configuration

- [DLL entry and loading](https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/dllmain.cpp): `OptiScaler/dllmain.cpp`
- [Settings](https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/Config.h): `OptiScaler/Config.h`
- [Runtime state](https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/State.h): `OptiScaler/State.h`
- [In-game menu](https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/menu/menu_common.cpp): `OptiScaler/menu/menu_common.cpp`

### Graphics interception

- [Graphics and API hooks](https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/hooks/VulkanwDx12_Hooks.cpp): `OptiScaler/hooks/VulkanwDx12_Hooks.cpp`
- [DX12 resource tracking](https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/resource_tracking/ResTrack_dx12.cpp): `OptiScaler/resource_tracking/ResTrack_dx12.cpp`
- [FSR2 input adapter](https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/inputs/FSR2_Dx12.cpp): `OptiScaler/inputs/FSR2_Dx12.cpp`
- [Upscaler adapters](https://github.com/janblade/optiscaler-f5-dlssnr-multipass/tree/main/OptiScaler/upscalers): `OptiScaler/upscalers`
- [Native frame pipeline](https://github.com/janblade/optiscaler-f5-dlssnr-multipass/tree/main/OptiScaler/native): `OptiScaler/native`

### Neural rendering

- [Neural settings UI](https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/dlssnr/DlssNr_Menu.cpp): `OptiScaler/dlssnr/DlssNr_Menu.cpp`
- [DLSS NR DX12 feature](https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/dlssnr/DlssNrFeature_Dx12.h): `OptiScaler/dlssnr/DlssNrFeature_Dx12.h`
- [DLSS NR Vulkan feature](https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/dlssnr/DlssNrFeature_Vk.cpp): `OptiScaler/dlssnr/DlssNrFeature_Vk.cpp`
- [Temporal detail reuse](https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/dlssnr/DlssNrDetailReuseHost.h): `OptiScaler/dlssnr/DlssNrDetailReuseHost.h`
- [Colour LUT chain](https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/dlssnr/DlssNr_LutChain.h): `OptiScaler/dlssnr/DlssNr_LutChain.h`
- [Pass profiles](https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/dlssnr/DlssNr_Profiles.h): `OptiScaler/dlssnr/DlssNr_Profiles.h`

### Game-facing features

- [Frame generation](https://github.com/janblade/optiscaler-f5-dlssnr-multipass/tree/main/OptiScaler/framegen): `OptiScaler/framegen`
- [Low-latency inputs](https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/low_latency/input/input_common.cpp): `OptiScaler/low_latency/input/input_common.cpp`
- [Plugin registry](https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/plugins/PluginRegistry.h): `OptiScaler/plugins/PluginRegistry.h`

### Runtime support

- [Shared runtime utilities](https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/SysUtils.h): `OptiScaler/SysUtils.h`
- [Logging](https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/Logger.h): `OptiScaler/Logger.h`
- [Latency configuration rules](https://github.com/janblade/optiscaler-f5-dlssnr-multipass/blob/main/OptiScaler/native/NativeLowLatencyRule.h): `OptiScaler/native/NativeLowLatencyRule.h`

### Other components

- **Game**

## Connections

- Game → DLL entry and loading: loads mod (evidence: `OptiScaler/dllmain.cpp`)
- DLL entry and loading → Settings: reads settings (evidence: `OptiScaler/dllmain.cpp`)
- DLL entry and loading → Graphics and API hooks: installs hooks (evidence: `OptiScaler/dllmain.cpp`)
- DLL entry and loading → Plugin registry: loads plugins (evidence: `OptiScaler/dllmain.cpp`)
- Game → FSR2 input adapter: dispatches upscaling
- FSR2 input adapter → DLSS NR DX12 feature: adapts dispatch (evidence: `OptiScaler/inputs/FSR2_Dx12.cpp`)
- Graphics and API hooks → DX12 resource tracking: tracks resources
- Graphics and API hooks → DLSS NR Vulkan feature: intercepts Vulkan (evidence: `OptiScaler/hooks/VulkanwDx12_Hooks.cpp`)
- DLSS NR DX12 feature → Temporal detail reuse: reuses detail
- Neural settings UI → Settings: edits settings (evidence: `OptiScaler/dlssnr/DlssNr_Menu.cpp`)
- In-game menu → Neural settings UI: opens controls
- Settings → Runtime state: configures runtime (evidence: `OptiScaler/Config.h`)
- DLSS NR DX12 feature → Pass profiles: uses profiles
- DLSS NR DX12 feature → Colour LUT chain: applies colour
- Game → Frame generation: requests frame generation
- Game → Low-latency inputs: requests latency control
- DLL entry and loading → Shared runtime utilities: uses runtime helpers (evidence: `OptiScaler/dllmain.cpp`)
- DLL entry and loading → Logging: logs startup (evidence: `OptiScaler/dllmain.cpp`)
- Settings → Latency configuration rules: includes rules (evidence: `OptiScaler/Config.h`)
- Native frame pipeline → DLSS NR DX12 feature: supports native mode
