# apex-compute/anr architecture

> Architecture diagram of the GitHub repository apex-compute/anr, 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/apex-compute/anr
- Repository: https://github.com/apex-compute/anr

## Overview

This repository’s documented runtime product is nr-record plus the renderer-based comparison and capture viewer, rather than the separately packaged ANR frame-generation runtime. The main workflow captures FG or upscaler inputs, replays recordings through selected generators, turns outputs into videos or images, then compares them in the viewer. README statements and the supplied source index support the major workflow; several viewer and replay subsystem details are unsampled, so uncertain internal links are omitted.

Main entry points: [`record/recorder.cpp`](https://github.com/apex-compute/anr/blob/main/record/recorder.cpp) (Recorder), [`renderer/clips/clip_viewer.cpp`](https://github.com/apex-compute/anr/blob/main/renderer/clips/clip_viewer.cpp) (Compare Viewer), [`record/capture/capture.cpp`](https://github.com/apex-compute/anr/blob/main/record/capture/capture.cpp) (FG Capture DLL), [`record/reader.cpp`](https://github.com/apex-compute/anr/blob/main/record/reader.cpp) (Recording Reader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Game Capture"]
  node_fg_capture["FG Capture DLL<br/>[capture.cpp]"]
  node_sr_capture["SR Capture DLL<br/>[sr_capture.cpp]"]
  node_sr_host["SR Host<br/>[sr_host.cpp]"]
  node_recorder["Recorder<br/>[recorder.cpp]"]
  node_gpu_packing["GPU Packing<br/>[d3d12_packer.cpp]"]
  node_vulkan_ring["Vulkan Ring<br/>[vulkan_ring.cpp]"]
  node_recording["Recording Folder"]
end

subgraph group_replay["Replay and Media"]
  node_record_reader["Recording Reader<br/>[reader.cpp]"]
  node_fg_replay["FG Replay<br/>[nr_replay.cpp]"]
  node_sr_replay["SR Replay<br/>[sr_replay.cpp]"]
  node_fg_generators["FG Generators<br/>[ngx_generator.cpp]"]
  node_sr_generators["SR Generators<br/>[sr_generators.cpp]"]
  node_frame_io["Replay Frame IO<br/>[frames.cpp]"]
  node_video_tools["Video Tools<br/>[nr_video.cpp]"]
end

subgraph group_viewer["Comparison Viewer"]
  node_renderer_main["Renderer Entry<br/>[main.cpp]"]
  node_clip_mode["Clip Modes<br/>[clip_session.cpp]"]
  node_clip_viewer["Compare Viewer<br/>[clip_viewer.cpp]"]
  node_capture_studio["Capture Studio<br/>[studio.cpp]"]
  node_capture_store[("Capture Store<br/>[store.cpp]")]
  node_video_sources["Video Sources"]
  node_exporter["Video Exporter<br/>[exporter.cpp]"]
end

subgraph group_runtime["Shared Runtime"]
  node_app["Window and Input<br/>[app.cpp]"]
  node_device_vulkan["Vulkan Support<br/>[vulkan.cpp]"]
end

node_game(("Game"))
node_generator_dll["Generator DLL"]
node_ffmpeg["FFmpeg Tools"]
node_user(("Operator"))

node_game -->|"supplies FG inputs"| node_fg_capture
node_game -->|"supplies SR inputs"| node_sr_capture
node_fg_capture -->|"records frames"| node_recorder
node_sr_capture -->|"records frames"| node_recorder
node_sr_host -->|"hosts upscaler"| node_sr_capture
node_recorder -->|"packs textures"| node_gpu_packing
node_recorder -->|"uses Vulkan ring"| node_vulkan_ring
node_recorder -->|"writes recording"| node_recording
node_user -->|"starts capture"| node_game
node_recording -->|"opens recording"| node_record_reader
node_record_reader -->|"provides frames"| node_fg_replay
node_record_reader -->|"provides frames"| node_sr_replay
node_fg_replay -->|"dispatches generator"| node_fg_generators
node_sr_replay -->|"dispatches generator"| node_sr_generators
node_fg_generators -->|"invokes DLL"| node_generator_dll
node_sr_generators -->|"invokes upscaler"| node_generator_dll
node_fg_replay -->|"writes replay frames"| node_frame_io
node_sr_replay -->|"writes replay frames"| node_frame_io
node_frame_io -->|"streams frames"| node_video_tools
node_video_tools -->|"uses ffmpeg"| node_ffmpeg
node_user -->|"launches viewer"| node_renderer_main
node_renderer_main -->|"dispatches clip mode"| node_clip_mode
node_clip_mode -->|"runs comparison"| node_clip_viewer
node_clip_viewer -->|"opens videos"| node_video_sources
node_clip_viewer -->|"exports comparison"| node_exporter
node_clip_mode -->|"runs captures mode"| node_capture_studio
node_capture_studio -->|"loads capture data"| node_capture_store
node_clip_viewer -.->|"uses window loop"| node_app
node_capture_studio -.->|"uses window loop"| node_app
node_fg_capture -.->|"supports Vulkan"| node_device_vulkan

click node_fg_capture "https://github.com/apex-compute/anr/blob/main/record/capture/capture.cpp"
click node_sr_capture "https://github.com/apex-compute/anr/blob/main/record/capture/sr_capture.cpp"
click node_sr_host "https://github.com/apex-compute/anr/blob/main/record/capture/sr_host.cpp"
click node_recorder "https://github.com/apex-compute/anr/blob/main/record/recorder.cpp"
click node_gpu_packing "https://github.com/apex-compute/anr/blob/main/record/d3d12_packer.cpp"
click node_vulkan_ring "https://github.com/apex-compute/anr/blob/main/record/vulkan_ring.cpp"
click node_record_reader "https://github.com/apex-compute/anr/blob/main/record/reader.cpp"
click node_fg_replay "https://github.com/apex-compute/anr/blob/main/record/replay/nr_replay.cpp"
click node_sr_replay "https://github.com/apex-compute/anr/blob/main/record/replay/sr_replay.cpp"
click node_fg_generators "https://github.com/apex-compute/anr/blob/main/record/replay/ngx_generator.cpp"
click node_sr_generators "https://github.com/apex-compute/anr/blob/main/record/replay/sr_generators.cpp"
click node_frame_io "https://github.com/apex-compute/anr/blob/main/record/replay/frames.cpp"
click node_video_tools "https://github.com/apex-compute/anr/blob/main/record/replay/nr_video.cpp"
click node_renderer_main "https://github.com/apex-compute/anr/blob/main/renderer/main.cpp"
click node_clip_mode "https://github.com/apex-compute/anr/blob/main/renderer/clips/clip_session.cpp"
click node_clip_viewer "https://github.com/apex-compute/anr/blob/main/renderer/clips/clip_viewer.cpp"
click node_capture_studio "https://github.com/apex-compute/anr/blob/main/renderer/clips/captures/studio.cpp"
click node_capture_store "https://github.com/apex-compute/anr/blob/main/renderer/clips/captures/store.cpp"
click node_video_sources "https://github.com/apex-compute/anr/blob/main/renderer/clips/video/nri_video_source.cpp"
click node_exporter "https://github.com/apex-compute/anr/blob/main/renderer/clips/exporter.cpp"
click node_app "https://github.com/apex-compute/anr/blob/main/renderer/app.cpp"
click node_device_vulkan "https://github.com/apex-compute/anr/blob/main/device/vulkan.cpp"

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_fg_capture,node_sr_capture,node_sr_host,node_recorder,node_gpu_packing,node_vulkan_ring,node_recording toneBlue
class node_record_reader,node_fg_replay,node_sr_replay,node_fg_generators,node_sr_generators,node_frame_io,node_video_tools toneAmber
class node_renderer_main,node_clip_mode,node_clip_viewer,node_capture_studio,node_capture_store,node_video_sources,node_exporter toneMint
class node_app,node_device_vulkan toneRose
class node_game,node_generator_dll,node_ffmpeg,node_user toneIndigo
```

## Components

### Game Capture

- [FG Capture DLL](https://github.com/apex-compute/anr/blob/main/record/capture/capture.cpp): `record/capture/capture.cpp`
- [SR Capture DLL](https://github.com/apex-compute/anr/blob/main/record/capture/sr_capture.cpp): `record/capture/sr_capture.cpp`
- [SR Host](https://github.com/apex-compute/anr/blob/main/record/capture/sr_host.cpp): `record/capture/sr_host.cpp`
- [Recorder](https://github.com/apex-compute/anr/blob/main/record/recorder.cpp): `record/recorder.cpp`
- [GPU Packing](https://github.com/apex-compute/anr/blob/main/record/d3d12_packer.cpp): `record/d3d12_packer.cpp`
- [Vulkan Ring](https://github.com/apex-compute/anr/blob/main/record/vulkan_ring.cpp): `record/vulkan_ring.cpp`
- **Recording Folder**

### Replay and Media

- [Recording Reader](https://github.com/apex-compute/anr/blob/main/record/reader.cpp): `record/reader.cpp`
- [FG Replay](https://github.com/apex-compute/anr/blob/main/record/replay/nr_replay.cpp): `record/replay/nr_replay.cpp`
- [SR Replay](https://github.com/apex-compute/anr/blob/main/record/replay/sr_replay.cpp): `record/replay/sr_replay.cpp`
- [FG Generators](https://github.com/apex-compute/anr/blob/main/record/replay/ngx_generator.cpp): `record/replay/ngx_generator.cpp`
- [SR Generators](https://github.com/apex-compute/anr/blob/main/record/replay/sr_generators.cpp): `record/replay/sr_generators.cpp`
- [Replay Frame IO](https://github.com/apex-compute/anr/blob/main/record/replay/frames.cpp): `record/replay/frames.cpp`
- [Video Tools](https://github.com/apex-compute/anr/blob/main/record/replay/nr_video.cpp): `record/replay/nr_video.cpp`

### Comparison Viewer

- [Renderer Entry](https://github.com/apex-compute/anr/blob/main/renderer/main.cpp): `renderer/main.cpp`
- [Clip Modes](https://github.com/apex-compute/anr/blob/main/renderer/clips/clip_session.cpp): `renderer/clips/clip_session.cpp`
- [Compare Viewer](https://github.com/apex-compute/anr/blob/main/renderer/clips/clip_viewer.cpp): `renderer/clips/clip_viewer.cpp`
- [Capture Studio](https://github.com/apex-compute/anr/blob/main/renderer/clips/captures/studio.cpp): `renderer/clips/captures/studio.cpp`
- [Capture Store](https://github.com/apex-compute/anr/blob/main/renderer/clips/captures/store.cpp): `renderer/clips/captures/store.cpp`
- [Video Sources](https://github.com/apex-compute/anr/blob/main/renderer/clips/video/nri_video_source.cpp): `renderer/clips/video/nri_video_source.cpp`
- [Video Exporter](https://github.com/apex-compute/anr/blob/main/renderer/clips/exporter.cpp): `renderer/clips/exporter.cpp`

### Shared Runtime

- [Window and Input](https://github.com/apex-compute/anr/blob/main/renderer/app.cpp): `renderer/app.cpp`
- [Vulkan Support](https://github.com/apex-compute/anr/blob/main/device/vulkan.cpp): `device/vulkan.cpp`

### Other components

- **Game**
- **Generator DLL**
- **FFmpeg Tools**
- **Operator**

## Connections

- Game → FG Capture DLL: supplies FG inputs (evidence: `README.md`)
- Game → SR Capture DLL: supplies SR inputs (evidence: `README.md`)
- FG Capture DLL → Recorder: records frames (evidence: `record/capture/capture.cpp`)
- SR Capture DLL → Recorder: records frames (evidence: `record/capture/sr_capture.cpp`)
- SR Host → SR Capture DLL: hosts upscaler (evidence: `record/capture/sr_host.cpp`)
- Recorder → GPU Packing: packs textures
- Recorder → Vulkan Ring: uses Vulkan ring
- Recorder → Recording Folder: writes recording
- Operator → Game: starts capture (evidence: `README.md`)
- Recording Folder → Recording Reader: opens recording
- Recording Reader → FG Replay: provides frames (evidence: `record/replay/nr_replay.cpp`)
- Recording Reader → SR Replay: provides frames (evidence: `record/replay/sr_replay.cpp`)
- FG Replay → FG Generators: dispatches generator (evidence: `record/replay/nr_replay.cpp`)
- SR Replay → SR Generators: dispatches generator (evidence: `record/replay/sr_replay.cpp`)
- FG Generators → Generator DLL: invokes DLL (evidence: `README.md`)
- SR Generators → Generator DLL: invokes upscaler (evidence: `README.md`)
- FG Replay → Replay Frame IO: writes replay frames (evidence: `record/replay/nr_replay.cpp`)
- SR Replay → Replay Frame IO: writes replay frames (evidence: `record/replay/sr_replay.cpp`)
- Replay Frame IO → Video Tools: streams frames (evidence: `README.md`)
- Video Tools → FFmpeg Tools: uses ffmpeg (evidence: `README.md`)
- Operator → Renderer Entry: launches viewer (evidence: `README.md`)
- Renderer Entry → Clip Modes: dispatches clip mode (evidence: `renderer/main.cpp`)
- Clip Modes → Compare Viewer: runs comparison (evidence: `renderer/clips/clip_session.cpp`)
- Compare Viewer → Video Sources: opens videos (evidence: `README.md`)
- Compare Viewer → Video Exporter: exports comparison
- Clip Modes → Capture Studio: runs captures mode (evidence: `README.md`)
- Capture Studio → Capture Store: loads capture data
- Compare Viewer → Window and Input: uses window loop
- Capture Studio → Window and Input: uses window loop
- FG Capture DLL → Vulkan Support: supports Vulkan
