Compare commits

..
Author SHA1 Message Date
poli0981andClaude Opus 5.5 59dc22637d release: 0.1.0-beta.35 - its changelog file (accessibility: the statement, a screen reader's names and announcements, headings and charts, contrast themes, focus), HANDOFF's beta.35 section (D88-D92), owner-only item 32, the release lines (beta.35 PR-7)
docs/changelog/0.1.0-beta.35.md takes [Unreleased] as it stood (#366-#371) under a
summary and the update paragraph: the legal texts keep their versions, schema 22
and rules 2026.11.2 unchanged. HANDOFF's beta.34 START HERE (with its alpha.3
lines) moves verbatim to docs/handoff/history/0.1.0-beta.34.md with its row; the
new START HERE carries D88-D92, the choices, what was measured and the traps (a
ContentDialog test needs the dispatcher's context, a static event hears every
test's, WPF UI's throwing brushes fall back to the Fluent fills inside the App, a
resource reference's callback runs on an equal value, a forward StaticResource
fails only when used, Python's "\b", RenderTargetBitmap's offset); owner-only item
32 is beta.35 on real hardware; D88-D92's rows, and D82's and D87's rows now point
at the history files they moved to. README, ACCURACY, the Disclaimer's accuracy
block and LIMITATIONS name 0.1.0-beta.35; ACCESSIBILITY.md's checks paragraph
rewrapped.

No alpha with this release (D92): alpha.4 moves the alpha line to .NET 11's
release as a task of its own.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 13:15:56 +07:00
poli0981andClaude Opus 5.5 731f6d3082 feat: focus and motion - Ctrl+1 to 5 put the keyboard in the page they open and say its title, a message box is owned by the window it opens over, and pages slide in only while Windows animates (beta.35 PR-6) (#371)
* feat: focus and motion - Ctrl+1 to 5 put the keyboard in the page they open and say its title, a message box is owned by the window it opens over, and pages slide in only while Windows animates (beta.35 PR-6)

PageFocus: after a page shortcut the page shown takes the focus once laid out (its first
control) and its first-level heading is announced; the shell tells it each page shown
from NavigationView.Navigated. PageMotion: the NavigationView's Transition is None while
SystemParameters.ClientAreaAnimation is off, followed as it changes (WPF UI 4.3.0 played
FadeInWithSlide whatever it was). MessageBoxes: WPF UI's MessageBox sets no owner
(measured: null before and after it is shown), so every box is owned by the App's
active window - six call sites, and a scan holds it.

Measured, and left alone: a ContentDialog already gives the focus back to its opener
(WPF UI's ContentDialogHostController stores and restores it); a test pins it. A first
measurement said otherwise because it ran with no dispatcher context, where the
dialog's own finally never resumed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(native): the tiny ring's case retries until one attempt both overlapped the writer and was lapped by it - CI's single attempt kept up with all 200000 records (beta.35 PR-6)

ci.yml's check on #371 failed in fl_ring, "a tiny ring, so the writer laps the
reader constantly": attempts 1, most overlapped drains 167058, dropped 0. The loop
repeated an attempt only when it had not overlapped the writer (#308); an attempt
that overlapped and was never lapped ended it, and CHECK(dropped > 0) failed. Both
now hold in the same attempt, the last, repeated up to kMaxAttempts (8): a reader
that never counts a drop still fails every attempt. 40 local runs of the case and
the native suite (32/32) pass; nothing outside the test changes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 06:11:02 +00:00
poli0981andClaude Opus 5.5 cea7d87ff8 feat: Windows contrast themes followed - every colour the theme's own, the accent its highlight, the charts in its colours; and the title bar, the snackbars and a Danger button read (D91) (beta.35 PR-5) (#370)
* feat: Windows contrast themes followed - every colour the theme's own, by role from WPF UI's four contrast files, the accent its highlight and the highlight's text, the charts in its colours, the Remove button its own button, on and off at once (D91) (beta.35 PR-5)

While SystemParameters.HighContrast is on, the light or the dark Fluent theme (as the
contrast theme is) lies under Services/ContrastOverlay: every key of WPF UI 4.3.0's HC1,
HC2, HCBlack and HCWhite in the user's own SystemColors colour for its role
(Services/ContrastRoles: the colour a key has in all four, opaque colours only; ties and
placeholders by name), the transparent keys transparent, the 21 accent keys as the
highlight and the text on the accent as the highlight's text. No Mica, no
SystemThemeWatcher (it would apply WPF UI's files: 84 of 97 colours a red placeholder,
17 brushes that throw). A switch, an edit or turning it off is followed at once.

What the App draws itself reads ContrastTheme.Active: ChartPalette.ForContrast,
ChartTheme.TextOn, the artwork band, the Import list, the update footer. The Remove
button takes the DangerButton style (WPF UI's Danger is a fixed #F44336). Settings >
Theme says a contrast theme is in use.

Red first: the sweep under four default and two edited themes found the chips at
1.26-1.78:1, the Remove button at 3.06-4.42:1, the badges' black, and the pressed
menu item white on white.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix: what no sweep rendered reads - the agent's pill on the theme's own fills, every snackbar in the theme's colours, a Danger button's dark text on its red and the theme's own button under a contrast theme (beta.35 PR-5)

Measured 2026-11-09 against WPF UI 4.3.0's styles, outside any surface the sweeps render:
the title bar's agent pill was a ui:Badge with a bound palette appearance (light theme
2.78, 2.63, 2.16 and 3.68:1), the Success and Caution snackbars white on fixed green and
orange (2.78 and 2.16:1 in both themes), and a Danger button white on #F44336 in the dark
theme (3.68:1), out of any contrast theme's reach.

AgentPill (a Pill on the theme's success, caution and critical fills), the strip's
messages all Secondary, and an implicit ui:Button style: a Danger button's text is
TextFillColorDarkPrimaryBrush (5.3 and 5.7:1), and the theme's own button while a
contrast theme is on, message boxes included. The DangerButton style of the first
commit is gone; a bound badge appearance and the other five button appearances are
refused.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 05:46:12 +00:00
poli0981andClaude Opus 5.5 54a2c08601 feat: headings and charts a screen reader can use - page and section headings, every chart named with where its numbers are, its keys kept, a double-click that shows all of it, no series told apart by colour alone (D90) (beta.35 PR-4) (#369)
Every Title is AutomationProperties.HeadingLevel Level1 and every section Subtitle Level2; a Subtitle that shows
a value says None. AccessibilityTests holds every Title and Subtitle to a declared level, PagesLoadTests every
page to one first-level heading.

Every plot is Charts/ChartPlot, ScottPlot's WpfPlot with a peer: an Image of the localized type "chart", named
and with help text saying where its numbers are and which keys move it, focus drawn with WPF UI's focus style.
Charts/ChartKeys keeps the arrows and A with the chart after ScottPlot has acted (the page used to scroll or move
the focus on); a double-click shows all of the chart, as the guide said, instead of ScottPlot's benchmark overlay.
Charts/ChartPatterns gives every series a line pattern, marker or hatch by its index - Compare's five sessions,
the GPU temperature and hot spot, the two stutters, the two lows, the two limits - and
NoChartTellsTwoSeriesApartByColourAlone reads every chart's legend for two entries that differ by colour only.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 04:52:30 +00:00
poli0981andClaude Opus 5.5 926580c0f2 feat: a screen reader is told what appears - safety notices, the agent's and the update's banners, every short message, a game page's notice and each maintenance result, through UI Automation's notification (D89) (beta.35 PR-3) (#368)
Services/IAnnouncer over Services/UiaAnnouncer, the one place the App raises UI Automation's notification event:
only on its active window (a game that has the screen is never interrupted) and only when a screen reader listens.
An Alert (every one read): a safety notice as it arrives, a warning in the strip, the agent going offline, a game
page's refusal. A Status (a newer one replacing one not yet read): the strip's info and success, the agent back, an
update's step, a page's success, every Database maintenance result.

Every transient message goes through IMessageStrip now - MainWindowViewModel's six direct ISnackbarService calls
moved to it - and SnackbarStrip says what it shows. Services/ShellAnnouncements says only a change: the first state
is read with the window, a download's percent ticks are one step, a rebuilt window says nothing. The maintenance
line's LiveSetting, which announced nothing, is gone; no XAML may set one.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 04:36:48 +00:00
poli0981andClaude Opus 5.5 0b485d1293 feat: what a screen reader is given - every item, cell and row button named by what it shows, the display-only controls with a voice, the notices' text reachable, no silent Tab stop (D88) (beta.35 PR-2) (#367)
PagesLoadTests.Automation sweeps the UI Automation tree WPF builds for every page, window, dialog and control,
every tab shown: no Tab stop without a peer, no item named by its type, every focusable control named, no shown
text hidden in a template, no two buttons in a list sharing a name. All five went red on main first.

Fixes: every list item type speaks through ToString (Services/SpokenText) - Choice its label, a notice its title
and text, a document page its title, a session row its date, length and tier; FpsReadout, TriStateChip and
ChangeBadge get SpokenTextAutomationPeer (a Text element, no children) and leave the tab order, and the readout
says rule 6 aloud (Native, displayed and the factor together); a template column names its cells through
Controls/CellName over WPF UI's DefaultDataGridCellStyle, an empty cell read as "empty"; a row's button names its
row; the App's InfoBar template draws title and message through ContentPresenters; implicit styles take
ItemsControl, ui:Image and ui:CardControl out of the tab order; a CardExpander's expand button is named after its
header (Controls/ExpanderToggleName); the dialog hosts are no Tab stops. ScreenReaderNamesTests holds each piece.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 04:16:02 +00:00
poli0981andClaude Opus 5.5 fad7b84075 feat: the accessibility statement - ACCESSIBILITY.md under Help > Accessibility and on the wiki, the Accessibility problem form and its label, the documents corrected (D88) (beta.35 PR-1) (#366)
ACCESSIBILITY.md states WCAG 2.2 AA through WCAG2ICT as a goal and never a claim, what works with the keyboard
alone, a screen reader, a contrast theme or Magnifier, how it is checked (the owner's pass of 2026-11-09 on
beta.34 and alpha.3), the known limits with what to do instead, and how a barrier is reported and handled - by
severity, no promised times. Embedded and shown under Help > Accessibility and after Limitations in the guide's
window; a wiki page of its own.

The Accessibility problem issue form, a user-interface section in the PR template, and the labels accessibility,
safety and priority-high - the last two named by the Safety gap form since 2026-08-02 and never existing.

Documents corrected: charts take focus and ScottPlot's keys (ChartKeyboardTests measures it; 08_UI said
neither); the database-maintenance live region announces nothing; the Narrator gap is the owner's pass now;
20_OPEN_QUESTIONS G's accessibility row closed; NFR-9 widened (D88-D91); LIMITATIONS gains an Accessibility
section and loses its one struck sentence, which a screen reader reads as current.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 03:51:44 +00:00
dependabot[bot] 4cc4c3e9c2 Bump the minor-and-patch group with 1 update (#365)
Bumps Meziantou.Analyzer from 3.0.317 to 3.0.319

---
updated-dependencies:
- dependency-name: Meziantou.Analyzer
  dependency-version: 3.0.319
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: minor-and-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-11-09 07:03:16 +07:00
poli0981andClaude Opus 5.5 27f537a2d7 docs: 0.1.0-alpha.3's notes - its changelog file opening with the experimental-build warning, its row, HANDOFF's alpha.3 lines, owner-only item 31 (D87) (alpha.3 PR-1) (#363)
The third alpha is the source of 0.1.0-beta.34 on .NET 11 RC3 (D87: right after
beta.34, 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.3.md: the experimental-build warning, the update
  from alpha.2 (the ledger copy, the Disclaimer 2.13 and the Privacy Policy 2.14
  once, the Alpha notice's box again, schema 22 - which an alpha.2 cannot open),
  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.3" lines (the sync by a merge
  commit, the switch unchanged, the first alpha whose ledger moves) and
  owner-only item 31, the third 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-06 09:51:02 +00:00
poli0981andClaude Opus 5.5 44c031faca 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) (#362)
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 09:34:30 +00: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
219 changed files with 8244 additions and 493 deletions

No files matched your search

+100
View File
@@ -0,0 +1,100 @@
# ACCESSIBILITY.md (beta.35, D88) sends every accessibility barrier here. It is its own form rather than part of the bug
# report because a barrier needs different facts: what the reporter uses to read or operate the screen, and how far it
# stops them. Nothing here asks about the reporter themself.
name: Accessibility problem
description: Something in FrameLedger cannot be reached, read or seen — with the keyboard, a screen reader, a contrast theme, Magnifier or another aid
labels: [accessibility]
body:
- type: markdown
attributes:
value: |
Thank you for telling us. **You never need to tell us anything about yourself or a disability** — what you use
and what happened is enough. Screenshots and recordings help but are optional.
If FrameLedger refused to hook a game, stopped measuring or turned hooking off **without your knowing** — a
safety notice you could not perceive — say so below: it is a safety problem too, and it is handled first.
What FrameLedger aims for and what it cannot do yet: [ACCESSIBILITY.md](https://github.com/poli0981/frameledger/blob/main/ACCESSIBILITY.md).
- type: textarea
id: task
attributes:
label: What were you trying to do?
placeholder: 'e.g. switch hooking on for a game, read a session''s frame rate, answer the terms window'
validations:
required: true
- type: textarea
id: what-happened
attributes:
label: What happened instead?
description: What you heard, saw or could not do — and what you expected.
validations:
required: true
- type: textarea
id: steps
attributes:
label: How to get there
placeholder: |
1. Open Games (Ctrl+2)
2. Tab to …
3. …
- type: input
id: app-version
attributes:
label: FrameLedger version
description: Help ▸ About
validations:
required: true
- type: input
id: os
attributes:
label: Windows version
placeholder: 'Windows 11 26100.2314'
validations:
required: true
- type: dropdown
id: aid
attributes:
label: What do you use?
multiple: true
options:
- Keyboard only
- Narrator
- NVDA
- JAWS
- Windows Magnifier
- A Windows contrast theme
- Voice Access or other speech input
- Display scaling or a large text size
- Something else (say below)
validations:
required: true
- type: input
id: aid-version
attributes:
label: Its version, if you know it
placeholder: 'e.g. NVDA 2026.1'
- type: dropdown
id: severity
attributes:
label: How much does it stop you?
description: Optional — the maintainer sets it when reading the report (ACCESSIBILITY.md, How serious it is).
options:
- Not sure
- Critical — I cannot do the task at all
- Serious — only with great difficulty or a workaround
- Moderate — it is tiring or inconsistent
- Minor — it barely gets in the way
- type: textarea
id: more
attributes:
label: Anything else
description: A screenshot, a recording, or a diagnostic file from Help ▸ Report a bug (built on your PC; you choose what to attach).
+12
View File
@@ -30,6 +30,18 @@ review questions from `docs/19_SAFETY_AND_ANTICHEAT.md` §Review checklist.
**Measured overhead:** <!-- e.g. "0.31 µs/present, game Avg FPS delta -0.2%" -->
## User-interface changes only
Skip this section if the PR does not change what the App shows. Otherwise — `ACCESSIBILITY.md` §For contributors,
`docs/08_UI.md` §Accessibility:
- [ ] Every control that shows no text of its own has a name, from `.resx` in `en`, `vi` and `ja`
- [ ] Colours come from the theme only, and nothing is shown by colour alone
- [ ] Everything new can be reached and used with the keyboard, in reading order, and Esc leaves a new dialog
- [ ] `ACCESSIBILITY.md` (and `LIMITATIONS.md`) changed in this PR if what works or what does not moved
**Checked by hand:** <!-- e.g. "Tab through the new card with the mouse unplugged; Narrator reads its name and value" -->
## Safety-string changes only
- [ ] `Safety_*` resx keys have human-reviewed `ja` (never machine-drafted — `docs/09_I18N.md`)
+1 -1
View File
@@ -1,5 +1,5 @@
# The GitHub Wiki is a copy of the repository's own pages (D53/D54, the owner, 2026-10-07): wiki/ (Home, the sidebar,
# the developer pages) and guide/ (the user guide, which is the End-user part) with LIMITATIONS.md, assembled and checked
# the developer pages) and guide/ (the user guide, which is the End-user part) with LIMITATIONS.md and ACCESSIBILITY.md, assembled and checked
# by tools/wiki-build.ps1 - the check build.ps1 runs as `wiki-check`. A page edited on the Wiki tab is overwritten here;
# edit wiki/ or guide/ instead (docs/13_CI_CD.md §wiki.yml).
#
+168
View File
@@ -0,0 +1,168 @@
# Accessibility
FrameLedger should be usable by everyone who plays games on a Windows PC — with a keyboard alone, with a screen reader,
with a Windows contrast theme or Magnifier, and without telling colours apart. This page says what FrameLedger aims
for, what works today, how that was checked, what does not work yet and what to do instead, and how to tell us about a
barrier. It is written for the person who has just met one; the details for developers are in
[`docs/08_UI.md`](docs/08_UI.md#accessibility).
FrameLedger is a desktop program: its own window, its dialogs, its document windows, the icon by the clock and the
notices Windows shows for it. It draws nothing inside a game, so it cannot make a game itself any easier to use.
*Beta software: this page describes version 0.1.0-beta.35. In the app: Help ▸ Accessibility.*
## What FrameLedger aims for
- **WCAG 2.2 at level AA**, applied to desktop software as W3C's
[WCAG2ICT](https://www.w3.org/TR/wcag2ict-22/) guidance explains. This is a goal that guides the work, not a claim:
no formal evaluation has been made, and FrameLedger does not say it conforms to any standard.
- **Every task can be done with the keyboard alone.**
- **A screen reader can read every control and every value**, in the language FrameLedger is shown in, and hears what
changes — a notice, a result.
- **Text and controls keep their contrast** in the light and the dark theme and under Windows contrast themes, and
**colour is never the only way something is shown.**
- **Everything stays sharp at any display scale**, and when the window moves between screens.
## What works today
### The keyboard
| Keys | What they do |
|---|---|
| **Ctrl+1** … **Ctrl+5** (also with the numeric keypad) | Open Dashboard, Games, Compare, Logs and Settings, and move the keyboard into that page; a screen reader hears its title. |
| **Alt** or **F10**, then the arrow keys and **Enter** | Move to the menus. **Alt** with a menu's underlined letter opens it (*File*, *Tools*, *Help* in English). |
| **Tab** and **Shift+Tab** | Move through a page or a dialog in reading order. |
| The **arrow keys**, **Home**, **End**, **Page Up**, **Page Down** | Move inside a list or a table — a game's sessions, the games list, the Compare list, the import checklist. |
| **Enter** or **Space** | Press the button, switch or box that has the focus. **Enter** on a game in the list opens its page. |
| **Esc** | Closes a dialog the way its **Close** or **Cancel** button does: nothing is changed. A dialog that has no Close button waits for an answer, and the terms window has its own **Decline** and **Accept**. |
| **Enter** in the hooking warning | Switches hooking on once the phrase is typed exactly; before that it does nothing. |
| On a chart: the **arrow keys**, **Ctrl** with an arrow, **A** | Tab reaches every chart. The arrows move its view, Ctrl with an arrow zooms, A shows all of it again (so does a double-click); the page around it stays put. |
The same keys are in the user guide, [The screens](guide/07-screens.md#keyboard-and-mouse).
### Screen readers
- **Every page, menu, dialog and setting can be reached and used with Narrator.** The owner checked this on
2026-11-09, keyboard only with the mouse disconnected, on 0.1.0-beta.34 and 0.1.0-alpha.3, and found no fault.
- **Every page has headings**: its title is a heading of the first level, each section one of the second, so a screen
reader's heading keys move from section to section.
- **Every chart says what it is and where its numbers are written as text**, and which keys move it.
- **Every button, switch and box that shows no text of its own has a name**, from the same translations as the screen.
- **Lists, drop-down options and table cells are read by the words they show**, and a button repeated on each row names
its row — *Open: 11/9/2026 14:03*, *Play: Cyberpunk 2077*, *Turn off: Cyberpunk 2077*.
- **The frame-rate readout says the game's own frames, the displayed frames and the frame-generation factor together**
(*Native 62 FPS, displayed 118 FPS, frame generation ×1.9*) — never the larger number alone; a ray-tracing chip says its
value and where it came from (*Ray Tracing: Yes, measured*).
- **What appears is said as it appears**: a safety notice (hooking refused, measuring stopped, hooking turned off), the
capture agent going away and coming back, an update's steps, a short message at the bottom of the window, a notice on a
game's page and a result of **Tools ▸ Database maintenance** — in the words shown, while FrameLedger's window is the
active one. While a game has the screen nothing interrupts it; the notice stays in the window, and Windows' own
notifications from the icon by the clock are read by the screen reader itself.
- **The notices above the page can be read where they are shown**, and the button that answers one says which notice it
answers.
- **Tab goes from control to control**: pictures, lists and the rows of Settings are not stops of their own.
- **Dialogs say they are dialogs**, keep the focus inside them until they close, and then give it back to the control
that opened them. A message box opens over FrameLedger's window, never behind it.
### Seeing the screen
- **Light, dark, or the same as Windows** (Settings ▸ Theme). FrameLedger takes every colour from the theme, and every
text is measured against what is painted under it, in both themes.
- **Windows contrast themes** (Settings ▸ Accessibility ▸ Contrast themes) — Aquatic, Desert, Dusk, Night sky, or one
whose colours you changed: every colour in the window becomes one of the theme's, whatever Settings ▸ Theme says, as
soon as you turn one on, edit it or turn it off. The charts draw in its colours too, their lines and marks still told
apart by pattern, and Settings ▸ Theme says a contrast theme is in use.
- **The colour a game's picture lends its page** is used only as far as every text on it still reads, and never under a
contrast theme.
- **Windows display scaling** at any size, on every screen; **Magnifier** (Windows logo key + Plus) works as with any
program.
- Labels such as *Hooking on* and *Not installed*, and the ray-tracing chips, always carry their words; a chip that reads
*N/A* is also drawn with a dashed edge.
- **No chart tells two series apart by colour alone**: its lines are solid, dashed or dotted, its points circles,
triangles or squares, its shaded stretches striped or dotted.
### Languages
FrameLedger is shown in English, Vietnamese or Japanese (Settings ▸ Language), and the names a screen reader reads come
from the same translations. The documents — the user guide, this page, the legal texts — are in English.
## How it is checked
- **On every build**, by the project's own tests: what a screen reader is given for every page, window and dialog —
every place Tab stops has a name, no list or table item is read by its program name, no text is hidden from a screen
reader inside a control, no two buttons in a list share a name; each thing that appears is said once, in its words;
every page has one first-level heading and every section title a level; no chart tells two series apart by colour
alone; a chart's keys move it and stay its own; every control that shows no text has a name; no colour is written
into a screen; every text reads against its background in both themes and after a theme switch, and under Windows'
four contrast themes and two edited ones is drawn in the theme's own colours at 4.5:1 or better; **Esc** closes the
open dialog without an answer, and a dialog gives the focus back; **Ctrl+1** … **Ctrl+5** open the pages in their
order and move the keyboard into them; a page slides in only while Windows' animation effects are on; the program
declares it follows each screen's scaling.
- **By hand**: the owner's pass of 2026-11-09 above, repeated for each release that changes a screen.
- **Not tested yet**: NVDA, JAWS, Voice Access, touch, Windows 10, and other people's PCs. They should work through the
same Windows interface Narrator uses, but nobody has checked. Contrast themes are checked by the tests above and have
not yet been looked at on a screen.
## Known limitations
Each one with what to do instead. A barrier that is not on this list is worth reporting.
- **A chart's points cannot be read one by one.** A screen reader hears the chart's name and where its numbers are:
a session's figures and *Statistics per series* in its summary, the table under the Compare chart, the Sessions table
and the list of changes under a trend chart, and **File ▸ Export ▸ Session CSV** or **Session JSON**.
- **In the user guide and the other documents the app shows, headings are read as ordinary text**: Windows' document
view gives them no heading role. Their links and their order work as on any page.
- **The short messages at the bottom of the window close after four seconds**, and cannot be read again once closed. A
screen reader is told each one as it appears.
- **Windows' text size setting** (Settings ▸ Accessibility ▸ Text size) **is not followed.** Use display scaling
(Settings ▸ System ▸ Display ▸ Scale) or Magnifier.
- **Pausing capture is only in the menu of the icon by the clock.**
- **The windows Windows itself shows** — choosing a file, the administrator prompt — are Windows', not FrameLedger's.
## Report an accessibility problem
1. Open an issue with the
[Accessibility problem form](https://github.com/poli0981/frameledger/issues/new?template=accessibility.yml).
2. Say what you were trying to do and what happened instead; your FrameLedger version (Help ▸ About) and your Windows
version; and what you use — the keyboard alone, Narrator, NVDA, JAWS, Magnifier, a contrast theme — with its version.
The steps to get there help, and so does a screenshot or a recording, but neither is required. **You never need to
tell us anything about yourself or a disability.**
3. If you want to attach details from your PC, **Help ▸ Report a bug** builds them into a file on your PC and shows you
what is inside first; nothing is uploaded by itself.
**A safety notice you could not perceive** — hooking refused, measuring stopped or hooking turned off, without your
knowing — is a safety problem as well: say so in the report, and it is handled first.
### How serious it is
You do not have to choose; the maintainer sets it when reading the report.
| Severity | What it means | For example |
|---|---|---|
| **Critical** | A task cannot be done at all. | Hooking cannot be switched off with the keyboard; the terms window or the hooking warning cannot be answered; a safety notice cannot be read. |
| **Serious** | It can be done only with great difficulty or a workaround. | A value can be read only by exporting the session. |
| **Moderate** | It is tiring or inconsistent. | A name that differs from what the screen shows; an extra stop for Tab. |
| **Minor** | It barely gets in the way. | A tooltip the keyboard cannot reach, when its words are shown elsewhere too. |
### What happens next
FrameLedger has one maintainer, so there are no promised times. Every report is read and answered, without doubting what
you describe. Critical problems come before other work; a workaround, when there is one, is written on the issue; the
fix ships in a release, and the issue is closed once you say it works for you — or when a fix has been out for a while
and nobody has answered.
## Who looks after this
The project's owner, poli0981, keeps this page and the checks behind it, and reviews both for each release that changes
a screen. A change to FrameLedger that moves anything on this page changes the page in the same pull request.
## For contributors
A change to the App keeps what the tests above hold: a name, from the translations in all three languages, for every
control that shows no text; colours only from the theme. Say in the pull request what you checked with the keyboard
and with Narrator. The rules and the checks are in [`docs/08_UI.md`](docs/08_UI.md#accessibility) and
[`CONTRIBUTING.md`](CONTRIBUTING.md).
## Feedback
To improve this page, open an issue or a pull request. A barrier goes through the form above, so that it is not lost.
+3
View File
@@ -41,6 +41,9 @@ Newest first. Each file holds that release's section exactly as it stood here.
| Version | Date | Notes |
|---|---|---|
| `0.1.0-beta.35` | 2026-11-09 | [`docs/changelog/0.1.0-beta.35.md`](docs/changelog/0.1.0-beta.35.md) |
| `0.1.0-alpha.3` | 2026-11-06 | [`docs/changelog/0.1.0-alpha.3.md`](docs/changelog/0.1.0-alpha.3.md) |
| `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) |
+9 -3
View File
@@ -49,7 +49,7 @@ A C++ DLL (`FrameLedger.Overlay.dll`) is injected into games the user explicitly
| UI | WPF + WPF UI (`WPF-UI` pinned = 4.3.0) + CommunityToolkit.Mvvm — `docs/16_WPFUI_SYNTAX.md` |
| App composition | .NET Generic Host + DI in `FrameLedger.App` |
| Charts | ScottPlot 5 |
| Markdown in the App | **Markdig** (BSD-2-Clause, pinned ~~1.4.0~~ 1.5.0 since beta.31 — 1.4.2 in beta.30) → WPF `FlowDocument`, HTML off, no image fetched — the Legal Gate, the user guide, Help ▸ Limitations, the update notes, About (beta.12; row added 2026-10-04) |
| Markdown in the App | **Markdig** (BSD-2-Clause, pinned ~~1.4.0~~ 1.5.0 since beta.31 — 1.4.2 in beta.30) → WPF `FlowDocument`, HTML off, no image fetched — the Legal Gate, the user guide, Help ▸ Limitations, Help ▸ Accessibility (beta.35, D88), the update notes, About (beta.12; row added 2026-10-04) |
| GPU telemetry | **The game process's own memory since beta.12 (D43):** `FrameLedger.ProcessStats.dll` (C++, loaded by the Agent, never into a game) reads its dedicated/shared GPU memory from the `GPU Process Memory` counters and its working sets from `GetProcessMemoryInfo` — `18_GPU_VENDOR_APIS` §The game process's memory. Layered: DXGI + PDH counters (all vendors) → LibreHardwareMonitorLib (MPL-2.0, all vendors) → **NVAPI (MIT, headers + `amd64/nvapi64.lib` vendored 2026-08-05** at `src/native/third_party/nvapi/`, consumed via the `fl_nvapi` target; NVIDIA extras + Reflex). **No AMD/Intel vendor SDK** — `docs/18_GPU_VENDOR_APIS.md`. ~~**No telemetry source exists in code yet**~~ **`LhmTelemetrySource` (L2) exists since 2026-09-03 (`20_OPEN_QUESTIONS` §M5 row R1, eight GPU fields unelevated); L1 (`BaselineTelemetrySource`: DXGI identity + the PDH adapter-memory counter, the first CsWin32 consumer), `CompositeTelemetrySource` and the 1 Hz `TelemetryPoller` since 2026-09-09; L3 (`NvapiTelemetrySource` over the native `FrameLedger.NvapiBridge.dll` — the only shipped binary linking `nvapi64.lib`, loaded by the Agent into its own process and never into a game) since 2026-09-10 (PR-E2)** — `ctest fl_nvapi_probe` was the only NVAPI consumer until then, and it exists so the vendoring is verified rather than asserted. This row said no source existed for six days after one did, recorded 2026-09-09 rather than repaired quietly. This row previously claimed the vendoring in the present tense while `third_party/` held only `vulkan-headers`; `legal/` had already caught the identical claim about itself and gained a bidirectional gate, which is what made the real vendoring a red-then-green |
| CPU/board sensors | LibreHardwareMonitorLib ≥ 0.9.6 (PawnIO) — **optional**, elevated only |
| Tier-2 fallback | **There is none, and Tier 2 is not a measurement.** Owner decision 2026-08-28: the ladder is two rungs — hooked, or duration + sensors + the reason. ~~ETW-based, no injection~~; ~~Intel PresentMon console binary~~ dropped 2026-08-27 after §S31 retired it. Whether a shipped build ever regains a no-injection measurement is `docs/20_OPEN_QUESTIONS.md` §G |
@@ -67,6 +67,7 @@ A C++ DLL (`FrameLedger.Overlay.dll`) is injected into games the user explicitly
FrameLedger.slnx # XML solution format (SDK default since .NET 10)
NOTICE # copyright + the GPLv3 section 7 additional terms (beta.12, D45)
CONTRIBUTING.md FORKING.md CODE_OF_CONDUCT.md # for people who build, contribute or redistribute
LIMITATIONS.md ACCESSIBILITY.md # what the software cannot do; the accessibility statement (D36, D88)
global.json # pins the SDK band — see 12_BUILD
RELEASE_LINE # `main`, or `alpha` on the alpha branch (D73, 2026-10-31) — 12_BUILD §The alpha line
build.ps1 # the quality gate; CI runs this identical script
@@ -165,7 +166,7 @@ guide/ # the user guide (beta.12, D44): ~~eight~~ short
# (twelve since beta.17, D54: the screens, every setting, troubleshooting, a glossary;
# and the guide is the wiki's End-user part)
wiki/ # the wiki's own pages (beta.17, D53): Home, _Sidebar, the developer pages. wiki.yml
# publishes them with guide/ and LIMITATIONS.md to the Wiki tab at a release;
# publishes them with guide/, LIMITATIONS.md and ACCESSIBILITY.md to the Wiki tab at a release;
# tools/wiki-build.ps1 assembles and checks them (build.ps1 wiki-check)
docs/ legal/ legal/licenses/
```
@@ -196,6 +197,8 @@ The version handshake is wired end to end as of 2026-08-05: `FlGuardBuildId` giv
- Hook-path changes state measured overhead in the PR body (`14_TESTING` §Hook overhead).
- Any new hook is listed in `17_HOOK_ENGINE` §Hook inventory and justified against rule 4.
- New user-visible strings exist in `en`, `vi`, `ja`.
- A change to what the App shows keeps `ACCESSIBILITY.md` §For contributors (names, theme colours, nothing by colour alone,
keyboard reach) and updates that page when it moves what works or what does not (D88).
- Any deviation from a doc updates that doc in the same PR.
## Reading order
@@ -219,7 +222,10 @@ The version handshake is wired end to end as of 2026-08-05: `FlGuardBuildId` giv
10. Remaining (`09`–`15`).
11. **`LIMITATIONS.md`** (repository root; shown in the App under Help ▸ Limitations) — what the WHOLE software cannot
do, in the user's words, each item linked to its details. When a change moves a limit, the page changes in the same
PR (D36, 2026-09-27). **`docs/LIST_GAME_TESTED.md`** — the real games FrameLedger has been run with and what each
PR (D36, 2026-09-27). **`ACCESSIBILITY.md`** (repository root; Help ▸ Accessibility) — the accessibility statement:
WCAG 2.2 AA through WCAG2ICT as a goal, never a claim; what works with the keyboard, a screen reader and contrast
themes, what does not, how a barrier is reported (D88, 2026-11-09); `docs/08_UI.md` §Accessibility holds its checks.
**`docs/LIST_GAME_TESTED.md`** — the real games FrameLedger has been run with and what each
session measured, from a copy of the owner's ledger and the repository's own evidence (D35).
**Before writing native or capture code, read `docs/20_OPEN_QUESTIONS.md`** (its open entries; since beta.24 the
+7 -1
View File
@@ -11,6 +11,8 @@ merged, and under what licence your contribution is accepted.
- **Open an issue before anything larger than a fix**, so the approach can be agreed before the work is done.
- **A game with anti-cheat that FrameLedger fails to detect** is a safety bug: use the *Safety gap* issue form.
- **A vulnerability in FrameLedger itself** goes the private route in `SECURITY.md`, never a public issue.
- **Something that cannot be reached, read or seen** — with the keyboard, a screen reader, a contrast theme — uses the
*Accessibility problem* form; `ACCESSIBILITY.md` says what the App aims for.
- Everyone who takes part follows the `CODE_OF_CONDUCT.md`.
## Building
@@ -45,13 +47,17 @@ The definition of done is the one in `CLAUDE.md`:
- a change to the hook path states its measured overhead in the PR (`docs/14_TESTING.md` §Hook overhead);
- a new hook is listed in `docs/17_HOOK_ENGINE.md` §Hook inventory and justified against rule 4;
- every new user-visible string exists in `en`, `vi` and `ja` (`docs/09_I18N.md`);
- a change to what the App shows keeps `ACCESSIBILITY.md` §For contributors — a name for every control that shows no
text, theme colours only, nothing shown by colour alone, everything reachable by keyboard — and says in the PR what was
checked with the keyboard and Narrator; if it moves what works or what does not, `ACCESSIBILITY.md` changes with it;
- a change that makes a document wrong updates that document in the same PR;
- a change under `src/` adds an entry under `## [Unreleased]` in `CHANGELOG.md`;
- every new source file carries the licence header — `./tools/notice-check.ps1 -Fix` writes it. A file you wrote
yourself may name you in its second line instead, in the same form:
`Copyright (C) <year> <your name> - additional terms under GPLv3 section 7: see NOTICE`.
The pull-request template lists the safety checks for changes to the capture layer.
The pull-request template lists the safety checks for changes to the capture layer, and the accessibility checks for
changes to the user interface.
## What will not be merged
+1 -1
View File
@@ -74,7 +74,7 @@
<ItemGroup Label="Analyzers (build-time only)">
<PackageVersion Include="Roslynator.Analyzers" Version="5.0.1" />
<PackageVersion Include="Meziantou.Analyzer" Version="3.0.317" />
<PackageVersion Include="Meziantou.Analyzer" Version="3.0.319" />
<PackageVersion Include="Microsoft.VisualStudio.Threading.Analyzers" Version="18.12.1" />
</ItemGroup>
+17 -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.35.*
## 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**
(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
@@ -197,6 +202,15 @@ you accept the prompt. Turn it on only if you trust everything that runs under y
anti-cheat, never to judge it, and recording or measuring a game vouches for nothing. Four itch.io downloads this
project once used as examples turned out to carry malware ([details](docs/spike-notes.md)).
## Accessibility
What works with the keyboard alone, a screen reader, a contrast theme or Magnifier, what does not yet, and how to report
a barrier is on its own page: [Accessibility](ACCESSIBILITY.md) (in the app: Help ▸ Accessibility). The largest limits:
- **A chart's points cannot be read one by one.** A screen reader hears its name and where its numbers are written —
the session's figures, the tables, **File ▸ Export**; its keys move it.
- **Windows' text size setting is not followed** — use display scaling or Magnifier.
## Play
- **Through GOG GALAXY or itch, you finish in their app.** GOG GALAXY runs the game as its own shortcuts do, and the
+12 -8
View File
@@ -6,13 +6,14 @@
**New here? Start with the [user guide](guide/README.md)** — install, record a game, read your results, stay safe with
anti-cheat, and look after your data, a page each, then every screen, every setting and what to do when something goes
wrong. What FrameLedger cannot do is on one page: [Limitations](LIMITATIONS.md). Both are in the app too (Help ▸ User
guide, Help ▸ Limitations), and on the project's [wiki](https://github.com/poli0981/frameledger/wiki) with the developer
pages.
wrong. What FrameLedger cannot do is on one page: [Limitations](LIMITATIONS.md). How it works with the keyboard alone, a
screen reader or a contrast theme, and how to report a barrier: [Accessibility](ACCESSIBILITY.md). All three are in the
app too (Help ▸ User guide, Help ▸ Limitations, Help ▸ Accessibility), and on the project's
[wiki](https://github.com/poli0981/frameledger/wiki) with the developer 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.35`** (2026-11-09), 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 +45,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 +177,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.35` (2026-11-09); before it `v0.1.0-beta.34` (2026-11-06), `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**.
@@ -201,7 +204,8 @@ FrameLedger is GPL-3.0-only free software, and you are welcome to build it, chan
- **Build it:** [`docs/12_BUILD.md`](docs/12_BUILD.md) — `./build.ps1 check` is the whole quality gate, the same one CI runs.
- **Contribute:** [`CONTRIBUTING.md`](CONTRIBUTING.md) — the definition of done, what will not be merged, and that a
contribution is licensed GPL-3.0-only with the [`NOTICE`](NOTICE) terms (no CLA). Conduct:
[`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md). Security reports: [`SECURITY.md`](SECURITY.md).
[`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md). Security reports: [`SECURITY.md`](SECURITY.md). Accessibility — the goal,
the checks and how a barrier is reported: [`ACCESSIBILITY.md`](ACCESSIBILITY.md).
- **Fork or redistribute:** [`FORKING.md`](FORKING.md) — what the GPL asks of anyone who distributes builds, and the names
a fork must change so it does not share FrameLedger's update feed, install folder, data, pipe or Vulkan layer.
- **Find your way around:** the [wiki](https://github.com/poli0981/frameledger/wiki)'s developer pages are short, and each
+1 -1
View File
@@ -467,7 +467,7 @@ function Invoke-ProjectGates {
Invoke-Checked 'notice-check (self-test)' { & $noticeTool -SelfTest }
Invoke-Checked 'notice-check' { & $noticeTool -RepoRoot $repo }
# beta.17 (D53/D54): the GitHub Wiki is built from wiki/, guide/ and LIMITATIONS.md, and wiki.yml publishes it when a
# beta.17 (D53/D54): the GitHub Wiki is built from wiki/, guide/, LIMITATIONS.md and (beta.35) ACCESSIBILITY.md, and wiki.yml publishes it when a
# release is made. A link or a section that leads nowhere, a page nothing leads to, a sidebar out of the guide's
# order, a path that names nothing or a version written into a page is red here, not on the published wiki.
# Self-test first (nine cases, both directions), then the live assembly into a temporary folder.
+1 -1
View File
@@ -113,7 +113,7 @@ Draw live FPS/frametime/upscaler info inside the game. Only for games already ho
- **NFR-6 Accuracy:** per `03_METRICS` §Accuracy budget, stated per tier.
- **NFR-7 Resilience:** power loss loses at most the last 60 s of raw data; DB never corrupts (WAL + transactions); Agent restart recovers `.partial` sessions as `interrupted`.
- **NFR-8 OS support:** Windows 10 22H2+ and Windows 11, x64. No ARM64 in v1.
- **NFR-9 Accessibility:** full keyboard navigation, adequate contrast in both Fluent themes, Per-Monitor V2 DPI awareness. *(What each clause means for this app, and the check that holds it: `08_UI` §Accessibility, P4 PR-8.)*
- **NFR-9 Accessibility:** full keyboard navigation, adequate contrast in both Fluent themes, Per-Monitor V2 DPI awareness. *(What each clause means for this app, and the check that holds it: `08_UI` §Accessibility, P4 PR-8.)* *(Widened 2026-11-09, beta.35, owner decisions D88–D91: and a screen reader reads every control and value and is told what changes; Windows contrast themes are followed; nothing is shown by colour alone. The goal behind all of it is WCAG 2.2 AA as W3C's WCAG2ICT applies it to desktop software — a goal, not a conformance claim — stated to users in `ACCESSIBILITY.md`.)*
- **NFR-10 Offline-first:** everything except updates and opt-in metadata works with zero connectivity.
- **NFR-11 Auditability:** the entire set of hooks is enumerable in `17_HOOK_ENGINE` §Hook inventory and matches the code; a reviewer must be able to verify in minutes that nothing reads game memory.
+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
+178 -14
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. *(beta.35, D91: a Windows contrast theme wins over all three while it is on — §Contrast.)* All XAML follows `16_WPFUI_SYNTAX.md` — that doc is mandatory reading before writing views.
## Shell
@@ -40,8 +43,13 @@ WPF + **WPF UI (Wpf.Ui, Fluent)**. Shell = `ui:FluentWindow` with custom `ui:Tit
**Menu bar**
- **File:** Add game… · Import library (Steam / GOG / Epic / itch.io / Xbox *— since beta.33*) · Export ▸ (Session CSV / Session JSON / Chart PNG) · Exit
- **Tools:** Agent status… · Update detection rules · Vulkan layer registration… · Open data folder · Database maintenance…
- **Help:** User guide (beta.12) · Check for updates · Report a bug… · ~~Documentation~~ Online documentation · Limitations · About FrameLedger (~~App / Developer / Third-party licenses tabs~~ — built beta.12 as *This app* / *Third-party licences* / *Legal documents*, below)
- **Help:** User guide (beta.12) · Check for updates · Report a bug… · ~~Documentation~~ Online documentation · Limitations · Accessibility (beta.35) · About FrameLedger (~~App / Developer / Third-party licenses tabs~~ — built beta.12 as *This app* / *Third-party licences* / *Legal documents*, below)
> **Help ▸ Accessibility, beta.35 (owner decision D88, 2026-11-09):** `ACCESSIBILITY.md` — the accessibility statement —
> as the build embeds it (`Services.AccessibilityDocument`), in a `Windows/DocumentWindow` of its own like Limitations,
> and after Limitations in the user guide's window so the guide's links to it open there. Information, not one of
> FR-11's documents. What it says and the checks behind it are §Accessibility below.
>
> **Help ▸ Limitations, beta.10 (D36):** `LIMITATIONS.md` as the build embeds it (`Services.LimitationsDocument`), in a
> ~~read-only, scrolling WPF UI `MessageBox` with *Open on GitHub*~~ window of its own since beta.12 (`Windows/DocumentWindow`,
> rendered — below; corrected 2026-10-04). It is information, not one of FR-11's documents:
@@ -141,7 +149,11 @@ The Menu sits in its own row **below** the TitleBar (never inside the drag regio
## Notifications policy
- **In-app, transient** (rules updated, export done, non-fatal capture warning): `ISnackbarService` snackbar, 4 s.
- **In-app, transient** (rules updated, export done, non-fatal capture warning): `ISnackbarService` snackbar, 4 s — shown
only through `IMessageStrip` (`Services/SnackbarStrip`) since beta.35, which says it to a screen reader as it shows it
(D89; `AnnouncementsTests.OnlyTheStripShowsASnackbarAndNoXamlSetsALiveSetting`).
- **Every one of these is said to a screen reader as it appears (beta.35, owner decision D89)** — §Accessibility, Screen
readers.
- **In-app, persistent** (Agent offline, ~~PawnIO missing,~~ update downloaded, a viewer's folder, the safety notices, *an alpha build* — since 2026-10-31, D74): `ui:InfoBar` banner pinned above content with action button. *(Corrected 2026-10-07: no PawnIO banner was ever built — CPU temperature reads N/A, and Settings ▸ System says it needs the admin mode and PawnIO; the viewer's banner (D52) and the safety notices were missing from the list.)*
- **System-level, app possibly minimized** (session saved with "View" action, capture error while in tray, update available): tray balloon/toast via H.NotifyIcon.
- One event → exactly one channel; never duplicate the same event across snackbar *and* tray.
@@ -285,6 +297,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 +324,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 +651,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 +802,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
@@ -844,7 +883,7 @@ Tail view of `ui-*.log` / `agent-*.log` (toggle), level filter, search (`ui:Auto
> (`Settings_RemoveUninstalled_Applied`), not at the next session — the detection sweep reads it at every pass. Tests:
> `ViewerModeTests.EverySettingTheAgentReadsIsOffInAViewer`, `GuideDocumentsTests.TheSettingsPageOfTheGuideNamesEverySetting`.
Sections per FR-10 using the WPF UI settings idiom: `ui:CardControl`/`ui:CardExpander` rows with `ToggleSwitch`, `ComboBox`, `ui:NumberBox` (numeric inputs — min session length, sensor interval, retention). Language switch applies immediately (09_I18N). Theme selector (Light/Dark/System) drives `ApplicationThemeManager` (16 §Theming). **Capture section (top, most important):** the global **hooking kill switch** (`ToggleSwitch`, prominent) with a one-line summary of what it does; a list of games currently hook-enabled with a per-game revoke; Vulkan layer registration state + Register/Unregister; a link to the safety documentation. Turning the global switch off must take effect immediately, including for the Vulkan layer.
Sections per FR-10 using the WPF UI settings idiom: `ui:CardControl`/`ui:CardExpander` rows with `ToggleSwitch`, `ComboBox`, `ui:NumberBox` (numeric inputs — min session length, sensor interval, retention). Language switch applies immediately (09_I18N). Theme selector (Light/Dark/System) drives `ApplicationThemeManager` (16 §Theming) *(beta.35, D91: a Windows contrast theme wins while it is on, §Contrast, and a line under the selector says so, bound to `ContrastTheme.IsOn` so it comes and goes with the page shown)*. **Capture section (top, most important):** the global **hooking kill switch** (`ToggleSwitch`, prominent) with a one-line summary of what it does; a list of games currently hook-enabled with a per-game revoke; Vulkan layer registration state + Register/Unregister; a link to the safety documentation. Turning the global switch off must take effect immediately, including for the Vulkan layer.
**System (2026-09-21, FR "show the user's hardware"):** a card above Legal stating this PC as a session's hardware snapshot would record it right now — processor, graphics card, graphics driver, memory, Windows build, primary display — through the same `IHardwareSnapshotSource` the Agent stamps sessions with, read on the thread pool when the page opens, a field that could not be read as N/A, with **Copy** (the same lines as text) and a note that nothing is sent anywhere and what CPU temperature needs. Its own `SystemInfoViewModel`, not `SettingsViewModel`'s. The same snapshot is one tertiary line under the session summary's header (it was loaded for the export and shown nowhere), and `--diag` prints it; the bug bundle's `sysinfo.json` is deliberately NOT given it — its keys are the issue link's prefill.
@@ -968,8 +1007,9 @@ Agent section: elevation state with a plain explanation of what elevation *optio
(`ScrollViewer.CanContentScroll="False"` on the `Page` — `16_WPFUI_SYNTAX` §Gotchas: until beta.14 the wheel scrolled
nothing on five pages, and the Logs tail did not follow the newest line); a scroller nested in a dialog hands the wheel
on at its ends (`ui:PassiveScrollViewer`); over a chart a plain wheel scrolls the page and **Ctrl+wheel zooms the chart**
(`Charts/ChartWheel`, every plot through `ChartTheme.Attach`) — drag still pans and double-click still resets, as
ScottPlot does. The import checklist scrolls inside its list and nowhere else, so its intro and its count stay put.
(`Charts/ChartWheel`, every plot through `ChartTheme.Attach`) — drag still pans and ~~double-click still resets, as
ScottPlot does~~ *(corrected 2026-11-09: ScottPlot's left double-click toggled its render-time benchmark overlay; since
beta.35 a double-click shows all of the chart, `ChartTheme.ResetOnDoubleClick`, `ChartKeyboardTests`)*. The import checklist scrolls inside its list and nowhere else, so its intro and its count stay put.
## Accessibility
@@ -977,17 +1017,39 @@ NFR-9 names three things — full keyboard navigation, adequate contrast in both
and this section is what they mean for this app, each with the test that holds it (P4 PR-8, 2026-09-15). Until then
the requirement was one bullet under §UX rules, and nothing checked it.
> **The users' half is `ACCESSIBILITY.md` (beta.35, owner decision D88, 2026-11-09):** the goal — WCAG 2.2 AA as W3C's
> WCAG2ICT applies it to desktop software, a goal and never a conformance claim — what works, what does not and what to do
> instead, and how a barrier is reported (the *Accessibility problem* form, `labels: [accessibility]`) and handled (by
> severity, no promised times). It is embedded and shown under Help ▸ Accessibility. **This section is the design and the
> checks; the statement says nothing this section does not hold**, and a change that moves either changes both
> (`AccessibilityDocumentTests` holds the statement's own rules: embedded as written, a goal and no claim, a form that
> exists, no struck text in a page the App shows). NFR-9 was widened the same day to screen readers and contrast themes
> (D88–D91).
### Keyboard
| Keys | Does | Where |
|---|---|---|
| **Ctrl+1 … Ctrl+5** (and the numeric keypad's 1–5) | Dashboard · Games · Compare · Logs · Settings | `MainWindow` `InputBindings` → `MainWindowViewModel.NavigateToCommand` → `ShellShortcuts` |
| **Ctrl+1 … Ctrl+5** (and the numeric keypad's 1–5) | Dashboard · Games · Compare · Logs · Settings — and since beta.35 the page's first control takes the focus once it is shown, its title (the page's first-level heading) said to a screen reader; before, the focus stayed where it was, often on the page that had just gone | `MainWindow` `InputBindings` → `MainWindowViewModel.NavigateToCommand` → `ShellShortcuts`, then `Services/PageFocus` (the shell tells it each page shown, from `NavigationView.Navigated`) |
| **Alt**, **F10** | Focuses the menu bar; arrows and Enter walk File / Tools / Help | WPF `Menu`, nothing custom |
| **Alt** + a menu's access key | Opens that menu — `_File` `_Tools` `_Help`; `_Tệp` `_Công cụ` `Trợ _giúp`; `ファイル(_F)` `ツール(_T)` `ヘルプ(_H)` *(row added 2026-11-09: the keys existed since P3 and this table did not name them)* | the `Menu_*` strings' `_` |
| **Tab / Shift+Tab** | Moves through a page in reading order | layout order; no `TabIndex` overrides |
| **Arrows, Home/End, Page Up/Down** | Move within a `DataGrid` (Sessions, Compare picker, Import checklist) | `DataGrid` defaults |
| On a focused chart: **arrows**, **Ctrl**+arrow, **A** *(beta.35, D90)* | Pan, zoom, show all — ScottPlot's keys; the key is then the chart's, so the page neither scrolls nor moves the focus on (Tab still leaves) | `Charts/ChartPlot`, `Charts/ChartKeys` |
| **Esc** | Closes the open `ContentDialog` or `MessageBox` with no result — the same as its Close/Cancel button | `DialogKeyboard`, one class handler per dialog type registered at start-up |
| **Enter** | In the consent dialog's phrase box: enables hooking once the phrase is typed exactly, does nothing before (beta.30, D69); elsewhere in a `ContentDialog`, the default button | WPF's default button (`ConsentPrompt`: `DefaultButton = Primary`) and `ConsentDialogContent.SwallowsEnter` |
**Focus after a dialog, and motion (beta.35).** A `ContentDialog` gives the focus back to the control that opened it: WPF
UI 4.3.0's `ContentDialogHostController` stores `Keyboard.FocusedElement` when the dialog opens and focuses it again, at
`DispatcherPriority.Input`, when it closes — the App adds nothing, and
`FocusAndMotionTests.AContentDialogGivesTheFocusBackToTheControlThatOpenedIt` holds it (a first measurement said
otherwise; it ran on a thread with no dispatcher context, where the dialog's own `finally` never resumed). A WPF UI
`MessageBox` sets no owner — null before and after it is shown — so `Services/MessageBoxes` gives it the App's active
window: it opens over it and hands the focus back to it, not to another program; every box goes through it
(`EveryMessageBoxGoesThroughMessageBoxes`). A page slides in only while Windows' animation effects are on
(`SystemParameters.ClientAreaAnimation`, followed as it changes): `Services/PageMotion` sets the `NavigationView`'s
`Transition` to `None` while they are off, where WPF UI 4.3.0 played `FadeInWithSlide` whatever they were.
**Esc is the Close button, never the primary one.** On the consent dialog (FR-2.1) that is ~~"Keep it off"~~ "Keep hooking
off" *(the button's text, corrected 2026-10-07)*: nothing is
stamped. A dialog that offers no Close button is not dismissed by Esc, and the Legal Gate (FR-11) is a window of its own
@@ -1009,7 +1071,54 @@ handled key — so whether Esc alone would close a dialog through `IsCancel` is
— corrected 2026-10-04): every `Button`, `ToggleButton`, `ToggleSwitch`, `CheckBox`, `RadioButton`, `ComboBox`,
`TextBox`, `NumberBox`, `PasswordBox`, `Slider` and `HyperlinkButton` in the App's XAML either has content or a name. A new
unnamed one is red.
- Status lines that change after an action (the Database maintenance result) are `AutomationProperties.LiveSetting="Polite"`.
- **What a screen reader is given, swept on every surface (beta.35, D88).** `PagesLoadTests.Automation` hosts every page,
window, dialog and control as the App hosts it, every tab shown in turn, and reads the UI Automation tree WPF builds — the
tree Narrator reads: **no Tab stop without an automation peer** (a plain `Control`, WPF UI's `Image`, `Card` and
`CardControl` take the focus with no peer or an empty name), **no item named by its type** (WPF names a list's, a
drop-down's and a grid row's item by `ToString()`, and a template column's cell, which has no text of its own, by
`Item: <row>, Column Display Index: n`), **every focusable control named**, **no shown text hidden in a template** (a
`TextBlock` whose templated parent is not a `ContentPresenter` is no control element), and **no two buttons in a list
sharing a name**. All five went red on `main` first — the type-named items filled 190 lines over the surfaces and their
tabs, the silent stops 37, and the safety InfoBar's title and message were hidden — and the fixes are: every item type speaks (`ToString()` through `Services/SpokenText`: `Choice` its
label, a notice its title and text, a document page its title, a session row its date, length and tier…); the display-only
controls (`FpsReadout`, `TriStateChip`, `ChangeBadge`) have a `Controls/SpokenTextAutomationPeer` — a Text element named
by their words, no children — and leave the tab order; a template column names its cells through
`Controls/CellName` (a cell style based on WPF UI's `DefaultDataGridCellStyle`, an empty cell read as *empty*); a row's
button names its row (*Open: …*, *Play: …*, *Turn off: …*); the App's InfoBar template draws its title and message through
`ContentPresenter`s; implicit styles take a plain `ItemsControl`, WPF UI's `Image` and `CardControl` out of the tab order;
a `CardExpander`'s expand button is named after its header (`Controls/ExpanderToggleName` — WPF UI 4.3.0 leaves it
unnamed). **The FPS readout says rule 6 aloud**: *Native 62 FPS, displayed 118 FPS, frame generation ×1.9*, a steady factor
with its share, a stand-alone number with its qualifier (`FpsPresentation.Spoken`). `ScreenReaderNamesTests` holds each
piece.
- **Headings (beta.35, owner decision D90).** A page's title (`FontTypography="Title"`) is
`AutomationProperties.HeadingLevel="Level1"`, a section title (`Subtitle`) `Level2`; a `Subtitle` that shows a value — the
Dashboard's three figures, a stat card's value, the FPS readout's line — says `None` on purpose.
`AccessibilityTests.EveryTitleAndSubtitleDeclaresAHeadingLevel` (every Title and Subtitle declares one),
`PagesLoadTests.EveryPageHasOneFirstLevelHeadingItsTitle`. A rendered document's headings (the guide, LIMITATIONS, this
statement, the legal texts) cannot be: a `FlowDocument` `Paragraph` has no automation peer, so it has no heading level to
give — stated in `ACCESSIBILITY.md` §Known limitations.
- **Charts (beta.35, D90).** Every plot is a `Charts/ChartPlot` — ScottPlot's `WpfPlot` with a peer: an Image whose
localized type is *chart*, named by its `AutomationProperties.Name` (`A11y_Chart_*`), its help text where its numbers are
as text (`A11y_ChartData_*`) and its keys (`A11y_Chart_Keys`); no children. Its focus is drawn with WPF UI's
`DefaultControlFocusVisualStyle`. **No two series of a chart differ by colour alone** (`Charts/ChartPatterns`: lines
cycle solid / dashed / dotted / densely dashed, then take markers; point series cycle circle / triangle / square /
diamond; the power and thermal limit spans are striped and dotted) — `PagesLoadTests.NoChartTellsTwoSeriesApartByColourAlone`
reads every chart's legend on every surface and the Compare chart with five sessions.
- **What appears is said as it appears (beta.35, owner decision D89).** `Services/IAnnouncer`, over UI Automation's
notification event in `Services/UiaAnnouncer` — the one place the App raises it, on its **active** window only (a game
that has the screen is never interrupted; the tray's Windows notifications cover a hidden window) and only when a
screen reader listens (`AutomationPeer.ListenerExists`). An **Alert** (`ImportantAll`, every one read): a safety notice as
it arrives (`SafetyNotices`), a warning in the strip, the capture agent going offline, a game page's refusal or warning.
A **Status** (`MostRecent` per activity, a newer one replacing one not yet read): the strip's info and success, the agent
back (`A11y_Agent_Connected`), an update's step (`Services/ShellAnnouncements` says a *change* only — the first state is
read with the window, a download's percent ticks are one step, a rebuilt window re-reads the same state silently), a
game page's success, every Database maintenance result line. The words are the window's, in its language.
`AnnouncementsTests`, `DatabaseMaintenanceViewModelTests.AResultIsSaidToAScreenReaderAsItAppears`.
- ~~Status lines that change after an action (the Database maintenance result) are `AutomationProperties.LiveSetting="Polite"`.~~
*(Corrected 2026-11-09: this announces nothing. WPF raises `LiveRegionChanged` only when the app raises it — "you
explicitly raise an event", Microsoft's* What's new in accessibility *for 4.7.1 — and `TextBlockAutomationPeer` raises
none (dotnet/wpf); the App raised no automation event anywhere. The setting marks the line as a live region and no
more. It came out the same day, for the announcement above; no XAML may set one.)*
### Contrast
@@ -1092,6 +1201,45 @@ theme's background, as it was before; the badge and the list carry its informati
> under it, in both themes. `EveryTextFollowsAThemeSwitch` hosts its pages in the presenter too since, and went red with
> them: a page made after a switch stayed black. All three went red on the unfixed XAML before they went green.
> **Windows contrast themes, followed (beta.35, owner decision D91).** WPF UI 4.3.0 cannot be asked to do it:
> `ApplicationTheme.HighContrast` names no dictionary; its four high-contrast files (HC1 Dusk, HC2 Night sky, HCBlack
> Aquatic, HCWhite Desert) each hold 84 red `#FFFF0000` placeholders among 97 colours and 17 brushes that throw when the
> file is read alone; their colours are Windows 11's defaults, not the user's; and they put the window text on the accent.
> So while `SystemParameters.HighContrast` is on, `Services/WpfThemeApplier` applies the light or the dark Fluent theme as
> the contrast theme is (by its window colour), with no Mica and no `SystemThemeWatcher`, and `Services/ContrastOverlay`
> over it: every key of those four files in the user's colour for its role (`Services/ContrastRoles` — a key's role is the
> colour it has in all four, opaque colours only, because inside the App a brush that throws alone falls back to the
> Fluent theme's translucent fill: `MenuBarItemBackgroundPressed` read as the white of the window text, and a pressed menu
> item was white on white; ties and placeholders by the key's name), the keys transparent there transparent, three
> Fluent-only keys by role, the 21 accent keys WPF UI writes into the application's resources as the highlight, and the
> text on the accent as the highlight's text. The colours are `SystemColors` (`ContrastPalette.FromSystem`) — the user's
> own, edited or not, Windows 10's as well — and turning a theme on, editing it or turning it off is followed at once
> (`SystemContrastSource`). What the App draws itself reads `ContrastTheme.Active`: the charts (`ChartPalette.ForContrast`,
> the theme's colours only, the series told apart by `ChartPatterns`), a badge's text (`ChartTheme.TextOn`, the theme's
> colour that reads best on the fill), the mix bar, the artwork band (no tint), the Import list (no dimmed rows), the
> unsigned-update footer (the secondary text style, not an opacity). WPF UI's Danger button paints a fixed `#F44336` in its
> style, out of any resource's reach, so every `ui:Button` takes the App's implicit style (`Styles/FrameLedger.xaml`): a
> Danger button is the theme's own button while one is on, the message boxes' Delete included. Held by `ContrastThemeTests` — the four files still placeholders; every key a role or
> transparent, none red; the roles the same over either Fluent theme; with each default theme's own colours the overlay
> is WPF UI's colours key for key, the text on the accent apart; an edited theme's colours reach every key; every Fluent
> colour key covered; every resource the App reads resolves; `ThemePlan`; the applier on and off at once — and
> `PagesLoadTests.EveryTextIsInTheContrastThemesColoursAndReadable`: every surface rendered under the four default themes
> and two edited ones, every text the theme's colour on the theme's colour at 4.5:1 or better. It went red first on the
> chips (window text on the highlight, 1.26–1.78:1), the Remove button (3.06–4.42:1 on `#F44336`) and the badges' black.
> **A sixth hole, closed 2026-11-09 (beta.35), found by measuring what no sweep renders.** The title bar and the snackbars
> are no surface, and the 3:1 sweep let 3.68:1 pass. The capture agent's pill was a `ui:Badge` whose appearance was
> BOUND — Success, Info, Caution, Danger, WPF UI's `Palette*Brush` under `BadgeForeground` — so `ContrastTests`, which reads
> literal attributes, never saw it: in the light theme 2.78, 2.63, 2.16 and 3.68:1. It is `AgentPill` now (a `Pill` on
> `SystemFillColor{Success,Caution,Critical}BackgroundBrush`, the theme's text), and a bound badge appearance is refused.
> WPF UI's Success and Caution snackbars are fixed colours under white in both themes, 2.78:1 and 2.16:1: the strip shows
> every message as Secondary, the theme's, 13.97:1 and 16.53:1, its icon saying the kind. And a Danger button's text was
> the theme's button text on `#F44336` — white in the dark theme, 3.68:1: the App's implicit button style puts
> `TextFillColorDarkPrimaryBrush` there, 5.3:1 and 5.7:1. `ContrastThemeTests.TheTitleBarsMarksReadInEveryState`,
> `ADangerButtonReadsInBothThemesAndIsTheThemesOwnButtonUnderAContrastTheme`,
> `NoButtonOrBadgeTakesAnAppearanceThatPaintsAFixedColour` and
> `AnnouncementsTests.EveryMessageOfTheStripIsDrawnInTheThemesOwnColours` hold the three.
### DPI
`app.manifest` declares Per-Monitor V2 (`AccessibilityTests.TheManifestIsPerMonitorV2`). A chart reads the pointer
@@ -1100,8 +1248,24 @@ ScottPlot reads once when the control is made, before it has a window.
### Known gaps, stated
- ScottPlot plots are not keyboard-operable (no focus, no pan/zoom by keys). The numbers behind them are on the
- ~~ScottPlot plots are not keyboard-operable (no focus, no pan/zoom by keys).~~ *(Corrected 2026-11-09, measured by
`ChartKeyboardTests` in a window off the screen: a plot takes focus — ScottPlot's control is focusable and a Tab stop —
and the keys ScottPlot reads reach it: the arrows pan, Ctrl with an arrow zooms, A shows all of it. ~~What it is not is
usable: it has no automation peer, so Narrator says nothing on reaching it, and it marks no key handled, so the page
around it acts on the same arrow too.~~ Since beta.35 it has a peer and keeps its keys, §Screen readers.)* A chart's
points are still not read one by one. The numbers behind them are on the
session summary's stat cards and in File ▸ Export (CSV/JSON); the hardware-change markers' text is WPF text in the
list under each trend chart (beta.30).
- No screen-reader pass with Narrator has been done; the names above are necessary, not proven sufficient. That pass
is the owner's.
- ~~No screen-reader pass with Narrator has been done; the names above are necessary, not proven sufficient. That pass
is the owner's.~~ **The owner's pass, 2026-11-09: keyboard only with the mouse disconnected, and Narrator, on
0.1.0-beta.34 and 0.1.0-alpha.3 — every page, menu, dialog and setting reached and used, no fault.**
- **What that pass could not show**, found the same day by measuring the UI Automation tree WPF builds (in memory, on
.NET 10.0.14 — not by listening): ~~a drop-down's items are named by a record's printed form (`Choice { Value = dark,
Label = Dark }`) and plain lists' items by their type; a control with no automation peer that still takes focus — a
chart, the FPS readout, the RT/PT/RR chips, the game's artwork — is a Tab stop Narrator says nothing about; text inside
a control template (the safety notices' title and message, the readout, the chips) is hidden from the control view;
nothing is announced; no text is a heading; several charts tell series apart by colour alone~~ *(closed the same day,
§Screen readers above)*; ~~page transitions play with Windows' animation effects off~~ *(not since beta.35,
§Keyboard)*; ~~Windows contrast themes are not
followed~~ *(followed since beta.35, D91 — §Contrast)*. `ACCESSIBILITY.md` §Known limitations
states each to users with what to do instead.
+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
+1 -1
View File
@@ -355,7 +355,7 @@ would not fit).
13b. `tools/accuracy-check.ps1 -SelfTest`, then live — the accuracy block is ONE text (`legal/ACCURACY.md`) embedded verbatim in `README.md` and `legal/DISCLAIMER.md` §4; a copy that drifted, a copy with no markers, or an empty source is red. Four self-test cases, both directions (§S23-6, 2026-09-06)
13c. **`tools/notice-check.ps1 -SelfTest`, then live** (beta.12, owner decision D45, 2026-10-03) — every first-party source file (`.cs .cpp .h .inl .ps1 .xaml`, tracked or new, minus `src/native/third_party/`) opens with `SPDX-License-Identifier: GPL-3.0-only` and `Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE` in its own comment syntax, because GPLv3 §7 wants additional terms named "in the relevant source files" (`NOTICE` carries them); the second line may name another holder and year in the same form (a contributor's own file).
Seven self-test cases, both directions; `./tools/notice-check.ps1 -Fix` writes a missing header, and `tools/resx-gen.ps1` generates the accessor with it
13d. **`tools/wiki-build.ps1 -SelfTest`, then `-Check`** (beta.17, owner decisions D53/D54, 2026-10-07) — assembles the GitHub Wiki from `wiki/`, `guide/` and `LIMITATIONS.md` into a temporary folder, as `wiki.yml` does at a release (`13_CI_CD` §wiki.yml), and fails on a link to a file, folder or section that does not exist, two sources for one page, a page that neither Home nor the sidebar leads to, a sidebar that lists the guide in another order than `guide/README.md`, a backticked repository path in a `wiki/` page that names nothing, and a version number written into a `wiki/` page (the footer says which release the wiki shows). Nine self-test cases, both directions
13d. **`tools/wiki-build.ps1 -SelfTest`, then `-Check`** (beta.17, owner decisions D53/D54, 2026-10-07) — assembles the GitHub Wiki from `wiki/`, `guide/`, `LIMITATIONS.md` and (beta.35) `ACCESSIBILITY.md` into a temporary folder, as `wiki.yml` does at a release (`13_CI_CD` §wiki.yml), and fails on a link to a file, folder or section that does not exist, two sources for one page, a page that neither Home nor the sidebar leads to, a sidebar that lists the guide in another order than `guide/README.md`, a backticked repository path in a `wiki/` page that names nothing, and a version number written into a `wiki/` page (the footer says which release the wiki shows). ~~Nine~~ Ten self-test cases since beta.35 (the statement's page, D88), both directions
14. `tools/changelog-check.ps1 -SelfTest` — nine cases, five expected RED. The live half needs a pull request's changed-file list and is supplied by `ci.yml`
14b. `tools/release-notes.ps1 -SelfTest` — five cases over a fixture changelog (a dated and an undated section, a missing one, a prefix that must not match, an empty one), and since beta.24 three over a temporary tree: a version with its own `docs/changelog/<version>.md` is read from it, one without from `CHANGELOG.md`, a prefix of a file name is not that file. The live half needs a tag's version and runs in `release.yml`, where a missing or empty section is a red release (P4 PR-5)
14d. **`tools/docs-split-check.ps1 -SelfTest`, then live** (beta.24, owner decision D66) — `CHANGELOG.md` holds no released section beside `[Unreleased]`; each `docs/changelog/<version>.md` holds one `## ` heading, its own `## [<version>] - date`, and no relative link (the App renders release notes as `CHANGELOG.md`); `CHANGELOG.md` and the files under `docs/changelog/`, and `docs/HANDOFF.md` and the files under `docs/handoff/` — and since PR-5 `docs/20_OPEN_QUESTIONS.md` and `docs/open-questions/`, `docs/spike-notes.md` and `docs/spike-notes/` — name each other in both directions. Eleven self-test cases, both directions
+8 -6
View File
@@ -211,9 +211,9 @@ FrameLedger uses the **`poli0981/.github` ops repo** where its templates fit, an
### `wiki.yml` — after a successful Release run, and by hand · **repo-local, built 2026-10-07 (beta.17, D53/D54)**
- **What:** the GitHub Wiki is a copy of the repository's own pages — `wiki/` (Home, the sidebar, the developer pages)
and `guide/` (the user guide: the End-user part, the same pages the App shows) with `LIMITATIONS.md`.
`tools/wiki-build.ps1` names each page (a guide page after its first heading, `guide/README.md` as *User-guide*,
`LIMITATIONS.md` as *Limitations*), rewrites links between pages to page names and every other repository link to
and `guide/` (the user guide: the End-user part, the same pages the App shows) with `LIMITATIONS.md` and, since
beta.35 (D88), `ACCESSIBILITY.md`. `tools/wiki-build.ps1` names each page (a guide page after its first heading,
`guide/README.md` as *User-guide*, `LIMITATIONS.md` as *Limitations*, `ACCESSIBILITY.md` as *Accessibility*), rewrites links between pages to page names and every other repository link to
its address on GitHub **at the release's tag**, drops each page's first heading (the wiki prints the page name), and
writes a footer naming the tag. The same assembly is `build.ps1`'s `wiki-check` gate (`12_BUILD` §Local quality gate,
13d), so a dead link is red on the pull request, never on the published wiki.
@@ -252,8 +252,8 @@ What it is and what differs on the branch: `12_BUILD` §The alpha line. What CI
warning, its row in `CHANGELOG.md`'s Releases table, a line in HANDOFF's START HERE) → the sync pull request into
`alpha` → a `release.yml` dispatch on `alpha` (`gh workflow run release.yml --ref alpha -f version=x.y.z-alpha.N`) →
the signed tag on `alpha`'s head → the run (§release.yml: the line's tag rule, `--channel alpha`). **No wiki publish**
(`wiki.yml` skips an `-alpha.` tag) and **no release line moves**: README, ACCURACY, the Disclaimer's copy and
LIMITATIONS keep naming the newest beta.
(`wiki.yml` skips an `-alpha.` tag) and **no release line moves**: README, ACCURACY, the Disclaimer's copy,
LIMITATIONS and ACCESSIBILITY keep naming the newest beta.
- **The cadence:** one alpha per beta, cut from it. Velopack's GitHub source reads the newest ten releases (one page,
`perPage` 10), so ten alphas in a row would hide every beta from the betas' own update check, and the other way round
(`11_UPDATER` §Channels).
@@ -545,7 +545,9 @@ Central package management makes Dependabot PRs single-file diffs.
**In the tree — done:**
- [x] Repo-local `ci.yml`, `codeql.yml`, `release.yml`, `rules-publish.yml` (all four repo-local by decision, §Workflows); ~~caller stubs pointing at `poli0981/.github`~~ — never the design, see the first paragraph *(and `wiki.yml` since beta.17, repo-local too: five)*
- [x] Issue forms `bug_report.yml`, `feature_request.yml`, `safety_gap.yml`; `ISSUE_TEMPLATE/config.yml` pointing a vulnerability at private reporting; PR template referencing CLAUDE.md's definition of done
- [x] Issue forms `bug_report.yml`, `feature_request.yml`, `safety_gap.yml`; `ISSUE_TEMPLATE/config.yml` pointing a vulnerability at private reporting; PR template referencing CLAUDE.md's definition of done *(and since 2026-11-09, beta.35, D88: `accessibility.yml`, the form `ACCESSIBILITY.md` sends a barrier to, and the PR template's user-interface section)*
- [x] The labels the forms apply exist *(2026-11-09: `accessibility`, and `safety` and `priority-high`, which `safety_gap.yml` had named since it was written (2026-08-02) while the repository had neither — GitHub applies only a label that exists, so no Safety gap report was ever labelled)*
- [x] `ACCESSIBILITY.md` — the accessibility statement: WCAG 2.2 AA through WCAG2ICT as a goal, never a claim; how a barrier is reported and handled (2026-11-09, D88)
- [x] `.github/dependabot.yml` (nuget + github-actions, weekly; a seven-day cooldown and the actions grouped since 2026-10-25 — and a NuGet library update it never proposed is `dotnet list package --outdated`'s to find, §Dependabot and the NuGet audit)
- [x] `SECURITY.md` — the private route for a vulnerability, the public route for a safety gap, and the honest response intent (2026-09-16)
- [x] A release rehearsal: `release.yml` `workflow_dispatch` runs every step but the Release itself (§release.yml)
+5
View File
@@ -209,9 +209,14 @@ that it was checked against anything.
| Mode | launch mode · attach mode · mid-session settings change |
| Safety | game with anti-cheat → toggle disabled · simulated late AC load → unhook · double-crash → auto-disable |
| Tier | forced Tier 2 (records duration, available sensors and the reason — and nothing else) · Tier 1 → Tier 2 degradation notice |
| Accessibility *(added 2026-11-09, beta.35, D88)* | **keyboard only** with the mouse disconnected — every page, menu and dialog, Ctrl+1…5, Esc · **Narrator** — names, values, headings, the notices as they appear · a **contrast theme** on and off (Aquatic, Desert) · Windows **animation effects** off · a large **display scale**. The owner's first pass: 2026-11-09, keyboard only and Narrator on 0.1.0-beta.34 and 0.1.0-alpha.3, no fault (`ACCESSIBILITY.md` §How it is checked; the automated half is `08_UI` §Accessibility) |
| Update | Velopack delta; update deferred while a game is hooked (FR-12) — *a delta needs a previous release, so this row is reachable from the second release, not the first* *(corrected 2026-10-04: no release has carried a delta — `release.yml` never fetches the previous release before `vpk pack`, `11_UPDATER` §Built — so the update leg is a full package; **since beta.13** a release carries a delta against the previous one, and the first
update that can use it is beta.12 → beta.13 — HANDOFF owner-only item 10)* |
## Release smoke
Clean-VM install → Legal Gate → Agent setup (unelevated) → add a game → consent dialog → hooked 2-min session → charts render → CSV opens in Excel → Vulkan layer registered/unregistered cleanly → uninstall removes layer registration, task, and asks about data.
*(Added 2026-11-09, beta.35, D88:)* and an **accessibility smoke**, the same build: the Legal Gate, the consent dialog and
the session summary reached and answered with the keyboard alone; Narrator reads the notice a refused game raises; the
window readable under one contrast theme. The release's owner-only item in `HANDOFF` lists what that release moved.
+62 -1
View File
@@ -62,6 +62,7 @@ private static readonly IHost _host = Host.CreateDefaultBuilder()
Theme rules:
- Manual Light/Dark: `ApplicationThemeManager.Apply(ApplicationTheme.Dark)`.
- System: `SystemThemeWatcher.Watch(mainWindow)` — call it in the window's `Loaded` handler (needs an HWND), and unwatch when switching to manual.
- A Windows contrast theme (beta.35, D91): wins over all three while it is on, and is never left to the watcher, which would apply WPF UI's own high-contrast files (§Gotchas). `Services/ThemePlan.For` is the table, `Services/WpfThemeApplier` applies it.
- Persist the choice in `settings`; re-apply before the main window shows to avoid a flash. **Measured 2026-09-13: this is a correctness rule, not a cosmetic one** — `ApplicationThemeManager.Apply(theme, backdrop, updateAccent: true)` is what registers the `SystemAccentColor*` resources the control templates `StaticResource` at first Measure; a `FluentWindow` shown before any `Apply` throws `XamlParseException: Cannot find resource named 'SystemAccentColorPrimary'`. The shell applies the theme in its constructor before `InitializeComponent()` and again from `Loaded` for the watcher.
- Subscribe `ApplicationThemeManager.Changed` once, centrally, to re-theme ScottPlot (below).
@@ -115,6 +116,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)
@@ -164,6 +173,22 @@ Native `Menu`, `TabControl`, `ComboBox`, `Slider`~~, `ListView`~~ are fine — t
WCAG contrast, black in both themes. The chart reads `ChartTheme.Current` at every render; the WPF chip in the list
(`Controls/ChangeBadge`) follows a switch through the same resource reference as `ArtTint` and `FgMixBar`
(`ChartPalette.ForBackground`). No colour in XAML.
- Third exception (beta.35, D91): **a Windows contrast theme's colours**, read from `SystemColors` in one place
(`Services/ContrastPalette.FromSystem`) and laid over the theme by `Services/ContrastOverlay` — never written in XAML. A
colour the App works out itself reads `Services.ContrastTheme.Active` first (the charts, the badges, the artwork band);
XAML that must change with it binds `{Binding Path=(services:ContrastTheme.IsOn)}`, a static property WPF hears through
its `StaticPropertyChanged` event.
- **`ui:Button Appearance="Danger"` / `Info` / `Success` / `Caution` / `Dark` / `Light` paint fixed colours** — values in
WPF UI 4.3.0's button style (`#F44336` for Danger), not resources, so no theme and no contrast theme reaches them, under
the theme's button text (white on the red in the dark theme, 3.68:1). Danger is the one the App uses: its implicit
`ui:Button` style (`Styles/FrameLedger.xaml`) puts the theme's dark text on the red, and the theme's own button under a
contrast theme — message boxes' buttons included. The other five are refused
(`ContrastThemeTests.NoButtonOrBadgeTakesAnAppearanceThatPaintsAFixedColour`).
- **A snackbar's appearances are fixed colours too** (`ISnackbarService.Show`): Success, Caution, Info, Danger, Primary,
Dark and Light are values under white or black text — Success 2.78:1, Caution 2.16:1 in both themes. Only Secondary is
the theme's: `Services/SnackbarStrip`, the one place a snackbar is shown, uses it for every message.
- **A `ui:Badge` with a BOUND palette appearance** is the same hole as a literal one, and no XAML scan of literals sees it
(the agent's pill, beta.35: `AgentPill` now). A bound badge appearance is refused by the same test.
## FlowDocument (rendered documents, beta.12)
@@ -207,7 +232,12 @@ var result = await box.ShowDialogAsync(); // Wpf.Ui.Controls.MessageBoxResult.Pr
⚠ Name clash with `System.Windows.MessageBox` — in App code, `using MessageBox = Wpf.Ui.Controls.MessageBox;` ~~and ban the System one (BannedSymbols/analyzer note)~~ *(corrected 2026-10-04: nothing bans it. Three paths use the Win32 box on purpose — the crash dialog, the startup-failure dialog and the uninstall question — because they run when the shell's dialog host cannot be trusted. Use the WPF UI one everywhere else.)*
- Rich in-flow dialogs: `IContentDialogService` (host wired in MainWindow — a `ui:ContentDialogHost`, since 4.3.0 marks `SetDialogHost(ContentPresenter)` obsolete).
- Transient in-app: `ISnackbarService.Show(title, message, ControlAppearance.Success, new SymbolIcon(SymbolRegular.Checkmark24), TimeSpan.FromSeconds(4))`.
- Transient in-app: ~~`ISnackbarService.Show(title, message, ControlAppearance.Success, new SymbolIcon(SymbolRegular.Checkmark24), TimeSpan.FromSeconds(4))`~~
`IMessageStrip` (`Info` / `Success` / `Warn`) — `Services/SnackbarStrip` is the one caller of `ISnackbarService.Show`, and
says each message to a screen reader (beta.35, D89). A view model never holds `ISnackbarService`.
- A change a screen reader must hear goes through `IAnnouncer` (`Services/UiaAnnouncer`, UI Automation's notification
event). **`AutomationProperties.LiveSetting` alone says nothing in WPF**: the app must raise `LiveRegionChanged` itself,
and no XAML of the App's sets one (beta.35).
- System/tray notifications: H.NotifyIcon only (08_UI §Notifications policy).
## ScottPlot theme sync
@@ -224,6 +254,15 @@ On startup and on `ApplicationThemeManager.Changed`: for every live plot set fig
> `Add.HorizontalSpan` for the ribbon, `Add.Bars` over `Statistics.Histogram.WithBinCount`, `Add.ScatterLine`
> for the percentile curve, a series' `Axes.YAxis = plot.Axes.Right` for the sensor overlay.
>
> **Accessible charts, beta.35 (D90).** Every plot in XAML is `charts:ChartPlot` (a `WpfPlot` subclass; ScottPlot's
> default style and input stay) with `AutomationProperties.Name` and `HelpText` from `A11y_Chart_*` / `A11y_ChartData_*`.
> `ChartTheme.Attach` adds `Charts/ChartKeys` (arrows and A marked handled after ScottPlot's class handler has acted — an
> instance handler runs after it) and `ResetOnDoubleClick` (`DoubleLeftClickBenchmark(false)` and a `DoubleClickResponse` on
> the left button that autoscales). A series takes `ChartPatterns.Line` / `Points` / `Hatch` by its index — a new series
> without one is red in `NoChartTellsTwoSeriesApartByColourAlone`. Under a Windows contrast theme `ChartTheme.Current` is
> `ChartPalette.ForContrast(ContrastTheme.Active)` — the theme's window under every plot, its text, link, highlight,
> button text and disabled text for the rest — and the patterns carry the series apart (D91).
>
> **The trend's change markers, beta.30 (D70):** `Charts/ChangeMarkerPlottable`, an `IPlottable` + `IRenderLast` added
> with `Add.Plottable` (which assigns no axes: the chart sets `Axes.XAxis`/`YAxis` itself), draws the dashed lines in
> `Render` — clipped to the data area — and the numbered badges in `RenderLast`, after the panels and unclipped, in a
@@ -244,6 +283,13 @@ On startup and on `ApplicationThemeManager.Changed`: for every live plot set fig
- [ ] **`WpfPlot.DisplayScale` is read once, in the constructor**, from `VisualTreeHelper.GetDpi` before the control has
a window. Read a pointer with `GetPlotPixelPosition(e)` (the element's DPI now); ScottPlot's pixels are device
pixels while no `Plot.ScaleFactor` is set, and none is.
- [ ] **WPF UI 4.3.0's high-contrast theme cannot be applied as it is** (beta.35, D91). `ApplicationTheme.HighContrast` has
no dictionary (the watcher picks HC1/HC2/HCBlack/HCWhite by Windows' theme name); each of those holds 84 `#FFFF0000`
placeholders among 97 colours and 17 brushes (`SystemFillColor*Brush`, `MenuBar*`) that throw when the file is read
alone — inside the App their forward references fall back to the application's resources and read as the Fluent
theme's fills; their colours are Windows 11's defaults, not the user's; their text on the accent is the window text.
Never let `SystemThemeWatcher` watch while a contrast theme is on: it would apply them. The App reads them for each
key's role only (§Theming & brushes; `08_UI` §Contrast).
- [ ] `SystemThemeWatcher.Watch` after HWND exists (`Loaded`), not in the constructor — but `ApplicationThemeManager.Apply(…, updateAccent: true)` BEFORE the first window's XAML loads, or the accent resources are missing at first Measure (§App bootstrap).
- [ ] Menu row lives **outside** `ui:TitleBar` (its area is the drag region; a Menu inside becomes undraggable/unclickable territory).
- [ ] Don't set `AllowsTransparency`/`WindowStyle` on `FluentWindow` — it manages its own chrome.
@@ -258,6 +304,21 @@ On startup and on `ApplicationThemeManager.Changed`: for every live plot set fig
bar with no exit, which is exactly how the safety notices shipped (2026-09-14). `Styles/FrameLedger.xaml` carries
the upstream template plus one presenter column; `PagesLoadTests.TheInfoBarTemplateRendersItsContent` renders both
templates and turns red when upstream gains a presenter, which is when the copy comes out.
- [ ] **What a screen reader is given is the UI Automation tree, and WPF builds it with four holes** (beta.35, D88;
`PagesLoadTests.Automation` sweeps every surface for each). (1) **A control with no automation peer** — a plain `Control`
or `ContentControl`, WPF UI's `Image`, `Card`, `Badge`, `InfoBar` (measured on .NET 10.0.14) — is skipped by the tree; if
it is also focusable (a `Control` is, by default) it is a Tab stop Narrator says nothing about. Give a display-only
control a peer (`Controls/SpokenTextAutomationPeer`) and take it out of the tab order; `ui:CardControl` has a peer with an
empty name even with a string `Header` — the App's implicit style takes it out of the tab order. (2) **A list's,
drop-down's or grid row's item is named by its `ToString()`**: a record's is its printed form (`Choice { Value = dark,
Label = Dark }`), a class's its full type name. Every item type overrides it (`Services/SpokenText` builds the words).
(3) **A `TextBlock` written straight into a `ControlTemplate` is no control element** (`TextBlockAutomationPeer`: not when
its templated parent is something other than a `ContentPresenter`): draw a template's text through a `ContentPresenter`
(the App's InfoBar template), or give the control a peer that says it. (4) **A `DataGridTemplateColumn`'s cell has no text
of its own**, so WPF names it `Item: <row>, Column Display Index: n`: name it with `controls:CellName.Path` (a cell style
based on `DefaultDataGridCellStyle`, the one WPF UI's grid gives every cell). Also: a plain `ItemsControl` is focusable
(the App's implicit style says no), and WPF UI's `CardExpander` leaves its expand button (`ExpanderToggleButton`)
unnamed (`Controls/ExpanderToggleName`, set by the App's implicit CardExpander style).
- [ ] **WPF UI 4.3.0 keys its DataGrid parts' styles and defines no implicit one** (`DefaultDataGridRowStyle`,
`DefaultDataGridCellStyle`, `DefaultDataGridColumnHeaderStyle`, handed to the grid by its implicit `DataGrid` style's
`RowStyle`/`CellStyle`/`ColumnHeaderStyle` setters). A local `RowStyle` replaces WPF UI's; based on
+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 |
+1 -1
View File
@@ -1913,7 +1913,7 @@ Each of these is referenced by an existing doc but specified nowhere.
| ~~**Threading model**~~ | ~~Which component owns which thread, UI-thread rules, and how the 1 Hz telemetry poller, 10 Hz drain and pipe reader interact~~ **Answered 2026-09-09 (P2 PR-C): `04_CAPTURE` §Threading model** — four threads, one owner per shared object, the pipe reader named as one more producer. This row was not struck when the section was written; struck 2026-09-13. What is still unspecified is the UI thread's own rules, which is `08_UI`'s in P3 | `04_CAPTURE`, `18_GPU_VENDOR_APIS` |
| **Pipe/shm security** | Stated as policy ("DACL granting the current user's SID") but not as implementable SDDL, nor who creates the objects with what rights. The shm half is built (`fl_shm_host.h`, the Overlay creates the section under the current user's SID); the pipe half is **built 2026-09-13 (P3 PR-1, HANDOFF §P3 decision D11)**: `D:P(A;;GA;;;<user>)(A;;GA;;;BA)` (with the owner `O:<user>` stated since 2026-09-17, `07_IPC` §C) handed to `CreateNamedPipe` with `PIPE_REJECT_REMOTE_CLIENTS`, and the client's token user compared by impersonation on its first frame (`Infrastructure.Ipc.PipeAccessControl`, pinned by `PipeServerClientTests` including the refused stranger). **Row closed** | `07_IPC` |
| ~~**Legal doc versioning**~~ | ~~FR-11 re-shows documents "when a document version increments". Nothing says where the current version lives, who writes `legal_acceptance.version`, or how the markdown is rendered in-app~~ **Answered 2026-09-14 (P3 PR-9):** the version is the document's own `**Version:**` line, read from the copy embedded in the App at build (`App.Services.LegalDocuments`); the App writes `legal_acceptance.version` on the one Accept and re-shows any document whose embedded version differs from its row; ~~the markdown is shown as text with authoring comments stripped, not rendered~~ the markdown is shown with authoring comments stripped and, since beta.12, rendered (`08_UI` §Menu, *Documents are rendered*; §First-run flow built note) | FR-11, `06_DATA_MODEL` |
| **Accessibility / DPI** | NFR-9 states requirements; no design anywhere | NFR-9, `08_UI` |
| ~~**Accessibility / DPI**~~ | ~~NFR-9 states requirements; no design anywhere~~ **Answered 2026-09-15 (P4 PR-8): `08_UI` §Accessibility** — what each clause of NFR-9 means here and the check that holds it; this row was not struck then. Since 2026-11-09 (beta.35, D88) the users' half is `ACCESSIBILITY.md`, and NFR-9 names screen readers and contrast themes too. **Row closed** | NFR-9, `08_UI` |
| **Uninstall / data deletion** | One Velopack clause. No in-app "delete all my data", despite the privacy position | `12_BUILD`, `legal/PRIVACY_POLICY.md` |
| ~~**Cover art**~~ | ~~Appears in the schema, the data directory and the UI; nothing says where it comes from or the licence position on downloaded store art~~ **Answered 2026-10-14 (beta.23, owner decisions D60/D61):** from the user's own image (a copy in `covers\`) or what the Steam and GOG GALAXY apps already keep on this PC — nothing is downloaded, so no store art is redistributed or fetched; the art stays its owners' (`legal/TRADEMARKS.md`), the Privacy Policy 2.11 names the files read. `08_UI` §Games › Game detail. **Row closed** | `06_DATA_MODEL`, `05_DETECTION` |
| **The main line's .NET** *(added 2026-10-31, D73–D76)* | **When does the main line — the betas and the first release — leave .NET 10 LTS, and for what?** The alpha line (`12_BUILD` §The alpha line) builds the same source on .NET 11 to gather the evidence; it decides nothing by existing. What is known: .NET 11 is STS, supported 24 months to about 2028-11, no later than .NET 10 LTS (2028-11-14), so moving buys no support time; Microsoft's supported-OS list for .NET 11 has Windows 10 only in its LTSC and IoT editions, against NFR-8's Windows 10 22H2 floor; C# 15's unions and closed hierarchies would suit the tri-states and refusal reasons, but only once the main line compiles C# 15. **Decision table, written before the evidence:** move to .NET 11 only if (a) at least two alphas on the GA runtime pass the gate and an owner's run of a hooked title with no runtime-specific defect, (b) the owner accepts dropping NFR-8's floor to Windows 11 or ships knowingly unsupported on Windows 10, and (c) something .NET 11 brings is wanted — a measured gain or a language feature; otherwise stay on .NET 10 and take .NET 12 LTS (expected 2027-11) the same way, through the alpha line first | `12_BUILD`, `13_CI_CD`, `02_SPEC` NFR-8, CLAUDE.md pinned stack |
+109 -72
View File
@@ -72,6 +72,8 @@ 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) |
| `§beta.34` | [`handoff/history/0.1.0-beta.34.md`](handoff/history/0.1.0-beta.34.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,87 +81,76 @@ 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-09, 0.1.0-beta.35: accessibility — a statement, what a screen reader is given and told, headings and charts, contrast themes, focus
*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.35.md`; this is what no other file carries.* The owner: "Bạn lên plan và thêm
phiên bản mới (nếu thực sự cần) cho mục accessibility: 1. đọc docs, check, sync và sửa, cập nhật thêm file
ACCESSIBILITY.md vào đúng vị trí. 2. Check các Accessibility đã có, đề xuất thêm accessibility nếu cần. 3. Đã dùng: bàn
phím only (tắt chuột) và narrators, không lỗi." — plan accessibility, with a new version if it is really needed: read,
check, sync and fix the documents and add `ACCESSIBILITY.md` where it belongs; check what exists and propose more; the
owner had used the keyboard alone, mouse disconnected, and Narrator, with no fault. With opensource.guide's
accessibility practices and the open-source-accessibility toolkit's `ACCESSIBILITY.md` template (MIT: its structure,
not its text). #366 (the statement, D88), #367 (names and peers), #368 (announcements, D89), #369 (headings and charts,
D90), #370 (contrast themes, D91, and three contrast holes outside them), #371 (focus and motion) and this release; no alpha (D92).
**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).
- **D88 — the accessibility statement**: `ACCESSIBILITY.md` at the repository's root, in the App under Help ▸
Accessibility and on the wiki. WCAG 2.2 at level AA, as W3C's WCAG2ICT applies it to desktop software, is a goal and
never a claim; a report is handled by severity, with no promised times; the owner's pass of 2026-11-09 — keyboard only
and Narrator, on 0.1.0-beta.34 and 0.1.0-alpha.3, no fault — is its first evidence by hand.
- **D89 — what appears is said to a screen reader**: UI Automation notifications for a safety notice, the agent's and
the update's banners, every snackbar, a game page's notice and Database maintenance's results, only while
FrameLedger's window is the active one.
- **D90 — headings and charts**: a page's title is a heading of level 1, a section's title level 2; every chart is
named with where its numbers are written; no chart tells two series apart by colour alone.
- **D91 — Windows contrast themes are followed**, whatever Settings ▸ Theme says.
- **D92 — beta.35 in this train and no alpha**; alpha.4 is the move to .NET 11's release (SDK `11.0.100`, packages
`11.0.0`), a task of its own after 2026-11-10.
**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.
- **A contrast theme is the user's colours by role**, not WPF UI's high-contrast files (84 red placeholders among 97
colours, 17 brushes that throw, Windows 11's defaults) and not a hand list of keys: every key of the four files takes
the colour of the role it has in all of them, opaque colours only (`ContrastRoles`), over the light or the dark Fluent
theme as the contrast theme is; the text on the accent is the highlight's text, the App's choice.
- **What must change while it is shown binds `ContrastTheme.IsOn`**, a static property WPF hears through
`StaticPropertyChanged`: the implicit button style, the Settings line. The charts, the badges and the artwork band read
`ContrastTheme.Active` when they draw.
- **The snackbars lost their green and orange** (white on fixed colours, 2.16–2.78:1 in both themes): every message is
Secondary, its icon saying the kind. **The agent's pill is a `Pill` on the theme's fills**, no longer a badge.
- **A content dialog's focus is WPF UI's**: its host stores and restores the focused element; a test pins it. Message
boxes get the App's active window as owner (`MessageBoxes`), which WPF UI's leaves null.
- **A page shortcut focuses the page's first control and says its first level-1 heading** (`PageFocus`); a click in the
pane leaves the focus where WPF UI puts it.
- **Left as limitations, with what to do instead** (`ACCESSIBILITY.md` §Known limitations): a chart's points one by
one, headings inside the documents the App shows (a FlowDocument paragraph has no peer), the snackbars' four seconds,
Windows' text size, pausing only from the tray.
**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 UI Automation tree WPF builds, on .NET 10.0.14 — items named by `ToString()`, peerless
focusable controls, a template's text hidden from the control view, template cells read as *Item: …* (`16_WPFUI_SYNTAX`
§Gotchas); WPF UI 4.3.0's high-contrast files, its Button, Badge and Snackbar appearances (fixed colours, the ratios
above), its message box's missing owner and its content dialog host's focus restore; ScottPlot 5.1.59's keys (focusable,
none marked handled) and its double-click benchmark.
**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.
- **A `ContentDialog` test needs the dispatcher's context.** `ContentDialog.ShowAsync` takes the dialog out of its host
in a `finally` after an await; on a test thread with no `DispatcherSynchronizationContext` that never resumes on the UI
thread, the dialog stays in its host and the focus on its button — a first measurement concluded WPF UI kept the focus
there; it does not.
- **A test that listens to a static event hears every test's**: subscribe inside the one STA work item.
- **Inside the App, a brush that throws when WPF UI's file is read alone falls back to the application's resources**, the
Fluent theme's translucent fills: `MenuBarItemBackgroundPressed` read as the window text's white. Count only opaque
colours as evidence.
- **WPF calls a resource reference's callback when a merged dictionary changes, even for an equal value** (Aquatic's
window is the dark theme's `#202020`): no second signal was needed, measured and pinned.
- **A forward `StaticResource` in a style dictionary fails only when that resource is first used** — `AgentPill`
`BasedOn` `Pill`, placed above it: the dictionary loaded, the style threw when found.
- **Python's `"\b"` in a non-raw string is a backspace** — it went into a C# regex twice; write regexes raw.
- **`RenderTargetBitmap.Render(child)` draws the child at its offset**: sample a child's pixel through its parent.
**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.
**Owner-only:** item 32 — beta.35 on real hardware.
## Owner-only — no PR can close these
@@ -264,7 +255,9 @@ an alpha's release has to find — #350's lookup, by the name the pack lists. It
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
@@ -361,13 +354,47 @@ an alpha's release has to find — #350's lookup, by the name the pack lists. It
`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_*`.
31. **0.1.0-alpha.3 on real hardware** (D73, D87). (a) **The update from alpha.2**: Help ▸ Check for updates offers
alpha.3 and *Restart to update* installs it; say whether it downloaded the delta or the whole package. (b) The terms
window shows the Disclaimer 2.13, the Privacy Policy 2.14 and the Alpha notice with its box again, and Accept waits for
the tick. (c) `%LOCALAPPDATA%\FrameLedger\backups\ledger-before-0.1.0-alpha.3.db` exists beside alpha.2's, and opens;
the ledger it left is at schema 22. (d) Item 30's checks, on the alpha.
32. **beta.35 on real hardware** (D88–D91). (a) **The update from beta.34** (or alpha.3's): no terms window, the ledger
unchanged. (b) **Narrator**: a safety notice is read as it appears; the agent's banner going and coming; Tools ▸
Database maintenance ▸ Check reads its result; a short message at the bottom is read; **H** moves between each page's
title and its sections; Settings ▸ Theme's options read their words; the Sessions table's cells read their values;
Tab to a chart says its name and where its numbers are, and its arrows, Ctrl+arrows and A move it without scrolling
the page; a double-click shows all of it. (c) **Contrast themes**: Aquatic and Desert, and one with an edited colour
(Windows 10 if at hand) — every page, a dialog, the title bar's agent pill, a short message, a chart; turned on and
off with FrameLedger open, it follows at once; Settings ▸ Theme shows its line. (d) **Ctrl+1 … Ctrl+5** put the
keyboard in the page and Narrator says its title. (e) **Animation effects off** (Settings ▸ Accessibility ▸ Visual
effects): no page slides in. (f) **Remove** on a game's page: the box opens over the window, its Cancel puts the focus
back on Remove; the light theme's agent pill and a *done* message read clearly. (g) Help ▸ Accessibility shows the
statement. (h) The 35 `ja` strings this release adds, all marked `review`: `Menu_Help_Accessibility`,
`Accessibility_Title`, `Settings_Theme_ContrastOn` and 32 `A11y_*` (the names, the chart names and keys, the
announcements).
**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 —
@@ -463,7 +490,17 @@ Where each owner decision is recorded — the file and its section, and a label
| D79 | [`05_DETECTION.md`](05_DETECTION.md) §Platform signatures & metadata | the platform is "Xbox" (`xbox`), in full: import, artwork, Play, capture, detection, docs and legal |
| 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) |
| D82 | [`handoff/history/0.1.0-beta.33.md`](handoff/history/0.1.0-beta.33.md) | 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/history/0.1.0-beta.34.md`](handoff/history/0.1.0-beta.34.md) | alpha.3 right after beta.34, on RC3 (before .NET 11's release, 2026-11-10) |
| D88 | [`../ACCESSIBILITY.md`](../ACCESSIBILITY.md) | the accessibility statement at the root, under Help ▸ Accessibility and on the wiki: WCAG 2.2 AA through WCAG2ICT is a goal, never a claim; reports by severity, no promised times |
| D89 | [`08_UI.md`](08_UI.md) §Screen readers | what appears is said to a screen reader — notices, the agent's and the update's banners, the snackbars, a game page's notice, Database maintenance's results — while FrameLedger's window is active |
| D90 | [`08_UI.md`](08_UI.md) §Screen readers | page titles heading 1, section titles heading 2; every chart named with where its numbers are; no series told apart by colour alone |
| D91 | [`08_UI.md`](08_UI.md) §Contrast | Windows contrast themes are followed, whatever Settings ▸ Theme says |
| D92 | [`HANDOFF.md`](HANDOFF.md) §START HERE | beta.35 in this train, no alpha; alpha.4 is the move to .NET 11's release (SDK 11.0.100, packages 11.0.0), a task of its own after 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).
+5 -1
View File
@@ -11,7 +11,7 @@ This folder is for people who build, change or review FrameLedger. **If you only
| Find your way around first | The [wiki](https://github.com/poli0981/frameledger/wiki)'s developer pages (source: [`../wiki/`](../wiki/), beta.17) — a short page per part, each linking here |
| Learn the system | [`../CLAUDE.md`](../CLAUDE.md) (the rules and the layout), then the reading order below |
| Build it | [`12_BUILD.md`](12_BUILD.md) — `./build.ps1 check` is the whole gate, the same one CI runs |
| Contribute or fork | [`../CONTRIBUTING.md`](../CONTRIBUTING.md), [`../FORKING.md`](../FORKING.md), [`../NOTICE`](../NOTICE) |
| Contribute or fork | [`../CONTRIBUTING.md`](../CONTRIBUTING.md), [`../FORKING.md`](../FORKING.md), [`../NOTICE`](../NOTICE), [`../CODE_OF_CONDUCT.md`](../CODE_OF_CONDUCT.md) *(it and `SECURITY.md`, below, added 2026-11-09: the index named neither)* |
**Status lives in four places, and nowhere else** — check a status claim against the code before you plan on it:
@@ -87,5 +87,9 @@ are safety items, and something listed there as unresolved should not be built t
- [`../legal/`](../legal/) — the documents a user accepts, the accuracy statement, the third-party notices and licence
texts, the trademark note.
- [`../LIMITATIONS.md`](../LIMITATIONS.md) — what the whole software cannot do, in a player's words.
- [`../ACCESSIBILITY.md`](../ACCESSIBILITY.md) — the accessibility statement (beta.35, D88): the goal, what works with the
keyboard, a screen reader and contrast themes, the known limits and how a barrier is reported; shown in the App under
Help ▸ Accessibility. Its checks are [`08_UI.md`](08_UI.md) §Accessibility.
- [`../SECURITY.md`](../SECURITY.md) — the private route for a vulnerability, and why the guard has no override.
- [`../rules/detection-rules.json`](../rules/detection-rules.json) — engine, platform and capability signatures and the
anti-cheat blocklist, validated by `tools/rules-validate.ps1`.
+36
View File
@@ -0,0 +1,36 @@
<!-- The third alpha's notes (D73, D87), on main as every release's are; the alpha branch takes them with its sync. CHANGELOG.md lists every release. -->
## [0.1.0-alpha.3] - 2026-11-06
> ⚠ **EXPERIMENTAL BUILD — YOU USE IT AT YOUR OWN RISK.** This is an **alpha**: the source of `0.1.0-beta.34` 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 third alpha: `0.1.0-beta.34` on .NET 11 RC3** — 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 beta's notes, `docs/changelog/0.1.0-beta.34.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.2`:** 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.3.db` (the newest three copies are kept). The terms window
shows the **Disclaimer 2.13** and the **Privacy Policy 2.14** 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 moves to schema 22, which an
alpha.2 cannot open (the copy is the database as alpha.2 left it; going back is to the newest beta, which opens it); the
detection rules move to `2026.11.2`.
**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.34
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.
+91
View File
@@ -0,0 +1,91 @@
<!-- Moved from CHANGELOG.md's [Unreleased] when 0.1.0-beta.35 was cut, 2026-11-09 (D66). CHANGELOG.md lists every release. -->
## [0.1.0-beta.35] - 2026-11-09
**The thirty-fifth pre-release: accessibility.** An accessibility statement (Help ▸ Accessibility); a screen reader
that reads every control and value in its words and is told what appears; headings and charts it can use; Windows
contrast themes followed; the keyboard following a page shortcut, and a message box opening over the window. And three
places where text read below WCAG's 4.5:1 in a Fluent theme, found on the way: the agent's pill, two kinds of short
message, a destructive button. The same unsigned installer: verify its hash against `SHA256SUMS.txt`, then *More info →
Run anyway*.
**Updating from `0.1.0-beta.34`:** Help ▸ Check for updates, then *Restart to update* with no game running. The legal
texts keep their versions, so nothing is shown for you to accept; the ledger stays at schema 22 and the detection rules
at `2026.11.2`. Nothing about capture or measurement changes.
### Added
- **An accessibility statement** (owner request 2026-11-09, decision D88). `ACCESSIBILITY.md` says what FrameLedger aims
for — WCAG 2.2 at level AA as W3C's WCAG2ICT applies it to desktop software, a goal and not a claim of conformance —
what works with the keyboard alone, a screen reader, a contrast theme or Magnifier, how it is checked (the project's
tests, and the owner's pass of 2026-11-09: keyboard only and Narrator on 0.1.0-beta.34 and 0.1.0-alpha.3, no fault),
what does not work yet and what to do instead, and how a barrier is reported and handled — by severity, with no
promised times. The app shows it under **Help ▸ Accessibility**, and after Limitations in the user guide's window; the
wiki gets an *Accessibility* page.
- **An *Accessibility problem* issue form** (`.github/ISSUE_TEMPLATE/accessibility.yml`) asking what was tried, what
happened and what the reporter uses — never anything about the reporter themself — and a user-interface section in the
pull-request template. The `accessibility` label exists, and so do `safety` and `priority-high`, which the *Safety gap*
form had named since its first day without either existing — so GitHub had never applied them.
- **A screen reader reads what the window shows** (decision D88's goal; measured in the UI Automation tree WPF builds on
every page, window and dialog, every tab — `PagesLoadTests.Automation`). Drop-down options were read as an internal
record (*Choice { Value = dark, Label = Dark }*), lists and table rows by their program names, table cells drawn by a
template as *Item: …, Column Display Index: n*, and the terms window's list by each document's whole text; each now
reads the words it shows, and an empty cell reads *empty*. The frame-rate readout says Native, Displayed and the
factor together (CLAUDE.md rule 6, in speech), a ray-tracing chip its value and where it came from, a change badge its
number. The safety notices' title and message reach a screen reader (they were hidden inside the notice's template),
and the notice's button says which notice it answers. A button repeated on each row names its row (*Open: …*, *Play:
…*, *Turn off: …*). Tab no longer stops on pictures, lists, Settings' rows, the FPS readout, the chips or the dialog
host, where it found nothing to say; an expander's button is named after its header.
- **A screen reader is told what appears** (owner decision D89): a safety notice as it arrives, the capture agent going
offline and coming back, an update's steps (not each percent), every short message at the bottom of the window, a
notice on a game's page and each result of Tools ▸ Database maintenance — in the words shown, and only while
FrameLedger's window is the active one, so a game that has the screen is never interrupted. The database line's live
region, which announced nothing, is gone.
- **Headings and charts a screen reader can use** (owner decision D90). Every page's title is a first-level heading and
each section title a second-level one, so a screen reader's heading keys move between sections. Every chart says what
it is and where its numbers are written as text; its keys — arrows to move, Ctrl with an arrow to zoom, A to see all of
it — now stay with the chart instead of also scrolling the page or moving the focus on, and its focus is drawn. No
chart tells two series apart by colour alone any more: Compare's five sessions, the GPU's temperature and its hot spot,
the two kinds of stutter, the two lows and the two limits each have their own line pattern, marker or hatch.
- **Windows contrast themes are followed** (owner decision D91). With a contrast theme on — Aquatic, Desert, Dusk, Night
sky, or one whose colours were edited, on Windows 10 or 11 — every colour in FrameLedger's windows is one of that
theme's, whatever Settings ▸ Theme says, and it changes the moment the theme is turned on, edited or turned off;
Settings ▸ Theme says so under its box. Before, *System* could apply WPF UI's own high-contrast files, most of whose
colours are a red placeholder, and the next window opened put the light or the dark theme back. The charts draw in the
theme's colours, their patterns telling the series apart; the frame-generation, ray-tracing and upscaler chips are the
theme's highlight and its text (WPF UI's files put the window text there, 1.26–1.78:1); a destructive button is the
theme's own button; a pressed menu item is no longer white on white; nothing is drawn translucent, and a game's picture
lends its page no colour, as before.
- **The keyboard follows a page shortcut.** **Ctrl+1** … **Ctrl+5** now move the focus into the page they open — its
first control — and a screen reader hears the page's title; before, the focus stayed where it was, often on the page
that had just gone, and Tab began again at the top of the window.
- **Pages no longer slide in while Windows' animation effects are off** (Settings ▸ Accessibility ▸ Visual effects),
followed as the setting changes.
### Fixed
- **A message box opens over FrameLedger's window** — Remove game, Delete sessions, the database's and the update's
questions. It had no owner, so it could fall behind the window it came from and, closing, give the focus to another
program; it is owned by the window that opened it now, and the focus comes back there.
- **A double-click on a chart shows all of it again**, as the user guide said; it toggled ScottPlot's render-time overlay.
- **The capture agent's state in the title bar reads in the light theme.** It was drawn on WPF UI's fixed green, blue,
orange and red under white — 2.78, 2.63, 2.16 and 3.68:1 — and is on the theme's own success, caution and critical
fills now, as the notices are; its words say the state.
- **The short messages at the bottom of the window read.** A *done* or a *warning* message was white on a fixed green or
orange, 2.78:1 and 2.16:1 in both themes; every message is in the theme's colours now, its icon saying which kind.
- **A destructive button's label reads in the dark theme** — Remove on a game's page, Delete in the confirmations: the
theme's dark text on the red, 5.3:1 and 5.7:1, where white read 3.68:1.
### Changed
- **Documents corrected**: charts do take focus and keys (`docs/08_UI.md` said neither — `ChartKeyboardTests` measures
it); the database-maintenance result's live region announced nothing, since WPF raises one only when the app does; the
"no Narrator pass" gap is the owner's pass now, beside what that pass could not show; the open question "Accessibility
/ DPI: no design anywhere" is closed; NFR-9 names screen readers and contrast themes (D88–D91). `LIMITATIONS.md` gains an
*Accessibility* section and loses its one struck sentence — a screen reader reads struck text as current, so no page
the app shows strikes text through. The guide's menu table names its menu on every row, read one row at a time.
+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.
+90
View File
@@ -0,0 +1,90 @@
# HANDOFF history — 0.1.0-beta.34
*Moved verbatim from `docs/HANDOFF.md` when 0.1.0-beta.35 was cut, 2026-11-09 (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-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.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):**
- **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.
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:**
- **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:** 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:**
- **`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 30 — beta.34 on real hardware.
### 0.1.0-alpha.3 — the third alpha, the same day (D87)
`alpha` takes main at this pull request — `v0.1.0-beta.34` and these notes, no other change — by a merge commit, as
`13_CI_CD` §The alpha line says. One file the switch holds moved on main — `legal/THIRD_PARTY_NOTICES.md`, its
Streamline row (#358) — on a line the switch does not touch (the switch changes the *Transitive* row), so the merge
takes both without a conflict (`git merge-tree` before the pull request); main's package set did not move, and the
switch stays 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) — the train reached it before .NET 11's release. 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.3` on `alpha`, with its delta
from alpha.2. Its notes are `docs/changelog/0.1.0-alpha.3.md`, which open with the experimental-build warning. It is
the first alpha whose ledger moves (schema 22): the copy it makes first is the database as alpha.2 left it, and going
back is to the newest beta, which opens schema 22.
- **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 31 — the third 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.
+7 -4
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,
@@ -70,7 +72,8 @@ correct it by hand — your correction is labelled as yours.
shows the same. *Sessions at a glance* numbers the same days the same way.
- **Compare** (in the navigation on the left) — pick sessions, even of different games, and see them side by side.
To look closer, hold **Ctrl** and turn the mouse wheel over a chart to zoom, drag to pan, and double-click to reset. The
To look closer, hold **Ctrl** and turn the mouse wheel over a chart to zoom, drag to pan, and double-click to see all of
it again — or Tab to the chart and use the arrow keys, **Ctrl** with an arrow to zoom, and **A**. The
wheel alone scrolls the page.
## Export
+28 -17
View File
@@ -27,20 +27,21 @@ stopped, hooking turned off — each with one button that only says you have rea
| Menu | Item | What it does |
|---|---|---|
| **File** | **Add game…** | Pick a game's `.exe` file. It is added with hooking off, and its page opens. |
| | **Import library…** | A checklist of the games installed through Steam, GOG Galaxy, Epic, itch.io and the Xbox app (or the Microsoft Store). |
| | **Export** ▸ **Session CSV** · **Session JSON** · **Chart PNG** | Saves the session you last selected or opened. Read [Your data](05-your-data.md) before you share a file. |
| | **Exit** | Quits FrameLedger, even when *Minimize to tray on close* is on. |
| **File** | **Import library…** | A checklist of the games installed through Steam, GOG Galaxy, Epic, itch.io and the Xbox app (or the Microsoft Store). |
| **File** | **Export** ▸ **Session CSV** · **Session JSON** · **Chart PNG** | Saves the session you last selected or opened. Read [Your data](05-your-data.md) before you share a file. |
| **File** | **Exit** | Quits FrameLedger, even when *Minimize to tray on close* is on. |
| **Tools** | **Agent status…** | Opens the Dashboard, where the agent's card is. |
| | **Update detection rules** | The agent reads its detection rules again and checks your games again. |
| | **Vulkan layer registration…** | Opens Settings, where the Vulkan layer is. |
| | **Open data folder** | Opens `%LOCALAPPDATA%\FrameLedger` in Explorer. |
| | **Database maintenance…** | **Check**, **Back up…**, **Sweep…** and **Compact** your database ([When something goes wrong](09-troubleshooting.md#the-database)). |
| **Tools** | **Update detection rules** | The agent reads its detection rules again and checks your games again. |
| **Tools** | **Vulkan layer registration…** | Opens Settings, where the Vulkan layer is. |
| **Tools** | **Open data folder** | Opens `%LOCALAPPDATA%\FrameLedger` in Explorer. |
| **Tools** | **Database maintenance…** | **Check**, **Back up…**, **Sweep…** and **Compact** your database ([When something goes wrong](09-troubleshooting.md#the-database)). |
| **Help** | **User guide** | This guide. |
| | **Check for updates** | Asks GitHub now. |
| | **Report a bug…** | Builds a report on your PC ([When something goes wrong](09-troubleshooting.md#report-a-problem)). |
| | **Online documentation** | The project's page on GitHub. |
| | **Limitations** | What FrameLedger cannot do. |
| | **About FrameLedger** | The version, the licences and the notices. |
| **Help** | **Check for updates** | Asks GitHub now. |
| **Help** | **Report a bug…** | Builds a report on your PC ([When something goes wrong](09-troubleshooting.md#report-a-problem)). |
| **Help** | **Online documentation** | The project's page on GitHub. |
| **Help** | **Limitations** | What FrameLedger cannot do. |
| **Help** | **Accessibility** | What works with the keyboard alone, a screen reader or a contrast theme, what does not yet, and how to report a problem. |
| **Help** | **About FrameLedger** | The version, the licences and the notices. |
## Dashboard
@@ -59,6 +60,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 +112,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
@@ -128,8 +133,14 @@ is ready.
## Keyboard and mouse
- **Ctrl+1** … **Ctrl+5** open Dashboard, Games, Compare, Logs and Settings.
- **Alt** or **F10** moves to the menus.
- **Ctrl+1** … **Ctrl+5** open Dashboard, Games, Compare, Logs and Settings, and put the keyboard in that page.
- **Alt** or **F10** moves to the menus; **Alt** with a menu's underlined letter opens it (**Alt+F**, **Alt+T** and
**Alt+H** for File, Tools and Help in English).
- **Esc** closes a dialog the way its Close or Cancel button does.
- Over a chart, **Ctrl** and the mouse wheel zoom, dragging pans, and a double-click resets. The wheel alone scrolls the
page.
- Over a chart, **Ctrl** and the mouse wheel zoom, dragging pans, and a double-click shows all of it again. The wheel
alone scrolls the page.
- **Tab** reaches a chart; then the **arrow keys** move its view, **Ctrl** with an arrow zooms, and **A** shows all of it
again.
What works with the keyboard alone, a screen reader or a contrast theme — and what does not yet — is on its own page:
[Accessibility](../ACCESSIBILITY.md) (Help ▸ Accessibility).
+2 -2
View File
@@ -41,8 +41,8 @@ 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 |
| **Theme** | Follow system, Light or Dark. Applies at once. While a Windows contrast theme is on, FrameLedger uses that theme's colours whatever you choose here, and says so under the box. | Follow system |
| **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
+2 -1
View File
@@ -20,7 +20,8 @@ Each page below takes a minute or two to read. The first six are the guide; the
12. [The terms, in plain words](terms-in-plain-words.md)
What FrameLedger cannot do is listed on its own page: [Limitations](../LIMITATIONS.md) (in the app: Help ▸
Limitations).
Limitations). How it works with the keyboard alone, a screen reader or a contrast theme, and how to report a problem:
[Accessibility](../ACCESSIBILITY.md) (Help ▸ Accessibility).
**FrameLedger is beta software.** It certainly still has bugs. If something goes wrong, Help ▸ Report a bug… builds a
report on your PC that you can look at before you decide to share it.
+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.35`** (2026-11-09), 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.35`** (2026-11-09), 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" ] },
+3
View File
@@ -329,6 +329,7 @@ public partial class App : System.Windows.Application
builder.Services.AddSingleton(appearance);
builder.Services.AddSingleton(registered);
builder.Services.AddSingleton(closePolicy);
builder.Services.AddSingleton<IContrastSource, SystemContrastSource>(); // beta.35 (D91): a contrast theme wins
builder.Services.AddSingleton<IThemeApplier, WpfThemeApplier>();
// The Agent link, the Run entry, the Agent's maintenance flags and the updater: a viewer's composition holds none of
@@ -378,6 +379,7 @@ public partial class App : System.Windows.Application
services.AddSingleton<TrayViewModel>();
services.AddSingleton<TrayHost>();
services.AddTransient<MainWindow>();
services.AddSingleton<PageFocus>(); // beta.35: Ctrl+1…5 put the keyboard in the page they open
services.AddSingleton<MainWindowViewModel>();
services.AddSingleton<ILanguageFollower>(static sp => sp.GetRequiredService<TrayHost>());
services.AddSingleton<ILanguageFollower>(static sp => sp.GetRequiredService<MainWindowViewModel>());
@@ -398,6 +400,7 @@ public partial class App : System.Windows.Application
services.AddSingleton<IGamePicker, GamePicker>();
services.AddSingleton<IConfirmations, Confirmations>();
services.AddSingleton<AddGameFlow>();
services.AddSingleton<IAnnouncer, UiaAnnouncer>(); // beta.35 (D89): what appears is said to a screen reader
services.AddSingleton<IMessageStrip, SnackbarStrip>();
services.AddSingleton<IEditGamePrompt, EditGamePrompt>();
@@ -27,4 +27,7 @@ public sealed record ChangeMarker(int Number, DateTimeOffset At, IReadOnlyList<s
/// <summary>The tooltip near the marker: the number and the day, then the changes.</summary>
public string ToolTipText => string.Format(CultureInfo.CurrentCulture, Strings.Trend_Change_Heading_Format, NumberText, DateText) + Environment.NewLine + Text;
/// <summary>The row as a screen reader reads it (beta.35, D88): its number — the chart's badge — the day and the changes.</summary>
public override string ToString() => string.Format(CultureInfo.CurrentCulture, Strings.A11y_ChangeMarker_Format, NumberText, DateText, SpokenText.List([.. Lines]));
}
+35
View File
@@ -0,0 +1,35 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using System.Windows.Input;
using ScottPlot.WPF;
namespace FrameLedger.App.Charts;
/// <summary>
/// The keys of a chart that has the focus (beta.35, D90). ScottPlot reads them — the arrows move the view, Ctrl with an arrow
/// zooms, A shows all of it — and marks none handled, so the page around a chart acted on the same arrow too: it scrolled,
/// or moved the focus on, and a pan lasted one keypress (<c>ChartKeyboardTests</c>). After ScottPlot has acted, these keys
/// are the chart's alone; Tab and every other key go on as before.
/// </summary>
public static class ChartKeys
{
/// <summary>Whether a key that reached a focused chart is the chart's: an arrow (with or without Ctrl, Shift or Alt) or A.</summary>
public static bool IsTheCharts(Key key) => key is Key.Left or Key.Right or Key.Up or Key.Down or Key.A;
/// <summary>
/// Keeps the chart's keys from the page. An instance handler runs after the class's own — ScottPlot's
/// <c>OnKeyDown</c> — so the plot has already moved when the key is marked.
/// </summary>
public static void Attach(WpfPlot control)
{
ArgumentNullException.ThrowIfNull(control);
control.KeyDown += static (_, e) =>
{
if (IsTheCharts(e.Key))
{
e.Handled = true;
}
};
}
}
+20 -2
View File
@@ -62,8 +62,26 @@ public sealed record ChartPalette(
/// element drawn in the chart colours follows a theme switch: a resource reference to <c>ApplicationBackgroundColor</c>,
/// read here (<c>FgMixBar</c>, <c>ChangeBadge</c>).
/// </summary>
public static ChartPalette ForBackground(System.Windows.Media.Color background) =>
For(Services.ColorMath.Luminance(background) < 0.5 ? ApplicationTheme.Dark : ApplicationTheme.Light);
public static ChartPalette ForBackground(System.Windows.Media.Color background) => Services.ContrastTheme.Active is { } contrast
? ForContrast(contrast)
: For(Services.ColorMath.Luminance(background) < 0.5 ? ApplicationTheme.Dark : ApplicationTheme.Light);
/// <summary>
/// The palette under a Windows contrast theme (beta.35, D91): only the theme's own colours — the window under every plot,
/// its text for the axes and the first series, then the link, the highlight, the button text and the disabled text in
/// turn — the series told apart by their patterns as well (<see cref="ChartPatterns"/>), since a contrast theme has few.
/// </summary>
public static ChartPalette ForContrast(Services.ContrastPalette contrast)
{
ArgumentNullException.ThrowIfNull(contrast);
Color window = ChartTheme.ToScottPlot(contrast.Window);
Color text = ChartTheme.ToScottPlot(contrast.WindowText);
Color link = ChartTheme.ToScottPlot(contrast.HotTrack);
Color highlight = ChartTheme.ToScottPlot(contrast.Highlight);
Color button = ChartTheme.ToScottPlot(contrast.ButtonText);
Color gray = ChartTheme.ToScottPlot(contrast.GrayText);
return new ChartPalette(window, window, text, gray, text, link, highlight, link, text, link, highlight, highlight, text, button, gray, button);
}
/// <summary>A palette from any dictionary carrying the keys (the tests hand in a parsed file).</summary>
public static ChartPalette FromDictionary(ResourceDictionary dictionary)
@@ -0,0 +1,62 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using ScottPlot;
using ScottPlot.Plottables;
namespace FrameLedger.App.Charts;
/// <summary>
/// No two series of one chart told apart by colour alone (beta.35, D90; WCAG 2.2 1.4.1): a chart's lines cycle through the
/// line patterns, its point series through the marker shapes, its shaded spans through the hatches — as the latency chart
/// already drew its average dashed and its 95th percentile dotted. A reader who does not tell the palette's red from its
/// green, and a Windows contrast theme with a handful of colours, still tell the series apart. <c>ChartPatternsTests</c>
/// reads every chart's legend for two entries that differ by colour only.
/// </summary>
public static class ChartPatterns
{
/// <summary>The line patterns, in the order a chart's lines take them.</summary>
public static IReadOnlyList<LinePattern> Lines { get; } = [LinePattern.Solid, LinePattern.Dashed, LinePattern.Dotted, LinePattern.DenselyDashed];
/// <summary>The marker shapes, in the order a chart's point series take them; the fifth and later lines carry one too.</summary>
public static IReadOnlyList<MarkerShape> Markers { get; } = [MarkerShape.FilledCircle, MarkerShape.FilledTriangleUp, MarkerShape.FilledSquare, MarkerShape.FilledDiamond, MarkerShape.OpenCircle];
/// <summary>The pattern of a chart's <paramref name="index"/>th line, and from the fifth on a marker beside it.</summary>
public static void Line(Scatter line, int index)
{
ArgumentNullException.ThrowIfNull(line);
line.LinePattern = Lines[index % Lines.Count];
if (index >= Lines.Count)
{
line.MarkerShape = Markers[(index / Lines.Count - 1) % Markers.Count];
line.MarkerSize = 6;
}
}
/// <inheritdoc cref="Line(Scatter, int)"/>
public static void Line(SignalXY line, int index)
{
ArgumentNullException.ThrowIfNull(line);
line.LinePattern = Lines[index % Lines.Count];
if (index >= Lines.Count)
{
line.MarkerShape = Markers[(index / Lines.Count - 1) % Markers.Count];
line.MarkerSize = 6;
}
}
/// <summary>The marker of a chart's <paramref name="index"/>th point series.</summary>
public static void Points(Scatter points, int index)
{
ArgumentNullException.ThrowIfNull(points);
points.MarkerShape = Markers[index % Markers.Count];
}
/// <summary>The hatch of a chart's <paramref name="index"/>th kind of shaded span: stripes, then dots, then a checker.</summary>
public static IHatch Hatch(int index) => (index % 3) switch
{
0 => new ScottPlot.Hatches.Striped(),
1 => new ScottPlot.Hatches.Dots(),
_ => new ScottPlot.Hatches.Checker(),
};
}
+44
View File
@@ -0,0 +1,44 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using System.Windows;
using System.Windows.Automation;
using System.Windows.Automation.Peers;
using ScottPlot.WPF;
namespace FrameLedger.App.Charts;
/// <summary>
/// The App's chart (beta.35, D90): ScottPlot's <see cref="WpfPlot"/> with a voice. ScottPlot's control is a Tab stop with no
/// automation peer, so a screen reader reached every chart and said nothing. This one is an Image a screen reader names —
/// the chart's <c>AutomationProperties.Name</c> — whose help text says where its numbers are written as text and which keys
/// move it (<see cref="ChartKeys"/>). Everything else is ScottPlot's: the subclass keeps its default style and its input.
/// </summary>
public sealed class ChartPlot : WpfPlot
{
public ChartPlot()
{
// The keyboard's focus is drawn as on every other control (WPF UI's focus rectangle), not left to ScottPlot's surface.
SetResourceReference(FocusVisualStyleProperty, "DefaultControlFocusVisualStyle");
}
protected override AutomationPeer OnCreateAutomationPeer() => new ChartPlotAutomationPeer(this);
/// <summary>A chart to a screen reader: an image named by the chart, with where its numbers are and its keys as help.</summary>
private sealed class ChartPlotAutomationPeer(ChartPlot owner) : FrameworkElementAutomationPeer(owner)
{
protected override AutomationControlType GetAutomationControlTypeCore() => AutomationControlType.Image;
protected override string GetLocalizedControlTypeCore() => Strings.A11y_Chart_ControlType;
protected override string GetClassNameCore() => nameof(ChartPlot);
protected override string GetHelpTextCore()
{
string where = AutomationProperties.GetHelpText(Owner);
return string.IsNullOrWhiteSpace(where) ? Strings.A11y_Chart_Keys : where + " " + Strings.A11y_Chart_Keys;
}
protected override List<AutomationPeer>? GetChildrenCore() => null;
}
}
+35 -3
View File
@@ -2,6 +2,8 @@
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using ScottPlot;
using ScottPlot.Interactivity;
using ScottPlot.Interactivity.UserActionResponses;
using ScottPlot.WPF;
using Wpf.Ui.Appearance;
@@ -18,8 +20,8 @@ public static class ChartTheme
private static readonly Lock _lock = new();
private static bool _subscribed;
/// <summary>The palette of the theme WPF UI has applied.</summary>
public static ChartPalette Current => ChartPalette.For(ApplicationThemeManager.GetAppTheme());
/// <summary>The palette of the theme WPF UI has applied — or, under a Windows contrast theme, of its colours (beta.35, D91).</summary>
public static ChartPalette Current => Services.ContrastTheme.Active is { } contrast ? ChartPalette.ForContrast(contrast) : ChartPalette.For(ApplicationThemeManager.GetAppTheme());
/// <summary>Colours one plot for the current theme; the series keep their own palette colours.</summary>
public static void Apply(Plot plot)
@@ -46,7 +48,8 @@ public static class ChartTheme
ArgumentException.ThrowIfNullOrWhiteSpace(path);
Color figure = plot.FigureBackground.Color;
Color data = plot.DataBackground.Color;
Color window = ApplicationThemeManager.GetAppTheme() == ApplicationTheme.Light ? Color.FromHex("#F3F3F3") : Color.FromHex("#202020");
Color window = Services.ContrastTheme.Active is { } contrast ? ToScottPlot(contrast.Window)
: ApplicationThemeManager.GetAppTheme() == ApplicationTheme.Light ? Color.FromHex("#F3F3F3") : Color.FromHex("#202020");
try
{
plot.FigureBackground.Color = Over(figure, window);
@@ -68,6 +71,12 @@ public static class ChartTheme
internal static Color TextOn(Color fill)
{
System.Windows.Media.Color under = ToWpf(fill);
if (Services.ContrastTheme.Active is { } contrast)
{
// beta.35 (D91): under a contrast theme the text is one of its colours too — the one that reads best on the fill.
return ToScottPlot(contrast.Colors.MaxBy(c => Services.ColorMath.Contrast(c, under)));
}
return Services.ColorMath.Contrast(System.Windows.Media.Colors.Black, under) >= Services.ColorMath.Contrast(System.Windows.Media.Colors.White, under)
? Colors.Black
: Colors.White;
@@ -76,6 +85,9 @@ public static class ChartTheme
/// <summary>A chart colour as WPF's.</summary>
internal static System.Windows.Media.Color ToWpf(Color c) => System.Windows.Media.Color.FromArgb(c.A, c.R, c.G, c.B);
/// <summary>A WPF colour as ScottPlot draws it (a contrast theme's colours, beta.35).</summary>
internal static Color ToScottPlot(System.Windows.Media.Color c) => new(c.R, c.G, c.B, c.A);
/// <summary>Source-over: <paramref name="top"/> composited on an opaque <paramref name="under"/>.</summary>
internal static Color Over(Color top, Color under)
{
@@ -94,6 +106,8 @@ public static class ChartTheme
{
ArgumentNullException.ThrowIfNull(control);
ChartWheel.Attach(control);
ChartKeys.Attach(control);
ResetOnDoubleClick(control);
lock (_lock)
{
_live.RemoveAll(static w => !w.TryGetTarget(out _));
@@ -108,6 +122,24 @@ public static class ChartTheme
Apply(control.Plot);
}
/// <summary>
/// beta.35 (D90): a double-click shows all of the chart, as the guide always said. ScottPlot's left double-click toggled
/// its render-time overlay — a developer's benchmark — and A and a middle click were the only ways back.
/// </summary>
internal static void ResetOnDoubleClick(WpfPlot control)
{
ArgumentNullException.ThrowIfNull(control);
control.UserInputProcessor.DoubleLeftClickBenchmark(false);
if (!control.UserInputProcessor.UserActionResponses.OfType<DoubleClickResponse>().Any())
{
control.UserInputProcessor.UserActionResponses.Add(new DoubleClickResponse(StandardMouseButtons.Left, static (plotControl, _) =>
{
plotControl.Plot.Axes.AutoScale();
plotControl.Refresh();
}));
}
}
private static void OnThemeChanged(ApplicationTheme theme, System.Windows.Media.Color accent)
{
WpfPlot[] plots;
+3 -2
View File
@@ -4,8 +4,9 @@
<UserControl x:Class="FrameLedger.App.Charts.CompareChart"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:sp="clr-namespace:ScottPlot.WPF;assembly=ScottPlot.WPF"
xmlns:charts="clr-namespace:FrameLedger.App.Charts"
xmlns:res="clr-namespace:FrameLedger.App"
MinHeight="300">
<!-- 08_UI §Compare: overlaid percentile curves; the tier legend is stamped on the plot when tiers are mixed (FR-6.2). -->
<sp:WpfPlot x:Name="Plot" />
<charts:ChartPlot x:Name="Plot" AutomationProperties.Name="{x:Static res:Strings.A11y_Chart_Compare}" AutomationProperties.HelpText="{x:Static res:Strings.A11y_ChartData_Compare}" />
</UserControl>
@@ -42,6 +42,7 @@ public partial class CompareChart : UserControl
Scatter line = plot.Add.ScatterLine(curve.Xs, curve.Ys, palette[DrawnCurves % palette.Length]);
line.LineWidth = 2;
line.LegendText = curve.Label;
ChartPatterns.Line(line, DrawnCurves); // beta.35 (D90): five sessions, five patterns — never colour alone
DrawnCurves++;
}
@@ -5,7 +5,8 @@
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:ui="http://schemas.lepo.co/wpfui/2022/xaml"
xmlns:sp="clr-namespace:ScottPlot.WPF;assembly=ScottPlot.WPF"
xmlns:charts="clr-namespace:FrameLedger.App.Charts"
xmlns:res="clr-namespace:FrameLedger.App"
MinHeight="240">
<!-- FR-5.1: the FPS histogram and the percentile curve, side by side; the note says what the histogram's range left out (beta.8). -->
<Grid>
@@ -18,8 +19,8 @@
<ColumnDefinition Width="12" />
<ColumnDefinition Width="*" />
</Grid.ColumnDefinitions>
<sp:WpfPlot x:Name="Histogram" Grid.Column="0" />
<sp:WpfPlot x:Name="Percentiles" Grid.Column="2" />
<charts:ChartPlot x:Name="Histogram" AutomationProperties.Name="{x:Static res:Strings.A11y_Chart_Histogram}" AutomationProperties.HelpText="{x:Static res:Strings.A11y_ChartData_Summary}" Grid.Column="0" />
<charts:ChartPlot x:Name="Percentiles" AutomationProperties.Name="{x:Static res:Strings.A11y_Chart_Percentiles}" AutomationProperties.HelpText="{x:Static res:Strings.A11y_ChartData_Summary}" Grid.Column="2" />
<ui:TextBlock x:Name="Note" Grid.Row="1" Grid.ColumnSpan="3" Margin="0,4,0,0" Style="{StaticResource TertiaryText}" TextWrapping="Wrap" Visibility="Collapsed" />
</Grid>
</UserControl>
@@ -94,6 +94,7 @@ public partial class DistributionChart : UserControl
Scatter low = plot.Add.ScatterPoints(new[] { x }, new[] { fps }, ChartTheme.Current.Stutter);
low.MarkerSize = 7;
low.LegendText = pointOne ? Strings.Summary_Stat_P01Low : Strings.Summary_Stat_P1Low;
ChartPatterns.Points(low, pointOne ? 2 : 0); // beta.35 (D90): the 1% low a circle, the 0.1% low a square
}
// The axis is 0–100 whatever the curve covers: AutoScale first, then the X limits (AutoScale afterwards undid them).
@@ -5,7 +5,8 @@
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:ui="http://schemas.lepo.co/wpfui/2022/xaml"
xmlns:sp="clr-namespace:ScottPlot.WPF;assembly=ScottPlot.WPF"
xmlns:charts="clr-namespace:FrameLedger.App.Charts"
xmlns:res="clr-namespace:FrameLedger.App"
MinHeight="260">
<!-- 08_UI §Session summary / FR-5.1: the frametime timeline, min/max decimated (FR-5.3); zoom and pan are ScottPlot's —
zoom with Ctrl+wheel since beta.14, a plain wheel scrolls the page (ChartWheel).
@@ -16,6 +17,6 @@
<RowDefinition Height="*" />
</Grid.RowDefinitions>
<ui:TextBlock x:Name="Note" Grid.Row="0" Margin="0,0,0,4" Style="{StaticResource TertiaryText}" TextWrapping="Wrap" Visibility="Collapsed" />
<sp:WpfPlot x:Name="Plot" Grid.Row="1" />
<charts:ChartPlot x:Name="Plot" AutomationProperties.Name="{x:Static res:Strings.A11y_Chart_Frametime}" AutomationProperties.HelpText="{x:Static res:Strings.A11y_ChartData_Summary}" Grid.Row="1" />
</Grid>
</UserControl>
@@ -115,7 +115,7 @@ public partial class FrametimeChart : UserControl
DrawPresents(plot, p);
}
DrawSeries(plot, _series.AppTimesS, _series.AppFrameTimesMs, p.Native, generating ? Strings.Chart_Series_AppFrames : Strings.Chart_Series_Presents);
DrawSeries(plot, _series.AppTimesS, _series.AppFrameTimesMs, p.Native, generating ? Strings.Chart_Series_AppFrames : Strings.Chart_Series_Presents, 0);
DrawStutter(plot, p);
if (_sensors && _series.SensorsAligned)
{
@@ -128,7 +128,7 @@ public partial class FrametimeChart : UserControl
Plot.Refresh();
}
private void DrawSeries(ScottPlot.Plot plot, double[] xs, double[] ys, Color color, string label)
private void DrawSeries(ScottPlot.Plot plot, double[] xs, double[] ys, Color color, string label, int index)
{
if (xs.Length == 0)
{
@@ -140,6 +140,7 @@ public partial class FrametimeChart : UserControl
SignalXY line = plot.Add.SignalXY(dx, dy, color);
line.LineWidth = 1;
line.LegendText = label;
ChartPatterns.Line(line, index); // beta.35 (D90): the frames solid, the displayed ones dashed
}
/// <summary>Every present but those after a gap, whose stored interval is 0 — not a frame, and it was drawn as a 0 ms one.</summary>
@@ -147,7 +148,7 @@ public partial class FrametimeChart : UserControl
{
// beta.23: the decoded series carries the line (SeriesDigest), so the Displayed toggle no longer walks every present.
(double[] xs, double[] ys) = _series!.Digest?.Presents ?? SeriesDigest.PresentsWithoutGaps(_series.TimesS, _series.FrameTimesMs, _series.Gap);
DrawSeries(plot, xs, ys, p.Displayed, Strings.Chart_Series_Displayed);
DrawSeries(plot, xs, ys, p.Displayed, Strings.Chart_Series_Displayed, 1);
}
private void DrawStutter(ScottPlot.Plot plot, ChartPalette p)
@@ -174,11 +175,11 @@ public partial class FrametimeChart : UserControl
(pso ? psoYs : ys).Add(_series.AppFrameTimesMs[i]);
}
AddMarkers(plot, xs, ys, p.Stutter, Strings.Chart_Series_Stutter);
AddMarkers(plot, psoXs, psoYs, p.StutterPso, Strings.Chart_Series_StutterPso);
AddMarkers(plot, xs, ys, p.Stutter, Strings.Chart_Series_Stutter, 0);
AddMarkers(plot, psoXs, psoYs, p.StutterPso, Strings.Chart_Series_StutterPso, 1);
}
private void AddMarkers(ScottPlot.Plot plot, List<double> xs, List<double> ys, Color color, string label)
private void AddMarkers(ScottPlot.Plot plot, List<double> xs, List<double> ys, Color color, string label, int index)
{
if (xs.Count == 0)
{
@@ -191,6 +192,7 @@ public partial class FrametimeChart : UserControl
markers.LineWidth = 0;
markers.MarkerSize = 5;
markers.LegendText = label;
ChartPatterns.Points(markers, index); // beta.35 (D90): a stutter a circle, a shader-compile stutter a triangle
}
private void DrawSegments(ScottPlot.Plot plot, ChartPalette p)
+3 -2
View File
@@ -4,8 +4,9 @@
<UserControl x:Class="FrameLedger.App.Charts.LatencyChart"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:sp="clr-namespace:ScottPlot.WPF;assembly=ScottPlot.WPF"
xmlns:charts="clr-namespace:FrameLedger.App.Charts"
xmlns:res="clr-namespace:FrameLedger.App"
MinHeight="240">
<!-- 08_UI §Games › Latency (Tier 1 + Reflex only): the PC latency timeline with the stored avg / p95 lines. -->
<sp:WpfPlot x:Name="Plot" />
<charts:ChartPlot x:Name="Plot" AutomationProperties.Name="{x:Static res:Strings.A11y_Chart_Latency}" AutomationProperties.HelpText="{x:Static res:Strings.A11y_ChartData_Latency}" />
</UserControl>
@@ -6,11 +6,11 @@
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:ui="http://schemas.lepo.co/wpfui/2022/xaml"
xmlns:res="clr-namespace:FrameLedger.App"
xmlns:sp="clr-namespace:ScottPlot.WPF;assembly=ScottPlot.WPF">
xmlns:charts="clr-namespace:FrameLedger.App.Charts">
<!-- 08_UI §Session summary (beta.14, D49): the render scale over the session, as steps; a line saying it was not measured
where the upscaler's parameters never were. -->
<Grid>
<sp:WpfPlot x:Name="Plot" />
<charts:ChartPlot x:Name="Plot" AutomationProperties.Name="{x:Static res:Strings.A11y_Chart_RenderScale}" AutomationProperties.HelpText="{x:Static res:Strings.A11y_ChartData_Summary}" />
<ui:TextBlock x:Name="NotMeasured" Style="{StaticResource SecondaryText}" TextWrapping="Wrap" VerticalAlignment="Center" HorizontalAlignment="Center"
Text="{x:Static res:Strings.Chart_RenderScale_NotMeasured}" Visibility="Collapsed" />
</Grid>
+5 -5
View File
@@ -6,21 +6,21 @@
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:ui="http://schemas.lepo.co/wpfui/2022/xaml"
xmlns:res="clr-namespace:FrameLedger.App"
xmlns:sp="clr-namespace:ScottPlot.WPF;assembly=ScottPlot.WPF">
xmlns:charts="clr-namespace:FrameLedger.App.Charts">
<!-- 08_UI §Games › Sensors: temperatures / load / power; then video memory and memory, each with THIS GAME's own figure
and the whole graphics card's / whole PC's as SEPARATE, differently-labelled series (beta.12, D43). -->
<StackPanel>
<ui:TextBlock FontTypography="BodyStrong" Text="{x:Static res:Strings.Sensors_Temps_Header}" />
<sp:WpfPlot x:Name="Temps" Height="240" Margin="0,6,0,0" />
<charts:ChartPlot x:Name="Temps" AutomationProperties.Name="{x:Static res:Strings.A11y_Chart_Temps}" AutomationProperties.HelpText="{x:Static res:Strings.A11y_ChartData_Summary}" Height="240" Margin="0,6,0,0" />
<ui:TextBlock Margin="0,12,0,0" FontTypography="BodyStrong" Text="{x:Static res:Strings.Sensors_Vram_Header}" />
<sp:WpfPlot x:Name="Vram" Height="220" Margin="0,6,0,0" />
<charts:ChartPlot x:Name="Vram" AutomationProperties.Name="{x:Static res:Strings.A11y_Chart_Vram}" AutomationProperties.HelpText="{x:Static res:Strings.A11y_ChartData_Summary}" Height="220" Margin="0,6,0,0" />
<ui:TextBlock Margin="0,12,0,0" FontTypography="BodyStrong" Text="{x:Static res:Strings.Sensors_Ram_Header}" />
<sp:WpfPlot x:Name="Ram" Height="220" Margin="0,6,0,0" />
<charts:ChartPlot x:Name="Ram" AutomationProperties.Name="{x:Static res:Strings.A11y_Chart_Ram}" AutomationProperties.HelpText="{x:Static res:Strings.A11y_ChartData_Summary}" Height="220" Margin="0,6,0,0" />
<!-- beta.14 (D49): the card's clocks (MHz) and fan (RPM, right axis), with the ticks its power limit or heat held it
back shaded. Collapsed when the session stored none of them. -->
<StackPanel x:Name="ClocksSection">
<ui:TextBlock Margin="0,12,0,0" FontTypography="BodyStrong" Text="{x:Static res:Strings.Sensors_Clocks_Header}" />
<sp:WpfPlot x:Name="Clocks" Height="220" Margin="0,6,0,0" />
<charts:ChartPlot x:Name="Clocks" AutomationProperties.Name="{x:Static res:Strings.A11y_Chart_Clocks}" AutomationProperties.HelpText="{x:Static res:Strings.A11y_ChartData_Summary}" Height="220" Margin="0,6,0,0" />
</StackPanel>
</StackPanel>
</UserControl>
@@ -153,6 +153,9 @@ public partial class SensorsChart : UserControl
{
VerticalSpan span = plot.Add.VerticalSpan(from, to, color.WithAlpha(0.18));
span.LineWidth = 0;
// beta.35 (D90): the power limit striped, the thermal limit dotted — they were red and orange shading only.
span.FillHatch = ChartPatterns.Hatch(string.Equals(name, SensorSeriesCatalog.GpuPowerLimit, StringComparison.Ordinal) ? 0 : 1);
span.FillHatchColor = color.WithAlpha(0.55);
if (drawn++ == 0)
{
span.LegendText = label;
@@ -278,6 +281,8 @@ public partial class SensorsChart : UserControl
Scatter line = plot.Add.ScatterLine(xs, ys, color);
line.LineWidth = 1;
line.LegendText = label;
// beta.35 (D90): the plot's lines in turn take the patterns — the GPU's temperature and its hot spot were green and red.
ChartPatterns.Line(line, plot.GetPlottables().OfType<Scatter>().Count() - 1);
if (axis is not null)
{
line.Axes.YAxis = axis;
+3 -2
View File
@@ -4,8 +4,9 @@
<UserControl x:Class="FrameLedger.App.Charts.TrendChart"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:sp="clr-namespace:ScottPlot.WPF;assembly=ScottPlot.WPF"
xmlns:charts="clr-namespace:FrameLedger.App.Charts"
xmlns:res="clr-namespace:FrameLedger.App"
MinHeight="260">
<!-- 08_UI §Games › Trend: the metric over date with hardware-change markers (FR-6.3). -->
<sp:WpfPlot x:Name="Plot" />
<charts:ChartPlot x:Name="Plot" AutomationProperties.Name="{x:Static res:Strings.A11y_Chart_Trend}" AutomationProperties.HelpText="{x:Static res:Strings.A11y_ChartData_Sessions}" />
</UserControl>
@@ -146,7 +146,7 @@ public partial class TrendChart : UserControl
continue;
}
hollow += AddLine(plot, line, palette[i % palette.Length], p.Data, isRight);
hollow += AddLine(plot, line, palette[i % palette.Length], p.Data, isRight, i);
onRight += isRight ? 1 : 0;
drawn.AddRange(line.Points);
}
@@ -171,7 +171,7 @@ public partial class TrendChart : UserControl
}
/// <summary>One line, its hollow points, against the left or the right axis; how many were hollow.</summary>
private static int AddLine(ScottPlot.Plot plot, TrendLine line, Color color, Color hollowColor, bool isRight)
private static int AddLine(ScottPlot.Plot plot, TrendLine line, Color color, Color hollowColor, bool isRight, int index)
{
double[] xs = [.. line.Points.Select(static t => t.At.LocalDateTime.ToOADate())];
double[] ys = [.. line.Points.Select(static t => t.Value)];
@@ -179,6 +179,9 @@ public partial class TrendChart : UserControl
scatter.LineWidth = 2;
scatter.MarkerSize = 7;
scatter.LegendText = isRight ? line.Label + " ▸" : line.Label;
// beta.35 (D90): each metric its own pattern and, since every trend line shows its points, its own marker
ChartPatterns.Line(scatter, index);
ChartPatterns.Points(scatter, index);
if (isRight)
{
scatter.Axes.YAxis = plot.Axes.Right;
+1 -1
View File
@@ -96,7 +96,7 @@ public static class ArtTint
return;
}
if (GetColor(band) is { } dominant && !SystemParameters.HighContrast && BandColour(band, dominant) is { } colour)
if (GetColor(band) is { } dominant && !SystemParameters.HighContrast && Services.ContrastTheme.Active is null && BandColour(band, dominant) is { } colour)
{
var brush = new SolidColorBrush(colour);
brush.Freeze();
+69
View File
@@ -0,0 +1,69 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using System.Windows;
using System.Windows.Automation;
using System.Windows.Controls;
using System.Windows.Data;
namespace FrameLedger.App.Controls;
/// <summary>
/// beta.35 (D88): the words a screen reader reads for a template column's cells. A <c>DataGridTemplateColumn</c>'s cell has no
/// text of its own — its template draws it — so WPF names it <c>Item: FrameLedger.App.ViewModels.SessionItemViewModel, Column
/// Display Index: 3</c>. Set on the column, <see cref="PathProperty"/> gives every cell of it the row's text at that path as its
/// name, through a cell style based on WPF UI's own (<c>DefaultDataGridCellStyle</c>, the one its DataGrid gives every cell), so
/// the cells look as they did.
/// </summary>
public static class CellName
{
/// <summary>The key of WPF UI 4.3.0's cell style, which its DataGrid sets as <c>CellStyle</c>.</summary>
public const string WpfUiCellStyleKey = "DefaultDataGridCellStyle";
public static readonly DependencyProperty PathProperty = DependencyProperty.RegisterAttached(
"Path", typeof(string), typeof(CellName), new PropertyMetadata(null, OnPathChanged));
public static string? GetPath(DataGridColumn column)
{
ArgumentNullException.ThrowIfNull(column);
return (string?)column.GetValue(PathProperty);
}
public static void SetPath(DataGridColumn column, string? value)
{
ArgumentNullException.ThrowIfNull(column);
column.SetValue(PathProperty, value);
}
/// <summary>
/// The cell style that names a cell by the row's text at <paramref name="path"/>, based on <paramref name="basedOn"/>. An
/// empty text is read as the word for empty: a cell WPF finds no text in is named by its fallback again.
/// </summary>
public static Style Named(string path, Style? basedOn)
{
ArgumentException.ThrowIfNullOrWhiteSpace(path);
var style = new Style(typeof(DataGridCell), basedOn);
style.Setters.Add(new Setter(AutomationProperties.NameProperty, new Binding(path) { Mode = BindingMode.OneWay, Converter = SaysEmpty.Instance }));
return style;
}
/// <summary>A cell's text, or the word for empty when there is none.</summary>
public static string Spoken(object? value) => value?.ToString() is { } text && !string.IsNullOrWhiteSpace(text) ? text : Strings.A11y_Empty;
private sealed class SaysEmpty : IValueConverter
{
public static readonly SaysEmpty Instance = new();
public object Convert(object? value, Type targetType, object? parameter, System.Globalization.CultureInfo culture) => Spoken(value);
public object ConvertBack(object? value, Type targetType, object? parameter, System.Globalization.CultureInfo culture) => Binding.DoNothing;
}
private static void OnPathChanged(DependencyObject element, DependencyPropertyChangedEventArgs e)
{
if (element is DataGridColumn column && e.NewValue is string { Length: > 0 } path)
{
column.CellStyle = Named(path, column.CellStyle ?? System.Windows.Application.Current?.TryFindResource(WpfUiCellStyleKey) as Style);
}
}
}
@@ -1,7 +1,9 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using System.Globalization;
using System.Windows;
using System.Windows.Automation.Peers;
using System.Windows.Controls;
using System.Windows.Media;
using FrameLedger.App.Charts;
@@ -40,6 +42,10 @@ public sealed class ChangeBadge : Control
set => SetValue(TextProperty, value);
}
/// <summary>beta.35 (D88): the badge in words — "Change 1" — the number that links the row to the chart's badge.</summary>
[System.Diagnostics.CodeAnalysis.SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format string is a resource that follows the UI culture, which changes at runtime")]
protected override AutomationPeer OnCreateAutomationPeer() => new SpokenTextAutomationPeer(this, () => string.Format(CultureInfo.CurrentCulture, Strings.A11y_Change_Format, Text));
/// <summary>The palette for the theme the element's resources hold now; the applied theme's when none is reachable.</summary>
internal ChartPalette Palette() => GetValue(_themeProperty) is Color background ? ChartPalette.ForBackground(background) : ChartTheme.Current;
@@ -0,0 +1,101 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using System.Diagnostics.CodeAnalysis;
using System.Globalization;
using System.Windows;
using System.Windows.Automation;
using System.Windows.Controls;
using System.Windows.Controls.Primitives;
namespace FrameLedger.App.Controls;
/// <summary>
/// beta.35 (D88): WPF UI 4.3.0's <c>CardExpander</c> draws its expand button, the template part <c>ExpanderToggleButton</c>,
/// apart from its header and with no name, so a screen reader reached a Tab stop it could only call "toggle button". Set on
/// every CardExpander by the App's implicit style, this names that button after the header — its text, or the first line of
/// text a composed header shows — once the template exists.
/// </summary>
[SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format string is a resource that follows the UI culture, which changes at runtime")]
public static class ExpanderToggleName
{
/// <summary>The template part WPF UI's CardExpander template names its expand button.</summary>
public const string PartName = "ExpanderToggleButton";
public static readonly DependencyProperty IsEnabledProperty = DependencyProperty.RegisterAttached(
"IsEnabled", typeof(bool), typeof(ExpanderToggleName), new PropertyMetadata(false, OnIsEnabledChanged));
public static bool GetIsEnabled(DependencyObject element)
{
ArgumentNullException.ThrowIfNull(element);
return (bool)element.GetValue(IsEnabledProperty);
}
public static void SetIsEnabled(DependencyObject element, bool value)
{
ArgumentNullException.ThrowIfNull(element);
element.SetValue(IsEnabledProperty, value);
}
/// <summary>The words for an expander's header: the text itself, or the first non-empty text a composed header holds.</summary>
public static string? HeaderText(object? header) => header switch
{
string text when !string.IsNullOrWhiteSpace(text) => text,
DependencyObject element => FirstText(element),
_ => null,
};
/// <summary>Names the expander's button now, if its template has been applied; false while it has not.</summary>
public static bool TryName(Control expander)
{
ArgumentNullException.ThrowIfNull(expander);
if (expander.Template?.FindName(PartName, expander) is not ToggleButton toggle)
{
return false;
}
if (HeaderText((expander as HeaderedContentControl)?.Header) is { } header)
{
AutomationProperties.SetName(toggle, string.Format(CultureInfo.CurrentCulture, Strings.A11y_ToggleSection_Format, header));
}
return true;
}
private static void OnIsEnabledChanged(DependencyObject element, DependencyPropertyChangedEventArgs e)
{
if (element is not Control expander || e.NewValue is not true || TryName(expander))
{
return;
}
// The template is applied in the first measure; name the button after the first layout that made it.
void OnLayoutUpdated(object? sender, EventArgs args)
{
if (TryName(expander))
{
expander.LayoutUpdated -= OnLayoutUpdated;
}
}
expander.LayoutUpdated += OnLayoutUpdated;
}
private static string? FirstText(DependencyObject root)
{
if (root is TextBlock { Text.Length: > 0 } text)
{
return text.Text;
}
foreach (object child in LogicalTreeHelper.GetChildren(root))
{
if (child is DependencyObject element && FirstText(element) is { } found)
{
return found;
}
}
return null;
}
}
@@ -16,7 +16,7 @@
<RowDefinition Height="Auto" />
</Grid.RowDefinitions>
<ui:TextBlock Grid.Row="0" FontTypography="Title" Text="{Binding ViewModel.StepText}" />
<ui:TextBlock Grid.Row="0" FontTypography="Title" AutomationProperties.HeadingLevel="Level1" Text="{Binding ViewModel.StepText}" />
<!-- Step 1: the Legal Gate. -->
<Grid Grid.Row="1" Margin="0,12,0,0" Visibility="{Binding ViewModel.IsLegalStep, Converter={StaticResource BoolToVis}}">
@@ -2,6 +2,7 @@
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using System.Windows;
using System.Windows.Automation.Peers;
using System.Windows.Controls;
using FrameLedger.App.Services;
@@ -25,4 +26,7 @@ public sealed class FpsReadout : Control
get => (FpsReadoutModel)GetValue(ModelProperty);
set => SetValue(ModelProperty, value);
}
/// <summary>beta.35 (D88): the readout in words — Native, Displayed and the factor together (rule 6) — and the tooltip's text as help.</summary>
protected override AutomationPeer OnCreateAutomationPeer() => new SpokenTextAutomationPeer(this, () => Model?.SpokenText, () => Model?.QualifierTooltip);
}
@@ -0,0 +1,37 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using System.Windows;
using System.Windows.Automation.Peers;
namespace FrameLedger.App.Controls;
/// <summary>
/// The voice of a control that only shows something (beta.35, D88) — the FPS readout, a ray-tracing chip, a change badge.
/// A plain <c>Control</c> has no automation peer, and WPF hides the text in its template from the control view, so a
/// screen reader was given nothing for these. This peer is a Text element named by what the control says in words, with
/// no children, so the template's pieces are not read a second time.
/// </summary>
/// <param name="owner">The control.</param>
/// <param name="name">Its words, read when the screen reader asks; the control's own <c>AutomationProperties.Name</c> wins.</param>
/// <param name="help">More words, where the eye has a tooltip; optional.</param>
public sealed class SpokenTextAutomationPeer(FrameworkElement owner, Func<string?> name, Func<string?>? help = null) : FrameworkElementAutomationPeer(owner)
{
protected override AutomationControlType GetAutomationControlTypeCore() => AutomationControlType.Text;
protected override string GetClassNameCore() => Owner.GetType().Name;
protected override string GetNameCore()
{
string own = base.GetNameCore();
return own.Length > 0 ? own : name() ?? string.Empty;
}
protected override string GetHelpTextCore()
{
string own = base.GetHelpTextCore();
return own.Length > 0 ? own : help?.Invoke() ?? string.Empty;
}
protected override List<AutomationPeer>? GetChildrenCore() => null;
}
@@ -2,6 +2,7 @@
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using System.Windows;
using System.Windows.Automation.Peers;
using System.Windows.Controls;
using FrameLedger.App.ViewModels;
@@ -24,4 +25,7 @@ public sealed class TriStateChip : Control
get => (TriStateChipModel?)GetValue(ModelProperty);
set => SetValue(ModelProperty, value);
}
/// <summary>beta.35 (D88): the chip in words, with where its value came from — the tooltip's to the eye.</summary>
protected override AutomationPeer OnCreateAutomationPeer() => new SpokenTextAutomationPeer(this, () => Model?.AccessibleName);
}
@@ -63,7 +63,7 @@
<DockPanel Margin="0,12,0,0">
<ui:ProgressRing Width="16" Height="16" Margin="0,0,8,0" DockPanel.Dock="Left" IsIndeterminate="True"
Visibility="{Binding IsBusy, Converter={StaticResource BoolToVis}}" />
<ui:TextBlock MaxWidth="680" HorizontalAlignment="Left" AutomationProperties.LiveSetting="Polite" Text="{Binding Status}" TextWrapping="Wrap" />
<ui:TextBlock MaxWidth="680" HorizontalAlignment="Left" Text="{Binding Status}" TextWrapping="Wrap" />
</DockPanel>
</StackPanel>
</UserControl>
@@ -6,6 +6,7 @@
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:ui="http://schemas.lepo.co/wpfui/2022/xaml"
xmlns:vm="clr-namespace:FrameLedger.App.ViewModels"
xmlns:controls="clr-namespace:FrameLedger.App.Controls"
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
d:DataContext="{d:DesignInstance Type=vm:ImportReviewViewModel}"
@@ -41,14 +42,14 @@
<DataGrid.RowStyle>
<Style TargetType="DataGridRow" BasedOn="{StaticResource DefaultDataGridRowStyle}">
<Style.Triggers>
<DataTrigger Binding="{Binding IsExisting}" Value="True">
<DataTrigger Binding="{Binding IsDimmed}" Value="True">
<Setter Property="Opacity" Value="0.55" />
</DataTrigger>
</Style.Triggers>
</Style>
</DataGrid.RowStyle>
<DataGrid.Columns>
<DataGridTemplateColumn Width="40">
<DataGridTemplateColumn Width="40" controls:CellName.Path="Name">
<DataGridTemplateColumn.CellTemplate>
<DataTemplate>
<CheckBox MinWidth="0" Padding="0" HorizontalAlignment="Center" IsEnabled="{Binding CanImport}"
@@ -60,7 +61,7 @@
<DataGridTextColumn Header="{x:Static vm:ImportReviewViewModel.ColumnPlatform}" Binding="{Binding PlatformText}" IsReadOnly="True" Width="Auto" />
<DataGridTextColumn Header="{x:Static vm:ImportReviewViewModel.ColumnName}" Binding="{Binding Name}" IsReadOnly="True" Width="2*" />
<DataGridTextColumn Header="{x:Static vm:ImportReviewViewModel.ColumnExe}" Binding="{Binding ExeText}" IsReadOnly="True" Width="3*" />
<DataGridTextColumn Header="{x:Static vm:ImportReviewViewModel.ColumnNote}" Binding="{Binding Note}" IsReadOnly="True" Width="Auto" />
<DataGridTextColumn Header="{x:Static vm:ImportReviewViewModel.ColumnNote}" Binding="{Binding Note}" IsReadOnly="True" Width="Auto" controls:CellName.Path="Note" />
</DataGrid.Columns>
</DataGrid>
<DockPanel Grid.Row="3">
@@ -53,6 +53,8 @@
<EmbeddedResource Include="..\..\LICENSE" LogicalName="LICENSE" />
<!-- beta.10 (D36): what the whole software cannot do, shown under Help > Limitations; information, not one of FR-11's accepted documents. -->
<EmbeddedResource Include="..\..\LIMITATIONS.md" LogicalName="LIMITATIONS.md" />
<!-- beta.35 (D88): the accessibility statement, shown under Help > Accessibility; information, not one of FR-11's accepted documents. -->
<EmbeddedResource Include="..\..\ACCESSIBILITY.md" LogicalName="ACCESSIBILITY.md" />
<!-- beta.12: what Help > About shows, rendered from the text this build carries (D45: the copyright line and the GPLv3
section 7 terms, the trademark note, the third-party notices and the index of every shipped package's licence). -->
<EmbeddedResource Include="..\..\NOTICE" LogicalName="NOTICE" />
+9 -5
View File
@@ -53,10 +53,10 @@
Content="{x:Static res:Strings.Alpha_Badge}"
ToolTip="{Binding ViewModel.AlphaBadgeTooltip}"
Visibility="{Binding ViewModel.IsAlpha, Mode=OneTime, Converter={StaticResource BoolToVis}}" />
<ui:Badge Margin="0,0,12,0"
VerticalAlignment="Center"
Appearance="{Binding ViewModel.AgentStatusAppearance}"
Content="{Binding ViewModel.AgentStatusText}" />
<!-- beta.35: the theme's own fills under its text, never WPF UI's palette badge (Styles/FrameLedger.xaml, AgentPill). -->
<Border DataContext="{Binding ViewModel}" Style="{StaticResource AgentPill}">
<TextBlock Foreground="{DynamicResource TextFillColorPrimaryBrush}" Text="{Binding AgentStatusText}" />
</Border>
</StackPanel>
</ui:TitleBar.TrailingContent>
</ui:TitleBar>
@@ -86,6 +86,7 @@
<MenuItem Header="{x:Static res:Strings.Menu_Help_ReportBug}" Command="{Binding ViewModel.ReportBugCommand}" />
<MenuItem Header="{x:Static res:Strings.Menu_Help_Documentation}" Command="{Binding ViewModel.DocumentationCommand}" />
<MenuItem Header="{x:Static res:Strings.Menu_Help_Limitations}" Command="{Binding ViewModel.LimitationsCommand}" />
<MenuItem Header="{x:Static res:Strings.Menu_Help_Accessibility}" Command="{Binding ViewModel.AccessibilityCommand}" />
<Separator />
<MenuItem Header="{x:Static res:Strings.Menu_Help_About}" Command="{Binding ViewModel.AboutCommand}" />
</MenuItem>
@@ -154,6 +155,7 @@
Severity="{Binding Severity}"
Title="{Binding Title}">
<ui:Button Appearance="Secondary"
AutomationProperties.HelpText="{Binding AccessibleName}"
Command="{Binding DataContext.ViewModel.DismissNoticeCommand, RelativeSource={RelativeSource AncestorType=Window}}"
CommandParameter="{Binding}"
Content="{Binding ActionText}" />
@@ -163,10 +165,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}"
@@ -190,6 +194,6 @@
</ui:NavigationView>
<ui:SnackbarPresenter x:Name="SnackbarPresenter" Grid.Row="3" VerticalAlignment="Bottom" />
<ui:ContentDialogHost x:Name="DialogHost" Grid.Row="3" />
<ui:ContentDialogHost x:Name="DialogHost" Grid.Row="3" Focusable="False" />
</Grid>
</ui:FluentWindow>
+27 -2
View File
@@ -2,6 +2,7 @@
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using System.Diagnostics;
using System.Windows;
using System.Windows.Threading;
using FrameLedger.App.Services;
using FrameLedger.App.ViewModels;
@@ -19,6 +20,8 @@ namespace FrameLedger.App;
/// </summary>
public partial class MainWindow : FluentWindow
{
private readonly PageMotion _motion;
public MainWindow(
MainWindowViewModel viewModel,
INavigationService navigation,
@@ -26,7 +29,8 @@ public partial class MainWindow : FluentWindow
IContentDialogService dialogs,
INavigationViewPageProvider pages,
IThemeApplier theme,
AppearanceSettings appearance)
AppearanceSettings appearance,
PageFocus pageFocus)
{
ArgumentNullException.ThrowIfNull(navigation);
ArgumentNullException.ThrowIfNull(snackbar);
@@ -34,6 +38,7 @@ public partial class MainWindow : FluentWindow
ArgumentNullException.ThrowIfNull(pages);
ArgumentNullException.ThrowIfNull(theme);
ArgumentNullException.ThrowIfNull(appearance);
ArgumentNullException.ThrowIfNull(pageFocus);
ViewModel = viewModel ?? throw new ArgumentNullException(nameof(viewModel));
DataContext = this;
@@ -45,13 +50,27 @@ 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);
Loaded += (_, _) => theme.Apply(appearance.Theme, this);
TimeNavigations();
// beta.35: a page slides in only while Windows' animation effects are on, followed while the window lives; and the
// page a shortcut opens takes the keyboard (PageFocus) — the shell says which page is shown after every navigation.
_motion = PageMotion.Follow(RootNavigation);
RootNavigation.Navigated += (_, e) =>
{
if (e.Page is FrameworkElement page)
{
pageFocus.Shown(page);
}
};
}
/// <summary>
@@ -75,4 +94,10 @@ public partial class MainWindow : FluentWindow
}
public MainWindowViewModel ViewModel { get; }
protected override void OnClosed(EventArgs e)
{
_motion.Dispose();
base.OnClosed(e);
}
}
+73 -35
View File
@@ -7,6 +7,7 @@
xmlns:ui="http://schemas.lepo.co/wpfui/2022/xaml"
xmlns:res="clr-namespace:FrameLedger.App"
xmlns:vm="clr-namespace:FrameLedger.App.ViewModels"
xmlns:controls="clr-namespace:FrameLedger.App.Controls"
xmlns:charts="clr-namespace:FrameLedger.App.Charts"
Title="{x:Static res:Strings.Compare_Header}"
Foreground="{DynamicResource TextFillColorPrimaryBrush}"
@@ -14,29 +15,55 @@
<!-- 08_UI §Compare: the picker (2–5, cross-game), the overlaid percentile curves, the stat table; FR-6.2's guard is the view model's. -->
<ScrollViewer VerticalScrollBarVisibility="Auto">
<StackPanel Style="{StaticResource PageRoot}">
<ui:TextBlock FontTypography="Title" Text="{x:Static vm:CompareViewModel.Header}" />
<ui:TextBlock FontTypography="Title" AutomationProperties.HeadingLevel="Level1" Text="{x:Static vm:CompareViewModel.Header}" />
<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" AutomationProperties.HeadingLevel="Level2" 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}}">
<DataGrid.Columns>
<!-- A template column, not DataGridCheckBoxColumn: that one's element style is WPF's own, an Aero2 box on the Fluent grid; MinWidth 0
and no padding, or WPF UI's CheckBox (MinWidth 120, padding 11) draws a sliver of the box in 40 px (beta.14). -->
<DataGridTemplateColumn Width="40">
<DataGridTemplateColumn Width="40" controls:CellName.Path="Label">
<DataGridTemplateColumn.CellTemplate>
<DataTemplate DataType="{x:Type vm:CompareCandidateViewModel}">
<CheckBox MinWidth="0" Padding="0" HorizontalAlignment="Center" AutomationProperties.Name="{Binding Label}"
@@ -44,18 +71,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" controls:CellName.Path="SettingsChangedText">
<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" controls:CellName.Path="Label" />
</DataGrid.Columns>
</DataGrid>
@@ -69,25 +101,31 @@
<ColumnDefinition Width="*" />
<ColumnDefinition Width="Auto" />
</Grid.ColumnDefinitions>
<ui:TextBlock Grid.Column="0" FontTypography="Subtitle" Text="{x:Static vm:CompareViewModel.CurvesHeader}" />
<ui:TextBlock Grid.Column="0" FontTypography="Subtitle" AutomationProperties.HeadingLevel="Level2" Text="{x:Static vm:CompareViewModel.CurvesHeader}" />
<ui:Button Grid.Column="1" Click="OnExportPng" Content="{x:Static vm:CompareViewModel.ExportPngText}" />
</Grid>
<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>
<ui:TextBlock Margin="0,16,0,0" FontTypography="Subtitle" AutomationProperties.HeadingLevel="Level2" Text="{x:Static vm:CompareViewModel.TableHeader}" />
<!-- 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}">
+8 -8
View File
@@ -13,13 +13,13 @@
ScrollViewer.CanContentScroll="False">
<ScrollViewer VerticalScrollBarVisibility="Auto">
<StackPanel Style="{StaticResource PageRoot}">
<ui:TextBlock FontTypography="Title" Text="{x:Static vm:DashboardViewModel.Header}" />
<ui:TextBlock FontTypography="Title" AutomationProperties.HeadingLevel="Level1" Text="{x:Static vm:DashboardViewModel.Header}" />
<!-- 08_UI §Dashboard: the live capture cards — one per running session since beta.28 (the owner, 2026-10-20: two or
more games at once), hooked sessions first — fed by SessionStarted / SessionProgress / SessionHeld /
SessionCompleted. A session recorded without measuring (Tier 2) shows why, and no readout (2026-09-23). -->
<StackPanel Margin="0,16,0,0" Orientation="Horizontal">
<ui:TextBlock FontTypography="Subtitle" Text="{x:Static vm:LiveCaptureViewModel.Header}" />
<ui:TextBlock FontTypography="Subtitle" AutomationProperties.HeadingLevel="Level2" Text="{x:Static vm:LiveCaptureViewModel.Header}" />
<Border Style="{StaticResource Pill}" Visibility="{Binding ViewModel.LiveCountText, Converter={StaticResource NullToCollapsed}}">
<TextBlock Foreground="{DynamicResource TextFillColorPrimaryBrush}" Text="{Binding ViewModel.LiveCountText}" />
</Border>
@@ -77,19 +77,19 @@
<ui:Card Margin="0,0,6,0">
<StackPanel>
<ui:TextBlock Style="{StaticResource SecondaryText}" Text="{x:Static vm:DashboardViewModel.TotalsGames}" />
<ui:TextBlock FontTypography="Subtitle" Text="{Binding ViewModel.GamesTrackedText}" />
<ui:TextBlock FontTypography="Subtitle" AutomationProperties.HeadingLevel="None" Text="{Binding ViewModel.GamesTrackedText}" />
</StackPanel>
</ui:Card>
<ui:Card Margin="6,0,6,0">
<StackPanel>
<ui:TextBlock Style="{StaticResource SecondaryText}" Text="{x:Static vm:DashboardViewModel.TotalsPlaytime}" />
<ui:TextBlock FontTypography="Subtitle" Text="{Binding ViewModel.PlaytimeText}" />
<ui:TextBlock FontTypography="Subtitle" AutomationProperties.HeadingLevel="None" Text="{Binding ViewModel.PlaytimeText}" />
</StackPanel>
</ui:Card>
<ui:Card Margin="6,0,0,0">
<StackPanel>
<ui:TextBlock Style="{StaticResource SecondaryText}" Text="{x:Static vm:DashboardViewModel.TotalsThisWeek}" />
<ui:TextBlock FontTypography="Subtitle" Text="{Binding ViewModel.ThisWeekText}" />
<ui:TextBlock FontTypography="Subtitle" AutomationProperties.HeadingLevel="None" Text="{Binding ViewModel.ThisWeekText}" />
</StackPanel>
</ui:Card>
</UniformGrid>
@@ -97,7 +97,7 @@
<!-- 08_UI §Dashboard: the Agent status card. Every value reads N/A until the Agent answered. -->
<ui:Card Margin="0,12,0,0" HorizontalAlignment="Stretch">
<StackPanel>
<ui:TextBlock FontTypography="Subtitle" Margin="0,0,0,12" Text="{x:Static vm:DashboardViewModel.AgentHeader}" />
<ui:TextBlock FontTypography="Subtitle" AutomationProperties.HeadingLevel="Level2" Margin="0,0,0,12" Text="{x:Static vm:DashboardViewModel.AgentHeader}" />
<Grid>
<Grid.ColumnDefinitions>
<ColumnDefinition Width="Auto" />
@@ -128,14 +128,14 @@
</ui:Card>
<!-- recent sessions -->
<ui:TextBlock Margin="0,20,0,0" FontTypography="Subtitle" Text="{x:Static vm:DashboardViewModel.RecentHeader}" />
<ui:TextBlock Margin="0,20,0,0" FontTypography="Subtitle" AutomationProperties.HeadingLevel="Level2" Text="{x:Static vm:DashboardViewModel.RecentHeader}" />
<ui:TextBlock Margin="0,8,0,0" Style="{StaticResource SecondaryText}" TextWrapping="Wrap"
Text="{x:Static vm:DashboardViewModel.EmptyText}"
Visibility="{Binding ViewModel.RecentEmpty, Converter={StaticResource BoolToVis}}" />
<ItemsControl Margin="0,8,0,0" ItemsSource="{Binding ViewModel.Recent}">
<ItemsControl.ItemTemplate>
<DataTemplate DataType="{x:Type vm:RecentSessionViewModel}">
<ui:CardAction Margin="0,0,0,6" IsChevronVisible="True"
<ui:CardAction Margin="0,0,0,6" IsChevronVisible="True" AutomationProperties.Name="{Binding AccessibleName}"
Command="{Binding DataContext.ViewModel.OpenSessionCommand, RelativeSource={RelativeSource AncestorType=Page}}"
CommandParameter="{Binding}">
<Grid>
+15 -13
View File
@@ -74,6 +74,8 @@
Visibility="{Binding ViewModel.ArtCover, Converter={StaticResource NullToCollapsed}}">
<ui:Image.Style>
<Style TargetType="ui:Image" BasedOn="{StaticResource DefaultImageStyle}">
<!-- beta.35 (D88): a picture, not a stop for Tab (the App's implicit ui:Image style says so for the others) -->
<Setter Property="Focusable" Value="False" />
<Setter Property="Width" Value="120" />
<Setter Property="Height" Value="180" />
<Style.Triggers>
@@ -91,7 +93,7 @@
</ui:Image.Style>
</ui:Image>
<StackPanel Grid.Column="1">
<ui:TextBlock FontTypography="Title" Text="{Binding ViewModel.Name}" />
<ui:TextBlock FontTypography="Title" AutomationProperties.HeadingLevel="Level1" Text="{Binding ViewModel.Name}" />
<ui:TextBlock Style="{StaticResource SecondaryText}" Text="{Binding ViewModel.Subtitle}" />
<ui:TextBlock Style="{StaticResource TertiaryText}" TextTrimming="CharacterEllipsis" Text="{Binding ViewModel.ExecutableText}" ToolTip="{Binding ViewModel.ExecutableText}" />
<ui:InfoBar Margin="0,6,0,0" IsClosable="False" Severity="Warning"
@@ -314,7 +316,7 @@
<DataGrid.Columns>
<DataGridTextColumn Header="{x:Static res:Strings.Sessions_Col_Date}" Binding="{Binding DateText}" />
<DataGridTextColumn Header="{x:Static res:Strings.Sessions_Col_Duration}" Binding="{Binding DurationText}" />
<DataGridTemplateColumn Header="{x:Static res:Strings.Sessions_Col_Tier}">
<DataGridTemplateColumn Header="{x:Static res:Strings.Sessions_Col_Tier}" controls:CellName.Path="TierText">
<DataGridTemplateColumn.CellTemplate>
<DataTemplate DataType="{x:Type vm:SessionItemViewModel}">
<Border Style="{StaticResource Pill}" Margin="0" ToolTip="{Binding TierTooltip}">
@@ -323,21 +325,21 @@
</DataTemplate>
</DataGridTemplateColumn.CellTemplate>
</DataGridTemplateColumn>
<DataGridTemplateColumn Header="{x:Static res:Strings.Sessions_Col_Native}">
<DataGridTemplateColumn Header="{x:Static res:Strings.Sessions_Col_Native}" controls:CellName.Path="NativeText">
<DataGridTemplateColumn.CellTemplate>
<DataTemplate DataType="{x:Type vm:SessionItemViewModel}">
<TextBlock Text="{Binding NativeText}" ToolTip="{Binding FpsTooltip}" />
</DataTemplate>
</DataGridTemplateColumn.CellTemplate>
</DataGridTemplateColumn>
<DataGridTemplateColumn Header="{x:Static res:Strings.Sessions_Col_Displayed}">
<DataGridTemplateColumn Header="{x:Static res:Strings.Sessions_Col_Displayed}" controls:CellName.Path="DisplayedText">
<DataGridTemplateColumn.CellTemplate>
<DataTemplate DataType="{x:Type vm:SessionItemViewModel}">
<TextBlock Text="{Binding DisplayedText}" ToolTip="{Binding FpsTooltip}" />
</DataTemplate>
</DataGridTemplateColumn.CellTemplate>
</DataGridTemplateColumn>
<DataGridTemplateColumn Header="{x:Static res:Strings.Sessions_Col_Fg}">
<DataGridTemplateColumn Header="{x:Static res:Strings.Sessions_Col_Fg}" controls:CellName.Path="FgText">
<DataGridTemplateColumn.CellTemplate>
<DataTemplate DataType="{x:Type vm:SessionItemViewModel}">
<TextBlock Text="{Binding FgText}" ToolTip="{Binding FpsTooltip}" />
@@ -349,14 +351,14 @@
<DataGridTextColumn Header="{x:Static res:Strings.Sessions_Col_Resolution}" Binding="{Binding ResolutionText}" />
<DataGridTextColumn Header="{x:Static res:Strings.Sessions_Col_GpuTemp}" Binding="{Binding GpuTempText}" />
<!-- beta.12 (D43): the game's own memory, both tiers; mean, the shared / working-set / commit peaks in the tooltip -->
<DataGridTemplateColumn Header="{x:Static res:Strings.Sessions_Col_GameVram}">
<DataGridTemplateColumn Header="{x:Static res:Strings.Sessions_Col_GameVram}" controls:CellName.Path="GameVramText">
<DataGridTemplateColumn.CellTemplate>
<DataTemplate DataType="{x:Type vm:SessionItemViewModel}">
<TextBlock Text="{Binding GameVramText}" ToolTip="{Binding GameVramTooltip}" />
</DataTemplate>
</DataGridTemplateColumn.CellTemplate>
</DataGridTemplateColumn>
<DataGridTemplateColumn Header="{x:Static res:Strings.Sessions_Col_GameRam}">
<DataGridTemplateColumn Header="{x:Static res:Strings.Sessions_Col_GameRam}" controls:CellName.Path="GameRamText">
<DataGridTemplateColumn.CellTemplate>
<DataTemplate DataType="{x:Type vm:SessionItemViewModel}">
<TextBlock Text="{Binding GameRamText}" ToolTip="{Binding GameRamTooltip}" />
@@ -365,14 +367,14 @@
</DataGridTemplateColumn>
<DataGridTextColumn Header="{x:Static res:Strings.Sessions_Col_Api}" Binding="{Binding ApiText}" />
<!-- beta.10: both tiers; the tooltip carries every share, the window, the back buffer and the source -->
<DataGridTemplateColumn Header="{x:Static res:Strings.Sessions_Col_Display}">
<DataGridTemplateColumn Header="{x:Static res:Strings.Sessions_Col_Display}" controls:CellName.Path="DisplayModeText">
<DataGridTemplateColumn.CellTemplate>
<DataTemplate DataType="{x:Type vm:SessionItemViewModel}">
<TextBlock Text="{Binding DisplayModeText}" ToolTip="{Binding DisplayModeTooltip}" />
</DataTemplate>
</DataGridTemplateColumn.CellTemplate>
</DataGridTemplateColumn>
<DataGridTemplateColumn>
<DataGridTemplateColumn controls:CellName.Path="FeaturesText">
<DataGridTemplateColumn.CellTemplate>
<DataTemplate DataType="{x:Type vm:SessionItemViewModel}">
<StackPanel Orientation="Horizontal">
@@ -383,7 +385,7 @@
</DataTemplate>
</DataGridTemplateColumn.CellTemplate>
</DataGridTemplateColumn>
<DataGridTemplateColumn Header="{x:Static res:Strings.Sessions_Col_Exit}">
<DataGridTemplateColumn Header="{x:Static res:Strings.Sessions_Col_Exit}" controls:CellName.Path="ExitText">
<DataGridTemplateColumn.CellTemplate>
<DataTemplate DataType="{x:Type vm:SessionItemViewModel}">
<StackPanel Orientation="Horizontal">
@@ -394,11 +396,11 @@
</DataTemplate>
</DataGridTemplateColumn.CellTemplate>
</DataGridTemplateColumn>
<DataGridTextColumn Header="{x:Static res:Strings.Sessions_Col_Tags}" Binding="{Binding TagsText}" />
<DataGridTemplateColumn>
<DataGridTextColumn Header="{x:Static res:Strings.Sessions_Col_Tags}" Binding="{Binding TagsText}" controls:CellName.Path="TagsText" />
<DataGridTemplateColumn controls:CellName.Path="OpenName">
<DataGridTemplateColumn.CellTemplate>
<DataTemplate DataType="{x:Type vm:SessionItemViewModel}">
<ui:Button Appearance="Secondary" Padding="8,2" Content="{x:Static res:Strings.Summary_Open}"
<ui:Button Appearance="Secondary" Padding="8,2" Content="{x:Static res:Strings.Summary_Open}" AutomationProperties.Name="{Binding OpenName}"
Command="{Binding DataContext.ViewModel.OpenSessionCommand, RelativeSource={RelativeSource AncestorType=Page}}"
CommandParameter="{Binding}" />
</DataTemplate>
+40 -8
View File
@@ -30,7 +30,7 @@
<ColumnDefinition Width="Auto" />
<ColumnDefinition Width="Auto" />
</Grid.ColumnDefinitions>
<ui:TextBlock Grid.Column="0" FontTypography="Title" Text="{Binding ViewModel.HeaderText}" />
<ui:TextBlock Grid.Column="0" FontTypography="Title" AutomationProperties.HeadingLevel="Level1" Text="{Binding ViewModel.HeaderText}" />
<ui:TextBox Grid.Column="1" MinWidth="220" Margin="0,0,12,0" VerticalAlignment="Center"
AutomationProperties.Name="{x:Static vm:GamesViewModel.SearchPlaceholder}"
Icon="{ui:SymbolIcon Search24}"
@@ -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}}" />
@@ -80,7 +110,7 @@
<ItemsControl.ItemTemplate>
<DataTemplate DataType="{x:Type vm:GameCardViewModel}">
<Grid>
<ui:CardAction IsChevronVisible="False" VerticalAlignment="Stretch" VerticalContentAlignment="Top"
<ui:CardAction IsChevronVisible="False" VerticalAlignment="Stretch" VerticalContentAlignment="Top" AutomationProperties.Name="{Binding AccessibleName}"
Command="{Binding DataContext.ViewModel.OpenCommand, RelativeSource={RelativeSource AncestorType=Page}}"
CommandParameter="{Binding}"
Icon="{ui:SymbolIcon Games24}">
@@ -112,7 +142,7 @@
</ui:CardAction>
<!-- beta.21 (D59): Play, over the card's corner rather than inside it, so the card stays one button. -->
<ui:Button Margin="0,10,10,0" Padding="6,4" HorizontalAlignment="Right" VerticalAlignment="Top"
AutomationProperties.Name="{x:Static res:Strings.Play_Button}"
AutomationProperties.Name="{Binding PlayName}"
Command="{Binding DataContext.ViewModel.PlayCommand, RelativeSource={RelativeSource AncestorType=Page}}"
CommandParameter="{Binding}"
Icon="{ui:SymbolIcon Play24}"
@@ -123,19 +153,21 @@
</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"
Visibility="{Binding ViewModel.ListView, Converter={StaticResource BoolToVis}}">
<DataGrid.Columns>
<!-- beta.21 (D59): Play, as on the cards. -->
<DataGridTemplateColumn Header="{x:Static res:Strings.Play_Button}" Width="Auto">
<DataGridTemplateColumn Header="{x:Static res:Strings.Play_Button}" Width="Auto" controls:CellName.Path="PlayName">
<DataGridTemplateColumn.CellTemplate>
<DataTemplate>
<ui:Button Margin="2,0" Padding="6,2" Appearance="Transparent"
AutomationProperties.Name="{x:Static res:Strings.Play_Button}"
AutomationProperties.Name="{Binding PlayName}"
Command="{Binding DataContext.ViewModel.PlayCommand, RelativeSource={RelativeSource AncestorType=Page}}"
CommandParameter="{Binding}"
Icon="{ui:SymbolIcon Play24}"
@@ -147,7 +179,7 @@
<DataGridTextColumn Header="{x:Static res:Strings.Games_List_Name}" Binding="{Binding Name}" Width="3*" />
<DataGridTextColumn Header="{x:Static res:Strings.Games_List_Store}" Binding="{Binding PlatformText}" Width="Auto" />
<DataGridTextColumn Header="{x:Static res:Strings.Games_List_Engine}" Binding="{Binding EngineText}" Width="*" />
<DataGridTemplateColumn Header="{x:Static res:Strings.Games_List_Status}" Width="*">
<DataGridTemplateColumn Header="{x:Static res:Strings.Games_List_Status}" Width="*" controls:CellName.Path="StatusText">
<DataGridTemplateColumn.CellTemplate>
<DataTemplate>
<TextBlock Margin="4,0" VerticalAlignment="Center" Text="{Binding StatusText}" ToolTip="{Binding NotInstalledToolTip}" />
+1 -1
View File
@@ -18,7 +18,7 @@
<RowDefinition Height="Auto" />
</Grid.RowDefinitions>
<ui:TextBlock Grid.Row="0" FontTypography="Title" Text="{x:Static vm:LogsViewModel.Header}" />
<ui:TextBlock Grid.Row="0" FontTypography="Title" AutomationProperties.HeadingLevel="Level1" Text="{x:Static vm:LogsViewModel.Header}" />
<!-- 08_UI §Logs: source toggle, level filter, search, pause-scroll; the two buttons. -->
<WrapPanel Grid.Row="1" Margin="0,12,0,8" Orientation="Horizontal">
+20 -15
View File
@@ -6,16 +6,17 @@
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:ui="http://schemas.lepo.co/wpfui/2022/xaml"
xmlns:res="clr-namespace:FrameLedger.App"
xmlns:services="clr-namespace:FrameLedger.App.Services"
xmlns:vm="clr-namespace:FrameLedger.App.ViewModels"
Title="{x:Static res:Strings.Settings_Header}"
Foreground="{DynamicResource TextFillColorPrimaryBrush}"
ScrollViewer.CanContentScroll="False">
<ScrollViewer VerticalScrollBarVisibility="Auto">
<StackPanel Style="{StaticResource PageRoot}">
<ui:TextBlock FontTypography="Title" Text="{x:Static vm:SettingsViewModel.Header}" />
<ui:TextBlock FontTypography="Title" AutomationProperties.HeadingLevel="Level1" Text="{x:Static vm:SettingsViewModel.Header}" />
<!-- 08_UI §Settings: Capture first, most important — the kill switch, the hook-enabled games, the layer, the safety link. -->
<ui:TextBlock FontTypography="Subtitle" Margin="0,20,0,8" Text="{x:Static res:Strings.Settings_Capture_Header}" />
<ui:TextBlock FontTypography="Subtitle" AutomationProperties.HeadingLevel="Level2" Margin="0,20,0,8" Text="{x:Static res:Strings.Settings_Capture_Header}" />
<ui:CardExpander Margin="0,4,0,0" IsExpanded="True" Icon="{ui:SymbolIcon ShieldError24}">
<ui:CardExpander.Header>
<Grid>
@@ -48,7 +49,7 @@
<ui:TextBlock Grid.Column="0" VerticalAlignment="Center" Text="{Binding Name}" />
<ui:Button Grid.Column="1"
Appearance="Secondary"
Command="{Binding RevokeCommand}"
AutomationProperties.Name="{Binding RevokeName}" Command="{Binding RevokeCommand}"
Content="{x:Static res:Strings.Settings_HookedGames_Revoke}" />
</Grid>
</DataTemplate>
@@ -112,11 +113,11 @@
</StackPanel>
<StackPanel Grid.Column="1" Margin="12,0,0,0" VerticalAlignment="Center" Orientation="Horizontal">
<ui:Button Appearance="Secondary"
Command="{Binding GrantCommand}"
AutomationProperties.Name="{Binding GrantName}" Command="{Binding GrantCommand}"
Content="{x:Static res:Strings.Settings_Exceptions_Grant}"
Visibility="{Binding CanGrant, Converter={StaticResource BoolToVis}}" />
<ui:Button Appearance="Secondary"
Command="{Binding WithdrawCommand}"
AutomationProperties.Name="{Binding WithdrawName}" Command="{Binding WithdrawCommand}"
Content="{x:Static res:Strings.Settings_Exceptions_Withdraw}"
Visibility="{Binding CanWithdraw, Converter={StaticResource BoolToVis}}" />
</StackPanel>
@@ -167,7 +168,7 @@
<!-- Recording policy: the three numbers and background capture (D16: the Agent reads them at session start) — off in a
viewer, which has no Agent (beta.18; every setting the Agent reads is, ViewerModeTests). -->
<ui:TextBlock FontTypography="Subtitle" Margin="0,20,0,8" Text="{x:Static res:Strings.Settings_Policy_Header}" />
<ui:TextBlock FontTypography="Subtitle" AutomationProperties.HeadingLevel="Level2" Margin="0,20,0,8" Text="{x:Static res:Strings.Settings_Policy_Header}" />
<ui:CardControl Margin="0,4,0,0" Icon="{ui:SymbolIcon Timer24}">
<ui:CardControl.Header>
<StackPanel>
@@ -218,7 +219,7 @@
meant recording nothing. Removed until a launch path exists. -->
<!-- beta.11 (owner request 2026-10-03: no row without a control): Data - Delete all sessions (D40). -->
<ui:TextBlock FontTypography="Subtitle" Margin="0,20,0,8" Text="{x:Static res:Strings.Settings_Data_Header}" />
<ui:TextBlock FontTypography="Subtitle" AutomationProperties.HeadingLevel="Level2" Margin="0,20,0,8" Text="{x:Static res:Strings.Settings_Data_Header}" />
<!-- beta.19 (owner decision D55): the Agent removes an entry whose game is no longer installed and that has no session. -->
<ui:CardControl Margin="0,4,0,0" Icon="{ui:SymbolIcon BoxDismiss24}">
<ui:CardControl.Header>
@@ -242,7 +243,7 @@
</ui:CardControl>
<!-- Agent: elevation is optional and no tier needs it. beta.11: the elevation line is the admin mode's own status, not a row of its own. -->
<ui:TextBlock FontTypography="Subtitle" Margin="0,20,0,8" Text="{x:Static res:Strings.Settings_Agent_Header}" />
<ui:TextBlock FontTypography="Subtitle" AutomationProperties.HeadingLevel="Level2" Margin="0,20,0,8" Text="{x:Static res:Strings.Settings_Agent_Header}" />
<!-- beta.10, the admin mode (D34): off by default; on shows the disclosure, and Windows asks at every Agent start. -->
<ui:CardControl Margin="0,4,0,0" Icon="{ui:SymbolIcon Shield24}">
<ui:CardControl.Header>
@@ -281,7 +282,7 @@
</ui:CardControl>
<!-- Appearance (PR-2) and window. -->
<ui:TextBlock FontTypography="Subtitle" Margin="0,20,0,8" Text="{x:Static vm:SettingsViewModel.AppearanceHeader}" />
<ui:TextBlock FontTypography="Subtitle" AutomationProperties.HeadingLevel="Level2" Margin="0,20,0,8" Text="{x:Static vm:SettingsViewModel.AppearanceHeader}" />
<ui:CardControl Margin="0,4,0,0" Header="{x:Static vm:SettingsViewModel.ThemeLabel}" Icon="{ui:SymbolIcon Color24}">
<ComboBox MinWidth="180"
AutomationProperties.Name="{x:Static vm:SettingsViewModel.ThemeLabel}"
@@ -290,6 +291,10 @@
SelectedValue="{Binding ViewModel.SelectedTheme, Mode=TwoWay}"
SelectedValuePath="Value" />
</ui:CardControl>
<!-- beta.35 (D91): a Windows contrast theme's colours win; this says so while one is on, and goes when it is off. -->
<ui:TextBlock Margin="12,4,0,0" Style="{StaticResource SecondaryText}" TextWrapping="Wrap"
Text="{x:Static res:Strings.Settings_Theme_ContrastOn}"
Visibility="{Binding Path=(services:ContrastTheme.IsOn), Converter={StaticResource BoolToVis}}" />
<ui:CardControl Margin="0,8,0,0" Header="{x:Static vm:SettingsViewModel.LanguageLabel}" Icon="{ui:SymbolIcon LocalLanguage24}">
<ComboBox MinWidth="180"
AutomationProperties.Name="{x:Static vm:SettingsViewModel.LanguageLabel}"
@@ -300,7 +305,7 @@
</ui:CardControl>
<!-- beta.21 (owner decision D59): what Play does. The App's own setting; the Agent never reads it. -->
<ui:TextBlock FontTypography="Subtitle" Margin="0,20,0,8" Text="{x:Static res:Strings.Settings_Games_Header}" />
<ui:TextBlock FontTypography="Subtitle" AutomationProperties.HeadingLevel="Level2" Margin="0,20,0,8" Text="{x:Static res:Strings.Settings_Games_Header}" />
<ui:CardControl Margin="0,4,0,0" Icon="{ui:SymbolIcon Play24}">
<ui:CardControl.Header>
<StackPanel>
@@ -338,7 +343,7 @@
<ui:ToggleSwitch AutomationProperties.Name="{x:Static res:Strings.Settings_GameArtTint_Label}" IsChecked="{Binding ViewModel.GameArtTint, Mode=TwoWay}" />
</ui:CardControl>
<ui:TextBlock FontTypography="Subtitle" Margin="0,20,0,8" Text="{x:Static res:Strings.Settings_Window_Header}" />
<ui:TextBlock FontTypography="Subtitle" AutomationProperties.HeadingLevel="Level2" Margin="0,20,0,8" Text="{x:Static res:Strings.Settings_Window_Header}" />
<ui:CardControl Margin="0,4,0,0" Icon="{ui:SymbolIcon Power24}">
<ui:CardControl.Header>
<StackPanel>
@@ -386,7 +391,7 @@
not exist is the same over-disclosure the privacy policy's version 2.2 removed from its table. The
setting stays in the registry, off, for the day a consumer exists (06_DATA_MODEL §Settings registry).
-->
<ui:TextBlock FontTypography="Subtitle" Margin="0,20,0,8" Text="{x:Static res:Strings.Settings_Updates_Header}" />
<ui:TextBlock FontTypography="Subtitle" AutomationProperties.HeadingLevel="Level2" Margin="0,20,0,8" Text="{x:Static res:Strings.Settings_Updates_Header}" />
<ui:CardControl Margin="0,4,0,0" Icon="{ui:SymbolIcon ArrowSync24}">
<ui:CardControl.Header>
<StackPanel>
@@ -416,7 +421,7 @@
<ui:ToggleSwitch AutomationProperties.Name="{x:Static res:Strings.Settings_AutoCheck_Label}" IsChecked="{Binding ViewModel.AutoCheckUpdates, Mode=TwoWay}" IsEnabled="{Binding ViewModel.ActsOnThisPc}" />
</ui:CardControl>
<ui:TextBlock FontTypography="Subtitle" Margin="0,20,0,8" Text="{x:Static res:Strings.Settings_Logging_Header}" />
<ui:TextBlock FontTypography="Subtitle" AutomationProperties.HeadingLevel="Level2" Margin="0,20,0,8" Text="{x:Static res:Strings.Settings_Logging_Header}" />
<ui:CardControl Margin="0,4,0,0" Icon="{ui:SymbolIcon Bug24}">
<ui:CardControl.Header>
<StackPanel>
@@ -427,7 +432,7 @@
<ui:ToggleSwitch AutomationProperties.Name="{x:Static res:Strings.Settings_LogDebug_Label}" IsChecked="{Binding ViewModel.LogDebug, Mode=TwoWay}" />
</ui:CardControl>
<ui:TextBlock FontTypography="Subtitle" Margin="0,20,0,8" Text="{x:Static vm:SystemInfoViewModel.Header}" />
<ui:TextBlock FontTypography="Subtitle" AutomationProperties.HeadingLevel="Level2" Margin="0,20,0,8" Text="{x:Static vm:SystemInfoViewModel.Header}" />
<ui:Card Margin="0,4,0,0">
<StackPanel>
<ItemsControl ItemsSource="{Binding SystemInfo.Lines}" Focusable="False">
@@ -449,7 +454,7 @@
</StackPanel>
</ui:Card>
<ui:TextBlock FontTypography="Subtitle" Margin="0,20,0,8" Text="{x:Static res:Strings.Settings_Legal_Header}" />
<ui:TextBlock FontTypography="Subtitle" AutomationProperties.HeadingLevel="Level2" Margin="0,20,0,8" Text="{x:Static res:Strings.Settings_Legal_Header}" />
<ui:CardAction Margin="0,4,0,24" Command="{Binding ViewModel.ReopenLegalCommand}" Icon="{ui:SymbolIcon DocumentText24}">
<ui:TextBlock Text="{x:Static res:Strings.Settings_Legal_Reopen}" />
</ui:CardAction>
@@ -0,0 +1,35 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using System.IO;
namespace FrameLedger.App.Services;
/// <summary>
/// <c>ACCESSIBILITY.md</c> (beta.35, owner decision D88): the project's accessibility statement — what FrameLedger aims
/// for, what works with the keyboard, a screen reader and contrast themes, what does not yet, and how to report a
/// barrier — embedded at build time from the repository root and shown under Help ▸ Accessibility, so the App shows
/// exactly the text this build was reviewed with.
/// </summary>
/// <remarks>
/// <b>Information, not terms</b>, like <see cref="LimitationsDocument"/>: it is not one of FR-11's documents
/// (<see cref="LegalDocuments.Keys"/>), and nothing here is accepted.
/// </remarks>
public static class AccessibilityDocument
{
/// <summary>The embedded resource's name (<c>FrameLedger.App.csproj</c>).</summary>
public const string ResourceName = "ACCESSIBILITY.md";
/// <summary>The same text in the repository at this build's source, for the window's button.</summary>
public static readonly Uri OnGitHub = RepositoryLinks.Blob(ResourceName);
/// <summary>The document's text, authoring comments removed.</summary>
/// <exception cref="InvalidOperationException">The build did not embed it.</exception>
public static string Load()
{
using Stream stream = typeof(AccessibilityDocument).Assembly.GetManifestResourceStream(ResourceName)
?? throw new InvalidOperationException($"the build did not embed {ResourceName}");
using var reader = new StreamReader(stream);
return LegalDocuments.StripComments(reader.ReadToEnd());
}
}
@@ -0,0 +1,14 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.App.Services;
/// <summary>How a screen reader treats an announcement (beta.35, D89).</summary>
public enum AnnouncementKind
{
/// <summary>A result or a change of state: read in turn, a newer one of the same kind replacing one not yet read.</summary>
Status,
/// <summary>Something the user must know — a safety notice, a failure, the agent gone: every one is read.</summary>
Alert,
}
@@ -22,7 +22,7 @@ public sealed class Confirmations : IConfirmations
SecondaryButtonAppearance = ControlAppearance.Danger,
CloseButtonText = Strings.Common_Cancel,
};
MessageBoxResult result = await box.ShowDialogAsync(cancellationToken: ct).ConfigureAwait(true);
MessageBoxResult result = await MessageBoxes.ShowAsync(box, ct).ConfigureAwait(true);
return result switch
{
MessageBoxResult.Primary => RemoveGameChoice.KeepSessions,
@@ -45,6 +45,6 @@ public sealed class Confirmations : IConfirmations
PrimaryButtonAppearance = ControlAppearance.Danger,
CloseButtonText = Strings.Common_Cancel,
};
return await box.ShowDialogAsync(cancellationToken: ct).ConfigureAwait(true) == MessageBoxResult.Primary;
return await MessageBoxes.ShowAsync(box, ct).ConfigureAwait(true) == MessageBoxResult.Primary;
}
}
@@ -0,0 +1,153 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using System.Windows;
using System.Windows.Media;
namespace FrameLedger.App.Services;
/// <summary>
/// A contrast theme's colours over the App's Fluent theme (beta.35, D91): every WPF UI theme resource given the user's colour
/// for its role (<see cref="ContrastRoles"/>), as one merged dictionary on top of the theme — the light or the dark one, as
/// the contrast theme is light or dark — and the accent's resources, which WPF UI's accent manager writes straight into the
/// application's resources and which outrank any merged dictionary, written there too. Removing it leaves the Fluent theme;
/// <c>ApplicationThemeManager.Apply(…, updateAccent: true)</c> then writes the accent back.
/// </summary>
public static class ContrastOverlay
{
/// <summary>
/// The accent's resources: the 21 WPF UI 4.3.0's <c>ApplicationAccentColorManager</c> sets in the application's own
/// resources (measured 2026-11-09), each with its role.
/// </summary>
public static IReadOnlyDictionary<string, (ContrastRole Role, bool Brush)> AccentKeys { get; } = new Dictionary<string, (ContrastRole, bool)>(StringComparer.Ordinal)
{
["SystemAccentColor"] = (ContrastRole.Highlight, false),
["SystemAccentColorPrimary"] = (ContrastRole.Highlight, false),
["SystemAccentColorSecondary"] = (ContrastRole.Highlight, false),
["SystemAccentColorTertiary"] = (ContrastRole.Highlight, false),
["SystemAccentBrush"] = (ContrastRole.Highlight, true),
["SystemFillColorAttentionBrush"] = (ContrastRole.Highlight, true),
["AccentFillColorDefault"] = (ContrastRole.Highlight, false),
["AccentFillColorSecondary"] = (ContrastRole.Highlight, false),
["AccentFillColorTertiary"] = (ContrastRole.Highlight, false),
["AccentFillColorDefaultBrush"] = (ContrastRole.Highlight, true),
["AccentFillColorSecondaryBrush"] = (ContrastRole.Highlight, true),
["AccentFillColorTertiaryBrush"] = (ContrastRole.Highlight, true),
["AccentFillColorSelectedTextBackgroundBrush"] = (ContrastRole.Highlight, true),
["AccentTextFillColorPrimaryBrush"] = (ContrastRole.HotTrack, true),
["AccentTextFillColorSecondaryBrush"] = (ContrastRole.HotTrack, true),
["AccentTextFillColorTertiaryBrush"] = (ContrastRole.HotTrack, true),
["AccentTextFillColorDisabled"] = (ContrastRole.GrayText, false),
["TextOnAccentFillColorPrimary"] = (ContrastRole.HighlightText, false),
["TextOnAccentFillColorSecondary"] = (ContrastRole.HighlightText, false),
["TextOnAccentFillColorSelectedText"] = (ContrastRole.HighlightText, false),
["TextOnAccentFillColorDisabled"] = (ContrastRole.GrayText, false),
};
/// <summary>
/// The colours of WPF UI 4.3.0's Fluent themes that none of its contrast dictionaries has (measured 2026-11-09), each with a
/// role: the navigation pane's separator, a gradient there, a line in the window text; the snowflake effect's two, the window.
/// </summary>
public static IReadOnlyDictionary<string, (ContrastRole Role, bool Brush)> FluentOnlyKeys { get; } = new Dictionary<string, (ContrastRole, bool)>(StringComparer.Ordinal)
{
["LeftNavigationViewSeparatorBrush"] = (ContrastRole.WindowText, true),
["SnowflakeGradientTop"] = (ContrastRole.Window, false),
["SnowflakeGradientBottom"] = (ContrastRole.Window, false),
};
/// <summary>
/// The text on the accent, which the overlay makes the highlight: the highlight's text. WPF UI's contrast dictionaries make
/// it the window text over an accent they leave as Windows' (measured 2026-11-09: white on Dusk's highlight, 1.62:1, in
/// every chip the App draws on the accent), so these are the App's roles, not inferred ones.
/// </summary>
public static IReadOnlyDictionary<string, (ContrastRole Role, bool Brush)> OnAccentKeys { get; } = new Dictionary<string, (ContrastRole, bool)>(StringComparer.Ordinal)
{
["TextOnAccentFillColorPrimary"] = (ContrastRole.HighlightText, false),
["TextOnAccentFillColorPrimaryBrush"] = (ContrastRole.HighlightText, true),
["TextOnAccentFillColorSecondary"] = (ContrastRole.HighlightText, false),
["TextOnAccentFillColorSecondaryBrush"] = (ContrastRole.HighlightText, true),
["TextOnAccentFillColorSelectedText"] = (ContrastRole.HighlightText, false),
["TextOnAccentFillColorSelectedTextBrush"] = (ContrastRole.HighlightText, true),
};
/// <summary>The overlay: every role-mapped key in the palette's colour for its role, and the transparent keys transparent.</summary>
public static ResourceDictionary Build(ContrastPalette palette)
{
ArgumentNullException.ThrowIfNull(palette);
var overlay = new Overlay();
foreach ((string key, (ContrastRole role, bool brush)) in ContrastRoles.Map)
{
overlay[key] = Value(palette.Of(role), brush);
}
foreach ((string key, (ContrastRole role, bool brush)) in OnAccentKeys)
{
overlay[key] = Value(palette.Of(role), brush);
}
foreach ((string key, bool brush) in ContrastRoles.Clear)
{
overlay[key] = Value(Colors.Transparent, brush);
}
foreach ((string key, (ContrastRole role, bool brush)) in FluentOnlyKeys.Where(k => !overlay.Contains(k.Key)))
{
overlay[key] = Value(palette.Of(role), brush);
}
return overlay;
}
/// <summary>Puts the palette over <paramref name="resources"/> (the application's), replacing an earlier overlay.</summary>
public static void Install(ResourceDictionary resources, ContrastPalette palette)
{
ArgumentNullException.ThrowIfNull(resources);
ArgumentNullException.ThrowIfNull(palette);
TakeOff(resources);
ContrastTheme.Active = palette;
resources.MergedDictionaries.Add(Build(palette));
foreach ((string key, (ContrastRole role, bool brush)) in AccentKeys)
{
resources[key] = Value(palette.Of(role), brush);
}
}
/// <summary>Takes the overlay away; the accent's own resources are the theme manager's to write back.</summary>
public static void Remove(ResourceDictionary resources)
{
ArgumentNullException.ThrowIfNull(resources);
TakeOff(resources);
ContrastTheme.Active = null;
}
/// <summary>Whether an overlay is on <paramref name="resources"/>.</summary>
public static bool IsInstalled(ResourceDictionary resources)
{
ArgumentNullException.ThrowIfNull(resources);
return resources.MergedDictionaries.OfType<Overlay>().Any();
}
// The overlays only: a palette replaced by another is never "off" in between.
private static void TakeOff(ResourceDictionary resources)
{
foreach (ResourceDictionary overlay in resources.MergedDictionaries.OfType<Overlay>().ToList())
{
_ = resources.MergedDictionaries.Remove(overlay);
}
}
private static object Value(Color colour, bool brush)
{
if (!brush)
{
return colour;
}
var solid = new SolidColorBrush(colour);
solid.Freeze();
return solid;
}
/// <summary>The overlay's own type, so it can be found and taken away again.</summary>
private sealed class Overlay : ResourceDictionary;
}
@@ -0,0 +1,43 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using System.Windows;
using System.Windows.Media;
namespace FrameLedger.App.Services;
/// <summary>
/// A Windows contrast theme's colours (beta.35, D91): the eight the user sees — and may edit — in Settings ▸ Accessibility ▸
/// Contrast themes. <see cref="FromSystem"/> reads the ones Windows has on now; a test builds its own.
/// </summary>
public sealed record ContrastPalette(Color Window, Color WindowText, Color Highlight, Color HighlightText, Color HotTrack, Color GrayText, Color ButtonFace, Color ButtonText)
{
/// <summary>The theme Windows has on now — the user's colours, edited or not, on Windows 10 and 11 alike.</summary>
public static ContrastPalette FromSystem() => new(
SystemColors.WindowColor, SystemColors.WindowTextColor, SystemColors.HighlightColor, SystemColors.HighlightTextColor,
SystemColors.HotTrackColor, SystemColors.GrayTextColor, SystemColors.ControlColor, SystemColors.ControlTextColor);
/// <summary>A dark window (Aquatic, Dusk, Night sky) rather than a light one (Desert): which Fluent theme lies under it.</summary>
public bool IsDark => ColorMath.Luminance(Window) < 0.5;
/// <summary>The colour of a role, fully opaque — a contrast theme has no translucent colours.</summary>
public Color Of(ContrastRole role)
{
Color c = role switch
{
ContrastRole.Window => Window,
ContrastRole.WindowText => WindowText,
ContrastRole.Highlight => Highlight,
ContrastRole.HighlightText => HighlightText,
ContrastRole.HotTrack => HotTrack,
ContrastRole.GrayText => GrayText,
ContrastRole.ButtonFace => ButtonFace,
ContrastRole.ButtonText => ButtonText,
_ => throw new ArgumentOutOfRangeException(nameof(role), role, "not a contrast role"),
};
return Color.FromRgb(c.R, c.G, c.B);
}
/// <summary>Every colour of the palette, in role order.</summary>
public IReadOnlyList<Color> Colors => [.. Enum.GetValues<ContrastRole>().Select(Of)];
}
@@ -0,0 +1,35 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.App.Services;
/// <summary>
/// The eight colours a Windows contrast theme is made of (beta.35, D91) — what Settings ▸ Accessibility ▸ Contrast themes
/// lets the user edit, and what every colour of a contrast-themed window is one of.
/// </summary>
public enum ContrastRole
{
/// <summary>The background of a window and of what is in it.</summary>
Window,
/// <summary>Text on <see cref="Window"/>; also borders and strokes.</summary>
WindowText,
/// <summary>A selected item's background; an accent's fill.</summary>
Highlight,
/// <summary>Text on <see cref="Highlight"/>.</summary>
HighlightText,
/// <summary>A link (Windows' "hyperlink" colour).</summary>
HotTrack,
/// <summary>Disabled text and controls.</summary>
GrayText,
/// <summary>A button's background.</summary>
ButtonFace,
/// <summary>A button's text.</summary>
ButtonText,
}
@@ -0,0 +1,219 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using System.Windows;
using System.Windows.Media;
namespace FrameLedger.App.Services;
/// <summary>
/// Which of a contrast theme's eight colours every WPF UI theme resource stands for (beta.35, D91), read from WPF UI 4.3.0's
/// own four high-contrast dictionaries (HC1 Dusk, HC2 Night sky, HCBlack Aquatic, HCWhite Desert).
/// </summary>
/// <remarks>
/// <para>
/// <b>Why not apply those dictionaries.</b> Measured 2026-11-09: each holds 459 keys, of which 84 of its 97 colours are a
/// <c>#FFFF0000</c> placeholder and 17 brushes (<c>SystemFillColor*Brush</c>, <c>MenuBar*</c>) throw when read; and their
/// colours are Windows 11's defaults, so a theme the user edited — or Windows 10's — would not be followed.
/// </para>
/// <para>
/// <b>What they are good for</b> is the role of each key: every brush there is one of the theme's eight colours (in HC1, 113
/// are the window colour, 68 the window text, 56 the highlight …). A key's role is the colour it has in all four — a key
/// that is the button face in one and the window in another is a button face — ties broken by its name, and a key with no
/// role colour anywhere (a placeholder, a throw) takes its brush twin's or its name's. <see cref="ContrastOverlay"/> then
/// gives every key the user's own colour for its role, and keeps the keys transparent there transparent.
/// </para>
/// <para>
/// <b>Only an opaque colour is evidence.</b> A brush that throws when its file is read alone does not throw in the App: its
/// forward reference falls back to the application's resources, and it reads as the Fluent theme's own fill — measured
/// 2026-11-09, <c>MenuBarItemBackgroundPressed</c> read <c>#0AFFFFFF</c> under the dark theme, the white of the window text
/// in three of the four, which made a pressed menu item white on white. A contrast theme has no translucent colour, so a
/// translucent one says nothing about a role, and the roles come out the same whichever Fluent theme lies under them.
/// </para>
/// </remarks>
public static class ContrastRoles
{
/// <summary>WPF UI 4.3.0's high-contrast theme files (<c>Resources/Theme/*.xaml</c>).</summary>
public static readonly IReadOnlyList<string> ThemeNames = ["HC1", "HC2", "HCBlack", "HCWhite"];
private static readonly Color _placeholder = Color.FromArgb(0xFF, 0xFF, 0, 0);
private static readonly Lazy<(IReadOnlyDictionary<string, (ContrastRole Role, bool Brush)> Roles, IReadOnlyDictionary<string, bool> Clear)> _inferred =
new(static () => Infer([.. ThemeNames.Select(Load)]));
/// <summary>Every key's role, and whether it is a brush (else a colour); keys transparent in a theme are in <see cref="Clear"/>.</summary>
public static IReadOnlyDictionary<string, (ContrastRole Role, bool Brush)> Map => _inferred.Value.Roles;
/// <summary>The keys transparent in one of the themes (true for a brush): the overlay keeps them transparent, so no colour of the Fluent theme under it shows through.</summary>
public static IReadOnlyDictionary<string, bool> Clear => _inferred.Value.Clear;
/// <summary>One of WPF UI's high-contrast dictionaries, read for its keys and colours — never applied.</summary>
public static ResourceDictionary Load(string theme)
{
ArgumentException.ThrowIfNullOrWhiteSpace(theme);
return new ResourceDictionary { Source = new Uri($"pack://application:,,,/Wpf.Ui;component/Resources/Theme/{theme}.xaml", UriKind.Absolute) };
}
/// <summary>The eight colours a high-contrast dictionary defines for itself (its <c>SystemColor*Color</c> keys).</summary>
public static ContrastPalette PaletteOf(ResourceDictionary dictionary)
{
ArgumentNullException.ThrowIfNull(dictionary);
return new ContrastPalette(
Read(dictionary, "SystemColorWindowColor"), Read(dictionary, "SystemColorWindowTextColor"),
Read(dictionary, "SystemColorHighlightColor"), Read(dictionary, "SystemColorHighlightTextColor"),
Read(dictionary, "SystemColorHotlightColor"), Read(dictionary, "SystemColorGrayTextColor"),
Read(dictionary, "SystemColorButtonFaceColor"), Read(dictionary, "SystemColorButtonTextColor"));
}
/// <summary>Every key's role across the dictionaries given (the four, in the App; a test's own, in a test), and the keys transparent in one.</summary>
public static (IReadOnlyDictionary<string, (ContrastRole Role, bool Brush)> Roles, IReadOnlyDictionary<string, bool> Clear) Infer(IReadOnlyList<ResourceDictionary> dictionaries)
{
ArgumentNullException.ThrowIfNull(dictionaries);
var seen = new Dictionary<string, List<HashSet<ContrastRole>>>(StringComparer.Ordinal);
var brush = new Dictionary<string, bool>(StringComparer.Ordinal);
var transparent = new HashSet<string>(StringComparer.Ordinal);
foreach (ResourceDictionary dictionary in dictionaries)
{
ContrastPalette palette = PaletteOf(dictionary);
foreach (string key in dictionary.Keys.OfType<string>())
{
object? value = TryRead(dictionary, key);
brush[key] = brush.GetValueOrDefault(key) || value is not Color;
Color? colour = value switch
{
Color c => c,
SolidColorBrush b => b.Color,
_ => null,
};
if (colour is { A: 0 })
{
_ = transparent.Add(key);
continue;
}
if (!seen.TryGetValue(key, out List<HashSet<ContrastRole>>? sets))
{
sets = [];
seen[key] = sets;
}
// Opaque only: a translucent colour is a Fluent fill a forward reference fell back to, never a contrast colour.
if (colour is { A: 0xFF } known && known != _placeholder)
{
sets.Add([.. Enum.GetValues<ContrastRole>().Where(r => palette.Of(r) == Color.FromRgb(known.R, known.G, known.B))]);
}
}
}
var roles = new Dictionary<string, (ContrastRole, bool)>(StringComparer.Ordinal);
foreach ((string key, List<HashSet<ContrastRole>> sets) in seen.Where(p => !transparent.Contains(p.Key)))
{
if (FromColours(key, sets) is { } role)
{
roles[key] = (role, brush[key]);
}
}
// A colour key with no role colour anywhere (a placeholder) takes the role of its brush twin; then the name decides.
foreach (string key in seen.Keys.Where(k => !transparent.Contains(k) && !roles.ContainsKey(k)))
{
roles[key] = (roles.TryGetValue(key + "Brush", out (ContrastRole Role, bool) twin) ? twin.Role : ByName(key), brush[key]);
}
return (roles, transparent.ToDictionary(static k => k, k => brush[k], StringComparer.Ordinal));
}
/// <summary>The role every dictionary agrees on, a tie broken by the name; null when no dictionary gave a role colour.</summary>
private static ContrastRole? FromColours(string key, List<HashSet<ContrastRole>> sets)
{
List<HashSet<ContrastRole>> informative = [.. sets.Where(static s => s.Count > 0)];
if (informative.Count == 0)
{
return null;
}
HashSet<ContrastRole> common = [.. informative[0]];
foreach (HashSet<ContrastRole> set in informative.Skip(1))
{
common.IntersectWith(set);
}
HashSet<ContrastRole> choices = common.Count > 0 ? common : [.. informative.SelectMany(static s => s)];
return choices.Count == 1 ? choices.First() : Prefer(key, choices);
}
/// <summary>Of several roles a colour fits, the one the key's name points at; a button's before a window's.</summary>
private static ContrastRole Prefer(string key, HashSet<ContrastRole> choices)
{
bool button = key.Contains("Button", StringComparison.Ordinal);
ContrastRole[] order = button
? [ContrastRole.ButtonFace, ContrastRole.ButtonText, ContrastRole.Window, ContrastRole.WindowText, ContrastRole.Highlight, ContrastRole.HighlightText, ContrastRole.HotTrack, ContrastRole.GrayText]
: [ContrastRole.Window, ContrastRole.WindowText, ContrastRole.Highlight, ContrastRole.HighlightText, ContrastRole.HotTrack, ContrastRole.GrayText, ContrastRole.ButtonFace, ContrastRole.ButtonText];
ContrastRole named = ByName(key);
if (choices.Contains(named))
{
return named;
}
return order.First(choices.Contains);
}
/// <summary>A role from the key's name alone — for a placeholder, or a brush that would not even load.</summary>
internal static ContrastRole ByName(string key)
{
ArgumentNullException.ThrowIfNull(key);
bool Has(string part) => key.Contains(part, StringComparison.Ordinal);
bool text = Has("TextFill") || Has("Foreground") || Has("Glyph") || (Has("Text") && !Has("Background"));
if (Has("Disabled"))
{
return ContrastRole.GrayText;
}
if (Has("OnAccent") || (text && (Has("Selected") || Has("Pressed"))))
{
return ContrastRole.HighlightText;
}
if (Has("AccentText") || Has("Hyperlink") || Has("Hotlight"))
{
return ContrastRole.HotTrack;
}
if (Has("Accent") || ((Has("Background") || Has("Fill")) && (Has("Selected") || Has("Pressed"))))
{
return ContrastRole.Highlight;
}
if (text)
{
return Has("Button") ? ContrastRole.ButtonText : ContrastRole.WindowText;
}
if (Has("Stroke") || (Has("Border") && !Has("MenuBar")))
{
return ContrastRole.WindowText;
}
// A system fill with no Background in its name is an icon's or a mark's colour: the text colour.
if (Has("SystemFillColor") && !Has("Background"))
{
return ContrastRole.WindowText;
}
return Has("Button") ? ContrastRole.ButtonFace : ContrastRole.Window;
}
private static object? TryRead(ResourceDictionary dictionary, string key)
{
try
{
return dictionary[key];
}
catch (Exception ex) when (ex is ResourceReferenceKeyNotFoundException or InvalidOperationException or System.Windows.Markup.XamlParseException)
{
return null;
}
}
private static Color Read(ResourceDictionary dictionary, string key) =>
TryRead(dictionary, key) is Color colour ? colour : throw new InvalidOperationException($"the high-contrast dictionary has no colour {key}");
}
@@ -0,0 +1,46 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using System.ComponentModel;
namespace FrameLedger.App.Services;
/// <summary>
/// The contrast theme the App's own colours follow now (beta.35, D91): set while <see cref="ContrastOverlay"/> is installed,
/// null otherwise. What WPF UI's theme resources cannot carry reads it — the charts' palette, the frame-generation bar, the
/// change badges, the artwork's tint. The UI thread's: set and read there.
/// </summary>
public static class ContrastTheme
{
private static ContrastPalette? _active;
/// <summary>WPF's change notice for a static property: what a binding to <see cref="IsOn"/> listens to, weakly.</summary>
public static event EventHandler<PropertyChangedEventArgs>? StaticPropertyChanged;
/// <summary>The palette, or null while no contrast theme is followed.</summary>
public static ContrastPalette? Active
{
get => _active;
internal set
{
if (Equals(_active, value))
{
return;
}
bool was = IsOn;
_active = value;
StaticPropertyChanged?.Invoke(null, new PropertyChangedEventArgs(nameof(Active)));
if (was != IsOn)
{
StaticPropertyChanged?.Invoke(null, new PropertyChangedEventArgs(nameof(IsOn)));
}
}
}
/// <summary>
/// A contrast theme is followed now — what XAML binds to, <c>{Binding Path=(services:ContrastTheme.IsOn)}</c>, to change
/// while it is shown: the Remove button's look (<c>DangerButton</c>), the line under Settings ▸ Theme.
/// </summary>
public static bool IsOn => _active is not null;
}
@@ -23,9 +23,11 @@ public sealed class DatabaseMaintenancePrompts : IDatabaseMaintenancePrompts
private readonly IAgentRequests _agent;
private readonly IFileSaver _files;
private readonly RegisteredSettings _settings;
private readonly IAnnouncer? _announcer;
public DatabaseMaintenancePrompts(IContentDialogService dialogs, LedgerDatabase db, IAgentRequests agent, IFileSaver files, RegisteredSettings settings)
public DatabaseMaintenancePrompts(IContentDialogService dialogs, LedgerDatabase db, IAgentRequests agent, IFileSaver files, RegisteredSettings settings, IAnnouncer? announcer = null)
{
_announcer = announcer;
_dialogs = dialogs ?? throw new ArgumentNullException(nameof(dialogs));
_db = db ?? throw new ArgumentNullException(nameof(db));
_agent = agent ?? throw new ArgumentNullException(nameof(agent));
@@ -35,7 +37,7 @@ public sealed class DatabaseMaintenancePrompts : IDatabaseMaintenancePrompts
public async Task ShowAsync(CancellationToken ct = default)
{
var viewModel = new DatabaseMaintenanceViewModel(new LedgerMaintenance(_db), _db.Path, _agent, _files, this, _settings);
var viewModel = new DatabaseMaintenanceViewModel(new LedgerMaintenance(_db), _db.Path, _agent, _files, this, _settings, announcer: _announcer);
var dialog = new ContentDialog
{
Title = Strings.Maintenance_Title,
@@ -57,7 +59,7 @@ public sealed class DatabaseMaintenancePrompts : IDatabaseMaintenancePrompts
PrimaryButtonAppearance = ControlAppearance.Danger,
CloseButtonText = Strings.Common_Cancel,
};
MessageBoxResult result = await box.ShowDialogAsync(cancellationToken: ct).ConfigureAwait(true);
MessageBoxResult result = await MessageBoxes.ShowAsync(box, ct).ConfigureAwait(true);
return result == MessageBoxResult.Primary;
}
}
+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)
{
@@ -12,4 +12,7 @@ public sealed record DocumentPage(string Title, string Text, string Path, bool I
{
/// <summary>The same file on GitHub, at this build's source.</summary>
public Uri Url => RepositoryLinks.Blob(Path);
/// <summary>The page list's item as a screen reader reads it (beta.35): the title, never the page's whole text.</summary>
public override string ToString() => Title;
}
@@ -14,6 +14,7 @@ public sealed class DocumentWindows(IUrlOpener urls, IThemeApplier theme, Appear
{
private DocumentWindow? _guide;
private DocumentWindow? _limitations;
private DocumentWindow? _accessibility;
private DocumentWindow? _alphaNotice;
private AboutWindow? _about;
@@ -44,6 +45,21 @@ public sealed class DocumentWindows(IUrlOpener urls, IThemeApplier theme, Appear
_limitations.Show();
}
public void ShowAccessibility()
{
if (Reveal(_accessibility))
{
return;
}
_accessibility = new DocumentWindow(Strings.Accessibility_Title, [new DocumentPage(Strings.Accessibility_Title, AccessibilityDocument.Load(), AccessibilityDocument.ResourceName)], urls, theme, appearance)
{
Owner = shell.Current,
};
_accessibility.Closed += (_, _) => _accessibility = null;
_accessibility.Show();
}
public void ShowAlphaNotice()
{
if (Reveal(_alphaNotice))
@@ -23,9 +23,9 @@ public static class EmbeddedDocuments
/// <summary>
/// The user guide's pages in reading order (beta.12, D44; <c>guide/</c> in the repository). Each page's title is its
/// first heading; <see cref="LimitationsDocument"/> closes the list, so the guide's links to it open in the window.
/// beta.17 (D54): the four reference pages after the FAQ make the guide the wiki's End-user part too; the alpha builds'
/// page joins them in beta.32 (D73).
/// first heading; <see cref="LimitationsDocument"/> and, since beta.35 (D88), <see cref="AccessibilityDocument"/> close
/// the list, so the guide's links to them open in the window. beta.17 (D54): the four reference pages after the FAQ make
/// the guide the wiki's End-user part too; the alpha builds' page joins them in beta.32 (D73).
/// </summary>
public static IReadOnlyList<string> GuidePages { get; } =
[
@@ -70,10 +70,13 @@ public static class EmbeddedDocuments
Page(Strings.About_Doc_Trademarks, Trademarks),
];
/// <summary>Help ▸ User guide: the guide's pages, each titled by its first heading, and the Limitations page after them.</summary>
/// <summary>
/// Help ▸ User guide: the guide's pages, each titled by its first heading, then the Limitations page and the
/// accessibility statement (beta.35, D88).
/// </summary>
public static IReadOnlyList<DocumentPage> Guide()
{
var pages = new List<DocumentPage>(GuidePages.Count + 1);
var pages = new List<DocumentPage>(GuidePages.Count + 2);
foreach (string path in GuidePages)
{
string text = Read(path);
@@ -81,6 +84,7 @@ public static class EmbeddedDocuments
}
pages.Add(new DocumentPage(Strings.Limitations_Title, LimitationsDocument.Load(), LimitationsDocument.ResourceName));
pages.Add(new DocumentPage(Strings.Accessibility_Title, AccessibilityDocument.Load(), AccessibilityDocument.ResourceName));
return pages;
}
@@ -122,6 +122,25 @@ public static class FpsPresentation
public static string PresentedLine(double? presented) => string.Format(CultureInfo.CurrentCulture, Strings.Fps_Presented_Format, Formats.Fps(presented));
/// <summary>
/// The readout in words, for a screen reader (beta.35, D88). CLAUDE.md rule 6 holds for speech as it does for the eye:
/// <c>Native 62 FPS, displayed 118 FPS, frame generation ×1.9</c> — the three together, never the displayed number alone —
/// a steady factor with the share of the session it covers, and a stand-alone number with its qualifier.
/// </summary>
public static string Spoken(FpsReadoutModel model)
{
ArgumentNullException.ThrowIfNull(model);
return model.Kind switch
{
FpsReadoutKind.Generated when model.Factor is double factor => model.SteadyShare is double share
? string.Format(CultureInfo.CurrentCulture, Strings.A11y_Fps_GeneratedSteady_Format, Formats.Fps(model.Native), Formats.Fps(model.Displayed), factor, share * 100)
: string.Format(CultureInfo.CurrentCulture, Strings.A11y_Fps_Generated_Format, Formats.Fps(model.Native), Formats.Fps(model.Displayed), factor),
FpsReadoutKind.Presented or FpsReadoutKind.IdentifiedUncounted when model.QualifierText is { } qualifier =>
string.Format(CultureInfo.CurrentCulture, Strings.A11y_Fps_Presented_Format, Formats.Fps(model.Presented), qualifier),
_ => model.Line,
};
}
public static string FactorChip(double factor) => FactorChip(factor, steadyShare: null);
/// <summary>The factor chip; a steady-state factor always carries the share of the session it describes: <c>×2.0 FG · 75%</c>.</summary>
@@ -78,4 +78,10 @@ public sealed record FpsReadoutModel
public bool QualifierIsWarning => Kind == FpsReadoutKind.IdentifiedUncounted || Qualifier is FpsQualifier.RuntimeLoaded or FpsQualifier.Withheld;
public string? FactorChip => Kind == FpsReadoutKind.Generated && Factor is double f ? FpsPresentation.FactorChip(f, SteadyShare) : null;
/// <summary>
/// The readout as a screen reader says it (beta.35, D88) — CLAUDE.md rule 6 holds for speech too: Native, Displayed and
/// the factor together, a steady factor with the share it covers; a stand-alone number with its qualifier.
/// </summary>
public string SpokenText => FpsPresentation.Spoken(this);
}
+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)
@@ -0,0 +1,18 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.App.Services;
/// <summary>
/// Tells a screen reader what just appeared (beta.35, owner decision D89): a safety notice, a banner, a short message at the
/// bottom of the window, a result. A screen reader reads what has the focus; a notice that appears elsewhere was never
/// heard. The words are the ones the window shows, in its language.
/// </summary>
public interface IAnnouncer
{
/// <summary>Says <paramref name="text"/> to a screen reader, if one listens.</summary>
/// <param name="text">The words, as shown.</param>
/// <param name="kind">How the screen reader treats them.</param>
/// <param name="activity">What kind of thing speaks (<c>Notice</c>, <c>Strip</c>, <c>Agent</c>…): a screen reader groups announcements by it.</param>
void Announce(string text, AnnouncementKind kind, string activity);
}
Loaded 100 of 219 files, more files were not shown because too many files have changed in this diff. Show more