Compare commits

...
Author SHA1 Message Date
poli0981andClaude Opus 5.5 ca05d33641 release: 0.1.0-beta.34 - its changelog file (DLSS 5 and DLSS 4.5 from evidence, filters, Games at once), HANDOFF's beta.34 section (D83-D87), owner-only item 30, the release lines (beta.34 PR-7)
docs/changelog/0.1.0-beta.34.md takes [Unreleased] as it stood (#356-#361)
under a summary and the update paragraph: the Disclaimer 2.13 and the
Privacy Policy 2.14 once, schema 22 (a beta.33 cannot open it), rules
2026.11.2. HANDOFF's beta.33 START HERE (with its alpha.2 lines) moves
verbatim to docs/handoff/history/0.1.0-beta.33.md with its row; the new START
HERE carries D83-D87, the choices, what was measured and the traps
(notice-check reads the index, the native token test's exact mask, WPF UI's
navigation cache and pane template, Microsoft.Data.Sqlite's synchronous
async); owner-only item 30 is beta.34 on real hardware; D87's row. README,
ACCURACY, the Disclaimer's accuracy block and LIMITATIONS name
0.1.0-beta.34.

One wording fix found while writing the notes, before the release: D83's
evidence is DLSS Frame Generation IDENTIFIED in the session (fg_mode =
dlssg), as DlssText reads it - its factor need not have been counted - and
five places written in #357 said "counted" (05_DETECTION twice, spike-notes
§26, the changelog entry, HANDOFF's D83 row), with DlssText's and the test's
comments. DlssTextTests now pins it: Dynamic applied with DLSS Frame
Generation identified and the count refused (non_uniform) reads DLSS 4.5.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-06 16:21:48 +07:00
poli0981andClaude Opus 5.5 f66d98eb78 docs: the tested-games list from a copy of the ledger of 2026-11-06 (D35) - fifteen more games measured, the first Xbox titles; the docs sweep across the train (beta.34 PR-6) (#361)
Owner request 2026-11-06, item 5: review, update and sync the documents and the
tested-games list, from the database.

- docs/LIST_GAME_TESTED.md: refreshed from a copy of the owner's ledger taken
  2026-11-06 (read-only; 131 sessions of 27 games, the same as the live ledger
  when the commit was made), as drafted in the plan the owner approved: fifteen
  more Tier-1 rows (Phantom Blade Zero under Dynamic, Hogwarts Legacy loading
  DLSS 5's runtime, Valor Mortis and inKONBINI from the Xbox app, ...), seven
  rows updated, the Tier-2 sessions and the guard's refusals since 2026-09-27,
  the driver range and the engine versions read since.
- docs/08_UI.md: the DLSS line's two new rows (D83, D84); Compare over every
  session.
- docs/HANDOFF.md: item 28's tested-list step done.
- docs/open-questions/closed-s.md: S30 notes the fifth Streamline id decoded,
  from the vendor's header rather than by guess (row O4's warning).
- guide/08-settings.md: a language change stays on Settings.
- CHANGELOG.md: the entry.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-06 09:17:49 +00:00
poli0981andClaude Opus 5.5 efaf585928 feat: filters on Games and Compare; the Compare page's layout; the selected pane item keeps its label (D85, D86) (beta.34 PR-5) (#360)
Owner request 2026-11-06, items 3 and 4, with a screenshot of Compare.

- Games (D85): Store, Engine, State, Installed and Played beside the search
  and sort, with Clear filters; the title counts what is shown of all while a
  filter or the search narrows it. Kept while the App runs, not saved.
- Compare (D85): every session (it was the newest 200, one game lookup each;
  now one read of the names, off the UI thread), filtered by game, tier and
  frame generation, with a count; a ticked session stays listed.
- Compare layout: the selection bar on the left above the list with Clear
  selection; columns sized to what they hold and one filler column; the date
  sorts by when; the settings-changed cell says so or shows a dash; the
  result table's labels sit over their columns (MetricHeader bound).
- The pane (D86): our copy of WPF UI 4.3.0's LeftFluent item template
  without the IsActive collapse, so the selected page keeps its label.
- Strings en/vi/ja (ja review); 08_UI, guide/07-screens, CHANGELOG, HANDOFF.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-06 09:05:13 +00:00
poli0981andClaude Opus 5.5 a78d7bd359 feat: Games opens at once from any page - the window keeps the library page, cards before the executable checks; a language change keeps the page on screen (beta.34 PR-4) (#359)
The owner, 2026-11-06: switching to Games stalls 0.5-1.5 s; and changing the language in Settings
brings back the last game page instead of Settings.

- Measured first (spike-notes 27, a scratch test, not committed; 65 games, the first executable
  check held 800 ms for a USB drive waking): first cards 822-830 ms -> 10-15 ms; a revisit
  181-215 ms -> 15-16 ms; the first build unchanged (the non-virtualizing grid, by decision).
- WindowPageCache: the window's own page provider keeps the GamesPage it built (set after
  SetNavigationControl, which hands the NavigationView the container's provider; WPF UI's
  NavigationCacheMode is never read when a page provider is set). One per window, so a language
  change's new window builds its own.
- GamesViewModel: the library read on the thread pool; the cards listed before the executable
  checks, each getting its Not installed pill when its check answers; a read keeps every card that
  would look the same (GameCardViewModel.LooksLike, Sync - never Clear); the page reads the library
  again each time it is shown (Attach). The list view is bounded (MaxHeight 640).
- ShellHost notes every page the live window shows (pane clicks included), so a rebuild opens on
  the page on screen - Settings after a change made there.
- Tests: GamesViewModelTests (cards before the checks, a page shown again, Sync), WindowPageCacheTests
  (kept per window; the shell remembers the page on screen).
- Docs: 16_WPFUI_SYNTAX, wiki App-UI-development, 08_UI, 09_I18N, spike-notes 27, CHANGELOG.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-06 08:49:55 +00:00
poli0981andClaude Opus 5.5 c9b0aab862 feat: DLSS 5 is named where the game ran its neural rendering (schema 0022, rules 2026.11.2, Privacy 2.14); Streamline headers re-vendored at v2.14.16 (D84) (beta.34 PR-3) (#358)
The owner, 2026-11-06: Hogwarts Legacy with Neural Rendering on loaded DLSS 5's runtime
(nvngx_dlssnr.dll 310.9.16.0, from the game's folder) and the session could say only "DLSS 5
runtime loaded". Then: check what changed in recent Streamline versions, fix it if needed.

- Streamline: the vendored closure was v2.12.0 byte for byte; v2.14.16 changes three of its
  eleven files (kFeatureDLSS_NR = 1004, the uplift buffer types 70-72, kStructVersion7, the
  version). Re-vendored byte for byte; README provenance, THIRD_PARTY_NOTICES row.
- Overlay (hook path): the slEvaluateFeature detour decodes kFeatureDLSS_NR into its own bit;
  RecordPresent sets FL_FEAT_SL_NEURAL_RENDERING (feature byte bit 7, an enumerator - no layout
  change) under the condition every Streamline fact shares; the evaluate row's family also claims
  FL_HOOK_SL_NEURAL_RENDERING (bit 12), published with the detour. Overhead: decode unchanged
  within noise (4.7 ns a call), +0.14..0.19 ns a present.
- Agent: Domain.Metrics.NeuralRendering.SharePct; sessions.dlss_nr_pct (schema 0022) only from a
  writer that published the family - an older Overlay's silence is never a measured 0 %.
  CensusNames records sl.dlss_nr.dll.
- Rules 2026.11.2: capability dlss_nr -> "Supports DLSS 5 Neural Rendering".
- App (D84): DLSS 5 heads the DLSS line where it ran ("DLSS 5 (neural rendering on 97.3% of
  rendered frames)"); its library listed with version and source; measured 0 -> "runtime loaded,
  not seen running"; nothing to tell -> "runtime loaded" as before. CSV basis/pct.
- CaptureHost dev census: a kFeatureDLSS_NR bucket.
- Privacy Policy 2.14 (neural-rendering libraries); the accuracy block's DLSS 5 sentence.
- Tests: native guard_test (the new harness mode through an injected Overlay; 0xF00D lights no NR
  fact; the token case's exact mask gains the family), NeuralRenderingTests, SessionAggregatorTests,
  DlssGenerationTests, DlssTextTests (a row shaped from session 132), LedgerDatabaseTests (0022),
  the repository round trip, the rules fixture, RuntimeModuleSourcesTests, SlCensusTests.
- Docs: 05_DETECTION, 06_DATA_MODEL, 17_HOOK_ENGINE, LIMITATIONS, guide/03, guide/10, the accuracy
  block, spike-notes 26 (+ owner-only item 30(a)'s decision table), HANDOFF (D84), CHANGELOG.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-06 08:39:42 +00:00
poli0981andClaude Opus 5.5 569bacac95 feat: a session under the NVIDIA App's Dynamic frame generation reads DLSS 4.5; Disclaimer 2.13 (D83) (beta.34 PR-2) (#357)
The owner, 2026-11-06: Phantom Blade Zero under the NVIDIA App's Dynamic multi frame generation,
up to x3, read "DLSS 4" - but Dynamic (and x6) exist only in DLSS 4.5. The DLSS line named a
generation from the measured multiplier alone, and "up to x3" never passes x3.0.

- Domain: DlssEvidence.DynamicFrameGeneration, DlssBasis.DynamicFrameGeneration; the rule's new
  row sits below a measured x5 and above every DLSS 4 row.
- App: DlssText reads Dynamic as DLSS Frame Generation counted AND the game's driver profile
  setting NGX_DLSSG_MODE to 4 (NvidiaDriverSettings.DlssgModeDynamic, NVIDIA's own name) AND the
  driver's FG word reporting the mode override applied (FG_MODE). The driver's own mode number
  (3 Dynamic / 1 Fixed on all sixteen stored sessions) is recorded, not keyed on. Label "DLSS 4.5
  (Dynamic multi frame generation, set in the NVIDIA App)", CSV basis=dynamic_frame_generation.
  A Fixed multiplier names nothing by itself (Witcher 3 under Fixed x6 still presented x2.0).
- Dlss_Basis_Dynamic in en/vi/ja (ja review).
- Docs: 05_DETECTION (row + amendment), 03_METRICS (the ceiling decode confirmed), LIMITATIONS,
  guide/03, guide/10, the accuracy block re-dated 2026-11-06 + Disclaimer 2.13, spike-notes 26
  (new), HANDOFF decisions index (D83), CHANGELOG.
- Tests: DlssGenerationTests, DlssTextTests (a row shaped from the owner's session 129 and four
  negatives).

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-06 08:15:42 +00:00
poli0981andClaude Opus 5.5 f7bfe1e8f1 fix: an Xbox game's picture name that names a file's stream is passed over, not thrown on; the guard's note on GuardedInjectImpl sits above it again (beta.34 PR-1) (#356)
Two things a self-review of #351 and #352 found after their gates were green.

- XboxArtCache.Image: a ShellVisuals name in MicrosoftGame.config that points at a
  stream of a file, named like a drive ("Resources\a:b.png"), made the scale
  search's pattern "a:b.scale-*.png", and EnumerateFiles throws ArgumentException
  on a rooted pattern ("Second path fragment must not be a drive or UNC name") -
  which XboxArtCache.Find does not catch. GameArt.ForAsync's task then faulted:
  the game page showed no picture and logged an unobserved task, and a command
  that awaits the page's reload would reach the dispatcher's crash report. A name
  whose leaf holds ':' is now no picture, like a name outside the package. Red
  without the fix (the exact ArgumentException), green with it; no install of
  the owner's eleven titles has such a name (spike-notes §25).
- fl_guard.cpp: #352 put BlockingMitigation and TargetIsolationVerdict between
  GuardedInjectImpl and the comment that describes it ("A refusal returns here
  ... runs only for a target the full evaluation allowed"), so it read as the
  first line of BlockingMitigation's. It moves back above GuardedInjectImpl and
  names the target's isolation among what runs after the evaluation. No code
  change there.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-03 08:09:29 +00:00
poli0981andClaude Opus 5.5 405449283b docs: 0.1.0-alpha.2's notes - its changelog file opening with the experimental-build warning, its row, HANDOFF's alpha.2 lines, owner-only item 29 (D82) (alpha.2 PR-2) (#354)
The second alpha is the source of 0.1.0-beta.33 on .NET 11 RC3 (D82: right after
beta.33, on RC3 because the train reached it before .NET 11's release on
2026-11-10). Its notes are on main as every release's are; the alpha branch takes
them with the sync that follows this pull request (13_CI_CD §The alpha line).

- docs/changelog/0.1.0-alpha.2.md: the experimental-build warning, the update
  from alpha.1 (the ledger copy, the Privacy Policy 2.13 once, the Alpha notice's
  box again), installing over a beta and going back, and what differs from the
  beta - the same as alpha.1 from beta.32.
- CHANGELOG.md: its row in the Releases table.
- docs/HANDOFF.md: START HERE's "0.1.0-alpha.2" lines (the sync by a merge commit,
  the switch unchanged, the first delta an alpha's release has to find - #350's
  lookup) and owner-only item 29, the second alpha on real hardware.

No release line moves (README, ACCURACY, the Disclaimer's copy and LIMITATIONS
keep naming the newest beta).

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-03 07:37:51 +00:00
92 changed files with 2763 additions and 223 deletions

No files matched your search

+2
View File
@@ -41,6 +41,8 @@ Newest first. Each file holds that release's section exactly as it stood here.
| Version | Date | Notes |
|---|---|---|
| `0.1.0-beta.34` | 2026-11-06 | [`docs/changelog/0.1.0-beta.34.md`](docs/changelog/0.1.0-beta.34.md) |
| `0.1.0-alpha.2` | 2026-11-03 | [`docs/changelog/0.1.0-alpha.2.md`](docs/changelog/0.1.0-alpha.2.md) |
| `0.1.0-beta.33` | 2026-11-03 | [`docs/changelog/0.1.0-beta.33.md`](docs/changelog/0.1.0-beta.33.md) |
| `0.1.0-alpha.1` | 2026-10-31 | [`docs/changelog/0.1.0-alpha.1.md`](docs/changelog/0.1.0-alpha.1.md) |
| `0.1.0-beta.32` | 2026-10-31 | [`docs/changelog/0.1.0-beta.32.md`](docs/changelog/0.1.0-beta.32.md) |
+8 -3
View File
@@ -5,7 +5,7 @@ hooking on for — and reading the graphics calls the game makes. That is why it
resolution, the upscaler, frame generation and ray tracing apart. It is also where its limits come from. This
page lists them in plain words; each item links to the document that has the details.
*Beta software: this page describes version 0.1.0-beta.33.*
*Beta software: this page describes version 0.1.0-beta.34.*
## Games it will not measure
@@ -106,8 +106,13 @@ shown is recorded too, from outside the game. ([Capture](docs/04_CAPTURE.md))
show neither the driver's report nor the NVIDIA App's mode. ([Metrics](docs/03_METRICS.md))
- **Which DLSS ran** (since 0.1.0-beta.24) is named only from what the session showed: the model preset the NVIDIA
driver reports (L or M: DLSS 4.5; J or K: DLSS 4), a measured multi-frame factor (×5 or ×6: DLSS 4.5; ×3 or ×4:
DLSS 4), or a library whose major version names one (2.x, 3.x). A 310 library with no such evidence shows its
version only. DLSS 5 is shown only as *runtime loaded*, by a library name not yet seen on a real game. Where each
DLSS 4), the NVIDIA App's *Dynamic* frame generation that the driver reports applied (DLSS 4.5, whatever multiplier
it chose — since 0.1.0-beta.34), or a library whose major version names one (2.x, 3.x). A *Fixed* ×5 or ×6 set in
the App names DLSS 4.5 only when the frames show it. A 310 library with no such evidence shows its
version only. ~~DLSS 5 is shown only as *runtime loaded*, by a library name not yet seen on a real game.~~ **DLSS 5**
(since 0.1.0-beta.34) is named where the game was seen running its neural rendering through Streamline, with the share
of rendered frames; its library loaded and nothing seen reads *runtime loaded* — *not seen running* only where the
Overlay looked. A game that runs neural rendering outside Streamline is not seen. Where each
library was loaded from is read from its folder, for sessions recorded since 0.1.0-beta.24.
- **Ray tracing** is *Yes*, *No* or *N/A* — measured from the game's ray-tracing calls on Direct3D 12, and
N/A where FrameLedger could not look. **Path tracing is never stated as a fact**: there is no API signal
+6 -4
View File
@@ -11,8 +11,8 @@ guide, Help ▸ Limitations), and on the project's [wiki](https://github.com/pol
pages.
<!-- accuracy-block:begin -->
> ⚠ **What FrameLedger actually measures today — 2026-10-19.** The software is a beta; its latest
> **beta is `0.1.0-beta.33`** (2026-11-03), an unsigned installer built from that tag with its
> ⚠ **What FrameLedger actually measures today — 2026-11-06.** The software is a beta; its latest
> **beta is `0.1.0-beta.34`** (2026-11-06), an unsigned installer built from that tag with its
> checksums published beside it (alphas — experimental builds on a prerelease .NET — are published apart). The source holds the desktop app
> (library, store import, charts, settings) and the background Agent, which records a session when a
> game in the library runs (unless you switched its recording off), injects only into games you enabled
@@ -44,7 +44,9 @@ pages.
> every other case — FSR at a dynamic resolution among them — no mode is shown.
> - **DLSS version:** the version of each DLSS library the game loaded and whether it came from the game or from
> the NVIDIA driver; "DLSS 4" or "DLSS 4.5" only when the session shows it (the model preset the driver reports,
> or a measured multi-frame factor); DLSS 5 only as "runtime loaded".
> a measured multi-frame factor, or the NVIDIA App's Dynamic frame generation that the driver reports applied);
> "DLSS 5" only when the game was seen running its neural rendering, otherwise "runtime loaded" when its library was
> loaded.
> - **Render → output resolution:** measured where the vendor's own per-frame call carries the render
> size (AMD FidelityFX dispatches, and Streamline titles whose resource tags state it); `N/A` where it
> does not: DLSS titles that bypass Streamline, Streamline titles whose tags carry no size, and Vulkan
@@ -174,7 +176,7 @@ Elevation is **optional — for everything.** Hooked capture is the normal path
## Install
> **The latest beta is `v0.1.0-beta.33` (2026-11-03); before it `v0.1.0-beta.32` (2026-10-31), `v0.1.0-beta.31` (2026-10-26), `v0.1.0-beta.30` (2026-10-26), `v0.1.0-beta.29` (2026-10-25), `v0.1.0-beta.28` (2026-10-20), `v0.1.0-beta.27` (2026-10-20), `v0.1.0-beta.26` (2026-10-19), `v0.1.0-beta.25` (2026-10-19), `v0.1.0-beta.24` (2026-10-19), `v0.1.0-beta.23` (2026-10-14), `v0.1.0-beta.22` (2026-10-13), `v0.1.0-beta.21` (2026-10-13), `v0.1.0-beta.20` (2026-10-12), `v0.1.0-beta.19` (2026-10-12), `v0.1.0-beta.18` (2026-10-07), `v0.1.0-beta.17` (2026-10-07), `v0.1.0-beta.16` (2026-10-06), `v0.1.0-beta.15` (2026-10-06), `v0.1.0-beta.14` (2026-10-06), `v0.1.0-beta.13` (2026-10-04), `v0.1.0-beta.12` (2026-10-04), `v0.1.0-beta.11` (2026-10-03), `v0.1.0-beta.10` (2026-09-28), `v0.1.0-beta.9` (2026-09-26), `v0.1.0-beta.8` (2026-09-25), `v0.1.0-beta.7` (2026-09-23), `v0.1.0-beta.6` (2026-09-23), `v0.1.0-beta.5` (2026-09-22), `v0.1.0-beta.4` (2026-09-21), `v0.1.0-beta.3` (2026-09-21), `v0.1.0-beta.2` (2026-09-17) and `v0.1.0-beta.1` (2026-09-16).** They are pre-releases: read the notes of the one you install — `CHANGELOG.md` links each release's own file under `docs/changelog/` — for what it measures, what it does not yet, and how to update, before installing. A source build is `docs/12_BUILD.md`.
> **The latest beta is `v0.1.0-beta.34` (2026-11-06); before it `v0.1.0-beta.33` (2026-11-03), `v0.1.0-beta.32` (2026-10-31), `v0.1.0-beta.31` (2026-10-26), `v0.1.0-beta.30` (2026-10-26), `v0.1.0-beta.29` (2026-10-25), `v0.1.0-beta.28` (2026-10-20), `v0.1.0-beta.27` (2026-10-20), `v0.1.0-beta.26` (2026-10-19), `v0.1.0-beta.25` (2026-10-19), `v0.1.0-beta.24` (2026-10-19), `v0.1.0-beta.23` (2026-10-14), `v0.1.0-beta.22` (2026-10-13), `v0.1.0-beta.21` (2026-10-13), `v0.1.0-beta.20` (2026-10-12), `v0.1.0-beta.19` (2026-10-12), `v0.1.0-beta.18` (2026-10-07), `v0.1.0-beta.17` (2026-10-07), `v0.1.0-beta.16` (2026-10-06), `v0.1.0-beta.15` (2026-10-06), `v0.1.0-beta.14` (2026-10-06), `v0.1.0-beta.13` (2026-10-04), `v0.1.0-beta.12` (2026-10-04), `v0.1.0-beta.11` (2026-10-03), `v0.1.0-beta.10` (2026-09-28), `v0.1.0-beta.9` (2026-09-26), `v0.1.0-beta.8` (2026-09-25), `v0.1.0-beta.7` (2026-09-23), `v0.1.0-beta.6` (2026-09-23), `v0.1.0-beta.5` (2026-09-22), `v0.1.0-beta.4` (2026-09-21), `v0.1.0-beta.3` (2026-09-21), `v0.1.0-beta.2` (2026-09-17) and `v0.1.0-beta.1` (2026-09-16).** They are pre-releases: read the notes of the one you install — `CHANGELOG.md` links each release's own file under `docs/changelog/` — for what it measures, what it does not yet, and how to update, before installing. A source build is `docs/12_BUILD.md`.
1. Download the latest `FrameLedger.App-win-Setup.exe` from [Releases](https://github.com/poli0981/frameledger/releases). It installs into `%LOCALAPPDATA%\FrameLedger.App`; your data stays in `%LOCALAPPDATA%\FrameLedger`, and uninstalling asks before touching it.
2. SmartScreen may warn — releases are not code-signed (free, open-source project). Verify the SHA-256 checksum published with each release, then **More info → Run anyway**.
+4 -1
View File
@@ -535,7 +535,10 @@ F_app = Σ fgEvaluations (APPLICATION frames, counted at the
> in a game's menu is not read — it reaches the runtime through `sl::DLSSGOptions`, the route `HANDOFF` §2b refused —
> so the measured row is its evidence. The dynamic ceiling (`NGX_DLSSG_DYNAMIC_MULTI_FRAME_COUNT_MAX`) is decoded as
> `NGX_DLSSG_MULTI_FRAME_COUNT` is (frames generated per rendered frame) and the automatic target as "max refresh
> rate"; NVIDIA's header names neither, and owner-only item 20(a) checks both against the App.
> rate"; NVIDIA's header names neither, and owner-only item 20(a) checks both against the App. *(2026-11-06, beta.34:
> the ceiling's decode held on the owner's Phantom Blade Zero — a ceiling of 5 held states up to ×6.0, a ceiling of 2
> nothing above ×3.0 — `spike-notes` §26. And the context line is no longer the only place the Dynamic mode shows: the
> DLSS line names DLSS 4.5 where the driver reports Dynamic applied, D83, `05_DETECTION` §DLSS generation.)*
`fgEvaluations` is recorded per present by ~~the NGX/Streamline/FFX/XeSS FG hooks~~ the `slGetNewFrameToken`
detour; where Streamline never issued a token, by the FidelityFX dispatches — new PREPARE `frameID`s, else UPSCALE
+32 -3
View File
@@ -482,12 +482,27 @@ never the path), and the super-resolution preset the driver reports applied:
|---|---|---|
| Super-resolution render preset **L or M** that the NVIDIA driver reports applied, in a session where super resolution ran | DLSS 4.5 (2nd-gen transformer) | `ngx_driver_words` — the SR word's `PRESET` bit and `renderPreset`; presets L/M arrived with DLL 310.5.0 (NVIDIA's DLSS 4.5 release, driver 591.74) |
| A DLSS Frame Generation state measured at **×5 or more** | DLSS 4.5 (Dynamic / 6× multi-frame generation) | `fg_mix` / `fg_factor` with `fg_mode = dlssg` |
| The NVIDIA App's **Dynamic** frame generation — set in the game's profile and reported applied by the driver — in a session where DLSS Frame Generation was identified *(beta.34, owner decision D83)* | DLSS 4.5 (Dynamic multi frame generation, set in the NVIDIA App) | `driver_profile`'s `NGX_DLSSG_MODE` = 4 (dynamic), `ngx_driver_words`' FG word with `FG_MODE` (bit 13), `fg_mode = dlssg` |
| Preset **J or K** reported applied | DLSS 4 (transformer) | as above |
| A DLSS Frame Generation state at **×3 or ×4** | DLSS 4 (multi-frame generation) | as above |
| `nvngx_dlss.dll` **2.x** | DLSS 2 | `runtime_modules` |
| `nvngx_dlss.dll` **3.x**, or `nvngx_dlssg.dll` **1.x–3.x** | DLSS 3 | `runtime_modules` |
| A **310.x** library alone, a CNN preset (A–F), ×2 | *no label* — the versions are shown | DLSS 4 and 4.5 ship the same major number; the preset is what names the model |
| `nvngx_dlssnr.dll` loaded | "DLSS 5 runtime loaded" — never a generation of these features | the module name is community-sourced until owner-only item 20(d) sees it load |
| ~~`nvngx_dlssnr.dll` loaded~~ | ~~"DLSS 5 runtime loaded" — never a generation of these features~~ | ~~the module name is community-sourced until owner-only item 20(d) sees it load~~ *(replaced 2026-11-06 by the two rows below, D84)* |
| DLSS 5's neural rendering **evaluated** — `kFeatureDLSS_NR` (Streamline 2.14) on some of the frames the game rendered through Streamline, seen by an Overlay that decodes it *(beta.34, owner decision D84)* | DLSS 5 (neural rendering on N % of rendered frames) — **heads the table** | `dlss_nr_pct` (schema 0022), from `FL_FEAT_SL_NEURAL_RENDERING` under `FL_HOOK_SL_NEURAL_RENDERING` |
| `nvngx_dlssnr.dll` loaded, neural rendering not seen evaluated | "DLSS 5 runtime loaded" — and "…, not seen running" where an Overlay that decodes it drained Streamline batches and none carried it (0 %); never a generation | `runtime_modules` (the name seen on Hogwarts Legacy, 2026-11-06) and `dlss_nr_pct` |
**Amended 2026-11-06 (beta.34, owner decision D83): Dynamic is DLSS 4.5's.** The NVIDIA App's *Dynamic* frame
generation and its ×6 mode exist only in DLSS 4.5, so a session the driver reports running Dynamic is DLSS 4.5 whatever
multiplier the mode chose: the owner's Phantom Blade Zero under *Dynamic, up to ×3* held ×2.0 and ×3.0 — nine hooked sessions
from 2026-11-03 to 11-05 — and read *DLSS 4 (a ×3.0 frame-generation state)* until then. The row needs all three: the
profile's Dynamic (`NGX_DLSSG_MODE` = 4, NVIDIA's own name for the value), the driver's report that its frame-generation
override applied in the game's process (the FG word's `FG_MODE` bit), and DLSS Frame Generation identified in the session
(`fg_mode = dlssg`; its factor need not have been counted) —
a profile set to Dynamic that the driver never applied is a setting, not evidence. The driver's own mode number is not
read: it answers 3 under Dynamic and 1 under *Fixed* on every stored session (`spike-notes` §26), and NVIDIA's header
names neither. A *Fixed* ×5 or ×6 is not this row — Witcher 3 under the App's Fixed ×6 still presented ×2.0 — and
names DLSS 4.5 only where a state is measured at ×5 or more, which ranks above it.
Never a default preset inferred from a version: what a DLL "would" run by default is the game's and the driver's to
decide. A preset the driver applied to a super resolution it never saw created and evaluated names the model of
@@ -495,7 +510,21 @@ nothing and is not used (the owner's Silent Hill 2 session: preset L applied, no
the ×6.0 state's). **Sources:** NVAPI's `NV_NGX_DLSS_OVERRIDE_GET_STATE_PARAMS_V1` (the vendored
`src/native/third_party/nvapi/nvapi.h`); presets L/M with DLL 310.5.0 — PCGH's DLSS 4.5 test and NVIDIA's driver
591.74 release notes; DLSS 4.5's Dynamic MFG and 6× — NVIDIA's announcement (driver 595, RTX 50); DLSS 5 — NVIDIA's
GTC 2026 announcement and its 2026-09-03 launch; `nvngx_dlssnr.dll` — community reports only.
GTC 2026 announcement and its 2026-09-03 launch; ~~`nvngx_dlssnr.dll` — community reports only~~ `nvngx_dlssnr.dll` —
loaded by the owner's Hogwarts Legacy with Neural Rendering on, 310.9.16.0 from the game's folder (2026-11-06,
`spike-notes` §26), beside its Streamline plugin `sl.dlss_nr.dll`; `kFeatureDLSS_NR = 1004` — Streamline `v2.14.16`'s
public `sl_core_types.h` (re-vendored for it, `src/native/third_party/streamline/README.md`).
**Amended 2026-11-06 (beta.34, owner decision D84): DLSS 5 is named where it ran.** Until then a session could say only
that DLSS 5's runtime was LOADED — and Hogwarts Legacy, Neural Rendering on, loaded it. The Overlay's
`slEvaluateFeature` detour now decodes `kFeatureDLSS_NR` into its own per-frame fact (`FL_FEAT_SL_NEURAL_RENDERING`,
the feature byte's last bit, under the condition every Streamline fact shares) and publishes
`FL_HOOK_SL_NEURAL_RENDERING` with the detour; the Agent stores the share of Streamline batches that carried it
(`dlss_nr_pct`) **only from a writer that published that family** — an older Overlay drains the same batches and never
sets the bit, and its silence must not read as 0 %. Above every other row because DLSS 5 is named for that feature as
DLSS 4.5 is for its own: the session's super resolution, ray reconstruction and frame generation are the libraries the
line lists after it. Whether the game routes neural rendering through `slEvaluateFeature` at all is owner-only item
30(a)'s run; a title that does not reads *runtime loaded*, never *not running*.
## Anti-cheat pre-scan (static)
@@ -529,7 +558,7 @@ Three things this section previously implied that are not true, and are worth st
> the user's and stays; a `detected` entry is refreshed; **an empty field with no entry has nothing to protect
> and is filled and badged `detected`** — without that clause a freshly added game could never receive an
> engine at all, since `EnsureAsync` writes no provenance. A null detected value erases nothing.
> `capability_flags` is written whole every run (a JSON array of the rule ids — `dlss`, `dlss_g`, `dlss_rr`,
> `capability_flags` is written whole every run (a JSON array of the rule ids — `dlss`, `dlss_g`, `dlss_rr`, `dlss_nr` (beta.34),
> `streamline`, `fsr`, `xess`, `xefg`) because the Supports row has no user-edit surface and a stale "Supports
> DLSS-G" after the DLL left is the confusion §Capability hints exists to prevent.
- Strings scans bounded to 8 MB, local only.
+13
View File
@@ -320,6 +320,9 @@ CREATE TABLE sessions (
-- schema 0021 (2026-10-19, beta.24, D64): each loaded runtime module's folder class — 05_DETECTION §DLSS generation
runtime_module_sources TEXT, -- {"nvngx_dlss.dll":"graphics_driver", …}: game | graphics_driver | windows; never a path
-- schema 0022 (2026-11-06, beta.34, D84): DLSS 5's neural rendering — 05_DETECTION §DLSS generation
dlss_nr_pct REAL, -- 0–100 of the Streamline batches that evaluated kFeatureDLSS_NR; NULL = nothing could tell
-- schema 0020 (2026-10-19, beta.24, D62): every frame-generation state the session held — 03_METRICS §The mix
fg_mix TEXT, -- {"Rows":[{"Kind":"generated","Factor":4.0,"NativeFps":…,"DisplayedFps":…,
-- "Seconds":…,"Share":…,"Windows":…}, …]}: states by rising factor, then
@@ -715,6 +718,16 @@ Sequential embedded SQL (`Migrations/0001_init.sql`, `0002_*.sql`, …), applied
> from its crash file (which carries no module list). `LatestVersion` is 21;
> `LedgerDatabaseTests.ScriptTwentyOneAddsTheModuleSourcesColumnAndAnEarlierSessionHasNone`, the repository round trip.
> **`0022_dlss_nr.sql` (beta.34, 2026-11-06, owner decision D84) — DLSS 5's neural rendering, measured.** One REAL column,
> ADD COLUMN only: `dlss_nr_pct`, the share (0–100) of the presents that drained a Streamline evaluation on which the game
> evaluated `kFeatureDLSS_NR` (`Domain.Metrics.NeuralRendering`). Written by the recorder's aggregation
> (`SessionAggregator.ApplyRt`) **only when the writer published `FL_HOOK_SL_NEURAL_RENDERING`** — an Overlay older than
> the script drains the same batches and never sets the bit, so its NULL is "could not tell", never 0. NULL before, and
> never rebuilt (`frame_blobs` keep no feature byte); a session recovered from its crash file is re-aggregated from its
> raw records and keeps it. `LatestVersion` is 22;
> `LedgerDatabaseTests.ScriptTwentyTwoAddsTheNeuralRenderingColumnAndAnEarlierSessionHasNone`, the repository round trip.
> **A beta.33 or alpha.2 cannot open a ledger beta.34 migrated** (the alpha keeps its copy first, D73).
> **Every open used to migrate, and one that should not have did — 2026-09-16.** The Agent's `--console sessions`,
> a verb that prints, was run against the owner's ledger while the file on disk was at schema 2 and applied 0003 and
> 0004 to it. `LedgerDatabase.OpenReadOnlyAsync` exists since that day: an existing file, `PRAGMA query_only`, no
+34 -4
View File
@@ -1,6 +1,9 @@
# 08 — UI
WPF + **WPF UI (Wpf.Ui, Fluent)**. Shell = `ui:FluentWindow` with custom `ui:TitleBar`, a thin classic **Menu bar** (file-level operations), and a left **`ui:NavigationView`** (`PaneDisplayMode="LeftFluent"`) as primary navigation. Light/Dark/System themes via `ApplicationThemeManager` + `SystemThemeWatcher`; Mica backdrop on Windows 11 with automatic solid fallback on Windows 10. All XAML follows `16_WPFUI_SYNTAX.md` — that doc is mandatory reading before writing views.
WPF + **WPF UI (Wpf.Ui, Fluent)**. Shell = `ui:FluentWindow` with custom `ui:TitleBar`, a thin classic **Menu bar** (file-level operations), and a left **`ui:NavigationView`** (`PaneDisplayMode="LeftFluent"`) as primary navigation *(since beta.34, D86, its items use
our copy of WPF UI 4.3.0's LeftFluent item template — `FlLeftFluentNavigationViewItemTemplate` in `Styles/FrameLedger.xaml` —
whose only change is that the selected page keeps its label; WPF UI's animates it away, and the owner's screenshot of
Compare showed the icon alone)*. Light/Dark/System themes via `ApplicationThemeManager` + `SystemThemeWatcher`; Mica backdrop on Windows 11 with automatic solid fallback on Windows 10. All XAML follows `16_WPFUI_SYNTAX.md` — that doc is mandatory reading before writing views.
## Shell
@@ -285,6 +288,13 @@ All screens are `Page`s registered with the navigation page provider and navigat
### Games (grid → detail)
- `GridView`-style panel of cover cards (`ui:CardAction`): name, platform badge, engine badge, total playtime, last played, mini trend sparkline (avg Native FPS last 10 sessions). Sort/filter/`ui:AutoSuggestBox` search.
> **The filters, beta.34 (owner request 2026-11-06, D85)** — specified here since P3 and never built: a row under the
> search and sort with **Store**, **Engine** (the stores and engines the library holds, each list naming its
> "everything" first; *Added by hand* for an entry with no store, *Engine not identified* for one with none),
> **State** (the card's one state, as its pill says it), **Installed** and **Played**, and *Clear filters*. While a filter
> or the search narrows the list the title counts what is shown of all (*Games · 12 of 65*). Kept while the App runs —
> the page is the window's (`WindowPageCache`) — and not saved. Tests:
> `GamesViewModelTests.TheFiltersNarrowTheLibraryAndTheHeaderCountsWhatIsShown`.
> **The library, beta.11 (owner requests 2026-10-03).** *The empty band on the right:* the cards were 300 px in a plain
> `WrapPanel`, so at ~1350 px three fitted and a card's width was left unused; the grid is now
> `Controls.UniformWrapPanel` — as many columns as fit at 300 px or wider, every card an equal share of the width, each row
@@ -305,7 +315,14 @@ All screens are `Page`s registered with the navigation page provider and navigat
> message at once in its one snackbar, so only the last name stayed on screen. And only the newest read of the library is
> shown: reads overlap — a session that ends, an import, a removal — and the one that started first could finish last,
> its executable checks waiting on a slow drive, and put back a removed game's card (`GamesViewModel.LoadAsync`,
> `GamesViewModelTests.AnOlderReadThatFinishesLastIsNotShownOverANewerOne`)*). **The page reloads by itself** while it is on screen when a session ends (`SessionCompleted`) or an
> `GamesViewModelTests.AnOlderReadThatFinishesLastIsNotShownOverANewerOne`)*). *(beta.34, owner request 2026-11-06 —
> "switching to Games stalls 0.5–1.5 s", `spike-notes` §27: the window keeps the page it built and shows it again on
> every later visit, reading the library again behind it; the library is read on the thread pool; the cards appear
> before any executable is checked — 39 of the owner's 41 Steam games are on a USB drive that sleeps — and each card
> gets its *Not installed* pill when its check answers; a read keeps every card that would look the same; the list
> view is bounded (`MaxHeight` 640) so it builds the rows on screen. `GamesViewModelTests`
> `.TheCardsComeBeforeTheExecutableChecksAndThePillAfter`, `.APageShownAgainReadsTheLibraryAndKeepsTheCardsThatLookTheSame`,
> `WindowPageCacheTests`.)* **The page reloads by itself** while it is on screen when a session ends (`SessionCompleted`) or an
> import adds games (`LibraryChanges` — navigating to the page already on screen does nothing in WPF UI 4.3.0, so an
> import from the menu never showed until the page was left). **Import** (FR-1.2): the games already in the library — at
> this path or under another drive letter — are hidden by default (*Show the N games already in the library* brings them
@@ -625,7 +642,10 @@ Stat cards (Avg uses `FpsReadout`, Median, 1% Low, 0.1% Low, Min/Max, σ, stutte
> frame-generation state)*, *DLSS 3 (library 3.7.10)* — else *DLSS*; then each DLSS library with its version and where
> it was loaded from (*Super Resolution 310.5.0, from the graphics driver, preset L (2nd-gen transformer model)*), then
> *DLSS 5 runtime loaded* when it was. The game page's *Last session measured* repeats the label; the CSV export gains
> `# dlss:`. `DlssTextTests`.
> `# dlss:`. `DlssTextTests`. *(beta.34: two more rows — the NVIDIA App's Dynamic frame generation the driver reports
> applied is *DLSS 4.5 (Dynamic multi frame generation, set in the NVIDIA App)* (D83), and *DLSS 5 (neural rendering on
> N % of rendered frames)* heads the line where the game was seen running it, its library listed like the others, *runtime
> loaded, not seen running* where the Overlay looked and saw none (D84) — `05_DETECTION` §DLSS generation.)*
> **beta.27: one window per session, and no DLSS line that says only *DLSS*.** Opening a session whose summary window is
> open — from a Sessions tab, a notification, the game page — brings that window forward, restored if minimised, rather
@@ -773,10 +793,20 @@ Stat cards (Avg uses `FpsReadout`, Median, 1% Low, 0.1% Low, Min/Max, σ, stutte
### Compare
Session picker (2–5, cross-game allowed) → overlaid percentile curves + stat table with best-value highlighting; FG columns always show Native and Displayed separately. Export PNG.
> **beta.34 (owner request 2026-11-06, with a screenshot; D85).** The list holds **every session** — it was the newest
> 200, read on the UI thread with one game lookup each; now one read of the names, on the thread pool — and filters by
> **Game**, **Tier** and **Frame generation** (with / without; a session that measured none is neither), with a count
> (*6 of 131 sessions*); a ticked session stays listed whatever the filters say. The selection bar — *Pick 2 to 5
> sessions*, the count, *Clear selection*, *Compare* — sits above the list on the left: it was a window's width away. The
> columns are sized to what they hold with one filler column after them (three star columns spread a wide window into
> gaps, and the Tier column was exactly its header's width, so *Tier* and *FPS* touched); the date sorts by when; the
> settings-changed cell says *Changed mid-session* beside its icon, or a dash (it was blank). The result table's session
> labels sit over their columns: the header row has the metric column's 140 px first, as every row does. Tests:
> `CompareViewModelTests.TheFiltersNarrowTheListAndATickedSessionStaysOnIt`, the page in `PagesLoadTests`' surfaces.
**Mixed-tier guard (FR-6.2):** selecting sessions from different capture tiers shows a blocking `ContentDialog` explaining that they measured different things; proceeding stamps the chart with a tier legend and greys out metrics unavailable in the lower tier. Sessions with `settings_changed_midsession` carry a warning icon and are excluded from trend lines by default.
> **Built 2026-09-14 (P3 PR-7).** `CompareViewModel` over the last 200 sessions across games: a `DataGrid`
> **Built 2026-09-14 (P3 PR-7).** `CompareViewModel` over ~~the last 200 sessions~~ every session *(since beta.34)* across games: a `DataGrid`
> picker with a checkbox column (Compare enabled at 2–5), the FR-6.4 warning icon per row; **Compare** asks
> `IMixedTierPrompt` (a `ContentDialog`, default button Cancel) when the selection mixes tiers and compares
> nothing on a decline; a comparison that proceeds carries `Compare_Mixed_Legend` as the plot's title and an
+4
View File
@@ -17,6 +17,10 @@ Languages: **en** (neutral/default) · **vi** · **ja**. Same `.resx` pattern as
- One `Strings.resx` (+ `Strings.vi.resx`, `Strings.ja.resx`) per assembly that has user-visible text (`App`, `Shared` ~~for error codes~~ for the safety family, the `Safety_*` keys — corrected 2026-10-04). Access through a generated strongly-typed class; **no string literals in XAML/C# for user-visible text** (analyzer TODO: Meziantou MA0011/manual review in PR checklist). **As built (P3 PR-2, 2026-09-13):** the class is `Strings.Designer.cs`, written by `tools/resx-gen.ps1 -Resx <file>` and **committed** — not the SDK's `ResXFileCodeGenerator`, which the SDK-style WPF project does not run — with `Culture`, `ResourceManager`, `Keys`, and one property per key; the audit below fails when it is stale. The first family is `src/FrameLedger.App/Strings.resx` (65 keys); `Shared`'s arrives with PR-4's `Safety_*` text, because an empty family is what the audit refuses.
- XAML binding via `{x:Static res:Strings.Key}` ~~plus a `LocalizeExtension` for the few dynamic cases~~ *(corrected 2026-10-04: no `LocalizeExtension` exists; text that varies is composed in the view model from `Strings.*`)*.
- **Runtime switching:** setting change → set `CultureInfo.CurrentUICulture` + `Thread` defaults → re-create the main window shell (cheap; state preserved via VM). Persist in `settings`.
**The new window opens on the page that was on screen** *(beta.34, owner request 2026-11-06)* — Settings, after a
change made there. `ShellHost` remembered only the pages opened from code (`PageNavigator`), never a click in the
pane, so a language changed on Settings brought back the last game page opened; it now notes every page the live
window's NavigationView shows (`ShellHost.NoteShown`).
**Two kinds of text did not follow, until beta.15:** a list of choices built once in a static (Settings' themes and update
channels, the Logs page's two lists, the Games page's sort order — `x:Static` read the list built in the language the
App started in), and the singletons that outlive the rebuilt window (the tray's menu, the title bar's Agent pill and the
+8
View File
@@ -115,6 +115,14 @@ Code-behind wires services once: `navigationService.SetNavigationControl(RootNav
- Navigate **only** via `INavigationService.Navigate(typeof(SomePage))` — never manipulate `Frame` directly, never `new` a Page.
- Pages implement `INavigableView<TViewModel>` with `ViewModel` injected via constructor DI; `DataContext = this` in the page constructor (WPF UI template idiom) so bindings read `ViewModel.*`.
- Page state: pages are Transient; anything that must survive navigation lives in the ViewModel-backing services/DB, not the Page.
**Except the library, since beta.34** (owner request 2026-11-06, "Games stalls 0.5–1.5 s"; `spike-notes` §27): the window
keeps the `GamesPage` it built — `Services.WindowPageCache`, the window's own `INavigationViewPageProvider`, set after
`INavigationService.SetNavigationControl` (which hands the NavigationView the container's provider) — and its view model
reads the library again each time the page is shown (`GamesViewModel.Attach`). Still Transient in the container; one
instance per window, so a language change's new window builds its own in the new language. **Not**
`NavigationViewItem.NavigationCacheMode`: WPF UI 4.3.0 reads it only when the NavigationView has neither a service
provider nor a page provider (`NavigationView.Navigation.cs`, `GetNavigationItemInstance`), and this App sets one — the
attribute would have changed nothing.
## Control mapping (always prefer these)
+1 -1
View File
@@ -194,7 +194,7 @@ Every hook must be listed here with a purpose. Anything not on this list is not
|---|---|
| NGX: `NVSDK_NGX_D3D11/D3D12/VULKAN_CreateFeature`, `EvaluateFeature`, `ReleaseFeature` | Which NGX feature is *actually created and evaluated per frame*: SuperSampling (DLSS), RayReconstruction (DLSS-D), FrameGeneration (DLSS-G) |
| NGX parameter accessors (`NVSDK_NGX_Parameter_SetI/GetI/SetUI`) — **exported by `sl.common.dll` only; see below** | `Width`/`Height` (render) vs `OutWidth`/`OutHeight` (output), `PerfQualityValue` (quality preset), sharpness |
| ✅ Streamline: `slEvaluateFeature` · ⏳ `slInit`, `slSetFeatureLoaded`, `slSetConstants`, `slGetFeatureRequirements` | Feature set actually active when the game goes through SL rather than NGX directly (`kFeatureDLSS`, `DLSS_G`, `DLSS_RR`, `Reflex`, `NIS`). **Built 2026-08-09**, identity only: one MinHook detour on `sl.interposer.dll!slEvaluateFeature`, resolved **module-scoped** and installed lazily by the watchdog. Sets `FL_MEASURED_UPSCALER` + `FL_HOOK_UPSCALER_IDENTITY`; decodes `kFeatureDLSS`/`kFeatureNIS` and reports `FL_UPSCALER_UNKNOWN` for anything else. **Never `FL_UPSCALER_NONE`** — a Streamline-only writer cannot see FFX, XeSS or NGX-direct, and `NONE` is the only one of the three states that may be aggregated as a negative |
| ✅ Streamline: `slEvaluateFeature` · ⏳ `slInit`, `slSetFeatureLoaded`, `slSetConstants`, `slGetFeatureRequirements` | Feature set actually active when the game goes through SL rather than NGX directly (`kFeatureDLSS`, `DLSS_G`, `DLSS_RR`, `Reflex`, `NIS`; since beta.34 `kFeatureDLSS_NR` — DLSS 5's neural rendering, its own fact bit and family `FL_HOOK_SL_NEURAL_RENDERING`, D84; rule 4: the `feature` argument of the API hooked, nothing else). **Built 2026-08-09**, identity only: one MinHook detour on `sl.interposer.dll!slEvaluateFeature`, resolved **module-scoped** and installed lazily by the watchdog. Sets `FL_MEASURED_UPSCALER` + `FL_HOOK_UPSCALER_IDENTITY`; decodes `kFeatureDLSS`/`kFeatureNIS` and reports `FL_UPSCALER_UNKNOWN` for anything else. **Never `FL_UPSCALER_NONE`** — a Streamline-only writer cannot see FFX, XeSS or NGX-direct, and `NONE` is the only one of the three states that may be aggregated as a negative |
| ✅ Streamline: `slSetTag` — **and, since 2026-09-05, every tag's TYPE** (`slTagCensus`; a HUD-less / UI tag marks the present `FL_FG_DLSS_G`, rule 4: the same argument) | The **global** resource tags, where a title states the size of the buffer it is upscaling *from*: `kBufferTypeScalingInputColor`'s extent → `renderW/H` — **or, since 2026-09-05, the size the tagged `sl::Resource` declares when the extent is zero** (`TagSize` in `fl_sl_inputs.h`, shared by all three tag routes; GUID-checked; a Resource declaring no size is still the honest unknown). **Built 2026-08-15** (`FL_HOOK_UPSCALER_PARAMS`), and it is an ALTERNATIVE to the local tags in `slEvaluateFeature`'s `inputs`, not a layer over them — `sl_core_api.h:258` says global and local tags "do NOT interact", so a title using one yields nothing from the other and both are read. Published only on a frame where an evaluation was also seen, because a tag is viewport state that outlives any one frame. This row was MISSING from this table while the hook shipped, which is the gap the banner above now names |
| ✅ Streamline: `slSetTagForFrame` — **and every tag's TYPE, as above** | The same global tags through **Streamline 2.8's frame-based entry point**, which deprecates `slSetTag`: `(const FrameToken&, const ViewportHandle&, const ResourceTag*, uint32_t, CommandBuffer*)` — the token first, then exactly `slSetTag`'s list, handed to the same tag walk. **Built 2026-09-04** (`FL_HOOK_UPSCALER_PARAMS`, its own trampoline; the family is now **published when whole** — once every tag export the loaded interposer has is patched — because publishing on the first row entitled records the second was not yet producing, 38 of 41 on the fixture: the ffx leaves' #110 defect again, fixed the same way). Measured need: Dying Light: The Beast (SL 2.8.0) published `Dlss` identity on every batch and the params bit on none across three captures, because a 2.8 title that tags per frame never calls the deprecated export. The token is not read; the frame count stays with `slGetNewFrameToken`. The installer picks this detour by SYMBOL (`kSymbolSlSetTagForFrame`, bound to the row by `static_assert`), not by family, since the two rows share a family bit and differ in signature |
| ✅ **FidelityFX ffx-api: `ffxDispatch` on the FOUR modules a game calls** — `amd_fidelityfx_dx12.dll` (SDK 1.1.x monolith), `amd_fidelityfx_upscaler_dx12.dll`, `amd_fidelityfx_framegeneration_dx12.dll`, **and `amd_fidelityfx_loader_dx12.dll`** (added the evening of 2026-09-04: three loader-shipping titles at FSR produced zero dispatches at any leaf export, so the loader is where their calls arrive) · ⏳ FSR 3.0 host route `ffx_fsr3_x64.dll!ffxFsr3ContextDispatchUpscale` / `ffxFsr3DispatchFrameGeneration` · ~~`ffxFsr2ContextCreate`~~ · ~~`ffxCreateContext`~~ | **Built 2026-09-04** (`HANDOFF` item 7c). One observer behind three trampolines reads the DESCRIPTOR the title passed — head type first, body only after the type matched a constant from the vendored MIT headers (`third_party/fidelityfx/`, tag v2.3.0): **UPSCALE** → identity (`FSR3` from the monolith, `FSR_UNVERSIONED` from the 2.x upscaler DLL, which hosts FSR 3.1 and FSR 4 behind one type) + `renderSize` → `renderW/H` (quality and sharpness `0xFF`: the dispatch carries neither — *since beta.25 the quality byte is the mode the `ffxQuery` row below names for the dispatched size, `0xFF` when none does*) + one COUNT; **PREPARE / PREPARE_V2** → `frameID` counted on a *new* index only — this vendor's `slGetNewFrameToken`, the `fgEvaluations` producer once a title has ever prepared, with the UPSCALE count as the fallback for a title that never does; **FRAMEGENERATION** → `fgMode = FSR_FG` on that present. Rule 4: the argument of the API we hooked, never `context`, `pNext`, a command list or a resource. **Why all four:** a UE5 title ships the two leaves with no loader and calls their exports; a loader-shipping title calls the loader's export and the signed loader reaches its providers through an object, not the leaves' exports (measured: Dying Light: The Beast, KCD2, Wukong). The morning's "never the loader" rested on the export tables alone and was reversed by the run. What guards against a loader that DID re-enter a leaf's export is the K = 1 control with all four hooked and the consumer's `frames/upscale-drained`, both of which read 2× in that case. `ffxCreateContext` is deliberately NOT a row — nothing it carries fills a field the dispatch does not, and its honest family would collide with `slEvaluateFeature`'s under the installer's equality binding. The family is compound (`IDENTITY \| PARAMS \| FG_EVALUATIONS`), pinned by `static_assert`s that also bind the leaf table to the rows both ways and refuse the loader as a row. Streamline keeps precedence for the count once it has ever issued a token, so every §S31-validated title is byte-identical. Second count: the consumer prints `frames/upscale-drained`, the AMD `tokens/batch`. **FSR 3.0 — BUILT 2026-09-05 as a fifth AMD target:** `ffx_fsr3_x64.dll!ffxFsr3ContextDispatchUpscale` (Cyberpunk's copy; named export, its own descriptor, vendored from tag **`fsr3-v3.0.4`** — the tag whose twelve `ffxFsr3*` declarations match the shipped module, not the `v1.1.4` first named). Rule 4: the detour reads `renderSize` of the descriptor the title passed and nothing else — never the context, a resource or the command list; the offset is pinned to a literal (1256) so a re-vendoring that moved it fails to compile. Same family and publish point as the four rows (`PublishFfxFamilyIfWhole` waits for a loaded host too), keyed by module in the installer; identity `FSR3` as a fact. `ffxFsr3DispatchFrameGeneration` is deliberately not a row (§H11 carries the reversal condition); the `ffx_fsr3upscaler_x64.dll` leaf is the pre-committed alternative if the facade reads silent (row B2) — never both, or `frames/upscale-drained` reads 2.00 |
+85 -55
View File
@@ -72,6 +72,7 @@ owner-only items stay below; the history of every train, the passed owner-only i
| `§beta.30` | [`handoff/history/0.1.0-beta.30.md`](handoff/history/0.1.0-beta.30.md) |
| `§beta.31` | [`handoff/history/0.1.0-beta.31.md`](handoff/history/0.1.0-beta.31.md) |
| `§beta.32` | [`handoff/history/0.1.0-beta.32.md`](handoff/history/0.1.0-beta.32.md) |
| `§beta.33` | [`handoff/history/0.1.0-beta.33.md`](handoff/history/0.1.0-beta.33.md) |
| `§Owner-only`, an open item | [§Owner-only](#owner-only--no-pr-can-close-these) below |
| `§Owner-only`, a passed item (3, 12, 14–19) | [`handoff/owner-only-passed.md`](handoff/owner-only-passed.md) |
| `§Traps`, `§Two corrections carried forward` | [`handoff/traps.md`](handoff/traps.md) |
@@ -79,72 +80,73 @@ owner-only items stay below; the history of every train, the passed owner-only i
---
## **START HERE** — 2026-11-03, 0.1.0-beta.33: games from the Xbox app and the Microsoft Store
## **START HERE** — 2026-11-06, 0.1.0-beta.34: DLSS 5 and DLSS 4.5 from what the game and the driver did; filters; Games at once
*Status is `docs/changelog/0.1.0-beta.33.md`; this is what no other file carries.* The owner: "Trong phiên này, ta sẽ tập
trung xử lý, đánh giá, phân tích cho các game thuộc MS Store/ Xbox App/Game Pass cho (các) phiên bản tiếp theo nhé. Quy
trình vẫn như mọi lần." — handle, evaluate and analyse the games of the Microsoft Store, the Xbox app and Game Pass for the
next versions, the usual train; the owner's games are in `C:\XboxGames` and `D:\xbox`. #351 (the library, the install
root, detection, the art, Privacy 2.13), #352 (Play, the guard's two refusals, one exe-path reader) and this release;
`0.1.0-alpha.2` follows (D82).
*Status is `docs/changelog/0.1.0-beta.34.md`; this is what no other file carries.* The owner asked for seven things, the
usual train: (1) how DLSS 5 Neural Rendering is detected on Hogwarts Legacy (Neural Rendering on in the game), and its
version; (2) under the NVIDIA App's *Dynamic* multi frame generation the label read DLSS 4, though Dynamic and ×6 exist
only in DLSS 4.5 (Phantom Blade Zero); (3) filters on Games and Compare; (4) the Compare page's layout, from a
screenshot; (5) the documents and the tested-games list, from the database; (6) switching to Games stalled 0.5–1.5 s;
(7) a language change landed on the last content page instead of Settings. And while planning: "Bạn check Streamline các
bản gần đây có gì thay đổi và sửa luôn nếu thật sự cần nhé." — check what changed in recent Streamline versions and fix it
if really needed. #356 (two fixes from a self-review of #351 and #352), #357 (D83), #358 (D84, Streamline `v2.14.16`),
#359 (items 6 and 7), #360 (items 3 and 4, D85, D86), #361 (item 5) and this release; `0.1.0-alpha.3` follows (D87) —
the owner's screenshot is of an alpha, so the alpha is how these reach the owner's PC.
**Decisions (asked while planning, do not re-ask):**
- **D77 — measure first, on the owner's titles**: the launch chain was measured by activating six of the eleven packages
with no FrameLedger hook, read-only, each game closed by its window and never killed, with the decision table committed
before the run (`spike-notes` §25, its two commits in #351).
- **D78 — GDK only**: an app-container (UWP) process is refused with a reason of its own, `TargetAppContainer`, Tier 2
(`19_SAFETY` §The target must be able to take the Overlay); `LIMITATIONS.md` says so.
- **D79 — the platform is "Xbox"** (id `xbox`), full scope: import, art, Play, Tier-1 capture, detection, docs and legal.
- **D80 — Play on an Xbox game always activates its package**, in both D59 modes (`08_UI` §Games): started by its path a
GDK game is never the game in its package — the run corrected the plan's premise that `CreateProcess` fails with error 5
(it hands the launch executable back to the package, so the game is not the launcher's descendant; an Unreal shipping
executable runs outside it). The Agent records such a game in attach mode.
- **D81 — title lists stay keyed by Steam id**: an Xbox copy is matched by everything but that entry; the gap is
`20_OPEN_QUESTIONS` §G *Xbox app / Microsoft Store titles*.
- **D82 — alpha.2 right after beta.33** (the owner runs `0.1.0-alpha.1`, and the alpha's channel is locked): on RC3; if
the train reaches the alpha after .NET 11's release on 2026-11-10, the standing rule applies (SDK 11.0.100, packages
11.0.0) — no new decision.
- **D83 — Dynamic frame generation is DLSS 4.5's**: the owner's rule, "Dynamic and ×6 exist only in DLSS 4.5". The
evidence is the game's driver profile setting Dynamic (`NGX_DLSSG_MODE` = 4) **and** the driver reporting its
frame-generation override applied in the game's process (`FG_MODE` in its FG word), in a session where DLSS
Frame Generation was identified (`fg_mode = dlssg`; its factor need not have been counted); a state measured at ×5 or more still ranks first, and a *Fixed* multiplier names nothing by itself
(amends D64). The driver's `frameGenerationMode` — 3 under Dynamic and 1 under Fixed in every session read, and unnamed
by NVIDIA — is recorded in `spike-notes` §26, not keyed on.
- **D84 — DLSS 5 is the session's generation where its neural rendering was measured running**: the Overlay decodes
`kFeatureDLSS_NR` in its `slEvaluateFeature` detour and the Agent keeps its share of the Streamline batches
(`sessions.dlss_nr_pct`, schema 0022) — *DLSS 5 (neural rendering on N % of rendered frames)*; loaded and seen not
running, *runtime loaded, not seen running*; where nothing could tell, *runtime loaded*, as before (amends D64).
- **D85 — the filters**: Games — store, engine, state, installed, played; Compare — game, tier, frame generation, no
period; Compare lists every session (it listed the newest 200).
- **D86 — the left pane's selected item keeps its label**: our copy of WPF UI 4.3.0's LeftFluent item template, whose
`IsActive` trigger animated it away.
- **D87 — alpha.3 right after beta.34**, on RC3: the train reaches it before .NET 11's release on 2026-11-10.
The Privacy Policy 2.13's wording was approved with the plan (D36).
Streamline was re-vendored at `v2.14.16` on the owner's instruction above, not as a decision of its own. The wording of
the Disclaimer 2.13 and the Privacy Policy 2.14, and the tested-games list (D35), were approved with the plan (D36).
**Choices made here:**
- **A GDK package root is an install-root boundary**, for the guard's check 4 and for detection alike, and only where no
store boundary matched — so it can only widen what is walked (`19_SAFETY` §Pre-injection checks, amended 2026-11-03).
The guard gained `GamesInstalled\<X>` with it, and one case list read by both test suites
(`tests/fixtures/install-roots/cases.txt`) holds the two resolvers together.
- **`root_file`, a new detection signal**, answered from the install root's own listing, so the `xbox` platform rule —
first, because a GDK FINAL FANTASY ships Steam's DLL — is decidable even where a very large install's walk ran short.
- **The two refusals read the target once, before the primitive**, never at the 30 s re-scan; "could not tell" refuses as
`ProcessUnreadable`, and only enforcing flags count (`SetContextIpValidation` without strict mode is on every
CET-compatible process: `pwsh.exe` reads `0x105`).
- **`TargetResolver` reads the watcher's spelling** (`ProcessImagePath`) but keeps the guard's rights, so D21's
`TargetUnreadable` is unchanged.
- **Neural rendering's share is over the Streamline batches**, not every present: a generated frame evaluates nothing,
and a title that never drains a batch reads *nothing could tell* (null), never 0 %.
- **A writer older than beta.34 is told apart by its family bit**, `FL_HOOK_SL_NEURAL_RENDERING` (bit 12), published with
the detour — an old Overlay's silence leaves `dlss_nr_pct` null instead of a measured 0 %; no layout change.
- **The Games page is the window's**, kept by our own page provider (`WindowPageCache`), not `NavigationCacheMode`: WPF UI
4.3.0 reads that only when neither a service provider nor a page provider is set, and `SetNavigationControl` sets one
(`16_WPFUI_SYNTAX` §Navigation). One per window, so a language change's window builds its own.
- **The cards come before the executable checks** — 39 of the owner's 41 Steam games are on a USB drive that sleeps — and
each card gets its *Not installed* pill when its check answers.
- **The pane's item template is a copy changed in one place**, reading WPF UI's own `NavigationViewConstants.xaml`: before
the WPF UI pin moves, the upstream template is read again.
**Measured on the way** (`spike-notes` §25): eleven GDK packages, full trust, the user's token, medium integrity, none of
the four mitigations; the image path and the loader's main module both in the `Content` spelling; every game `.exe`
refuses `FILE_READ_DATA`/`FILE_EXECUTE` outside its package, so no Unreal version and no *Runs as* for these titles;
`GetProcessMitigationPolicy` answers through `PROCESS_QUERY_LIMITED_INFORMATION`, and an unknown policy answers
`ERROR_INVALID_PARAMETER`.
**Measured on the way:** the owner's DLSS sessions of 2026-11-01 → 11-06, the driver's frame-generation numbering and
Streamline's `v2.12.0` → `v2.14.16` changes are `spike-notes` §26 (the ledger read read-only; the vendored copy was
`v2.12.0` byte for byte); the Games page before and after is §27 (first cards 822–830 ms → 10–15 ms with the first
executable check held 800 ms; a revisit 181–215 ms → 15–16 ms). The neural-rendering decode costs nothing measurable in
the detour and 0.14–0.19 ns on the present's feature byte (#358's body; NFR-1's budget is 1 µs per present).
**Traps met on the way:**
- **Malwarebytes quarantines `fl_guard_test.exe`** (`Malware.Heuristic.108256`, records in
`C:\ProgramData\Malwarebytes\MBAMService\RtpDetections`) on some builds and not others: ctest then reports `fl_guard` as
passed in 0.5 s with no output and `fl_prescan` with an empty command. Read `LastTest.log` for the assertion count before
believing a native pass; an exclusion for `E:\frameledger\build\` is the owner's to add (a security setting), and CI runs
both suites.
- **`build.ps1` finds the x64 clang-format; `Get-ChildItem … clang-format.exe` finds the ARM64 one first**, which will not
start on this PC.
- **SonarCloud's quality gate on #351 was 77.7 % new-code coverage** (≥ 80 % wanted) and one `cpp:S5813` (`wcslen`): both
closed in #352 — its own gate 95.4 %, main's after the merge 86.5 % on the code since beta.32 with no open issue. The
job is advisory, so a merge on green does not wait for it — read its verdict after each merge.
- **FluentAssertions' `OnlyContain` fails an empty collection**: a test of what this PC holds (`GamingRoots.OnThisPc()`)
passed here and failed on the hosted runner, which has no `.GamingRoot` (#352's first CI run) — assert that nothing
is wrong rather than that everything is right.
- **`notice-check` reads the tracked tree**: a file deleted from the working tree but not from the index fails it with
*Could not find file* — after every build and test had passed (#360's first local gate). Stage the change
(`git add -A`) before the gate.
- **A new hook family bit belongs in the native token test's exact mask** (`guard_test.cpp`), and a new Streamline fact
in the 0xF00D case's list of facts it must not light — #358's first gate (`0x100f` against `15`).
- **WPF UI 4.3.0**: `NavigationCacheMode` is ignored once a page provider is set; `INavigationService.SetNavigationControl`
hands the NavigationView the container's provider, so ours is set after it; LeftFluent's item template collapses the
selected item's label.
- **Microsoft.Data.Sqlite's async methods run synchronously**: a read awaited on the UI thread blocks it — `Task.Run` it.
**Owner-only:** item 28 — the Xbox titles on real hardware.
**Owner-only:** item 30 — beta.34 on real hardware.
## Owner-only — no PR can close these
@@ -249,7 +251,9 @@ refuses `FILE_READ_DATA`/`FILE_EXECUTE` outside its package, so no Unreal versio
setting*, the game's own library and no generation beyond what was observed. Record the names the override loads
under `%ProgramData%\NVIDIA\NGX` (the summary's *Loaded:* line) — they correct `05_DETECTION` §Shipped is not loaded.
(d) **DLSS 5** on the owner's DLSS 5 title: *DLSS 5 runtime loaded*. If it is not shown, record the module names it
loads (*Loaded:* line); `nvngx_dlssnr.dll` is then corrected in `CensusNames` and `05_DETECTION`.
loads (*Loaded:* line); `nvngx_dlssnr.dll` is then corrected in `CensusNames` and `05_DETECTION`. *(2026-11-06, `spike-notes` §26:
Hogwarts Legacy, Neural Rendering on, loaded `nvngx_dlssnr.dll` 310.9.16.0 from the game's folder — the name holds;
whether it ran is what beta.34 measures, item 30(a).)*
(e) **SonarCloud (D67):** bulk-mark per `13_CI_CD` §SonarCloud; optionally its *Ignore issues on multiple criteria*
rows; close PR #315. (f) The Legal Gate shows **Disclaimer 2.11** and **Privacy Policy 2.12** once. (g) The `ja`
strings marked `review`. *(2026-10-19, the owner's first runs — `spike-notes` §22: (a) the Dynamic context line
@@ -346,7 +350,28 @@ refuses `FILE_READ_DATA`/`FILE_EXECUTE` outside its package, so no Unreal versio
`Art_Source_Xbox`, `Import_NothingFound`, `FirstRun_Import_Body`, `Settings_GameArt_Body`, `Play_Xbox_Format`,
`Play_Xbox_NotStarted_Format`, `Play_PackagedGame_Format`, `Play_ToolTip_Store`, `Play_ToolTip_Direct`,
`Settings_PlayMode_Body`, `Guard_TargetAppContainer`, `Guard_TargetMitigation`. Then
`docs/LIST_GAME_TESTED.md` gains the Xbox titles from a ledger copy (D35), approved before the commit.
`docs/LIST_GAME_TESTED.md` gains the Xbox titles from a ledger copy (D35), approved before the commit. *(2026-11-06,
beta.34: done — inKONBINI and Valor Mortis, with the refresh the owner approved with the plan.)*
29. **0.1.0-alpha.2 on real hardware** (D73, D82). (a) **The update from alpha.1**: Help ▸ Check for updates offers
alpha.2 — the first update an alpha's updater has found — and *Restart to update* installs it; say whether it
downloaded the delta or the whole package. (b) The terms window shows the Privacy Policy 2.13 and the Alpha notice
with its box again, and Accept waits for the tick. (c)
`%LOCALAPPDATA%\FrameLedger\backups\ledger-before-0.1.0-alpha.2.db` exists beside alpha.1's, and opens. (d) Item 28's
Xbox checks, on the alpha.
30. **beta.34 on real hardware** (D83–D86). (a) **The update from beta.33** (or alpha.3's, item 31): the terms window
shows the Disclaimer 2.13 and the Privacy Policy 2.14 once. (b) **Hogwarts Legacy with Neural Rendering on**, one
hooked session → *DLSS 5 (neural rendering on N % of rendered frames)*; then **off** — `spike-notes` §26's table,
written before the run, decides (on and 0 %: neural rendering runs outside `slEvaluateFeature`, the line stays
*runtime loaded, not seen running*, and the session's `sl_tag_census` is recorded before anything is named).
(c) **Phantom Blade Zero** under the NVIDIA App's *Dynamic, up to ×3* → *DLSS 4.5 (Dynamic multi frame generation, set
in the NVIDIA App)*; the game's own ×3 with no override from the App → *DLSS 4*. (d) **Games** from any page: the
cards at once, a second visit at once; the Debug line `ui: page … shown … ms after its navigation`. (e) **Settings →
change the language** → the window comes back on Settings. (f) The filters on Games and Compare, the Compare columns
and selection bar, the selected page's label in the pane, in both themes. (g) The 34 `ja` strings this release adds,
all marked `review`: `Dlss_Basis_Dynamic`, `Dlss_NeuralRendering_NotSeen`, `Dlss_Feature_NeuralRendering`,
`Dlss_Basis_NeuralRendering_Format`, `Games_Filter_*`, `Games_Header_Filtered_Format`, `Filter_Clear`,
`Compare_Filter_*`, `Compare_Count_Format`, `Compare_Count_Filtered_Format`, `Compare_ClearSelection`,
`Compare_MidSession_Changed`, `A11y_Games_Filter_*`, `A11y_Compare_Filter_*`.
**Answered 2026-08-05, do not re-ask:** remove `gameguard` and keep `guard` (approved
over a red `Rules` gate, with the reasoning recorded in the merge commit); vendor NVAPI
headers **and** `amd64/nvapi64.lib`; Windows 11 is the **measurement scope** only —
@@ -443,6 +468,11 @@ Where each owner decision is recorded — the file and its section, and a label
| D80 | [`08_UI.md`](08_UI.md) §Games | Play on an Xbox game always activates its package, in both modes; the Agent answers `PackagedGame` and records it in attach mode |
| D81 | [`20_OPEN_QUESTIONS.md`](20_OPEN_QUESTIONS.md) §G | title lists stay keyed by Steam id; an Xbox copy is matched by everything but that entry |
| D82 | [`HANDOFF.md`](HANDOFF.md) §START HERE | alpha.2 right after beta.33; on RC3 unless the train reaches it after .NET 11 ships (then SDK 11.0.100, packages 11.0.0) |
| D83 | [`05_DETECTION.md`](05_DETECTION.md) §DLSS generation | the NVIDIA App's Dynamic frame generation, reported applied by the driver in a session where DLSS Frame Generation was identified, is DLSS 4.5 (amends D64) |
| D84 | [`05_DETECTION.md`](05_DETECTION.md) §DLSS generation | DLSS 5 heads the DLSS line where its neural rendering was measured running (`kFeatureDLSS_NR`, `dlss_nr_pct`); loaded only reads "runtime loaded" (amends D64) |
| D85 | [`08_UI.md`](08_UI.md) §Games, §Compare | filters: Games — store, engine, state, installed, played; Compare — game, tier, frame generation (no period); Compare lists every session |
| D86 | [`08_UI.md`](08_UI.md) (the shell) | the left pane's selected item keeps its label: our copy of WPF UI 4.3.0's LeftFluent item template |
| D87 | [`HANDOFF.md`](HANDOFF.md) §START HERE | alpha.3 right after beta.34, on RC3 (before .NET 11's release, 2026-11-10) |
---
+46 -16
View File
@@ -1,43 +1,47 @@
# Games FrameLedger has been run with
*As of 2026-09-27 (0.1.0-beta.10). Built from a copy of the developer's own FrameLedger database and the repository's
*As of 2026-11-06 (0.1.0-beta.34). Built from a copy of the developer's own FrameLedger database and the repository's
measurement notes, and reviewed by the project's owner before it was published. It lists what happened on one machine;
it promises nothing about any other.*
*(Not re-read for 0.1.0-beta.11 or 0.1.0-beta.12 — noted 2026-10-04. Refreshing it needs a new copy of the database and
the owner's review; sessions since 2026-09-27, and the game-memory figures beta.12 adds, are not here.)*
*~~(Not re-read for 0.1.0-beta.11 or 0.1.0-beta.12 — noted 2026-10-04. Refreshing it needs a new copy of the database and
the owner's review; sessions since 2026-09-27, and the game-memory figures beta.12 adds, are not here.)~~ Refreshed
2026-11-06 from a copy of the database taken that day, and reviewed by the owner with the plan of 0.1.0-beta.34: the
sessions since 2026-09-27 are below, with the graphics memory a game used where it adds something.*
**The machine.** Every row below was run on one PC: an NVIDIA GeForce RTX 5080 (the only graphics card), an Intel Core
i7-14700KF, 32 GB of DDR5, Windows 11 (Insider builds 26300 → 29648) and a 2560×1440, 240 Hz monitor. **No AMD or Intel
i7-14700KF, 32 GB of DDR5, Windows 11 (Insider builds 26300 → 29648) and a 2560×1440, 240 Hz monitor; the graphics
driver went from 32.0.16.1714 to 32.0.16.2114 over the sessions in the database. **No AMD or Intel
graphics card and no second machine has been tested**, and ~~**no real Vulkan or OpenGL game has been measured** — every
measurement below is Direct3D 11 or 12~~ **one real Vulkan game has been measured (Everhex Demo, 2026-10-13) and no
OpenGL game** — every other measurement below is Direct3D 11 or 12 *(corrected 2026-10-14)*. What the tiers mean and what FrameLedger cannot do: [LIMITATIONS.md](../LIMITATIONS.md).
**Two periods.** From 2026-08-03 to 2026-09-06 the games were measured with the developer's capture tool, one run at a
time against the game's own settings menu (reports in [spike-notes.md](spike-notes.md)). From 2026-09-16 the shipped
app and agent recorded them as a user would; the database holds the sessions from 2026-09-22 on — earlier ones went
with the 2026-09-16 recovery and with library entries removed since.
app and agent recorded them as a user would; ~~the database holds the sessions from 2026-09-22 on~~ the copy of
2026-11-06 holds the sessions from 2026-10-04 on — earlier ones went with the 2026-09-16 recovery and with library
entries and sessions removed since; a row citing the database before 2026-10-04 was read from the copy of 2026-09-27.
## Measured — hooked (Tier 1)
| Game | Engine | API | What was measured | When | Evidence |
|---|---|---|---|---|---|
| Cyberpunk 2077 | — | D3D12 | DLSS Balanced 1485×835 → 2560×1440, exact against its settings file; DLSS Frame Generation off ×1.00, ×3 (61.4 → 183.5 FPS), ×4 (58.7 → 234.1); FSR 3 + FSR frame generation ×2 (74.3 → 148.6); ray tracing *Yes* with path tracing on and *No* with it off, as set | 2026-08-15 → 09-05, about 25 runs | [spike-notes §8, §9, §11](spike-notes.md) |
| Cyberpunk 2077 | — | D3D12 | DLSS Balanced 1485×835 → 2560×1440, exact against its settings file; DLSS Frame Generation off ×1.00, ×3 (61.4 → 183.5 FPS), ×4 (58.7 → 234.1); FSR 3 + FSR frame generation ×2 (74.3 → 148.6); ray tracing *Yes* with path tracing on and *No* with it off, as set; on 2026-10-20, ×2, ×3 and ×4 chosen in the game's menu within one session read as separate states, ×4.0 at 63.8 → 255.3 FPS, with ray tracing and Ray Reconstruction *Yes* | 2026-08-15 → 10-20, about 26 runs | [spike-notes §8, §9, §11, §23](spike-notes.md), database |
| Dying Light: The Beast | — | D3D12 | DLSS Frame Generation ×4: Native 70.5 → Displayed 282.1 FPS, counted through DXGI; FSR + FSR frame generation ×2 (70.5 → 140.9); ray tracing *Yes* | 2026-09-04 → 09-06 | [spike-notes §9](spike-notes.md), [03_METRICS §Frame Generation](03_METRICS.md) |
| Hell Is Us | Unreal Engine 5.5.4 | D3D12 | DLSS Frame Generation ×4 (76.5 → 306.2); DLSS shown as *driver-reported* (it bypasses Streamline); FSR + FSR frame generation ×2 (85.7 → 171.4); XeSS frame generation shown as Presented FPS only; ray tracing *No* | 2026-09-03 → 09-16 | [spike-notes §8, §9](spike-notes.md) |
| Black Myth: Wukong | Unreal Engine 5.0.0 | D3D12 | DLSS Frame Generation ×4 (55.4 → 221.5); ray tracing *Yes* (16.2 % of frames in the app's session); a session that changed state showed its steady state (×4.1) instead of an average | 2026-08-20 → 09-16 | [spike-notes §9, §14](spike-notes.md) |
| Clair Obscur: Expedition 33 | Unreal Engine 5.4.4 | D3D12 | DLSS + Frame Generation ×4 (54.9 → 218.4) and ×2 (76.0 → 149.8); frame generation off read *none*, with DXGI agreeing; ray tracing *No* | 2026-09-04 → 09-06 | [spike-notes §9](spike-notes.md) |
| Clair Obscur: Expedition 33 | Unreal Engine 5.4.4 | D3D12 | DLSS + Frame Generation ×4 (54.9 → 218.4) and ×2 (76.0 → 149.8); frame generation off read *none*, with DXGI agreeing; ray tracing *No*; the NVIDIA App's *Fixed ×6* read ×6.0 (81.8 → 490.9) on 2026-10-20 | 2026-09-04 → 10-20 | [spike-notes §9, §23](spike-notes.md), database |
| Rune Factory: Guardians of Azuma | Unreal Engine (version not in the executable) | D3D12 | DLSS Frame Generation ×4 (128.9 → 513.0); FSR frame generation compiled into the game counted ×2 but not named; ray tracing *No* (the game has none) | 2026-08-20 → 09-06 | [spike-notes §9](spike-notes.md) |
| Kingdom Come: Deliverance II | — | D3D12 | FSR (3.1 or 4) at 1505×847 → 2560×1440; frame generation *none* (the game ships none); ray tracing *No* | 2026-09-04 | [spike-notes §9](spike-notes.md) |
| Lies of P | Unreal Engine 4.27.2 | D3D12 | FSR 3 at 1506×848 → 2560×1440 with FSR frame generation ×2.04 (57.1 → 116.4) in the app; frame generation off read *none*; DLSS shown as *driver-reported*; ray tracing *No* | 2026-08-03 → 09-16 | [spike-notes §7, §9, §14](spike-notes.md) |
| Lies of P | Unreal Engine 4.27.2 | D3D12 | FSR 3 at 1506×848 → 2560×1440 with FSR frame generation ×2.04 (57.1 → 116.4) in the app; frame generation off read *none*; DLSS shown as *driver-reported*; ray tracing *No*; on 2026-10-19 and 10-20, FSR 3 at 1707×961 and at 1280×720 → 2560×1440 with FSR frame generation ×2.0 (54.6 → 109.6, 57.6 → 116.7) and no FSR quality mode — the game never asked for one while the hook was in | 2026-08-03 → 10-20 | [spike-notes §7, §9, §14, §22, §23](spike-notes.md), database |
| Onimusha: Way of the Sword (demo) | RE Engine | D3D12 | DLSS + DLSS Frame Generation: ×3.67 and ×3.93 with the capture tool, ×4.00 in the app's steady state (60 → 240 FPS), ×3.0 (60 → 180) in the app on 2026-09-22; ray tracing *Yes* | 2026-09-05 → 09-22 | [spike-notes §9, §14](spike-notes.md), database |
| Cronos: The New Dawn (demo) | Unreal Engine (version not in the executable) | D3D12 | DLSS with frame generation off (105 FPS, *none*); on ×2 (86.8 → 172.7), DLSS Frame Generation named; ray tracing *Yes* | 2026-09-06 → 09-16 | [spike-notes §9, §14](spike-notes.md) |
| Alan Wake 2 | — | D3D12 | Path tracing Ultra with DLSS and Ray Reconstruction: ray tracing *Yes* (96.8 % of frames), frame generation read ×1.00 (the game did not apply the setting that run). On 2026-09-04: DLSS with ray tracing *Yes* (99 % of frames), 92.5 FPS, frame generation *none* by count; then ray tracing off (*No*), DLSS, Presented 114.5 FPS. The quality preset was never read | 2026-08-04 → 09-04 | [spike-notes §8](spike-notes.md), run reports |
| SILENT HILL 2 | Unreal Engine 5.1 | D3D12 | DLSS Frame Generation identified, frames not counted (Presented 78 FPS); DLSS *driver-reported*; ray tracing *Yes* | 2026-09-25 | database |
| DARK SOULS III | FromSoftware | D3D11 | Presented 59.8 FPS; no upscaler, frame generation or ray tracing loaded | 2026-09-03 | [spike-notes §9](spike-notes.md) |
| Sekiro: Shadows Die Twice | FromSoftware | D3D11 | Presented 60 FPS (the game's cap), two sessions of 15 min and 2 h 18 min | 2026-09-26 | database |
| SILENT HILL 2 | Unreal Engine 5.1 | D3D12 | DLSS Frame Generation identified, frames not counted (Presented 78 FPS) on 2026-09-25; then under the NVIDIA App's *Fixed ×6* ×6.0 (53.3 → 320.0) and under its *Dynamic, up to ×6* states ×2.0, ×3.0 and ×6.1; DLSS *driver-reported*; ray tracing *Yes* | 2026-09-25 → 10-20 | database, [spike-notes §22, §23](spike-notes.md) |
| DARK SOULS III | FromSoftware | D3D11 | Presented 59.8 FPS; no upscaler, frame generation or ray tracing loaded; then 34 sessions at the game's 60 FPS cap, the longest 6 h 12 min, four of them ended by the game crashing | 2026-09-03 → 10-25 | [spike-notes §9](spike-notes.md), database |
| Sekiro: Shadows Die Twice | FromSoftware | D3D11 | Presented 60 FPS (the game's cap): two sessions of 15 min and 2 h 18 min, then three more of up to 1 h 6 min | 2026-09-26 → 10-29 | database |
| Yu-Gi-Oh! Master Duel | Unity 6000.0 | D3D11 | Presented 239 FPS across six sessions (up to 5 h 25 min) | 2026-09-22 → 09-25 | database |
| GIRLS' FRONTLINE 2: EXILIUM | Unity 2019.4 | D3D11 | Presented 53–101 FPS; the last three sessions under the user-mode anti-cheat exception (NetEase Yidun), one of them 3 h 9 min, all ended normally | 2026-09-21 → 09-27 | database, [HANDOFF](HANDOFF.md) |
| GIRLS' FRONTLINE 2: EXILIUM | Unity 2019.4 | D3D11 | Presented 53–101 FPS; the last three sessions under the user-mode anti-cheat exception (NetEase Yidun), one of them 3 h 9 min, all ended normally; ten more under the exception, 28–72 FPS, the longest 2 h 9 min, all ended normally | 2026-09-21 → 10-20 | database, [HANDOFF](HANDOFF.md) |
| Aniimo | Unity 2022.3 | D3D12 | DLSS at 1707×960 → 2560×1440, frame generation *none* (×1.00, 205 FPS), ray tracing *No* — then blocked (below) | 2026-09-22 | database |
| AbyssMemory | Unreal Engine 4.26.1 | D3D11 | Presented 55 FPS, one short session | 2026-09-22 | database |
| Umamusume: Pretty Derby | Unity 2022.3 | D3D11 | Presented 37 FPS, one session | 2026-09-27 | database |
@@ -45,6 +49,21 @@ with the 2026-09-16 recovery and with library entries removed since.
| Flower in Us | RPG Maker MV/MZ (NW.js) | D3D11 | Presented 59.8 FPS over three swap chains, after two refusals that found the game's browser process ambiguous (fixed) | 2026-09-03 → 09-04 | [spike-notes §9](spike-notes.md) |
| UMIGARI | Unreal Engine 5.5.4 | D3D12 | Presented 95–97 FPS, frame generation *none*, ray tracing *No* | 2026-09-05 → 09-06 | run reports only |
| Everhex Demo | — | Vulkan | Presented 239.7 FPS (1 % low 213.5), 14,955 frames in 69 s, through FrameLedger's Vulkan layer — the first real Vulkan game measured; started by Play set to *Start directly* | 2026-10-13 | database *(row added 2026-10-14 from a copy of the database)* |
| The Witcher 3: Wild Hunt — Remastered | — | D3D12 | DLSS 1707×960 → 2560×1440 with DLSS Frame Generation ×2.0 (118.8 → 237.4 FPS); ray tracing and Ray Reconstruction *Yes*; under the NVIDIA App's *Fixed ×6* it still presented ×2.0 — the setting is not the frames | 2026-10-04 → 10-20 | database, [spike-notes §23](spike-notes.md) |
| Phantom Blade Zero | Unreal Engine (version not in the executable) | D3D12 | DLSS *driver-reported*; DLSS Frame Generation under the NVIDIA App's *Dynamic* mode: up to ×6 held ×4.0 (59.5 → 235.6 FPS) and ×5.2 (44.3 → 231.2), up to ×3 held ×3.0 (58–76 → 175–227) for 75–94 % of each session longer than an hour; ray tracing *Yes*; thirteen sessions, the longest 6 h 29 min (5.26 million frames); up to 9.6 GB of graphics memory | 2026-11-01 → 11-05 | database, [spike-notes §26](spike-notes.md) |
| Hogwarts Legacy | Unreal Engine (version not in the executable) | D3D12 | With the game's *Neural Rendering* on, DLSS 5's runtime (`nvngx_dlssnr.dll` 310.9.16.0) loaded from the game's folder — the first game seen loading it; DLSS *driver-reported*; DLSS Frame Generation not counted (non-uniform, ×1.97 overall), Presented 140.2 FPS; ray tracing *Yes*, Ray Reconstruction *No* | 2026-11-06 | database, [spike-notes §26](spike-notes.md) |
| Valor Mortis (Xbox app) | Unreal Engine | D3D12 | DLSS Frame Generation ×6.0 (39.9 → 239.2 FPS), DLSS *driver-reported*, ray tracing *No*; recorded in attach mode | 2026-11-04 | database |
| inKONBINI (Xbox app) | Unity 6000.0 | D3D11 | Presented 205.9 FPS, one short session | 2026-11-03 | database |
| DARK SOULS II: Scholar of the First Sin | FromSoftware | D3D11 | The game's 60 FPS cap, nine sessions up to 5 h 29 min; one was unhooked by the safety check and recorded on | 2026-10-09 → 10-12 | database |
| Mithril | Unreal Engine (version not in the executable) | D3D12 | Presented 91.5–119.4 FPS, ray tracing *Yes*, four sessions up to 3 h 4 min | 2026-10-12 → 10-16 | database |
| KEEP IT ON HER | Unreal Engine 5.8 | D3D12 | Presented 59.5–108.8 FPS, ray tracing *Yes* | 2026-10-12 → 10-13 | database |
| WALTO | Unity 6000.3 | D3D12 | Presented 212.5 FPS over 2 h 41 min (2,057,022 frames) | 2026-10-08 | database |
| White Mask Mansion | Unity 6000.1 | D3D12 | Presented 286–309 FPS, five sessions | 2026-10-27 | database |
| LIMINAL: Within Demo | Unity 2022.3 | D3D11 | Presented 222.5–228.6 FPS | 2026-10-12 | database |
| Sleepytime Village | Unity 2021.3 | D3D11 | Presented 906–1,440 FPS (the game sets no cap) | 2026-10-25 → 10-26 | database |
| Scarlet Wolf | Unity 2021.3 | D3D11 | Presented 128.5 FPS | 2026-10-15 | database |
| March Out! Playtest | Unity 2022.3 | D3D11 | Presented 118.2 FPS | 2026-10-08 | database |
| A Space for the Unbound – Prologue (GOG) | Unity 2019.4 | D3D11 | Presented 61.0 FPS, started by FrameLedger | 2026-10-20 | database |
## Recorded without measurement (Tier 2)
@@ -52,8 +71,14 @@ with the 2026-09-16 recovery and with library entries removed since.
|---|---|---|---|
| HELLO, HELLO WORLD! | A 32-bit game (RPG Maker MV): refused by the guard once, and two sessions with hooking switched off — each recorded with its duration and sensors. *Its itch.io download puts malware in front of the game — do not run it (noted 2026-10-13, [spike-notes §20](spike-notes.md))* | 2026-09-23 | database |
| Umamusume: Pretty Derby | Three sessions played with hooking switched off for the game | 2026-09-27 | database |
| Sekiro: Shadows Die Twice | One session played with hooking switched off | 2026-09-25 | database |
| Sekiro: Shadows Die Twice | Two sessions played with hooking switched off | 2026-09-25, 10-07 | database |
| GIRLS' FRONTLINE 2: EXILIUM | One session whose process Windows would not let FrameLedger open, and two recovered after the agent itself stopped mid-session (*interrupted*) | 2026-09-22 → 09-23 | database |
| Bound Between Desks | Two sessions with hooking switched off (a Ren'Py 8.5 game) | 2026-10-15 → 10-20 | database |
| Phantom Blade Zero | Three sessions after a game update changed its executable on 2026-11-04, until hooking was consented to again on 11-05; one refused because a module list came back incomplete | 2026-11-04 → 11-05 | database |
| The Witcher 3: Wild Hunt — Remastered | Three sessions before hooking was consented to | 2026-10-13 → 10-20 | database |
| Mithril | Two sessions before hooking was consented to | 2026-10-16 | database |
| Hogwarts Legacy | One session with hooking switched off; Windows logged a crash of the game | 2026-11-06 | database |
| Valor Mortis, WALTO, Scarlet Wolf, Lies of P, A Space for the Unbound – Prologue | One session each with hooking switched off | 2026-10-08 → 11-04 | database |
## Refused by the anti-cheat guard
@@ -64,7 +89,10 @@ with the 2026-09-16 recovery and with library entries removed since.
| Aniimo | NetEase Yidun with a kernel driver (`NEPKernel.sys`) in the game's folder — never eligible for an exception | 2026-09-25 | [19_SAFETY](19_SAFETY_AND_ANTICHEAT.md) |
| Goose Goose Duck | Easy Anti-Cheat's service running, and its folder | 2026-08-04 | [spike-notes §13](spike-notes.md) |
| Neverness To Everness | Anti-Cheat Expert's kernel driver in the game's folder | 2026-08-04 | [spike-notes §13](spike-notes.md) |
| Wuthering Waves | Anti-Cheat Expert, kept beside the game's executable four folder levels in, where the check did not look before beta.21: a session with hooking on was injected and unhooked 37 seconds later, when the 30-second re-check met ACE's driver (`ACE-BASE.sys`); nothing was measured. Since beta.21 its folder and its Steam id refuse it before any injection *(row added 2026-10-13 from the agent's log)* | 2026-10-12 | [spike-notes §19](spike-notes.md) |
| Wuthering Waves | Anti-Cheat Expert, kept beside the game's executable four folder levels in, where the check did not look before beta.21: a session with hooking on was injected and unhooked 37 seconds later, when the 30-second re-check met ACE's driver (`ACE-BASE.sys`); nothing was measured. Since beta.21 its folder and its Steam id refuse it before any injection *(row added 2026-10-13 from the agent's log)*; two sessions recorded without measurement on 2026-10-31 | 2026-10-12 → 10-31 | [spike-notes §19](spike-notes.md), database |
| Arknights: Endfield | Anti-Cheat Expert's folder (`AntiCheatExpert`) beside the game; one session recorded without measurement | 2026-10-31 | database |
| Stella Sora | Anti-Cheat Expert's folder (`AntiCheatExpert`); three sessions recorded without measurement | 2026-10-30 → 10-31 | database |
| Umamusume: Pretty Derby | CrackProof, on FrameLedger's title list since beta.11 (Steam 3224770) — measured before the list named it (above) | 2026-10-03 | [19_SAFETY](19_SAFETY_AND_ANTICHEAT.md) |
| Counter-Strike 2 | Valve Anti-Cheat — refused by FrameLedger's title list since beta.8. On 2026-08-04 the checks alone allowed it (VAC is invisible to them); nothing was injected | 2026-08-04, beta.8 | [spike-notes §13](spike-notes.md), [19_SAFETY](19_SAFETY_AND_ANTICHEAT.md) |
Also refused before any injection: **Deadly Heart Gambit** — a 32-bit game (2026-08-03).
@@ -74,4 +102,6 @@ Also refused before any injection: **Deadly Heart Gambit** — a 32-bit game (20
The Unreal Engine version (beta.10) was checked against ten installed Unreal games without running them: Hell Is Us
5.5.4, Black Myth: Wukong 5.0.0, Clair Obscur: Expedition 33 5.4.4, Lies of P 4.27.2, SILENT HILL 2 5.1, UMIGARI 5.5.4,
AbyssMemory 4.26.1, **Martha Is Dead 4.27.0**; Cronos (demo) and Rune Factory name no version in their executables and
read *not found*. ([spike-notes §15](spike-notes.md), [05_DETECTION §Engine version](05_DETECTION.md))
read *not found*. ([spike-notes §15](spike-notes.md), [05_DETECTION §Engine version](05_DETECTION.md)) Read since on the games
in the database: KEEP IT ON HER 5.8 and Wuthering Waves 4.26.2; Phantom Blade Zero, Hogwarts Legacy and Mithril name no
version in their executables, and an Xbox game's executable cannot be read outside its package (Valor Mortis).
+33
View File
@@ -0,0 +1,33 @@
<!-- The second alpha's notes (D73, D82), on main as every release's are; the alpha branch takes them with its sync. CHANGELOG.md lists every release. -->
## [0.1.0-alpha.2] - 2026-11-03
> ⚠ **EXPERIMENTAL BUILD — YOU USE IT AT YOUR OWN RISK.** This is an **alpha**: the source of `0.1.0-beta.33` built on
> **.NET 11 Release Candidate 3** (SDK `11.0.100-rc.3.26522.148`, runtime `11.0.0-rc.3.26522.148`), a version of .NET
> Microsoft has not finished, with the C# 15 compiler. It has not been tested the way a beta is, and it can crash, record
> wrongly or fail to update in ways no beta has. **If you want results you can rely on, use the beta.** Before it runs it
> shows the *Alpha notice* (`legal/ALPHA_NOTICE.md` 1.0), which you must accept, with its own box to tick.
**The second alpha: `0.1.0-beta.33` on .NET 11 RC3** — games from the Xbox app and the Microsoft Store (the beta's
notes, `docs/changelog/0.1.0-beta.33.md`, say what that brings). What an alpha is and how to go back: the user guide's
*Alpha builds* page (`guide/11-alpha-builds.md`), and the *Alpha builds* section of `LIMITATIONS.md`.
**Updating from `0.1.0-alpha.1`:** Help ▸ Check for updates, then *Restart to update* with no game running — an alpha
updates only to newer alphas. Before it first opens your database it copies it to
`%LOCALAPPDATA%\FrameLedger\backups\ledger-before-0.1.0-alpha.2.db` (the newest three copies are kept). The terms window
shows the **Privacy Policy 2.13** once and, as every time an alpha's terms window opens, waits for the Alpha notice's box
to be ticked again; the notice itself stays 1.0. The ledger stays at schema 21; the detection rules move to `2026.11.1`.
**Installing it over a beta:** download `FrameLedger.App-alpha-Setup.exe` below, verify its hash against
`SHA256SUMS.txt`, and let it replace the FrameLedger already installed; the Alpha notice is shown first. **Going back:**
install the newest beta's `FrameLedger.App-win-Setup.exe` over it; your database stays where it is.
**Windows and your PC:** as for the first alpha — Microsoft supports .NET 11 on Windows 11 24H2 and later, and on Windows
10 only in its LTSC and IoT editions; it needs a processor with SSE4.2 and POPCNT. .NET 11 RC3 is supported until .NET 11
ships (10 November 2026); the next alpha moves to the final release.
### What differs from 0.1.0-beta.33
The same as `0.1.0-alpha.1` differed from `0.1.0-beta.32` (`docs/changelog/0.1.0-alpha.1.md`): the runtime and the
compiler, the three libraries serviced with the runtime, what .NET 11 itself changes — and the part of FrameLedger loaded
into a game is the beta's.
+81
View File
@@ -0,0 +1,81 @@
<!-- Moved from CHANGELOG.md's [Unreleased] when 0.1.0-beta.34 was cut, 2026-11-06 (D66). CHANGELOG.md lists every release. -->
## [0.1.0-beta.34] - 2026-11-06
**The thirty-fourth pre-release: DLSS 5 and DLSS 4.5 named from what the game and the driver did, filters on Games
and Compare, and a Games page that opens at once.** The same unsigned installer: verify its hash against
`SHA256SUMS.txt`, then *More info → Run anyway*.
**Updating from `0.1.0-beta.33`:** Help ▸ Check for updates, then *Restart to update* with no game running. The
Disclaimer (2.13) and the Privacy Policy (2.14) are shown once for you to accept; the EULA does not change. The ledger
moves to schema 22, which a beta.33 cannot open. The detection rules move to `2026.11.2`, so every game in the
library is read again once. DLSS 4.5 under the NVIDIA App's *Dynamic* frame generation reads on sessions you already
have; whether DLSS 5's neural rendering ran is kept for sessions recorded from now on.
### Added
- **Filters on Games and Compare** (owner request 2026-11-06, decision D85). Games: store, engine, state, installed and
played, beside the search and sort, with *Clear filters*; the title counts what is shown of all. Compare: game, tier
and frame generation over every session (it listed the newest 200), with a count; a ticked session stays listed.
### Changed
- **The list of games FrameLedger has been run with is current again** (`docs/LIST_GAME_TESTED.md`, decision D35's
method): refreshed from a copy of the owner's database taken 2026-11-06 and reviewed by the owner — fifteen more
games measured hooked, among them Phantom Blade Zero under the NVIDIA App's *Dynamic* mode, Hogwarts Legacy loading
DLSS 5's runtime and the first two Xbox app games — and the sessions recorded without measurement or refused by the
guard since 2026-09-27. The guide's Settings page says a language change stays on Settings; the closed §S30 notes the
fifth Streamline id decoded (`docs/open-questions/closed-s.md`).
- **The Compare page's layout** (the owner's screenshot): the selection bar beside the list instead of a window's width
away, with *Clear selection*; columns sized to what they hold — *Tier* and *FPS* touched, and wide gaps split the rest —;
the date sorts by when; the settings-changed column says so in words or shows a dash (it was blank); the result
table's session labels sit over their columns.
- **The selected page keeps its name in the left pane** (D86): WPF UI's pane animates the selected item's label away
(Compare's, in the screenshot — every page's while selected); FrameLedger uses a copy of its template without that.
- **Games opens at once from any page** (owner request 2026-11-06: switching to Games stalled 0.5–1.5 s). The window
keeps the library page it built and shows it again on every later visit, reading the library again behind it; the
library is read off the UI thread; the cards appear before the executables are checked — a USB drive that sleeps
took a second or more to answer, and no card was shown until every one had — and each card gets its *Not installed*
pill when its check answers; a read keeps every card that would look the same instead of rebuilding them all; the
list view builds only the rows on screen (`spike-notes` §27).
- **Changing the language keeps the page you are on** — Settings, after a change made there. The App remembered only
the pages it opened from code, so the language changed on Settings came back on the last game page opened
(`src/FrameLedger.App/Services/ShellHost.cs`).
- **DLSS 5 is named where the game ran it** (owner decision D84, amending D64). The owner's Hogwarts Legacy, Neural
Rendering on, loaded DLSS 5's runtime (`nvngx_dlssnr.dll` 310.9.16.0, from the game's folder) and the session could say
only *DLSS 5 runtime loaded* — nothing measured whether it ran. The Overlay's Streamline hook now decodes DLSS 5's
feature (`kFeatureDLSS_NR`, Streamline 2.14) into its own per-frame fact, and the Agent keeps the share of the frames
the game rendered through Streamline that carried it (`sessions.dlss_nr_pct`, **schema 0022** — a ledger this build
migrated no longer opens in an earlier one). Seen running, the DLSS line reads *DLSS 5 (neural rendering on 97.3% of
rendered frames)*, above every other generation; loaded and seen not running, *DLSS 5 runtime loaded, not seen
running*; where nothing could tell (an earlier Overlay, a title outside Streamline), *DLSS 5 runtime loaded*, as
before. Its library is listed with its version and source like the others, its Streamline plugin `sl.dlss_nr.dll`
is recorded when loaded, and a game shipping either file shows *Supports DLSS 5 Neural Rendering* (rules
`2026.11.2`, capability `dlss_nr`). The **Privacy Policy 2.14** names neural-rendering libraries among those whose
versions are read; the **Disclaimer 2.13**'s accuracy block says when DLSS 5 is named. One hook-path change: one more
compare in the `slEvaluateFeature` detour and one more test where a present is recorded (`spike-notes` §26).
- **Streamline's headers are `v2.14.16`'s** (developers): the vendored copy was `v2.12.0`, byte for byte; three of its
eleven files change — `kFeatureDLSS_NR`, the uplift buffer types 70–72, `kStructVersion7`, the version — and
nothing FrameLedger consumed otherwise (`src/native/third_party/streamline/README.md`).
- **A session under the NVIDIA App's *Dynamic* frame generation reads DLSS 4.5** (owner decision D83, amending D64).
Dynamic and its ×6 mode exist only in DLSS 4.5, and the DLSS line named a generation from the measured multiplier
alone: the owner's Phantom Blade Zero under *Dynamic, up to ×3* held ×2.0 and ×3.0 and read *DLSS 4 (a ×3.0
frame-generation state)*. It reads *DLSS 4.5 (Dynamic multi frame generation, set in the NVIDIA App)* where the game's
driver profile sets Dynamic, the driver reports its frame-generation override applied in the game's process, and DLSS
Frame Generation was identified (whether or not its factor was counted); a state measured at ×5 or more still ranks first, and a *Fixed* multiplier names nothing
by itself (The Witcher 3 under Fixed ×6 still presented ×2.0). The game page's chip and the CSV's `# dlss:` line
(`basis=dynamic_frame_generation`) follow; the **Disclaimer 2.13** says so in its accuracy block
(`src/FrameLedger.Domain/Detection/DlssGeneration.cs`, `src/FrameLedger.App/Services/DlssText.cs`; `spike-notes` §26).
- **The guard's source reads in order again** (developers only; no behaviour changes): the note that says what runs only
for a target the anti-cheat evaluation allowed sits above the function it describes again — beta.33's two isolation
checks had come between them — and names that isolation check among what runs
(`src/native/FrameLedger.Injector/src/fl_guard.cpp`).
### Fixed
- **An Xbox game's page no longer fails on a strange picture name** in the game's own `MicrosoftGame.config` (beta.33's):
a name that points at a stream of a file (`a:b.png`) made the search for its scaled variants throw — the page then
showed no picture and logged an error, and an action on the page that reloads it could end in the crash report. Such a
name is no picture a package ships, so it is passed over like a name outside the package
(`src/FrameLedger.Infrastructure/Art/XboxArtCache.cs`). Found by a self-review of #351 and #352 after their gates
passed; no install of the owner's eleven titles has such a name.
+85
View File
@@ -0,0 +1,85 @@
# HANDOFF history — 0.1.0-beta.33
*Moved verbatim from `docs/HANDOFF.md` when 0.1.0-beta.34 was cut, 2026-11-06 (owner decision D66); `docs/HANDOFF.md` §How this file is split lists every part. Nothing below was edited, so its "below" and "above" mean HANDOFF.md as it stood.*
## **START HERE** — 2026-11-03, 0.1.0-beta.33: games from the Xbox app and the Microsoft Store
*Status is `docs/changelog/0.1.0-beta.33.md`; this is what no other file carries.* The owner: "Trong phiên này, ta sẽ tập
trung xử lý, đánh giá, phân tích cho các game thuộc MS Store/ Xbox App/Game Pass cho (các) phiên bản tiếp theo nhé. Quy
trình vẫn như mọi lần." — handle, evaluate and analyse the games of the Microsoft Store, the Xbox app and Game Pass for the
next versions, the usual train; the owner's games are in `C:\XboxGames` and `D:\xbox`. #351 (the library, the install
root, detection, the art, Privacy 2.13), #352 (Play, the guard's two refusals, one exe-path reader) and this release;
`0.1.0-alpha.2` follows (D82).
**Decisions (asked while planning, do not re-ask):**
- **D77 — measure first, on the owner's titles**: the launch chain was measured by activating six of the eleven packages
with no FrameLedger hook, read-only, each game closed by its window and never killed, with the decision table committed
before the run (`spike-notes` §25, its two commits in #351).
- **D78 — GDK only**: an app-container (UWP) process is refused with a reason of its own, `TargetAppContainer`, Tier 2
(`19_SAFETY` §The target must be able to take the Overlay); `LIMITATIONS.md` says so.
- **D79 — the platform is "Xbox"** (id `xbox`), full scope: import, art, Play, Tier-1 capture, detection, docs and legal.
- **D80 — Play on an Xbox game always activates its package**, in both D59 modes (`08_UI` §Games): started by its path a
GDK game is never the game in its package — the run corrected the plan's premise that `CreateProcess` fails with error 5
(it hands the launch executable back to the package, so the game is not the launcher's descendant; an Unreal shipping
executable runs outside it). The Agent records such a game in attach mode.
- **D81 — title lists stay keyed by Steam id**: an Xbox copy is matched by everything but that entry; the gap is
`20_OPEN_QUESTIONS` §G *Xbox app / Microsoft Store titles*.
- **D82 — alpha.2 right after beta.33** (the owner runs `0.1.0-alpha.1`, and the alpha's channel is locked): on RC3; if
the train reaches the alpha after .NET 11's release on 2026-11-10, the standing rule applies (SDK 11.0.100, packages
11.0.0) — no new decision.
The Privacy Policy 2.13's wording was approved with the plan (D36).
**Choices made here:**
- **A GDK package root is an install-root boundary**, for the guard's check 4 and for detection alike, and only where no
store boundary matched — so it can only widen what is walked (`19_SAFETY` §Pre-injection checks, amended 2026-11-03).
The guard gained `GamesInstalled\<X>` with it, and one case list read by both test suites
(`tests/fixtures/install-roots/cases.txt`) holds the two resolvers together.
- **`root_file`, a new detection signal**, answered from the install root's own listing, so the `xbox` platform rule —
first, because a GDK FINAL FANTASY ships Steam's DLL — is decidable even where a very large install's walk ran short.
- **The two refusals read the target once, before the primitive**, never at the 30 s re-scan; "could not tell" refuses as
`ProcessUnreadable`, and only enforcing flags count (`SetContextIpValidation` without strict mode is on every
CET-compatible process: `pwsh.exe` reads `0x105`).
- **`TargetResolver` reads the watcher's spelling** (`ProcessImagePath`) but keeps the guard's rights, so D21's
`TargetUnreadable` is unchanged.
**Measured on the way** (`spike-notes` §25): eleven GDK packages, full trust, the user's token, medium integrity, none of
the four mitigations; the image path and the loader's main module both in the `Content` spelling; every game `.exe`
refuses `FILE_READ_DATA`/`FILE_EXECUTE` outside its package, so no Unreal version and no *Runs as* for these titles;
`GetProcessMitigationPolicy` answers through `PROCESS_QUERY_LIMITED_INFORMATION`, and an unknown policy answers
`ERROR_INVALID_PARAMETER`.
**Traps met on the way:**
- **Malwarebytes quarantines `fl_guard_test.exe`** (`Malware.Heuristic.108256`, records in
`C:\ProgramData\Malwarebytes\MBAMService\RtpDetections`) on some builds and not others: ctest then reports `fl_guard` as
passed in 0.5 s with no output and `fl_prescan` with an empty command. Read `LastTest.log` for the assertion count before
believing a native pass; an exclusion for `E:\frameledger\build\` is the owner's to add (a security setting), and CI runs
both suites.
- **`build.ps1` finds the x64 clang-format; `Get-ChildItem … clang-format.exe` finds the ARM64 one first**, which will not
start on this PC.
- **SonarCloud's quality gate on #351 was 77.7 % new-code coverage** (≥ 80 % wanted) and one `cpp:S5813` (`wcslen`): both
closed in #352 — its own gate 95.4 %, main's after the merge 86.5 % on the code since beta.32 with no open issue. The
job is advisory, so a merge on green does not wait for it — read its verdict after each merge.
- **FluentAssertions' `OnlyContain` fails an empty collection**: a test of what this PC holds (`GamingRoots.OnThisPc()`)
passed here and failed on the hosted runner, which has no `.GamingRoot` (#352's first CI run) — assert that nothing
is wrong rather than that everything is right.
**Owner-only:** item 28 — the Xbox titles on real hardware.
### 0.1.0-alpha.2 — the second alpha, the same day (D82)
`alpha` took main at this pull request — `v0.1.0-beta.33` and these notes, no other change — by a merge commit, as
`13_CI_CD` §The alpha line says: no file the switch holds had moved on main, so nothing conflicted and the switch is the
first alpha's (SDK `11.0.100-rc.3.26522.148`, the three packages at `11.0.0-rc.3.26522.148`, the same NuGet licence
texts). Its gate on the 11 SDK must pass before the pull request into `alpha` is merged by hand (the branch has no
auto-merge); the release runs from the signed tag `v0.1.0-alpha.2` on `alpha`, and its delta from alpha.1 is the first
an alpha's release has to find — #350's lookup, by the name the pack lists. Its notes are
`docs/changelog/0.1.0-alpha.2.md`, which open with the experimental-build warning.
- **The next alpha moves to .NET 11's release**: from 2026-11-10 the switch is SDK `11.0.100` and the packages `11.0.0`,
and RC3 is out of support — move the alpha even if no beta comes.
**Owner-only:** item 29 — the second alpha on real hardware.
+9
View File
@@ -121,6 +121,15 @@ rather than of an instance.
> `spike-notes` §8 and §H5 — so item 3's counter has nothing to count on this route. That is
> a separate finding with its own consequences for HANDOFF item 3, and it does not belong to
> this entry.
>
> **2026-11-06 (beta.34, D84): a fifth id is decoded, and not by guess.** `kFeatureDLSS_NR` (1004),
> DLSS 5's neural rendering, comes from Streamline `v2.14.16`'s own `sl_core_types.h`, re-vendored for it
> (`src/native/third_party/streamline/README.md`) — row O4's warning holds: no id is mapped from a number seen
> arriving. Until then an evaluation of it fell to `FL_FEAT_SL_UNDECODED`, which the Agent does not store. It
> is its own fact (`FL_FEAT_SL_NEURAL_RENDERING`, from the drain word, never from the decoded `upscaler`
> byte — the rule above), never an upscaler; the census counts it in a bucket of its own
> (`SlCensus.WithNeuralRendering`), so the buckets still add up. Whether a real game evaluates it through
> `slEvaluateFeature` is owner-only item 30(a), with its table in `spike-notes` §26.
<details>
<summary>The entry as it stood while it was open, including the pre-committed table with its two holes</summary>
+2
View File
@@ -49,3 +49,5 @@ Each section below lives in its own file under `docs/spike-notes/`, moved verbat
| §23 | The owner's runs of beta.26 on real hardware (2026-10-20) | [`spike-notes/23-owner-runs-2026-10-20.md`](spike-notes/23-owner-runs-2026-10-20.md) |
| §24 | The whole gate on .NET 11 RC3 — what the alpha line's SDK asks of the source (2026-10-31, beta.32, D73–D76) | [`spike-notes/24-dotnet11-probe.md`](spike-notes/24-dotnet11-probe.md) |
| §25 | Xbox app / Microsoft Store (GDK) titles — the layout, the launch chain, the image paths (2026-11-03, beta.33, D77–D82) | [`spike-notes/25-xbox-gdk.md`](spike-notes/25-xbox-gdk.md) |
| §26 | DLSS 5 on Hogwarts Legacy, Dynamic frame generation on Phantom Blade Zero, and Streamline 2.12 → 2.14.16 (2026-11-06, beta.34, D83, D84) | [`spike-notes/26-dlss5-dynamic-streamline.md`](spike-notes/26-dlss5-dynamic-streamline.md) |
| §27 | Switching to Games, and a language change that lands elsewhere (2026-11-06, beta.34) | [`spike-notes/27-games-page-2026-11-06.md`](spike-notes/27-games-page-2026-11-06.md) |
@@ -0,0 +1,85 @@
## 26 · DLSS 5 on Hogwarts Legacy, Dynamic frame generation on Phantom Blade Zero, and Streamline 2.12 → 2.14.16 *(2026-11-06, beta.34, owner decisions D83, D84)*
**Why this was measured.** The owner asked, on 2026-11-06, how FrameLedger detects DLSS 5's Neural Rendering on
Hogwarts Legacy — turned on in the game — and why Phantom Blade Zero under the NVIDIA App's *Dynamic* multi frame
generation, up to ×3, read "DLSS 4" when Dynamic and ×6 exist only in DLSS 4.5; then, while the plan was written,
what had changed in Streamline since the copy the Overlay is built against.
**Where, and how.** The owner's ledger was read **read-only** — Python's `sqlite3` with `mode=ro`, no FrameLedger
binary, the Agent of `0.1.0-alpha.2` running beside it — on the dev box of §Environment (Windows 11 Pro build 29648,
i7-14700KF, RTX 5080, 2560×1440 at 240 Hz; NVIDIA driver 32.0.16.2101, then 32.0.16.2114 from 2026-11-05 18:29).
Streamline's headers were compared with the upstream repository's tags through GitHub's API, byte for byte.
### The NVIDIA App's frame-generation settings against the driver's report
`driver_profile` is the game's profile as the Agent read it at the session's start; the FG word and `frameGenerationMode`
are `NvAPI_NGX_GetNGXOverrideState`'s, from `ngx_driver_words`. Bits: `0x1F` initialised … selected, `0x20` preset,
`0x200`/`0x400` created/evaluated, `0x2000` `FG_MODE`, `0x8000` `FG_MULTI_FRAME`.
| Sessions | The App's setting (profile) | FG word | `frameGenerationMode` | Frames counted |
|---|---|---|---|---|
| Phantom Blade Zero 111, 112, 114 (11-01 → 11-02) | `NGX_DLSSG_MODE` 4 *dynamic*, ceiling 5, target `0x01000000` | `0x263F` | 3 | states ×3.0 … ×4.0, ×5.2, ×6.0 |
| Phantom Blade Zero 116 → 129 (11-03 → 11-05), the eight hooked sessions the driver answered (130 was recovered without its report) | `NGX_DLSSG_MODE` 4 *dynamic*, **ceiling 2**, target `0x01000000` | `0x263F` (`0x203F` once) | 3 | ×2.0 and ×3.0 only; ×3.0 held 75–94 % of each session longer than an hour |
| SILENT HILL 2 60, 71 (10-19, 10-20) | `NGX_DLSSG_MODE` 4 *dynamic*, ceiling 5 | `0xA03F` | 3 | ×2.0, ×3.0, ×6.1 |
| Clair Obscur: Expedition 33 64, The Witcher 3 68, SILENT HILL 2 36 | `NGX_DLSSG_MODE` 2 *on*, multi-frame count 5 (*Fixed ×6*) | `0xA03F` | 1 | ×6.0; Witcher 3 ×2.0 |
| Cyberpunk 2077 69 (multiplier chosen in the game) | none set | `0x5` | 0 | ×1.9, ×3.0, ×4.0 |
So the driver reports `FG_MODE` applied under both of the App's modes and its own mode number tells them apart — 3 under
Dynamic, 1 under Fixed, on all sixteen sessions — but NVIDIA's header names neither number. **What D83 reads is the
profile's value, which the header does name (4, `NGX_DLSSG_MODE_DYNAMIC`), with the report's `FG_MODE` bit as proof the
driver applied it**, and DLSS Frame Generation identified in the session (`fg_mode = dlssg`, whether or not its factor
was counted). The ceiling's decode (frames generated per
rendered frame, `03_METRICS` §The mix) held: a ceiling of 5 reached ×6.0, a ceiling of 2 never passed ×3.0.
**Decided (D83):** a session the driver reports running the App's Dynamic mode is **DLSS 4.5**, below a measured ×5 and
above every DLSS 4 row; *Fixed* stays the frames' to name (`05_DETECTION` §DLSS generation).
### DLSS 5 on Hogwarts Legacy
Session 132 (2026-11-06 13:56, hooked, attached, 141 s, Neural Rendering on in the game): `runtime_modules` holds
**`nvngx_dlssnr.dll` 310.9.16.0, loaded from the game's folder** — the name `CensusNames` carried from community sources
(owner-only item 20(d)) seen on a real game for the first time — beside `nvngx_dlss.dll`, `nvngx_dlssd.dll`,
`nvngx_dlssg.dll` 310.9.16.0 and Streamline 2.14.16 (`sl.interposer.dll`, `sl.common.dll`, `sl.dlss_g.dll`,
`sl.reflex.dll`). The install ships the matching Streamline plugin, `Engine\Plugins\Runtime\Nvidia\StreamlineCore\
Binaries\ThirdParty\Win64\sl.dlss_nr.dll` (402,048 bytes; `nvngx_dlssnr.dll` is 266,424,944), which no list asked about.
The driver's super-resolution word read `0x80605` (created and evaluated, no override); the session identified DLSS Frame
Generation but refused a factor (non-uniform, ×1.97 overall); 140.2 FPS presented.
What the App made of it: *DLSS · Super Resolution 310.9.16, from the game · … · DLSS 5 runtime loaded* — loaded, never
whether it ran. Nothing measured that: an evaluation of a Streamline feature the Overlay does not decode lights
`FL_FEAT_SL_UNDECODED`, which the Agent does not store, and the session's `sl_tag_census` (`0x20E00`) shows only that
the game tags a buffer type the census does not name, per frame (bit 17) — which Streamline 2.14 names, below.
### Streamline: the vendored copy against the releases
The vendored closure (`src/native/third_party/streamline`, "main, 2026-08-09") is **byte-identical to tag `v2.12.0`**,
all eleven files. Releases since: `v2.14.1` (2026-09-08: V-Sync and frame-rate limiters in Dynamic multi frame
generation, `VK_NV_low_latency2`) and `v2.14.16` (2026-10-16: fixes) — the version Hogwarts Legacy ships and the NVIDIA
App's override loads (`1B0_E658700.dll` 2.14.16.0). From `v2.12.0` to `v2.14.16` three of the eleven change:
- `sl_core_types.h`: **`kFeatureDLSS_NR = 1004`**; buffer types 70–72, reserved until then, become
`kBufferTypeUpliftInputColor`, `kBufferTypeUpliftOutputColor` and `kBufferTypeUpliftControlMask` — "neural-net
uplift passes", DLSS 5's inputs; `Resource::reserved` (32 bits) becomes `internalFlags` + `reserved` (16 each, the
struct's size unchanged).
- `sl_struct.h`: `kStructVersion7`.
- `sl_version.h`: 2.14.16.
`sl_core_api.h` (`PFun_slEvaluateFeature`), `sl_dlss.h`, `sl.h` and `license.txt` are unchanged, and nothing of
FrameLedger reads `Resource::reserved`. **Decided:** re-vendor at `v2.14.16` (the owner: "check what changed … and fix it
if really needed") so the Overlay decodes DLSS 5's evaluations by the vendor's own constant (D84).
### What beta.34 builds on it, and owner-only item 30(a)'s decision table — written before the run
Built (D84): the Overlay decodes `kFeatureDLSS_NR` into `FL_FEAT_SL_NEURAL_RENDERING` and publishes
`FL_HOOK_SL_NEURAL_RENDERING` with the detour; the Agent stores `dlss_nr_pct` — the share of the Streamline batches that
carried it — only from a writer that published the family. The harness drives the id through an injected Overlay
(`guard_test`, *DLSS 5's neural rendering is its own fact*). What no fixture can say is whether Hogwarts Legacy evaluates
neural rendering through `slEvaluateFeature` at all; one short hooked session each:
| Neural Rendering in the game | `dlss_nr_pct` | What it means, and what follows |
|---|---|---|
| On | above 0 | the game evaluates it through Streamline: *DLSS 5 (neural rendering on N % of rendered frames)* — D84 holds as built |
| On | 0 | Streamline batches drained and none carried 1004: neural rendering runs another way (NGX directly, or another id). The line reads *runtime loaded, not seen running*; record the session's `sl_tag_census`, and the decode is revisited before anything is named |
| On | NULL | no Streamline batch drained, or the family is missing from `hooks_installed_mask` (bit 12): the detour never installed — record which |
| Off | 0, the runtime loaded | the runtime loads with the feature off: "loaded" never meant "on", which is why D84 waits for the evaluation |
| Off | NULL, the runtime not loaded | the game loads it only when on — recorded, nothing changes |
@@ -0,0 +1,41 @@
## 27 · Switching to Games, and a language change that lands elsewhere *(2026-11-06, beta.34)*
**Why this was measured.** The owner, 2026-11-06: switching from any page to Games stalls about 0.5–1.5 s before the
page appears; and changing the language in Settings brings back the last content page (a game's detail) instead of
Settings. §21 (beta.23) had measured the library at 275 ms for 48 games and left it, the grid non-virtualizing by the
owner's decision (2026-10-15); the library has 65 games now.
**What the code showed** (read, then measured): every page is transient and rebuilt per visit; `GamesViewModel` read the
settings, the games and the per-game session summary on the UI thread (Microsoft.Data.Sqlite completes its asynchronous
calls synchronously), then asked for every executable's file **and showed no card until all had answered** — 39 of the
owner's 41 Steam games are on the USB drive D:, which sleeps — and cleared and re-added every card on each read; the list
view's `DataGrid` had no height bound and built every row. WPF UI's `NavigationCacheMode` would not have helped: 4.3.0
reads it only when the NavigationView has neither a service provider nor a page provider, and this App sets one. The
language: `ShellHost` remembered only pages opened from code (`PageNavigator`), never a pane click.
**The decision table, written before the runs:** fix what keeps the first card from appearing, what rebuilds a page on
every visit, and what blocks the UI thread ≥ 50 ms; leave the grid non-virtualizing (the owner's decision); record the
rest.
**How.** A scratch xUnit test over the App's own `GamesViewModel` and `GamesPage` (not committed — it times, and a timing
assertion in CI is a flake), Release, on the dev PC of §21: a scratch ledger shaped like the owner's — 65 games, a third
with a session — with the first executable check held **800 ms** (a USB drive waking) and every later one answering at
once. Seven iterations a run, the median; three runs a side, the code before this change (PR-3's tree) and after it.
*First cards*: from the view model's construction to all 65 cards listed. *Build*: a new page laid out at 1200×900 with
its 65 cards. *Revisit*: before, a new page again (every visit built one); after, the kept page laid out again.
| | before (three runs) | after (three runs) |
|---|---|---|
| First cards | 822 – 830 ms | 10 – 15 ms |
| Build (first visit) | 165 – 197 ms | 164 – 223 ms — the same work, run-to-run noise |
| Revisit | 181 – 215 ms | 15 – 16 ms |
**Built** (beta.34): the window keeps the library page it built (`Services.WindowPageCache`, the window's own page
provider, set after `INavigationService.SetNavigationControl`) and the page reads the library again each time it is shown
(`GamesViewModel.Attach`); the library is read on the thread pool; the cards are listed first and the executable checks
follow, each card getting its *Not installed* pill when its check answers; a read keeps every card that would look the
same (`GameCardViewModel.LooksLike`, `GamesViewModel.Sync` — no `Clear`); the list view is bounded (`MaxHeight` 640).
`ShellHost` notes every page the live window shows, so a rebuild opens on Settings after a change made there.
**Left as it was:** the first visit's build (≈ 2.5–3.4 ms a card at 65) — the non-virtualizing grid's cost, unchanged by
decision; a page kept per window holds its 65 cards' visuals for the window's life.
+5 -3
View File
@@ -19,9 +19,11 @@ A value FrameLedger could not measure reads **N/A** — never 0, and never an es
settled. For FSR it is the mode the game asked AMD's library about and then rendered at; at a dynamic resolution
none is shown.
- **The DLSS line** names the DLSS the game ran: *DLSS 4.5* or *DLSS 4* only when the session showed it (the model
preset the NVIDIA driver reports, or a frame-generation multiplier of ×3 and above), each DLSS library's version and
whether it came from the game or from the graphics driver (the NVIDIA App can swap in the driver's copy), and *DLSS 5
runtime loaded* when it was. With nothing to add to the header's *DLSS*, it is not shown.
preset the NVIDIA driver reports, a frame-generation multiplier of ×3 and above, or the NVIDIA App's *Dynamic* frame
generation, which is DLSS 4.5's), each DLSS library's version and
whether it came from the game or from the graphics driver (the NVIDIA App can swap in the driver's copy). *DLSS 5*
heads the line when the game was seen running its neural rendering — with the share of the frames it rendered —; its
library loaded and nothing seen reads *DLSS 5 runtime loaded* (*not seen running* when FrameLedger looked). With nothing to add to the header's *DLSS*, it is not shown.
- **Frame generation in this session** (sessions recorded with 0.1.0-beta.24 or later) lists every frame-generation
state the session held — `×2.0`, `×4.0`… — each with its own frame rates and its share of the time, then the time
without frame generation, and *Not classified* for time in no state that lasted at least 10 seconds: switching,
+5 -1
View File
@@ -59,6 +59,9 @@ stopped, hooking turned off — each with one button that only says you have rea
## Games
- **Search games**; sort by **Name**, **Last played** or **Playtime**; **Show as a list** or **Show as a grid**.
- **Filters** (since 0.1.0-beta.34): by **store**, **engine**, **state** (Hooking on, Hooking off, Anti-cheat, Exception,
Not recorded), **installed** and **played**; the title then says how many of your games are shown. **Clear filters**
shows them all again.
- **Refresh** reads your library again: it offers games newly installed through a store, and marks a game whose `.exe`
is gone as *Not installed*. The agent removes such a game by itself after ten minutes when it has no sessions and its
drive is connected — never one where anti-cheat was found (**Settings ▸ Data ▸ Remove uninstalled games** turns this
@@ -108,7 +111,8 @@ It opens from a session row, from the Dashboard, and from the notice when a sess
Tick **2 to 5 sessions**, from any of your games, and press **Compare**: one frame-rate curve per measured session, and
a table with the best value of each row in bold. Comparing a measured session with an unmeasured one asks first,
because they measured different things.
because they measured different things. The list holds every session; narrow it by **game**, **tier** (measured or
not) and **frame generation** — a session you ticked stays in the list. **Clear selection** unticks them all.
## Logs
+1 -1
View File
@@ -42,7 +42,7 @@ The link under them, *Read what the hook does and does not do*, opens the safety
| Setting | What it does | Default |
|---|---|---|
| **Theme** | Follow system, Light or Dark. Applies at once. | Follow system |
| **Language** | English, Tiếng Việt or 日本語. The window is rebuilt in the new language at once. | English |
| **Language** | English, Tiếng Việt or 日本語. The window is rebuilt in the new language at once, and stays on Settings (since 0.1.0-beta.34; before, it could open on the last game you looked at). | English |
## Games
+3 -1
View File
@@ -16,7 +16,9 @@ What the words on FrameLedger's screens mean, in alphabetical order. How each fi
says. Sessions are still recorded.
- **Displayed FPS** — the frames you saw, generated frames included.
- **DLSS 4, DLSS 4.5** — NVIDIA's DLSS generations. FrameLedger names one only when the session shows it: the model
preset the NVIDIA driver reports, or a frame-generation multiplier of ×3 and above.
preset the NVIDIA driver reports, a frame-generation multiplier of ×3 and above, or the NVIDIA App's *Dynamic*
frame generation (DLSS 4.5 only).
- **DLSS 5** — NVIDIA's neural rendering. Named only when the game was seen running it (since 0.1.0-beta.34).
- **FG factor** — Displayed FPS divided by Native FPS, shown as `×1.9 FG`.
- **FPS** — frames per second over the time measured.
- **Frame generation** — the technology (DLSS Frame Generation, FSR Frame Generation) that inserts frames the game did
+5 -3
View File
@@ -11,8 +11,8 @@
that changes what FrameLedger.Overlay or the capture host does; date the change.
HTML comments are not part of the block.
-->
> ⚠ **What FrameLedger actually measures today — 2026-10-19.** The software is a beta; its latest
> **beta is `0.1.0-beta.33`** (2026-11-03), an unsigned installer built from that tag with its
> ⚠ **What FrameLedger actually measures today — 2026-11-06.** The software is a beta; its latest
> **beta is `0.1.0-beta.34`** (2026-11-06), an unsigned installer built from that tag with its
> checksums published beside it (alphas — experimental builds on a prerelease .NET — are published apart). The source holds the desktop app
> (library, store import, charts, settings) and the background Agent, which records a session when a
> game in the library runs (unless you switched its recording off), injects only into games you enabled
@@ -44,7 +44,9 @@
> every other case — FSR at a dynamic resolution among them — no mode is shown.
> - **DLSS version:** the version of each DLSS library the game loaded and whether it came from the game or from
> the NVIDIA driver; "DLSS 4" or "DLSS 4.5" only when the session shows it (the model preset the driver reports,
> or a measured multi-frame factor); DLSS 5 only as "runtime loaded".
> a measured multi-frame factor, or the NVIDIA App's Dynamic frame generation that the driver reports applied);
> "DLSS 5" only when the game was seen running its neural rendering, otherwise "runtime loaded" when its library was
> loaded.
> - **Render → output resolution:** measured where the vendor's own per-frame call carries the render
> size (AMD FidelityFX dispatches, and Streamline titles whose resource tags state it); `N/A` where it
> does not: DLSS titles that bypass Streamline, Streamline titles whose tags carry no size, and Vulkan
+6 -4
View File
@@ -1,6 +1,6 @@
# FrameLedger — Disclaimer
**Version:** 2.12 · **Effective:** {{RELEASE_DATE}}
**Version:** 2.13 · **Effective:** {{RELEASE_DATE}}
## 0. This is pre-release software
@@ -115,8 +115,8 @@ Software running inside another process can, in principle, destabilize it. Frame
Frame timing is derived from high-resolution timestamps taken at the moment the game presents each frame; upscaling, frame-generation and ray-tracing state are read from the parameters the game passes to those APIs. This is substantially more accurate than inferring settings from files on disk, but **no measurement is guaranteed to be exact**:
<!-- accuracy-block:begin -->
> ⚠ **What FrameLedger actually measures today — 2026-10-19.** The software is a beta; its latest
> **beta is `0.1.0-beta.33`** (2026-11-03), an unsigned installer built from that tag with its
> ⚠ **What FrameLedger actually measures today — 2026-11-06.** The software is a beta; its latest
> **beta is `0.1.0-beta.34`** (2026-11-06), an unsigned installer built from that tag with its
> checksums published beside it (alphas — experimental builds on a prerelease .NET — are published apart). The source holds the desktop app
> (library, store import, charts, settings) and the background Agent, which records a session when a
> game in the library runs (unless you switched its recording off), injects only into games you enabled
@@ -148,7 +148,9 @@ Frame timing is derived from high-resolution timestamps taken at the moment the
> every other case — FSR at a dynamic resolution among them — no mode is shown.
> - **DLSS version:** the version of each DLSS library the game loaded and whether it came from the game or from
> the NVIDIA driver; "DLSS 4" or "DLSS 4.5" only when the session shows it (the model preset the driver reports,
> or a measured multi-frame factor); DLSS 5 only as "runtime loaded".
> a measured multi-frame factor, or the NVIDIA App's Dynamic frame generation that the driver reports applied);
> "DLSS 5" only when the game was seen running its neural rendering, otherwise "runtime loaded" when its library was
> loaded.
> - **Render → output resolution:** measured where the vendor's own per-frame call carries the render
> size (AMD FidelityFX dispatches, and Streamline titles whose resource tags state it); `N/A` where it
> does not: DLSS titles that bypass Streamline, Streamline titles whose tags carry no size, and Vulkan
+2 -2
View File
@@ -1,6 +1,6 @@
# FrameLedger — Privacy Policy
**Version:** 2.13 · **Effective:** {{RELEASE_DATE}}
**Version:** 2.14 · **Effective:** {{RELEASE_DATE}}
**Short version: everything stays on your PC. FrameLedger has no accounts, no telemetry, no analytics, and never uploads your data anywhere.**
@@ -42,7 +42,7 @@ An exported session (CSV or JSON) and a bug report can contain your games' names
## 4. What the app can technically observe
To do its job, FrameLedger observes: which of *your tracked* executables — the entries in your library whose recording is on — are running, and their process trees; whether a game you enabled hooking for runs in an app container, and which of Windows' code-protection settings it runs under (for example, accepting only Microsoft-signed code), read from Windows before any injection; the parameters your games pass to the graphics APIs it intercepts (presentation, upscaling, ray tracing, pipeline creation); the memory use of a tracked game's process — its dedicated and shared video memory, from Windows' GPU performance counters, and its working sets and commit, from Windows' process-memory information, for which a game it does not inject into is opened with the least access Windows offers and closed again (never its memory's content); loaded module names of a game being captured, the version information of its upscaling and frame-generation libraries, and whether each was loaded from the game's folder or from the graphics driver's own copy (for detection and for the anti-cheat safety check); the names of the files in each library game's install folder, the version information of its executable and of the upscaling libraries it ships, the content of its executable file (the markers of the engine and of the graphics libraries it carries, the libraries it imports, and the engine build name an Unreal Engine game carries), the version marks an engine keeps in its own files (Unity's player library and the header of its data file, the header of a Godot data pack, an RPG Maker game's title, core script and Game.ini, the library Game.ini names, and the version file of a Ren'Py game's engine), and the store files that name it (Steam's and GOG's, on your disk) and, for a game the Xbox app or the Microsoft Store installed, the package files in its install folder that describe it (`MicrosoftGame.config` and `appxmanifest.xml`) — to detect its engine, its engine version and its features and to check it for anti-cheat before any injection is possible; the lists of installed games that the Steam, GOG GALAXY, Epic Games and itch apps keep on your disk, and where GOG GALAXY is installed, the folders the Xbox app installs games into on each drive (named by the `.GamingRoot` file at the drive's root) with each game's package files, and Windows' answer to whether that game's package is installed for you — read when you import your library and when you press Play, to find the store that installed a game and hand the game to that store's app — Steam's and GOG GALAXY's also when you open a game's page, to find the artwork their apps keep for it; the cover and banner images that the Steam and GOG GALAXY apps keep on your disk for a game in your library and the logo and splash-screen images a game from the Xbox app ships in its own folder — read to show them on its page, never copied or sent anywhere; the size, position and state of a tracked game's window and the monitor it is on, read from Windows and not from the game, and — for a game FrameLedger injects into — whether the game asked for exclusive full-screen; the NVIDIA driver's settings for your tracked executables (read only: the DLSS and frame-generation overrides the NVIDIA App set); hardware sensor values from your graphics driver's own libraries; how busy the processor is and how much memory is in use, from Windows' own counters; the crash reports Windows keeps in its Application log about a tracked game's executable while it ran (to tell a crash from an ordinary exit — the reports are read, never sent anywhere); and the names of the programs a tracked game starts, so that a game's own crash reporter is recognised.
To do its job, FrameLedger observes: which of *your tracked* executables — the entries in your library whose recording is on — are running, and their process trees; whether a game you enabled hooking for runs in an app container, and which of Windows' code-protection settings it runs under (for example, accepting only Microsoft-signed code), read from Windows before any injection; the parameters your games pass to the graphics APIs it intercepts (presentation, upscaling, ray tracing, pipeline creation); the memory use of a tracked game's process — its dedicated and shared video memory, from Windows' GPU performance counters, and its working sets and commit, from Windows' process-memory information, for which a game it does not inject into is opened with the least access Windows offers and closed again (never its memory's content); loaded module names of a game being captured, the version information of its upscaling, frame-generation and neural-rendering libraries, and whether each was loaded from the game's folder or from the graphics driver's own copy (for detection and for the anti-cheat safety check); the names of the files in each library game's install folder, the version information of its executable and of the upscaling and neural-rendering libraries it ships, the content of its executable file (the markers of the engine and of the graphics libraries it carries, the libraries it imports, and the engine build name an Unreal Engine game carries), the version marks an engine keeps in its own files (Unity's player library and the header of its data file, the header of a Godot data pack, an RPG Maker game's title, core script and Game.ini, the library Game.ini names, and the version file of a Ren'Py game's engine), and the store files that name it (Steam's and GOG's, on your disk) and, for a game the Xbox app or the Microsoft Store installed, the package files in its install folder that describe it (`MicrosoftGame.config` and `appxmanifest.xml`) — to detect its engine, its engine version and its features and to check it for anti-cheat before any injection is possible; the lists of installed games that the Steam, GOG GALAXY, Epic Games and itch apps keep on your disk, and where GOG GALAXY is installed, the folders the Xbox app installs games into on each drive (named by the `.GamingRoot` file at the drive's root) with each game's package files, and Windows' answer to whether that game's package is installed for you — read when you import your library and when you press Play, to find the store that installed a game and hand the game to that store's app — Steam's and GOG GALAXY's also when you open a game's page, to find the artwork their apps keep for it; the cover and banner images that the Steam and GOG GALAXY apps keep on your disk for a game in your library and the logo and splash-screen images a game from the Xbox app ships in its own folder — read to show them on its page, never copied or sent anywhere; the size, position and state of a tracked game's window and the monitor it is on, read from Windows and not from the game, and — for a game FrameLedger injects into — whether the game asked for exclusive full-screen; the NVIDIA driver's settings for your tracked executables (read only: the DLSS and frame-generation overrides the NVIDIA App set); hardware sensor values from your graphics driver's own libraries; how busy the processor is and how much memory is in use, from Windows' own counters; the crash reports Windows keeps in its Application log about a tracked game's executable while it ran (to tell a crash from an ordinary exit — the reports are read, never sent anywhere); and the names of the programs a tracked game starts, so that a game's own crash reporter is recognised.
It does **not** read game memory outside those API parameters, and does not read game saves, chat, input content, network traffic, or anything unrelated to performance measurement. It records only for programs you added to your library and did not switch recording off for — a program whose recording is off is not watched at all — and injects only into games you individually enabled.
+1 -1
View File
@@ -62,7 +62,7 @@ Telemetry is layered so no proprietary vendor licence is ever required (`docs/18
| `nvapi64.dll` (runtime implementation) | Loaded at runtime from the user's system | Part of the NVIDIA graphics driver | No — never redistributed by us |
| **LibreHardwareMonitorLib** | GPU sensors for **all vendors** (AMD, Intel, NVIDIA) + CPU/board sensors when elevated | **MPL-2.0** | Yes, as an unmodified NuGet package |
| **DXGI + Windows performance counters (PDH)** | Vendor-neutral baseline: utilisation, VRAM, adapter identity | Windows OS APIs | n/a |
| **NVIDIA Streamline headers** (`sl.h`, its eight-file include closure, and `sl_dlss.h`) | Declarations only — `sl::Feature`, the `kFeature*` ids and `PFun_slEvaluateFeature` — so the Overlay's upscaler hook has the vendor's own signature instead of a hand-written guess. **Types and `decltype` only: never linked**, or `sl.interposer.dll` would become a load-time dependency and the Overlay would fail to load in every game that ships no Streamline | **MIT** — <https://github.com/NVIDIA-RTX/Streamline>, `main`, 2026-08-09 | **Vendored 2026-08-09** at `src/native/third_party/streamline/`: `license.txt` and ten headers. **`sl_nvperf.h` is excluded** — the same `license.txt` carries a second, proprietary "NSight Perf SDK License, Version 2023.3" block naming `sl_nvperf.h` and `sl_nvperf.dll`. **All of `external/` is excluded** — upstream's `external/ngx-sdk/` is the RTX SDKs Licence. `license-check.ps1` asserts both exclusions and the grant text |
| **NVIDIA Streamline headers** (`sl.h`, its eight-file include closure, and `sl_dlss.h`) | Declarations only — `sl::Feature`, the `kFeature*` ids and `PFun_slEvaluateFeature` — so the Overlay's upscaler hook has the vendor's own signature instead of a hand-written guess. **Types and `decltype` only: never linked**, or `sl.interposer.dll` would become a load-time dependency and the Overlay would fail to load in every game that ships no Streamline | **MIT** — <https://github.com/NVIDIA-RTX/Streamline>, `main`, 2026-08-09 (= tag `v2.12.0`); tag `v2.14.16` since 2026-11-06 | **Vendored 2026-08-09**, re-vendored at `v2.14.16` on 2026-11-06, at `src/native/third_party/streamline/`: `license.txt` and ten headers. **`sl_nvperf.h` is excluded** — the same `license.txt` carries a second, proprietary "NSight Perf SDK License, Version 2023.3" block naming `sl_nvperf.h` and `sl_nvperf.dll`. **All of `external/` is excluded** — upstream's `external/ngx-sdk/` is the RTX SDKs Licence. `license-check.ps1` asserts both exclusions and the grant text |
| **AMD FidelityFX SDK headers** (`ffx_api.h`, `ffx_api_types.h`, `ffx_upscale.h`, `ffx_framegeneration.h`, `ffx_framegeneration_api_types.h`) | Declarations only — `ffxApiHeader::type`, the `FFX_API_*_DESC_TYPE_*` values, `ffxDispatchDescUpscale::renderSize`, the frame-generation `Prepare` descriptors' `frameID` and `PfnFfxDispatch` — so the Overlay's AMD hook decodes the dispatch descriptor by the vendor's own layout instead of a guess. **Types only: never linked**, and the Overlay defines none of the names the header declares `dllexport` (`hookinventory-check` Pass C reads its export table) | **MIT, by exception** — <https://github.com/GPUOpen-LibrariesAndSDKs/FidelityFX-SDK> tag `v2.3.0` (`60f4ea81`, 2026-06-24). Upstream's `docs/license.md` is a binary-only default licence followed by an MIT exception list; on 2026-09-04 that list named all 845 files in the tree, these five among them, and each header carries the grant in its own banner | **Vendored 2026-09-04** at `src/native/third_party/fidelityfx/`: `license.md` verbatim (exception list included) and five headers in upstream's `Kits/FidelityFX/…` layout. **No `signedbin/`, no `.lib`, no source, no `dx12/` backend headers** (no consumer yet). `license-check.ps1` §2d asserts every vendored path is on the exception list and every header carries the grant |
| **AMD FidelityFX SDK 3.0 host headers** (`ffx_fsr3.h` and its nine-file include closure: `ffx_interface.h`, `ffx_fsr3upscaler.h`, `ffx_frameinterpolation.h`, `ffx_opticalflow.h`, `ffx_assert.h`, `ffx_types.h`, `ffx_error.h`, `ffx_util.h`, `gpu/fsr3upscaler/ffx_fsr3upscaler_resources.h`) | Declarations only — `FfxFsr3DispatchUpscaleDescription::renderSize` and the type of `ffxFsr3ContextDispatchUpscale` — so the Overlay's hook on the FSR 3.0 **host** DLL (`ffx_fsr3_x64.dll`, Cyberpunk 2077's copy, which upscales through named exports rather than the ffx-api facade) reads the render extent by the vendor's own layout. **Types and `decltype` only: never linked**, and the Overlay defines none of the names the header declares `dllexport` (`hookinventory-check` Pass C reads its export table; the `ffx_fsr3_x64.dll` fixture in `tools/vendor-stubs` is that parser's second positive control) | **MIT** — <https://github.com/GPUOpen-LibrariesAndSDKs/FidelityFX-SDK> tag `fsr3-v3.0.4` (`55ff22bb`). The root `LICENSE.txt` at that tag is the MIT grant verbatim and every header carries it inline — a different licence *shape* from the `v2.3.0` row above, which is why it is a separate directory and `license-check.ps1` §2e rather than §2d. The tag is the one whose declarations match the module the title ships (twelve `ffxFsr3*` exports); `v1.1.4`, which the docs first named, declares three more and appends fields to the dispatch descriptor | **Vendored 2026-09-05** at `src/native/third_party/fidelityfx-fsr3/`: `LICENSE.txt` verbatim and ten headers in upstream's `sdk/include/FidelityFX/…` layout, each blob sha checked against the upstream tree. **No backends, no `.cpp`, no shaders, no samples.** `license-check.ps1` §2e asserts the root grant and every header's banner, file by file. Same MIT text as the row above, so `legal/licenses/fidelityfx-MIT.txt` is the notice for both |
| NVIDIA **NGX** / **Streamline**, AMD **FidelityFX**, Intel **XeSS** **runtimes** (the DLLs themselves) | Not loaded, not linked, not redistributed. We observe the calls a *game* makes to the copies it ships (`docs/17_HOOK_ENGINE.md`). Unchanged by the row above, which vendors **headers** and no runtime | — | **No vendor upscaler code is distributed by FrameLedger** |
+2 -1
View File
@@ -42,7 +42,7 @@
"level, which made it a check that could not fire."
],
"schemaVersion": 2,
"rulesVersion": "2026.11.1",
"rulesVersion": "2026.11.2",
"engines": [
{
@@ -191,6 +191,7 @@
{ "id": "dlss", "name": "DLSS", "signals": [ "nvngx_dlss.dll" ] },
{ "id": "dlss_g", "name": "DLSS Frame Gen", "signals": [ "nvngx_dlssg.dll", "sl.dlss_g.dll" ] },
{ "id": "dlss_rr", "name": "Ray Reconstruction","signals": [ "nvngx_dlssd.dll" ] },
{ "id": "dlss_nr", "name": "DLSS 5 Neural Rendering", "signals": [ "nvngx_dlssnr.dll", "sl.dlss_nr.dll" ] },
{ "id": "streamline", "name": "Streamline", "signals": [ "sl.interposer.dll", "sl.reflex.dll" ] },
{ "id": "fsr", "name": "FSR", "signals": [ "ffx_fsr2_*.dll", "ffx_fsr3*.dll", "ffx_frameinterpolation_*.dll", "amd_fidelityfx_*.dll", "ffx_api*.dll" ] },
{ "id": "xess", "name": "XeSS", "signals": [ "libxess.dll", "libxess_dx11.dll" ] },
+2
View File
@@ -163,10 +163,12 @@
</ItemsControl>
</StackPanel>
<!-- beta.34 (D86): our copy of WPF UI's LeftFluent item template, so the selected page keeps its label (Styles/FrameLedger.xaml). -->
<ui:NavigationView x:Name="RootNavigation"
Grid.Row="3"
IsBackButtonVisible="Collapsed"
IsPaneToggleVisible="False"
ItemTemplate="{StaticResource FlLeftFluentNavigationViewItemTemplate}"
PaneDisplayMode="LeftFluent">
<ui:NavigationView.MenuItems>
<ui:NavigationViewItem Content="{x:Static res:Strings.Nav_Dashboard}"
+4 -1
View File
@@ -45,8 +45,11 @@ public partial class MainWindow : FluentWindow
theme.Apply(appearance.Theme, null);
InitializeComponent();
RootNavigation.SetPageProviderService(pages);
navigation.SetNavigationControl(RootNavigation);
// beta.34: this window's own provider, set AFTER SetNavigationControl — which hands the NavigationView the
// container's provider (upstream 4.3.0 NavigationService.SetNavigationControl) and would replace one set before it.
// It keeps the library page for the window's life (WindowPageCache); every other page is the container's.
RootNavigation.SetPageProviderService(new WindowPageCache(pages));
snackbar.SetSnackbarPresenter(SnackbarPresenter);
dialogs.SetDialogHost(DialogHost);
+68 -31
View File
@@ -18,18 +18,44 @@
<ui:TextBlock Margin="0,16,0,0" Style="{StaticResource SecondaryText}" TextWrapping="Wrap" Text="{x:Static vm:CompareViewModel.EmptyText}"
Visibility="{Binding ViewModel.IsEmpty, Converter={StaticResource BoolToVis}}" />
<Grid Margin="0,16,0,0" Visibility="{Binding ViewModel.IsEmpty, Converter={StaticResource InverseBoolToVis}}">
<Grid.ColumnDefinitions>
<ColumnDefinition Width="*" />
<ColumnDefinition Width="Auto" />
<ColumnDefinition Width="Auto" />
</Grid.ColumnDefinitions>
<ui:TextBlock Grid.Column="0" FontTypography="Subtitle" Text="{x:Static vm:CompareViewModel.PickHeader}" />
<ui:TextBlock Grid.Column="1" Margin="0,0,16,0" VerticalAlignment="Center" Style="{StaticResource SecondaryText}" Text="{Binding ViewModel.SelectedText}" />
<ui:Button Grid.Column="2" Appearance="Primary" Command="{Binding ViewModel.CompareCommand}" IsEnabled="{Binding ViewModel.CanCompare}"
Content="{x:Static vm:CompareViewModel.RunText}" Icon="{ui:SymbolIcon ArrowSwap24}" />
</Grid>
<!-- beta.34 (owner request 2026-11-06, D85): the filters - game, tier, frame generation - over every session, and how
many the list holds; a ticked session stays listed whatever they say. -->
<WrapPanel Margin="0,16,0,0" Orientation="Horizontal"
Visibility="{Binding ViewModel.IsEmpty, Converter={StaticResource InverseBoolToVis}}">
<ComboBox MinWidth="220" Margin="0,0,8,8" VerticalAlignment="Center"
AutomationProperties.Name="{x:Static res:Strings.A11y_Compare_Filter_Game}"
DisplayMemberPath="Label" ItemsSource="{Binding ViewModel.Games}"
SelectedValue="{Binding ViewModel.GameFilter, Mode=TwoWay}" SelectedValuePath="Value" />
<ComboBox MinWidth="180" Margin="0,0,8,8" VerticalAlignment="Center"
AutomationProperties.Name="{x:Static res:Strings.A11y_Compare_Filter_Tier}"
DisplayMemberPath="Label" ItemsSource="{Binding ViewModel.Tiers}"
SelectedValue="{Binding ViewModel.TierFilter, Mode=TwoWay}" SelectedValuePath="Value" />
<ComboBox MinWidth="240" Margin="0,0,8,8" VerticalAlignment="Center"
AutomationProperties.Name="{x:Static res:Strings.A11y_Compare_Filter_Fg}"
DisplayMemberPath="Label" ItemsSource="{Binding ViewModel.FrameGenerationChoices}"
SelectedValue="{Binding ViewModel.FrameGenerationFilter, Mode=TwoWay}" SelectedValuePath="Value" />
<ui:Button Margin="0,0,16,8" VerticalAlignment="Center" Appearance="Secondary"
Command="{Binding ViewModel.ClearFiltersCommand}"
Content="{x:Static vm:CompareViewModel.ClearFiltersText}" Icon="{ui:SymbolIcon FilterDismiss24}" />
<ui:TextBlock Margin="0,0,0,8" VerticalAlignment="Center" Style="{StaticResource SecondaryText}" Text="{Binding ViewModel.CountText}" />
</WrapPanel>
<!-- beta.34: the selection bar beside what it acts on - it sat at the window's far right, a full width away from the list. -->
<StackPanel Margin="0,8,0,0" Orientation="Horizontal"
Visibility="{Binding ViewModel.IsEmpty, Converter={StaticResource InverseBoolToVis}}">
<ui:TextBlock Margin="0,0,16,0" VerticalAlignment="Center" FontTypography="Subtitle" Text="{x:Static vm:CompareViewModel.PickHeader}" />
<ui:TextBlock Margin="0,0,16,0" VerticalAlignment="Center" Style="{StaticResource SecondaryText}" Text="{Binding ViewModel.SelectedText}" />
<ui:Button Margin="0,0,8,0" Appearance="Secondary" Command="{Binding ViewModel.ClearSelectionCommand}"
Content="{x:Static vm:CompareViewModel.ClearSelectionText}" />
<ui:Button Appearance="Primary" Command="{Binding ViewModel.CompareCommand}" IsEnabled="{Binding ViewModel.CanCompare}"
Content="{x:Static vm:CompareViewModel.RunText}" Icon="{ui:SymbolIcon ArrowSwap24}" />
</StackPanel>
<!--
beta.34: columns sized to what they hold, and one filler column after them - three star columns spread a wide
window into gaps, and the Tier column was exactly its header's width, so "Tier" and "FPS" touched. The date sorts
by when, not by its text; the settings-changed cell says so in words, or shows a dash.
-->
<DataGrid Margin="0,8,0,0" MaxHeight="320" AutoGenerateColumns="False" CanUserAddRows="False" HeadersVisibility="Column"
ItemsSource="{Binding ViewModel.Candidates}" SelectionMode="Single"
Visibility="{Binding ViewModel.IsEmpty, Converter={StaticResource InverseBoolToVis}}">
@@ -44,18 +70,23 @@
</DataTemplate>
</DataGridTemplateColumn.CellTemplate>
</DataGridTemplateColumn>
<DataGridTextColumn Header="{x:Static res:Strings.Compare_Col_Game}" Binding="{Binding GameName}" IsReadOnly="True" Width="2*" />
<DataGridTextColumn Header="{x:Static res:Strings.Compare_Col_Date}" Binding="{Binding DateText}" IsReadOnly="True" Width="*" />
<DataGridTextColumn Header="{x:Static res:Strings.Compare_Col_Tier}" Binding="{Binding TierText}" IsReadOnly="True" Width="Auto" />
<DataGridTextColumn Header="{x:Static res:Strings.Compare_Col_Fps}" Binding="{Binding ReadoutLine}" IsReadOnly="True" Width="2*" />
<DataGridTemplateColumn Header="{x:Static res:Strings.Compare_Col_MidSession}" IsReadOnly="True">
<DataGridTextColumn Header="{x:Static res:Strings.Compare_Col_Game}" Binding="{Binding GameName}" IsReadOnly="True" Width="Auto" MinWidth="220" />
<DataGridTextColumn Header="{x:Static res:Strings.Compare_Col_Date}" Binding="{Binding DateText}" SortMemberPath="StartedAt" IsReadOnly="True" Width="Auto" MinWidth="150" />
<DataGridTextColumn Header="{x:Static res:Strings.Compare_Col_Tier}" Binding="{Binding TierText}" IsReadOnly="True" Width="Auto" MinWidth="64" />
<DataGridTextColumn Header="{x:Static res:Strings.Compare_Col_Fps}" Binding="{Binding ReadoutLine}" IsReadOnly="True" Width="Auto" MinWidth="220" />
<DataGridTemplateColumn Header="{x:Static res:Strings.Compare_Col_MidSession}" IsReadOnly="True" Width="Auto" MinWidth="150" SortMemberPath="SettingsChangedMidSession">
<DataGridTemplateColumn.CellTemplate>
<DataTemplate DataType="{x:Type vm:CompareCandidateViewModel}">
<ui:SymbolIcon Symbol="Warning24" Foreground="{DynamicResource SystemFillColorCautionBrush}"
Visibility="{Binding SettingsChangedMidSession, Converter={StaticResource BoolToVis}}" />
<StackPanel Margin="4,0" Orientation="Horizontal" VerticalAlignment="Center">
<ui:SymbolIcon Margin="0,0,6,0" Symbol="Warning24" Foreground="{DynamicResource SystemFillColorCautionBrush}"
Visibility="{Binding SettingsChangedMidSession, Converter={StaticResource BoolToVis}}" />
<TextBlock VerticalAlignment="Center" Text="{Binding SettingsChangedText}" />
</StackPanel>
</DataTemplate>
</DataGridTemplateColumn.CellTemplate>
</DataGridTemplateColumn>
<!-- the filler: the width the columns above do not need, so they stay together on a wide window -->
<DataGridTemplateColumn Width="*" CanUserSort="False" CanUserResize="False" IsReadOnly="True" />
</DataGrid.Columns>
</DataGrid>
@@ -75,19 +106,25 @@
<charts:CompareChart x:Name="Chart" Margin="0,6,0,0" Height="340" />
<ui:TextBlock Margin="0,16,0,0" FontTypography="Subtitle" Text="{x:Static vm:CompareViewModel.TableHeader}" />
<!-- the header row: one label per compared session -->
<ItemsControl Margin="0,6,0,0" ItemsSource="{Binding ViewModel.Compared}">
<ItemsControl.ItemsPanel>
<ItemsPanelTemplate>
<UniformGrid Rows="1" />
</ItemsPanelTemplate>
</ItemsControl.ItemsPanel>
<ItemsControl.ItemTemplate>
<DataTemplate DataType="{x:Type vm:CompareCandidateViewModel}">
<ui:TextBlock Margin="4,0" Style="{StaticResource SecondaryText}" FontTypography="Caption" TextWrapping="Wrap" Text="{Binding Label}" />
</DataTemplate>
</ItemsControl.ItemTemplate>
</ItemsControl>
<!-- the header row: the metric column's own header, then one label per compared session - laid out as every row
below is (a 140-px metric cell, then the sessions sharing the rest), so each label sits over its column;
beta.34: it spread over the whole width, the 140 px included, and drifted left of its values. -->
<DockPanel Margin="0,6,0,0">
<ui:TextBlock DockPanel.Dock="Left" Width="140" Style="{StaticResource SecondaryText}" FontTypography="Caption"
Text="{x:Static vm:CompareViewModel.MetricHeader}" />
<ItemsControl ItemsSource="{Binding ViewModel.Compared}">
<ItemsControl.ItemsPanel>
<ItemsPanelTemplate>
<UniformGrid Rows="1" />
</ItemsPanelTemplate>
</ItemsControl.ItemsPanel>
<ItemsControl.ItemTemplate>
<DataTemplate DataType="{x:Type vm:CompareCandidateViewModel}">
<ui:TextBlock Margin="4,0" Style="{StaticResource SecondaryText}" FontTypography="Caption" TextWrapping="Wrap" Text="{Binding Label}" />
</DataTemplate>
</ItemsControl.ItemTemplate>
</ItemsControl>
</DockPanel>
<ItemsControl ItemsSource="{Binding ViewModel.Rows}">
<ItemsControl.ItemTemplate>
<DataTemplate DataType="{x:Type vm:CompareRowViewModel}">
+34 -2
View File
@@ -62,6 +62,36 @@
Icon="{ui:SymbolIcon Add24}" />
</Grid>
<!-- beta.34 (owner request 2026-11-06, D85): the filters - store, engine, state, installed, played - beside the search
and sort above; each list names its "everything" first, and the stores and engines are the library's own. -->
<WrapPanel Margin="0,12,0,0" Orientation="Horizontal"
Visibility="{Binding ViewModel.IsEmpty, Converter={StaticResource InverseBoolToVis}}">
<ComboBox MinWidth="150" Margin="0,0,8,8" VerticalAlignment="Center"
AutomationProperties.Name="{x:Static res:Strings.A11y_Games_Filter_Store}"
DisplayMemberPath="Label" ItemsSource="{Binding ViewModel.Stores}"
SelectedValue="{Binding ViewModel.StoreFilter, Mode=TwoWay}" SelectedValuePath="Value" />
<ComboBox MinWidth="170" Margin="0,0,8,8" VerticalAlignment="Center"
AutomationProperties.Name="{x:Static res:Strings.A11y_Games_Filter_Engine}"
DisplayMemberPath="Label" ItemsSource="{Binding ViewModel.Engines}"
SelectedValue="{Binding ViewModel.EngineFilter, Mode=TwoWay}" SelectedValuePath="Value" />
<ComboBox MinWidth="150" Margin="0,0,8,8" VerticalAlignment="Center"
AutomationProperties.Name="{x:Static res:Strings.A11y_Games_Filter_State}"
DisplayMemberPath="Label" ItemsSource="{Binding ViewModel.States}"
SelectedValue="{Binding ViewModel.StateFilter, Mode=TwoWay}" SelectedValuePath="Value" />
<ComboBox MinWidth="150" Margin="0,0,8,8" VerticalAlignment="Center"
AutomationProperties.Name="{x:Static res:Strings.A11y_Games_Filter_Installed}"
DisplayMemberPath="Label" ItemsSource="{Binding ViewModel.InstalledChoices}"
SelectedValue="{Binding ViewModel.InstalledFilter, Mode=TwoWay}" SelectedValuePath="Value" />
<ComboBox MinWidth="150" Margin="0,0,8,8" VerticalAlignment="Center"
AutomationProperties.Name="{x:Static res:Strings.A11y_Games_Filter_Played}"
DisplayMemberPath="Label" ItemsSource="{Binding ViewModel.PlayedChoices}"
SelectedValue="{Binding ViewModel.PlayedFilter, Mode=TwoWay}" SelectedValuePath="Value" />
<ui:Button Margin="0,0,0,8" VerticalAlignment="Center" Appearance="Secondary"
Command="{Binding ViewModel.ClearFiltersCommand}"
Content="{x:Static vm:GamesViewModel.ClearFiltersText}"
Icon="{ui:SymbolIcon FilterDismiss24}" />
</WrapPanel>
<ui:TextBlock Margin="0,16,0,0" Style="{StaticResource SecondaryText}" TextWrapping="Wrap"
Text="{x:Static vm:GamesViewModel.EmptyText}"
Visibility="{Binding ViewModel.IsEmpty, Converter={StaticResource BoolToVis}}" />
@@ -123,8 +153,10 @@
</ItemsControl.ItemTemplate>
</ItemsControl>
<!-- The list: one row per game across the width; double-click or Enter opens it. -->
<DataGrid x:Name="GameList" Margin="0,16,0,0" AutoGenerateColumns="False" CanUserAddRows="False" CanUserDeleteRows="False"
<!-- The list: one row per game across the width; double-click or Enter opens it. Bounded since beta.34, as the
Sessions grid is since beta.23: inside the page's scroller it was measured with no height limit and built every
row, a Play button each (spike-notes §21, §27). -->
<DataGrid x:Name="GameList" Margin="0,16,0,0" MaxHeight="640" AutoGenerateColumns="False" CanUserAddRows="False" CanUserDeleteRows="False"
CanUserSortColumns="False" HeadersVisibility="Column" IsReadOnly="True" SelectionMode="Single"
ItemsSource="{Binding ViewModel.Games}"
MouseDoubleClick="OnListDoubleClick" KeyDown="OnListKeyDown"
+38 -5
View File
@@ -15,7 +15,9 @@ namespace FrameLedger.App.Services;
/// <summary>
/// The DLSS a session ran, in words (beta.24, owner decision D64; <c>05_DETECTION</c> §DLSS generation): each DLSS
/// library's version and where it was loaded from, the model preset the NVIDIA driver reports, and a generation only
/// where the session shows one (<see cref="DlssGeneration"/>, strongest evidence first). DLSS 5 only as "runtime loaded".
/// where the session shows one (<see cref="DlssGeneration"/>, strongest evidence first) — since beta.34 (D83) also the
/// NVIDIA App's Dynamic frame generation the driver reports applied, and (D84) DLSS 5 where its neural rendering was seen
/// running; a DLSS 5 runtime that was only loaded says so, and whether the Overlay looked.
/// </summary>
/// <remarks>Read from what the row stores; nothing here infers a generation from a version that does not name one.</remarks>
[SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format strings are resources that follow the UI culture, which changes at runtime")]
@@ -32,7 +34,8 @@ public static class DlssText
{
ArgumentNullException.ThrowIfNull(row);
Dictionary<string, string?> modules = Modules(row.RuntimeModulesJson);
return new DlssEvidence(VersionOf(modules, _superResolutionFile), VersionOf(modules, _frameGenerationFile), ReportedPreset(row), LargestFrameGenerationFactor(row));
return new DlssEvidence(VersionOf(modules, _superResolutionFile), VersionOf(modules, _frameGenerationFile), ReportedPreset(row), LargestFrameGenerationFactor(row),
DynamicFrameGeneration(row), row.DlssNrPct);
}
/// <summary>The generation the row establishes, as a label with what it rests on (<c>DLSS 4.5 (preset L)</c>), or null.</summary>
@@ -45,7 +48,8 @@ public static class DlssText
/// <summary>
/// The summary's DLSS line: the label first when one is established, then each library with its version, where it was
/// loaded from and — for super resolution — the preset the driver reports, then DLSS 5's runtime when it was loaded.
/// loaded from and — for super resolution — the preset the driver reports, then DLSS 5's runtime when it was loaded —
/// since beta.34 (D84) listed as a library too, and, where it is not the label, whether it was seen running.
/// Null for a session with no DLSS library, no DLSS upscaler and no DLSS Frame Generation — and, since beta.27, where it
/// would say only "DLSS": the header already names the upscaler. The NVIDIA App's override loads its libraries under
/// names no census lists (Witcher 3, 2026-10-20: <c>160_E658700.bin</c>, which the loaded-libraries line prints), and an
@@ -74,9 +78,12 @@ public static class DlssText
parts.Add(preset);
}
if (modules.ContainsKey(_neuralRenderingFile))
AddLibrary(parts, modules, sources, _neuralRenderingFile, Strings.Dlss_Feature_NeuralRendering, detail: null);
if (modules.ContainsKey(_neuralRenderingFile) && evidence.NeuralRenderingPct is not > 0)
{
parts.Add(Strings.Dlss_NeuralRendering_Loaded);
// Loaded, and not the label: a writer that decodes it saw it evaluate nowhere (0 %), or nothing could tell
// (null: an Overlay before beta.34, or a title that never went through Streamline) — never "off".
parts.Add(evidence.NeuralRenderingPct is null ? Strings.Dlss_NeuralRendering_Loaded : Strings.Dlss_NeuralRendering_NotSeen);
}
return label is null && parts.Count == 1 ? null : string.Join(" · ", parts);
@@ -108,6 +115,11 @@ public static class DlssText
parts.Add("preset=" + letter.ToString(_inv));
}
if (row.DlssNrPct is double neural)
{
parts.Add("neural_rendering_pct=" + neural.ToString("0.0", _inv));
}
return parts.Count == 0 ? "N/A" : string.Join("; ", parts);
}
@@ -116,6 +128,8 @@ public static class DlssText
{
DlssBasis.Preset => string.Format(CultureInfo.CurrentCulture, Strings.Nv_Preset_Format, DlssGeneration.PresetLetter(evidence.Preset)),
DlssBasis.FrameGenerationFactor => string.Format(CultureInfo.CurrentCulture, Strings.Dlss_Basis_Factor_Format, evidence.LargestFrameGenerationFactor),
DlssBasis.DynamicFrameGeneration => Strings.Dlss_Basis_Dynamic,
DlssBasis.NeuralRendering => string.Format(CultureInfo.CurrentCulture, Strings.Dlss_Basis_NeuralRendering_Format, Formats.Share(evidence.NeuralRenderingPct)),
_ => string.Format(CultureInfo.CurrentCulture, Strings.Dlss_Basis_Library_Format, Short(evidence.SuperResolution is { Major: 2 or 3 } ? evidence.SuperResolution : evidence.FrameGeneration)),
});
@@ -123,6 +137,8 @@ public static class DlssText
{
DlssBasis.Preset => "preset",
DlssBasis.FrameGenerationFactor => "frame_generation_factor",
DlssBasis.DynamicFrameGeneration => "dynamic_frame_generation",
DlssBasis.NeuralRendering => "neural_rendering",
_ => "library_version",
};
@@ -132,6 +148,7 @@ public static class DlssText
DlssGenerationKind.Dlss3 => "DLSS 3",
DlssGenerationKind.Dlss4 => "DLSS 4",
DlssGenerationKind.Dlss45 => "DLSS 4.5",
DlssGenerationKind.Dlss5 => "DLSS 5",
_ => "DLSS",
};
@@ -183,6 +200,22 @@ public static class DlssText
: null;
}
/// <summary>
/// The NVIDIA App's Dynamic frame generation ran in the session (beta.34, D83): DLSS Frame Generation was identified, the
/// game's driver profile sets <c>NGX_DLSSG_MODE</c> to Dynamic, and the driver's frame-generation word reports the mode
/// override applied in the game's process (<see cref="NgxOverrideFlags.FgMode"/>). The driver's own mode number —
/// 3 under Dynamic and 1 under Fixed on every stored session (<c>spike-notes</c> §26) — is not what is read: NVIDIA's
/// header names the profile's values and not the report's. A profile that sets Dynamic the driver never applied, or a
/// session where no DLSS Frame Generation was identified, is not evidence; a factor the count refused takes nothing
/// from it.
/// </summary>
private static bool DynamicFrameGeneration(SessionRow row) =>
Is(row.FgMode, "dlssg")
&& DriverProfileRecord.Parse(row.DriverProfileJson) is { } profile && NvidiaOverrides.IsRead(profile)
&& profile.ValueOf(NvidiaDriverSettings.DlssgMode) == NvidiaDriverSettings.DlssgModeDynamic
&& NgxDriverWords.Parse(row.NgxDriverWordsJson) is { Outcome: nameof(NgxProbeOutcome.Answered) } words
&& (Mask(words.Fg) & NgxOverrideFlags.FgMode) != 0;
/// <summary>The largest DLSS Frame Generation state the session measured: the mix's states, else its one factor.</summary>
private static double? LargestFrameGenerationFactor(SessionRow row)
{
+3 -8
View File
@@ -108,14 +108,9 @@ public sealed class GameLibrary
return [];
}
var names = new Dictionary<long, string>();
foreach (long gameId in rows.Select(static r => r.GameId).Distinct())
{
GameRow? game = await _games.FindByIdAsync(gameId, ct).ConfigureAwait(false);
names[gameId] = game?.Name ?? Strings.Common_NotAvailable;
}
return [.. rows.Select(r => new RecentSession(r, names[r.GameId]))];
// One read of the library's names (beta.34): Compare now lists every session, and a read per game was a query each.
Dictionary<long, string> names = (await _games.ListAsync(ct).ConfigureAwait(false)).ToDictionary(static g => g.Id, static g => g.Name);
return [.. rows.Select(r => new RecentSession(r, names.GetValueOrDefault(r.GameId) ?? Strings.Common_NotAvailable))];
}
public async Task<LibraryTotals> TotalsAsync(CancellationToken ct = default)
@@ -134,7 +134,7 @@ public static class NvidiaOverrides
string? fixedCount = multiplier is null ? null : string.Format(CultureInfo.CurrentCulture, Strings.FgMix_Context_Fixed_Format, multiplier);
return profile.ValueOf(S.DlssgMode) switch
{
4 => string.Join(", ", new[]
S.DlssgModeDynamic => string.Join(", ", new[]
{
Strings.FgMix_Context_Dynamic,
Multiplier(profile.ValueOf(S.DlssgDynamicMultiFrameCountMax)) is { } ceiling ? string.Format(CultureInfo.CurrentCulture, Strings.FgMix_Context_UpTo_Format, ceiling) : null,
@@ -250,7 +250,7 @@ public static class NvidiaOverrides
1 => Strings.Nv_FgMode_Off,
2 => Strings.Nv_FgMode_On,
3 => Strings.Nv_FgMode_Auto,
4 => Strings.Nv_FgMode_Dynamic,
S.DlssgModeDynamic => Strings.Nv_FgMode_Dynamic,
_ => null,
};
+19
View File
@@ -35,6 +35,10 @@ public sealed class ShellHost(IServiceProvider services, INavigationService navi
MainWindow window = services.GetRequiredService<MainWindow>();
window.Closing += OnClosing;
window.Closed += OnClosed;
// beta.34 (owner request 2026-11-06): every page the window shows is the one a rebuild opens on — a click in the pane
// included, which never went through PageNavigator. A language changed on Settings stays on Settings; it came back
// on the last page opened from code (a game's page, typically).
window.RootNavigation.Navigated += (_, e) => NoteShown(ReferenceEquals(window, _current), e.Page);
_current = window;
window.Show();
Interlocked.Exchange(ref _handle, new System.Windows.Interop.WindowInteropHelper(window).Handle);
@@ -71,6 +75,21 @@ public sealed class ShellHost(IServiceProvider services, INavigationService navi
/// <summary>The page the shell will open on, kept across a rebuild.</summary>
public void Remember(Type page) => _page = page;
/// <summary>The page a rebuild opens on (beta.34: the page on screen).</summary>
internal Type Page => _page;
/// <summary>
/// A page the live window shows (beta.34): remembered whichever way it was reached — the pane, the keyboard, a link, code.
/// The old window of a rebuild, closing, changes nothing.
/// </summary>
internal void NoteShown(bool live, object? page)
{
if (live && page is not null)
{
_page = page.GetType();
}
}
/// <summary>
/// A new window in the current UI culture; the old one closes after the new one is up. The long-lived pieces that
/// read their text once — the tray's menu, the Agent pill — read it again (<see cref="ILanguageFollower"/>, beta.15).
@@ -0,0 +1,60 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using FrameLedger.App.Pages;
using Wpf.Ui.Abstractions;
namespace FrameLedger.App.Services;
/// <summary>
/// The window's page provider (beta.34, owner request 2026-11-06: "switching to Games stalls 0.5–1.5 s"): the container's,
/// except that the library page is built once per window and shown again on every later visit — its cards already laid
/// out — and reads the library again in the background (<see cref="ViewModels.GamesViewModel.Attach"/>).
/// </summary>
/// <remarks>
/// <para>
/// <b>Why not WPF UI's own cache.</b> <c>NavigationViewItem.NavigationCacheMode</c> is read only when the NavigationView has
/// neither a service provider nor a page provider (upstream 4.3.0 <c>NavigationView.Navigation.cs</c>,
/// <c>GetNavigationItemInstance</c>): this App sets a page provider, so the attribute would have changed nothing.
/// </para>
/// <para>
/// <b>Why per window.</b> A language change builds a new window (<see cref="ShellHost.Rebuild"/>) and shows it before the
/// old one closes: a page shared between them would be asked into a second frame while the first still holds it, and would
/// keep the old language's text. One instance of this class per <see cref="MainWindow"/> keeps both apart — the new window
/// builds its own page in the new language.
/// </para>
/// <para>
/// The pages stay transient in the container (<c>16_WPFUI_SYNTAX</c> §Navigation); only <see cref="Kept"/> are held, and
/// only by the window that built them.
/// </para>
/// </remarks>
public sealed class WindowPageCache(INavigationViewPageProvider inner) : INavigationViewPageProvider
{
private readonly INavigationViewPageProvider _inner = inner ?? throw new ArgumentNullException(nameof(inner));
private readonly Dictionary<Type, object> _kept = [];
/// <summary>The pages a window keeps: the library, the one page whose build grows with the data (<c>spike-notes</c> §21, §27).</summary>
public static IReadOnlySet<Type> Kept { get; } = new HashSet<Type> { typeof(GamesPage) };
public object? GetPage(Type pageType)
{
ArgumentNullException.ThrowIfNull(pageType);
if (!Kept.Contains(pageType))
{
return _inner.GetPage(pageType);
}
if (_kept.TryGetValue(pageType, out object? page))
{
return page;
}
page = _inner.GetPage(pageType);
if (page is not null)
{
_kept[pageType] = page;
}
return page;
}
}
+102
View File
@@ -29,6 +29,14 @@ public static class Strings
/// <summary>Every key, for an audit that walks them.</summary>
public static IReadOnlyList<string> Keys { get; } =
[
nameof(A11y_Compare_Filter_Fg),
nameof(A11y_Compare_Filter_Game),
nameof(A11y_Compare_Filter_Tier),
nameof(A11y_Games_Filter_Engine),
nameof(A11y_Games_Filter_Installed),
nameof(A11y_Games_Filter_Played),
nameof(A11y_Games_Filter_State),
nameof(A11y_Games_Filter_Store),
nameof(A11y_Games_Sort),
nameof(A11y_Logs_Level),
nameof(A11y_Logs_Source),
@@ -161,14 +169,24 @@ public static class Strings
nameof(Common_NotAvailable),
nameof(Common_Ok),
nameof(Common_Yes),
nameof(Compare_ClearSelection),
nameof(Compare_Col_Date),
nameof(Compare_Col_Fps),
nameof(Compare_Col_Game),
nameof(Compare_Col_MidSession),
nameof(Compare_Col_Tier),
nameof(Compare_Count_Filtered_Format),
nameof(Compare_Count_Format),
nameof(Compare_Curves_Header),
nameof(Compare_Empty),
nameof(Compare_Export_Png),
nameof(Compare_Filter_Fg_All),
nameof(Compare_Filter_Fg_With),
nameof(Compare_Filter_Fg_Without),
nameof(Compare_Filter_Game_All),
nameof(Compare_Filter_Tier_All),
nameof(Compare_Filter_Tier_Measured),
nameof(Compare_Filter_Tier_NotMeasured),
nameof(Compare_Header),
nameof(Compare_Legend_Format),
nameof(Compare_Metric_AvgCpuLoad),
@@ -199,6 +217,7 @@ public static class Strings
nameof(Compare_Metric_TimeBelowRefresh),
nameof(Compare_Metric_Vsync),
nameof(Compare_Metric_Window),
nameof(Compare_MidSession_Changed),
nameof(Compare_Mixed_Body),
nameof(Compare_Mixed_Legend),
nameof(Compare_Mixed_Proceed),
@@ -274,9 +293,12 @@ public static class Strings
nameof(Display_Window_Format),
nameof(Display_WindowOnMonitor_Format),
nameof(Display_WindowOnMonitorHz_Format),
nameof(Dlss_Basis_Dynamic),
nameof(Dlss_Basis_Factor_Format),
nameof(Dlss_Basis_Library_Format),
nameof(Dlss_Basis_NeuralRendering_Format),
nameof(Dlss_Feature_FrameGeneration),
nameof(Dlss_Feature_NeuralRendering),
nameof(Dlss_Feature_RayReconstruction),
nameof(Dlss_Feature_SuperResolution),
nameof(Dlss_From_Game),
@@ -289,6 +311,7 @@ public static class Strings
nameof(Dlss_Model_Transformer),
nameof(Dlss_Model_Unknown),
nameof(Dlss_NeuralRendering_Loaded),
nameof(Dlss_NeuralRendering_NotSeen),
nameof(Dlss_Preset_Format),
nameof(Document_OnGitHub),
nameof(Document_Pages),
@@ -427,6 +450,7 @@ public static class Strings
nameof(FgMix_State_Format),
nameof(FgMix_Unclassified),
nameof(FgMix_Unclassified_Note),
nameof(Filter_Clear),
nameof(FirstRun_Accept),
nameof(FirstRun_Agent_Body),
nameof(FirstRun_Agent_Header),
@@ -579,8 +603,18 @@ public static class Strings
nameof(Games_Card_Playtime_Format),
nameof(Games_Card_Sessions_Format),
nameof(Games_Empty),
nameof(Games_Filter_Engine_All),
nameof(Games_Filter_Engine_Unknown),
nameof(Games_Filter_Installed_All),
nameof(Games_Filter_Installed_Yes),
nameof(Games_Filter_Played_All),
nameof(Games_Filter_Played_Yes),
nameof(Games_Filter_State_All),
nameof(Games_Filter_Store_All),
nameof(Games_Filter_Store_Manual),
nameof(Games_Header),
nameof(Games_Header_Count_Format),
nameof(Games_Header_Filtered_Format),
nameof(Games_List_Engine),
nameof(Games_List_LastPlayed),
nameof(Games_List_Name),
@@ -1193,6 +1227,22 @@ public static class Strings
nameof(Viewer_ChangesThisPc_Off),
];
public static string A11y_Compare_Filter_Fg => ResourceManager.GetString(nameof(A11y_Compare_Filter_Fg), Culture) ?? nameof(A11y_Compare_Filter_Fg);
public static string A11y_Compare_Filter_Game => ResourceManager.GetString(nameof(A11y_Compare_Filter_Game), Culture) ?? nameof(A11y_Compare_Filter_Game);
public static string A11y_Compare_Filter_Tier => ResourceManager.GetString(nameof(A11y_Compare_Filter_Tier), Culture) ?? nameof(A11y_Compare_Filter_Tier);
public static string A11y_Games_Filter_Engine => ResourceManager.GetString(nameof(A11y_Games_Filter_Engine), Culture) ?? nameof(A11y_Games_Filter_Engine);
public static string A11y_Games_Filter_Installed => ResourceManager.GetString(nameof(A11y_Games_Filter_Installed), Culture) ?? nameof(A11y_Games_Filter_Installed);
public static string A11y_Games_Filter_Played => ResourceManager.GetString(nameof(A11y_Games_Filter_Played), Culture) ?? nameof(A11y_Games_Filter_Played);
public static string A11y_Games_Filter_State => ResourceManager.GetString(nameof(A11y_Games_Filter_State), Culture) ?? nameof(A11y_Games_Filter_State);
public static string A11y_Games_Filter_Store => ResourceManager.GetString(nameof(A11y_Games_Filter_Store), Culture) ?? nameof(A11y_Games_Filter_Store);
public static string A11y_Games_Sort => ResourceManager.GetString(nameof(A11y_Games_Sort), Culture) ?? nameof(A11y_Games_Sort);
public static string A11y_Logs_Level => ResourceManager.GetString(nameof(A11y_Logs_Level), Culture) ?? nameof(A11y_Logs_Level);
@@ -1457,6 +1507,8 @@ public static class Strings
public static string Common_Yes => ResourceManager.GetString(nameof(Common_Yes), Culture) ?? nameof(Common_Yes);
public static string Compare_ClearSelection => ResourceManager.GetString(nameof(Compare_ClearSelection), Culture) ?? nameof(Compare_ClearSelection);
public static string Compare_Col_Date => ResourceManager.GetString(nameof(Compare_Col_Date), Culture) ?? nameof(Compare_Col_Date);
public static string Compare_Col_Fps => ResourceManager.GetString(nameof(Compare_Col_Fps), Culture) ?? nameof(Compare_Col_Fps);
@@ -1467,12 +1519,30 @@ public static class Strings
public static string Compare_Col_Tier => ResourceManager.GetString(nameof(Compare_Col_Tier), Culture) ?? nameof(Compare_Col_Tier);
public static string Compare_Count_Filtered_Format => ResourceManager.GetString(nameof(Compare_Count_Filtered_Format), Culture) ?? nameof(Compare_Count_Filtered_Format);
public static string Compare_Count_Format => ResourceManager.GetString(nameof(Compare_Count_Format), Culture) ?? nameof(Compare_Count_Format);
public static string Compare_Curves_Header => ResourceManager.GetString(nameof(Compare_Curves_Header), Culture) ?? nameof(Compare_Curves_Header);
public static string Compare_Empty => ResourceManager.GetString(nameof(Compare_Empty), Culture) ?? nameof(Compare_Empty);
public static string Compare_Export_Png => ResourceManager.GetString(nameof(Compare_Export_Png), Culture) ?? nameof(Compare_Export_Png);
public static string Compare_Filter_Fg_All => ResourceManager.GetString(nameof(Compare_Filter_Fg_All), Culture) ?? nameof(Compare_Filter_Fg_All);
public static string Compare_Filter_Fg_With => ResourceManager.GetString(nameof(Compare_Filter_Fg_With), Culture) ?? nameof(Compare_Filter_Fg_With);
public static string Compare_Filter_Fg_Without => ResourceManager.GetString(nameof(Compare_Filter_Fg_Without), Culture) ?? nameof(Compare_Filter_Fg_Without);
public static string Compare_Filter_Game_All => ResourceManager.GetString(nameof(Compare_Filter_Game_All), Culture) ?? nameof(Compare_Filter_Game_All);
public static string Compare_Filter_Tier_All => ResourceManager.GetString(nameof(Compare_Filter_Tier_All), Culture) ?? nameof(Compare_Filter_Tier_All);
public static string Compare_Filter_Tier_Measured => ResourceManager.GetString(nameof(Compare_Filter_Tier_Measured), Culture) ?? nameof(Compare_Filter_Tier_Measured);
public static string Compare_Filter_Tier_NotMeasured => ResourceManager.GetString(nameof(Compare_Filter_Tier_NotMeasured), Culture) ?? nameof(Compare_Filter_Tier_NotMeasured);
public static string Compare_Header => ResourceManager.GetString(nameof(Compare_Header), Culture) ?? nameof(Compare_Header);
public static string Compare_Legend_Format => ResourceManager.GetString(nameof(Compare_Legend_Format), Culture) ?? nameof(Compare_Legend_Format);
@@ -1533,6 +1603,8 @@ public static class Strings
public static string Compare_Metric_Window => ResourceManager.GetString(nameof(Compare_Metric_Window), Culture) ?? nameof(Compare_Metric_Window);
public static string Compare_MidSession_Changed => ResourceManager.GetString(nameof(Compare_MidSession_Changed), Culture) ?? nameof(Compare_MidSession_Changed);
public static string Compare_Mixed_Body => ResourceManager.GetString(nameof(Compare_Mixed_Body), Culture) ?? nameof(Compare_Mixed_Body);
public static string Compare_Mixed_Legend => ResourceManager.GetString(nameof(Compare_Mixed_Legend), Culture) ?? nameof(Compare_Mixed_Legend);
@@ -1683,12 +1755,18 @@ public static class Strings
public static string Display_WindowOnMonitorHz_Format => ResourceManager.GetString(nameof(Display_WindowOnMonitorHz_Format), Culture) ?? nameof(Display_WindowOnMonitorHz_Format);
public static string Dlss_Basis_Dynamic => ResourceManager.GetString(nameof(Dlss_Basis_Dynamic), Culture) ?? nameof(Dlss_Basis_Dynamic);
public static string Dlss_Basis_Factor_Format => ResourceManager.GetString(nameof(Dlss_Basis_Factor_Format), Culture) ?? nameof(Dlss_Basis_Factor_Format);
public static string Dlss_Basis_Library_Format => ResourceManager.GetString(nameof(Dlss_Basis_Library_Format), Culture) ?? nameof(Dlss_Basis_Library_Format);
public static string Dlss_Basis_NeuralRendering_Format => ResourceManager.GetString(nameof(Dlss_Basis_NeuralRendering_Format), Culture) ?? nameof(Dlss_Basis_NeuralRendering_Format);
public static string Dlss_Feature_FrameGeneration => ResourceManager.GetString(nameof(Dlss_Feature_FrameGeneration), Culture) ?? nameof(Dlss_Feature_FrameGeneration);
public static string Dlss_Feature_NeuralRendering => ResourceManager.GetString(nameof(Dlss_Feature_NeuralRendering), Culture) ?? nameof(Dlss_Feature_NeuralRendering);
public static string Dlss_Feature_RayReconstruction => ResourceManager.GetString(nameof(Dlss_Feature_RayReconstruction), Culture) ?? nameof(Dlss_Feature_RayReconstruction);
public static string Dlss_Feature_SuperResolution => ResourceManager.GetString(nameof(Dlss_Feature_SuperResolution), Culture) ?? nameof(Dlss_Feature_SuperResolution);
@@ -1713,6 +1791,8 @@ public static class Strings
public static string Dlss_NeuralRendering_Loaded => ResourceManager.GetString(nameof(Dlss_NeuralRendering_Loaded), Culture) ?? nameof(Dlss_NeuralRendering_Loaded);
public static string Dlss_NeuralRendering_NotSeen => ResourceManager.GetString(nameof(Dlss_NeuralRendering_NotSeen), Culture) ?? nameof(Dlss_NeuralRendering_NotSeen);
public static string Dlss_Preset_Format => ResourceManager.GetString(nameof(Dlss_Preset_Format), Culture) ?? nameof(Dlss_Preset_Format);
public static string Document_OnGitHub => ResourceManager.GetString(nameof(Document_OnGitHub), Culture) ?? nameof(Document_OnGitHub);
@@ -1989,6 +2069,8 @@ public static class Strings
public static string FgMix_Unclassified_Note => ResourceManager.GetString(nameof(FgMix_Unclassified_Note), Culture) ?? nameof(FgMix_Unclassified_Note);
public static string Filter_Clear => ResourceManager.GetString(nameof(Filter_Clear), Culture) ?? nameof(Filter_Clear);
public static string FirstRun_Accept => ResourceManager.GetString(nameof(FirstRun_Accept), Culture) ?? nameof(FirstRun_Accept);
public static string FirstRun_Agent_Body => ResourceManager.GetString(nameof(FirstRun_Agent_Body), Culture) ?? nameof(FirstRun_Agent_Body);
@@ -2293,10 +2375,30 @@ public static class Strings
public static string Games_Empty => ResourceManager.GetString(nameof(Games_Empty), Culture) ?? nameof(Games_Empty);
public static string Games_Filter_Engine_All => ResourceManager.GetString(nameof(Games_Filter_Engine_All), Culture) ?? nameof(Games_Filter_Engine_All);
public static string Games_Filter_Engine_Unknown => ResourceManager.GetString(nameof(Games_Filter_Engine_Unknown), Culture) ?? nameof(Games_Filter_Engine_Unknown);
public static string Games_Filter_Installed_All => ResourceManager.GetString(nameof(Games_Filter_Installed_All), Culture) ?? nameof(Games_Filter_Installed_All);
public static string Games_Filter_Installed_Yes => ResourceManager.GetString(nameof(Games_Filter_Installed_Yes), Culture) ?? nameof(Games_Filter_Installed_Yes);
public static string Games_Filter_Played_All => ResourceManager.GetString(nameof(Games_Filter_Played_All), Culture) ?? nameof(Games_Filter_Played_All);
public static string Games_Filter_Played_Yes => ResourceManager.GetString(nameof(Games_Filter_Played_Yes), Culture) ?? nameof(Games_Filter_Played_Yes);
public static string Games_Filter_State_All => ResourceManager.GetString(nameof(Games_Filter_State_All), Culture) ?? nameof(Games_Filter_State_All);
public static string Games_Filter_Store_All => ResourceManager.GetString(nameof(Games_Filter_Store_All), Culture) ?? nameof(Games_Filter_Store_All);
public static string Games_Filter_Store_Manual => ResourceManager.GetString(nameof(Games_Filter_Store_Manual), Culture) ?? nameof(Games_Filter_Store_Manual);
public static string Games_Header => ResourceManager.GetString(nameof(Games_Header), Culture) ?? nameof(Games_Header);
public static string Games_Header_Count_Format => ResourceManager.GetString(nameof(Games_Header_Count_Format), Culture) ?? nameof(Games_Header_Count_Format);
public static string Games_Header_Filtered_Format => ResourceManager.GetString(nameof(Games_Header_Filtered_Format), Culture) ?? nameof(Games_Header_Filtered_Format);
public static string Games_List_Engine => ResourceManager.GetString(nameof(Games_List_Engine), Culture) ?? nameof(Games_List_Engine);
public static string Games_List_LastPlayed => ResourceManager.GetString(nameof(Games_List_LastPlayed), Culture) ?? nameof(Games_List_LastPlayed);
+136
View File
@@ -1121,6 +1121,50 @@
<value>並べ替え</value>
<comment>review</comment>
</data>
<data name="Games_Filter_Store_All" xml:space="preserve">
<value>すべてのストア</value>
<comment>review</comment>
</data>
<data name="Games_Filter_Store_Manual" xml:space="preserve">
<value>手動で追加</value>
<comment>review</comment>
</data>
<data name="Games_Filter_Engine_All" xml:space="preserve">
<value>すべてのエンジン</value>
<comment>review</comment>
</data>
<data name="Games_Filter_Engine_Unknown" xml:space="preserve">
<value>エンジン不明</value>
<comment>review</comment>
</data>
<data name="Games_Filter_State_All" xml:space="preserve">
<value>すべての状態</value>
<comment>review</comment>
</data>
<data name="Games_Filter_Installed_All" xml:space="preserve">
<value>インストール済みかを問わない</value>
<comment>review</comment>
</data>
<data name="Games_Filter_Installed_Yes" xml:space="preserve">
<value>インストール済み</value>
<comment>review</comment>
</data>
<data name="Games_Filter_Played_All" xml:space="preserve">
<value>プレイ済みかを問わない</value>
<comment>review</comment>
</data>
<data name="Games_Filter_Played_Yes" xml:space="preserve">
<value>セッションあり</value>
<comment>review</comment>
</data>
<data name="Games_Header_Filtered_Format" xml:space="preserve">
<value>ゲーム · {0} / {1}</value>
<comment>review</comment>
</data>
<data name="Filter_Clear" xml:space="preserve">
<value>フィルターを解除</value>
<comment>review</comment>
</data>
<data name="Games_Sort_LastPlayed" xml:space="preserve">
<value>最後にプレイ</value>
<comment>review</comment>
@@ -1609,6 +1653,50 @@
<value>{0} 件選択</value>
<comment>review</comment>
</data>
<data name="Compare_Filter_Game_All" xml:space="preserve">
<value>すべてのゲーム</value>
<comment>review</comment>
</data>
<data name="Compare_Filter_Tier_All" xml:space="preserve">
<value>すべての Tier</value>
<comment>review</comment>
</data>
<data name="Compare_Filter_Tier_Measured" xml:space="preserve">
<value>計測あり (Tier 1)</value>
<comment>review</comment>
</data>
<data name="Compare_Filter_Tier_NotMeasured" xml:space="preserve">
<value>計測なし (Tier 2)</value>
<comment>review</comment>
</data>
<data name="Compare_Filter_Fg_All" xml:space="preserve">
<value>フレーム生成の有無を問わない</value>
<comment>review</comment>
</data>
<data name="Compare_Filter_Fg_With" xml:space="preserve">
<value>フレーム生成あり</value>
<comment>review</comment>
</data>
<data name="Compare_Filter_Fg_Without" xml:space="preserve">
<value>フレーム生成なし</value>
<comment>review</comment>
</data>
<data name="Compare_Count_Format" xml:space="preserve">
<value>{0} 件のセッション</value>
<comment>review</comment>
</data>
<data name="Compare_Count_Filtered_Format" xml:space="preserve">
<value>{1} 件中 {0} 件のセッション</value>
<comment>review</comment>
</data>
<data name="Compare_ClearSelection" xml:space="preserve">
<value>選択を解除</value>
<comment>review</comment>
</data>
<data name="Compare_MidSession_Changed" xml:space="preserve">
<value>セッション中に変更</value>
<comment>review</comment>
</data>
<data name="Compare_Table_Header" xml:space="preserve">
<value>統計</value>
<comment>review</comment>
@@ -2588,6 +2676,38 @@
<value>ゲームの並べ替え</value>
<comment>review</comment>
</data>
<data name="A11y_Games_Filter_Store" xml:space="preserve">
<value>ストアでゲームを絞り込む</value>
<comment>review</comment>
</data>
<data name="A11y_Games_Filter_Engine" xml:space="preserve">
<value>エンジンでゲームを絞り込む</value>
<comment>review</comment>
</data>
<data name="A11y_Games_Filter_State" xml:space="preserve">
<value>状態でゲームを絞り込む</value>
<comment>review</comment>
</data>
<data name="A11y_Games_Filter_Installed" xml:space="preserve">
<value>インストール状態でゲームを絞り込む</value>
<comment>review</comment>
</data>
<data name="A11y_Games_Filter_Played" xml:space="preserve">
<value>セッションでゲームを絞り込む</value>
<comment>review</comment>
</data>
<data name="A11y_Compare_Filter_Game" xml:space="preserve">
<value>ゲームでセッションを絞り込む</value>
<comment>review</comment>
</data>
<data name="A11y_Compare_Filter_Tier" xml:space="preserve">
<value>Tier でセッションを絞り込む</value>
<comment>review</comment>
</data>
<data name="A11y_Compare_Filter_Fg" xml:space="preserve">
<value>フレーム生成でセッションを絞り込む</value>
<comment>review</comment>
</data>
<data name="A11y_Logs_Source" xml:space="preserve">
<value>ログのソース</value>
<comment>review</comment>
@@ -4569,6 +4689,10 @@
<value>ライブラリ {0}</value>
<comment>review</comment>
</data>
<data name="Dlss_Basis_Dynamic" xml:space="preserve">
<value>NVIDIA App で設定した Dynamic マルチフレーム生成</value>
<comment>review</comment>
</data>
<data name="Dlss_Feature_SuperResolution" xml:space="preserve">
<value>Super Resolution</value>
<comment>review</comment>
@@ -4621,6 +4745,18 @@
<value>DLSS 5 ランタイムを読み込み済み</value>
<comment>review</comment>
</data>
<data name="Dlss_NeuralRendering_NotSeen" xml:space="preserve">
<value>DLSS 5 ランタイムを読み込み済み、実行は確認されず</value>
<comment>review</comment>
</data>
<data name="Dlss_Feature_NeuralRendering" xml:space="preserve">
<value>Neural Rendering</value>
<comment>review</comment>
</data>
<data name="Dlss_Basis_NeuralRendering_Format" xml:space="preserve">
<value>描画フレームの {0} でニューラルレンダリング</value>
<comment>review</comment>
</data>
<data name="Fsr_Mode_NativeAa" xml:space="preserve">
<value>ネイティブ AA</value>
<comment>review</comment>
+102
View File
@@ -846,6 +846,39 @@
<data name="Games_Sort_Label" xml:space="preserve">
<value>Sort by</value>
</data>
<data name="Games_Filter_Store_All" xml:space="preserve">
<value>All stores</value>
</data>
<data name="Games_Filter_Store_Manual" xml:space="preserve">
<value>Added by hand</value>
</data>
<data name="Games_Filter_Engine_All" xml:space="preserve">
<value>All engines</value>
</data>
<data name="Games_Filter_Engine_Unknown" xml:space="preserve">
<value>Engine not identified</value>
</data>
<data name="Games_Filter_State_All" xml:space="preserve">
<value>Any state</value>
</data>
<data name="Games_Filter_Installed_All" xml:space="preserve">
<value>Installed or not</value>
</data>
<data name="Games_Filter_Installed_Yes" xml:space="preserve">
<value>Installed</value>
</data>
<data name="Games_Filter_Played_All" xml:space="preserve">
<value>Played or not</value>
</data>
<data name="Games_Filter_Played_Yes" xml:space="preserve">
<value>With sessions</value>
</data>
<data name="Games_Header_Filtered_Format" xml:space="preserve">
<value>Games · {0} of {1}</value>
</data>
<data name="Filter_Clear" xml:space="preserve">
<value>Clear filters</value>
</data>
<data name="Games_Sort_LastPlayed" xml:space="preserve">
<value>Last played</value>
</data>
@@ -1212,6 +1245,39 @@
<data name="Compare_Selected_Format" xml:space="preserve">
<value>{0} selected</value>
</data>
<data name="Compare_Filter_Game_All" xml:space="preserve">
<value>All games</value>
</data>
<data name="Compare_Filter_Tier_All" xml:space="preserve">
<value>Any tier</value>
</data>
<data name="Compare_Filter_Tier_Measured" xml:space="preserve">
<value>Measured (Tier 1)</value>
</data>
<data name="Compare_Filter_Tier_NotMeasured" xml:space="preserve">
<value>Not measured (Tier 2)</value>
</data>
<data name="Compare_Filter_Fg_All" xml:space="preserve">
<value>With or without frame generation</value>
</data>
<data name="Compare_Filter_Fg_With" xml:space="preserve">
<value>With frame generation</value>
</data>
<data name="Compare_Filter_Fg_Without" xml:space="preserve">
<value>Without frame generation</value>
</data>
<data name="Compare_Count_Format" xml:space="preserve">
<value>{0} sessions</value>
</data>
<data name="Compare_Count_Filtered_Format" xml:space="preserve">
<value>{0} of {1} sessions</value>
</data>
<data name="Compare_ClearSelection" xml:space="preserve">
<value>Clear selection</value>
</data>
<data name="Compare_MidSession_Changed" xml:space="preserve">
<value>Changed mid-session</value>
</data>
<data name="Compare_Table_Header" xml:space="preserve">
<value>Statistics</value>
</data>
@@ -1947,6 +2013,30 @@
<data name="A11y_Games_Sort" xml:space="preserve">
<value>Sort games</value>
</data>
<data name="A11y_Games_Filter_Store" xml:space="preserve">
<value>Filter games by store</value>
</data>
<data name="A11y_Games_Filter_Engine" xml:space="preserve">
<value>Filter games by engine</value>
</data>
<data name="A11y_Games_Filter_State" xml:space="preserve">
<value>Filter games by state</value>
</data>
<data name="A11y_Games_Filter_Installed" xml:space="preserve">
<value>Filter games by installed</value>
</data>
<data name="A11y_Games_Filter_Played" xml:space="preserve">
<value>Filter games by sessions</value>
</data>
<data name="A11y_Compare_Filter_Game" xml:space="preserve">
<value>Filter sessions by game</value>
</data>
<data name="A11y_Compare_Filter_Tier" xml:space="preserve">
<value>Filter sessions by tier</value>
</data>
<data name="A11y_Compare_Filter_Fg" xml:space="preserve">
<value>Filter sessions by frame generation</value>
</data>
<data name="A11y_Logs_Source" xml:space="preserve">
<value>Log source</value>
</data>
@@ -3437,6 +3527,9 @@ The documents below are the full terms; this summary does not replace them.</val
<data name="Dlss_Basis_Library_Format" xml:space="preserve">
<value>library {0}</value>
</data>
<data name="Dlss_Basis_Dynamic" xml:space="preserve">
<value>Dynamic multi frame generation, set in the NVIDIA App</value>
</data>
<data name="Dlss_Feature_SuperResolution" xml:space="preserve">
<value>Super Resolution</value>
</data>
@@ -3476,6 +3569,15 @@ The documents below are the full terms; this summary does not replace them.</val
<data name="Dlss_NeuralRendering_Loaded" xml:space="preserve">
<value>DLSS 5 runtime loaded</value>
</data>
<data name="Dlss_NeuralRendering_NotSeen" xml:space="preserve">
<value>DLSS 5 runtime loaded, not seen running</value>
</data>
<data name="Dlss_Feature_NeuralRendering" xml:space="preserve">
<value>Neural Rendering</value>
</data>
<data name="Dlss_Basis_NeuralRendering_Format" xml:space="preserve">
<value>neural rendering on {0} of rendered frames</value>
</data>
<data name="Fsr_Mode_NativeAa" xml:space="preserve">
<value>Native AA</value>
</data>
+102
View File
@@ -841,6 +841,39 @@
<data name="Games_Sort_Label" xml:space="preserve">
<value>Sắp xếp theo</value>
</data>
<data name="Games_Filter_Store_All" xml:space="preserve">
<value>Mọi cửa hàng</value>
</data>
<data name="Games_Filter_Store_Manual" xml:space="preserve">
<value>Thêm thủ công</value>
</data>
<data name="Games_Filter_Engine_All" xml:space="preserve">
<value>Mọi engine</value>
</data>
<data name="Games_Filter_Engine_Unknown" xml:space="preserve">
<value>Chưa nhận diện engine</value>
</data>
<data name="Games_Filter_State_All" xml:space="preserve">
<value>Mọi trạng thái</value>
</data>
<data name="Games_Filter_Installed_All" xml:space="preserve">
<value>Đã cài hoặc chưa</value>
</data>
<data name="Games_Filter_Installed_Yes" xml:space="preserve">
<value>Đã cài</value>
</data>
<data name="Games_Filter_Played_All" xml:space="preserve">
<value>Đã chơi hoặc chưa</value>
</data>
<data name="Games_Filter_Played_Yes" xml:space="preserve">
<value>Có phiên</value>
</data>
<data name="Games_Header_Filtered_Format" xml:space="preserve">
<value>Game · {0} / {1}</value>
</data>
<data name="Filter_Clear" xml:space="preserve">
<value>Bỏ lọc</value>
</data>
<data name="Games_Sort_LastPlayed" xml:space="preserve">
<value>Chơi gần nhất</value>
</data>
@@ -1207,6 +1240,39 @@
<data name="Compare_Selected_Format" xml:space="preserve">
<value>Đã chọn {0}</value>
</data>
<data name="Compare_Filter_Game_All" xml:space="preserve">
<value>Mọi game</value>
</data>
<data name="Compare_Filter_Tier_All" xml:space="preserve">
<value>Mọi tier</value>
</data>
<data name="Compare_Filter_Tier_Measured" xml:space="preserve">
<value>Có đo (Tier 1)</value>
</data>
<data name="Compare_Filter_Tier_NotMeasured" xml:space="preserve">
<value>Không đo (Tier 2)</value>
</data>
<data name="Compare_Filter_Fg_All" xml:space="preserve">
<value>Có hoặc không tạo khung hình</value>
</data>
<data name="Compare_Filter_Fg_With" xml:space="preserve">
<value>Có tạo khung hình</value>
</data>
<data name="Compare_Filter_Fg_Without" xml:space="preserve">
<value>Không tạo khung hình</value>
</data>
<data name="Compare_Count_Format" xml:space="preserve">
<value>{0} phiên</value>
</data>
<data name="Compare_Count_Filtered_Format" xml:space="preserve">
<value>{0} / {1} phiên</value>
</data>
<data name="Compare_ClearSelection" xml:space="preserve">
<value>Bỏ chọn</value>
</data>
<data name="Compare_MidSession_Changed" xml:space="preserve">
<value>Đổi giữa phiên</value>
</data>
<data name="Compare_Table_Header" xml:space="preserve">
<value>Thống kê</value>
</data>
@@ -1942,6 +2008,30 @@
<data name="A11y_Games_Sort" xml:space="preserve">
<value>Sắp xếp game</value>
</data>
<data name="A11y_Games_Filter_Store" xml:space="preserve">
<value>Lọc game theo cửa hàng</value>
</data>
<data name="A11y_Games_Filter_Engine" xml:space="preserve">
<value>Lọc game theo engine</value>
</data>
<data name="A11y_Games_Filter_State" xml:space="preserve">
<value>Lọc game theo trạng thái</value>
</data>
<data name="A11y_Games_Filter_Installed" xml:space="preserve">
<value>Lọc game theo tình trạng cài đặt</value>
</data>
<data name="A11y_Games_Filter_Played" xml:space="preserve">
<value>Lọc game theo phiên</value>
</data>
<data name="A11y_Compare_Filter_Game" xml:space="preserve">
<value>Lọc phiên theo game</value>
</data>
<data name="A11y_Compare_Filter_Tier" xml:space="preserve">
<value>Lọc phiên theo tier</value>
</data>
<data name="A11y_Compare_Filter_Fg" xml:space="preserve">
<value>Lọc phiên theo tạo khung hình</value>
</data>
<data name="A11y_Logs_Source" xml:space="preserve">
<value>Nguồn log</value>
</data>
@@ -3432,6 +3522,9 @@ Các văn bản bên dưới là điều khoản đầy đủ; bản tóm tắt
<data name="Dlss_Basis_Library_Format" xml:space="preserve">
<value>thư viện {0}</value>
</data>
<data name="Dlss_Basis_Dynamic" xml:space="preserve">
<value>tạo nhiều khung hình Dynamic, đặt trong NVIDIA App</value>
</data>
<data name="Dlss_Feature_SuperResolution" xml:space="preserve">
<value>Super Resolution</value>
</data>
@@ -3471,6 +3564,15 @@ Các văn bản bên dưới là điều khoản đầy đủ; bản tóm tắt
<data name="Dlss_NeuralRendering_Loaded" xml:space="preserve">
<value>đã nạp runtime DLSS 5</value>
</data>
<data name="Dlss_NeuralRendering_NotSeen" xml:space="preserve">
<value>đã nạp runtime DLSS 5, không thấy chạy</value>
</data>
<data name="Dlss_Feature_NeuralRendering" xml:space="preserve">
<value>Neural Rendering</value>
</data>
<data name="Dlss_Basis_NeuralRendering_Format" xml:space="preserve">
<value>neural rendering trên {0} khung hình đã kết xuất</value>
</data>
<data name="Fsr_Mode_NativeAa" xml:space="preserve">
<value>Native AA</value>
</data>
+114
View File
@@ -11,6 +11,11 @@
Our styles, merged LAST (16_WPFUI_SYNTAX §App bootstrap). Colours only through theme brushes with
DynamicResource; the chart palette (16 §Theming) arrives with the charts (P3 PR-6) as its own dictionary.
-->
<ResourceDictionary.MergedDictionaries>
<!-- beta.34: the pane item's sizes (FlLeftFluentNavigationViewItemTemplate, below), as WPF UI's own template reads them. -->
<ResourceDictionary Source="pack://application:,,,/Wpf.Ui;component/Controls/NavigationView/NavigationViewConstants.xaml" />
</ResourceDictionary.MergedDictionaries>
<BooleanToVisibilityConverter x:Key="BoolToVis" />
<converters:InverseBoolToVisibilityConverter x:Key="InverseBoolToVis" />
<converters:NullToCollapsedConverter x:Key="NullToCollapsed" />
@@ -329,4 +334,113 @@
</Setter.Value>
</Setter>
</Style>
<!--
The navigation pane's item, beta.34 (owner request 2026-11-06, D86): WPF UI 4.3.0's LeftFluentNavigationViewItemTemplate
(lepoco/wpfui, MIT - src/Wpf.Ui/Controls/NavigationView/NavigationLeftFluent.xaml at tag 4.3.0), copied with ONE
change: its IsActive trigger animated the label's ContentGrid to height 0 and opacity 0, so the selected page lost its
name - the owner's screenshot of Compare, and every other page the same while it was selected. The selected item keeps
the accent bar, the selected background, the accent icon and the border animation. Set as RootNavigation.ItemTemplate
(MainWindow.xaml): a local value outranks the default style's PaneDisplayMode=LeftFluent trigger.
-->
<ControlTemplate x:Key="FlLeftFluentNavigationViewItemTemplate" TargetType="{x:Type ui:NavigationViewItem}">
<Border x:Name="MainBorder"
MinWidth="{StaticResource PaneFluentButtonWidth}"
Height="{StaticResource PaneFluentButtonHeight}"
Padding="4"
HorizontalAlignment="Stretch"
Background="Transparent"
BorderBrush="{TemplateBinding BorderBrush}"
BorderThickness="1"
CornerRadius="4">
<Grid>
<Rectangle x:Name="ActiveRectangle"
Width="3"
Height="24"
Margin="-4,0,0,0"
HorizontalAlignment="Left"
VerticalAlignment="Center"
Fill="{DynamicResource NavigationViewSelectionIndicatorForeground}"
Opacity="0.0"
RadiusX="2"
RadiusY="2" />
<Grid HorizontalAlignment="Stretch" VerticalAlignment="Stretch">
<Grid.RowDefinitions>
<RowDefinition Height="*" />
<RowDefinition Height="Auto" />
</Grid.RowDefinitions>
<ContentPresenter x:Name="IconContentPresenter"
Grid.Row="0"
Margin="0"
Content="{TemplateBinding Icon}"
TextElement.FontSize="{StaticResource NavigationViewFluentIconSize}"
TextElement.Foreground="{DynamicResource NavigationViewItemForegroundLeftFluent}" />
<Grid x:Name="ContentGrid"
Grid.Row="1"
Height="{StaticResource NavigationViewFluentIconSize}"
Margin="0,2,0,0">
<ContentPresenter x:Name="ElementContentPresenter"
HorizontalAlignment="Center"
Content="{TemplateBinding Content}"
ContentTemplate="{TemplateBinding ContentTemplate}"
RecognizesAccessKey="True"
TextElement.FontSize="{TemplateBinding FontSize}"
TextElement.Foreground="{DynamicResource NavigationViewItemForegroundLeftFluent}" />
</Grid>
<ContentPresenter x:Name="PART_InfoBadge"
Grid.Row="0"
Margin="0"
HorizontalAlignment="Right"
VerticalAlignment="Top"
Content="{TemplateBinding InfoBadge}" />
</Grid>
</Grid>
</Border>
<ControlTemplate.Triggers>
<Trigger Property="IsActive" Value="True">
<Setter TargetName="ActiveRectangle" Property="Opacity" Value="1.0" />
<Setter TargetName="MainBorder" Property="Background" Value="{DynamicResource NavigationViewItemBackgroundSelectedLeftFluent}" />
<Setter TargetName="IconContentPresenter" Property="TextElement.Foreground" Value="{DynamicResource NavigationViewSelectionIndicatorForeground}" />
<Setter TargetName="ElementContentPresenter" Property="Margin" Value="0" />
<Trigger.EnterActions>
<BeginStoryboard>
<Storyboard>
<DoubleAnimation Storyboard.TargetName="MainBorder"
Storyboard.TargetProperty="(Border.BorderBrush).(SolidColorBrush.Opacity)"
From="0" To="1" Duration="0:0:.16" />
</Storyboard>
</BeginStoryboard>
</Trigger.EnterActions>
<Trigger.ExitActions>
<BeginStoryboard>
<Storyboard>
<DoubleAnimation Storyboard.TargetName="MainBorder"
Storyboard.TargetProperty="(Border.BorderBrush).(SolidColorBrush.Opacity)"
From="1" To="0" Duration="0:0:.16" />
</Storyboard>
</BeginStoryboard>
</Trigger.ExitActions>
</Trigger>
<Trigger Property="Icon" Value="{x:Null}">
<Setter TargetName="IconContentPresenter" Property="Visibility" Value="Collapsed" />
</Trigger>
<Trigger Property="InfoBadge" Value="{x:Null}">
<Setter TargetName="PART_InfoBadge" Property="Margin" Value="0" />
<Setter TargetName="PART_InfoBadge" Property="Visibility" Value="Collapsed" />
</Trigger>
<Trigger Property="IsMouseOver" Value="True">
<Setter TargetName="MainBorder" Property="Background" Value="{DynamicResource NavigationViewItemBackgroundSelectedLeftFluent}" />
</Trigger>
<MultiTrigger>
<MultiTrigger.Conditions>
<Condition Property="IsMouseOver" Value="True" />
<Condition Property="IsActive" Value="False" />
</MultiTrigger.Conditions>
<MultiTrigger.Setters>
<Setter TargetName="IconContentPresenter" Property="TextElement.Foreground" Value="{DynamicResource NavigationViewItemForegroundPointerOverLeftFluent}" />
<Setter TargetName="ContentGrid" Property="TextElement.Foreground" Value="{DynamicResource NavigationViewItemForegroundPointerOverLeftFluent}" />
</MultiTrigger.Setters>
</MultiTrigger>
</ControlTemplate.Triggers>
</ControlTemplate>
</ResourceDictionary>
@@ -18,18 +18,38 @@ public sealed partial class CompareCandidateViewModel : ObservableObject
ArgumentNullException.ThrowIfNull(recent);
Row = recent.Row;
Id = recent.Row.Id;
GameId = recent.Row.GameId;
StartedAt = recent.Row.StartedAt;
GameName = recent.GameName;
DateText = Formats.Date(recent.Row.StartedAt);
IsHooked = recent.Row.Tier == CaptureTier.Hooked;
TierText = IsHooked ? Strings.Tier_Hooked : Strings.Tier_NotHooked;
ReadoutLine = FpsPresentation.FromRow(recent.Row).Line;
SettingsChangedMidSession = recent.Row.SettingsChangedMidSession;
SettingsChangedText = SettingsChangedMidSession ? Strings.Compare_MidSession_Changed : "—";
HasFrameGeneration = recent.Row.FgMode switch
{
"none" => false,
"na" or null => null,
_ => true,
};
}
public Application.Persistence.SessionRow Row { get; }
public long Id { get; }
public long GameId { get; }
/// <summary>The date column sorts by this, not by its text (beta.34).</summary>
public DateTimeOffset StartedAt { get; }
/// <summary>beta.34 (D85): frame generation in the session — true, false (measured none), or null (not measured: Tier 2).</summary>
public bool? HasFrameGeneration { get; }
/// <summary>The Settings-changed cell's words beside its icon, or a dash — the column was blank for every unchanged session.</summary>
public string SettingsChangedText { get; }
public string GameName { get; }
public string DateText { get; }
@@ -0,0 +1,12 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.App.ViewModels;
/// <summary>Compare's tier filter (beta.34, D85): every session, the measured (Tier 1), or those recorded without measurement.</summary>
public enum CompareTierFilter
{
All = 0,
Measured,
NotMeasured,
}
@@ -51,6 +51,21 @@ public sealed partial class CompareViewModel : ObservableObject
[ObservableProperty]
private string? _tierLegend;
/// <summary>beta.34 (D85): one game's sessions, or 0 for every game's.</summary>
[ObservableProperty]
private long _gameFilter;
[ObservableProperty]
private CompareTierFilter _tierFilter;
[ObservableProperty]
private YesNoFilter _frameGenerationFilter;
[ObservableProperty]
private string _countText = string.Empty;
private List<CompareCandidateViewModel> _pool = [];
public CompareViewModel(GameLibrary library, SessionSeriesLoader loader, IMixedTierPrompt mixed, IFileSaver saver, IMessageStrip strip)
{
_library = library ?? throw new ArgumentNullException(nameof(library));
@@ -77,6 +92,27 @@ public sealed partial class CompareViewModel : ObservableObject
public static string MetricHeader => Strings.Compare_Table_Metric;
public static string ClearFiltersText => Strings.Filter_Clear;
public static string ClearSelectionText => Strings.Compare_ClearSelection;
/// <summary>beta.34 (D85): the games the sessions are of, "All games" first.</summary>
public ObservableCollection<Choice<long>> Games { get; } = [];
public IReadOnlyList<Choice<CompareTierFilter>> Tiers { get; } =
[
new(CompareTierFilter.All, Strings.Compare_Filter_Tier_All),
new(CompareTierFilter.Measured, Strings.Compare_Filter_Tier_Measured),
new(CompareTierFilter.NotMeasured, Strings.Compare_Filter_Tier_NotMeasured),
];
public IReadOnlyList<Choice<YesNoFilter>> FrameGenerationChoices { get; } =
[
new(YesNoFilter.All, Strings.Compare_Filter_Fg_All),
new(YesNoFilter.Yes, Strings.Compare_Filter_Fg_With),
new(YesNoFilter.No, Strings.Compare_Filter_Fg_Without),
];
public ObservableCollection<CompareCandidateViewModel> Candidates { get; } = [];
public ObservableCollection<CompareCandidateViewModel> Compared { get; } = [];
@@ -93,26 +129,97 @@ public sealed partial class CompareViewModel : ObservableObject
/// <summary>Raised when <see cref="Curves"/> and <see cref="Rows"/> were rebuilt, so the page redraws.</summary>
public event EventHandler? Compared2;
/// <summary>
/// Every session, newest first (beta.34: it was the newest 200), read on the thread pool — Microsoft.Data.Sqlite completes
/// its asynchronous calls synchronously, and the page waited for it — and then filtered (D85).
/// </summary>
public async Task LoadAsync(CancellationToken ct = default)
{
IReadOnlyList<RecentSession> recent = await _library.RecentAsync(200, ct).ConfigureAwait(true);
foreach (CompareCandidateViewModel old in Candidates)
GameLibrary library = _library;
IReadOnlyList<RecentSession> recent = await Task.Run(() => library.RecentAsync(int.MaxValue, ct), ct).ConfigureAwait(true);
foreach (CompareCandidateViewModel old in _pool)
{
old.PropertyChanged -= OnCandidateChanged;
}
Candidates.Clear();
var pool = new List<CompareCandidateViewModel>(recent.Count);
foreach (RecentSession r in recent)
{
var candidate = new CompareCandidateViewModel(r);
candidate.PropertyChanged += OnCandidateChanged;
Candidates.Add(candidate);
pool.Add(candidate);
}
IsEmpty = Candidates.Count == 0;
_pool = pool;
Choice<long>[] games =
[
new(0, Strings.Compare_Filter_Game_All),
.. pool.GroupBy(static c => c.GameId).Select(static g => new Choice<long>(g.Key, g.First().GameName))
.OrderBy(static c => c.Label, StringComparer.CurrentCultureIgnoreCase),
];
Games.Clear();
foreach (Choice<long> game in games)
{
Games.Add(game);
}
if (!Games.Any(g => g.Value == GameFilter))
{
GameFilter = 0;
}
IsEmpty = _pool.Count == 0;
ApplyFilters();
Recount();
}
partial void OnGameFilterChanged(long value) => ApplyFilters();
partial void OnTierFilterChanged(CompareTierFilter value) => ApplyFilters();
partial void OnFrameGenerationFilterChanged(YesNoFilter value) => ApplyFilters();
[RelayCommand]
private void ClearFilters()
{
GameFilter = 0;
TierFilter = CompareTierFilter.All;
FrameGenerationFilter = YesNoFilter.All;
}
[RelayCommand]
private void ClearSelection()
{
foreach (CompareCandidateViewModel c in _pool.Where(static c => c.IsSelected))
{
c.IsSelected = false;
}
}
/// <summary>
/// The list the filters leave (beta.34, D85), newest first — and every ticked session whatever they say: a pick is never
/// hidden from the one who made it, so what Compare runs on is always on screen.
/// </summary>
private void ApplyFilters()
{
CompareCandidateViewModel[] shown = [.. _pool.Where(c => c.IsSelected || Passes(c))];
Candidates.Clear();
foreach (CompareCandidateViewModel c in shown)
{
Candidates.Add(c);
}
bool filtered = GameFilter != 0 || TierFilter != CompareTierFilter.All || FrameGenerationFilter != YesNoFilter.All;
CountText = filtered
? string.Format(CultureInfo.CurrentCulture, Strings.Compare_Count_Filtered_Format, shown.Length, _pool.Count)
: string.Format(CultureInfo.CurrentCulture, Strings.Compare_Count_Format, _pool.Count);
}
private bool Passes(CompareCandidateViewModel c) =>
(GameFilter == 0 || c.GameId == GameFilter)
&& TierFilter switch { CompareTierFilter.Measured => c.IsHooked, CompareTierFilter.NotMeasured => !c.IsHooked, _ => true }
&& FrameGenerationFilter switch { YesNoFilter.Yes => c.HasFrameGeneration is true, YesNoFilter.No => c.HasFrameGeneration is false, _ => true };
[RelayCommand]
private Task CompareAsync() => Run(CompareCoreAsync);
@@ -141,7 +248,7 @@ public sealed partial class CompareViewModel : ObservableObject
private async Task CompareCoreAsync()
{
CompareCandidateViewModel[] picked = [.. Candidates.Where(static c => c.IsSelected)];
CompareCandidateViewModel[] picked = [.. _pool.Where(static c => c.IsSelected)];
if (picked.Length < MinSessions || picked.Length > MaxSessions)
{
return;
@@ -284,7 +391,7 @@ public sealed partial class CompareViewModel : ObservableObject
private void Recount()
{
SelectedCount = Candidates.Count(static c => c.IsSelected);
SelectedCount = _pool.Count(static c => c.IsSelected);
CanCompare = SelectedCount is >= MinSessions and <= MaxSessions;
OnPropertyChanged(nameof(SelectedText));
}
@@ -3,6 +3,7 @@
using System.Diagnostics.CodeAnalysis;
using System.Globalization;
using CommunityToolkit.Mvvm.ComponentModel;
using FrameLedger.App.Services;
namespace FrameLedger.App.ViewModels;
@@ -12,19 +13,32 @@ namespace FrameLedger.App.ViewModels;
/// playtime, last played, hooking state — or, since 2026-09-23, "Not recorded" in its place for an entry whose recording is
/// off, and since 2026-09-25 "Anti-cheat" for one the guard found anti-cheat in; since beta.11 "Not installed" beside it
/// when its executable is not on disk (<see cref="GameLibrary.ExecutableExists"/>, read when the library is listed, never
/// stored), with the game page's own words for why (<see cref="Formats.ExecutableMissingText"/>).
/// stored), with the game page's own words for why (<see cref="Formats.ExecutableMissingText"/>). Since beta.34 a card is
/// shown before its executable is checked and gets the pill when the check answers (<see cref="SetInstalled"/>): a drive
/// that sleeps took a second to say, and no card appeared until every one had.
/// </summary>
[SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format strings are resources that follow the UI culture, which changes at runtime")]
public sealed class GameCardViewModel
public sealed partial class GameCardViewModel : ObservableObject
{
/// <summary>beta.11: the "Not installed" pill shows — the file, or the drive it was on, is not there now.</summary>
[ObservableProperty]
[NotifyPropertyChangedFor(nameof(StatusText))]
private bool _notInstalled;
/// <summary>What the pill means here — the drive that is not connected, or the path the file is gone from; null when installed.</summary>
[ObservableProperty]
private string? _notInstalledToolTip;
public GameCardViewModel(GameCard card, bool installed = true)
{
ArgumentNullException.ThrowIfNull(card);
Card = card;
NotInstalled = !installed;
NotInstalledToolTip = installed ? null : Formats.ExecutableMissingText(card.Row.Fingerprint.ExePath);
_notInstalled = !installed;
_notInstalledToolTip = installed ? null : Formats.ExecutableMissingText(card.Row.Fingerprint.ExePath);
Id = card.Row.Id;
Name = card.Row.Name;
PlatformToken = card.Row.Platform;
EngineToken = card.Row.Engine;
PlatformText = Formats.Platform(card.Row.Platform);
EngineText = Formats.Engine(card.Row.Engine, card.Row.EngineVersionSource);
Recorded = card.Row.RecordSessions;
@@ -59,6 +73,18 @@ public sealed class GameCardViewModel
public string PlatformText { get; }
/// <summary>The store's token (<c>steam</c>, <c>gog</c>, <c>epic</c>, <c>itch</c>, <c>xbox</c>; <c>none</c> for a game added by hand) — the store filter's key.</summary>
public string PlatformToken { get; }
/// <summary>The detected engine's id, or null — the engine filter's key.</summary>
public string? EngineToken { get; }
/// <summary>The card's one state, as its pill says it (beta.34, D85).</summary>
public GamesStateFilter State => !Recorded ? GamesStateFilter.NotRecorded
: Excepted ? GamesStateFilter.Exception
: AntiCheat ? GamesStateFilter.AntiCheat
: HookOn ? GamesStateFilter.HookingOn : GamesStateFilter.HookingOff;
public bool HasPlatform => PlatformText.Length > 0;
public string EngineText { get; }
@@ -99,12 +125,33 @@ public sealed class GameCardViewModel
/// <summary>The list view's last-played cell: the date alone, or "not played yet".</summary>
public string LastPlayedValue { get; }
/// <summary>beta.11: the "Not installed" pill shows — the file, or the drive it was on, is not there now.</summary>
public bool NotInstalled { get; }
/// <summary>What the pill means here — the drive that is not connected, or the path the file is gone from; null when installed.</summary>
public string? NotInstalledToolTip { get; }
/// <summary>The list view's status cell: what the hook pill says, and "Not installed" after it when that is so.</summary>
public string StatusText => NotInstalled ? HookText + " · " + Strings.Games_Card_NotInstalled : HookText;
/// <summary>The executable check's answer, when it comes (beta.34) — with the reason, read off the UI thread with it.</summary>
public void SetInstalled(bool installed, string? whyNot)
{
NotInstalled = !installed;
NotInstalledToolTip = installed ? null : whyNot;
}
/// <summary>
/// Whether <paramref name="other"/> — the same game read again — would look the same on its card and in its row, and
/// play the same executable (beta.34): a reload keeps the card it already has, and rebuilds only one that changed.
/// </summary>
public bool LooksLike(GameCardViewModel other)
{
ArgumentNullException.ThrowIfNull(other);
return Id == other.Id
&& string.Equals(Name, other.Name, StringComparison.Ordinal)
&& string.Equals(PlatformText, other.PlatformText, StringComparison.Ordinal)
&& string.Equals(EngineText, other.EngineText, StringComparison.Ordinal)
&& string.Equals(HookText, other.HookText, StringComparison.Ordinal)
&& string.Equals(SessionsText, other.SessionsText, StringComparison.Ordinal)
&& string.Equals(PlaytimeText, other.PlaytimeText, StringComparison.Ordinal)
&& string.Equals(LastPlayedText, other.LastPlayedText, StringComparison.Ordinal)
&& string.Equals(Card.Row.Fingerprint.ExePath, other.Card.Row.Fingerprint.ExePath, StringComparison.OrdinalIgnoreCase)
&& string.Equals(Card.Row.Platform, other.Card.Row.Platform, StringComparison.Ordinal)
&& string.Equals(Card.Row.StoreId, other.Card.Row.StoreId, StringComparison.Ordinal);
}
}
@@ -1453,6 +1453,7 @@ public sealed partial class GameDetailViewModel : ObservableObject
"dlss" => "DLSS",
"dlssg" or "dlss_g" => "DLSS-G",
"dlssd" or "dlss_rr" => "DLSS Ray Reconstruction",
"dlss_nr" => "DLSS 5 Neural Rendering",
"streamline" => "Streamline",
"vulkan" => "Vulkan",
"fsr" => "FSR",
@@ -0,0 +1,15 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.App.ViewModels;
/// <summary>The library's state filter (beta.34, D85): the card's one state, as its pill says it.</summary>
public enum GamesStateFilter
{
All = 0,
HookingOn,
HookingOff,
AntiCheat,
Exception,
NotRecorded,
}
+254 -17
View File
@@ -17,7 +17,10 @@ namespace FrameLedger.App.ViewModels;
/// open by click. Since beta.11 (owner requests 2026-10-03): shown as a grid of cards that fills the width or as a list
/// (<c>ui.library_view</c>), with the count in the header; <b>Refresh</b> reloads the library, looks in the stores for games
/// installed since and offers only those, and marks entries whose executable is gone ("Not installed"); and the page
/// reloads by itself when a session ends or an import adds games while it is on screen.
/// reloads by itself when a session ends or an import adds games while it is on screen. Since beta.34 (owner request
/// 2026-11-06, "Games stalls 0.5–1.5 s"; <c>spike-notes</c> §27) the page is kept by its window (<see cref="WindowPageCache"/>)
/// and reads the library again each time it is shown; the library is read on the thread pool, the cards appear before
/// the executables are checked, and a read keeps every card that would look the same.
/// </summary>
[System.Diagnostics.CodeAnalysis.SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format strings are resources that follow the UI culture, which changes at runtime")]
public sealed partial class GamesViewModel : ObservableObject
@@ -25,6 +28,12 @@ public sealed partial class GamesViewModel : ObservableObject
private const string _listValue = "list";
private const string _gridValue = "grid";
/// <summary>The store and engine filters' "everything" (beta.34, D85); no store or engine token is empty.</summary>
public const string AnyToken = "";
/// <summary>The engine filter's "not identified".</summary>
public const string UnknownEngineToken = "?";
/// <summary>How many removed games one notice names; the rest are counted (<c>Games_Removed_More_Format</c>).</summary>
private const int _removedNamed = 5;
@@ -43,10 +52,11 @@ public sealed partial class GamesViewModel : ObservableObject
private readonly Func<string, bool> _exists;
private readonly UiThread _ui = new();
private readonly List<string> _removed = [];
private IReadOnlyList<GameCardViewModel> _all = [];
private List<GameCardViewModel> _all = [];
private int _reads;
private bool _viewRead;
private bool _attached;
private bool _shownBefore;
[ObservableProperty]
private string _search = string.Empty;
@@ -67,6 +77,27 @@ public sealed partial class GamesViewModel : ObservableObject
[ObservableProperty]
private bool _listView;
/// <summary>beta.34 (D85): the store filter — a store token, or <see cref="AnyToken"/>.</summary>
[ObservableProperty]
private string _storeFilter = AnyToken;
/// <summary>beta.34 (D85): the engine filter — an engine id, <see cref="UnknownEngineToken"/>, or <see cref="AnyToken"/>.</summary>
[ObservableProperty]
private string _engineFilter = AnyToken;
[ObservableProperty]
private GamesStateFilter _stateFilter;
[ObservableProperty]
private YesNoFilter _installedFilter;
[ObservableProperty]
private YesNoFilter _playedFilter;
/// <summary>A filter or the search narrows the list; the header then counts what is shown of all.</summary>
[ObservableProperty]
private bool _isFiltered;
/// <summary>What Play will do, in the mode Settings ▸ Games has now (beta.21, D59).</summary>
[ObservableProperty]
private string _playToolTip = Strings.Play_ToolTip_Store;
@@ -128,6 +159,39 @@ public sealed partial class GamesViewModel : ObservableObject
public ObservableCollection<GameCardViewModel> Games { get; } = [];
/// <summary>beta.34 (D85): the stores the library holds, "All stores" first — rebuilt when the library changes them.</summary>
public ObservableCollection<Choice<string>> Stores { get; } = [];
/// <summary>beta.34 (D85): the engines the library holds, "All engines" first, "Engine not identified" last when any is.</summary>
public ObservableCollection<Choice<string>> Engines { get; } = [];
/// <summary>The states, labelled in the language the page opened in, as the pills say them.</summary>
public IReadOnlyList<Choice<GamesStateFilter>> States { get; } =
[
new(GamesStateFilter.All, Strings.Games_Filter_State_All),
new(GamesStateFilter.HookingOn, Strings.Games_Card_HookOn),
new(GamesStateFilter.HookingOff, Strings.Games_Card_HookOff),
new(GamesStateFilter.AntiCheat, Strings.Games_Card_AntiCheat),
new(GamesStateFilter.Exception, Strings.Games_Card_Exception),
new(GamesStateFilter.NotRecorded, Strings.Games_Card_NotRecorded),
];
public IReadOnlyList<Choice<YesNoFilter>> InstalledChoices { get; } =
[
new(YesNoFilter.All, Strings.Games_Filter_Installed_All),
new(YesNoFilter.Yes, Strings.Games_Filter_Installed_Yes),
new(YesNoFilter.No, Strings.Games_Card_NotInstalled),
];
public IReadOnlyList<Choice<YesNoFilter>> PlayedChoices { get; } =
[
new(YesNoFilter.All, Strings.Games_Filter_Played_All),
new(YesNoFilter.Yes, Strings.Games_Filter_Played_Yes),
new(YesNoFilter.No, Strings.Games_Card_NeverPlayed),
];
public static string ClearFiltersText => Strings.Filter_Clear;
/// <summary>The load in flight, for a test to await.</summary>
public Task Pending { get; private set; }
@@ -145,20 +209,73 @@ public sealed partial class GamesViewModel : ObservableObject
PlayToolTip = await _player.IsDirectAsync(ct).ConfigureAwait(true) ? Strings.Play_ToolTip_Direct : Strings.Play_ToolTip_Store;
}
IReadOnlyList<GameCard> cards = await _library.ListCardsAsync(ct).ConfigureAwait(true);
// Whether each executable is on disk is a file-system question per entry — a drive that is gone can take a moment
// to say so — so it is asked off the UI thread, the game page's own way (GameLibrary.ExecutableExists).
Func<string, bool> exists = _exists;
bool[] installed = await Task.Run(() => cards.Select(c => exists(c.Row.Fingerprint.ExePath)).ToArray(), ct)
.ConfigureAwait(true);
// beta.34: the library on the thread pool — Microsoft.Data.Sqlite completes its asynchronous calls synchronously,
// so on the UI thread the read was the page's to wait for.
GameLibrary library = _library;
IReadOnlyList<GameCard> cards = await Task.Run(() => library.ListCardsAsync(ct), ct).ConfigureAwait(true);
if (read != Volatile.Read(ref _reads))
{
return;
}
_all = [.. cards.Select((c, i) => new GameCardViewModel(c, installed[i]))];
HeaderText = string.Format(CultureInfo.CurrentCulture, Strings.Games_Header_Count_Format, _all.Count);
// The cards first — each as the card it was, where it would look the same — and only then whether each executable
// is on disk: a file-system question per entry that a sleeping drive answers in a second or more (39 of the owner's
// 41 Steam games are on a USB drive), and no card was shown until every one had answered (spike-notes §27).
_all = Merge(_all, cards);
RefreshChoices();
Apply();
Func<string, bool> exists = _exists;
(bool Installed, string? WhyNot)[] checks = await Task.Run(() => cards.Select(c =>
{
string path = c.Row.Fingerprint.ExePath;
bool installed = exists(path);
return (installed, installed ? null : Formats.ExecutableMissingText(path));
}).ToArray(), ct).ConfigureAwait(true);
if (read != Volatile.Read(ref _reads))
{
return;
}
var byId = _all.ToDictionary(static c => c.Id);
for (int i = 0; i < cards.Count; i++)
{
if (byId.TryGetValue(cards[i].Row.Id, out GameCardViewModel? card))
{
card.SetInstalled(checks[i].Installed, checks[i].WhyNot);
}
}
Apply();
PlayCommand.NotifyCanExecuteChanged();
}
/// <summary>
/// The library read again, as cards: an entry that would look the same keeps the card it has — its place on screen and
/// its installed state until the check answers again — and only an entry that changed, or is new, gets a new one.
/// </summary>
private static List<GameCardViewModel> Merge(IReadOnlyList<GameCardViewModel> shown, IReadOnlyList<GameCard> cards)
{
var old = shown.ToDictionary(static c => c.Id);
var merged = new List<GameCardViewModel>(cards.Count);
foreach (GameCard card in cards)
{
var fresh = new GameCardViewModel(card);
if (old.TryGetValue(card.Row.Id, out GameCardViewModel? kept))
{
if (kept.LooksLike(fresh))
{
merged.Add(kept);
continue;
}
fresh.SetInstalled(!kept.NotInstalled, kept.NotInstalledToolTip);
}
merged.Add(fresh);
}
return merged;
}
/// <summary>
@@ -184,6 +301,16 @@ public sealed partial class GamesViewModel : ObservableObject
}
_attached = true;
// beta.34: the page is kept by its window and shown again on a later visit (WindowPageCache), so what happened while
// it was away — a session that ended, a game removed, renamed or added on another page — is read now, behind the
// cards already on screen. Its first Loaded follows the constructor's own read.
if (_shownBefore)
{
Pending = LoadAsync();
}
_shownBefore = true;
}
public void Detach()
@@ -281,6 +408,82 @@ public sealed partial class GamesViewModel : ObservableObject
partial void OnSortChanged(GamesSort value) => Apply();
partial void OnStoreFilterChanged(string value) => Apply();
partial void OnEngineFilterChanged(string value) => Apply();
partial void OnStateFilterChanged(GamesStateFilter value) => Apply();
partial void OnInstalledFilterChanged(YesNoFilter value) => Apply();
partial void OnPlayedFilterChanged(YesNoFilter value) => Apply();
/// <summary>beta.34 (D85): every filter back to everything; the search stays (it has its own box).</summary>
[RelayCommand]
private void ClearFilters()
{
StoreFilter = AnyToken;
EngineFilter = AnyToken;
StateFilter = GamesStateFilter.All;
InstalledFilter = YesNoFilter.All;
PlayedFilter = YesNoFilter.All;
}
/// <summary>
/// The store and engine choices from what the library holds — rebuilt only when that set changes, so an open list does not
/// lose its selection on every read. A filter whose store or engine left the library goes back to everything.
/// </summary>
private void RefreshChoices()
{
Choice<string>[] stores =
[
new(AnyToken, Strings.Games_Filter_Store_All),
.. _all.Select(static c => c.PlatformToken).Distinct(StringComparer.Ordinal)
.Select(static t => new Choice<string>(t, Formats.Platform(t) is { Length: > 0 } name ? name : Strings.Games_Filter_Store_Manual))
.OrderBy(static c => c.Label, StringComparer.CurrentCultureIgnoreCase),
];
Choice<string>[] engines =
[
new(AnyToken, Strings.Games_Filter_Engine_All),
.. _all.Select(static c => c.EngineToken).OfType<string>().Distinct(StringComparer.Ordinal)
.Select(static t => new Choice<string>(t, Formats.Engine(t) is { Length: > 0 } name ? name : t))
.OrderBy(static c => c.Label, StringComparer.CurrentCultureIgnoreCase),
.. _all.Any(static c => c.EngineToken is null) ? new[] { new Choice<string>(UnknownEngineToken, Strings.Games_Filter_Engine_Unknown) } : Array.Empty<Choice<string>>(),
];
Replace(Stores, stores);
Replace(Engines, engines);
if (!Stores.Any(c => string.Equals(c.Value, StoreFilter, StringComparison.Ordinal)))
{
StoreFilter = AnyToken;
}
if (!Engines.Any(c => string.Equals(c.Value, EngineFilter, StringComparison.Ordinal)))
{
EngineFilter = AnyToken;
}
}
private static void Replace(ObservableCollection<Choice<string>> target, Choice<string>[] wanted)
{
if (target.SequenceEqual(wanted))
{
return;
}
target.Clear();
foreach (Choice<string> choice in wanted)
{
target.Add(choice);
}
}
private bool Passes(GameCardViewModel c) =>
(StoreFilter.Length == 0 || string.Equals(c.PlatformToken, StoreFilter, StringComparison.Ordinal))
&& (EngineFilter.Length == 0 || string.Equals(c.EngineToken ?? UnknownEngineToken, EngineFilter, StringComparison.Ordinal))
&& (StateFilter == GamesStateFilter.All || c.State == StateFilter)
&& InstalledFilter switch { YesNoFilter.Yes => !c.NotInstalled, YesNoFilter.No => c.NotInstalled, _ => true }
&& PlayedFilter switch { YesNoFilter.Yes => c.SessionCount > 0, YesNoFilter.No => c.SessionCount == 0, _ => true };
partial void OnListViewChanged(bool value)
{
if (_viewRead && _settings is not null)
@@ -354,7 +557,7 @@ public sealed partial class GamesViewModel : ObservableObject
private void Apply()
{
IEnumerable<GameCardViewModel> shown = _all;
IEnumerable<GameCardViewModel> shown = _all.Where(Passes);
string q = Search.Trim();
if (q.Length > 0)
{
@@ -368,13 +571,47 @@ public sealed partial class GamesViewModel : ObservableObject
_ => shown.OrderBy(static c => c.Name, StringComparer.CurrentCultureIgnoreCase),
};
Games.Clear();
foreach (GameCardViewModel card in shown)
{
Games.Add(card);
}
Sync(Games, [.. shown]);
IsEmpty = _all.Count == 0;
NoMatch = _all.Count > 0 && Games.Count == 0;
IsFiltered = q.Length > 0 || StoreFilter.Length > 0 || EngineFilter.Length > 0 || StateFilter != GamesStateFilter.All
|| InstalledFilter != YesNoFilter.All || PlayedFilter != YesNoFilter.All;
HeaderText = IsFiltered
? string.Format(CultureInfo.CurrentCulture, Strings.Games_Header_Filtered_Format, Games.Count, _all.Count)
: string.Format(CultureInfo.CurrentCulture, Strings.Games_Header_Count_Format, _all.Count);
}
/// <summary>
/// Makes <paramref name="target"/> list <paramref name="wanted"/>, in its order, by removing, moving and inserting —
/// never clearing (beta.34): a card that stays is the element already on screen, and the panel builds only the new.
/// </summary>
internal static void Sync(ObservableCollection<GameCardViewModel> target, IReadOnlyList<GameCardViewModel> wanted)
{
var keep = new HashSet<GameCardViewModel>(wanted);
for (int i = target.Count - 1; i >= 0; i--)
{
if (!keep.Contains(target[i]))
{
target.RemoveAt(i);
}
}
for (int i = 0; i < wanted.Count; i++)
{
if (i < target.Count && ReferenceEquals(target[i], wanted[i]))
{
continue;
}
int at = target.IndexOf(wanted[i]);
if (at >= 0)
{
target.Move(at, i);
}
else
{
target.Insert(i, wanted[i]);
}
}
}
}
@@ -0,0 +1,12 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.App.ViewModels;
/// <summary>A two-way filter's three choices (beta.34, D85): everything, only the ones that are, only the ones that are not.</summary>
public enum YesNoFilter
{
All = 0,
Yes,
No,
}
@@ -41,11 +41,13 @@ public static class CensusNames
/// <summary>
/// Modules the snapshot records though the in-process census has no bit for them (beta.24, D64): DLSS's Ray
/// Reconstruction and DLSS 5's runtime, Streamline's other plugins, and AMD's FidelityFX loader. The name of DLSS 5's
/// runtime, <c>nvngx_dlssnr.dll</c>, is from community sources until owner-only item 20(d) sees it load.
/// Reconstruction and DLSS 5's runtime, Streamline's other plugins, and AMD's FidelityFX loader. DLSS 5's runtime,
/// <c>nvngx_dlssnr.dll</c>, was a community-sourced name until 2026-11-06, when the owner's Hogwarts Legacy loaded it
/// (310.9.16.0, from the game's folder, Neural Rendering on — <c>spike-notes</c> §26); its Streamline plugin,
/// <c>sl.dlss_nr.dll</c>, ships beside it and is recorded since beta.34.
/// </summary>
private static readonly string[] _snapshotOnly =
["sl.dlss_d.dll", "sl.common.dll", "sl.reflex.dll", "amd_fidelityfx_loader_dx12.dll", "nvngx_dlssnr.dll"];
["sl.dlss_d.dll", "sl.common.dll", "sl.reflex.dll", "amd_fidelityfx_loader_dx12.dll", "nvngx_dlssnr.dll", "sl.dlss_nr.dll"];
/// <summary>
/// Every module FILE name a snapshot answers for — the census's, the <c>a / b</c> pairs above split into their
@@ -53,6 +53,12 @@ public static class NvidiaDriverSettings
/// <summary><c>NGX_DLSSG_MODE</c>: 0 not set (the default), 1 off, 2 on, 3 auto, 4 dynamic.</summary>
public const uint DlssgMode = 0x10308298;
/// <summary>
/// <see cref="DlssgMode"/>'s <c>NGX_DLSSG_MODE_DYNAMIC</c> — the NVIDIA App's <i>Dynamic</i> frame generation, which
/// exists only in DLSS 4.5 (beta.34, D83).
/// </summary>
public const uint DlssgModeDynamic = 4;
/// <summary><c>NGX_DLSSG_DYNAMIC_MULTI_FRAME_COUNT_MAX</c>: 0 off, else the dynamic mode's ceiling.</summary>
public const uint DlssgDynamicMultiFrameCountMax = 0x10562D0F;
@@ -153,6 +153,13 @@ public sealed record SessionRow
/// </summary>
public string? RuntimeModuleSourcesJson { get; init; }
/// <summary>
/// <c>dlss_nr_pct</c> (schema 0022, beta.34, D84): on how many of the frames the game rendered through Streamline DLSS 5's
/// neural rendering was evaluated, 0–100 (<c>Domain.Metrics.NeuralRendering</c>). Null where nothing could tell — an
/// Overlay that does not decode it, a title that never routed through Streamline — and on every session before.
/// </summary>
public double? DlssNrPct { get; init; }
public double? PresentedFps { get; init; }
public string? PresentedQualifier { get; init; }
@@ -219,6 +219,10 @@ public static class SessionAggregator
RtTier = c.Input.Writer.RtTier == (uint)RtTierValue.NotQueried ? null : c.Input.Writer.RtTier,
HooksInstalledMask = c.Input.Writer.HooksInstalledMask,
RasterPsoCount = hooks.HasFlag(FlHookFamily.Pso) ? c.Input.Writer.RasterPsoCreated : null,
// beta.34 (D84): DLSS 5's neural rendering, only from a writer whose Streamline detour decodes it — an older
// Overlay drains the same batches and never sets the bit, and its silence must not be stored as 0 %.
DlssNrPct = hooks.HasFlag(FlHookFamily.SlNeuralRendering) ? NeuralRendering.SharePct(c.Dominant) : null,
};
}
@@ -55,6 +55,13 @@ internal sealed record SlCensus
/// <summary>Batches that carried a feature id the Overlay does not decode.</summary>
public required int WithUndecoded { get; init; }
/// <summary>
/// Batches that carried DLSS 5's <c>kFeatureDLSS_NR</c> (beta.34, D84). Until that build the id fell to
/// <see cref="WithUndecoded"/>, so the two buckets are read together across builds: a writer older than beta.34
/// counted DLSS 5 as undecoded.
/// </summary>
public required int WithNeuralRendering { get; init; }
/// <summary>
/// <b><see cref="WithFrameGeneration"/> IS NOT AN ID OBSERVATION, and must never be quoted
/// as one beside <c>fgEvaluations</c>.</b>
@@ -64,7 +71,7 @@ internal sealed record SlCensus
/// It is <c>fgEvaluations &gt; 0</c> restated — the same byte read twice — because
/// <c>FL_SL_SEEN_RETIRED_DLSS_G</c> was retired deliberately so frame generation travels
/// only as the count (<c>dllmain.cpp</c> §FlSlSeen), and <see cref="FlFeatureFlags"/> has
/// no free fact bit left to carry a raw one. So "the census says zero" and "every record
/// no free fact bit left to carry a raw one (since beta.34 its last one is DLSS 5's). So "the census says zero" and "every record
/// says zero" are ONE measurement with one provenance, and a ledger entry citing them as
/// two corroborating lines would be manufacturing agreement out of a single fact.
/// </para>
@@ -101,10 +108,11 @@ internal sealed record SlCensus
private const int _idxFg = 3;
private const int _idxUndecoded = 4;
private const int _idxFgOnly = 5;
private const int _idxNeural = 6;
private static SlCensus Tally(IReadOnlyList<FlFrameRecord> stream, int start)
{
int[] n = new int[6];
int[] n = new int[7];
int batches = 0;
for (int i = start; i < stream.Count; i++)
{
@@ -129,6 +137,7 @@ internal sealed record SlCensus
n[_idxNis] += superResolution && upscaler == FlUpscaler.Nis ? 1 : 0;
n[_idxRr] += flags.HasFlag(FlFeatureFlags.RayReconstruction) ? 1 : 0;
n[_idxUndecoded] += flags.HasFlag(FlFeatureFlags.SlUndecoded) ? 1 : 0;
n[_idxNeural] += flags.HasFlag(FlFeatureFlags.SlNeuralRendering) ? 1 : 0;
n[_idxFg] += r.FgEvaluations > 0 ? 1 : 0;
n[_idxFgOnly] += r.FgEvaluations > 0 && !superResolution ? 1 : 0;
}
@@ -142,6 +151,7 @@ internal sealed record SlCensus
WithRayReconstruction = n[_idxRr],
WithFrameGeneration = n[_idxFg],
WithUndecoded = n[_idxUndecoded],
WithNeuralRendering = n[_idxNeural],
FgWithoutSuperResolution = n[_idxFgOnly],
};
}
@@ -155,6 +165,7 @@ internal sealed record SlCensus
WithRayReconstruction = 0,
WithFrameGeneration = 0,
WithUndecoded = 0,
WithNeuralRendering = 0,
FgWithoutSuperResolution = 0,
};
@@ -172,6 +183,7 @@ internal sealed record SlCensus
sb.Append(" kFeatureDLSS=").Append(N(WithDlss))
.Append(" kFeatureNIS=").Append(N(WithNis))
.Append(" kFeatureDLSS_RR=").Append(N(WithRayReconstruction))
.Append(" kFeatureDLSS_NR=").Append(N(WithNeuralRendering))
.Append(" UNDECODED=").AppendLine(N(WithUndecoded));
// NOT ON THE ID LINE. Every other column there is a distinct bit decoded from the
@@ -17,4 +17,10 @@ public enum DlssBasis
/// <summary>A loaded library's major version.</summary>
LibraryVersion = 3,
/// <summary>The NVIDIA App's Dynamic frame generation, which the driver reported applied (beta.34, D83).</summary>
DynamicFrameGeneration = 4,
/// <summary>DLSS 5's neural rendering, seen evaluated on some of the session's frames (beta.34, D84).</summary>
NeuralRendering = 5,
}
@@ -3,9 +3,19 @@
namespace FrameLedger.Domain.Detection;
/// <summary>What a session observed about DLSS, for <see cref="DlssGeneration.Of"/> (beta.24, D64).</summary>
/// <summary>What a session observed about DLSS, for <see cref="DlssGeneration.Of"/> (beta.24, D64; beta.34, D83).</summary>
/// <param name="SuperResolution">The loaded <c>nvngx_dlss.dll</c>'s file version.</param>
/// <param name="FrameGeneration">The loaded <c>nvngx_dlssg.dll</c>'s file version.</param>
/// <param name="Preset">The super-resolution render preset the NVIDIA driver reports applied in a session where it ran (1 = A …).</param>
/// <param name="LargestFrameGenerationFactor">The largest DLSS Frame Generation state the session measured.</param>
public sealed record DlssEvidence(Version? SuperResolution, Version? FrameGeneration, uint? Preset, double? LargestFrameGenerationFactor);
/// <param name="DynamicFrameGeneration">
/// The NVIDIA App's <i>Dynamic</i> frame generation ran in the session (beta.34, D83): the game's driver profile sets the
/// Dynamic mode, the driver reports its frame-generation override applied in the game's process, and DLSS Frame Generation
/// was counted. Dynamic exists only in DLSS 4.5, whatever multiplier it settled on.
/// </param>
/// <param name="NeuralRenderingPct">
/// On how many of the frames the game rendered through Streamline DLSS 5's neural rendering was evaluated, 0–100
/// (<c>sessions.dlss_nr_pct</c>, beta.34, D84); null where nothing could tell.
/// </param>
public sealed record DlssEvidence(Version? SuperResolution, Version? FrameGeneration, uint? Preset, double? LargestFrameGenerationFactor,
bool DynamicFrameGeneration = false, double? NeuralRenderingPct = null);
@@ -18,8 +18,20 @@ namespace FrameLedger.Domain.Detection;
/// model it runs is the preset's to say. Never a default preset inferred from a version.
/// </para>
/// <para>
/// DLSS 5's neural rendering is not a generation of these features and is not in this table: a session states only that
/// its runtime was loaded.
/// <b>The NVIDIA App's Dynamic frame generation is DLSS 4.5's</b> (beta.34, owner decision D83): Dynamic and the ×6 mode
/// exist only in DLSS 4.5, so a session the driver reports running Dynamic is DLSS 4.5 even where the multiplier it chose
/// stayed at ×3 — the owner's Phantom Blade Zero under "up to ×3" held ×2.0 and ×3.0 and read "DLSS 4" until then. It
/// ranks below the ×5 state (a measured multiplier is stronger evidence than a setting the driver confirms) and above
/// every DLSS 4 row. A Fixed multiplier the App sets is not this row: Witcher 3 under Fixed ×6 still presented ×2.0, so a
/// Fixed ×5 or ×6 names DLSS 4.5 only where the frames show it.
/// </para>
/// <para>
/// Until beta.34 this read "DLSS 5's neural rendering is not a generation of these features and is not in this table: a
/// session states only that its runtime was loaded". <b>Since beta.34 (owner decision D84) DLSS 5 heads the table where its
/// neural rendering was measured running</b> — the game evaluated <c>kFeatureDLSS_NR</c> on some of its frames — because DLSS 5 is named for that
/// feature as DLSS 4.5 is for its second-generation model and Dynamic frame generation: the session's other DLSS
/// features are the libraries the line lists after it. A runtime that was only loaded still names nothing (Hogwarts Legacy
/// loads it; whether it ran is the evaluation's to say).
/// </para>
/// </remarks>
/// <param name="Kind">The generation established.</param>
@@ -30,6 +42,11 @@ public sealed record DlssGeneration(DlssGenerationKind Kind, DlssBasis Basis)
public static DlssGeneration? Of(DlssEvidence evidence)
{
ArgumentNullException.ThrowIfNull(evidence);
if (evidence.NeuralRenderingPct is > 0)
{
return new DlssGeneration(DlssGenerationKind.Dlss5, DlssBasis.NeuralRendering);
}
if (evidence.Preset is 12 or 13)
{
return new DlssGeneration(DlssGenerationKind.Dlss45, DlssBasis.Preset);
@@ -40,6 +57,11 @@ public sealed record DlssGeneration(DlssGenerationKind Kind, DlssBasis Basis)
return new DlssGeneration(DlssGenerationKind.Dlss45, DlssBasis.FrameGenerationFactor);
}
if (evidence.DynamicFrameGeneration)
{
return new DlssGeneration(DlssGenerationKind.Dlss45, DlssBasis.DynamicFrameGeneration);
}
if (evidence.Preset is 10 or 11)
{
return new DlssGeneration(DlssGenerationKind.Dlss4, DlssBasis.Preset);
@@ -14,4 +14,7 @@ public enum DlssGenerationKind
/// <summary>DLSS 4.5.</summary>
Dlss45 = 45,
/// <summary>DLSS 5 — its neural rendering measured running (beta.34, D84).</summary>
Dlss5 = 5,
}
@@ -27,4 +27,10 @@ public enum FeatureBits
RayReconstructionObserved = 1 << 4,
ReflexObserved = 1 << 5,
SlUndecodedObserved = 1 << 6,
/// <summary>
/// DLSS 5's neural rendering was evaluated (beta.34, D84) — a fact whose OBSERVED is <see cref="RayReconstructionObserved"/>,
/// read only from a writer that published <see cref="HookFamilies.SlNeuralRendering"/>.
/// </summary>
SlNeuralRendering = 1 << 7,
}
@@ -26,4 +26,7 @@ public enum HookFamilies
/// <summary>The FidelityFX quality query (beta.25, D65).</summary>
UpscalerQuality = 1 << 11,
/// <summary>The Streamline detour decodes DLSS 5's neural rendering (beta.34, D84).</summary>
SlNeuralRendering = 1 << 12,
}
@@ -0,0 +1,42 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.Domain.Metrics;
/// <summary>
/// DLSS 5's neural rendering in a session (beta.34, owner decision D84; <c>05_DETECTION</c> §DLSS generation): on how many
/// of the frames the game rendered through Streamline it evaluated <c>kFeatureDLSS_NR</c>.
/// </summary>
/// <remarks>
/// Counted over the presents that drained a Streamline evaluation (<see cref="FeatureBits.RayReconstructionObserved"/>, the
/// one condition every Streamline fact of the byte is published under) — about one per application frame, so a session
/// under frame generation is not diluted by its generated presents. A stream with no such present gives no share at all:
/// the title never routed through Streamline while the hook was in, and its silence says nothing about DLSS 5. Whether the
/// writer could have seen neural rendering is the caller's to ask first (<see cref="HookFamilies.SlNeuralRendering"/>): an
/// Overlay older than beta.34 drains the same batches and never sets the bit.
/// </remarks>
public static class NeuralRendering
{
/// <summary>The percentage (0–100) of the stream's Streamline batches that carried a neural-rendering evaluation, or null.</summary>
public static double? SharePct(IReadOnlyList<FrameSample> stream)
{
ArgumentNullException.ThrowIfNull(stream);
int batches = 0;
int neural = 0;
foreach (FrameSample s in stream)
{
if (!s.Features.HasFlag(FeatureBits.RayReconstructionObserved))
{
continue;
}
batches++;
if (s.Features.HasFlag(FeatureBits.SlNeuralRendering))
{
neural++;
}
}
return batches == 0 ? null : 100.0 * neural / batches;
}
}
@@ -67,6 +67,13 @@ public sealed class XboxArtCache : IStoreArtCache
return null; // a name that escapes the package is not the package's picture
}
if (Path.GetFileName(full).Contains(':', StringComparison.Ordinal))
{
// A file's stream (name:stream) is no picture a package ships, and the scale search below would throw on one
// named like a drive ("a:b.png" makes the pattern "a:b.scale-*.png", which EnumerateFiles refuses; beta.34).
return null;
}
var plain = new FileInfo(full);
if (plain.Exists && plain.Length > 0)
{
@@ -0,0 +1,10 @@
-- 0022 (2026-11-06, beta.34, owner decision D84): DLSS 5's neural rendering, measured.
--
-- The share (0-100) of the frames a game rendered through Streamline on which it evaluated DLSS 5's neural rendering
-- (kFeatureDLSS_NR, Streamline 2.14), from the Overlay's per-frame fact (FL_FEAT_SL_NEURAL_RENDERING) over the presents that
-- drained a Streamline evaluation (Domain.Metrics.NeuralRendering). NULL where nothing could tell: an Overlay older than
-- this script decodes no neural rendering (its writer state lacks FL_HOOK_SL_NEURAL_RENDERING), and a title that never went
-- through Streamline drains no batch. Written by the Agent only (06_DATA_MODEL section Writer ownership); ADD COLUMN only.
-- A session written before has none and is never rebuilt: frame_blobs keep no feature byte.
ALTER TABLE sessions ADD COLUMN dlss_nr_pct REAL;
@@ -19,10 +19,10 @@ namespace FrameLedger.Infrastructure.Persistence;
internal static class SessionRowColumns
{
public const string Insert =
"INSERT INTO sessions (session_guid, game_id, snapshot_id, started_at, ended_at, duration_s, qpc_epoch, qpc_frequency, capture_tier, capture_mode, capture_notes, ac_exception_family, late_attach, telemetry_source, overlay_build_id, exit_status, drain_ticks, foreground_ticks, records_before_attach, dxgi_presents_before_hook, gap_count, guard_ticks_published, launch_wait_ms, api, present_mode, swap_effect, hdr_flag, hdr_source, sync_interval_mode, upscaler, upscaler_quality, upscaler_sharpness, upscaler_driver_reported, render_w, render_h, output_w, output_h, upscale_ratio, settings_changed_midsession, fg_mode, fg_source, fg_factor, fg_driver_reported, fg_runtime_census, fg_none_withheld_reason, fg_refusal, fg_refusal_detail, fg_factor_scope, fg_steady_share, presented_fps, presented_qualifier, dxgi_unseen_total, dxgi_present_samples, displayed_counted_by, sl_tag_census, sl_interposer_version, runtime_modules, driver_profile, executable_markers, ngx_driver_words, rt_flag, rt_source, pt_flag, pt_source, pt_confidence, rr_flag, rr_source, rt_frame_pct, rays_per_pixel, rt_pso_count, rt_tier, hooks_installed_mask, raster_pso_count, frame_count, app_frame_count, displayed_frame_count, dropped_frames, native_fps, displayed_fps, median_fps, p1_low_fps, p01_low_fps, displayed_p1_low_fps, min_fps, max_fps, frametime_stddev_ms, stutter_count, stutter_time_pct, pso_stutter_pct, reflex_active, latency_avg_us, latency_p95_us, dropped_records, fault_count, data_quality_warnings, writer_status_at_end, early_stop_family, loader_signals, vram_proc_avg_mb, vram_proc_max_mb, vram_budget_exceeded_pct, vram_adapter_max_mb, avg_cpu_temp, max_cpu_temp, avg_gpu_temp, max_gpu_temp, max_gpu_hotspot, avg_gpu_load, avg_cpu_load, avg_ram_mb, avg_gpu_power_w, throttle_pct, display_exclusive_ms, display_borderless_ms, display_windowed_ms, display_covers_ms, display_minimized_ms, display_nowindow_ms, display_changes, display_source, display_window_w, display_window_h, display_buffer_w, display_buffer_h, display_monitor_w, display_monitor_h, display_monitor_hz, game_vram_dedicated_avg_mb, game_vram_dedicated_median_mb, game_vram_dedicated_max_mb, game_vram_shared_max_mb, game_ram_private_avg_mb, game_ram_private_median_mb, game_ram_private_max_mb, game_ram_ws_max_mb, game_commit_max_mb, game_memory_processes, game_memory_source, sensor_stats_json, time_below_30_pct, time_below_60_pct, time_below_refresh_pct, frametime_delta_mean_ms, vsync_present_pct, tearing_allowed_pct, avg_gpu_core_clock_mhz, avg_gpu_mem_clock_mhz, avg_gpu_fan_rpm, max_gpu_mem_temp, power_limit_pct, thermal_limit_pct, app_frames_per_joule, fg_mix, runtime_module_sources) "
+ "VALUES (@session_guid, @game_id, @snapshot_id, @started_at, @ended_at, @duration_s, @qpc_epoch, @qpc_frequency, @capture_tier, @capture_mode, @capture_notes, @ac_exception_family, @late_attach, @telemetry_source, @overlay_build_id, @exit_status, @drain_ticks, @foreground_ticks, @records_before_attach, @dxgi_presents_before_hook, @gap_count, @guard_ticks_published, @launch_wait_ms, @api, @present_mode, @swap_effect, @hdr_flag, @hdr_source, @sync_interval_mode, @upscaler, @upscaler_quality, @upscaler_sharpness, @upscaler_driver_reported, @render_w, @render_h, @output_w, @output_h, @upscale_ratio, @settings_changed_midsession, @fg_mode, @fg_source, @fg_factor, @fg_driver_reported, @fg_runtime_census, @fg_none_withheld_reason, @fg_refusal, @fg_refusal_detail, @fg_factor_scope, @fg_steady_share, @presented_fps, @presented_qualifier, @dxgi_unseen_total, @dxgi_present_samples, @displayed_counted_by, @sl_tag_census, @sl_interposer_version, @runtime_modules, @driver_profile, @executable_markers, @ngx_driver_words, @rt_flag, @rt_source, @pt_flag, @pt_source, @pt_confidence, @rr_flag, @rr_source, @rt_frame_pct, @rays_per_pixel, @rt_pso_count, @rt_tier, @hooks_installed_mask, @raster_pso_count, @frame_count, @app_frame_count, @displayed_frame_count, @dropped_frames, @native_fps, @displayed_fps, @median_fps, @p1_low_fps, @p01_low_fps, @displayed_p1_low_fps, @min_fps, @max_fps, @frametime_stddev_ms, @stutter_count, @stutter_time_pct, @pso_stutter_pct, @reflex_active, @latency_avg_us, @latency_p95_us, @dropped_records, @fault_count, @data_quality_warnings, @writer_status_at_end, @early_stop_family, @loader_signals, @vram_proc_avg_mb, @vram_proc_max_mb, @vram_budget_exceeded_pct, @vram_adapter_max_mb, @avg_cpu_temp, @max_cpu_temp, @avg_gpu_temp, @max_gpu_temp, @max_gpu_hotspot, @avg_gpu_load, @avg_cpu_load, @avg_ram_mb, @avg_gpu_power_w, @throttle_pct, @display_exclusive_ms, @display_borderless_ms, @display_windowed_ms, @display_covers_ms, @display_minimized_ms, @display_nowindow_ms, @display_changes, @display_source, @display_window_w, @display_window_h, @display_buffer_w, @display_buffer_h, @display_monitor_w, @display_monitor_h, @display_monitor_hz, @game_vram_dedicated_avg_mb, @game_vram_dedicated_median_mb, @game_vram_dedicated_max_mb, @game_vram_shared_max_mb, @game_ram_private_avg_mb, @game_ram_private_median_mb, @game_ram_private_max_mb, @game_ram_ws_max_mb, @game_commit_max_mb, @game_memory_processes, @game_memory_source, @sensor_stats_json, @time_below_30_pct, @time_below_60_pct, @time_below_refresh_pct, @frametime_delta_mean_ms, @vsync_present_pct, @tearing_allowed_pct, @avg_gpu_core_clock_mhz, @avg_gpu_mem_clock_mhz, @avg_gpu_fan_rpm, @max_gpu_mem_temp, @power_limit_pct, @thermal_limit_pct, @app_frames_per_joule, @fg_mix, @runtime_module_sources) RETURNING id";
"INSERT INTO sessions (session_guid, game_id, snapshot_id, started_at, ended_at, duration_s, qpc_epoch, qpc_frequency, capture_tier, capture_mode, capture_notes, ac_exception_family, late_attach, telemetry_source, overlay_build_id, exit_status, drain_ticks, foreground_ticks, records_before_attach, dxgi_presents_before_hook, gap_count, guard_ticks_published, launch_wait_ms, api, present_mode, swap_effect, hdr_flag, hdr_source, sync_interval_mode, upscaler, upscaler_quality, upscaler_sharpness, upscaler_driver_reported, render_w, render_h, output_w, output_h, upscale_ratio, settings_changed_midsession, fg_mode, fg_source, fg_factor, fg_driver_reported, fg_runtime_census, fg_none_withheld_reason, fg_refusal, fg_refusal_detail, fg_factor_scope, fg_steady_share, presented_fps, presented_qualifier, dxgi_unseen_total, dxgi_present_samples, displayed_counted_by, sl_tag_census, sl_interposer_version, runtime_modules, driver_profile, executable_markers, ngx_driver_words, rt_flag, rt_source, pt_flag, pt_source, pt_confidence, rr_flag, rr_source, rt_frame_pct, rays_per_pixel, rt_pso_count, rt_tier, hooks_installed_mask, raster_pso_count, frame_count, app_frame_count, displayed_frame_count, dropped_frames, native_fps, displayed_fps, median_fps, p1_low_fps, p01_low_fps, displayed_p1_low_fps, min_fps, max_fps, frametime_stddev_ms, stutter_count, stutter_time_pct, pso_stutter_pct, reflex_active, latency_avg_us, latency_p95_us, dropped_records, fault_count, data_quality_warnings, writer_status_at_end, early_stop_family, loader_signals, vram_proc_avg_mb, vram_proc_max_mb, vram_budget_exceeded_pct, vram_adapter_max_mb, avg_cpu_temp, max_cpu_temp, avg_gpu_temp, max_gpu_temp, max_gpu_hotspot, avg_gpu_load, avg_cpu_load, avg_ram_mb, avg_gpu_power_w, throttle_pct, display_exclusive_ms, display_borderless_ms, display_windowed_ms, display_covers_ms, display_minimized_ms, display_nowindow_ms, display_changes, display_source, display_window_w, display_window_h, display_buffer_w, display_buffer_h, display_monitor_w, display_monitor_h, display_monitor_hz, game_vram_dedicated_avg_mb, game_vram_dedicated_median_mb, game_vram_dedicated_max_mb, game_vram_shared_max_mb, game_ram_private_avg_mb, game_ram_private_median_mb, game_ram_private_max_mb, game_ram_ws_max_mb, game_commit_max_mb, game_memory_processes, game_memory_source, sensor_stats_json, time_below_30_pct, time_below_60_pct, time_below_refresh_pct, frametime_delta_mean_ms, vsync_present_pct, tearing_allowed_pct, avg_gpu_core_clock_mhz, avg_gpu_mem_clock_mhz, avg_gpu_fan_rpm, max_gpu_mem_temp, power_limit_pct, thermal_limit_pct, app_frames_per_joule, fg_mix, runtime_module_sources, dlss_nr_pct) "
+ "VALUES (@session_guid, @game_id, @snapshot_id, @started_at, @ended_at, @duration_s, @qpc_epoch, @qpc_frequency, @capture_tier, @capture_mode, @capture_notes, @ac_exception_family, @late_attach, @telemetry_source, @overlay_build_id, @exit_status, @drain_ticks, @foreground_ticks, @records_before_attach, @dxgi_presents_before_hook, @gap_count, @guard_ticks_published, @launch_wait_ms, @api, @present_mode, @swap_effect, @hdr_flag, @hdr_source, @sync_interval_mode, @upscaler, @upscaler_quality, @upscaler_sharpness, @upscaler_driver_reported, @render_w, @render_h, @output_w, @output_h, @upscale_ratio, @settings_changed_midsession, @fg_mode, @fg_source, @fg_factor, @fg_driver_reported, @fg_runtime_census, @fg_none_withheld_reason, @fg_refusal, @fg_refusal_detail, @fg_factor_scope, @fg_steady_share, @presented_fps, @presented_qualifier, @dxgi_unseen_total, @dxgi_present_samples, @displayed_counted_by, @sl_tag_census, @sl_interposer_version, @runtime_modules, @driver_profile, @executable_markers, @ngx_driver_words, @rt_flag, @rt_source, @pt_flag, @pt_source, @pt_confidence, @rr_flag, @rr_source, @rt_frame_pct, @rays_per_pixel, @rt_pso_count, @rt_tier, @hooks_installed_mask, @raster_pso_count, @frame_count, @app_frame_count, @displayed_frame_count, @dropped_frames, @native_fps, @displayed_fps, @median_fps, @p1_low_fps, @p01_low_fps, @displayed_p1_low_fps, @min_fps, @max_fps, @frametime_stddev_ms, @stutter_count, @stutter_time_pct, @pso_stutter_pct, @reflex_active, @latency_avg_us, @latency_p95_us, @dropped_records, @fault_count, @data_quality_warnings, @writer_status_at_end, @early_stop_family, @loader_signals, @vram_proc_avg_mb, @vram_proc_max_mb, @vram_budget_exceeded_pct, @vram_adapter_max_mb, @avg_cpu_temp, @max_cpu_temp, @avg_gpu_temp, @max_gpu_temp, @max_gpu_hotspot, @avg_gpu_load, @avg_cpu_load, @avg_ram_mb, @avg_gpu_power_w, @throttle_pct, @display_exclusive_ms, @display_borderless_ms, @display_windowed_ms, @display_covers_ms, @display_minimized_ms, @display_nowindow_ms, @display_changes, @display_source, @display_window_w, @display_window_h, @display_buffer_w, @display_buffer_h, @display_monitor_w, @display_monitor_h, @display_monitor_hz, @game_vram_dedicated_avg_mb, @game_vram_dedicated_median_mb, @game_vram_dedicated_max_mb, @game_vram_shared_max_mb, @game_ram_private_avg_mb, @game_ram_private_median_mb, @game_ram_private_max_mb, @game_ram_ws_max_mb, @game_commit_max_mb, @game_memory_processes, @game_memory_source, @sensor_stats_json, @time_below_30_pct, @time_below_60_pct, @time_below_refresh_pct, @frametime_delta_mean_ms, @vsync_present_pct, @tearing_allowed_pct, @avg_gpu_core_clock_mhz, @avg_gpu_mem_clock_mhz, @avg_gpu_fan_rpm, @max_gpu_mem_temp, @power_limit_pct, @thermal_limit_pct, @app_frames_per_joule, @fg_mix, @runtime_module_sources, @dlss_nr_pct) RETURNING id";
public const string Select = "SELECT id, session_guid, game_id, snapshot_id, started_at, ended_at, duration_s, qpc_epoch, qpc_frequency, capture_tier, capture_mode, capture_notes, ac_exception_family, late_attach, telemetry_source, overlay_build_id, exit_status, drain_ticks, foreground_ticks, records_before_attach, dxgi_presents_before_hook, gap_count, guard_ticks_published, launch_wait_ms, api, present_mode, swap_effect, hdr_flag, hdr_source, sync_interval_mode, upscaler, upscaler_quality, upscaler_sharpness, upscaler_driver_reported, render_w, render_h, output_w, output_h, upscale_ratio, settings_changed_midsession, fg_mode, fg_source, fg_factor, fg_driver_reported, fg_runtime_census, fg_none_withheld_reason, fg_refusal, fg_refusal_detail, fg_factor_scope, fg_steady_share, presented_fps, presented_qualifier, dxgi_unseen_total, dxgi_present_samples, displayed_counted_by, sl_tag_census, sl_interposer_version, runtime_modules, driver_profile, executable_markers, ngx_driver_words, rt_flag, rt_source, pt_flag, pt_source, pt_confidence, rr_flag, rr_source, rt_frame_pct, rays_per_pixel, rt_pso_count, rt_tier, hooks_installed_mask, raster_pso_count, frame_count, app_frame_count, displayed_frame_count, dropped_frames, native_fps, displayed_fps, median_fps, p1_low_fps, p01_low_fps, displayed_p1_low_fps, min_fps, max_fps, frametime_stddev_ms, stutter_count, stutter_time_pct, pso_stutter_pct, reflex_active, latency_avg_us, latency_p95_us, dropped_records, fault_count, data_quality_warnings, writer_status_at_end, early_stop_family, loader_signals, vram_proc_avg_mb, vram_proc_max_mb, vram_budget_exceeded_pct, vram_adapter_max_mb, avg_cpu_temp, max_cpu_temp, avg_gpu_temp, max_gpu_temp, max_gpu_hotspot, avg_gpu_load, avg_cpu_load, avg_ram_mb, avg_gpu_power_w, throttle_pct, display_exclusive_ms, display_borderless_ms, display_windowed_ms, display_covers_ms, display_minimized_ms, display_nowindow_ms, display_changes, display_source, display_window_w, display_window_h, display_buffer_w, display_buffer_h, display_monitor_w, display_monitor_h, display_monitor_hz, game_vram_dedicated_avg_mb, game_vram_dedicated_median_mb, game_vram_dedicated_max_mb, game_vram_shared_max_mb, game_ram_private_avg_mb, game_ram_private_median_mb, game_ram_private_max_mb, game_ram_ws_max_mb, game_commit_max_mb, game_memory_processes, game_memory_source, sensor_stats_json, time_below_30_pct, time_below_60_pct, time_below_refresh_pct, frametime_delta_mean_ms, vsync_present_pct, tearing_allowed_pct, avg_gpu_core_clock_mhz, avg_gpu_mem_clock_mhz, avg_gpu_fan_rpm, max_gpu_mem_temp, power_limit_pct, thermal_limit_pct, app_frames_per_joule, fg_mix, runtime_module_sources FROM sessions";
public const string Select = "SELECT id, session_guid, game_id, snapshot_id, started_at, ended_at, duration_s, qpc_epoch, qpc_frequency, capture_tier, capture_mode, capture_notes, ac_exception_family, late_attach, telemetry_source, overlay_build_id, exit_status, drain_ticks, foreground_ticks, records_before_attach, dxgi_presents_before_hook, gap_count, guard_ticks_published, launch_wait_ms, api, present_mode, swap_effect, hdr_flag, hdr_source, sync_interval_mode, upscaler, upscaler_quality, upscaler_sharpness, upscaler_driver_reported, render_w, render_h, output_w, output_h, upscale_ratio, settings_changed_midsession, fg_mode, fg_source, fg_factor, fg_driver_reported, fg_runtime_census, fg_none_withheld_reason, fg_refusal, fg_refusal_detail, fg_factor_scope, fg_steady_share, presented_fps, presented_qualifier, dxgi_unseen_total, dxgi_present_samples, displayed_counted_by, sl_tag_census, sl_interposer_version, runtime_modules, driver_profile, executable_markers, ngx_driver_words, rt_flag, rt_source, pt_flag, pt_source, pt_confidence, rr_flag, rr_source, rt_frame_pct, rays_per_pixel, rt_pso_count, rt_tier, hooks_installed_mask, raster_pso_count, frame_count, app_frame_count, displayed_frame_count, dropped_frames, native_fps, displayed_fps, median_fps, p1_low_fps, p01_low_fps, displayed_p1_low_fps, min_fps, max_fps, frametime_stddev_ms, stutter_count, stutter_time_pct, pso_stutter_pct, reflex_active, latency_avg_us, latency_p95_us, dropped_records, fault_count, data_quality_warnings, writer_status_at_end, early_stop_family, loader_signals, vram_proc_avg_mb, vram_proc_max_mb, vram_budget_exceeded_pct, vram_adapter_max_mb, avg_cpu_temp, max_cpu_temp, avg_gpu_temp, max_gpu_temp, max_gpu_hotspot, avg_gpu_load, avg_cpu_load, avg_ram_mb, avg_gpu_power_w, throttle_pct, display_exclusive_ms, display_borderless_ms, display_windowed_ms, display_covers_ms, display_minimized_ms, display_nowindow_ms, display_changes, display_source, display_window_w, display_window_h, display_buffer_w, display_buffer_h, display_monitor_w, display_monitor_h, display_monitor_hz, game_vram_dedicated_avg_mb, game_vram_dedicated_median_mb, game_vram_dedicated_max_mb, game_vram_shared_max_mb, game_ram_private_avg_mb, game_ram_private_median_mb, game_ram_private_max_mb, game_ram_ws_max_mb, game_commit_max_mb, game_memory_processes, game_memory_source, sensor_stats_json, time_below_30_pct, time_below_60_pct, time_below_refresh_pct, frametime_delta_mean_ms, vsync_present_pct, tearing_allowed_pct, avg_gpu_core_clock_mhz, avg_gpu_mem_clock_mhz, avg_gpu_fan_rpm, max_gpu_mem_temp, power_limit_pct, thermal_limit_pct, app_frames_per_joule, fg_mix, runtime_module_sources, dlss_nr_pct FROM sessions";
public static Dictionary<string, object?> Parameters(SessionRow s)
{
@@ -413,12 +413,16 @@ internal static class SessionRowColumns
// Schema 0021 (beta.24, D64): each runtime module's folder class.
d["runtime_module_sources"] = s.RuntimeModuleSourcesJson;
// Schema 0022 (beta.34, D84): DLSS 5's neural rendering, the share of Streamline frames that evaluated it.
d["dlss_nr_pct"] = s.DlssNrPct;
}
private static SessionRow Read7(SessionRow row, DbDataReader r) => row with
{
FgMixJson = S(r, "fg_mix"),
RuntimeModuleSourcesJson = S(r, "runtime_module_sources"),
DlssNrPct = D(r, "dlss_nr_pct"),
};
public static string ExitStatusText(ExitStatus status) => Vocabulary.ExitStatusText(status);
+16
View File
@@ -232,6 +232,16 @@ public enum FlFeatureFlags : byte
RayReconstructionObserved = 1 << 4,
ReflexObserved = 1 << 5,
SlUndecodedObserved = 1 << 6,
/// <summary>
/// DLSS 5's neural rendering — <c>kFeatureDLSS_NR</c> — was evaluated this frame (beta.34, D84).
/// </summary>
/// <remarks>
/// A fact in the companions' half, the byte's last free bit: like <see cref="SlSuperResolution"/> it is published only
/// where an evaluation drained, so <see cref="RayReconstructionObserved"/> is its OBSERVED; and only a writer that
/// published <see cref="FlHookFamily.SlNeuralRendering"/> could set it — an older one's silence is not a "No".
/// </remarks>
SlNeuralRendering = 1 << 7,
}
/// <summary>Which hook families a writer installed. Bits in <see cref="FlWriterState.HooksInstalledMask"/>.</summary>
@@ -258,6 +268,12 @@ public enum FlHookFamily : uint
/// <summary>The FidelityFX quality query, <c>ffxQuery</c> (beta.25, D65): what lets a dispatch's size name its mode.</summary>
UpscalerQuality = 1u << 11,
/// <summary>
/// The <c>slEvaluateFeature</c> detour decodes DLSS 5's <c>kFeatureDLSS_NR</c> (beta.34, D84) — published with it, so a
/// writer that looked for neural rendering is told from one built before it could (<see cref="FlFeatureFlags.SlNeuralRendering"/>).
/// </summary>
SlNeuralRendering = 1u << 12,
}
/// <summary>
@@ -718,9 +718,6 @@ Verdict EvaluateImpl(std::uint32_t targetPid, const Sources& sources, const char
return Allow();
}
// A refusal returns here, and there is no argument that changes that (the `acknowledged` flag of 2026-09-21 was
// withdrawn on 2026-09-22 with the bypass it served). Everything below -- the payload's existence, the payload's
// identity, the primitive, the bitness answer -- runs only for a target the full evaluation allowed.
// beta.33 (D78) -- the first policy in `facts` the Overlay cannot live under, named for the refusal's signal; null
// when there is none. Which one names a refusal changes nothing a user can do, so the order is just winnt.h's.
const char* BlockingMitigation(const TargetIsolation& facts) noexcept {
@@ -765,6 +762,10 @@ Verdict TargetIsolationVerdict(std::uint32_t targetPid, const Sources& sources)
return Allow();
}
// A refusal returns here, and there is no argument that changes that (the `acknowledged` flag of 2026-09-21 was
// withdrawn on 2026-09-22 with the bypass it served). Everything below -- the payload's existence, the payload's
// identity, the target's isolation, the primitive, the bitness answer -- runs only for a target the full evaluation
// allowed.
Verdict GuardedInjectImpl(std::uint32_t targetPid, const wchar_t* dllPath, const Sources& sources,
const char* toleratedFamilies) noexcept {
const Verdict v = EvaluateImpl(targetPid, sources, toleratedFamilies);
@@ -99,7 +99,13 @@ namespace fl::inventory {
// ones that never evaluate anything through this export. The family bit moved with
// the count, so EntitledBy still binds FL_MEASURED_FG_COUNTS to the detour that
// actually produces it.
inline constexpr uint32_t kFamilyEvaluateFeature = static_cast<uint32_t>(fl::FL_HOOK_UPSCALER_IDENTITY);
//
// AND NEURAL RENDERING SINCE beta.34 (owner decision D84): the same detour decodes kFeatureDLSS_NR (Streamline 2.14's
// sl_core_types.h, re-vendored for it) into FL_FEAT_SL_NEURAL_RENDERING, so the row claims FL_HOOK_SL_NEURAL_RENDERING
// beside identity -- the family is what separates "this writer looked and DLSS 5 did not run" from "this writer was
// built before it could look".
inline constexpr uint32_t kFamilyEvaluateFeature =
static_cast<uint32_t>(fl::FL_HOOK_UPSCALER_IDENTITY) | static_cast<uint32_t>(fl::FL_HOOK_SL_NEURAL_RENDERING);
// EVERY FAMILY THIS DETOUR DOES NOT IMPLEMENT, NAMED. The obvious assertion --
// `kFamilyEvaluateFeature == (IDENTITY | FG_EVALUATIONS)` -- is a TAUTOLOGY against
@@ -126,6 +132,10 @@ static_assert((kFamilyEvaluateFeature & kFamiliesEvaluateFeatureDoesNotImplement
"verdict available");
static_assert((kFamilyEvaluateFeature & static_cast<uint32_t>(fl::FL_HOOK_UPSCALER_IDENTITY)) != 0u,
"the detour decodes sl::Feature, so it must claim upscaler identity");
static_assert(
(kFamilyEvaluateFeature & static_cast<uint32_t>(fl::FL_HOOK_SL_NEURAL_RENDERING)) != 0u,
"the detour decodes kFeatureDLSS_NR, so it must say so -- without the family an Agent cannot tell a writer "
"that saw no neural rendering from one that could not have seen it");
static_assert((kFamilyEvaluateFeature & static_cast<uint32_t>(fl::FL_HOOK_FG_EVALUATIONS)) == 0u,
"the evaluate detour no longer produces the application-frame count -- slGetNewFrameToken does -- "
"so claiming FG_EVALUATIONS here would entitle FL_MEASURED_FG_COUNTS to a detour that writes "
@@ -190,7 +200,7 @@ inline constexpr uint32_t kFamiliesFfxDispatchDoesNotImplement =
static_cast<uint32_t>(fl::FL_HOOK_RT_AS_BUILD) | static_cast<uint32_t>(fl::FL_HOOK_RT_PSO) |
static_cast<uint32_t>(fl::FL_HOOK_PSO) | static_cast<uint32_t>(fl::FL_HOOK_COLOR_SPACE) |
static_cast<uint32_t>(fl::FL_HOOK_REFLEX) | static_cast<uint32_t>(fl::FL_HOOK_VRAM) |
static_cast<uint32_t>(fl::FL_HOOK_UPSCALER_QUALITY);
static_cast<uint32_t>(fl::FL_HOOK_UPSCALER_QUALITY) | static_cast<uint32_t>(fl::FL_HOOK_SL_NEURAL_RENDERING);
static_assert((kFamilyFfxDispatch & kFamiliesFfxDispatchDoesNotImplement) == 0u,
"the ffxDispatch rows claim a family their detour does not implement -- hookinventory-check reads "
@@ -987,6 +987,14 @@ enum FlSlSeen : uint32_t {
FL_SL_SEEN_RETIRED_DLSS_G = 1u << 3,
FL_SL_SEEN_OTHER = 1u << 4, // an id we do not decode -- coverage is short, and we say so
// kFeatureDLSS_NR (1004, Streamline 2.14's sl_core_types.h): DLSS 5's neural rendering, which is neither an
// upscaler nor frame generation, so it moves no decoded byte -- RecordPresent turns it into
// FL_FEAT_SL_NEURAL_RENDERING and nothing else. Until beta.34 it fell to FL_SL_SEEN_OTHER: the owner's Hogwarts
// Legacy loaded DLSS 5's runtime with Neural Rendering on and the session could say only that it was LOADED
// (spike-notes §26, owner decision D84). Bit 5 sits inside fl::slseen::kFeatureMask (8 bits, derived), below the
// frame-generation count.
FL_SL_SEEN_DLSS_NR = 1u << 5,
};
std::atomic<uint32_t> g_slSeen{0};
@@ -1628,6 +1636,8 @@ sl::Result STDMETHODCALLTYPE Hook_SlEvaluateFeature(sl::Feature feature, const s
bit = FL_SL_SEEN_NIS;
} else if (feature == sl::kFeatureDLSS_RR) {
bit = FL_SL_SEEN_DLSS_RR;
} else if (feature == sl::kFeatureDLSS_NR) {
bit = FL_SL_SEEN_DLSS_NR;
} else if (feature == sl::kFeatureDLSS_G) {
bit = 0u; // carried as a COUNT below, not as a bit
}
@@ -3089,11 +3099,24 @@ void RecordPresent(IDXGISwapChain* sc, UINT syncInterval, UINT flags) noexcept {
// repo keeps catching -- `a != b` passes when one side is absent. The fixture is
// cheap: --hold-presenting-fg already drives a chosen sl::Feature, so a mode
// passing an id outside the four decoded constants would settle it.
// (Settled since, and this paragraph predates it -- noted 2026-11-06: guard_test's
// "an upscaler the Overlay cannot identify is UNKNOWN, never NONE" drives 0xF00D
// through an injected Overlay and finds UNDECODED on every record.)
feat = static_cast<uint8_t>(feat | FL_FEAT_SL_UNDECODED_OBSERVED);
if ((seen & FL_SL_SEEN_OTHER) != 0u) {
feat = static_cast<uint8_t>(feat | FL_FEAT_SL_UNDECODED);
}
// DLSS 5'S NEURAL RENDERING RAN THIS FRAME (beta.34, D84): kFeatureDLSS_NR was evaluated.
// Under the same condition as the facts above -- an evaluation was drained -- so its
// OBSERVED companion is FL_FEAT_RAY_RECONSTRUCTION_OBSERVED, as it is for the
// super-resolution fact below, and for the same reason: a second companion would be
// equal to it bit for bit. Never inferred from the module being loaded: Hogwarts Legacy
// loads nvngx_dlssnr.dll, and a load is not an evaluation.
if ((seen & FL_SL_SEEN_DLSS_NR) != 0u) {
feat = static_cast<uint8_t>(feat | FL_FEAT_SL_NEURAL_RENDERING);
}
// THE RAW SUPER-RESOLUTION FACT, kept apart from the decoded `upscaler` byte.
//
// The decode maps kFeatureDLSS_RR to FL_UPSCALER_DLSS, because Ray Reconstruction
+19 -1
View File
@@ -291,7 +291,19 @@ enum FlFeatureFlags : uint8_t {
FL_FEAT_RAY_RECONSTRUCTION_OBSERVED = 1u << 4,
FL_FEAT_REFLEX_OBSERVED = 1u << 5,
FL_FEAT_SL_UNDECODED_OBSERVED = 1u << 6,
// bit 7 free, and must pair with the fact bit four places below
// DLSS 5'S NEURAL RENDERING -- kFeatureDLSS_NR (1004, Streamline 2.14) was evaluated this frame
// (beta.34, owner decision D84). The byte's last free bit, and a FACT in the companions' half:
// this line said "bit 7 free, and must pair with the fact bit four places below", and bit 3
// took no companion for the reason it gives above -- every Streamline fact here is published
// under one condition, an evaluation drained, so its OBSERVED is
// FL_FEAT_RAY_RECONSTRUCTION_OBSERVED. This one is the same kind of fact and takes the same
// companion. Until it existed DLSS 5's evaluations fell to FL_FEAT_SL_UNDECODED, and a session
// could say only that the runtime was LOADED (spike-notes §26).
//
// AN ENUMERATOR, NOT A FIELD: no struct changes, so no FL_SHM_LAYOUT_VERSION bump, no
// ShmLayout.cs struct edit and no fl-layout-dump entry -- the mirror's enum gains the member.
FL_FEAT_SL_NEURAL_RENDERING = 1u << 7,
};
// bits in FlFrameRecord::rtFlags — POLARITY FLIPPED IN v3.
@@ -379,6 +391,12 @@ enum FlHookFamily : uint32_t {
// It measures nothing by itself; it is what lets an UPSCALE dispatch's renderSize name the mode the title asked
// for, so "hooked, and the title never asked" can be told from "not hooked".
FL_HOOK_UPSCALER_QUALITY = 1u << 11,
// DLSS 5's neural rendering (beta.34, owner decision D84): the slEvaluateFeature detour that publishes this decodes
// kFeatureDLSS_NR into FL_FEAT_SL_NEURAL_RENDERING. Published with the detour, never by itself, it is what tells a
// writer that LOOKED for neural rendering from one built before it could: an Overlay older than beta.34 sets
// FL_FEAT_RAY_RECONSTRUCTION_OBSERVED and never bit 7, and without this family its silence would read as a
// measured "not running" -- a fabricated negative of the kind 03_METRICS §RT/PT/RR forbids for ray reconstruction.
FL_HOOK_SL_NEURAL_RENDERING = 1u << 12,
};
// FlWriterState::runtimeCensus -- which vendor RUNTIME MODULES the loader reported
+93 -1
View File
@@ -5339,6 +5339,95 @@ TEST_CASE("an upscaler the Overlay cannot identify is UNKNOWN, never NONE", "[gu
CHECK(undecoded == static_cast<int>(all.size()));
CHECK(superResolution == 0);
// And 0xF00D is not DLSS 5 either (beta.34): the neural-rendering fact belongs to kFeatureDLSS_NR alone.
int neural = 0;
for (const auto& r : all) {
if ((r.featureFlags & fl::FL_FEAT_SL_NEURAL_RENDERING) != 0u) {
++neural;
}
}
CHECK(neural == 0);
UnmapViewOfFile(base);
CloseHandle(mapping);
}
TEST_CASE("DLSS 5's neural rendering is its own fact, never an undecoded id and never an upscaler",
"[guard][inject][shm][upscaler]") {
// beta.34, owner decision D84. The target evaluates kFeatureDLSS_NR (1004, Streamline 2.14's sl_core_types.h) once
// per present. Until this build the id fell to FL_SL_SEEN_OTHER, and the owner's Hogwarts Legacy -- DLSS 5's
// runtime loaded, Neural Rendering on -- could only be said to have LOADED it. Three things are asserted, each by
// count: the fact on every record; UNDECODED on none (the id is decoded now); and the upscaler UNKNOWN, as for any
// id that names no upscaler -- neural rendering is not one, and naming DLSS for it would be the decode inventing an
// answer. And the family the Agent keys the session's share on is published with the detour, so a measured 0 % can
// only come from a writer that looked.
Child child;
std::wstring cmd = std::wstring(L"\"") + FL_HARNESS_EXE + L"\" --real --hold-presenting-upscaled-nr 12";
STARTUPINFOW si{};
si.cb = sizeof(si);
REQUIRE(CreateProcessW(FL_HARNESS_EXE, cmd.data(), nullptr, nullptr, FALSE, CREATE_NO_WINDOW, nullptr, nullptr, &si,
&child.pi));
Sleep(800);
REQUIRE(WaitForSingleObject(child.pi.hProcess, 0) == WAIT_TIMEOUT);
ResetFake();
g.modules = {"kernel32.dll"};
g.scanSet = {child.pi.dwProcessId};
REQUIRE(GuardedInjectWithSources(child.pi.dwProcessId, FL_OVERLAY_DLL, FakeSources()).Allowed());
wchar_t name[128]{};
REQUIRE(_snwprintf_s(name, _TRUNCATE, L"Local\\FrameLedger.Ring.%lu", child.pi.dwProcessId) > 0);
HANDLE mapping = nullptr;
for (int i = 0; i < 100 && mapping == nullptr; ++i) {
mapping = OpenFileMappingW(FILE_MAP_READ, FALSE, name);
if (mapping == nullptr) {
Sleep(50);
}
}
REQUIRE(mapping != nullptr);
const void* base = MapViewOfFile(mapping, FILE_MAP_READ, 0, 0, 0);
REQUIRE(base != nullptr);
const auto* st =
reinterpret_cast<const fl::FlWriterState*>(static_cast<const unsigned char*>(base) + FL_SHM_WRITER_OFFSET);
REQUIRE(WaitForIdentityHook(st));
CHECK((st->hooksInstalledMask & static_cast<uint32_t>(fl::FL_HOOK_SL_NEURAL_RENDERING)) != 0u);
fl::RingReader rd;
REQUIRE(rd.Init(base, FL_SHM_DEFAULT_CAPACITY));
DiscardBacklog(rd);
const std::vector<fl::FlFrameRecord> all = DrainAtLeast(rd, 40, 8000);
REQUIRE(all.size() > 20);
int neural = 0;
int observed = 0;
int undecoded = 0;
int superResolution = 0;
int unknown = 0;
for (const auto& r : all) {
if ((r.featureFlags & fl::FL_FEAT_SL_NEURAL_RENDERING) != 0u) {
++neural;
}
if ((r.featureFlags & fl::FL_FEAT_RAY_RECONSTRUCTION_OBSERVED) != 0u) {
++observed;
}
if ((r.featureFlags & fl::FL_FEAT_SL_UNDECODED) != 0u) {
++undecoded;
}
if ((r.featureFlags & fl::FL_FEAT_SL_SUPER_RESOLUTION) != 0u) {
++superResolution;
}
if (r.upscaler == fl::FL_UPSCALER_UNKNOWN) {
++unknown;
}
}
CHECK(neural == static_cast<int>(all.size())); // one evaluation per present, so every record
CHECK(observed == static_cast<int>(all.size())); // under the condition every Streamline fact shares
CHECK(undecoded == 0); // decoded now -- not "an id we do not know"
CHECK(superResolution == 0); // and not a super-resolution id
CHECK(unknown == static_cast<int>(all.size())); // neural rendering names no upscaler
CHECK(st->faultCount == 0);
UnmapViewOfFile(base);
CloseHandle(mapping);
}
@@ -5533,8 +5622,11 @@ TEST_CASE("application-frame tokens are COUNTED, and the count tracks the fixtur
// UPSCALER_PARAMS is in the expected set because the stub exports slSetTag as
// well, so the watchdog installs BOTH inventory rows regardless of whether
// this fixture ever calls the second one. Installing is what the mask records.
// SL_NEURAL_RENDERING since beta.34 (D84): the evaluate row's compound family
// carries it, published with the detour, so a writer that could see DLSS 5 says so.
CHECK(obs.hooks == static_cast<std::uint32_t>(fl::FL_HOOK_PRESENT | fl::FL_HOOK_UPSCALER_IDENTITY |
fl::FL_HOOK_UPSCALER_PARAMS | fl::FL_HOOK_FG_EVALUATIONS));
fl::FL_HOOK_UPSCALER_PARAMS | fl::FL_HOOK_FG_EVALUATIONS |
fl::FL_HOOK_SL_NEURAL_RENDERING));
// THE CENSUS SEES THE STUB BY NAME. The interposer stub is loaded by absolute
// path and is still called sl.interposer.dll, so the loader answers yes for
+21 -2
View File
@@ -1,7 +1,8 @@
# NVIDIA Streamline headers (vendored)
Copied from <https://github.com/NVIDIA-RTX/Streamline>, `main`, on 2026-08-09.
**Headers only. No `.lib`, no `.dll`, no source, and deliberately not the whole
Copied from <https://github.com/NVIDIA-RTX/Streamline>, `main`, on 2026-08-09 — which was tag `v2.12.0`, byte for byte —
and **re-vendored at tag `v2.14.16` on 2026-11-06** (beta.34, the owner: "check what changed in recent Streamline
versions and fix it if really needed"). **Headers only. No `.lib`, no `.dll`, no source, and deliberately not the whole
`include/` directory** — see §What is here, and what is not.
**Licence:** MIT. `license.txt` is the upstream file, verbatim, and it opens with
@@ -19,6 +20,24 @@ the index blob is CRLF too, so unlike the NVAPI case — where upstream is LF an
transformation happens here in either direction. The bytes under version control
are the upstream bytes.
## 2026-11-06: v2.12.0 → v2.14.16, and why
Compared with the upstream tags through GitHub's API, all eleven files byte for byte: the copy of 2026-08-09 equals
`v2.12.0`; `v2.14.16` (2026-10-16) — the Streamline that Hogwarts Legacy ships and the NVIDIA App's DLSS override loads
— changes three of them, and the three are now its bytes (CRLF, as upstream):
- `sl_core_types.h` — **`kFeatureDLSS_NR = 1004`**, DLSS 5's neural rendering, which the Overlay's `slEvaluateFeature`
detour now decodes (`spike-notes` §26, owner decision D84); buffer types 70–72, reserved until then, become
`kBufferTypeUpliftInputColor`, `kBufferTypeUpliftOutputColor` and `kBufferTypeUpliftControlMask` (the tag census still
counts them as *other*); `Resource::reserved` (32 bits) becomes `internalFlags` + `reserved` (16 bits each — the
struct's size is unchanged, and nothing here reads either).
- `sl_struct.h` — `kStructVersion7`.
- `sl_version.h` — 2.14.16, so `kSDKVersion` is 2.14.16's: the dev probe `tools/fl-probe-interposer` passes it to `slInit`.
`sl.h`, `sl_core_api.h` (`PFun_slEvaluateFeature` — `hookinventory-check` Pass A's signature), `sl_dlss.h` and
`license.txt` are identical in both tags, and the closure is still the same ten headers. Re-checked on the new bytes:
no `throw`, `try` or `catch` in code (one "try" in a comment), and none of the four licence needles.
## Why this could be vendored at all
`docs/18_GPU_VENDOR_APIS.md` §Checklist before adding any vendor SDK, step 1: MIT
+19 -8
View File
@@ -206,12 +206,13 @@ constexpr BufferType kBufferTypeResponsivityMask = 68;
//! A 1 channel resource containing the alpha value of on-screen elements, between 0.0f and 1.0f inclusive.
//! Similar to kBufferTypeUIColorAndAlpha, but only the alpha channel for optimized run-time performance.
constexpr BufferType kBufferTypeUIAlpha = 69;
//! Reserved for future use, do not use
constexpr BufferType kBufferTypeReserved70 = 70;
//! Reserved for future use, do not use
constexpr BufferType kBufferTypeReserved71 = 71;
//! Reserved for future use, do not use
constexpr BufferType kBufferTypeReserved72 = 72;
//! Input color for neural-net "uplift" passes
constexpr BufferType kBufferTypeUpliftInputColor = 70;
//! Output color for neural-net "uplift" passes
//! May alias kBufferTypeUpliftInputColor (in-place uplift); the feature transitions appropriately.
constexpr BufferType kBufferTypeUpliftOutputColor = 71;
//! Optional - 4-channel control mask consumed by uplift passes
constexpr BufferType kBufferTypeUpliftControlMask = 72;
//! Features supported with this SDK
//!
@@ -249,6 +250,7 @@ constexpr Feature kFeatureNvPerf = 1002;
constexpr Feature kFeatureDirectSR = 1003;
constexpr Feature kFeatureDLSS_NR = 1004;
// ImGUI
constexpr Feature kFeatureImGUI = 9999;
@@ -371,8 +373,17 @@ SL_STRUCT_BEGIN(Resource, StructType({ 0x3a9d70cf, 0x2418, 0x4b72, { 0x83, 0x91,
uint32_t flags;
//! VkImageUsageFlags
uint32_t usage{};
//! Reserved for internal use
uint32_t reserved{};
//! Internal flags (bitfield) - do not modify
enum InternalFlags : uint16_t
{
eNone = 0,
//! Resource wraps a Vulkan swapchain image not allocated by SL or the host callback.
//! The release callback must not be invoked for such resources.
eVulkanSwapChainImage = 1 << 0,
};
uint16_t internalFlags{};
//! Reserved for future use
uint16_t reserved{};
//! IMPORTANT: New members go here or if optional can be chained in a new struct, see sl_struct.h for details
SL_STRUCT_END()
+1
View File
@@ -103,6 +103,7 @@ constexpr uint32_t kStructVersion3 = 3;
constexpr uint32_t kStructVersion4 = 4;
constexpr uint32_t kStructVersion5 = 5;
constexpr uint32_t kStructVersion6 = 6;
constexpr uint32_t kStructVersion7 = 7;
struct BaseStructure
{
+2 -2
View File
@@ -22,8 +22,8 @@
#pragma once
#define SL_VERSION_MAJOR 2
#define SL_VERSION_MINOR 12
#define SL_VERSION_PATCH 0
#define SL_VERSION_MINOR 14
#define SL_VERSION_PATCH 16
#include <cstdint>
#include <string>
+8
View File
@@ -3134,6 +3134,14 @@ int main(int argc, char** argv) {
slTagWholeResource, slTagDlssgInputs) == 0 &&
ok;
ranSomething = true;
} else if (std::strcmp(argv[i], "--hold-presenting-upscaled-nr") == 0 && i + 1 < argc) {
// The SAME target, evaluating DLSS 5's neural rendering (kFeatureDLSS_NR, Streamline 2.14 -- beta.34, D84)
// once per present. It is not an upscaler: the record must say UNKNOWN for the upscaler, as for any id
// that names none, and carry FL_FEAT_SL_NEURAL_RENDERING rather than FL_FEAT_SL_UNDECODED.
ok = HoldPresentingUpscaled(g, std::atoi(argv[++i]), real, sl::kFeatureDLSS_NR, slTagForFrame,
slTagWholeResource, slTagDlssgInputs) == 0 &&
ok;
ranSomething = true;
} else if (std::strcmp(argv[i], "--probe-upscaler-resolve") == 0) {
ok = ProbeUpscalerResolve() && ok;
ranSomething = true;
@@ -214,4 +214,50 @@ public sealed class CompareViewModelTests
CultureInfo.CurrentCulture = previousCulture;
}
}
/// <summary>
/// beta.34 (owner request 2026-11-06, D85): Compare lists every session — it was the newest 200 — and filters them by game,
/// tier and frame generation; a ticked session stays listed whatever the filters say, and the count says how many of how
/// many are shown.
/// </summary>
[System.Diagnostics.CodeAnalysis.SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format strings are resources that follow the UI culture")]
[Fact]
public async Task TheFiltersNarrowTheListAndATickedSessionStaysOnIt()
{
await using ScratchLedger s = await ScratchLedger.OpenAsync();
GameRow a = await s.GameAsync("Alpha");
GameRow b = await s.GameAsync("Beta");
DateTimeOffset now = DateTimeOffset.UtcNow;
_ = await s.SessionAsync(a.Id, now.AddHours(-5), fgMode: "dlssg", native: 60, displayed: 180, factor: 3);
_ = await s.SessionAsync(a.Id, now.AddHours(-4), fgMode: "none");
_ = await s.SessionAsync(b.Id, now.AddHours(-3), fgMode: "none");
_ = await s.SessionAsync(b.Id, now.AddHours(-2), hooked: false);
CompareViewModel vm = await BuildAsync(s, new ScriptedMixed(answer: true));
vm.Candidates.Should().HaveCount(4);
vm.CountText.Should().Be(string.Format(CultureInfo.CurrentCulture, Strings.Compare_Count_Format, 4));
vm.Games.Select(static g => g.Label).Should().Equal([Strings.Compare_Filter_Game_All, "Alpha", "Beta"]);
vm.GameFilter = a.Id;
vm.Candidates.Should().HaveCount(2).And.OnlyContain(c => c.GameId == a.Id);
vm.CountText.Should().Be(string.Format(CultureInfo.CurrentCulture, Strings.Compare_Count_Filtered_Format, 2, 4));
vm.FrameGenerationFilter = YesNoFilter.Yes;
vm.Candidates.Should().ContainSingle().Which.HasFrameGeneration.Should().BeTrue();
vm.Candidates[0].IsSelected = true;
vm.GameFilter = b.Id;
vm.FrameGenerationFilter = YesNoFilter.All;
vm.TierFilter = CompareTierFilter.NotMeasured;
vm.Candidates.Should().HaveCount(2, "Beta's unmeasured session, and the ticked one, which a filter never hides");
vm.Candidates.Count(static c => c.IsSelected).Should().Be(1);
vm.SelectedCount.Should().Be(1);
vm.ClearSelectionCommand.Execute(null);
vm.SelectedCount.Should().Be(0);
vm.ClearFiltersCommand.Execute(null);
vm.Candidates.Should().HaveCount(4);
vm.Candidates.Single(static c => c.HasFrameGeneration is null).TierText.Should().Be(Strings.Tier_NotHooked);
vm.Candidates.Should().OnlyContain(static c => c.SettingsChangedText.Length > 0, "a dash where nothing changed — the column was blank");
}
}
+82 -2
View File
@@ -36,8 +36,25 @@ public sealed class DlssTextTests
}
}
// Phantom Blade Zero, 2026-11-05 (the owner's ledger, session 129): the NVIDIA App's Dynamic frame generation, up to ×3,
// target the maximum refresh rate — the profile's NGX_DLSSG_MODE 4, and the driver's FG word with FG_MODE (bit 13) set.
private const string _dynamicUpToThree = "{\"Outcome\":\"Application\",\"Profile\":\"Phantom Blade Zero\",\"NvapiStatus\":0,\"Settings\":[" +
"{\"Id\":\"0x10E41E01\",\"Value\":1,\"Location\":\"Profile\",\"Predefined\":false}," +
"{\"Id\":\"0x104D6667\",\"Value\":0,\"Location\":\"Profile\",\"Predefined\":false}," +
"{\"Id\":\"0x10308298\",\"Value\":4,\"Location\":\"Profile\",\"Predefined\":false}," +
"{\"Id\":\"0x10562D0F\",\"Value\":2,\"Location\":\"Profile\",\"Predefined\":false}," +
"{\"Id\":\"0x10CF4125\",\"Value\":16777216,\"Location\":\"Profile\",\"Predefined\":false}]}";
private const string _dynamicApplied = "{\"Outcome\":\"Answered\",\"Sr\":\"0x1F\",\"Rr\":\"0x605\",\"Fg\":\"0x263F\",\"Driver\":62101,\"Ratio\":0,\"Mode\":0," +
"\"Preset\":0,\"FgCount\":0,\"FgPreset\":3,\"FgMode\":3,\"Readings\":203,\"Answered\":201,\"Changed\":true,\"Detail\":null}";
private const string _upToThreeMix = "{\"Rows\":[" +
"{\"Kind\":\"generated\",\"Factor\":1.9954505429997065,\"NativeFps\":85.175,\"DisplayedFps\":169.9625,\"Seconds\":80,\"Share\":0.013,\"Windows\":16}," +
"{\"Kind\":\"generated\",\"Factor\":2.9986416215642575,\"NativeFps\":72.64,\"DisplayedFps\":217.83,\"Seconds\":4540,\"Share\":0.746,\"Windows\":908}," +
"{\"Kind\":\"none\",\"Factor\":null,\"NativeFps\":61.68,\"DisplayedFps\":61.69,\"Seconds\":1203.9,\"Share\":0.198,\"Windows\":241}]}";
private static SessionRow Row(string? modules = null, string? sources = null, string? upscaler = null, string? driverReported = null, string? words = null,
string fgMode = "na", double? factor = null, string? mix = null) => new()
string fgMode = "na", double? factor = null, string? mix = null, string? profile = null, double? neural = null) => new()
{
SessionGuid = Guid.NewGuid(),
GameId = 1,
@@ -58,8 +75,70 @@ public sealed class DlssTextTests
FgMode = fgMode,
FgFactor = factor,
FgMixJson = mix,
DriverProfileJson = profile,
DlssNrPct = neural,
};
/// <summary>
/// beta.34, owner decision D84: Hogwarts Legacy with Neural Rendering on (the owner's session 132, 2026-11-06) loaded DLSS
/// 5's runtime, 310.9.16.0 from the game's folder, and could say only that. Measured running, DLSS 5 is the generation;
/// measured not running, it says so; with nothing able to tell, it stays "loaded".
/// </summary>
[Fact]
public void Dlss5IsTheGenerationWhereItsNeuralRenderingWasSeenRunning() => InEnglish(() =>
{
const string modules = "{\"sl.interposer.dll\":\"2,14,16,0\",\"nvngx_dlss.dll\":\"310,9,16,0\",\"nvngx_dlssg.dll\":\"310,9,16,0\"," +
"\"nvngx_dlssd.dll\":\"310,9,16,0\",\"nvngx_dlssnr.dll\":\"310,9,16,0\"}";
const string sources = "{\"nvngx_dlss.dll\":\"game\",\"nvngx_dlssg.dll\":\"game\",\"nvngx_dlssd.dll\":\"game\",\"nvngx_dlssnr.dll\":\"game\"}";
SessionRow hogwarts = Row(modules, sources, upscaler: "unknown", driverReported: "dlss", fgMode: "dlssg", neural: 97.31,
words: "{\"Outcome\":\"Answered\",\"Sr\":\"0x80605\",\"Rr\":\"0x5\",\"Fg\":\"0x5\",\"Readings\":5,\"Answered\":4}");
DlssText.Label(hogwarts).Should().Be("DLSS 5 (neural rendering on 97.3% of rendered frames)");
DlssText.Line(hogwarts).Should().Be("DLSS 5 (neural rendering on 97.3% of rendered frames) · Super Resolution 310.9.16, from the game"
+ " · Ray Reconstruction 310.9.16, from the game · Frame Generation 310.9.16, from the game · Neural Rendering 310.9.16, from the game");
DlssText.ExportLine(hogwarts).Should().Be("generation=DLSS 5 basis=neural_rendering; nvngx_dlss.dll=310,9,16,0 game; nvngx_dlssd.dll=310,9,16,0 game;"
+ " nvngx_dlssg.dll=310,9,16,0 game; nvngx_dlssnr.dll=310,9,16,0 game; neural_rendering_pct=97.3");
SessionRow off = hogwarts with { DlssNrPct = 0 };
DlssText.Label(off).Should().BeNull("not running, and the rest names no generation");
DlssText.Line(off).Should().EndWith("Neural Rendering 310.9.16, from the game · DLSS 5 runtime loaded, not seen running");
SessionRow unknown = hogwarts with { DlssNrPct = null };
DlssText.Line(unknown).Should().EndWith("Neural Rendering 310.9.16, from the game · DLSS 5 runtime loaded",
"an Overlay before beta.34, or a title outside Streamline: nothing could tell, so never \"not running\"");
return 0;
});
/// <summary>
/// beta.34, owner decision D83: Phantom Blade Zero under the NVIDIA App's Dynamic frame generation, up to ×3, held ×2.0
/// and ×3.0 and read "DLSS 4 (a ×3.0 frame-generation state)" — Dynamic exists only in DLSS 4.5. Evidence is the
/// profile's Dynamic AND the driver's report that the override applied AND DLSS Frame Generation identified — its
/// factor need not have been counted.
/// </summary>
[Fact]
public void TheNvidiaAppsDynamicFrameGenerationTheDriverAppliedIsDlss45() => InEnglish(() =>
{
const string modules = "{\"sl.interposer.dll\":\"2,14,1,0\",\"1B0_E658700.dll\":\"2,14,16,0\",\"160_E658700.bin\":\"310,9,16,0\",\"nvngx_dlssd.dll\":\"310,9,1,0\"}";
SessionRow phantomBlade = Row(modules, upscaler: "unknown", fgMode: "dlssg", factor: 2.9986416215642575, mix: _upToThreeMix,
words: _dynamicApplied, profile: _dynamicUpToThree);
DlssText.Label(phantomBlade).Should().Be("DLSS 4.5 (Dynamic multi frame generation, set in the NVIDIA App)");
DlssText.Line(phantomBlade).Should().Be("DLSS 4.5 (Dynamic multi frame generation, set in the NVIDIA App) · Ray Reconstruction 310.9.1");
DlssText.ExportLine(phantomBlade).Should().StartWith("generation=DLSS 4.5 basis=dynamic_frame_generation; ");
DlssText.Label(phantomBlade with { NgxDriverWordsJson = _dynamicApplied.Replace("0x263F", "0x63F", StringComparison.Ordinal) })
.Should().Be("DLSS 4 (a ×3.0 frame-generation state)", "a profile set to Dynamic that the driver never reports applying is a setting, not evidence");
DlssText.Label(phantomBlade with { DriverProfileJson = _dynamicUpToThree.Replace("\"Value\":4,", "\"Value\":2,", StringComparison.Ordinal) })
.Should().Be("DLSS 4 (a ×3.0 frame-generation state)", "Fixed is not Dynamic: Witcher 3 under Fixed ×6 still presented ×2.0");
DlssText.Label(phantomBlade with { FgMode = "na", FgFactor = null, FgMixJson = null })
.Should().BeNull("no DLSS Frame Generation was identified");
DlssText.Label(phantomBlade with { FgFactor = null, FgMixJson = null, FgRefusal = "non_uniform" })
.Should().Be("DLSS 4.5 (Dynamic multi frame generation, set in the NVIDIA App)",
"DLSS Frame Generation identified is the evidence; a factor the count refused takes nothing from it");
DlssText.Label(phantomBlade with { NgxDriverWordsJson = null }).Should().Be("DLSS 4 (a ×3.0 frame-generation state)", "no driver report, no evidence");
return 0;
});
[Fact]
public void WitchersLibrariesAreVersionsAndNameNoGenerationAtTimesTwo() => InEnglish(() =>
{
@@ -105,7 +184,8 @@ public sealed class DlssTextTests
DlssText.Label(Row("{\"nvngx_dlss.dll\":\"3.7.10.0\"}", upscaler: "dlss")).Should().Be("DLSS 3 (library 3.7.10)");
DlssText.Label(Row("{\"nvngx_dlss.dll\":\"2.5.1.0\"}", upscaler: "dlss")).Should().Be("DLSS 2 (library 2.5.1)");
DlssText.Line(Row("{\"nvngx_dlss.dll\":\"310.9.1.0\",\"nvngx_dlssnr.dll\":\"1.0.0.0\"}", upscaler: "dlss"))
.Should().Be("DLSS · Super Resolution 310.9.1 · DLSS 5 runtime loaded");
.Should().Be("DLSS · Super Resolution 310.9.1 · Neural Rendering 1.0.0 · DLSS 5 runtime loaded",
"since beta.34 DLSS 5's library is listed like the others; loaded, with nothing measured, it is only loaded");
DlssText.Line(Row("{\"sl.interposer.dll\":\"2,8,0,0\"}", upscaler: "fsr3")).Should().BeNull("no DLSS at all");
DlssText.Line(Row("{broken", upscaler: "dlss")).Should().BeNull("a line that would say only DLSS says nothing the header does not (beta.27)");
DlssText.ExportLine(Row()).Should().Be("N/A");
@@ -317,6 +317,109 @@ public sealed class GamesViewModelTests
vm.HeaderText.Should().EndWith("2");
}
/// <summary>
/// beta.34 (owner request 2026-11-06, "Games stalls 0.5–1.5 s"): the cards are listed before any executable is checked —
/// a sleeping USB drive took a second or more to answer, and no card was shown until every one had — and each card
/// gets its pill when its check answers.
/// </summary>
[Fact]
public async Task TheCardsComeBeforeTheExecutableChecksAndThePillAfter()
{
await using ScratchLedger s = await ScratchLedger.OpenAsync();
_ = await s.GameAsync("Alpha");
_ = await s.GameAsync("Bravo");
var bound = TimeSpan.FromSeconds(30);
using var checking = new ManualResetEventSlim();
using var mayAnswer = new ManualResetEventSlim();
bool Asleep(string path)
{
checking.Set();
_ = mayAnswer.Wait(bound, Ct);
return false;
}
var selection = new GameSelection();
var nav = new NoNavigation();
var vm = new GamesViewModel(s.Library, selection, nav, new AddGameFlow(s.Library, new NoPicker(), selection, nav, new NoStrip()), executableExists: Asleep);
Task load = vm.Pending;
try
{
checking.Wait(bound, Ct).Should().BeTrue("the checks begin once the cards are listed");
vm.Games.Should().HaveCount(2, "the cards are on the page while the drive is still answering");
vm.Games.Should().OnlyContain(static g => !g.NotInstalled, "not known yet, so no pill");
}
finally
{
mayAnswer.Set();
}
await load;
vm.Games.Should().OnlyContain(static g => g.NotInstalled, "the answer came, and each card has its pill");
vm.Games.Should().OnlyContain(static g => g.NotInstalledToolTip != null && g.StatusText.Contains(Strings.Games_Card_NotInstalled, StringComparison.Ordinal));
}
/// <summary>
/// beta.34: the page is kept by its window and shown again on a later visit, so it reads the library again then — what
/// happened while it was away appears — and a read keeps every card that would look the same, so the cards on screen are
/// not built again.
/// </summary>
[Fact]
public async Task APageShownAgainReadsTheLibraryAndKeepsTheCardsThatLookTheSame()
{
await using ScratchLedger s = await ScratchLedger.OpenAsync();
GameRow alpha = await s.GameAsync("Alpha");
_ = await s.GameAsync("Bravo");
var selection = new GameSelection();
var nav = new NoNavigation();
var vm = new GamesViewModel(s.Library, selection, nav, new AddGameFlow(s.Library, new NoPicker(), selection, nav, new NoStrip()));
Task first = vm.Pending;
await first;
vm.Attach();
vm.Pending.Should().BeSameAs(first, "the first Loaded follows the constructor's own read");
GameCardViewModel alphaCard = vm.Games.Single(static g => string.Equals(g.Name, "Alpha", StringComparison.Ordinal));
GameCardViewModel bravoCard = vm.Games.Single(static g => string.Equals(g.Name, "Bravo", StringComparison.Ordinal));
vm.Detach();
_ = await s.GameAsync("Charlie");
_ = await s.SessionAsync(alpha.Id, DateTimeOffset.UtcNow);
vm.Attach();
Task again = vm.Pending;
again.Should().NotBeSameAs(first, "shown again, the page reads the library again");
await again;
vm.Games.Select(static g => g.Name).Should().Equal(["Alpha", "Bravo", "Charlie"]);
vm.HeaderText.Should().EndWith("3");
vm.Games.Single(static g => string.Equals(g.Name, "Bravo", StringComparison.Ordinal)).Should().BeSameAs(bravoCard, "it looks the same, so it is the card on screen");
GameCardViewModel alphaNow = vm.Games.Single(static g => string.Equals(g.Name, "Alpha", StringComparison.Ordinal));
alphaNow.Should().NotBeSameAs(alphaCard, "its session count changed");
alphaNow.SessionCount.Should().Be(1);
}
private static GameRow Row(long id) => new()
{
Id = id,
Name = "G" + id.ToString(CultureInfo.InvariantCulture),
Fingerprint = new() { ExePath = @"C:\Games\g.exe", SizeBytes = 1, MtimeUnixMs = 2 },
HookEnabled = false,
HookCrashCount = 0,
AddedAt = DateTimeOffset.UnixEpoch,
UpdatedAt = DateTimeOffset.UnixEpoch,
};
[Fact]
public void SyncRemovesMovesAndInsertsWithoutClearing()
{
GameCardViewModel[] c = [.. Enumerable.Range(1, 5).Select(static i => new GameCardViewModel(new GameCard(Row(i), null)))];
var shown = new System.Collections.ObjectModel.ObservableCollection<GameCardViewModel>([c[0], c[1], c[2], c[3]]);
int resets = 0;
shown.CollectionChanged += (_, e) => resets += e.Action == System.Collections.Specialized.NotifyCollectionChangedAction.Reset ? 1 : 0;
GamesViewModel.Sync(shown, [c[3], c[0], c[4], c[2]]);
shown.Should().Equal([c[3], c[0], c[4], c[2]]);
resets.Should().Be(0, "never a Reset: the cards that stay keep their elements");
}
[Theory]
[InlineData(1200, 3)]
[InlineData(1248, 4)]
@@ -361,4 +464,50 @@ public sealed class GamesViewModelTests
Strings.Culture = previous;
}
}
/// <summary>
/// beta.34 (owner request 2026-11-06, D85): the library filters by store, engine, state, installed and played; the stores
/// and engines are the ones the library holds; the header counts what is shown of all; Clear filters undoes them.
/// </summary>
[System.Diagnostics.CodeAnalysis.SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format strings are resources that follow the UI culture")]
[Fact]
public async Task TheFiltersNarrowTheLibraryAndTheHeaderCountsWhatIsShown()
{
await using ScratchLedger s = await ScratchLedger.OpenAsync();
GameRow alpha = await s.GameAsync("Alpha");
_ = await s.GameAsync("Bravo");
_ = await s.GameAsync("Charlie");
_ = await s.SessionAsync(alpha.Id, DateTimeOffset.UtcNow);
var selection = new GameSelection();
var nav = new NoNavigation();
var vm = new GamesViewModel(s.Library, selection, nav, new AddGameFlow(s.Library, new NoPicker(), selection, nav, new NoStrip()),
executableExists: p => !p.Contains("Charlie", StringComparison.OrdinalIgnoreCase));
Task load = vm.Pending;
await load;
vm.Stores.Should().NotBeEmpty();
vm.Stores[0].Value.Should().Be(GamesViewModel.AnyToken);
vm.Engines[0].Value.Should().Be(GamesViewModel.AnyToken);
vm.IsFiltered.Should().BeFalse();
vm.HeaderText.Should().EndWith("3");
vm.PlayedFilter = YesNoFilter.Yes;
vm.Games.Select(static g => g.Name).Should().Equal(["Alpha"]);
vm.IsFiltered.Should().BeTrue();
vm.HeaderText.Should().Be(string.Format(CultureInfo.CurrentCulture, Strings.Games_Header_Filtered_Format, 1, 3));
vm.PlayedFilter = YesNoFilter.No;
vm.InstalledFilter = YesNoFilter.No;
vm.Games.Select(static g => g.Name).Should().Equal(["Charlie"], "never played, and its executable is not on disk");
vm.InstalledFilter = YesNoFilter.All;
vm.StateFilter = GamesStateFilter.HookingOn;
vm.Games.Should().BeEmpty("hooking is off for every scratch entry");
vm.NoMatch.Should().BeTrue();
vm.ClearFiltersCommand.Execute(null);
vm.Games.Should().HaveCount(3);
vm.IsFiltered.Should().BeFalse();
vm.HeaderText.Should().EndWith("3");
}
}
@@ -713,4 +713,27 @@ public sealed partial class PagesLoadTests
seen.Windows.Should().Be(2);
seen.AfterClose.Should().Equal([first], "a closed window is forgotten, and the next open builds a new one");
}
/// <summary>
/// beta.34 (owner request 2026-11-06, D86): the selected page keeps its name in the pane. WPF UI's LeftFluent template
/// animates the label to height 0 when an item becomes active; ours is the same template without that.
/// </summary>
[Fact]
public async Task TheSelectedPaneItemKeepsItsLabel()
{
(double Height, double Opacity, double LabelHeight) seen = await OnStaAsync(() =>
{
var template = (System.Windows.Controls.ControlTemplate)System.Windows.Application.Current.FindResource("FlLeftFluentNavigationViewItemTemplate");
var item = new Wpf.Ui.Controls.NavigationViewItem { Content = "Compare", Template = template };
item.SetValue(Wpf.Ui.Controls.NavigationViewItem.IsActiveProperty, true);
Render(item);
var grid = (FrameworkElement)template.FindName("ContentGrid", item);
var label = (FrameworkElement)template.FindName("ElementContentPresenter", item);
return (grid.ActualHeight, grid.Opacity, label.ActualHeight);
});
seen.Height.Should().BeGreaterThan(0, "the label's row keeps its height while the item is selected");
seen.Opacity.Should().Be(1);
seen.LabelHeight.Should().BeGreaterThan(0);
}
}
@@ -0,0 +1,64 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using FluentAssertions;
using FrameLedger.App.Pages;
using FrameLedger.App.Services;
using Microsoft.Extensions.DependencyInjection;
using Wpf.Ui.Abstractions;
namespace FrameLedger.App.Tests;
/// <summary>
/// beta.34 (owner request 2026-11-06): the library page is kept by the window that built it and shown again on a later
/// visit; every other page is the container's, new each visit; a new window — a language change — builds its own.
/// And the shell opens a rebuilt window on the page that was on screen, however it was reached.
/// </summary>
public sealed class WindowPageCacheTests
{
private sealed class NewEachTime : INavigationViewPageProvider
{
public int Built { get; private set; }
public object? GetPage(Type pageType)
{
Built++;
return new object();
}
}
[Fact]
public void TheLibraryIsKeptByItsWindowAndEveryOtherPageIsNewEachVisit()
{
var container = new NewEachTime();
var window = new WindowPageCache(container);
object games = window.GetPage(typeof(GamesPage))!;
window.GetPage(typeof(GamesPage)).Should().BeSameAs(games, "shown again, it is the page already built");
window.GetPage(typeof(DashboardPage)).Should().NotBeSameAs(window.GetPage(typeof(DashboardPage)), "transient, as before");
container.Built.Should().Be(3);
new WindowPageCache(container).GetPage(typeof(GamesPage)).Should().NotBeSameAs(games,
"a rebuilt window builds its own, in its own language, and never shares one page between two windows");
WindowPageCache.Kept.Should().BeEquivalentTo([typeof(GamesPage)]);
FluentActions.Invoking(() => window.GetPage(null!)).Should().Throw<ArgumentNullException>();
}
[Fact]
public void ARebuildOpensOnThePageOnScreenHoweverItWasReached()
{
var shell = new ShellHost(new ServiceCollection().BuildServiceProvider(), null!, null!, new WindowClosePolicy());
shell.Page.Should().Be<DashboardPage>();
shell.Remember(typeof(GameDetailPage));
shell.NoteShown(live: true, page: new SettingsPageStandIn());
shell.Page.Should().Be<SettingsPageStandIn>("a page reached by the pane is remembered too");
shell.NoteShown(live: false, page: new object());
shell.Page.Should().Be<SettingsPageStandIn>("the closing window of a rebuild changes nothing");
shell.NoteShown(live: true, page: null);
shell.Page.Should().Be<SettingsPageStandIn>();
}
private sealed class SettingsPageStandIn;
}
@@ -40,7 +40,7 @@ public sealed class RuntimeModuleSourcesTests
RuntimeModuleSources.Token(RuntimeModuleSource.Unknown).Should().BeNull();
RuntimeModuleSources.FromToken("cloud").Should().Be(RuntimeModuleSource.Unknown);
CensusNames.ModuleFileNames.Should().Contain(["nvngx_dlssnr.dll", "sl.dlss_d.dll", "sl.common.dll", "sl.reflex.dll", "amd_fidelityfx_loader_dx12.dll"],
CensusNames.ModuleFileNames.Should().Contain(["nvngx_dlssnr.dll", "sl.dlss_nr.dll", "sl.dlss_d.dll", "sl.common.dll", "sl.reflex.dll", "amd_fidelityfx_loader_dx12.dll"],
"the snapshot records them though the census has no bit");
}
}
@@ -303,6 +303,33 @@ public sealed class SessionAggregatorTests
row.Upscaler.Should().Be("unknown", "a hook ran and could not identify what it saw: coverage short, not N/A");
}
/// <summary>
/// beta.34, owner decision D84: DLSS 5's neural rendering is stored as its share of the Streamline batches — and only
/// from a writer whose detour decodes it (<see cref="FlHookFamily.SlNeuralRendering"/>). An Overlay built before it
/// drains the same batches and never sets the bit; storing its silence as 0 % would be a measured "not running" nobody
/// measured.
/// </summary>
[Fact]
public void NeuralRenderingIsAShareOfTheBatchesOnlyFromAWriterThatDecodesIt()
{
List<FlFrameRecord> records = SessionFixtures.Stream(400, _presentOnly | FlMeasured.Upscaler);
for (int i = 0; i < records.Count; i++)
{
FlFrameRecord r = records[i];
r.FeatureFlags = (byte)(FlFeatureFlags.RayReconstructionObserved | (i % 4 == 0 ? FlFeatureFlags.None : FlFeatureFlags.SlNeuralRendering));
records[i] = r;
}
const uint decodes = (uint)(FlHookFamily.Present | FlHookFamily.UpscalerIdentity | FlHookFamily.SlNeuralRendering);
SessionRow row = SessionAggregator.Aggregate(SessionFixtures.Skeleton(),
SessionFixtures.Hooked(records, new FlWriterState { Status = 1, HooksInstalledMask = decodes })).Row;
row.DlssNrPct.Should().BeApproximately(75, 0.01);
SessionRow older = SessionAggregator.Aggregate(SessionFixtures.Skeleton(),
SessionFixtures.Hooked(records, new FlWriterState { Status = 1, HooksInstalledMask = decodes & ~(uint)FlHookFamily.SlNeuralRendering })).Row;
older.DlssNrPct.Should().BeNull("a writer built before it could look says nothing, never 0 %");
}
[Fact]
public void RayTracingVramLatencyAndSensorsAggregateWhereMeasured()
{
@@ -41,6 +41,7 @@ public sealed class SlCensusTests
c.Batches.Should().Be(20);
c.WithUndecoded.Should().Be(20, "the undecoded fact must survive co-occurring with a count");
c.WithNeuralRendering.Should().Be(0, "no record carried DLSS 5's fact");
c.WithFrameGeneration.Should().Be(20);
c.FgWithoutSuperResolution.Should().Be(20, "this is §S30's exact shape");
}
@@ -37,6 +37,43 @@ public sealed class DlssGenerationTests
"the driver's override can run a newer model than the game's library");
}
/// <summary>
/// beta.34, owner decision D83: the NVIDIA App's Dynamic frame generation exists only in DLSS 4.5, so a session the
/// driver reports running it is DLSS 4.5 whatever multiplier it settled on — the owner's Phantom Blade Zero under
/// "up to ×3" held ×2.0 and ×3.0 and read DLSS 4 until then. A measured ×5 or more stays the stronger evidence.
/// </summary>
[Fact]
public void DynamicFrameGenerationIsDlss45BelowAMeasuredTimesFiveAndAboveEveryDlss4Row()
{
DlssGeneration.Of(new DlssEvidence(null, _dlss4Library, null, 3.0, DynamicFrameGeneration: true))
.Should().Be(new DlssGeneration(DlssGenerationKind.Dlss45, DlssBasis.DynamicFrameGeneration), "Phantom Blade Zero under up to ×3");
DlssGeneration.Of(new DlssEvidence(_dlss4Library, _dlss4Library, 11, 2.0, DynamicFrameGeneration: true))
.Should().Be(new DlssGeneration(DlssGenerationKind.Dlss45, DlssBasis.DynamicFrameGeneration), "above a DLSS 4 preset");
DlssGeneration.Of(new DlssEvidence(null, _dlss4Library, null, 6.0, DynamicFrameGeneration: true))
.Should().Be(new DlssGeneration(DlssGenerationKind.Dlss45, DlssBasis.FrameGenerationFactor), "a measured ×6 is the stronger evidence");
DlssGeneration.Of(new DlssEvidence(_dlss4Library, null, 12, 3.0, DynamicFrameGeneration: true))
.Should().Be(new DlssGeneration(DlssGenerationKind.Dlss45, DlssBasis.Preset));
DlssGeneration.Of(new DlssEvidence(null, _dlss4Library, null, 3.0))
.Should().Be(new DlssGeneration(DlssGenerationKind.Dlss4, DlssBasis.FrameGenerationFactor), "without Dynamic a ×3 state is DLSS 4's");
}
/// <summary>
/// beta.34, owner decision D84: DLSS 5 heads the table where its neural rendering was measured running, above every
/// other row — the session's other DLSS features are the libraries the line lists after it. Measured not running, or
/// not measurable, it names nothing.
/// </summary>
[Fact]
public void Dlss5IsTheGenerationWhereItsNeuralRenderingRanAndNowhereElse()
{
DlssGeneration.Of(new DlssEvidence(_dlss4Library, _dlss4Library, 12, 6.0, DynamicFrameGeneration: true, NeuralRenderingPct: 97.3))
.Should().Be(new DlssGeneration(DlssGenerationKind.Dlss5, DlssBasis.NeuralRendering), "it outranks every DLSS 4.5 row");
DlssGeneration.Of(new DlssEvidence(_dlss4Library, _dlss4Library, null, null, NeuralRenderingPct: 0.4))
.Should().Be(new DlssGeneration(DlssGenerationKind.Dlss5, DlssBasis.NeuralRendering), "running on any frame is running");
DlssGeneration.Of(new DlssEvidence(_dlss4Library, _dlss4Library, null, null, NeuralRenderingPct: 0)).Should().BeNull("seen not running");
DlssGeneration.Of(new DlssEvidence(_dlss4Library, _dlss4Library, 12, null, NeuralRenderingPct: 0))
.Should().Be(new DlssGeneration(DlssGenerationKind.Dlss45, DlssBasis.Preset), "without it, the rest of the table speaks");
}
[Fact]
public void ALibraryVersionNamesAGenerationOnlyWhereItsMajorNumberDoes()
{
@@ -0,0 +1,33 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using FluentAssertions;
using FrameLedger.Domain.Metrics;
using static FrameLedger.Domain.Tests.Metrics.SampleFixtures;
namespace FrameLedger.Domain.Tests.Metrics;
/// <summary>
/// beta.34, owner decision D84: DLSS 5's neural rendering, as the share of the presents that drained a Streamline batch —
/// the frames the game rendered through Streamline — on which <c>kFeatureDLSS_NR</c> was evaluated.
/// </summary>
public sealed class NeuralRenderingTests
{
[Fact]
public void TheShareIsOverTheBatchesAndNothingDrainedIsNoShare()
{
FrameSample plain = Present(1);
FrameSample batch = plain with { Features = FeatureBits.RayReconstructionObserved };
FrameSample neural = plain with { Features = FeatureBits.RayReconstructionObserved | FeatureBits.SlNeuralRendering };
NeuralRendering.SharePct([plain, plain]).Should().BeNull("no present drained a Streamline batch: silence says nothing");
NeuralRendering.SharePct([]).Should().BeNull();
NeuralRendering.SharePct([batch, batch, plain]).Should().Be(0, "Streamline batches, and none evaluated neural rendering");
NeuralRendering.SharePct([neural, neural, neural, batch]).Should().Be(75);
NeuralRendering.SharePct([neural, plain, neural, plain, neural, plain]).Should().Be(100,
"a generated present drains no batch, so frame generation does not dilute the share");
NeuralRendering.SharePct([plain with { Features = FeatureBits.SlNeuralRendering }]).Should().BeNull(
"the fact without its OBSERVED says nothing");
FluentActions.Invoking(static () => NeuralRendering.SharePct(null!)).Should().Throw<ArgumentNullException>();
}
}
@@ -159,6 +159,8 @@ public sealed class XboxLibrarySourceTests : IDisposable
files.Cover.Should().BeNull("a GDK package ships no portrait cover");
XboxArtCache.Image(content, @"..\..\outside.png").Should().BeNull("a name that escapes the package is not the package's picture");
XboxArtCache.Image(content, @"C:\Windows\System32\shell32.dll").Should().BeNull();
XboxArtCache.Image(content, @"Resources\a:b.png").Should().BeNull("a file's stream is not a picture, and its scale search threw (beta.34)");
XboxArtCache.Image(content, @"Resources\Square480x480Logo.png:Zone.Identifier").Should().BeNull();
}
/// <summary>
@@ -304,6 +304,45 @@ public sealed class LedgerDatabaseTests
}
}
/// <summary>
/// Schema 0022 (2026-11-06, beta.34, D84): <c>sessions.dlss_nr_pct</c>, DLSS 5's neural rendering measured — ADD COLUMN
/// only; a session written before has none, and is not rebuilt (its frames keep no feature byte).
/// </summary>
[Fact]
public async Task ScriptTwentyTwoAddsTheNeuralRenderingColumnAndAnEarlierSessionHasNone()
{
await using LedgerFixture f = await LedgerFixture.OpenAsync();
MigrationRunner.LatestVersion.Should().BeGreaterThanOrEqualTo(22);
long gameId = (await new SqliteGameRepository(f.Db).EnsureAsync(
new() { ExePath = @"C:\Games\H\h.exe", SizeBytes = 1, MtimeUnixMs = 2 }, "H", Ct).ConfigureAwait(true)).Id;
long snapshotId = await new SqliteHardwareSnapshotRepository(f.Db).EnsureAsync(new HardwareSnapshot { GpuName = "g" }, DateTimeOffset.UnixEpoch, Ct)
.ConfigureAwait(true);
string path = f.Path;
await f.Db.DisposeAsync().ConfigureAwait(true);
var c21 = new SqliteConnection(new SqliteConnectionStringBuilder { DataSource = path, Pooling = false }.ToString());
await using (c21.ConfigureAwait(true))
{
await c21.OpenAsync(Ct).ConfigureAwait(true);
await RewindToAsync(c21, 21).ConfigureAwait(true);
await c21.ExecuteAsync(new CommandDefinition(
"INSERT INTO sessions (session_guid, game_id, snapshot_id, started_at, ended_at, duration_s, qpc_epoch, qpc_frequency, capture_tier, capture_mode, exit_status, frame_count, app_frame_count, displayed_frame_count, dropped_frames, runtime_modules) "
+ "VALUES ('00000000-0000-0000-0000-000000000022', @gameId, @snapshotId, 0, 60000, 60, 0, 10000000, 1, 'attach', 'normal', 6000, 6000, 6000, 0, '{\"nvngx_dlssnr.dll\":\"310,9,16,0\"}')",
new { gameId, snapshotId }, cancellationToken: Ct)).ConfigureAwait(true);
}
LedgerDatabase migrated = await LedgerDatabase.OpenAsync(path, ct: Ct).ConfigureAwait(true);
await using (migrated.ConfigureAwait(true))
{
migrated.SchemaVersion.Should().Be(MigrationRunner.LatestVersion);
IReadOnlyList<string> added = await migrated.ReadAsync(async (c, ct) => (IReadOnlyList<string>)[.. await c.QueryAsync<string>(new CommandDefinition(
"SELECT name FROM pragma_table_info('sessions') WHERE name = 'dlss_nr_pct' AND type = 'REAL'", cancellationToken: ct)).ConfigureAwait(false)], Ct).ConfigureAwait(true);
added.Should().ContainSingle();
SessionRow before = (await new SqliteSessionRepository(migrated).FindAsync(Guid.Parse("00000000-0000-0000-0000-000000000022"), Ct).ConfigureAwait(true))!;
before.RuntimeModulesJson.Should().Be("{\"nvngx_dlssnr.dll\":\"310,9,16,0\"}", "the row keeps everything it had");
before.DlssNrPct.Should().BeNull("a session recorded before beta.34 says only that DLSS 5's runtime was loaded");
}
}
/// <summary>
/// Schema 0017 (2026-10-03, beta.11, D38): <c>games.ac_exception_trial_failed_at</c>, NULL on every row written before — a
/// grant made under D33 keeps everything it had and carries no failed trial.
@@ -108,6 +108,7 @@ public sealed class SqliteSessionRepositoryTests
ThermalLimitPct = 2.5,
AppFramesPerJoule = 0.3125,
RuntimeModuleSourcesJson = "{\"nvngx_dlss.dll\":\"graphics_driver\"}",
DlssNrPct = 97.25,
FgMixJson = "{\"Rows\":[{\"Kind\":\"generated\",\"Factor\":3.99,\"NativeFps\":70.5,\"DisplayedFps\":281.3,\"Seconds\":120,\"Share\":0.75,\"Windows\":24}]}",
};
+1 -1
View File
@@ -1 +1 @@
{ "engine": null, "platform": null, "capabilities": ["dlss", "dlss_g", "dlss_rr", "streamline"], "$why": "Every capability matches independently - there is no precedence here, unlike engines, because a game ships several." }
{ "engine": null, "platform": null, "capabilities": ["dlss", "dlss_g", "dlss_rr", "dlss_nr", "streamline"], "$why": "Every capability matches independently - there is no precedence here, unlike engines, because a game ships several." }
Whitespace-only changes.
+3 -1
View File
@@ -7,7 +7,9 @@ WPF UI 4.3.0 (pinned), CommunityToolkit.Mvvm, ScottPlot for charts and Markdig f
## How it is put together
- A .NET Generic Host with dependency injection. Pages and their view models are transient — a page is made again on
every navigation, so state lives in the view models' services and the database, never in a page. A view model that
every navigation, so state lives in the view models' services and the database, never in a page. The one exception
(beta.34): the window keeps the library page it built (`WindowPageCache`) and the page reads the library again each
time it is shown. A view model that
listens to a service attaches on its page's Loaded and detaches on Unloaded, and is never `IDisposable`: the container
keeps every transient disposable it makes until the App exits.
- The ledger's reads run on the thread that calls them (Microsoft.Data.Sqlite completes its asynchronous calls