Compare commits

..
Author SHA1 Message Date
poli0981 134115bfd5 Merge pull request #383 from poli0981/alpha4/pr2-sync-main
sync: main at 0.1.0-alpha.4's notes into alpha - v0.1.0-beta.37 on .NET 11.0.0; every switch file takes main's side and the branch now differs from main in RELEASE_LINE alone (D98) (alpha.4 PR-2)
2026-11-11 07:43:33 +07:00
poli0981andClaude Fable 5.2 da2cb93fa9 sync: main at 0.1.0-alpha.4's notes into alpha - v0.1.0-beta.37 on .NET 11.0.0; every switch file takes main's side and the branch now differs from main in RELEASE_LINE alone (D98) (alpha.4 PR-2)
main moved to .NET 11 with 0.1.0-beta.37 (D94), so what the alpha
branch held as its switch - global.json, the TFM, the three
runtime-serviced packages, legal/licenses/nuget, the Transitive row of
THIRD_PARTY_NOTICES - main now holds at released versions. All 27
conflicts were in those files and each takes main's side: the branch's
release-candidate lines go. RELEASE_LINE stays `alpha`, and
`git diff --name-only origin/main` on this tree prints that one name.

The alpha line rests after 0.1.0-alpha.4 (docs/12_BUILD.md, The alpha
line): no further sync follows a beta until a newer .NET is tried.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
2026-11-11 07:30:48 +07:00
poli0981andClaude Opus 5.5 eb1c375b87 sync: main at 0.1.0-alpha.3's notes into alpha - v0.1.0-beta.34 and the notes, by a merge commit (D87) (alpha.3 PR-2) (#364)
alpha takes main at 0.1.0-alpha.3's notes (27f537a, #363) - v0.1.0-beta.34 and the notes, no other change - by a merge commit (13_CI_CD §The alpha line). One file the switch holds moved on main, legal/THIRD_PARTY_NOTICES.md (#358's Streamline row), on a line the switch does not touch, so the merge took both without a conflict; main's package set is unchanged and the switch is alpha.1'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 passed on the 11 SDK (run 42198454631, net11.0), as the local trial of the same tree had.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-06 17:11:35 +07:00
poli0981andClaude Opus 5.5 4a0d5b482d sync: main at 0.1.0-alpha.2's notes into alpha - v0.1.0-beta.33 and the notes, by a merge commit (D82) (alpha.2 PR-3) (#355)
alpha takes main at 0.1.0-alpha.2's notes (4054492, #354) - v0.1.0-beta.33 and the notes, no other change - by a merge commit (13_CI_CD §The alpha line). No file the switch holds moved on main and its package set is unchanged, so nothing conflicted and the switch is alpha.1'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 passed on the 11 SDK (run 41597957507, net11.0).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-03 14:57:26 +07:00
poli0981andClaude Opus 5.5 a13206f220 build: the alpha line's switch - .NET 11 RC3 SDK and runtime, C# 15, the three runtime-serviced packages at 11.0.0-rc.3, the NuGet licence texts of that package set (D73, D76) (alpha.1 PR-1) (#349)
What the alpha branch differs from main by, and nothing else (docs/12_BUILD.md §The alpha line):
- RELEASE_LINE: alpha - release.yml tags this line vX.Y.Z-alpha.N only and packs it on Velopack's
  alpha channel; the App and the Agent act on it (the Alpha notice, its tick box, the Agent's
  wait, the badge and banner, the locked channel, the ledger copy).
- global.json: SDK 11.0.100-rc.3.26522.148, allowPrerelease (setup-dotnet installs exactly it).
- Directory.Build.props: TFM net11.0-windows10.0.22621.0; SupportedOSPlatformVersion stays 19045.
- Directory.Packages.props: Microsoft.Extensions.Hosting, Microsoft.Data.Sqlite and
  System.Diagnostics.EventLog 11.0.0-rc.3.26522.148 (Data.Sqlite 11 declares SQLitePCLRaw 3.0.5,
  SQLite 3.53.4).
- legal/licenses/nuget/: regenerated by tools/license-gather.ps1 - 69 packages (the nine
  Microsoft.Extensions abstractions are in the .NET 11 runtime; SQLitePCLRaw 3.0.5 and
  SourceGear's SQLite package); THIRD_PARTY_NOTICES says so.

./build.ps1 check on SDK 11.0.100-rc.3: ALL GATES PASSED - App 730, Application 553,
Infrastructure 536 of 538 (the two that need an administrator token), Domain 422, CaptureHost
137, Agent 32; coverage and licence OK. No source change: what .NET 11's SDK asked of the source
is on main (#345, spike-notes §24).

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-31 23:38:04 +07:00
252 changed files with 333 additions and 22746 deletions

No files matched your search

+4 -151
View File
@@ -59,12 +59,10 @@ dotnet_diagnostic.MA0011.severity = warning
# and GenerateDocumentationFile is on for the shipping ones.
dotnet_diagnostic.CS1591.severity = suggestion
# --- ReSharper inspections: what Qodana reads (docs/13_CI_CD.md §Qodana, D93 and D100) ---
# Qodana's linters run ReSharper's engine - Qodana for .NET since 2026-11-11, the Community linter before it - and the
# engine reads these keys; so does Rider or ReSharper in the editor, which is why they are here and not in
# qodana.yaml: the same list everywhere. An inspection is off only where it argues with a choice this project made;
# each line says which. Everything else it reports is fixed. (What is NOT ReSharper's - a whole severity, the
# IntelliJ platform's Markdown and XML inspections, JetBrains' security rules - has no key here and is in qodana.yaml.)
# --- ReSharper inspections: what Qodana reads (docs/13_CI_CD.md §Qodana, D93) ---
# Qodana Community for .NET is ReSharper's InspectCode, and InspectCode reads these keys - so does Rider or ReSharper
# in the editor, which is why they are here and not in qodana.yaml: the same list everywhere. An inspection is off
# only where it argues with a choice this project made; each line says which. Everything else it reports is fixed.
[*.{cs,xaml}]
# The compiler's missing-XML-comment warning, already a suggestion above (CS1591): InspectCode reports suggestions.
resharper_c_sharp_warnings_cs1591_highlighting = none
@@ -149,12 +147,6 @@ resharper_redundant_empty_switch_section_highlighting = none
# A binding path through a null yields no value, and the template shows nothing: that is the design.
resharper_xaml_possible_null_reference_exception_highlighting = none
[*.resx]
# A vi or ja value that equals the English one is deliberate: product and technology names, units and format strings
# are not translated, and a ja safety string is the English verbatim until a reviewer signs it (docs/09_I18N.md;
# tools/resx-audit.ps1 holds that rule). 271 results on Qodana for .NET's first run.
resharper_overridden_with_same_value_highlighting = none
[src/FrameLedger.App/**.cs]
# WPF codegen constraints, not style choices. The generated App.g.cs and
# *.g.cs partials declare these types public, so making them internal is a
@@ -184,142 +176,3 @@ resharper_collection_never_updated_local_highlighting = none
resharper_unused_method_return_value_local_highlighting = none
resharper_redundant_assignment_highlighting = none
resharper_return_type_can_be_not_nullable_highlighting = none
# --- ReSharper C++ inspections: what Qodana's native report reads (docs/13_CI_CD.md §Qodana, D99 and D100) ---
# The native report runs ReSharper's C++ engine, and with it the clang-tidy checks and clang diagnostics that engine
# bundles (the keys that say clang_tidy). The native code is built by MSVC alone, with /W4 /WX; what clang says about
# code it never compiles is read here as advice. An inspection is off only where it argues with a choice this project
# made, and each line says which; everything else the report found was fixed.
[src/native/**.{cpp,h,inl}]
# Where the compiler pads a struct. Information, not a fault: the layouts that matter are asserted (static_assert on
# sizes and offsets in fl_shm.h, and the mirror test against fl-layout-dump).
resharper_cpp_clang_tidy_clang_diagnostic_padded_highlighting = none
# MSVC's own keywords - __try/__except (rule 5's guard around every hook body), __declspec, __stdcall. This code is
# built by MSVC and by nothing else.
resharper_cpp_clang_tidy_clang_diagnostic_language_extension_token_highlighting = none
# A function looked up by name - GetProcAddress, vkGetInstanceProcAddr, a vtable slot - comes back as a pointer to
# another function type and is cast to its real one: that is the API. Through void* is how the cast says it is meant.
resharper_cpp_clang_tidy_clang_diagnostic_cast_function_type_strict_highlighting = none
resharper_cpp_clang_tidy_bugprone_casting_through_void_highlighting = none
# Memory read as something else - a COM object as its vtable, a relay's bytes as an address - says reinterpret_cast,
# also where static_cast from void* would compile.
resharper_cpp_reinterpret_cast_from_void_ptr_highlighting = none
# It proposes std::cmp_less for a comparison whose sides differ in sign. The comparisons it found cast one side
# explicitly, and the compiler's own sign warnings (C4018, C4388, C4389) are errors in this build.
resharper_cpp_clang_tidy_modernize_use_integer_sign_comparison_highlighting = none
# A `default:` under a switch that names every enumerator is deliberate: a value outside the enumeration - a corrupt
# one, a future one - takes the refusing arm instead of falling out of the switch.
resharper_cpp_clang_tidy_clang_diagnostic_covered_switch_default_highlighting = none
# "Not eliding copy on return": a verdict returned from a const local is copied. It is a few words wide.
resharper_cpp_clang_tidy_clang_diagnostic_nrvo_highlighting = none
# A type that owns a handle deletes its copies or declares none; the moves are then not generated either, which is
# what is wanted. Four more `= delete` lines would say nothing the destructor did not.
resharper_cpp_clang_tidy_cppcoreguidelines_special_member_functions_highlighting = none
# An enumeration zero-initialised (`D3D_FEATURE_LEVEL got{}`) is an out parameter cleared before the call that fills it.
resharper_cpp_clang_tidy_bugprone_invalid_enum_default_initialization_highlighting = none
# An enumeration's width is part of a layout or of the atomic word it is stored in, not a size to be minimised.
resharper_cpp_clang_tidy_performance_enum_size_highlighting = none
# "Possibly unused #include": a file that calls std::memset includes <cstring>, also when <windows.h> already brought
# it in. What it reported was of that kind, or a header named again inside a conditional block, but for two that
# nothing used; those were removed.
resharper_cpp_unused_include_directive_highlighting = none
# A function another file calls by a declaration of its own (the harness's Hold* functions), an entry point the
# loader calls by name (DllMain), a placeholder a target links: "can be made static" reads one file.
resharper_cpp_use_internal_linkage_highlighting = none
# "Can be made const": a parameter or a method through which the code acts on a device, a ring or a handle is not
# const because the type system would allow it; and a local that is already const gains nothing from constexpr - for a
# std::string it would hold only while the text fits the small-string buffer.
resharper_cpp_parameter_may_be_const_ptr_or_ref_highlighting = none
resharper_cpp_member_function_may_be_const_highlighting = none
resharper_cpp_variable_can_be_made_constexpr_highlighting = none
# THE ENGINE MISREADS THESE. (1) `std::atomic_ref<T>{x}.fetch_or(bit)` is reported as an expression without side
# effects; the side effect is the call. (2) A Win32, D3D12 or ffx-api structure is zero-initialised and then filled
# field by field - the reserved fields must stay zero - and is handed to the API by its address or its header's: the
# engine reports the initialiser as always rewritten and the fields as assigned and never used. (3) A test of a
# constexpr function (`Check(F(a) == b && G(a) == c, ...)`) has the engine evaluate it and call one side redundant.
resharper_cpp_expression_without_side_effects_highlighting = none
resharper_cpp_initialized_value_is_always_rewritten_highlighting = none
resharper_cpp_assigned_value_is_never_used_highlighting = none
resharper_cpp_redundant_boolean_expression_argument_highlighting = none
# Proposals to restate working code in a newer idiom - a range-for, std::ranges, any_of, starts_with, std::min, a raw
# string, an if with an initialiser, emplace_back. The native code is written to be read beside the hook path: an
# index and a plain loop, the same in the guard, its tests and the probes.
resharper_cpp_clang_tidy_modernize_loop_convert_highlighting = none
resharper_cpp_clang_tidy_modernize_use_ranges_highlighting = none
resharper_cpp_use_range_algorithm_highlighting = none
resharper_cpp_clang_tidy_readability_use_anyofallof_highlighting = none
resharper_cpp_clang_tidy_modernize_use_starts_ends_with_highlighting = none
resharper_cpp_clang_tidy_readability_use_std_min_max_highlighting = none
resharper_cpp_clang_tidy_modernize_raw_string_literal_highlighting = none
resharper_cpp_clang_tidy_modernize_use_emplace_highlighting = none
resharper_cpp_clang_tidy_modernize_return_braced_init_list_highlighting = none
resharper_cpp_use_associative_contains_highlighting = none
resharper_cpp_too_wide_scope_highlighting = none
resharper_cpp_if_can_be_replaced_by_constexpr_if_highlighting = none
# A structure Windows defines and this SDK's headers do not give (RTL_PROCESS_MODULE_INFORMATION,
# PROCESS_MEMORY_COUNTERS_EX2), and a test's stand-in for a Vulkan dispatchable object, are declared field for field:
# the fields nothing names are what puts the others at their offsets.
[src/native/{FrameLedger.Injector/src/fl_guard_sources.cpp,FrameLedger.ProcessStats/src/fl_process_stats.cpp,tools/fl-probe-guard/main.cpp,tests/vklayer_test.cpp}]
resharper_cpp_declarator_never_used_highlighting = none
# The linter's compiler, not the build's: NVAPI's header makes NvU32 `unsigned int` under clang and `unsigned long`
# under MSVC, which is the compiler that builds this probe - and `%lu` is right for it.
[src/native/tools/fl-probe-nvapi/main.cpp]
resharper_cpp_clang_tidy_clang_diagnostic_format_highlighting = none
# --- the probes, the harness and the tests ---
[src/native/{tools,tests}/**.{cpp,h}]
# printf, fprintf, fputs, fclose: a probe prints what it found and a test prints why it failed; neither has anything
# to do about a failed write to its own console.
resharper_cpp_clang_tidy_cert_err33_c_highlighting = none
# atoi on the harness's own arguments, which its tests write: a number that does not parse is 0, and the run that
# asked for it fails on its own assertion.
resharper_cpp_clang_tidy_bugprone_unchecked_string_to_number_conversion_highlighting = none
# A printf-shaped helper (`Note(fmt, ...)`): the attribute clang proposes is not MSVC's, and a parameter pack would
# be a second implementation of printf.
resharper_cpp_clang_tidy_modernize_avoid_variadic_functions_highlighting = none
resharper_cpp_clang_tidy_clang_diagnostic_missing_format_attribute_highlighting = none
# `&pointer` handed to an API that takes `void*` (ReadProcessMemory, a memcpy of a vtable slot, a Streamline array of
# constants): the conversion is the call's own.
resharper_cpp_clang_tidy_bugprone_multi_level_implicit_pointer_conversion_highlighting = none
# A test builds a handle or an address from a number, on purpose: a fake one, or one read from another process.
resharper_cpp_clang_tidy_performance_no_int_to_ptr_highlighting = none
# A macro that pastes its argument into a name (FL_DEV(vkGetDeviceQueue)) cannot put it in parentheses.
resharper_cpp_clang_tidy_bugprone_macro_parentheses_highlighting = none
# A test's fixture: a global with a std::string in it, a memcpy into a byte buffer that is not a string, two strings
# added in an assertion's message.
resharper_cpp_clang_tidy_bugprone_throwing_static_initialization_highlighting = none
resharper_cpp_clang_tidy_bugprone_not_null_terminated_result_highlighting = none
resharper_cpp_clang_tidy_performance_inefficient_string_concatenation_highlighting = none
# layout_test checks facts the compiler already knows - a constant's length, a bit-field's range - at run time, so
# that a failure prints which one: the branch that cannot be taken is the test passing.
resharper_cpp_unreachable_code_highlighting = none
resharper_cpp_clang_tidy_clang_diagnostic_unreachable_code_highlighting = none
resharper_cpp_clang_tidy_clang_diagnostic_tautological_value_range_compare_highlighting = none
# --- CODE LOADED INTO A GAME: the Overlay, the Vulkan layer, the shared-memory headers ---
# D100: here only a defect is fixed, in a pull request of its own with the hook's overhead measured (rule 5,
# 14_TESTING §Hook overhead). The report found none. What it did say about these files, each kept as it is:
[src/native/{FrameLedger.Overlay,FrameLedger.VkLayer,FrameLedger.Shm}/**.{cpp,h,inl}]
# Arms with the same body are different cases, each with its own comment saying why it reads as it does.
resharper_cpp_clang_tidy_bugprone_branch_clone_highlighting = none
# MinHook's MH_ALL_HOOKS is NULL, by its header.
resharper_cpp_zero_constant_can_be_replaced_with_nullptr_highlighting = none
# Kept on purpose, each with its reason beside it in dllmain.cpp: a retired enumerator whose bit must not be reused;
# slSetTag, deprecated by a header whose replacement no measured module exports.
resharper_cpp_enumerator_never_used_highlighting = none
resharper_cpp_clang_tidy_clang_diagnostic_deprecated_declarations_highlighting = none
# DEAD CODE, FOUND AND NOT REMOVED: nothing calls dllmain.cpp's LogNoteW. D100 changes code loaded into a game for
# a defect only, so taking it out is the owner's to order (HANDOFF, the native report's section) and not this
# report's to do. Until then this one file is not read for an unused function. Remove this section with it.
[src/native/FrameLedger.Overlay/src/dllmain.cpp]
resharper_cpp_declarator_never_used_highlighting = none
resharper_cpp_clang_tidy_clang_diagnostic_unused_function_highlighting = none
# The guard's rule matcher, which the Overlay compiles too. ResolveTolerance clears its out parameter with memset, as
# ResetRules does: a Tolerance is flags with default member initialisers, which is all "non-trivially default
# constructible" means here, and zero is what those initialisers say.
[src/native/FrameLedger.Injector/{src/fl_ac_rules.cpp,include/fl_ac_rules.h}]
resharper_cpp_clang_tidy_bugprone_raw_memory_call_on_non_trivial_type_highlighting = none
+21 -117
View File
@@ -1,31 +1,28 @@
# Qodana (owner decisions D93, 2026-11-10, and D99, 2026-11-11; docs/13_CI_CD.md §Qodana).
# Qodana (owner decision D93, 2026-11-10; docs/13_CI_CD.md §Qodana).
#
# JetBrains' template for the Qodana Scan action, changed where FrameLedger differs
# and each change said here:
#
# - The linter is Qodana for .NET (Rider's engine) in NATIVE mode, on a Windows
# runner: the projects target Windows, and the linter then builds and loads them
# with the SDK this job installs from global.json - no container, and no
# EnableWindowsTargeting. qodana.yaml names the linter and the mode; nothing is
# passed as an action argument. (Until beta.37 this was the Community linter in a
# Linux container, the one Linux job this repository had.)
# - The action is pinned to a commit, as every action that is not GitHub's own is
# here.
# - The linter is Qodana Community for .NET (qodana.yaml names it and says why): a
# Linux container, which is why this job alone runs on ubuntu-latest in a
# Windows-only project. EnableWindowsTargeting lets the .NET SDK there build and
# load projects whose target is Windows; it is passed to the container rather than
# written into Directory.Build.props, because no build of the product is meant to
# run anywhere but Windows.
# - The action is pinned to a commit (v2026.2.2, the newest; the template names
# v2026.1), as every action that is not GitHub's own is here.
# - Permissions are the ones the job uses: it reads the repository, writes a check
# run with the annotations and one comment on the pull request. The template's
# `contents: write` is for pushing quick-fixes, which this job never does.
# - A workflow of its own, as JetBrains advises, and ADVISORY: `main`'s required
# contexts stay `check` and the two `analyze` jobs. A problem Qodana finds, a
# Qodana Cloud outage or a lapsed licence is a red job beside a green `check`,
# never a blocked merge.
# - Two jobs, two reports (D99): `managed` reads the solution - the C#, the XAML and
# what Rider's plugins read around it - and reports to the Qodana Cloud project
# `frameledger`; `native` reads the C++ of src/native through a Visual Studio
# solution CMake generates for it, with settings of its own (qodana-native.yaml),
# and reports to `frameledger-cpp`. Neither reads what the other does. The pull
# request's comment and annotations are the managed job's alone.
# contexts stay `check` and the two `analyze` jobs. A problem Qodana finds, or a
# Qodana Cloud outage, is a red job beside a green `check`, never a blocked merge.
# - `main` only: the `alpha` branch is main's source under another release line
# (docs/13_CI_CD.md §The alpha line), and main's is what is analysed.
# - INTERIM since beta.37 (D94, 2026-11-11): main builds on .NET 11, which the
# linter's image does not carry (SDKs 8 to 10), so qodana.yaml's `bootstrap`
# installs the SDK global.json names into the container first. The Ultimate
# linter's pull request replaces this job with one on Windows.
name: Qodana
@@ -43,8 +40,7 @@ concurrency:
cancel-in-progress: true
jobs:
managed:
name: Qodana (managed)
qodana:
# A pull request from this repository, or a push or a dispatch. QODANA_TOKEN
# reaches neither a fork's pull request nor Dependabot's, and their token cannot
# write the check run or the comment.
@@ -52,7 +48,7 @@ jobs:
github.event_name != 'pull_request' ||
(github.event.pull_request.head.repo.full_name == github.repository &&
github.event.pull_request.user.login != 'dependabot[bot]')
runs-on: windows-latest
runs-on: ubuntu-latest
timeout-minutes: 60
permissions:
contents: read
@@ -68,111 +64,19 @@ jobs:
# A full history is required for pull request analysis.
fetch-depth: 0
# Native mode runs the linter in this job's environment, so the SDK it loads
# the projects with is this one. No MSVC step here on purpose: it exports
# Platform=x64, which MSBuild reads as a solution platform (build.ps1's
# Clear-VcxprojPlatform).
- name: Set up .NET
uses: actions/setup-dotnet@v6
with:
global-json-file: global.json
# Restored only: `check` saves this cache, under the same key.
- name: Restore the NuGet cache
uses: actions/cache/restore@v6
with:
path: ~/.nuget/packages
key: nuget-${{ runner.os }}-${{ hashFiles('**/Directory.Packages.props', 'global.json') }}
restore-keys: nuget-${{ runner.os }}-
# Built before it is inspected: a build that fails is then one red step with
# the compiler's own message, not a report of thousands of unresolved symbols.
# The native DLLs are absent here, so the .targets that copy them warn and the
# build goes on, as on a fresh clone.
- name: Build what the linter loads
shell: pwsh
run: |
dotnet build FrameLedger.slnx -c Release
if ($LASTEXITCODE -ne 0) { throw 'the build failed' }
# pr-mode false: the whole solution every time, so a pull request and `main`
# are judged by the same list. upload-result: the SARIF and the linter's log
# as an artifact of the run, for a reader with no Qodana Cloud account.
# Caches are saved from `main` only (a pull request reads them), under keys of
# this job's own: one per branch would crowd the repository's cache quota,
# which NuGet's share.
# Caches are saved from `main` only (a pull request reads them): one per
# branch would crowd the repository's cache quota, which NuGet's share.
- name: Qodana Scan
uses: JetBrains/qodana-action@3e8d76ff0e0241618abd808682f426afe84bab3f # v2026.2.2
with:
pr-mode: false
upload-result: true
artifact-name: qodana-report
cache-default-branch-only: true
primary-cache-key: qodana-managed-${{ github.ref_name }}-${{ github.sha }}
additional-cache-key: qodana-managed-main
env-vars-to-linter: EnableWindowsTargeting
env:
QODANA_TOKEN: ${{ secrets.QODANA_TOKEN }}
QODANA_ENDPOINT: 'https://qodana.cloud'
native:
name: Qodana (native)
# The same condition as `managed`, for the same reason: QODANA_TOKEN_NATIVE
# reaches neither a fork's pull request nor Dependabot's.
if: >-
github.event_name != 'pull_request' ||
(github.event.pull_request.head.repo.full_name == github.repository &&
github.event.pull_request.user.login != 'dependabot[bot]')
runs-on: windows-latest
timeout-minutes: 60
# No annotations and no comment from this job (below), so it writes nothing.
permissions:
contents: read
steps:
- uses: actions/checkout@v7
with:
ref: ${{ github.event.pull_request.head.sha }}
fetch-depth: 0
# global.json sits above the solution, and the linter resolves it.
- name: Set up .NET
uses: actions/setup-dotnet@v6
with:
global-json-file: global.json
# The Visual Studio generator finds the toolset itself: no MSVC step. Configure
# fetches MinHook, Catch2 and jsmn into the build tree, as the gate's does.
- name: Generate the solution and the one generated header
shell: pwsh
working-directory: src/native
run: |
cmake --version
cmake --preset x64-vs-analysis
if ($LASTEXITCODE -ne 0) { throw 'cmake configure failed' }
cmake --build --preset x64-vs-analysis --target fl_ac_floor_gen
if ($LASTEXITCODE -ne 0) { throw 'generating the blocklist floor failed' }
if (-not (Test-Path ../../build/native/x64-vs-analysis/FrameLedgerNative.slnx)) {
Get-ChildItem ../../build/native/x64-vs-analysis -Filter 'FrameLedgerNative.*' | ForEach-Object { Write-Host $_.Name }
throw 'CMake did not write FrameLedgerNative.slnx (qodana-native.yaml names it)'
}
# A report of its own: its own settings file, results folder, artifact, cache
# keys and Qodana Cloud project. The pull request's comment and annotations are
# the managed job's; a second job of the same linter would overwrite them.
- name: Qodana Scan
uses: JetBrains/qodana-action@3e8d76ff0e0241618abd808682f426afe84bab3f # v2026.2.2
with:
args: --config qodana-native.yaml
results-dir: ${{ runner.temp }}/qodana-native/results
cache-dir: ${{ runner.temp }}/qodana-native/caches
pr-mode: false
upload-result: true
artifact-name: qodana-report-native
cache-default-branch-only: true
primary-cache-key: qodana-native-${{ github.ref_name }}-${{ github.sha }}
additional-cache-key: qodana-native-main
post-pr-comment: false
use-annotations: false
env:
QODANA_TOKEN: ${{ secrets.QODANA_TOKEN_NATIVE }}
QODANA_ENDPOINT: 'https://qodana.cloud'
EnableWindowsTargeting: 'true'
+3 -6
View File
@@ -9,7 +9,7 @@ barrier. It is written for the person who has just met one; the details for deve
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.41. In the app: Help ▸ Accessibility.*
*Beta software: this page describes version 0.1.0-beta.37. In the app: Help ▸ Accessibility.*
## What FrameLedger aims for
@@ -29,7 +29,7 @@ notices Windows shows for it. It draws nothing inside a game, so it cannot make
| 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. **Ctrl+6** opens Advanced the same way while Advanced metrics is switched on, and does nothing while it is off. |
| **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. |
@@ -96,7 +96,7 @@ from the same translations. The documents — the user guide, this page, the leg
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, and **Ctrl+6** the Advanced page only while its option is on; a page slides in only while Windows' animation effects are on; the program
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
@@ -107,9 +107,6 @@ from the same translations. The documents — the user guide, this page, the leg
Each one with what to do instead. A barrier that is not on this list is worth reporting.
- **The Advanced page's "This PC" does not announce its readings as they change.** They change every second; a
screen reader reads the table when you move through it, and each row says its reading, its value and the time it
was read at.
- **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**.
-4
View File
@@ -41,10 +41,6 @@ Newest first. Each file holds that release's section exactly as it stood here.
| Version | Date | Notes |
|---|---|---|
| `0.1.0-beta.41` | 2026-11-12 | [`docs/changelog/0.1.0-beta.41.md`](docs/changelog/0.1.0-beta.41.md) |
| `0.1.0-beta.40` | 2026-11-12 | [`docs/changelog/0.1.0-beta.40.md`](docs/changelog/0.1.0-beta.40.md) |
| `0.1.0-beta.39` | 2026-11-11 | [`docs/changelog/0.1.0-beta.39.md`](docs/changelog/0.1.0-beta.39.md) |
| `0.1.0-beta.38` | 2026-11-11 | [`docs/changelog/0.1.0-beta.38.md`](docs/changelog/0.1.0-beta.38.md) |
| `0.1.0-alpha.4` | 2026-11-11 | [`docs/changelog/0.1.0-alpha.4.md`](docs/changelog/0.1.0-alpha.4.md) |
| `0.1.0-beta.37` | 2026-11-11 | [`docs/changelog/0.1.0-beta.37.md`](docs/changelog/0.1.0-beta.37.md) |
| `0.1.0-beta.36` | 2026-11-10 | [`docs/changelog/0.1.0-beta.36.md`](docs/changelog/0.1.0-beta.36.md) |
+9 -39
View File
@@ -73,12 +73,9 @@ RELEASE_LINE # `main`, or `alpha` on the alpha branch (D73, 20
build.ps1 # the quality gate; CI runs this identical script
SonarQube.Analysis.xml # SonarCloud's settings for ci.yml's sonarcloud job (D68, 2026-10-25; it replaced
.config/dotnet-tools.json # .sonarcloud.properties) and the scanner it runs — 13_CI_CD §SonarCloud
qodana-native.yaml # the same for the native job: the C++ of src/native, through the Visual Studio solution
# CMake writes for it (preset x64-vs-analysis), a report of its own (D99)
qodana.yaml # Qodana's settings for the managed job of .github/workflows/qodana.yml (D93; Qodana for
# .NET on the Ultimate licence since 2026-11-11, D99): the linter, the solution, a gate
# of zero problems, and what is switched off that .editorconfig has no key for —
# ReSharper's inspections are .editorconfig's resharper_* keys (D100) — 13_CI_CD §Qodana
qodana.yaml # Qodana's settings for .github/workflows/qodana.yml (D93, 2026-11-10): the linter, the
# solution, a gate of zero problems; the inspections' severities are .editorconfig's
# resharper_* keys — 13_CI_CD §Qodana
src/
native/
FrameLedger.Overlay/ # C++20 DLL injected into the game (hooks + ring writer + optional overlay)
@@ -103,25 +100,7 @@ src/
# composes it from, SessionEndReason, the census/NGX/marker facts;
# and Recording/ since 2026-09-10 (PR-D): SessionRecorder,
# SessionAggregator + FgLadder, SessionFinalizer, the .partial
# writer and PartialRecovery, ExitStatusMapper, the crash policy;
# and Advanced/ since 2026-11-11 (D101): AdvancedMetricCatalog, the one
# list "Advanced metrics" reads - what is read, and what is not with the
# reason (18_GPU_VENDOR_APIS §Advanced metrics) - and the value model
# (AdvancedValue / AdvancedFact / AdvancedReading / AdvancedSnapshot) and
# the port IAdvancedHardware. Infrastructure implements it: AdvancedHardwareHub
# (one reader for the Agent, on its own thread, only while held - D107) over
# NvapiAdvancedReader (the bridge's ABI 3) and LhmAdvancedReader (LhmGroups:
# the card; as administrator with PawnIO the processor, memory and board -
# never storage, D103). The Agent composes it since the switch, `telemetry.advanced`
# (PR-5, 2026-11-11: off by default; on, a session holds the hub), and
# Ipc/AdvancedMachineResponder answers GetAdvancedMachine from the hub's last
# snapshot - each request is the page's hold on it (PR-6, D107). Recording/
# AdvancedSessionBuilder stores what a session's samples carried (schema 0023:
# machine_profiles + session_advanced, adv.* series with NaN for a gap, D102).
# Train B (0.1.0-beta.40, D111): Capture/InGameAdvancedSampler turns the shared
# memory's region 5 - what a hooked game told DLSS and FSR, read by the Overlay
# only while the session asks (ICaptureObserver.WantsInGameAdvanced) - into session
# facts and two adv.* series; reach `Game` in the catalog; no schema change.
# writer and PartialRecovery, ExitStatusMapper, the crash policy
FrameLedger.Infrastructure/ # SQLite, shm reader, vendor APIs, injector interop, parsers,
# and Capture/ (PR-C): ShmRingAttacher/ShmCaptureSink over the
# reader, HeldProcessLivenessSource, TargetResolver (path only,
@@ -144,9 +123,7 @@ src/
# is built as of 2026-09-14 (PR-5 Games/Dashboard, PR-6 summary +
# charts, PR-7 trend/compare, PR-8a Settings/safety notices/Logs/
# --diag, PR-8b tray + the Agent's maintenance flags, PR-9 first run
# + Legal Gate FR-11); Strings.resx en/vi/ja. The Advanced page
# (2026-11-11, D101/D105: Pages/AdvancedPage, there and on Ctrl+6 only
# while `telemetry.advanced` is on - 08_UI §Advanced). `--data-dir <copy>`
# + Legal Gate FR-11); Strings.resx en/vi/ja. `--data-dir <copy>`
# (beta.15, D52) = a VIEWER: no Agent started or contacted,
# nothing on the PC changed, the profile's own folder refused
FrameLedger.CaptureHost/ # UNSHIPPED, and since P2 PR-C (2026-09-09) a THIN SHELL: verbs,
@@ -174,14 +151,7 @@ tools/ # accuracy-check, changelog-check, chokepoint-che
# versioninfo-check, vklayer-blastradius, fps-impact-runbook,
# wiki-build (beta.17: builds and checks the wiki; the wiki-check gate),
# buildid-check (beta.18: the release's build id in the shipped natives),
# docs-split-check (beta.24, D66: CHANGELOG/HANDOFF and their parts agree),
# agent-cost (D110, 2026-11-11: a developer tool, not a gate - what the shipped
# Agent costs per second of session, Advanced metrics off and on),
# nvapi-readonly-check (D108, 2026-11-11: every NVAPI call of the bridge is on
# nvapi-allowed-calls.txt, and none there writes or identifies),
# overlay-fields-check (D116, 2026-11-12: every member of a vendor's struct the
# Overlay reads for Advanced metrics is in fl_adv_fields.h and on
# overlay-allowed-fields.txt; a camera's position, axes and matrices nowhere)
# docs-split-check (beta.24, D66: CHANGELOG/HANDOFF and their parts agree)
# (six names added 2026-10-04)
# (PowerShell). This line used to name three, one of which
# — resx-audit — ~~does not exist~~ exists since 2026-09-13 with
@@ -208,13 +178,13 @@ Dependency direction: `App/Agent → Application → Domain`; **`Application →
## Coding conventions
**C# —** `Nullable enable`, `TreatWarningsAsErrors`, `AnalysisLevel latest-all`, file-scoped namespaces, Roslynator + Meziantou + VS Threading analyzers, `dotnet format` clean. Qodana reads the C# and the XAML in an advisory workflow of its own, with a gate of zero problems *(since 2026-11-10, D93; Qodana for .NET on the Ultimate licence since 2026-11-11, D99 — `13_CI_CD` §Qodana)*: fix what it reports, or switch the inspection off with the reason on the line above, **in the place the engine that raised it reads** *(D100)* — one of ReSharper's (C#, XAML, `.resx`, the C++) in `.editorconfig`; what has no key there (the hints as a severity, the Markdown and XML inspections, the files JetBrains' security rules were read in) in `qodana.yaml` — never anywhere else, never without a reason. A new file that starts a process fails `ProcessStartSitesTests`, and Qodana's security rule reports it: read what it starts and where the path and the arguments come from, then list it in the test, in `qodana.yaml` and in `13_CI_CD` §Qodana. Async suffixed `Async`, `ConfigureAwait(false)` off the UI. All user-visible strings from `.resx`. Timestamps UTC (unix-ms in SQLite); QPC ticks only inside the capture pipeline.
**C# —** `Nullable enable`, `TreatWarningsAsErrors`, `AnalysisLevel latest-all`, file-scoped namespaces, Roslynator + Meziantou + VS Threading analyzers, `dotnet format` clean. Qodana Community for .NET (ReSharper's inspections) reads the C# and the XAML in an advisory workflow of its own, with a gate of zero problems *(since 2026-11-10, D93 — `13_CI_CD` §Qodana)*: fix what it reports, or switch the inspection off in `.editorconfig` with the reason beside it — never in `qodana.yaml`, never without one. Async suffixed `Async`, `ConfigureAwait(false)` off the UI. All user-visible strings from `.resx`. Timestamps UTC (unix-ms in SQLite); QPC ticks only inside the capture pipeline.
**C++ —** `clang-format` (LLVM base, 4-space, 120 col) enforced in CI. No STL containers that allocate in hook paths. No `std::mutex` in hook paths. `-D_HAS_EXCEPTIONS=0` in the Overlay target. Every hook entry point wrapped per the `FL_HOOK_GUARD` macro (`17_HOOK_ENGINE`). Static analysis: ~~`/analyze` + clang-tidy (`bugprone-*`, `cert-*`, `concurrency-*`)~~ CodeQL (`codeql.yml`, a required check); `/analyze` and clang-tidy are not configured *(corrected 2026-10-04)*. SonarCloud analyses the C++ too, from CMake's compilation database, in `ci.yml`'s advisory `sonarcloud` job *(since 2026-10-25, D68 — `13_CI_CD` §SonarCloud)*. Qodana reads it as well, in a report of its own *(since 2026-11-11, D99: ReSharper's C++ inspections and the clang-tidy checks they run, advisory, a gate of zero — `13_CI_CD` §Qodana)*: fix what it reports, or switch the inspection off in `.editorconfig` with the reason above it; **in code loaded into a game only a defect is fixed**, in a pull request of its own with the overhead measured *(D100)*.
**C++ —** `clang-format` (LLVM base, 4-space, 120 col) enforced in CI. No STL containers that allocate in hook paths. No `std::mutex` in hook paths. `-D_HAS_EXCEPTIONS=0` in the Overlay target. Every hook entry point wrapped per the `FL_HOOK_GUARD` macro (`17_HOOK_ENGINE`). Static analysis: ~~`/analyze` + clang-tidy (`bugprone-*`, `cert-*`, `concurrency-*`)~~ CodeQL (`codeql.yml`, a required check); `/analyze` and clang-tidy are not configured *(corrected 2026-10-04)*. SonarCloud analyses the C++ too, from CMake's compilation database, in `ci.yml`'s advisory `sonarcloud` job *(since 2026-10-25, D68 — `13_CI_CD` §SonarCloud)*.
**Licence header —** every first-party source file (`.cs .cpp .h .inl .ps1 .xaml`) opens with two comment lines, `SPDX-License-Identifier: GPL-3.0-only` and `Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE` (beta.12, owner decision D45). GPLv3 §7 requires additional terms to be named in the source files, and `NOTICE` holds them — (b) preserve the notices, (c) mark modified versions, (e) no trademark rights in the name. `tools/notice-check.ps1` is a `build.ps1` gate; `-Fix` writes a missing header. `src/native/third_party/` is excluded.
**Struct mirroring —** ~~`FlFrameRecord`, `FlShmHandshake`, `FlWriterState` and `FlControlBlock`~~ `FlShmHandshake`, `FlWriterState`, `FlControlBlock`, `FlDisplayState` (layout 4, beta.10), `FlAdvancedState` (layout 5, 2026-11-11, Advanced metrics train B), `FlFrameRecord` and `FlTolerance` (D33, beta.9) each exist twice *(corrected 2026-10-04)*: `src/native/FrameLedger.Shm/include/fl_shm.h` / `fl_tolerance.h` (**normative**) and `src/FrameLedger.Shared/ShmLayout.cs` as `[StructLayout(LayoutKind.Sequential)]`. `ShmLayoutMirrorTests` asserts size and every field offset on both sides **against JSON emitted by ~~`tools/fl-layout-dump`~~ `src/native/tools/fl-layout-dump`**, never a transcribed table, and walks the field list in both directions so a field added on either side alone fails.
**Struct mirroring —** ~~`FlFrameRecord`, `FlShmHandshake`, `FlWriterState` and `FlControlBlock`~~ `FlShmHandshake`, `FlWriterState`, `FlControlBlock`, `FlDisplayState` (layout 4, beta.10), `FlFrameRecord` and `FlTolerance` (D33, beta.9) each exist twice *(corrected 2026-10-04)*: `src/native/FrameLedger.Shm/include/fl_shm.h` / `fl_tolerance.h` (**normative**) and `src/FrameLedger.Shared/ShmLayout.cs` as `[StructLayout(LayoutKind.Sequential)]`. `ShmLayoutMirrorTests` asserts size and every field offset on both sides **against JSON emitted by ~~`tools/fl-layout-dump`~~ `src/native/tools/fl-layout-dump`**, never a transcribed table, and walks the field list in both directions so a field added on either side alone fails.
It also asserts **blittability** (`RuntimeHelpers.IsReferenceOrContainsReferences`), because offsets cannot see it: measured 2026-08-05, swapping the `fixed byte BuildId[32]` for this repo's own `[MarshalAs(ByValTStr)] string` idiom keeps `Marshal.SizeOf` at 64 and every offset correct while `Unsafe.SizeOf` collapses to **40** — a mirror that passes the obvious checks and cannot be read out of a memory-mapped view.
+2 -35
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.41.*
*Beta software: this page describes version 0.1.0-beta.37.*
## Games it will not measure
@@ -173,38 +173,6 @@ shown is recorded too, from outside the game. ([Capture](docs/04_CAPTURE.md))
- **CPU temperature** needs *Run the agent as administrator* and the separately installed PawnIO driver, and
has not been verified on real hardware yet. CPU load is the time the processor was busy — not Task
Manager's "utility" figure, which can exceed 100%. ([Telemetry](docs/18_GPU_VENDOR_APIS.md))
- **Advanced metrics** (since 0.1.0-beta.39; Settings ▸ Recording, off by default) stores more of what the graphics
driver and the sensors report with each session. Its limits:
- **A session recorded while it was off is not filled in later**, and switching it on applies from the next session.
- **What a game tells DLSS and FSR** (since 0.1.0-beta.40) is kept only for a game FrameLedger measures from
inside, and only where the game hands it over in a call FrameLedger intercepts. **Most games set their DLSS
options through a call it cannot see and show nothing**; the FSR rows need FSR 3.1 or later through AMD's own
library. The session says which it was — nothing seen, or not measured inside the game — and neither means the
game uses no upscaler. They are the game's words, not a check of what the upscaler did; the field of view is a
lowest and highest value, never a line over time; FSR's memory is a point where the game asked, so most sessions
have none. **None of it has been read from a real game yet.**
- **The driver's own figures** — the card's firmware and architecture, its memory in detail, what a display can do
with HDR and variable refresh, the driver's settings for the game — exist on **NVIDIA** cards only. On other cards
they read N/A; the card's sensors (fans, voltages, loads) are read on every brand, and none has been tested on an
AMD or Intel card.
- **The sensors are read every five seconds**, NVIDIA's figures every second; between two readings a sensor has no
value, and its last one is not repeated.
- **The processor's, the memory's and the motherboard's sensors** need *Run the agent as administrator* and the
separately installed PawnIO driver, and **have never been read on real hardware**. Without them they read N/A
with the reason.
- **A drive's temperature is not read at all**: the sensor library cannot list drives without touching removable
ones. Power supplies, fan controllers and batteries are not read either.
- **No serial number and no display identification data (EDID) is read**, so two PCs with the same parts look the
same.
- **None of these readings has been checked against another tool**, and they are **not in an export or a bug
report**.
- **The Advanced page's "This PC" is read only while that page is open** (or a game is being recorded), is not
stored, and keeps five minutes of each reading in memory. A reading with more than eight parts — every
processor core — is drawn as its lowest, average and highest; the table lists each part.
- **A session's chart needs its per-second series**, which are kept for the newest sessions of each game only
(Settings ▸ Recording); an older session keeps its statistics.
([Telemetry](docs/18_GPU_VENDOR_APIS.md#advanced-metrics-owner-decisions-d101d108-2026-11-11))
- **Whether the graphics card was held back by its power limit or by heat** (since 0.1.0-beta.14) is known only on
NVIDIA cards, and only as it was at each once-a-second reading. On other cards it reads N/A.
- **Frames per watt** (since 0.1.0-beta.14) counts the game's own frames — never generated ones — against the graphics
@@ -215,8 +183,7 @@ shown is recorded too, from outside the game. ([Capture](docs/04_CAPTURE.md))
Off by default. When on, **Windows asks every time the agent starts** and names an unknown publisher, because
FrameLedger is not signed. It lets FrameLedger open games that run as administrator and read the CPU
temperature — with Advanced metrics on, also the processor's, the memory's and the motherboard's sensors — where
PawnIO is installed; it does not bypass anti-cheat, does not open protected processes, and does not make games you
temperature; it does not bypass anti-cheat, does not open protected processes, and does not make games you
start from FrameLedger run as administrator. **The risk:** FrameLedger is installed in your user folder, so a
program running under your account could replace its files and would then run as administrator the next time
you accept the prompt. Turn it on only if you trust everything that runs under your account.
+3 -16
View File
@@ -12,8 +12,8 @@ app too (Help ▸ User guide, Help ▸ Limitations, Help ▸ Accessibility), and
[wiki](https://github.com/poli0981/frameledger/wiki) with the developer pages.
<!-- accuracy-block:begin -->
> ⚠ **What FrameLedger actually measures today — 2026-11-11.** The software is a beta; its latest
> **beta is `0.1.0-beta.41`** (2026-11-12), 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.37`** (2026-11-11), an unsigned installer built from that tag with its
> checksums published beside it (alphas — experimental builds that try a newer .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
@@ -102,19 +102,6 @@ app too (Help ▸ User guide, Help ▸ Limitations, Help ▸ Accessibility), and
> Windows once a second and charted. Processor temperature is read only when the Agent runs as
> administrator — an option, off by default, for which Windows asks at every start of the Agent — with
> PawnIO installed, and that reading has not yet been checked on real hardware; everywhere else it is `N/A`.
> - **Advanced metrics (since beta.39; off unless you switch it on in Settings):** with it on, a session also stores
> what the graphics driver and the sensor library report about the hardware — the graphics card's memory, load,
> clocks, fans, voltages and power in detail, what a display can do, the driver's settings for the game — as they
> report it: NVIDIA's figures once a second, the sensor library's every five seconds. None of these readings has
> been checked against another tool. The processor's, the memory's and the motherboard's need the Agent as
> administrator with PawnIO and have never been read on real hardware; a drive's temperature is not read. The
> Advanced page shows them as they were stored, and what the PC reads at the moment only while that page is open.
> - **What a game tells its upscaler (since beta.40; only with Advanced metrics on, only for a game measured from
> inside):** the output size, presets and exposure a game hands DLSS, and the sharpening, jitter, exposure, depth
> range, field-of-view range, flags and frame time it hands FSR, are read from the arguments of the calls
> FrameLedger intercepts and shown as the game stated them — not checked against what the upscaler did. Most games
> set their DLSS options through a call that cannot be intercepted and show none; the FSR values need FSR 3.1 or
> later through AMD's own library. None of it has been read from a real game yet.
> - **Safety:** every pre-injection check runs before injection, including the signed-by-a-known-vendor
> half of the suspicious-module rule. During every capture the Agent re-runs the checks every 30 s and
> stops capturing on a refusal: a Direct3D or OpenGL game's hooks are removed, and the Vulkan layer
@@ -191,7 +178,7 @@ Elevation is **optional — for everything.** Hooked capture is the normal path
## Install
> **The latest beta is `v0.1.0-beta.41` (2026-11-12); before it `v0.1.0-beta.40` (2026-11-12), `v0.1.0-beta.39` (2026-11-11), `v0.1.0-beta.38` (2026-11-11), `v0.1.0-beta.37` (2026-11-11), `v0.1.0-beta.36` (2026-11-10), `v0.1.0-beta.35` (2026-11-09), `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`.
> **The latest beta is `v0.1.0-beta.37` (2026-11-11); before it `v0.1.0-beta.36` (2026-11-10), `v0.1.0-beta.35` (2026-11-09), `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**.
+1 -1
View File
@@ -1 +1 @@
main
alpha
-20
View File
@@ -479,26 +479,6 @@ function Invoke-ProjectGates {
# beta.24 (D66): CHANGELOG.md and docs/HANDOFF.md keep their paths as the index of their parts under docs/changelog/
# and docs/handoff/. A released section left in CHANGELOG.md, a release file whose heading is not its name or that
# links relatively, or an index and its files that do not name each other both ways is red here.
# 2026-11-11 (D108): "the bridge never calls a setter" was a sentence in docs/18 a reviewer checked by reading one
# file. With Advanced metrics the bridge calls forty-four NVAPI entry points, and the header declares a setter beside
# almost every getter: each call is held to tools/nvapi-allowed-calls.txt, in both directions, and a writer or a
# reader of an identifier (D104) is red even when the list names it. Text only - it runs with or without the native
# build.
Write-Step 'nvapi-readonly-check'
$nvapiTool = Join-Path $repo 'tools/nvapi-readonly-check.ps1'
Invoke-Checked 'nvapi-readonly-check (self-test)' { & $nvapiTool -SelfTest }
Invoke-Checked 'nvapi-readonly-check' { & $nvapiTool -RepoRoot $repo }
# 2026-11-12 (D116): the same for the code loaded into a game. Advanced metrics, train B, reads more members of
# the vendors' structs than the frame record ever needed, and the same structs hold where the player's camera is.
# Every such read is in one header, each member on tools/overlay-allowed-fields.txt in both directions; a camera's
# position, axes and matrices are named nowhere in the Overlay or the Vulkan layer, whatever the list says. Text
# only.
Write-Step 'overlay-fields-check'
$fieldsTool = Join-Path $repo 'tools/overlay-fields-check.ps1'
Invoke-Checked 'overlay-fields-check (self-test)' { & $fieldsTool -SelfTest }
Invoke-Checked 'overlay-fields-check' { & $fieldsTool -RepoRoot $repo }
Write-Step 'docs-split-check'
$splitTool = Join-Path $repo 'tools/docs-split-check.ps1'
Invoke-Checked 'docs-split-check (self-test)' { & $splitTool -SelfTest }
+1 -1
View File
@@ -162,7 +162,7 @@ The profile's own folder is refused there.)*
- **ADR-8:** **No evasion, ever** (`19_SAFETY` §What we will never build). This is an architectural constraint, not a preference — it defines what "correct" means for this codebase.
- **ADR-9:** Elevation demoted from required to optional; the Agent runs as a standard user by default.
**Chosen, not inherited, since beta.10 (owner decision D34, 2026-09-27):** Settings ▸ Capture agent ▸ *Run the agent as
administrator* (`capture.run_elevated`, off by default, a versioned disclosure — `agent-admin-dialog/2` *(`/1` until 2026-11-11, when Advanced metrics widened what the option adds — D101)* — before it turns
administrator* (`capture.run_elevated`, off by default, a versioned disclosure — `agent-admin-dialog/1` — before it turns
on). With it on, **Windows is asked every time the Agent starts** — a UAC prompt owned by the App's window when the App
starts it, flashing on the taskbar when the logon task does — and there is no silent path: no "highest privileges" task,
no service. The elevated Agent is started for one user (`--serve --for-user <SID>`) and refuses to run as another
+1 -2
View File
@@ -53,7 +53,6 @@ Requirement IDs (`FR-x`, `NFR-x`) are referenced by other docs, commits, and tes
- FR-5.3 Charts handle ≥ 500k points via min/max decimation; zoom/pan; PNG export.
- FR-5.4 Native/Displayed toggle wherever FG data exists.
- FR-5.5 Stutter markers annotated with cause when known (`PSO compile`, `VRAM budget exceeded`).
- FR-5.6 *(owner decision D101, 2026-11-11)* **Advanced metrics**: an option, off by default, and a page of its own that shows what the vendor interfaces make available — NVAPI, LibreHardwareMonitor through PawnIO, and in later releases Streamline and FidelityFX inside the game — each value under what it belongs to, the PC or one session, and each value that is not read listed with the reason. Off means nothing more is read or stored. `18_GPU_VENDOR_APIS` §Advanced metrics is the design and the inventory. *(Not built: the catalog exists, nothing reads it yet.)*
### FR-6 History & comparison
- FR-6.1 Sessions table per game: date, duration, tier badge, Native, Displayed, FG×, lows, resolution + upscaler, RT/PT/RR chips, crash badge, tags.
@@ -105,7 +104,7 @@ Draw live FPS/frametime/upscaler info inside the game. Only for games already ho
## Non-functional requirements
- **NFR-1 Game-side overhead:** ≤ 1 µs per present, ≤ 8 MB resident, measured game FPS impact ≤ 0.5% vs uninstrumented.
- **NFR-2 Agent overhead:** ~~≤ 1% of one core during capture~~ **≤ 2.5 % of one core during capture** *(owner decision D117, 2026-11-11: the 1 % had never been measured; measured in a real Agent it is 1.93 % with Advanced metrics off and 2.04 % with it on — `20_OPEN_QUESTIONS` §M16, `tools/agent-cost.ps1` — nearly all of it the once-a-second read of the graphics card's sensors, which stays)*, ≤ 150 MB working set *(measured: 113 MiB off, 119 MiB on)*, ~0% idle. *(D101, 2026-11-11: the limits hold with Advanced metrics on — FR-5.6. Its reads run on a thread of their own, the slow ones seldom, and with no game running only while its page is open (D107), so "~0% idle" is not spent on it. Measured on the development PC in a session that is not hooked; a hooked session, an elevated Agent with PawnIO's groups and a real game are the owner's run, `HANDOFF` §Owner-only.)*
- **NFR-2 Agent overhead:** ≤ 1% of one core during capture, ≤ 150 MB working set, ~0% idle.
- **NFR-3 Stability:** faults **originating in our own hook bodies** are contained by `FL_HOOK_GUARD`, counted, and self-disable the Overlay after 3 occurrences; the safety-unhook path completes within one frame. The Overlay adds no allocation, lock, syscall or logging to the present path.
> This deliberately does **not** say "must never crash a game" (`20_OPEN_QUESTIONS` §H8). SEH containment cannot reliably catch stack overflow, cannot intercept `__fastfail` — and `-D_HAS_EXCEPTIONS=0` converts a would-be STL throw into exactly that (`spike-notes.md` §H3) — and does not help when the game installs a vectored exception handler that runs first. An absolute promise the mechanism cannot support does not belong in a requirement, and must stay out of user-facing text: the Disclaimer already says injection carries risk, and that wording is the honest one.
+1 -4
View File
@@ -26,9 +26,6 @@ public interface IFrameSource : IAsyncDisposable
> DrainResult Drain(Span<FlFrameRecord> into, IList<ulong> gapIndices);
> void PublishGuardResult(uint completedEvaluations, bool unhookRequested);
> void SetPaused(bool paused); void RequestLogFlush();
> FlAdvancedState? AdvancedState { get; } void SetAdvancedRequested(bool requested); // region 5, train B (2026-11-12): the
> // word is written either way as the ring is attached, before the first guard result; the region is read only by
> // a session whose observer WantsInGameAdvanced, and carried on CaptureProgress.InGameAdvanced
> }
> public sealed class CaptureSession(...) // the loop: gate → inject → attach → drain, until something ends it
> {
@@ -540,7 +537,7 @@ Crash-within-60s-of-injection happening twice for the same game ⇒ **hooking au
|---|---|
| Game process, per present | ≤ 1 µs; no syscall, no allocation, no lock, no logging (`17_HOOK_ENGINE`) |
| Game process, resident | ≤ 8 MB (DLL + ring) |
| Agent, during capture | ~~≤ 1%~~ ≤ 2.5 % of one core average *(NFR-2 as D117 amended it, 2026-11-11: measured 1.93 %, `20_OPEN_QUESTIONS` §M16)*, ≤ 150 MB working set |
| Agent, during capture | ≤ 1% of one core average, ≤ 150 MB working set |
| Agent, idle | ~0% (1 Hz process poll only) |
| Measured game FPS impact | ≤ 0.5% vs uninstrumented, verified per release (`14_TESTING` §Hook overhead) |
+1 -53
View File
@@ -2,7 +2,7 @@
`%LOCALAPPDATA%\FrameLedger\ledger.db`. Pragmas: `journal_mode=WAL`, `synchronous=NORMAL`, `foreign_keys=ON`, `busy_timeout=5000`. `Microsoft.Data.Sqlite` + Dapper; all writes in explicit transactions.
**Writer ownership:** Agent writes `sessions`, `session_segments`, `frame_blobs`, `sensor_blobs`, `hardware_snapshots`, *(since schema 0023, 2026-11-11)* `machine_profiles` and `session_advanced`, the hook-state columns on `games`, **and since P4 PR-1 (2026-09-14) the *detected* columns on `games`** — `engine`, `engine_version`, `platform` under the per-field provenance rule (`05_DETECTION` §Caching: a `user` field is never touched), `capability_flags` whole, and the cache key `detection_rules_version` / `detection_exe_size_bytes` / `detection_exe_mtime_ms`, and since schema 0011 (2026-09-25) the executable's own facts `exe_machine` / `exe_file_version` / `exe_product_version` / `library_versions`, written whole like the flags — through `IGameRepository.ApplyDetectionAsync` only. The UI and the Agent were both already writers of `games`; this adds columns to the Agent's half, not a third writer (HANDOFF §P4). **And since P4 PR-4 the UI's library import writes `platform`, `store_id` and `game_version` through `ApplyStoreMetadataAsync`** — the same per-field provenance rule, badged `detected` (a store's record is not the user's typing), on columns the UI already owned. **And since 2026-09-23 the Agent's relocator merges two entries for one executable under two drive letters** (`IGameMerge`, HANDOFF D26, `19_SAFETY` §A moved drive is the same executable): in one transaction it re-parents the dropped entry's `sessions` to the survivor (before the delete — `sessions.game_id` cascades), carries a block or a crash auto-disable still in force to the survivor (`hook_enabled` only ever to 0; `hook_blocked_reason` is copied, never originated or cleared), adds the crash counts, deletes the dropped `games` row, and then moves the survivor to the file's path (after the delete — `exe_path` is UNIQUE). It was the one Agent write that deletes a `games` row until beta.19; it never touches a consent column. **And since beta.19 (2026-10-12, D55) the Agent removes an entry whose game is no longer installed** (`IGamePrune`, `SqliteGamePrune`, asked by the detection sweep through `UninstalledEntryPrune`): one `DELETE` that holds every stored condition in the same statement — the same row at the same path, `removed_at` NULL, no session stored (`NOT EXISTS` on `sessions` — nothing cascades), no `hook_blocked_reason`, `hook_prescan_state` not `blocked`, no `ac_exception_at` and no `ac_exception_trial_failed_at` — behind `retention.remove_uninstalled_games`; a block, a grant and D38's mark are never removed with their entry (`19_SAFETY` §What a finding does to the game, *What clears it*). **And since 2026-09-23 the UI writes `record_sessions`** (schema 0009, FR-1.6): the entry's recording switch, which the Agent only reads — off, the watcher does not watch for the program. The script's one data change switches it off for entries an old import made for Steam's own tools (`SteamLibrarySource.KnownTools`, the ids as of the script); a twin merge keeps it off when either twin had it off. **And since 2026-09-25 the Agent's pre-scan of the library (`19_SAFETY` §What a finding does to the game) writes the hook-state columns of every entry, not only of those the user asked to hook** — `hook_prescan_state`, and on a finding `hook_enabled = 0` and `hook_blocked_reason` — and its own key, `hook_prescan_rules_version` / `hook_prescan_exe_size_bytes` / `hook_prescan_exe_mtime_ms` (schema 0010), through `IGameConsentStore.RecordPreScanAsync` only: columns that were already the Agent's, never over a block, never a new row. **And since 2026-09-26 (schema 0014, D33) the Agent writes the user-mode exception's columns** — `ac_exception_*` on `games` through `IGameConsentStore` only (eligibility from the sweep, a grant from the `SetAntiCheatException` command, every end), and `sessions.ac_exception_family` with the session — the grant only after the user accepted its disclosure in the UI, which asks and never writes. **And since 2026-10-03 (beta.11, D40) the Agent deletes sessions on request** — every session of one game or of every game, `DeleteSessions` over the pipe, through `ISessionRepository.DeleteSessionsAsync` in one transaction (segments, blobs and annotations cascade), never while one is being recorded; the UI asks and never deletes a session row itself *(for Delete all sessions; FR-1.4's removal is the App's own cascade, above — corrected 2026-10-04)*. **Maintenance (P4 PR-7) adds no writer:** the retention sweep on demand is the Agent's, asked over the pipe; the UI's `VACUUM` rewrites pages with the same contents and changes no row (§Retention built note). UI writes `games` (user-editable fields — since P3 PR-3 that is the FR-1.3 metadata, the `*_default` tri-states, and `removed_at`; ~~never a `hook_*` column~~ **and two downgrades** *(corrected 2026-10-04)*: *Change executable* (2026-09-21, `GameLibrary.ChangeExecutableAsync`) turns hooking off, clears the consent and pre-scan columns and ends an excepLine truncated
**Writer ownership:** Agent writes `sessions`, `session_segments`, `frame_blobs`, `sensor_blobs`, `hardware_snapshots`, the hook-state columns on `games`, **and since P4 PR-1 (2026-09-14) the *detected* columns on `games`** — `engine`, `engine_version`, `platform` under the per-field provenance rule (`05_DETECTION` §Caching: a `user` field is never touched), `capability_flags` whole, and the cache key `detection_rules_version` / `detection_exe_size_bytes` / `detection_exe_mtime_ms`, and since schema 0011 (2026-09-25) the executable's own facts `exe_machine` / `exe_file_version` / `exe_product_version` / `library_versions`, written whole like the flags — through `IGameRepository.ApplyDetectionAsync` only. The UI and the Agent were both already writers of `games`; this adds columns to the Agent's half, not a third writer (HANDOFF §P4). **And since P4 PR-4 the UI's library import writes `platform`, `store_id` and `game_version` through `ApplyStoreMetadataAsync`** — the same per-field provenance rule, badged `detected` (a store's record is not the user's typing), on columns the UI already owned. **And since 2026-09-23 the Agent's relocator merges two entries for one executable under two drive letters** (`IGameMerge`, HANDOFF D26, `19_SAFETY` §A moved drive is the same executable): in one transaction it re-parents the dropped entry's `sessions` to the survivor (before the delete — `sessions.game_id` cascades), carries a block or a crash auto-disable still in force to the survivor (`hook_enabled` only ever to 0; `hook_blocked_reason` is copied, never originated or cleared), adds the crash counts, deletes the dropped `games` row, and then moves the survivor to the file's path (after the delete — `exe_path` is UNIQUE). It was the one Agent write that deletes a `games` row until beta.19; it never touches a consent column. **And since beta.19 (2026-10-12, D55) the Agent removes an entry whose game is no longer installed** (`IGamePrune`, `SqliteGamePrune`, asked by the detection sweep through `UninstalledEntryPrune`): one `DELETE` that holds every stored condition in the same statement — the same row at the same path, `removed_at` NULL, no session stored (`NOT EXISTS` on `sessions` — nothing cascades), no `hook_blocked_reason`, `hook_prescan_state` not `blocked`, no `ac_exception_at` and no `ac_exception_trial_failed_at` — behind `retention.remove_uninstalled_games`; a block, a grant and D38's mark are never removed with their entry (`19_SAFETY` §What a finding does to the game, *What clears it*). **And since 2026-09-23 the UI writes `record_sessions`** (schema 0009, FR-1.6): the entry's recording switch, which the Agent only reads — off, the watcher does not watch for the program. The script's one data change switches it off for entries an old import made for Steam's own tools (`SteamLibrarySource.KnownTools`, the ids as of the script); a twin merge keeps it off when either twin had it off. **And since 2026-09-25 the Agent's pre-scan of the library (`19_SAFETY` §What a finding does to the game) writes the hook-state columns of every entry, not only of those the user asked to hook** — `hook_prescan_state`, and on a finding `hook_enabled = 0` and `hook_blocked_reason` — and its own key, `hook_prescan_rules_version` / `hook_prescan_exe_size_bytes` / `hook_prescan_exe_mtime_ms` (schema 0010), through `IGameConsentStore.RecordPreScanAsync` only: columns that were already the Agent's, never over a block, never a new row. **And since 2026-09-26 (schema 0014, D33) the Agent writes the user-mode exception's columns** — `ac_exception_*` on `games` through `IGameConsentStore` only (eligibility from the sweep, a grant from the `SetAntiCheatException` command, every end), and `sessions.ac_exception_family` with the session — the grant only after the user accepted its disclosure in the UI, which asks and never writes. **And since 2026-10-03 (beta.11, D40) the Agent deletes sessions on request** — every session of one game or of every game, `DeleteSessions` over the pipe, through `ISessionRepository.DeleteSessionsAsync` in one transaction (segments, blobs and annotations cascade), never while one is being recorded; the UI asks and never deletes a session row itself *(for Delete all sessions; FR-1.4's removal is the App's own cascade, above — corrected 2026-10-04)*. **Maintenance (P4 PR-7) adds no writer:** the retention sweep on demand is the Agent's, asked over the pipe; the UI's `VACUUM` rewrites pages with the same contents and changes no row (§Retention built note). UI writes `games` (user-editable fields — since P3 PR-3 that is the FR-1.3 metadata, the `*_default` tri-states, and `removed_at`; ~~never a `hook_*` column~~ **and two downgrades** *(corrected 2026-10-04)*: *Change executable* (2026-09-21, `GameLibrary.ChangeExecutableAsync`) turns hooking off, clears the consent and pre-scan columns and ends an exception grant — it never writes a block or a grant — and *Remove game ▸ DeLine truncated
## Schema (v2 — hook architecture)
@@ -399,9 +399,6 @@ CREATE TABLE sensor_blobs (
-- beta.14 (D49) also gpu_core_clock|gpu_mem_clock (MHz), gpu_fan (RPM), gpu_mem_temp (°C)
-- and gpu_power_limit|gpu_thermal_limit (100 or 0 per tick, NVIDIA only) — a series name
-- needs no migration
-- since schema 0023 (2026-11-11, D102) also the ADVANCED series, every one under a name
-- that starts with `adv.` (Application.Advanced.AdvancedMetricCatalog): NaN, not -1,
-- for a tick with no reading, and read by FindAdvancedSensorsAsync only
-- cpu_load / ram_mb / cpu_temp and sessions.avg_cpu_load, avg_cpu_temp, max_cpu_temp,
-- avg_ram_mb were in schema 0001 with NO producer until 2026-09-21 (Telemetry.SystemTelemetrySource
-- on the poller's tick). Rows before that date hold NULL, which is what they measured; no migration.
@@ -467,7 +464,6 @@ switch's rule); integers are invariant-culture within an inclusive range; choice
| `capture.run_elevated` | bool | `0` | | The App when it starts the Agent, and an Agent the logon task started — both BEFORE the Agent exists, through `Infrastructure.Startup.RunElevatedSetting` (one row, `PRAGMA query_only`, no version gate, anything but `1` is off) (D34, beta.10): on, Windows is asked for administrator rights at every Agent start (`01_ARCHITECTURE` ADR-9) |
| `capture.min_session_s` | int | `30` | 5–600 | Agent, per session (FR-3.6) |
| `telemetry.interval_ms` | int | `1000` | 500–2000 | Agent, per session (FR-3.5) |
| `telemetry.advanced` | bool | `0` | | Agent, per session (FR-5.6, owner decision D101, 2026-11-11): **Advanced metrics**. On, a session holds the Agent's shared reader and stores its `adv.*` series and its `session_advanced` row (schema 0023); off — and any row that is not exactly `1` — nothing more is read or stored, and a session recorded while off has no row. Settings ▸ Recording (`18_GPU_VENDOR_APIS` §The switch) |
| `retention.raw_sessions_per_game` | int | `20` | 0–10000; **0 = unlimited** | Agent, per session (§Retention) |
| `retention.remove_uninstalled_games` | bool | `1` | | Agent, at every detection sweep (beta.19, D55, FR-1.8): on, an entry whose executable has been gone for ten minutes — its drive connected, the folder it was installed in still there — and that has no session and no anti-cheat block or exception is removed; off, it stays and reads *Not installed* (D41's behaviour) |
| `update.channel` | choice | ~~`stable`~~ `auto` (beta.14, D47) | `auto` · `stable` · `beta` | UI (P4 PR-5 reads it: `beta` = GitHub pre-releases too; `auto` follows the running copy, a pre-release asking for pre-releases — `11_UPDATER` §The update audit) |
@@ -495,18 +491,6 @@ Because Tier-1 and Tier-2 sessions carry different fields, every query that comp
> axis (a gap's interval is stored as 0), so a series still drifts ahead of its sensors past each gap.
> Sensor series are aligned to `t_ms` (milliseconds from `qpc_epoch`) and a tick with no reading is stored as
> **−1** — never 0, which would be a reading — because temperatures, loads, power and memory are never negative.
>
> **The advanced series are the exception, and say so by their name (schema 0023, owner decision D102).** A series
> whose name starts with `adv.` stores **NaN** for a tick with no reading: a motherboard's −12 V rail is negative, so
> −1 cannot mark a gap, and most of its ticks are gaps — the sensor library is read every fifth. They go through a
> second encoder, `ISeriesCodec.EncodeSparseFloat32`, which allows NaN and still refuses an infinity; **the rule
> above is not relaxed**: `EncodeFloat32` throws on a NaN as before, because a frame time has no gaps. Both decode
> with `DecodeFloat32`. `ISessionRepository.FindSensorsAsync` — what every summary, chart and export reads — leaves
> the `adv.` rows out (`series NOT LIKE 'adv.%'`), since those readers drop every negative value as "no reading";
> `FindAdvancedSensorsAsync` returns them with `t_ms` first. One session stores at most 256 of them
> (`AdvancedSessionBuilder.MaxSeries`); what is beyond is counted in its directory, not stored.
> **Size, measured 2026-11-11** on values shaped like the dev box's reader (17 series with a reading every tick, 41
> with one every fifth): one hour is 816 KiB raw and **189 KiB stored** — well inside NFR-5's 3 MB an hour.
## The `.partial` file
@@ -529,16 +513,6 @@ Because Tier-1 and Tier-2 sessions carry different fields, every query that comp
> | 6 `Note` | wall clock + UTF-8 text: a state transition | each transition |
> | 7 `Touches` | N × `i64` QPC at which the host touched the target | each flush |
> | 8 `SensorsWide` | the same samples under a 32-bit presence mask that carries the game process's memory (D43) | each flush, since beta.12 *(row added 2026-10-04)* |
> | 9 `SensorsAdvanced` | the advanced readings of the samples of the type-8 chunk before it (D101): `u16` names, then per name `u16` bytes and UTF-8; `u32` samples, then per sample `i64` QPC, `u16` readings and per reading `u16` name, `f64` value. Each chunk carries its own names, so it reads without any earlier chunk | each flush **in which a sample carries any** — with Advanced metrics off, never; the file is then byte for byte what it was (2026-11-11) |
> | 10 `AdvancedContext` | UTF-8 JSON (`AdvancedJson.OfContext`): the PC's facts, the session's, its series' directory, each source's state; the last one wins | the first flush after the recorder set it, and again only when it changed (2026-11-11) |
>
> **A chunk of a type the reader does not know is skipped, not the end of the file (owner decision D106,
> 2026-11-11).** Its length and checksum have been verified by then, so it is a whole chunk a newer build wrote.
> Until that day `_ => false` ended the read there, and a build one release older lost everything after the first
> new chunk — the price types 9 and 10 would have charged a beta.38 reading a beta.39 file. A chunk of a KNOWN type
> that does not parse still ends the read: that is a torn or a wrong file, not a newer one.
> (`PartialSessionFileAdvancedTests`: an unknown type between two known ones; the same with its checksum broken;
> a kill at every byte offset of a file that holds both new types.)
>
> Recovery (`PartialRecovery`): a file whose guid is already a row is deleted (the finalize had landed);
> one under the minimum session length is discarded; one with no readable header is dropped; the rest
@@ -744,32 +718,6 @@ 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.
> **`0023_advanced_metrics.sql` (2026-11-11, owner decisions D101 and D102) — what Advanced metrics stores.** Two
> tables and **no column on `sessions`** — the first `CREATE TABLE` since 0001. Every read of a `sessions` row, the
> JSON export and the bug bundle carry the whole row, and a driver profile does not belong in a bug bundle.
> `machine_profiles(id, hash UNIQUE, facts_json, captured_at)` holds the facts of the PC, one row per distinct set
> (`hash` = SHA-256 of `facts_json`); it stands beside `hardware_snapshots`, not in it, because that table's hash
> feeds the trend's hardware-change markers and a set of facts that exists only while an option is on would raise a
> marker each time the option is switched. `session_advanced(session_id PRIMARY KEY → sessions ON DELETE CASCADE,
> machine_profile_id → machine_profiles, facts_json, stats_json, series_json)` holds one row per session **recorded
> with the option on**: its facts and each source's state, the statistics of its advanced series (the form of
> `sensor_stats_json`), and the directory of the series that are members of a family. **A session recorded with the
> option off has no row** — that absence is how the App says "the option was off when this was recorded" rather than
> "nothing answered" — and is never given one. The JSON is `Application.Advanced.AdvancedJson`'s (camel case, nulls
> left out, a status by its name); writing is strict, reading is tolerant, and **only a fact whose catalog entry is
> read may be written** (`AdvancedJson.Storable`), so no identifier reaches either table (D104). **Since
> 0.1.0-beta.40 (train B) the same row holds what the game told its upscaler** — the session facts of the entries
> whose reach is `Game`, after the driver's, and `sources.inGame` (`Reading`, `NothingSeen`, `NotHooked`; absent in
> a row beta.39 wrote, which reads as "not said") — and its two series are `adv.ffx.upscale.frame_time_delta` and
> `adv.ffx.memory_usage` in `sensor_blobs`. No column and no script: schema 23 as it was. A session deleted
> takes its row with it; a profile no session points to is left, as a hardware snapshot is; the retention sweep
> removes a session's `adv.` series with its other raw series and keeps its row. Written by the Agent only, in the
> session's own transaction (`SqliteSessionRepository.InsertAdvancedAsync`). `LatestVersion` is 23;
> `LedgerDatabaseTests.ScriptTwentyThreeCreatesTheTwoAdvancedTablesAndAnEarlierSessionHasNoRow` (whose helper now
> undoes a script's `CREATE TABLE` and `CREATE INDEX` as well as its `ADD COLUMN`), the repository's four cases.
> **Nothing produces a row yet**: the option that switches the reader on is the next pull request's.
> **A beta.38 cannot open a ledger a later build migrated.**
> **`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
+5 -46
View File
@@ -14,17 +14,15 @@ in beta.9 without a row here)*:
Created by the Overlay on init, opened by the Agent. Name is deliberately plain and identifiable (`19_SAFETY` — no obfuscated object names).
Layout — **~~four~~ ~~five~~ six regions** (layout 4 since 2026-09-27, beta.10: region 4 is new and the ring moved
from `0xC0` to `0x100`; **layout 5 since 2026-11-11**, Advanced metrics train B: region 5 is new — twenty-three cache
lines, where the four before it are one each — and the ring moved from `0x100` to `0x6C0`):
Layout — **~~four~~ five regions, each exactly one 64-byte cache line before the ring** (layout 4 since
2026-09-27, beta.10: region 4 is new and the ring moved from `0xC0` to `0x100`):
```
[0x0000] FlShmHandshake 64 B write-once by the Overlay at init
[0x0040] FlWriterState 64 B Overlay-written (writeIndex touched every present)
[0x0080] FlControlBlock 64 B Agent-written
[0x00C0] FlDisplayState 64 B Overlay-written, at most every 500 ms per chain (layout 4)
[0x0100] FlAdvancedState 1472 B Overlay-written by its watchdog, once a second, only while the Agent asks (layout 5)
[0x06C0] FlFrameRecord[capacity] (64 B each, power-of-two capacity)
[0x0100] FlFrameRecord[capacity] (64 B each, power-of-two capacity)
```
The header is split in two on purpose. The immutable handshake and the
@@ -74,8 +72,7 @@ struct alignas(64) FlControlBlock { // Agent-written
uint32_t overlayEnabled; // @8 in-game overlay draw toggle (v1.1)
uint32_t guardTicks; // @12 completed guard evaluations, NOT a timer
uint32_t logFlushRequested; // @16 a COUNTER: bumped by the Agent at session end; the watchdog flushes the native log on a change (17_HOOK_ENGINE §Native logging, 2026-09-06)
uint32_t advancedRequested; // @20 0, or this session's request for Advanced metrics (D111): non-zero, new to this ring; written at attach, either way
uint32_t reserved[10]; // @24..63 must be zero
uint32_t reserved[11]; // @20..63 must be zero
};
struct alignas(64) FlDisplayState { // Overlay-written (layout 4, 2026-09-27, beta.10)
@@ -96,46 +93,9 @@ static_assert(sizeof(FlShmHandshake) == 64);
static_assert(sizeof(FlWriterState) == 64);
static_assert(sizeof(FlControlBlock) == 64);
static_assert(sizeof(FlDisplayState) == 64);
static_assert(sizeof(FlAdvancedState) == 1472); // region 5: fl_shm.h is its declaration, member by member
static_assert(FL_SHM_DISPLAY_OFFSET == 0xC0 && FL_SHM_ADVANCED_OFFSET == 0x100 && FL_SHM_RING_OFFSET == 0x6C0 && FL_SHM_RING_OFFSET % 64 == 0);
static_assert(FL_SHM_DISPLAY_OFFSET == 0xC0 && FL_SHM_RING_OFFSET == 0x100 && FL_SHM_RING_OFFSET % 64 == 0);
```
**Region 5 — what a hooked game told its upscaler (layout 5, 2026-11-11; Advanced metrics train B, owner decisions
D111 and D113; written by the Overlay's watchdog since 0.1.0-beta.40).** `18_GPU_VENDOR_APIS` §Train B is the design.
What the region is, as a contract between the two sides:
- **Off means nothing is read and nothing is written.** `FlControlBlock.advancedRequested` is the Agent's word that
this session records Advanced metrics — written at attach, either way, because the control block outlives a session
(`ShmRingReader.SetAdvancedRequested`). While it is 0 the Overlay reads no field and installs no hook beyond what
it did before, and writes nothing here: a ring nobody ever asked is zero from end to end (`fl_guard` checks every
byte, with a target that sends everything), and `validMask == 0` means "nothing was read", never "the game used
none of it".
- **"On" is a request, not a 1** *(2026-11-12)*. A game outlives a session, and so do the summaries the Overlay keeps
inside it — a range, a count, a mask of what was ever seen. So the word is a value no session of this ring used
before (above the word as it stands and above the request the region last answered; never 0), the watchdog starts
its summaries afresh at a value it has not seen, and every publication names the request it answers
(`FlAdvancedState.request`, the word that was `reserved0`). The reader returns only a publication that names the
value it wrote: what a second session of the same game finds in the region before the first tick is the first
session's, and is not read. After an "off" the region keeps its last publication, untouched.
- **One writer, once a second.** The detours keep process-local accumulators; the watchdog copies them here at its
tick. No game thread writes the region, so the seqlock has a single writer: `seq` odd, the fields, `seq` even.
- **The reader keeps its last consistent copy** (`ShmRingReader.AdvancedState`): null until something was published
for its request;
the same copy while `seq` has not moved, without copying 1472 bytes again; and that copy still when the writer is
inside on every attempt — a watchdog killed with its process leaves `seq` odd for good, and what it published
before is still what the game said.
- **Zero is "not read", never a value.** A Streamline `Boolean` and a DLSS preset are stored as the vendor's value
plus one; a float as its bits, with `FL_ADV_FLOAT_NONE` for "none seen" — the vendors' own sentinels are refused in
the detour and never reach the region; a size of 0 is "not given".
- **A per-frame value is summarised where it is seen**: a flag is an "ever seen" mask, a jitter the largest magnitude,
a field of view its lowest and highest (D114), the reported frame time a count and a sum the watchdog drains.
- **Sized once for the train's three releases.** The members ~~0.1.0-beta.41 and beta.42~~ 0.1.0-beta.42 and
beta.43 fill *(renumbered 2026-11-12, D118: a fix release took beta.41; the comments in `fl_shm.h` and
`ShmLayout.cs` still carry the old numbers until the release that fills each member rewrites them)* (`ffxFg*`,
`sl*`, `features`) are declared now and stay zero until then, so those releases bump no layout.
- The Vulkan layer never writes it. `ShmLayoutMirrorTests.TheAdvancedStateMirrorMatches` checks every member's
offset against `fl-layout-dump`; `ShmRingReaderTests` the three reads and that the request is stored either way.
**Region 4 — the presenting swap chain's display facts (layout 4, 2026-09-27, beta.10).** The owner asked for the game's
window size and display mode (exclusive fullscreen / borderless / windowed) and the share of a session each took. The two
facts only the process knows — whether the chain is in exclusive fullscreen, and which window it presents to — are
@@ -442,7 +402,6 @@ Unchanged in spirit from v1, bumped to `v2` for the new message set.
| `Shutdown` | UI→A | graceful stop → `ShutdownAck`, then the host stops (sessions finalize inside its grace window). *(Built 2026-09-13, PR-1b: `IAgentLifetime`, the host's under `--serve`, a logged no-op under `--console`.)* |
| `DeleteSessions` | UI→A | **Added 2026-10-03 (beta.11, D40).** `{ gameId? }` — every session of that game, or of every game when it is null, with their segments, frame and sensor series and annotations (they cascade) → `DeleteSessionsAck { gameId?, games, sessions }`. `Error SessionRunning` and nothing deleted while a session of that game — of any game, for all — is being recorded (`CaptureOrchestrator.IsRecording` / `IsRecordingAny`). The client names no rows beyond the game: they are the Agent's (§Writer ownership). Additive: an older Agent answers `Error UnknownType`, which the App says as "restart the agent". Carries no safety fact. |
| `SweepRetention` | UI→A | **no payload** — a trigger, like `UpdateRules`: the Agent applies `06_DATA_MODEL` §Retention to every game with the `retention.raw_sessions_per_game` it reads itself → `SweepRetentionAck { keep, games, sessions }` (`keep` 0 = unlimited, and then nothing was swept). *(Built 2026-09-15, P4 PR-7, for Tools ▸ Database maintenance: `Application.Recording.RetentionSweep` over `ISessionRepository.SweepRetentionAllAsync`, composed into `AgentCommandHandler` under `--serve`. The client names no number because the rows are the Agent's (§Writer ownership). Additive: an older Agent answers `Error UnknownType`, which the dialog reads as "restart the Agent". Carries no safety fact.)* |
| `GetAdvancedMachine` | UI→A | **Added 2026-11-11 (Advanced PR-6, owner decisions D101/D107).** `{ factsHash? }` → `AdvancedMachineAck { ready, takenAtUnixMs, factsHash?, factsJson?, readings[{ series, value }], series[{ series, metricId, label }], nvapi, nvapiCode?, sensors, elevatedSensors }` — what the Agent's shared advanced reader last read about this PC (`18_GPU_VENDOR_APIS` §The page's feed). **The handler reads no sensor**: the answer is the reader's last snapshot, one reference, because the pipe's read loop awaits its handler and a driver call there would hold up `Ping` and `StopSession`; the one thing it awaits is the option, a `settings` row asked for at most every two seconds. **A request is the page's hold on the reader**: the first acquires it and each renews a five-second lease, so the App asks once a second while the page is open and nothing has to say that it closed (`Application.Ipc.AdvancedMachineResponder`). `ready: false` — held, not yet read — carries nothing else. `readings` are that tick's only: a slow source is read every few ticks and the client keeps the last value it saw; a value that is not a number is left out. `factsJson` is the PC's facts as the ledger stores them (`AdvancedJson.OfFacts`), left out when the request's `factsHash` is the Agent's own. The three states are `AdvancedSourceStatus` names; a name a client does not know reads as unknown. `Error AdvancedOff` while `telemetry.advanced` is off — nothing is read, and a hold a previous request took is let go at once. Additive, protocol 2: an older Agent answers `Error UnknownType`, which the page shows as such. Carries no safety fact and changes nothing. |
| `SessionStarted` | A→UI | `{ sessionGuid, gameId, gameName, pid, tier, startedAt, hold? }` — **published once per session**: at the attach (tier 1, `startedAt` the attach), or — **since 2026-09-23** — at the first tick of a session held unhooked (tier 2, `startedAt` the session's start, `pid` 0 when the loop never opened the process, as a hooking-off hold never does). ~~a session that never attaches has no `SessionStarted`, only its `SessionCompleted` (tier 2)~~ — that was the beta.5 wire, and every hooking-off, refused or unreadable game read "Nothing is being captured." for as long as it ran. **`hold` (optional, tier 2 only)** is why nothing is measured: `{ reason, guardReason?, family?, signal?, hookingTurnedOff }` — the loop's `SessionEndReason` and, when the guard said anything but allow, its reason, family and signal: the same words the row's `capture_notes` will carry, so the live card and the summary read one sentence (`Formats.Tier2HoldReason` / `Tier2Reason`). The refusal's own event (`CaptureRefused` and the rest, below) goes out with this start rather than when the game exits, and is not repeated at the end |
| `SessionHeld` | A→UI | **Added 2026-09-23.** 1 Hz while a client listens, for a session held unhooked only: `{ sessionGuid, elapsedS, gpuTempC?, cpuTempC?, gpuLoadPct?, cpuLoadPct?, gameVramDedicatedMb?, gameRamPrivateMb? }` — how long it has run and the machine's sensors (and since beta.12 the game process's own memory, read from outside it — optional, an older client ignores them). **Never `SessionProgress`**: its `presents5s`, `presentedQualifier` and `fgMode` are required, and zeros there would put measured-looking numbers on the wire for a session that measures nothing (rule 6 has nothing to show and shows nothing) |
| `SessionProgress` | A→UI | 1 Hz: `{ sessionGuid, elapsedS, presents5s, presentedFps5s?, presentedQualifier, nativeFps5s?, displayedFps5s?, fgFactor?, fgMode, upscaler?, upscalerQuality?, upscalerDriverReported?, renderW/H?, outputW/H?, rtActive?, gpuTempC?, cpuTempC?, cpuLoadPct?, vramProcMb?, latencyUs?, fgRefusal?, fgRuntimeCensus?, gameVramDedicatedMb?, gameRamPrivateMb? }` (the last two added 2026-10-03, beta.12, optional: the game process's dedicated GPU memory and private working set, MiB, from the newest telemetry tick; `vramProcMb` stays reserved for the in-process figure and has no producer) — a 5 s rolling window over the ring through the SAME Domain calculators the row uses (`SessionProgressCalculator`, D13). **`upscalerQualityOverride` added 2026-10-19 (beta.24, D63), optional:** the mode an NVIDIA App override set when the driver reports it applied in the target and DLSS super resolution ran there — `performance`, `balanced`, `quality`, `ultra_performance`, `ultra_quality`, `dlaa`, or `override` when the driver's report alone does not settle the mode (the profile is the stored session's); absent otherwise. **`upscalerDriverReported` added 2026-09-21, optional:** `dlss` when the NVIDIA driver reports an NGX super-resolution feature created and evaluated in the target (`03_METRICS` §The driver-reported rung), so the live card says `DLSS (driver-reported)` where no hook can name the upscaler; identity only. **`cpuLoadPct` added 2026-09-21, optional** (CPU time busy over the last telemetry tick, 0–100; `cpuTempC` has a producer from the same date, present only when the Agent is elevated with PawnIO). **Two fields added 2026-09-14, both optional (an older client ignores them, §C):** `fgRefusal` is the row's `fg_refusal` (schema 0003) — present when `fgMode` names a technology and `fgFactor` is absent, so the live card can say "DLSS-G active — factor not counted" rather than N/A; `fgRuntimeCensus` is the raw census so the `fg_runtime_loaded` chip can name the module. **Rule 6 at the wire (2026-09-13):** `nativeFps5s` / `displayedFps5s` / `fgFactor` are present only when frame generation was measured in the window; otherwise `presentedFps5s` stands alone with `presentedQualifier` (`census_not_run` · `no_fg_runtime` · `fg_runtime_loaded` · `none_withheld`, the row's `presented_qualifier` from the same function). Every unmeasured field is absent, never 0. Suppressed when no client is connected |
+3 -60
View File
@@ -38,7 +38,7 @@ Compare showed the icon alone)*. Light/Dark/System themes via `ApplicationThemeM
> a refusal is a message box and exit 2. The viewer's folder is its own single-instance key, so it runs beside the
> profile's App. D6 is unchanged: the Agent's `--data-dir` stays under `--console`.
**NavigationView items:** Dashboard · Games · Compare · Logs · *Advanced* (since 2026-11-11, D105: last in `MenuItems`, `Visibility` bound to `Services.AdvancedOption.IsOn` — there only while `telemetry.advanced` is on, §Advanced) — `Settings` lives in `FooterMenuItems`. Icons from `SymbolIcon` (Fluent System Icons; pick from the `SymbolRegular` enum — see 16 §Icons).
**NavigationView items:** Dashboard · Games · Compare · Logs — `Settings` lives in `FooterMenuItems`. Icons from `SymbolIcon` (Fluent System Icons; pick from the `SymbolRegular` enum — see 16 §Icons).
**Menu bar**
- **File:** Add game… · Import library (Steam / GOG / Epic / itch.io / Xbox *— since beta.33*) · Export ▸ (Session CSV / Session JSON / Chart PNG) · Exit
@@ -850,64 +850,7 @@ Tail view of `ui-*.log` / `agent-*.log` (toggle), level filter, search (`ui:Auto
> The status line says shown / total / file. Tests: `LogTailTests`, `LogsViewModelTests`, and the page renders in
> `PagesLoadTests`.
### Advanced
> **Built 2026-11-11 (Advanced PR-7; owner decisions D101, D105, D107).** `Pages/AdvancedPage` over
> `ViewModels/AdvancedViewModel`, a `TabControl` of three tabs by what a value belongs to:
>
> - **This PC** — `Services.AdvancedMachineFeed`, watched between `Loaded` and `Unloaded` and while the page is visible
> (a window hidden to the tray lets go too), which is what makes the Agent read with no game running and stop when the
> page closes (D107). A status line says what the last request came to (`Advanced_State_*`: read at a time, waiting,
> off, no agent, an older agent, a viewer); *About this PC* is the facts under the catalog's groups; *Right now* is a
> `DataGrid` of every series with **the time it was read at** — a sensor read every fifth tick is never shown as new;
> *Over time* is one catalog entry's last five minutes (`Charts/AdvancedSeriesChart`, a date axis).
> - **Session** — a selector of the newest fifty sessions that have a `session_advanced` row
> (`ISessionRepository.ListAdvancedAsync`), then the PC's facts as they were and the session's own, the stored
> statistics, and the entry's series over the session (`SessionSeriesLoader.LoadAdvancedAsync`: `t_ms` is the clock,
> NaN is left out, a negative reading is kept). A session whose raw series retention removed keeps its statistics
> and says the series are gone. A session's summary has **Advanced metrics…** where the session has a row
> (`SessionSummaryViewModel.HasAdvanced`); it asks for that session through `Services.AdvancedSelection` and
> navigates, and a page already on screen takes the request at once.
> - **Sources** — every entry of `AdvancedMetricCatalog`: its label, what it belongs to, its source, and *Read*, or
> the reason it is not (`AdvReach_*`), or — live — why its source is silent (`AdvSource_*`). An entry read inside
> the game (reach `Game`, 0.1.0-beta.40) says *Read inside a game FrameLedger measures, when the game makes the
> call* (`Advanced_Status_InGame`): it is not a state of the PC. What became of those entries in one session is in
> that session's sources line on the Session tab (`Advanced_InGameLine` with `AdvInGame_*`): read, the game made none
> of the calls, or the session was not measured inside the game; a session stored before beta.40 has no such
> sentence.
>
> **Words.** Every catalog entry, group, reason, source state and driver token is a `Strings.resx` key made from its own
> name (`Adv_<id>`, `AdvGroup_*`, `AdvReach_*`, `AdvSource_*`, `AdvToken_*`) in `en`, `vi`, `ja`; the English label of
> an entry **is** its summary in the catalog, and a test holds the two equal. A key that is not there — a token a
> newer build stored — reads as the stored text, never as nothing (`ViewModels/AdvancedLabels`).
> `ViewModels/AdvancedPresenter` is the pure mapping, each rule with a test.
>
> **Charts.** A family with more than eight members is drawn as its lowest, average and highest
> (`AdvancedPresenter.MaxLines`), and the page says so; the table beside it lists every member. Lines differ by
> pattern as well as colour (`ChartPatterns`).
>
> **A viewer** (`--data-dir`) has no Agent: *This PC* says so, the page opens on *Session*, and nothing is asked. The
> navigation item is there when the copy's option is on **or the copy holds an advanced session** (`App.RunAsync`).
>
> **Accessibility** (`ACCESSIBILITY.md` §For contributors): one first-level heading, a level on every section; the two
> templates are implicit by type, so no page-local resource key is named; every row type overrides `ToString` so an
> item is read by its text; no `LiveSetting` — the readings change every second and are not announced; each chart has
> its name and says its numbers are in the table beside it. Tests: `AdvancedPresenterTests`, `AdvancedViewModelTests`,
> `PagesLoadTests` (the page among every surface, both themes, the contrast themes), `AccessibilityTests`
> (`CtrlOneToFive…`), `GuideDocumentsTests`.
### Settings
> **Advanced metrics (2026-11-11, owner decision D101; Advanced PR-5).** The Recording section has **Advanced metrics**
> (`telemetry.advanced`, off by default, off in a viewer like every setting the Agent reads): one `ui:CardControl` with a
> `ToggleSwitch`, under *Raw series kept per game*. Its text says what is read, that off reads and stores nothing more,
> that it applies from the next session and that an earlier session is not filled in. The Agent reads it at each
> session's start, so the row gets the usual "Applied. The capture agent reads it at the next session" strip. The
> switch also sets `AdvancedOption.IsOn` at once, so the navigation item and Ctrl+6 follow it without a restart
> (§Advanced, PR-7). With it, three texts that said what
> an Agent running as administrator adds with PawnIO now name the processor's, the memory's and the motherboard's
> sensors beside the CPU temperature: the Agent section's elevation line, the first run's Agent step, and the admin
> mode's disclosure (`agent-admin-dialog/2`). Tests: `SettingsViewModelTests.AdvancedMetricsIsOffByDefaultAndItsToggleIsPersisted`,
> `ViewerModeTests.EverySettingTheAgentReadsIsOffInAViewer`, `GuideDocumentsTests.TheSettingsPageOfTheGuideNamesEverySetting`.
>
> **beta.23 (owner decisions D60/D61).** The Games section has, under the Play button, **Show game artwork**
> (`ui.game_art`, on) and **Colour the game page from its artwork** (`ui.game_art_tint`, on; disabled while the first is
> off) — the game page's artwork and its band's colour (§Games › Game detail, *The header's cover*). Neither downloads
@@ -948,7 +891,7 @@ Agent section: elevation state with a plain explanation of what elevation *optio
> **The admin mode, beta.10 (owner decision D34; `01_ARCHITECTURE` ADR-9).** The Agent section has a switch, *Run the agent
> as administrator* (`capture.run_elevated`, off by default). Turning it on opens a `ContentDialog`
> (`Services.AgentAdminPrompt`, text `FrameLedger.Shared`'s `Safety_AdminMode_*`, version `agent-admin-dialog/2` *(`/1` until 2026-11-11, when Advanced metrics widened what the option adds — D101)* in its
> (`Services.AgentAdminPrompt`, text `FrameLedger.Shared`'s `Safety_AdminMode_*`, version `agent-admin-dialog/1` in its
> corner) whose primary button is enabled only by ticking "I understand…" and whose default button keeps standard rights;
> declined, nothing is written. Either way the row is written and the Agent restarts — asked to stop over the pipe, its
> instance lock waited out, the connection's next round starting it the new way — **except under a running session**,
@@ -1087,7 +1030,7 @@ the requirement was one bullet under §UX rules, and nothing checked it.
| Keys | Does | Where |
|---|---|---|
| **Ctrl+1 … Ctrl+5** (and the numeric keypad's 1–5); **Ctrl+6** since 2026-11-11 (D105) — the Advanced page, only while `AdvancedOption.IsOn`: `ShellShortcuts` refuses it otherwise, so the number stays free | 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`) |
| **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 |
-7
View File
@@ -20,11 +20,6 @@ cmake --preset x64-release
cmake --build --preset x64-release
```
A third preset, **`x64-vs-analysis`** *(2026-11-11)*, builds nothing that ships: it has CMake write a Visual Studio
solution (`build/native/x64-vs-analysis/FrameLedgerNative.slnx`, generator "Visual Studio 18 2026", tests and tools
on) for Qodana's native report, which reads C++ through a solution (`13_CI_CD` §Qodana). It needs Visual Studio 18;
the gate and the release never use it.
Targets:
- `FrameLedger.Overlay` → `FrameLedger.Overlay.dll`
- `FrameLedger.VkLayer` → `FrameLedger.VkLayer.dll` + `VkLayer_FRAMELEDGER_overlay.json`
@@ -409,8 +404,6 @@ Seven self-test cases, both directions; `./tools/notice-check.ps1 -Fix` writes a
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)
14e. **`tools/nvapi-readonly-check.ps1 -SelfTest`, then live** (owner decision D108, 2026-11-11) — every `NvAPI_*` call in `src/native/FrameLedger.NvapiBridge/src/fl_nvapi_bridge.cpp`, the one translation unit that links `nvapi64.lib` into a shipped binary, is on `tools/nvapi-allowed-calls.txt` and every name there is called; a name that sets, saves, restores, deletes, registers, resets, enables, disables or controls something is red **even when the list names it**, and so is one that returns an identifier (D104) — three reads the verb rule would refuse are exempt by name, each with its reason. Comments and string literals are taken out first, so a setter named in the comment that says it is never called is not a call. Seventeen self-test cases, both directions. Text only: it runs with or without the native build. `18_GPU_VENDOR_APIS` §Runtime policy's "never call a setter", which was a sentence until the bridge went from fourteen calls to forty-four
14f. **`tools/overlay-fields-check.ps1 -SelfTest`, then live** (owner decision D116, 2026-11-12) — the same for the code loaded into a game: every member of a vendor's struct the Overlay reads for Advanced metrics is read in ONE header, `src/native/FrameLedger.Overlay/include/fl_adv_fields.h`, through parameters with fixed names, and is on `tools/overlay-allowed-fields.txt`; every name there is read; the parameters are not aliased and `->` reaches nothing but `desc` and the Overlay's own `region`; no other Overlay or Vulkan-layer source reads a listed member; **a camera's position, axes and matrices** (`cameraPos`, `cameraUp`, `cameraRight`, `cameraFwd`, the five matrices, `cameraPinholeOffset`, `cameraPosition`, `cameraForward`) **are named nowhere in those sources and not on the list, whatever the list says**; and neither `sl::Constants` nor `ffxDispatchDescFrameGenerationPrepareV2` is copied by value or measured with `sizeof`. Comments and string literals are taken out first. Nineteen self-test cases, both directions. Text only. It reads names, not types — which struct version carries a member is `17_HOOK_ENGINE` §Which struct version carries which field and ctest `fl_adv_fields`
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
14c. **`tools/buildid-check.ps1 -SelfTest`** (beta.18) — eight cases, both directions: a binary built from a dirty tree (`-dirty`, or the short form's `+`), one with no id, a missing one, and an expected id that is dirty or not an id are red. The live half needs the release's clean-checkout id and runs in `release.yml` over the published tree (§Release-time token substitution)
15. `tools/resx-audit.ps1` — ~~**skipped loudly; it does not exist, and no `.resx` file does either**~~ **built 2026-09-13 (P3 PR-2)**: `-SelfTest` first (11 fixture cases, both directions), then the live pass over every `Strings.resx` family under `src/` — key sets equal across en/vi/ja, `Safety_*` in `ja` marked for review or signed, `Strings.Designer.cs` current with `tools/resx-gen.ps1`. A tree with no family is red (`09_I18N` §Translation workflow)
+7 -187
View File
@@ -124,14 +124,11 @@ FrameLedger uses the **`poli0981/.github` ops repo** where its templates fit, an
read `net10.0`; and for a construct it has not met, a pull request's run is not the evidence — a
`workflow_dispatch` on the branch is, §C# 15 and the analyses.)*
### `qodana.yml` — push to `main`, pull requests into `main`, `workflow_dispatch` · **repo-local, built 2026-11-10 (D93); Qodana for .NET since 2026-11-11 (D99)**
- ~~One job, `qodana`, on `ubuntu-latest` — the only Linux job in this repository, because the linter is a Linux
container~~ Two jobs, on `windows-latest`, each a report of its own: **`native`** (*Qodana (native)*) has CMake
write a Visual Studio solution and reads the C++ of `src/native` with `qodana-native.yaml`'s settings; and
`managed` (*Qodana (managed)*): `JetBrains/qodana-action` (pinned to
`v2026.2.2`'s commit; Dependabot moves the pin) runs **Qodana for .NET** in native mode over `FrameLedger.slnx`
with `qodana.yaml`'s settings, after a `dotnet build`. No job here runs on Linux any more. §Qodana below says what
it reads, what was changed from JetBrains' template and where an inspection is switched off.
### `qodana.yml` — push to `main`, pull requests into `main`, `workflow_dispatch` · **repo-local, built 2026-11-10 (D93)**
- One job, `qodana`, on `ubuntu-latest` — the only Linux job in this repository, because the linter is a Linux
container: `JetBrains/qodana-action` (pinned to `v2026.2.2`'s commit; Dependabot moves the pin) runs Qodana Community
for .NET over `FrameLedger.slnx` with `qodana.yaml`'s settings. §Qodana below says what it reads, what was changed
from JetBrains' template and where an inspection is switched off.
- **Advisory, with a gate of zero problems:** one problem turns the job red; it is not a required context.
- `permissions: contents: read, checks: write, pull-requests: write` — the annotations and the one comment; granted to
the job, the workflow grants none.
@@ -447,7 +444,7 @@ the comment below; the rest are fixed in the same train (beta.24 PR-2).
| `cpp:S935` `FlGetBuildId` returns no value | 1 | **False positive** | `FL_BUILD_ID` is defined by the build (`12_BUILD` §Version); the analysis compiles without it. |
| `cpp:S3519` out-of-bounds `memcpy` | 1 | **False positive** | `fl_patch_check.h` reads the prologue of a function this DLL hooked, under SEH, by design (`17_HOOK_ENGINE` §Unhooking). |
| `cpp:S836` garbage value returned | 1 | **False positive** | `hook-harness`'s `VtableOf` reads the vtable of a COM object it created itself. |
| `csharpsquid:S3869` `DangerousGetHandle` | 1 | **Accept** | `ParentDump` passes the dump file's handle to `MiniDumpWriteDump` inside the `using` that owns the stream, on the same thread, so it cannot be released during the call; CsWin32 generates no `SafeHandle` overload here (`NativeMethods.json`: `useSafeHandles: false`). **Raised again 2026-11-12:** #398 moved that call into `TryWriteOnce` (the dump is now tried three times), and SonarCloud tracks an issue by where it is — the accepted one closed and a new one opened on the same expression, as a blocker on new code. Nothing about the call changed; it is to be accepted again (HANDOFF owner-only item 38 (j)). |
| `csharpsquid:S3869` `DangerousGetHandle` | 1 | **Accept** | `ParentDump` passes the dump file's handle to `MiniDumpWriteDump` inside the `using` that owns the stream, on the same thread, so it cannot be released during the call; CsWin32 generates no `SafeHandle` overload here (`NativeMethods.json`: `useSafeHandles: false`). |
| `cpp:S1669`, `cpp:S6191`, `csharpsquid:S4036`, `githubactions:S7637`, `csharpsquid:S2190`, `S3427`, `S8949` | 35 | **Fixed** in beta.24 PR-2 — 5 of the 23 `S1669` were in the vendored Vulkan headers and leave with the exclusions | — |
**`cpp:S5813`, the 17 accepted, and why each string is terminated** (lines as of beta.24):
@@ -490,184 +487,7 @@ on `src/FrameLedger.Infrastructure/**/*` and `src/FrameLedger.Shared/**/*`, so n
stop reappearing on pull requests. *(Since D68 the `S8417` and `S6640` rows are `SonarQube.Analysis.xml`'s, in the
repository; `S6232`'s are not — a union read outside `LARGE_INTEGER` would be a finding — and its 24 stay marked.)*
## Qodana — `qodana.yml`, a workflow of its own (owner decisions D93, 2026-11-10; D99 and D100, 2026-11-11)
**Since 2026-11-11 the linter is Qodana for .NET, on the Ultimate licence (D99).** The owner took an Ultimate licence for
the Qodana Cloud organisation and asked for Qodana over every language. So the linter is **Qodana for .NET**
(`qodana-dotnet`: Rider's engine) where it was the Community one, in **native mode** on a Windows runner: no container,
the projects built and loaded with the SDK the job installs from `global.json`, and no `EnableWindowsTargeting`.
`qodana.yaml` names the linter and the mode (`withinDocker: false`); nothing is an action argument, so `qodana scan` on
a developer's PC reads the same file. The job is `managed` — *Qodana (managed)* in a pull request's checks: checkout,
`setup-dotnet`, the NuGet cache restored, `dotnet build -c Release` first — so that a build that fails is one red step
with the compiler's own message, not a report of unresolved symbols — then the action, pinned by commit. No MSVC step,
on purpose: it exports `Platform=x64`, which MSBuild reads as a solution platform. The linter's log says what the token
bought: "Qodana license plan: Ultimate", and the Qodana Cloud project it is linked to (`frameledger`). Still advisory,
still a gate of zero, still `main` and its pull requests alone. From here down to *As it was built* is the job as it
is; below that is D93's own account, which is now history.
**Two reports (D99).** Asked how to gather the C# and the C++, the owner chose two reports from the start, and made a
second Qodana Cloud project (`frameledger-cpp`, the `QODANA_TOKEN_NATIVE` secret). The managed report leaves
`src/native` out; the native one (*The native report*, below) reads nothing else, so every file is in exactly one.
**What is read, and by what.**
| What | Read by | |
|---|---|---|
| The C#, XAML and `.resx` of the thirteen projects | `managed` | ReSharper's engine, as under D93 |
| Markdown and XML around the solution | `managed` | the IntelliJ platform's own inspections — 23 and 10 results on the first run |
| JetBrains' security rules over the C# — pattern rules for a process start, an SQL text and the like | `managed` | new with this linter (its OpenGrep plugin) — 36 results on the first run, every one read; the files they were read in are listed in `qodana.yaml`, so a new one is reported |
| The C++ of `src/native` | `native` | ReSharper's C++ engine and the clang-tidy checks it bundles, over a Visual Studio solution CMake writes for it |
| JSON and YAML, the workflows among them | nothing reported | whether the profile inspects them and found nothing, or does not inspect them, was not established; CodeQL's `actions` language reads the workflows |
| PowerShell (`build.ps1`, `tools/`), CMake files, the HLSL shader | no linter of JetBrains' reads them here | SonarCloud reads the PowerShell |
**The first runs on this linter, and what was done (2026-11-11).** Run 42923079119 — the job with no settings beyond the
solution: **3,953 problems** in 92 inspections, and 3,607 of them **hints**: the lowest level an IDE has, which the
editor offers without underlining anything (this linter files them as `TYPO`, Qodana as *Low*). Meziantou's "name the
parameter" 1,084 times, a trailing comma 979, a XAML binding whose `DataContext` the engine cannot know 414, the MVVM
Toolkit's partial-property proposal 224, "invert `if`" 114 — and every other Roslyn analyzer message below the level
this build makes an error. **Hints are off as a severity**, one group in `qodana.yaml` (`severity:TYPO`): the Community
linter never reported them, and D93's rule is about warnings and suggestions. With that, run 42928814104: **347**.
| What | n | Done |
|---|---|---|
| `OverriddenWithSameValue` — a vi or ja value equal to the English one | 271 | off in `.editorconfig` (`[*.resx]`): product and technology names, units and format strings are not translated, and a ja safety string is the English verbatim until a reviewer signs it |
| `csharp_injection_rule-CommandInjection` — a process started with something that is not a literal | 35 | **read, one by one** (below): 11 places in `src`, 24 in tests; one place was hardened. The rule stays on, and the files read are left out of the plugin's inspection by path in `qodana.yaml` (*How the security rules are scoped*, below), so a new file that starts a process is reported |
| `MarkdownIncorrectTableFormatting` | 20 | off in `qodana.yaml`: Rider wants columns padded to one width; these tables are written to be diffed |
| `XmlHighlighting` in `src/FrameLedger.App/app.manifest` | 10 | that file ignored for that inspection: the linter has no schema for a Windows application manifest |
| `UnusedVariable.Compiler` and `RedundantUsingDirective` in `PrimaryDisplay.cs` | 6 | **the linter's own fault**, and the file is left as it is: resolving `PInvoke.EnumDisplaySettings(null, …)` — the `null`-to-`PCWSTR` conversion — the engine of this linter's build (QDNET-262.12299) fails an internal assertion (`IsStandardImplicitConversionFromExpression(conversion.Kind)`, in its `backend.log`), loses the method, and reports its three locals and the file's three usings as unused. The compiler builds the file with warnings as errors, and InspectCode 2026.2.3.1 and 2026.3.0 report nothing in it. Those two inspections are excluded for that one file in `qodana.yaml`, to be removed when a linter build reads it |
| `MarkdownUnresolvedHeaderReference` | 3 | off in `qodana.yaml`: all three resolve on GitHub, whose anchor rule the linter does not follow (`#display-mode--both-tiers-beta10`) |
| `csharp_injection_rule-SQLInjection` | 1 | the same: the one place assigns a constant command text and binds every value as a parameter, as every statement in this repository does; its file is listed with the others |
| `RedundantBoolCompare`, in a test | 1 | fixed — the expression also carried a clause its first half implied |
With those settled, run 42940926340 (2026-11-11, this pull request's branch, the whole solution): **no problem
reported** — the gate's zero, on this linter.
**How the security rules are scoped — by the plugin's one inspection, not by a rule.** Every result of the
OpenGrep plugin's several hundred rules is produced by one inspection, `OpenGrepInspection`; a rule's own id
(`csharp_injection_rule-CommandInjection`) is in the report and is honoured nowhere. Three runs measured it — a
profile entry's `ignore` (42932842462), an `exclude` path under the rule's id (42935752891), `enabled: false`
on the rule (42938295264): all 36 results stood each time, and the linter's log shows why — the plugin hands its
server every rule file whatever the profile says. What the plugin's inspection does honour is a path: an
`exclude` entry named `OpenGrepInspection` (its scopes are in the report's `log/effective.profile.xml`). So the
eleven files of `src` the results were read in, and `tests`, are listed there — and in the run above the
inspection was performed on 943 files, where it had been 1,308, and reported nothing: it is on, and it reads
what is not listed. The price is stated in `qodana.yaml`: a listed file is left out of **all** of the plugin's
rules, not only the one that fired. The plugin is also most of the job's time — about six of its fifteen
minutes.
**A second tripwire, in the gate: `ProcessStartSitesTests`.** Qodana is advisory, and its rule is a pattern for
`Process.Start`. The test sweeps `src` for every way a process is started here — `Process.Start`, a
`ProcessStartInfo`, `CreateProcessWithTokenW` through CsWin32, and the registration of the logon task — and fails
on a file that is not in its list, until that file has been read and listed. `Startup/UnelevatedProcess`, which
the rule never saw, is in it.
**Every place that starts a process, as read on 2026-11-11.** The rule is a pattern, not a data flow: it reports any
`Process.Start` whose argument is not a literal. What matters at each is what is started and where its path and
arguments come from.
| Place | What it starts | Where the path and the arguments come from |
|---|---|---|
| `App/Services/AgentLauncher` | `FrameLedger.Agent.exe` | the file beside the App (`AppContext.BaseDirectory`); arguments the App builds (`--serve`, the data folder) |
| `App/Services/AgentTool` | the same Agent, with one maintenance flag | a constant at each of its two callers (`--install-task`, the Settings page's flags) |
| `Infrastructure/Startup/AgentElevation` | the Agent, elevated (`runas`) | the Agent's own path; `--serve --for-user <this user's SID>` |
| `Infrastructure/Startup/LogonTask` | nothing itself — it registers the logon task, whose action Windows starts at sign-in | the Agent's path and constant arguments (`--serve`), into a Task Scheduler definition for this user, at the lowest privileges |
| `Infrastructure/Diagnostics/CrashDumpWriter` | this process's own executable, as the dumper | `Environment.ProcessPath`; an `ArgumentList`, no shell |
| `Infrastructure/Capture/ProcessLauncher` | the game | the executable the user added and enabled hooking for, and the launch arguments the user wrote for it; no shell |
| `App/Services/ShellStarter` | a game, directly or through its store (`steam://…`, `explorer.exe shell:AppsFolder\<AUMID>`) | the launch `GamePlayer` resolves from the record of a game the user added (D59, D80) |
| `App/Services/Explorer` | `explorer.exe` on a folder or a file | a quoted path of FrameLedger's own: the data folder, the logs, a bug report's zip, the licences folder |
| `App/Services/ShellUrlOpener` | the browser or the mail client | the project's own pages, or a Markdown link `MarkdownLinks` has already held to `http`, `https` and `mailto`. **Hardened here**: the opener now refuses any other scheme itself (`ShellUrlOpenerTests`) — the shell runs whatever it is handed, and a `file:` address is a program |
| `App/ViewModels/SettingsViewModel` | the browser | one constant address |
| `Infrastructure/Startup/UnelevatedProcess` | the Agent or a game with the shell's token, from an elevated process (`CreateProcessWithTokenW`) | its two callers above, `AgentLauncher` and `ProcessLauncher` — not a `Process.Start`, so the rule did not see it; the sweep does |
None takes a value from outside the PC or from a file FrameLedger did not write, except the game's own path and
arguments — which starting the game the user chose is.
**The native report — `qodana-native.yaml`, the job `native` (D99, 2026-11-11).** The C++ of `src/native`, read by
the same linter — Qodana for .NET, whose C++ is ReSharper C++ — in native mode on a Windows runner. It is the only
linter of JetBrains' that can: the native layer is MSVC-only, and the two C/C++ linters (`qodana-cpp`,
`qodana-clang`) are Linux images. It reads C++ through a Visual Studio solution, and `src/native` is a CMake tree, so
the job has CMake write one first: the preset **`x64-vs-analysis`** (generator "Visual Studio 18 2026", tests and
tools on) puts `FrameLedgerNative.slnx` under `build/native/x64-vs-analysis`, and the job builds from it the one
target whose output is a header (`fl_ac_floor_gen`, the blocklist floor). Nothing else is compiled, and nothing from
that tree ships. Then the action, with `--config qodana-native.yaml`: the solution, `RelWithDebInfo` and `x64` — the
flags the shipped binaries are built with — and, left out by path, what is not FrameLedger's code (the build tree,
`third_party`, the vendor stubs, a compiled shader as a byte array). Its own results folder, cache keys and artifact
(`qodana-report-native`), and the Qodana Cloud project `frameledger-cpp` through `QODANA_TOKEN_NATIVE`. It posts no
comment and no annotations — a second job of the same linter would overwrite the managed job's — so its result is the
job's own status and its report. Advisory, and a gate of zero, like the other.
**What it runs** is ReSharper's C++ inspections and, through them, the clang-tidy checks and clang diagnostics that
engine bundles. clang never builds this code — MSVC does, with `/W4 /WX` — so what clang says is read as advice. Every
one of them has a key in `.editorconfig` (`resharper_cpp_…_highlighting`; a clang-tidy check's is
`resharper_cpp_clang_tidy_<check>_highlighting`), so D100's rule holds without a second file: no `.clang-tidy`.
**Its first runs, and what was done.** Run 42923079119: **4,695 problems**, 4,040 of them hints, which are off as on
the managed side. Run 42928814104: **655** — **494 distinct**, because a source file compiled into three targets is
reported three times.
| What | distinct | Done |
|---|---|---|
| A choice this code made, off for the native tree: where the compiler pads a struct (46); MSVC's own keywords, `__try` among them (54); a function pointer got by name cast to its real type, through `void*` (55); `reinterpret_cast` where memory is read as something else (5); `std::cmp_less` proposed for comparisons that already cast (20); a `default:` under a full enum switch (3); a copied verdict (4); the moves of a type that owns a handle (11); a zeroed out-parameter enum (8); an enum's width (5); "can be made const / constexpr / static" (52); "possibly unused `#include`" (15) | 278 | off in `.editorconfig`, each with its reason. Of the fifteen includes two were unused and were removed; the others are a file including what it uses although another header already brings it |
| A newer idiom proposed for working code — a range-for, `std::ranges`, `any_of`, `starts_with`, a raw string, an `if` with an initialiser | 53 | off: the native code is written to be read beside the hook path, an index and a plain loop |
| **The engine misreading**: `std::atomic_ref<T>::fetch_or` as an expression without side effects (7); a Win32, D3D12 or ffx-api structure zero-initialised and then filled field by field as "always rewritten" and "assigned, never used" (15); a test of a `constexpr` function as a redundant argument (3) | 25 | off, with what the engine gets wrong written beside the keys |
| Fields nothing names, in a structure Windows defines and the SDK's headers do not give (`RTL_PROCESS_MODULE_INFORMATION`, `PROCESS_MEMORY_COUNTERS_EX2`) and in a test's stand-in for a Vulkan object | 25 | off for those four files: the fields are what puts the others at their offsets |
| `%lu` with an `NvU32`, in `fl-probe-nvapi` | 19 | off for that file: NVAPI's header makes `NvU32` an `unsigned int` under clang and an `unsigned long` under MSVC — the linter's compiler, not the build's |
| The probes, the harness and the tests: an unchecked `printf` (35), `atoi` on the harness's own arguments (20), a `&pointer` handed to a `void*` parameter (7), a printf-shaped helper (4), a fake handle built from a number (4), a test's fixtures (4), `layout_test`'s run-time checks of compile-time facts (3), a macro that pastes a name (1) | 78 | off for `tools` and `tests` |
| Code loaded into a game (below) | 7 | kept as it is, off for those files; one of them is dead code, recorded for the owner |
| **Fixed**: `sizeof(a) / sizeof(a[0])` → `std::size(a)` (4); a multiplication done in a narrower type than the one it is stored in or compared with (2: a constant in the guard's sources, a test); a member function, and a type alias, nothing used (3) | 9 | in the code; none changes what a shipped binary does |
With those settled, run 42942068024 — the first with these settings — reported **one** problem: `LogNoteW`, now by
ReSharper's own inspection where clang's had said it before (below). And run 42943094415 (2026-11-11, this pull
request's branch): **no problem reported** — the gate's zero, in the native report too.
**Code loaded into a game — the Overlay, the Vulkan layer, the shared-memory headers, the guard's rule matcher.**
D100: there only a defect is fixed, in a pull request of its own with the hook's overhead measured (rule 5,
`14_TESTING` §Hook overhead), and a proposal about style is not acted on. About a quarter of the 655 results were in
those files; nearly all of them are the tree-wide kinds above. **The report found no defect there.** What is
particular to them, read and kept: two `if` chains whose arms have the same body and are different cases, each with
its comment (`dllmain.cpp`); MinHook's `MH_ALL_HOOKS`, which is `NULL` by its header; a retired enumerator kept so
that its bit is not reused; `slSetTag`, deprecated by a header whose replacement no measured module exports;
`ResolveTolerance` clearing its out-parameter with `memset`, as `ResetRules` does — a `Tolerance` is flags whose
default initialisers are zero. And one thing that is not as it should be: **`LogNoteW` in `dllmain.cpp`, which nothing
calls** — dead code. It is not a defect, so D100 leaves its removal to the owner (HANDOFF); until then that one file
is not read for an unused function (`.editorconfig` says so, in a section to be removed with it).
**"Zero" has to mean "analysed".** A report with no problem cannot tell a clean tree from one the linter did not
read. So the settings were proved on a branch that puts back three of the things fixed here — the unused alias, the
unused member function, the narrow multiplication. Run 42942390715 reported exactly those three, each by the
inspection that had found it the first time (`CppTypeAliasNeverUsed` in `tools/fl-probe-interposer/main.cpp`;
`clang-diagnostic-unused-member-function` and `bugprone-implicit-widening-of-multiplication-result` in
`tests/ring_test.cpp`), and `LogNoteW`, and nothing else. The branch was deleted. Do the same before trusting a
zero after a change to the preset, the settings or the linter's version.
**What it does not read.** CMake files and PowerShell have no inspection in this linter (SonarCloud reads the
PowerShell); the HLSL shader and the `.def` file are not C++. CodeQL (`analyze (cpp, manual)`, a required check) and
SonarCloud go on reading the C++ as before: this is a third reader, and the only one of the three that is ReSharper's.
**Where an inspection is switched off: by the engine that raised it (D100, amending D93's "never in `qodana.yaml`").**
What Qodana reports is fixed, unless the inspection argues with a choice this project made; then it is off, with the
reason on the line above — in the place the engine that raised it reads:
- **ReSharper's** — the C#, the XAML, the `.resx`, and the C++ of the native report with the clang-tidy checks it
runs — in **`.editorconfig`** (`resharper_*_highlighting`), where Rider and ReSharper in the editor read it too:
sixty-four keys for the managed code, fifty-four lines for the C++, some of them for a folder or a file alone.
- **What has no key there** — in **`qodana.yaml`**: a whole severity (the hints) and the IntelliJ platform's Markdown
and XML inspections under `profile.inspections`; under `exclude`, by inspection and path, the files JetBrains'
security rules were read in and a file the linter itself fails on.
- **What is not FrameLedger's code** is left out by path (`exclude`): `SonarQube.Analysis.xml`'s list, for its reasons.
**What it does not use, and what happens if the licence lapses.** Quick-fixes (the linter would push commits — the job
has no `contents: write`, and a change nobody read is not wanted), code coverage in Qodana (the gate's coverage and
SonarCloud's already read the same reports) and FlexInspect are Ultimate features this job leaves alone. Without a
valid licence the linter does not start, so the job is red — advisory, never a blocked merge; the way back is
`linter: qodana-cdnet` with the job on `ubuntu-latest`, as it ran until beta.37.
**Running it on a developer's PC.** `qodana scan` in the repository root reads `qodana.yaml`, downloads the linter and
needs the project's token in `QODANA_TOKEN` — the Ultimate linter checks the licence. Without a token, InspectCode
still gives ReSharper's part (*As it was built*, below), with `--toolset-path` at the 11.0 SDK's `MSBuild.dll`; the
Markdown, XML and security results are the Rider linter's alone.
**As it was built — the Community linter, 2026-11-10 to beta.37 (D93).** Kept as written; where it says *is*, read *was*.
## Qodana — `qodana.yml`, a workflow of its own (owner decision D93, 2026-11-10)
**D93 — Qodana reads the C# and the XAML from CI.** The owner made the project on Qodana Cloud, set the `QODANA_TOKEN`
secret (2026-11-10) and asked for Qodana in CI from the workflow JetBrains gives, changed where it had to be, with what
+2 -2
View File
@@ -28,7 +28,7 @@ The anti-cheat guard is the one component where a bug can cost someone an accoun
- **Ring buffer:** SPSC correctness under a hammering writer thread; seqlock torn-read detection; wrap and overwrite-oldest semantics; power-of-two capacity assumptions. Include the **one-full-lap case**: a reader stalled exactly `capacity` records must not validate a different frame as unchanged (this is what the never-reset `seq` counter defends, `07_IPC` §Protocol rules).
- **Drop accounting:** the reader-side computation (`writeIndex - readIndex > capacity`) reports the right count and resumes at the right index. The writer has no drop counter to test — by design.
- **Torn records produce gap markers,** not silently shortened streams; a golden test asserts the gap does not appear as a stutter.
- **Record and header layout:** `static_assert(sizeof(...) == 64)` and `offsetof` assertions for `FlFrameRecord` **and all ~~three~~ ~~four~~ five header structs** *(five since layout 5, 2026-11-11: `FlAdvancedState`, 1472 bytes; what reads and writes it is tested at four levels since 0.1.0-beta.40 — `fl_adv_fields` the Overlay's header alone, `fl_guard` `[advanced]` the injected Overlay with the word off and on, `InGameAdvancedSamplerTests` / `CaptureSessionTests` / `SessionRecorderTests` what the Agent makes of a publication, and `AgentEndToEndTests.WhatTheGameTellsFsrIsStoredOnlyByASessionThatRecordsAdvancedMetrics` the shipped Agent, the real Overlay and the harness: two sessions of one target, the first storing nothing of it)* (`FlShmHandshake`, `FlWriterState`, `FlControlBlock`, and `FlDisplayState` since layout 4, beta.10) — plus D33's `FlTolerance`, mirrored the same way *(corrected 2026-10-04)* — the Agent reads across the process boundary in every one of them. Both halves exist as of 2026-08-05: the native side is `layout_test.cpp` plus the `static_assert`s (ctest `fl_shm_layout`), and the runtime offset dump from `tools/fl-layout-dump` is consumed by `ShmLayoutMirrorTests`, which walks the field list in **both directions** and additionally asserts blittability — `Marshal.SizeOf` and every offset stay correct for a mirror that uses `[MarshalAs(ByValTStr)] string`, while `Unsafe.SizeOf` drops from 64 to 40 and the struct can no longer be read from a mapped view.
- **Record and header layout:** `static_assert(sizeof(...) == 64)` and `offsetof` assertions for `FlFrameRecord` **and all ~~three~~ four header structs** (`FlShmHandshake`, `FlWriterState`, `FlControlBlock`, and `FlDisplayState` since layout 4, beta.10) — plus D33's `FlTolerance`, mirrored the same way *(corrected 2026-10-04)* — the Agent reads across the process boundary in every one of them. Both halves exist as of 2026-08-05: the native side is `layout_test.cpp` plus the `static_assert`s (ctest `fl_shm_layout`), and the runtime offset dump from `tools/fl-layout-dump` is consumed by `ShmLayoutMirrorTests`, which walks the field list in **both directions** and additionally asserts blittability — `Marshal.SizeOf` and every offset stay correct for a mirror that uses `[MarshalAs(ByValTStr)] string`, while `Unsafe.SizeOf` drops from 64 to 40 and the struct can no longer be read from a mapped view.
- **Fault policy:** injected SEH faults in a fake hook body → counter increments, original still called, self-disable at 3.
- **Hook index verification, by behaviour.** A vtable slot carries no identity, so "check that slot 8 *is* `Present`" is not a question the runtime can answer — the earlier wording here required something unimplementable. What is answerable: patch the slot, call the method, see whether the detour ran (`17_HOOK_ENGINE` §Getting vtable addresses; proved for slots 8, 13 and 22 in `spike-notes.md` §H4). Runs headless on CI via WARP and `CreateSwapChainForComposition`. A deliberate mismatch aborts installation instead of patching.
- **Every probe must be shown to fail.** A probe that ends in an unconditional assertion is green by construction and its ctest is decorative — `fl_proxy_swapchain` shipped in exactly that state. Before a probe counts as a regression net, break the thing it watches and watch it go red.
@@ -145,7 +145,7 @@ own work item on the STA thread and puts back — and with the keys a parameter,
## Hook overhead measurement (NFR-1, per release)
1. `hook-harness` in a fixed workload, present-rate uncapped: 3 runs hooked vs 3 unhooked → mean present-call cost delta must be ≤ 1 µs (measured with QPC around the call site in an instrumented harness build).
2. Real game, fixed 10-minute scene, capture ON vs OFF, 3 runs each: **game's own Avg FPS delta ≤ 0.5%**, Agent CPU ~~≤ 1%~~ ≤ 2.5 % of a core *(NFR-2 as D117 amended it, 2026-11-11; `tools/agent-cost.ps1` measures the unhooked half without a game)*, Agent RSS ≤ 150 MB, Overlay resident ≤ 8 MB.
2. Real game, fixed 10-minute scene, capture ON vs OFF, 3 runs each: **game's own Avg FPS delta ≤ 0.5%**, Agent CPU ≤ 1% of a core, Agent RSS ≤ 150 MB, Overlay resident ≤ 8 MB.
> **NOT MEASURED. The runbook exists as of 2026-09-10 (P2 PR-G); the run is the owner's.**
> `tools/fps-impact-runbook.ps1` sequences the six launches, holds consent granted for the ON leg and
+5 -56
View File
@@ -194,11 +194,11 @@ 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`; 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. **Since 0.1.0-beta.40 (Advanced metrics train B, D111), and only while the Agent asks** (`FlControlBlock.advancedRequested`): the `sl::DLSSOptions` a title chains into `inputs` — the struct the quality mode is read from — is read further: `outputWidth`/`outputHeight`, `preExposure`, `exposureScale`, `colorBuffersHDR`, the five presets of version 1, and where the struct's own `structVersion` proves them present `ultraQualityPreset` and `useAutoExposure` (≥ 2) and `alphaUpscalingEnabled` (≥ 3) — §Which struct version carries which field. Rule 4: more members of the same argument of the same call; `fl_adv_fields.h` is the one place, `tools/overlay-fields-check.ps1` holds it. No new patch site. **Measured** (the header's own functions, `/O2 /guard:cf /Qspectre /MT`, 20 M calls × 3): +9.5–11.7 ns per evaluation that chains the options while asked; with the word at 0, one relaxed load and a branch not taken — below what the bench resolves. Most titles set these through `slDLSSSetOptions`, which is not an export, and read N/A (train D) |
| ✅ 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. **Since 0.1.0-beta.40 (Advanced metrics train B, D111), and only while the Agent asks:** the UPSCALE arm reads the rest of `ffxDispatchDescUpscale` — `enableSharpening`, `sharpness`, `jitterOffset`, `preExposure`, `cameraNear`, `cameraFar`, `cameraFovAngleVertical`, `flags`, `reset`, `frameTimeDelta` — into process-local summaries (an "ever seen" mask, a largest magnitude, a lowest and highest, a count and a sum; one module's dispatches are counted, so a dispatch that reaches the loader and a leaf is one). Never on the FSR 3.0 host's legacy descriptor, which is vouched for through `renderSize` and no further; never a PREPARE descriptor's camera arrays (`tools/overlay-fields-check.ps1` refuses their names anywhere in the Overlay). `cameraNear`/`cameraFar`/`cameraFovAngleVertical` are the depth range and the field of view, not where the camera is; the field of view is kept as a session's range, never a series (D114). **Measured** (as the row above): +22–23 ns per UPSCALE dispatch, i.e. per application frame, while asked; ≤ 0.7 ns, inside the bench's noise, with the word at 0 |
| ✅ **FidelityFX ffx-api: `ffxQuery` on the same four modules** (beta.25, owner decision D65) — `amd_fidelityfx_dx12.dll`, `amd_fidelityfx_upscaler_dx12.dll`, `amd_fidelityfx_framegeneration_dx12.dll`, `amd_fidelityfx_loader_dx12.dll` | **Built 2026-10-19.** The mode an FSR title runs at reaches the vendor only as an argument of `ffxQuery` — "what render size (`…GETRENDERRESOLUTIONFROMQUALITYMODE`, `0x00010003`) or ratio (`…GETUPSCALERATIOFROMQUALITYMODE`, `0x00010002`) does this mode give at this display size?" — asked before the title sizes its targets; the per-frame dispatch carries the size alone. The detour calls the original FIRST, exactly once, and only when it returned `FFX_API_RETURN_OK` reads the descriptor's type, display size and mode and the values the vendor wrote through the title's own out pointers, into a five-slot table (one per `FfxApiUpscaleQualityMode`); the `ffxDispatch` UPSCALE arm names the ONE mode whose kept answer fits the dispatched `renderSize` (and `upscaleSize`, where stated) as `0x10 + mode` in `upscalerQuality`, else `0xFF` (`03_METRICS` §Upscaling). **Rule 4:** the arguments of the API we hooked — the descriptor the title passed and the out values of that same call — never `context`, a resource or anything the title did not hand the hooked export; nothing of the title's is written, and every read is under the hook's SEH guard. Both query layouts and type ids are pinned to literals by `static_assert`s, identical at SDK v1.1.4 and v2.3.0. **Its own family**, `FL_HOOK_UPSCALER_QUALITY` (bit 11 of `hooksInstalledMask`, mirrored in `FlHookFamily` and `HookFamilies`): `InstallByFamily` binds a row by equality, and the query entitles no measured field by itself — the byte rides under `FL_MEASURED_UPSCALER_PARAMS` from the dispatch arm — so the bit says only that the query was hooked, which tells "never asked" from "could not have seen it ask". Published like the dispatch family, once every loaded leaf is patched (`PublishFfxQueryFamilyIfWhole`); the FSR 3.0 host has no `ffxQuery` and no row (`static_assert`). A loader that passes a query on to a leaf's export refreshes one kept answer twice; nothing is counted, so nothing is counted twice. **Measured overhead** (a copy of the two bodies, `/O2 /guard:cf /Qspectre /MT`, 20 M calls × 3 runs, every slot holding both a size and a ratio — the worst case): 7.6–8.2 ns added per UPSCALE dispatch, i.e. per application frame, and 1.6 ns per query beside the trampoline; the per-present path gains one load. Harness: `--ffx-query sizes|ratios`; `fl_guard` "FSR's quality mode". **Since 0.1.0-beta.40 (Advanced metrics train B, D111), and only while the Agent asks:** when the query the vendor answered OK is the upscaler's memory — `FFX_API_QUERY_DESC_TYPE_UPSCALE_GPU_MEMORY_USAGE` (`0x00010008`, ffx-api 1.1.2) or `…_V2` (`0x00010009`, 2.0) — the `FfxApiEffectMemoryUsage` it wrote through the title's own out-pointer is kept (total and aliasable bytes), one module's queries counted. Only a title that asks is answered: FrameLedger never calls `ffxQuery` itself. The frame-generation memory queries (`0x00020007`, `0x0002000b`) are not read. +4.3–6.1 ns per such query while asked. Harness: `--ffx-memory-query v1|v2`; `fl_guard` "region 5 stays empty until the Agent asks". |
| ✅ **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 |
| ✅ **FidelityFX ffx-api: `ffxQuery` on the same four modules** (beta.25, owner decision D65) — `amd_fidelityfx_dx12.dll`, `amd_fidelityfx_upscaler_dx12.dll`, `amd_fidelityfx_framegeneration_dx12.dll`, `amd_fidelityfx_loader_dx12.dll` | **Built 2026-10-19.** The mode an FSR title runs at reaches the vendor only as an argument of `ffxQuery` — "what render size (`…GETRENDERRESOLUTIONFROMQUALITYMODE`, `0x00010003`) or ratio (`…GETUPSCALERATIOFROMQUALITYMODE`, `0x00010002`) does this mode give at this display size?" — asked before the title sizes its targets; the per-frame dispatch carries the size alone. The detour calls the original FIRST, exactly once, and only when it returned `FFX_API_RETURN_OK` reads the descriptor's type, display size and mode and the values the vendor wrote through the title's own out pointers, into a five-slot table (one per `FfxApiUpscaleQualityMode`); the `ffxDispatch` UPSCALE arm names the ONE mode whose kept answer fits the dispatched `renderSize` (and `upscaleSize`, where stated) as `0x10 + mode` in `upscalerQuality`, else `0xFF` (`03_METRICS` §Upscaling). **Rule 4:** the arguments of the API we hooked — the descriptor the title passed and the out values of that same call — never `context`, a resource or anything the title did not hand the hooked export; nothing of the title's is written, and every read is under the hook's SEH guard. Both query layouts and type ids are pinned to literals by `static_assert`s, identical at SDK v1.1.4 and v2.3.0. **Its own family**, `FL_HOOK_UPSCALER_QUALITY` (bit 11 of `hooksInstalledMask`, mirrored in `FlHookFamily` and `HookFamilies`): `InstallByFamily` binds a row by equality, and the query entitles no measured field by itself — the byte rides under `FL_MEASURED_UPSCALER_PARAMS` from the dispatch arm — so the bit says only that the query was hooked, which tells "never asked" from "could not have seen it ask". Published like the dispatch family, once every loaded leaf is patched (`PublishFfxQueryFamilyIfWhole`); the FSR 3.0 host has no `ffxQuery` and no row (`static_assert`). A loader that passes a query on to a leaf's export refreshes one kept answer twice; nothing is counted, so nothing is counted twice. **Measured overhead** (a copy of the two bodies, `/O2 /guard:cf /Qspectre /MT`, 20 M calls × 3 runs, every slot holding both a size and a ratio — the worst case): 7.6–8.2 ns added per UPSCALE dispatch, i.e. per application frame, and 1.6 ns per query beside the trampoline; the per-present path gains one load. Harness: `--ffx-query sizes|ratios`; `fl_guard` "FSR's quality mode". |
| ~~XeSS: `xessD3D12CreateContext`, `xessD3D12Init`, `xessD3D12Execute`~~ **Closed at the census by licence, 2026-09-04** (`20_OPEN_QUESTIONS` §Scope decisions, `18_GPU_VENDOR_APIS` §Intel XeSS SDK): no hook on any `libxess*.dll` export *(corrected 2026-10-04)* | ~~`outputResolution`, `qualitySetting`, XeSS version; `xess_fg` variants for XeFG~~ |
| ✅ **Application frames per present** (`fgEvaluations`) — **`sl.interposer.dll!slGetNewFrameToken` since 2026-09-03** | Native vs Displayed frame counts at Tier 1 — see `03_METRICS` §Frame Generation. **The producer is the frame-token export**: Streamline hands a title one token per application frame and the title must ask; the detour counts distinct tokens between two presents (pointer changes, nothing dereferenced), `FL_HOOK_FG_EVALUATIONS` is its family, and it installs on every Streamline 2 title including the ones that evaluate nothing through `slEvaluateFeature`. Rule 4: the out-parameter of an API we hooked. Premise and its gate in `03_METRICS`; pre-committed table in `20_OPEN_QUESTIONS` §S31. *The row as it stood before:* ~~NGX/SL/FFX/XeSS FG feature evaluations per present. **Built 2026-08-15 for Streamline, and MEASURED TO YIELD NOTHING ON THAT ROUTE**~~ — `slEvaluateFeature(kFeatureDLSS_G)` is never called by Cyberpunk 2077 (0 across ~14,000 batches, four FG settings), so this row installs, is honest, and counts zero; see `docs/HANDOFF.md` item 3. Built on the detour that was already there: `kFeatureDLSS_G` contributes to a saturating COUNT in the same word the feature bits live in (`fl_sl_seen.h`) rather than to a bit, because a bit collapses several evaluations between two presents into one — and under multi-frame generation that is the common case, not the edge. The row's family is therefore compound (`FL_HOOK_UPSCALER_IDENTITY \| FL_HOOK_FG_EVALUATIONS`), pinned by a `static_assert` because `hookinventory-check` reads that column as an opaque identifier. **Counts EVALUATIONS, not generated frames** — the 2026-08-14 owner ruling; the multiplier lives in `sl::DLSSGOptions`, which is only reachable by the route §2b refused. ~~Non-NVIDIA FG vendors are **deferred with a written rationale**: `amd_fidelityfx_framegeneration_dx12.dll` 3.1.5 exports only the five generic `ffx*` entry points, identical to five sibling modules, so identity is in the arguments and we have no headers~~ — **AMD has a producer since 2026-09-04** (the FidelityFX row above: the PREPARE dispatch's `frameID`, or the UPSCALE count on a title that never prepares, feeds `fgEvaluations` when Streamline has never issued a token); Intel stays at the census (`20_OPEN_QUESTIONS` §Scope decisions, by licence); the FSR 3.0 host DLL's UPSCALE (`ffxFsr3ContextDispatchUpscale`, since 2026-09-05) counts like an ffx-api UPSCALE when neither Streamline nor a PREPARE has spoken |
@@ -300,57 +300,6 @@ So:
> **`third_party/streamline/README.md` asserted this pass existed for five days
> before it did**, which is why it is described here rather than only there.
### Which struct version carries which field (owner decision D115, 2026-11-11)
**A field of a vendor struct is read only where it is proven to be there.** A game hands a hook a struct of the
version it was built against; a member a later version added lies past the end of what an older game allocated, and
reading it is reading game memory outside the argument (rule 4) — not merely a wrong value. So every read of a tail
member is gated on the struct's own version, and the gate comes from this table, not from the one header in the tree
— which declares only the newest shape, and for `sl::DLSSOptions` says nothing about which version added what.
Established 2026-11-11 from the upstream tags, through GitHub's API: each tag's header was fetched by blob and the
struct's declarations — type, name and order — compared across tags. The members' own types were checked at the
oldest and the newest tag (`enum Boolean : char`, `enum class DLSSMode : uint32_t`, `enum class DLSSPreset :
uint32_t`, `float2`/`float3`/`float4x4`; no `#pragma pack` in either).
**Streamline** (`NVIDIA-RTX/Streamline`; tags v2.0.0, v2.1.0, v2.2.0, v2.4.0, v2.4.15, v2.7.2, v2.7.30, v2.7.32,
v2.8.0, v2.9.0, v2.10.0, v2.10.3, v2.11.1, v2.12.0, v2.14.1, v2.14.16):
| Struct | `structVersion` | First tag (blob of the header) | Members that version adds, in order |
|---|---|---|---|
| `sl::DLSSOptions` (`include/sl_dlss.h`) | 1 | v2.0.0 (`7de7411e507d`) | `mode`, `outputWidth`, `outputHeight`, `sharpness`, `preExposure`, `exposureScale`, `colorBuffersHDR`, `indicatorInvertAxisX`, `indicatorInvertAxisY`, `dlaaPreset`, `qualityPreset`, `balancedPreset`, `performancePreset`, `ultraPerformancePreset` |
| | 2 | v2.1.0 (`60882f60e6f4`) | `ultraQualityPreset`, `useAutoExposure` |
| | 3 | v2.4.0 (`27d352db364f`) | `alphaUpscalingEnabled` |
| `sl::Constants` (`include/sl_consts.h`) | 1 | v2.0.0 (`db6f37adcf66`) | every member through `motionVectorsJittered` — the matrices, `jitterOffset`, `mvecScale`, `cameraPinholeOffset`, the camera's position and axes, `cameraNear`, `cameraFar`, `cameraFOV`, `cameraAspectRatio`, `motionVectorsInvalidValue`, the seven `Boolean`s |
| | 2 | v2.4.0 (`bba15338a623`) | `minRelativeLinearDepthObjectSeparation` |
`sl::DLSSOptions` keeps those seventeen declarations, same types and order, through v2.14.16 (`9a875bd4f843`); v2.8.0
only re-spelled the deprecated `sharpness`. `sl::Constants` is unchanged from v2.4.0 through v2.14.16
(`15589e577df9`). Streamline 1.x is refused before any read (`SpeaksStreamline2`).
**FidelityFX** (`GPUOpen-LibrariesAndSDKs/FidelityFX-SDK`; tags v1.1.0 — FSR 3.1.0, the first ffx-api — v1.1.1,
v1.1.2, v1.1.3, v1.1.4, v2.0.0, v2.1.0, v2.2.0, v2.3.0, v2.4.0). The descriptor header carries a `type` and no size
or version, so the question is whether the declaration ever changed:
| Struct | Tags | Result |
|---|---|---|
| `ffxDispatchDescUpscale` | v1.1.0 (`68860479bb94`) … v2.4.0 (`9d4a3e5f6c60`) | **one declaration in all ten**: twenty-three members, `flags` the last |
| `ffxConfigureDescFrameGeneration` | v1.1.0 (`0ecdd4b4e59b`) … v2.4.0 (`823a3b4720f1`) | **one declaration in all ten**: thirteen members |
| `FfxApiResource`, `FfxApiResourceDescription`, `FfxApiFloatCoords2D`, `FfxApiDimensions2D`, `FfxApiRect2D` | v1.1.0 … v2.4.0 | one declaration each in all ten |
| `ffxQueryDescUpscaleGetGPUMemoryUsage` (`0x00010008`), `FfxApiEffectMemoryUsage` | from v1.1.2 | one declaration since; a game that sends the type knows the struct |
| `ffxQueryDescUpscaleGetGPUMemoryUsageV2` (`0x00010009`) | from v2.0.0 | one declaration since |
**What follows for a hook** (Advanced metrics, train B):
- `sl::DLSSOptions`: a member is read at `structVersion >=` the row that adds it — never "at least 1" for the tail.
- `sl::Constants`: everything this project may read is version 1's. The camera's position, axes and matrices are
never read at any version (rule 4; the catalog's `PlayerState`).
- `ffxDispatchDescUpscale`, `ffxConfigureDescFrameGeneration`: every member may be read on the ffx-api route, since
no ffx-api release has a shorter one. `ffxDispatchDescFrameGenerationPrepareV2`'s camera arrays are never read.
- **Not established, so nothing more is read there**: the FSR 3.0 host's legacy descriptors (`fsr3-v3.0.x`) beyond
the `renderSize` the existing hook pins; any struct of a Streamline or FidelityFX release newer than the last tag
above — a re-vendoring re-runs this comparison (`third_party/*/README.md` §Checklist).
### Ray tracing
| Hook | Yields |
|---|---|
@@ -622,7 +571,7 @@ Field notes — each of these was a defect in an earlier revision:
- **SPSC lock-free ring**, capacity a power of two (default 8192 records = 512 KB), overwrite-oldest.
- Writer/reader seqlock protocol, including the rule that the payload write must
**exclude** the `seq` field and that `seq` is never reset: `07_IPC` §Protocol rules.
- Header: ~~three~~ **four** separate 64-byte lines before the ring — and, since layout 5 (2026-11-11), region 5's twenty-three, which the watchdog alone writes and only while the Agent asks (`07_IPC` §Region 5) — *(corrected 2026-10-04: since layout 4, 2026-09-27,
- Header: ~~three~~ **four** separate 64-byte lines before the ring *(corrected 2026-10-04: since layout 4, 2026-09-27,
beta.10, `FlDisplayState` at 0xC0 — Overlay-written at most every 500 ms; the ring starts at 0x100)* — `FlShmHandshake` (write-once),
`FlWriterState` (Overlay-written: `writeIndex`, `status`, `apiMask`, `faultCount`),
and `FlControlBlock` (**Agent**-written: `pauseRequested`, `unhookRequested`,
@@ -804,7 +753,7 @@ verification a dev-machine-only affair before:
- **WARP** (`D3D_DRIVER_TYPE_WARP`) — a software rasteriser, so no adapter is required.
- **`CreateSwapChainForComposition`** — no `HWND`, so no dependency on a window station or an interactive session.
Current modes: `--probe-vtable` (§H4, ctest `fl_vtable_indices`), `--probe-proxy` (§H5, ctest `fl_proxy_swapchain`), `--probe-unhook` (§H7, ctest `fl_unhook_preserves_foreign`), `--probe-cost` (NFR-1, measurement only), **`--probe-frames`** (ctest `fl_frame_identity` — what counts as a frame, against `GetLastPresentCount`), **`--probe-d3d12`** (ctest `fl_d3d12_acquisition` — device → command queue → swapchain), `--present N`, `--hold N`, **`--real`** and **`--plus-ui K``**, **`--vulkan --hold-presenting N`** (P1 item 3, real loader, exit 77 = cannot run here) and **`--opengl --hold-presenting N`** (P1 item 4, gdi32 `SwapBuffers` on a hidden window, Microsoft's generic renderer — runs on CI). *(Added 2026-10-04, each with its own ctest: `--probe-d3d12-vtable`, `--probe-dxr`, `--probe-dxr-inputs`, `--probe-upscaler-resolve`, `--probe-sl-abi`, `--probe-ffx-resolve`, `--probe-sl-inputs`, `--probe-sl-seen`, `--probe-dxgi-count`; and the `--hold-presenting-*` injection fixtures with `--load` / `--load-after-ms`.)* *(Added 2026-11-12, Advanced metrics train B: `--probe-adv-fields`, ctest `fl_adv_fields` — `fl_adv_fields.h` alone: a struct of a lower version is not read past its end, the vendors' sentinels never leave as values, the summaries, the publication, a new request starting afresh; and `--advanced` / `--ffx-memory-query v1|v2`, which make the `--hold-presenting-upscaled` and `--hold-presenting-ffx` fixtures send what Advanced metrics reads.)*
Current modes: `--probe-vtable` (§H4, ctest `fl_vtable_indices`), `--probe-proxy` (§H5, ctest `fl_proxy_swapchain`), `--probe-unhook` (§H7, ctest `fl_unhook_preserves_foreign`), `--probe-cost` (NFR-1, measurement only), **`--probe-frames`** (ctest `fl_frame_identity` — what counts as a frame, against `GetLastPresentCount`), **`--probe-d3d12`** (ctest `fl_d3d12_acquisition` — device → command queue → swapchain), `--present N`, `--hold N`, **`--real`** and **`--plus-ui K``**, **`--vulkan --hold-presenting N`** (P1 item 3, real loader, exit 77 = cannot run here) and **`--opengl --hold-presenting N`** (P1 item 4, gdi32 `SwapBuffers` on a hidden window, Microsoft's generic renderer — runs on CI). *(Added 2026-10-04, each with its own ctest: `--probe-d3d12-vtable`, `--probe-dxr`, `--probe-dxr-inputs`, `--probe-upscaler-resolve`, `--probe-sl-abi`, `--probe-ffx-resolve`, `--probe-sl-inputs`, `--probe-sl-seen`, `--probe-dxgi-count`; and the `--hold-presenting-*` injection fixtures with `--load` / `--load-after-ms`.)*
> **Every present here used to carry `DXGI_PRESENT_TEST`, which submits nothing.** Measured: 500 of them leave `GetLastPresentCount` at 0 while 37 real presents move it by 37. "N presents → N records" was therefore satisfiable only by a writer counting non-frames. `--real` issues real presents; the test-present path is kept as a named mode because it is what an alt-tabbed title actually runs.
+2 -523
View File
@@ -145,7 +145,7 @@ L1 gives no temperatures on its own (unless the D3DKMT probe pans out). That is
`LibreHardwareMonitorLib` ≥ 0.9.6, consumed as an **unmodified NuGet package**. It already implements per-vendor GPU sensor access internally — which means the vendor-interop licensing problem is one LHM has solved upstream, under a licence that works for us. That is the entire reason this layer exists.
- `Computer` opened with `IsGpuEnabled` always; ~~`IsCpuEnabled` + `IsMemoryEnabled` only when the Agent is elevated and PawnIO is available~~ nothing else, ever — the CPU temperature uses a separate `Computer` (below) (corrected 2026-10-04). *(2026-11-11: still true of THIS layer's `Computer`. Advanced metrics opens a third one, of its own — the graphics card, and as administrator with PawnIO the processor, memory and motherboard groups; D103, §Advanced metrics. Storage, the power supply, controllers, the battery and the network are opened by nothing.)*
- `Computer` opened with `IsGpuEnabled` always; ~~`IsCpuEnabled` + `IsMemoryEnabled` only when the Agent is elevated and PawnIO is available~~ nothing else, ever — the CPU temperature uses a separate `Computer` (below) (corrected 2026-10-04).
- Poll on a dedicated thread: `computer.Accept(updateVisitor)` then read mapped sensors. Never faster than 500 ms; default 1000 ms.
- Sensor mapping by `SensorType` + name heuristics per vendor (`GPU Core`, `GPU Hot Spot`, `GPU Memory`, `GPU Package Power`, …), kept in `SensorMap.cs` with unit tests against captured sensor-tree fixtures.
- **P0 verification items:** (a) which fields LHM actually returns per vendor on real hardware — fill the capability matrix below — **NVIDIA filled 2026-09-03, AMD/Intel deferred (§R5/§R6)**; (b) ~~whether GPU-only usage works **without** elevation and without PawnIO (expected yes, since GPU sensors go through user-mode vendor paths, but confirm — it determines whether the default unelevated Agent has temperatures at all)~~ — **confirmed 2026-09-03, §M5 row R1**: eight fields unelevated, the same eight elevated, PawnIO never opened; (c) ~~confirm LHM's sources are not marked with MPL-2.0 Exhibit B~~ — **done, 2026-08-02: clear.** No source file applies the notice; the only repository hit is the `LICENSE` template itself, and every file we depend on carries the permissive Exhibit A. Method and evidence in `docs/spike-notes.md` §0. Re-check on every version bump, and check *source headers*, never the LICENSE file — MPL-2.0's own text contains Exhibit B as a template, so grepping the licence finds it in every MPL project ever published.
@@ -204,8 +204,6 @@ Still resolve **entry points defensively at runtime**: `nvapi64.dll` may be abse
> **Not in this build, stated so nobody infers it from the table below:** VRAM (`FlNvSample.vram` is
> reserved and its bit is never set — see the Memory row), power, hotspot temperature, per-domain
> utilisation beyond the GPU domain, and anything Reflex (§M8: a hook fact, not a poller field).
> *(2026-11-11: still true of `FlNvSample`, the 1 Hz telemetry layer's struct. The memory figures and the other
> three utilisation domains are read since ABI 3 — below — into structs of their own, for Advanced metrics only.)*
>
> **ABI 2 (2026-09-25, beta.8): the driver profile, read-only.** The owner asked whether the NVIDIA App overrides a
> game's DLSS (frame generation, ray reconstruction, the model preset). The NVIDIA App writes those overrides into the
@@ -224,39 +222,6 @@ Still resolve **entry points defensively at runtime**: `nvapi64.dll` may be abse
> ctest `fl_nvapi_bridge` (argument refusals, DEGRADED before init, the global profile of the test's own executable on
> a GPU machine) and `NvapiBridgeMirrorTests` (`FlNvDriverProfileSize`, ABI 2).
>
> **ABI 3 (2026-11-11, owner decision D101): what "Advanced metrics" reads.** Five reads, each a struct with its
> size first and a `present` mask, and each call behind it a query: `FlNvReadFacts` (what is true of the card whatever
> is running — its type, bus, PCI ids, VBIOS version, architecture, core counts, the base and boost clocks, the
> sensor's range, `NvAPI_GPU_GetMemoryInfoEx`'s four sizes, the frame-buffer sizes, the driver's package and base
> branch, NVAPI's interface version, the chipset), `FlNvReadLive` (the same memory call's free figure with evictions
> and promotions, the frame-buffer, video and bus utilisation, the video clock, the P-state, the board and
> power-supply temperatures where the card has them, the throttle word, the encoder's session count and averages),
> `FlNvReadDisplays` (per connected display: HDR formats and luminances, variable-refresh support, the adaptive-sync
> flags), `FlNvSessionDisplay` (the display a GDI device name names: its variable-refresh state and the colour space
> the driver reports for one process) and `FlNvProfileSettings` (every setting of the global profile, or only what a
> game's own profile sets — a game no profile names is answered `GLOBAL` with nothing listed, never with the PC's
> settings). No struct of ABI 2 changed size; `FL_NV_FIELD_VRAM` stays clear.
>
> **No identifier has an entry point** (D104): not `NvAPI_GPU_GetBoardInfo`, `NvAPI_GPU_GetUUID`, an EDID read, or
> `NvAPI_GPU_GetEncoderSessionsInfo`, which lists WHICH programs encode. A display is passed on by its place in the
> driver's list; NVAPI's display id is a handle of this boot and is neither stored nor shown.
>
> **Read-only is now a gate** (D108): `tools/nvapi-readonly-check.ps1` holds every `NvAPI_*` call of the bridge's
> source to `tools/nvapi-allowed-calls.txt` in both directions — forty-four names — and refuses a name that sets,
> saves, restores, registers or controls something, or that returns an identifier, **even when the list names it**.
> Managed: `INvapiAdvancedBridge` (a port of its own beside `INvapiBridge`; `NativeNvapiBridge` implements both, and a
> DLL that predates ABI 3 answers `Unavailable` rather than throwing) and `NvapiAdvancedReader`, which turns the five
> structs into the catalog's facts and readings — every `nvapi.` entry whose reach is `Agent`, and no other, held by
> `NvapiAdvancedReaderTests` in both directions. **Nothing composes the reader yet**: no Agent code calls it.
>
> **Measured on the dev box the day it was written** (RTX 5080, a driver of base branch `R620`, ctest `fl_nvapi_bridge`'s
> AVAILABLE branch — `20_OPEN_QUESTIONS` §M12): all twenty facts answer (`present = 0xFFFFF`: discrete, desktop, PCI
> Express, 84 ray-tracing and 336 tensor cores, base 2295 / boost 2670 MHz, 16,303 MiB dedicated, a DCH Game Ready
> driver); eight of the ten live groups answer (`0x33F`) — **the board and power-supply temperatures do not exist on
> this card**, as the memory temperature does not, and read N/A; the one display answers all four groups; the global
> profile lists 24 settings. One thing the header had wrong: it misspells `NV_ENCODER_STATISTICS_VER` as
> `NNV_ENCODER_STATISTICS_VER`, so the bridge names `NV_ENCODER_STATISTICS_VER1`.
>
> **The ctest could not fail on a GPU machine until the same day.** `fl_nvapi_bridge` was registered with
> `PASS_REGULAR_EXPRESSION` alone, which makes ctest ignore the exit code: the AVAILABLE branch's reference-counting
> check (two references, two releases, then a read expected to work) failed on every machine with an NVIDIA GPU while
@@ -269,7 +234,7 @@ Still resolve **entry points defensively at runtime**: `nvapi64.dll` may be abse
| Temperatures | `NvAPI_GPU_GetThermalSettings` (+ extended thermal query for hotspot/memory where available). **Bridge (2026-09-10):** the public enumeration only — core is the `GPU` target; memory is the `MEMORY` target when the driver lists one, and on the RTX 5080 it does not (bit clear → `null`); hotspot is not read |
| Utilisation | `NvAPI_GPU_GetDynamicPstatesInfoEx` (GPU / FB / VID / BUS domains). **Bridge (2026-09-10):** the GPU domain only, as `loadPct` |
| Clocks | `NvAPI_GPU_GetAllClockFrequencies` — **bridge (2026-09-10):** current graphics and memory clocks |
| Memory | `NvAPI_GPU_GetMemoryInfoEx` — **not `NvAPI_GPU_GetMemoryInfo`**, which this table named until 2026-08-05. The vendored headers mark it `__nvapi_deprecated_function` ("deprecated in release 520"), so under `/W4 /WX` a call to it fails the native build. **Neither is called (2026-09-10):** ~~the vendored `nvapi.h` (`cd6918f6`) does not declare `GetMemoryInfoEx` at all — the deprecation message names a function the same header set does not ship~~ — so the bridge's `vram` field is **reserved**, its bit is never set, and VRAM stays L1's PDH adapter counter. ~~Taking a newer header set is the way to change that, not a call to the deprecated one~~ **Corrected 2026-11-11: the vendored set does declare it** — `nvapi_lite_common.h:600`, which `nvapi.h` includes, with `NV_GPU_MEMORY_INFO_EX_V1` above it and its id in `nvapi_interface.h`; the search that found nothing looked in `nvapi.h` alone. It was not called because of that sentence, from 2026-09-10 until now. The bridge calls it from ABI 3 for the advanced memory rows (§Advanced metrics); `FlNvSample.vram` stays reserved, so which layer fills the base `vram_adapter` series does not change |
| Memory | `NvAPI_GPU_GetMemoryInfoEx` — **not `NvAPI_GPU_GetMemoryInfo`**, which this table named until 2026-08-05. The vendored headers mark it `__nvapi_deprecated_function` ("deprecated in release 520"), so under `/W4 /WX` a call to it fails the native build. **Neither is called (2026-09-10):** the vendored `nvapi.h` (`cd6918f6`) does not declare `GetMemoryInfoEx` at all — the deprecation message names a function the same header set does not ship — so the bridge's `vram` field is **reserved**, its bit is never set, and VRAM stays L1's PDH adapter counter. Taking a newer header set is the way to change that, not a call to the deprecated one |
| **Throttle reasons** | `NvAPI_GPU_GetPerfDecreaseInfo` — not available from L1 or L2. **Bridge (2026-09-10):** the raw reason mask, and 0 is a measurement (no reason), not a clear bit |
| Driver version | `NvAPI_SYS_GetDriverAndBranchVersion` — **bridge (2026-09-10):** `FlNvDriverVersion`, surfaced as `616.64 (r616_41)` |
| **NGX per-process state** | `NvAPI_NGX_GetNGXOverrideState` (R570+) — the driver's feedback word per DLSS feature for a PID, read OUT OF PROCESS by `fl-probe-nvapi --ngx-state` and, since 2026-09-06, by the capture host beside each module snapshot — **in-process through the bridge since 2026-09-10** (`NvapiNgxStateProbe`; the spawn is retired and the words, the merge and the printed block are unchanged). Measured: the SR word's `CREATED \| EVALUATE` is set without an NVIDIA-app override; the FG word follows DLSS-G once created (`CREATED \| EVALUATE` at ×4, corrected the same day — the first reading was blind because it was early), the multiplier bits stay clear; `scalingRatio` is 0 even under an override. Identity only, SR and FG (`03_METRICS` §Upscaling) — and, since beta.24 (D63), the mode an NVIDIA App override set where the word says it applied; its `performanceMode` is in NGX's own numbering (Silent Hill 2, 2026-10-13: the App's Ultra Performance, profile value 5, reported as 3). *(Beta.27: never read after the game has gone — that reading, the last, had cleared `CREATED \| EVALUATE` on every stored session — and the two bits stand once a reading carried them: `03_METRICS` §The driver-reported rung.)* |
@@ -528,489 +493,3 @@ alone could never catch.
> (`NvapiTelemetrySource` over `FrameLedger.NvapiBridge.dll`, §L3). §M5 in particular (do LHM GPU
> sensors work unelevated, without PawnIO?) decided whether the default unelevated
> Agent has temperatures at all — **it does, on NVIDIA; row R1 above.**
## Advanced metrics (owner decisions D101–D108, 2026-11-11)
The owner asked for a setting, *"Thông số nâng cao"* (Advanced metrics), with a navigation item of its own, that shows
as much as the Streamline and NVAPI headers and PawnIO make available — numbers, tables, charts — **with each value
assigned to what it belongs to: one game session, or the PC**. Asked while planning, the owner chose: everything
that can be reached inside a game as well, in stages, the route refused on 2026-08-09 re-examined; stored in full with
the session; off by default, and off means nothing more is read; and the page never asks for administrator rights
itself. This section is the design those answers gave, the decisions taken with it, and the inventory.
**Nothing here is built by the pull request that wrote it** except the catalog
(`FrameLedger.Application.Advanced.AdvancedMetricCatalog`) and this section. Each later pull request of the train
states here what it built.
### The decisions
- **D101 — the option.** `telemetry.advanced`, off by default, read by the Agent at each session's start. **Off means
not read**: no additional call to NVAPI or LibreHardwareMonitor, nothing more stored, and the navigation item is
hidden. A session recorded while it was off shows N/A for everything here — it is not filled in afterwards.
- **D102 — where it is stored.** In two tables of their own (schema 0023), not in new columns of `sessions`: every
read of a `sessions` row, the JSON export and the bug bundle carry the whole row, and a driver profile does not
belong in a bug bundle. `machine_profiles` holds the facts of the PC, one row per distinct set, and a session points
to the row that was true when it ran — the trend's hardware-change markers and `hardware_snapshots` are untouched.
`session_advanced` holds one session's facts, its series' statistics and their directory. The series themselves go
to `sensor_blobs` under names that start with `adv.`, **with NaN for a tick that has no reading**: the fixed series
store −1 there and their readers drop every negative value, which would silently eat a −12 V rail.
- **D103 — LibreHardwareMonitor's other groups.** CPU, memory and motherboard (its sensor chip and embedded
controller) are opened **only when the Agent already runs as administrator and PawnIO is installed** — the existing
admin mode (D34); the page says what is missing and links to that setting. **Refused**: the power-supply and
fan-controller groups, which make the library search every USB HID device. **Deferred**: the battery group — and
**storage**. The plan had storage in, temperature only and internal drives only, with one outcome written down
before any run: *if the group cannot be opened without touching removable drives, it stays closed*. It cannot: the
library's `StorageGroup` (0.9.6, read 2026-11-11) lists every drive through DiskInfoToolkit's `ReloadStorages` with
no filter by bus, and subscribes to drives being plugged in afterwards. So `lhm.storage.*` is `Deferred`, a drive's
temperature reads N/A, and `LhmGroups` — the only way this code can name a group to open — has no member for it
(`20_OPEN_QUESTIONS` §M13). This amends §L2's "nothing else, ever" from the pull request that opened the three.
- **D104 — identifiers are never read.** The card's board serial number and unique id, a display's EDID, and the list
of programs that are encoding. They are named in the inventory so the page can say so; a test holds that no stored
JSON has their keys. This is the only part of "everything" left out on purpose.
- **D105 — the navigation item** is the last of the pane's items; Ctrl+1 to Ctrl+5 keep their pages and **Ctrl+6**
opens it only while the option is on.
- **D106 — the `.partial` file skips what it does not know.** A chunk of an unknown type whose checksum is right is
passed over; until now it ended the read, so a build one release older lost everything after the first new chunk.
- **D107 — with no game running**, the Agent reads sensors only while the page is open, through one reader shared
with the sessions, closed again some seconds after the last use. A PC idling with FrameLedger in the tray reads
nothing (NFR-2's "~0% idle").
- **D108 — read-only, by a gate.** §Runtime policy's "never call a setter" becomes a build check: every `NvAPI_*`
call in the bridge's source is compared with a committed list, in both directions, and a name that changes
something or returns an identifier is refused whatever the list says. An entry point that both reads and writes by
a command argument — the colour and info-frame controls — is refused like a writer: the check reads names, not
arguments, and nothing on the list is one. *(Built with ABI 3: `tools/nvapi-readonly-check.ps1`.)*
### The reader (built 2026-11-11; composed by the Agent since the switch)
`Application.Advanced.IAdvancedHardware` is the port: `Acquire()` keeps the reader running until the handle is let
go, `Latest` is the last tick without waiting, `ReadSessionFacts` reads one session's facts on the caller's thread.
`Infrastructure.Telemetry.AdvancedHardwareHub` implements it — **one reader for the whole Agent, on a thread of its
own (`fl-advanced`), running only while somebody holds it** and for a linger after, so that two sessions in a row,
or a session ending as the page opens, do not close and reopen the sensors (D107). The Agent records several
sessions at once, each with a poller; a reader per session would open the motherboard's sensor chip as many times.
What runs on that thread is `AdvancedHardwareReader`: NVAPI through `NvapiAdvancedReader`, and
`LhmAdvancedReader` over a `Computer` of its own, opened with `LhmAdvancedReader.GroupsFor(elevated, pawnIo)` —
`LhmGroups`, an enum that has a member for the four groups this project may open and for no other. Each sensor is a
member of a catalog family by the device at the top of its tree and its type (`LhmAdvancedMap.FamilyOf`); its series
is named from the library's own identifier (`/lpc/nct6798d/0/voltage/3` → `adv.lhm.board.voltage.lpc_nct6798d_0_3`)
and labelled with the hardware's words. A sensor with no family is not read.
- **A source that is not there is a state** (`AdvancedSources`): no NVIDIA driver, not administrator, PawnIO
missing. Never an exception, and never a value in its place.
- **A device that throws twice is left alone** until the reader opens again; the others go on. The library's own
traversal stops at the first exception, so each top-level device is refreshed in a guard of its own.
- **NVAPI answering with no field, twice running, after it had answered**: released and initialised again, once
(`20_OPEN_QUESTIONS` §M12).
- **The cadence was set by a measurement, before anything composed the reader.** `FrameLedger.CaptureHost
probe-advanced` runs this reader on the caller's own rights and prints what it read and what it cost. On the dev
box (RTX 5080, unelevated, 2026-11-11): 35 facts and 58 readings a tick — 17 from NVAPI, 41 from the card's sensors;
**one NVAPI live read costs 0.4 ms of processor time; one refresh of LibreHardwareMonitor's graphics-card group
costs 14 ms (62 ms elapsed)**. Once a second that refresh alone is 1.4% of one core, above NFR-2's 1% for the
whole Agent. So NVAPI is read every tick and **the sensor library every fifth** (0.28%), and on the ticks between a
sensor has no reading — its last value is not repeated. The same refresh is what the L2 telemetry layer does once
a second in every session: that cost is not this feature's, and is `20_OPEN_QUESTIONS` §M16 — measured in a real
Agent on 2026-11-11 (1.93 % of one core off, 2.04 % on) and answered by amending NFR-2 to 2.5 % (D117).
### From the reader to the ledger (built 2026-11-11; fed since the switch)
- **The poller attaches, it does not read.** `TelemetryPoller` takes an optional `IAdvancedHardware`, holds it from
`Start` to `Dispose`, and at each poll takes `Latest` — a read of one reference. A snapshot it has not taken yet
rides on that poll's `TelemetrySample.Advanced`; one it has already taken is not attached again, because a
reading is of one tick. Null — the option off — composes nothing, and a sample is what it always was.
- **The `.partial`** carries those readings in a chunk of their own after the sensor chunk (type 9) and the
session's context in another (type 10), so a recovered session keeps both; with the option off neither is
written. An unknown chunk type is now skipped rather than the end of the file (D106). `06_DATA_MODEL` §The
`.partial` file.
- **The finalizer** (`AdvancedSessionBuilder`, both tiers) turns the samples' readings into one series each,
aligned to `t_ms` with NaN for a tick with none, and builds the session's row: facts, sources, statistics,
directory. Schema 0023 and the rule for NaN are `06_DATA_MODEL` §Blob encoding and §Migrations.
### The switch (built 2026-11-11, Advanced PR-5)
`telemetry.advanced` (`SettingsRegistry.TelemetryAdvanced`, Boolean, default `0`, read by the Agent) becomes
`RecorderOptions.AdvancedMetrics` through `SettingsRecorderPolicy`, at each session's start like the other recording
settings; exactly `1` is on. From there:
- **The process has one sensor library** *(2026-11-12)*. One *reader* was never the whole of it: a session's L2
source and its CPU-temperature reader each open a LibreHardwareMonitor `Computer` of their own beside the
Advanced reader's, and the library keeps part of its state — the driver it reads the processor through, its bus
mutexes — per process. `Computer.Close()` lets go of that part whoever else is still reading. The first sessions
recorded as administrator with PawnIO showed it (`20_OPEN_QUESTIONS` §M13): a processor device that faulted out
some seconds after each session's sources closed, and one session whose reader could not open at all. Every
`Computer` is now opened and closed through `Infrastructure.Telemetry.LhmLibrary` (`LhmComputerAdapter` is its
user): opens and closes never run at once, and a `Computer` closed while another is in use is **parked** — left
open, read by nobody, handed to the next user of the same groups — until the last user lets go, when all are
closed. The reads are not serialised: the readers keep their own threads, so a sensor that hangs in one still
holds up neither the other nor the pipe.
- **The Agent has one reader** — `AgentServices` registers `AdvancedHardwareHub` as `IAdvancedHardware`, a tick a
second and a linger of ten — and nothing starts it but a holder. `SessionRecorder` holds it for a session's length
**only when the option is on**, and `AgentRecording` gives the session's `TelemetryPoller` the reader on the same
condition. Off: not held, not asked, no chunk 9 or 10, no row (`SessionRecorderTests.WithAdvancedMetricsOff…`).
- **A session's facts are read once, off the capture loop.** Fifteen seconds after the game's process is known — by
then it has a window — or at the session's end if that comes first, `IAdvancedHardware.ReadSessionFacts` runs on a
pool thread: asking the driver for a profile takes some hundred milliseconds. The finalize waits at most five
seconds for a read still in flight and stores the session without its facts rather than hold it. A read that
throws costs the facts, never the session.
- **Which display is the game's** comes from Windows, not from the game: `WindowGeometryProbe.MonitorDeviceOf` — the
monitor the process's largest visible window is on, as its GDI device name — which the reader hands to
`FlNvSessionDisplay`. No window, or a display another adapter drives: the session's display facts are absent.
- **The context reaches the crash file as it changes** (chunk 10), from `IAdvancedHardware.Latest` — a read of one
reference on the capture loop's task — so a recovered session keeps its machine facts, its sources and its
directory of series.
- **A session recorded with the option on always stores a row**, if only one that says every source is `Unknown`:
no row means "the option was off when this was recorded", which the page (PR-7) shows as such.
What elevation adds changed with this: an Agent running as administrator with PawnIO reads the processor, memory
and motherboard groups in a session with the option on. The texts that state what the admin mode adds say so —
Disclaimer 2.15 §5 and §5A (the owner's answer of 2026-11-11), the admin mode's disclosure (`agent-admin-dialog/2`),
Settings, the first run, the guide and `LIMITATIONS.md` — and Privacy Policy 2.15 names what is read and stored.
### The page's feed (built 2026-11-11, Advanced PR-6; shown by the page since PR-7)
With no game running the Agent reads sensors **only while the page is open** (D107), and nothing tells the Agent
that a page opened or closed:
- **`GetAdvancedMachine`** (`07_IPC` §Messages) is answered by `Application.Ipc.AdvancedMachineResponder` from
`IAdvancedHardware.Latest` alone. The first request acquires the shared reader and each one renews a five-second
lease; a lease after the last request the hold is let go, and the reader closes its sources ten seconds later
unless a session holds it. A page that closes, an App that exits and a pipe that drops all look the same: no
request. With the option off the answer is `Error AdvancedOff`, and nothing is held.
- **`App.Services.AdvancedMachineFeed`** asks once a second while a page holds `Watch()`, and keeps the facts (asked
for once, by their hash), **the last value of every series with the tick it was read on** — a sensor read every
fifth tick is "1400, as of then", never shown as new — five minutes of each series for the live charts, and the
sources' states. It stores nothing. Its states are the page's own words for why there is nothing to show: waiting
for the first read, off, no agent (a viewer never has one), an older agent.
### The page (built 2026-11-11, Advanced PR-7)
`08_UI` §Advanced is the screen. What this document's model becomes there:
- **A machine fact** is under *This PC* ▸ *About this PC* while the Agent answers, and under *Session* as it was
when that session was recorded (`machine_profiles`, one row per distinct set).
- **A session fact** is under *Session* only.
- **A series** is a row of *Right now* and a line of *Over time* while live — never stored then — and a row of the
session's statistics and a line of its chart once a session stored it.
- **An entry that is not read** is on *Sources* with its reason, in the same words as §Left out, by name.
`ISessionRepository.ListAdvancedAsync` lists the sessions that have a row; `SessionSeriesLoader.LoadAdvancedAsync`
decodes their series against `t_ms`, leaving a NaN tick out and keeping a negative reading.
### What belongs to what
| Scope | What it is | Stored | Shown |
|---|---|---|---|
| `MachineFact` | true of the PC whatever is running: the card's firmware and architecture, the driver's package, what a display can do | `machine_profiles`, once per distinct set; a session points to its row | This PC |
| `SessionFact` | true of one session: the game's display state, the settings the driver's profile for that game sets | `session_advanced.facts_json` | Session |
| `Series`, during a session | a sensor of the PC sampled while the game ran | `sensor_blobs` (`adv.*`), statistics in `session_advanced.stats_json` | Session |
| `Series`, with no session | the same sensor, read because the page is open | nowhere | This PC |
A third tab, **Sources**, lists every row of the inventory with its state on this PC — read, or N/A with the reason:
not an NVIDIA card, the Agent is not administrator, PawnIO is not installed, the option was off when the session was
recorded, the hook is not built, the route is refused, a vendor's licence. A PC without an NVIDIA card shows N/A for
every `nvapi.` row; nothing is estimated in its place (FR-4.9).
### The trains
| Train | Release | What | Its gate |
|---|---|---|---|
| A | 0.1.0-beta.39 | read by the Agent only — NVAPI and LibreHardwareMonitor — storage, the page. **Nothing changes in code loaded into a game** | this section |
| B | 0.1.0-beta.40, ~~.41, .42~~ .42, .43 *(three releases since D113, 2026-11-11; one was planned. Renumbered 2026-11-12, D118: 0.1.0-beta.41 is a fix release for the sensor library, not part of the train)* | inside the game: more fields of the Streamline and FidelityFX calls already hooked, and new hooks on functions `sl.interposer.dll` **exports** (`17_HOOK_ENGINE` §Hook inventory's ⏳ rows); shared-memory layout 5 — §Train B below | a plan of its own; overhead measured; each release after the first waits for the owner's run of the one before |
| C | ~~0.1.0-beta.41~~ ~~0.1.0-beta.43~~ 0.1.0-beta.44 *(D118)* | Reflex latency per frame | a spike, then the owner's go or no |
| D | ~~0.1.0-beta.42~~ ~~0.1.0-beta.44~~ 0.1.0-beta.45 *(D118)* | the Streamline feature state behind `slGetFeatureFunction` — DLSS frame generation's, DLSS's, Reflex's | a spike, then the owner's go or no |
Rules 4 and 5, the hook inventory, the measured overhead and the anti-cheat guard bind B, C and D exactly as they bind
every hook. `sl::Constants` is read without its camera position, axes and matrices: where the camera is, is where the
player is (rule 4). NGX stays closed by its licence (`17_HOOK_ENGINE` §NGX).
**Train D re-examines a refusal; it does not lift it.** `handoff/history/p0-queue-1-6.md` refused, on five grounds,
hooking `slGetFeatureFunction` and patching the function it returns. The route to try is a different one:
`slGetFeatureFunction` is itself an export (`vendor-exports.json`), so its hook is an ordinary inventory row, and
what it hands back could be a wrapper for a fixed list of names instead of a patch at an address learned at run time
— which would answer grounds 1 to 4, and turn ground 5 into "measured only when injected at launch". Two things it
raises are the owner's: replacing the pointer the game receives is a **write**, which rule 4 forbids as written; and
a wrapper must outlive the Overlay's own unhook. If the spike cannot answer all of it, the route stays refused and
the page says so.
### Train B (planned 2026-11-11, owner decisions D110–D116)
What the catalog marks `HookedCall` and `NewHook`. Planned the day train A shipped, the owner's decisions asked while
planning, the design reviewed against the code before it was approved.
- **D111 — off means off inside the game too.** The Agent writes one word of the control block
(`advancedRequested`, ~~0 or 1~~ 0 or that session's request, unconditionally at attach) when the session records Advanced metrics. The Overlay
reads a new field, and installs a new hook, only while it is set; with the option off it hooks and reads exactly
what 0.1.0-beta.39's does.
**Built 2026-11-12 (0.1.0-beta.40, PR-3), with one thing the plan did not have:** "on" is not a 1 but a
*request* — a value no session of that ring used before. A game outlives a session, and the Overlay's summaries
with it; a second session of a game that kept running would have read the first one's field of view and counts.
The watchdog starts its summaries afresh at a request it has not seen and names the request in every publication;
the Agent reads only what answers its own (`07_IPC` §Region 5). The detours consult one process-local flag, the
watchdog is the region's one writer, and `fl_guard` shows the off half on a target that sends everything: every
byte of the region zero until asked, untouched after an "off", a count that starts again at the next request.
**The Agent and the App, 2026-11-12 (PR-4).** A session that records Advanced metrics says so through
`ICaptureObserver.WantsInGameAdvanced`; `CaptureSession` writes the word either way as the ring is attached, before
its first guard result, and from then on carries each publication of region 5 on `CaptureProgress.InGameAdvanced`
— one instance a publication, the same one on the ten ticks between two. `Application.Capture.InGameAdvancedSampler`
turns a publication into what a session stores: the session facts of the thirteen `Game` entries below, in the
vendor's own words (a preset is its letter, a member its name), and two series —
`adv.ffx.upscale.frame_time_delta`, the mean of one second's dispatches, and `adv.ffx.memory_usage`, a point for
each second the game asked. The facts are one list until a field they are made of moves, so the recorder's context
is rewritten when a range widens and not once a second; the readings ride the newest telemetry sample of the tick.
**No schema change**: the facts go into `session_advanced.facts_json` beside the driver's, the series into
`sensor_blobs` under their `adv.` names, the `.partial`'s chunks 9 and 10 carry both. `AdvancedSources.InGame`
(optional; absent in every row 0.1.0-beta.39 wrote) says what became of those entries in the session: `Reading`,
`NothingSeen` — measured inside the game, and the game made none of the calls where they can be seen — or
`NotHooked`. The page says it in the session's sources line and, on Sources, that such an entry is read inside a
game FrameLedger measures when the game makes the call. The aliasable part of FSR's memory is published and not
shown: the catalog has one memory entry.
- **D113 — three releases, because a new patch site cannot be proven in CI.** A crash in a game under the user-mode
anti-cheat exception's trial ends that exception for good (D38), and every release already means restarting the
game. **beta.40**: more fields of calls *already* hooked — `sl::DLSSOptions` where the game chains it into
`slEvaluateFeature`, the FSR upscale dispatch, the FSR memory query — shared-memory layout 5, the Agent and the
page; **no new patch site**. **~~beta.41~~ beta.42**: `slSetConstants` and `ffxConfigure`. **~~beta.42~~
beta.43**: `slGetFeatureVersion` and `slGetFeatureRequirements` — the owner's words: a release of their own, still
hooked. Each starts when the owner says the one before passed its owner-only item.
- **D118 — 0.1.0-beta.41 is a fix release, and the train's numbers move by one** (owner decision 2026-11-12). The
owner's first evening with beta.40 showed the sensor library being closed under its other users (the paragraph on
`LhmLibrary` below; `20_OPEN_QUESTIONS` §M13); told that the fix would take the number D113 had given the train's
second release, the owner chose to release it at once. So: second release beta.42, third beta.43, train C
beta.44, train D beta.45. Text written before that day says beta.41 and beta.42 for the second and third — in
the released changelogs and the moved HANDOFF sections, which are not edited, and in the comments of `fl_shm.h`
and `ShmLayout.cs`, which the release that fills each member rewrites (they were left so that the code loaded
into a game stayed 0.1.0-beta.40's, line for line, in a release that fixes something else).
- **D112 — `slInit` is not hooked in train B.** A game calls it before FrameLedger attaches, so its preferences
would almost never be seen. If it is ever hooked: `applicationId`, `projectId` and the paths are never read.
- **D114 — the field of view is a session's range**, lowest to highest, never a series: a series would say when the
player aimed.
- **D115 — a tail member is read only where it is proven to be there** (`17_HOOK_ENGINE` §Which struct version
carries which field): the table from the upstream tags, not the one header in the tree.
- **D116 — "never the camera" is a build check**, as "never a setter" is (D108): `tools/overlay-fields-check.ps1` —
every read of a vendor struct in one header, each allowed member named and used, the camera's names refused
anywhere in the Overlay and the Vulkan layer, no copy of `sl::Constants` by value. *(Built 2026-11-12:
twenty-eight members on `tools/overlay-allowed-fields.txt`; `12_BUILD` gate 14f.)*
- **What will read N/A, and says why.** Many titles set their DLSS options through `slDLSSSetOptions`, which is not
an export (train D), so `sl.dlss.*` is filled only for a title that passes its options with the evaluate call.
`slGetFeatureVersion` and `slGetFeatureRequirements` are calls a game makes while starting.
- **Privacy Policy 2.16** at beta.40, once for the three releases: with Advanced metrics on, for a game FrameLedger
injects into, the parameters the game gives its upscaler and frame generation through the intercepted calls are
*stored* — sizes, presets, exposure, sharpening, the jitter's, the depth's and the field of view's ranges, flags,
versions — and never the camera's position, axes or matrices.
### Left out, by name
Present in the vendored `nvapi.h`, readable from the Agent, and not in the inventory — each is either not a
measurement of how a game runs or exists on professional cards only: ECC status and errors, NVLINK, illumination
(the card's lighting zones), licensable features, virtualization and GSP information, Quadro status, VR-ready data,
the IRQ and bus slot numbers, logical GPUs and SLI state, HDCP support, scan-out configuration, the colour and
info-frame controls. `NvAPI_DISP_GetTiming` calculates a timing from an input and reads nothing.
`NV_GET_ADAPTIVE_SYNC_DATA`'s last-flip count and timestamp mean nothing sampled once a second.
`NvAPI_GPU_ClientRegisterForUtilizationSampleUpdates` registers a callback, which is not a read.
### The inventory
One row per entry of `AdvancedMetricCatalog`, in its order; `AdvancedMetricCatalogTests` fails when this table and
the catalog differ in either direction. **Reach** is where a value can be read from, or why it is not read: `Agent`
(the Agent's own process), `AgentElevated` (the same, as administrator with PawnIO), `Game` (read inside a game
FrameLedger measures, from the arguments of a call the Overlay hooks, while the session records Advanced metrics —
since 0.1.0-beta.40), `HookedCall` (an argument of a call the Overlay already hooks, not read yet), `NewHook` (a hook
that is not built — Train B), `Spike` (Trains C and D), `Refused`, `Deferred`, `Identifier` (D104), `PlayerState`
(rule 4), `Licence`, `NotInHeaders`. ~~Only the first two are read by a build of Train A.~~ The first three are read
(`AdvancedMetric.IsRead`).
**NVAPI, the graphics card: facts**
| Id | What it is | Scope | Source | Reach | Unit |
|---|---|---|---|---|---|
| `nvapi.gpu.type` | Integrated or discrete graphics | MachineFact | Nvapi | Agent | Text |
| `nvapi.gpu.system_type` | Laptop or desktop, as the driver sees the PC | MachineFact | Nvapi | Agent | Text |
| `nvapi.gpu.external` | The card is an external one | MachineFact | Nvapi | Agent | Flag |
| `nvapi.gpu.bus_type` | The bus the card sits on | MachineFact | Nvapi | Agent | Text |
| `nvapi.gpu.pci_ids` | PCI device, subsystem and revision ids - the model, not the unit | MachineFact | Nvapi | Agent | Text |
| `nvapi.gpu.vbios_version` | Video BIOS version | MachineFact | Nvapi | Agent | Text |
| `nvapi.gpu.architecture` | Chip architecture, implementation and revision | MachineFact | Nvapi | Agent | Text |
| `nvapi.gpu.core_count` | Graphics cores | MachineFact | Nvapi | Agent | Count |
| `nvapi.gpu.rt_cores` | Ray-tracing cores | MachineFact | Nvapi | Agent | Count |
| `nvapi.gpu.tensor_cores` | Tensor cores | MachineFact | Nvapi | Agent | Count |
| `nvapi.gpu.ram_bus_width` | Width of the card's memory bus | MachineFact | Nvapi | Agent | Bits |
| `nvapi.gpu.clock_base_core` | Base core clock | MachineFact | Nvapi | Agent | Megahertz |
| `nvapi.gpu.clock_base_memory` | Base memory clock | MachineFact | Nvapi | Agent | Megahertz |
| `nvapi.gpu.clock_boost_core` | Boost core clock | MachineFact | Nvapi | Agent | Megahertz |
| `nvapi.gpu.clock_boost_memory` | Boost memory clock | MachineFact | Nvapi | Agent | Megahertz |
| `nvapi.gpu.temp_default_max` | The core sensor's default maximum temperature | MachineFact | Nvapi | Agent | Celsius |
**NVAPI, the card's memory**
| Id | What it is | Scope | Source | Reach | Unit |
|---|---|---|---|---|---|
| `nvapi.vram.dedicated` | Dedicated video memory on the card | MachineFact | Nvapi | Agent | Mebibytes |
| `nvapi.vram.dedicated_available` | Dedicated video memory available for surfaces | MachineFact | Nvapi | Agent | Mebibytes |
| `nvapi.vram.system` | System memory the driver reserved at load | MachineFact | Nvapi | Agent | Mebibytes |
| `nvapi.vram.shared` | Shared system memory the driver may commit | MachineFact | Nvapi | Agent | Mebibytes |
| `nvapi.vram.framebuffer_physical` | Physical frame buffer size | MachineFact | Nvapi | Agent | Mebibytes |
| `nvapi.vram.framebuffer_virtual` | Virtual frame buffer size | MachineFact | Nvapi | Agent | Mebibytes |
| `nvapi.vram.available` | Dedicated video memory available now, all programs | Series | Nvapi | Agent | Mebibytes |
| `nvapi.vram.in_use` | Dedicated video memory in use now, all programs: available for surfaces less available now | Series | Nvapi | Agent | Mebibytes |
| `nvapi.vram.evictions_size` | Memory released by evictions since the driver loaded | Series | Nvapi | Agent | Mebibytes |
| `nvapi.vram.eviction_count` | Evictions from dedicated video memory since the driver loaded | Series | Nvapi | Agent | Count |
| `nvapi.vram.promotions_size` | Memory moved in by promotions since the driver loaded | Series | Nvapi | Agent | Mebibytes |
| `nvapi.vram.promotion_count` | Promotions into dedicated video memory since the driver loaded | Series | Nvapi | Agent | Count |
**NVAPI, the card over time**
| Id | What it is | Scope | Source | Reach | Unit |
|---|---|---|---|---|---|
| `nvapi.load.framebuffer` | Frame-buffer (memory controller) utilisation | Series | Nvapi | Agent | Percent |
| `nvapi.load.video` | Video-engine utilisation | Series | Nvapi | Agent | Percent |
| `nvapi.load.bus` | Bus-interface utilisation | Series | Nvapi | Agent | Percent |
| `nvapi.clock.video` | Video clock | Series | Nvapi | Agent | Megahertz |
| `nvapi.pstate` | The card's current performance state (P-state id) | Series | Nvapi | Agent | Count |
| `nvapi.temp.board` | Board ambient temperature, where the card has the sensor | Series | Nvapi | Agent | Celsius |
| `nvapi.temp.power_supply` | The card's power-supply temperature, where it has the sensor | Series | Nvapi | Agent | Celsius |
| `nvapi.limit.ac_battery` | Held back by a switch to battery on the tick: 100 or 0 | Series | Nvapi | Agent | Percent |
| `nvapi.limit.api` | Held back at a program's request on the tick: 100 or 0 | Series | Nvapi | Agent | Percent |
| `nvapi.limit.insufficient_power` | Held back by a missing power connector on the tick: 100 or 0 | Series | Nvapi | Agent | Percent |
| `nvapi.encoder.sessions` | Active hardware-encoder sessions, all programs | Series | Nvapi | Agent | Count |
| `nvapi.encoder.fps` | Average encoding rate of the active sessions | Series | Nvapi | Agent | FramesPerSecond |
| `nvapi.encoder.latency` | Average encoding latency | Series | Nvapi | Agent | Microseconds |
**NVAPI, the driver**
| Id | What it is | Scope | Source | Reach | Unit |
|---|---|---|---|---|---|
| `nvapi.driver.package` | Game Ready, Studio or an RTX enterprise branch | MachineFact | Nvapi | Agent | Text |
| `nvapi.driver.dch` | The driver is a DCH package | MachineFact | Nvapi | Agent | Flag |
| `nvapi.driver.base_branch` | The driver's base branch | MachineFact | Nvapi | Agent | Text |
| `nvapi.driver.interface_version` | NVAPI's own interface version | MachineFact | Nvapi | Agent | Text |
| `nvapi.driver.chipset` | Chipset vendor and name, as the driver reports them | MachineFact | Nvapi | Agent | Text |
| `nvapi.driver.global_profile` | Every setting of the driver's global profile, read-only | MachineFact | Nvapi | Agent | Table |
| `nvapi.session.driver_profile` | The settings the driver's profile for this game sets itself, read-only | SessionFact | Nvapi | Agent | Table |
**NVAPI, displays**
| Id | What it is | Scope | Source | Reach | Unit |
|---|---|---|---|---|---|
| `nvapi.display.hdr_formats` | HDR formats a display accepts: HDR10, HDR10+, HDR10+ Gaming, Dolby Vision, EDR | MachineFact, one per device | Nvapi | Agent | Text |
| `nvapi.display.luminance_max` | A display's maximum luminance for HDR content | MachineFact, one per device | Nvapi | Agent | Nits |
| `nvapi.display.luminance_min` | Its minimum luminance | MachineFact, one per device | Nvapi | Agent | Nits |
| `nvapi.display.luminance_max_frame_average` | Its maximum frame-average light level | MachineFact, one per device | Nvapi | Agent | Nits |
| `nvapi.display.vrr_support` | Variable refresh: supported, G-SYNC module or adaptive sync, ULMB, usable at the current mode | MachineFact, one per device | Nvapi | Agent | Text |
| `nvapi.display.adaptive_sync_off` | Adaptive sync is switched off on the display | MachineFact, one per device | Nvapi | Agent | Flag |
| `nvapi.display.max_frame_interval` | The longest frame interval adaptive sync is set to hold | MachineFact, one per device | Nvapi | Agent | Microseconds |
| `nvapi.session.vrr_enabled` | Variable refresh was active on the game's display | SessionFact | Nvapi | Agent | Flag |
| `nvapi.session.vrr_requested` | Variable refresh was requested for it | SessionFact | Nvapi | Agent | Flag |
| `nvapi.session.vrr_possible` | Variable refresh was possible on it | SessionFact | Nvapi | Agent | Flag |
| `nvapi.session.vrr_display_mode` | The display itself was in variable-refresh mode | SessionFact | Nvapi | Agent | Flag |
| `nvapi.session.source_colorspace` | The colour space the game presented in, as the driver reports it for the process | SessionFact | Nvapi | Agent | Text |
**LibreHardwareMonitor, the graphics card (every vendor, unelevated)**
| Id | What it is | Scope | Source | Reach | Unit |
|---|---|---|---|---|---|
| `lhm.gpu.temperature` | Every temperature sensor of the card | Series, one per device | Lhm | Agent | Celsius |
| `lhm.gpu.load` | Every load of the card: its engines, its bus, its memory controller | Series, one per device | Lhm | Agent | Percent |
| `lhm.gpu.memory` | The card's memory counters: total, free, used, Direct3D dedicated and shared | Series, one per device | Lhm | Agent | Mebibytes |
| `lhm.gpu.clock` | Every clock of the card | Series, one per device | Lhm | Agent | Megahertz |
| `lhm.gpu.power` | Every power reading of the card | Series, one per device | Lhm | Agent | Watts |
| `lhm.gpu.fan` | Every fan of the card | Series, one per device | Lhm | Agent | Rpm |
| `lhm.gpu.fan_control` | Each fan's duty | Series, one per device | Lhm | Agent | Percent |
| `lhm.gpu.voltage` | Every voltage of the card | Series, one per device | Lhm | Agent | Volts |
| `lhm.gpu.current` | Every current of the card | Series, one per device | Lhm | Agent | Amperes |
| `lhm.gpu.throughput` | PCI Express traffic to and from the card | Series, one per device | Lhm | Agent | BytesPerSecond |
**LibreHardwareMonitor through PawnIO (the Agent as administrator, D103)**
| Id | What it is | Scope | Source | Reach | Unit |
|---|---|---|---|---|---|
| `lhm.cpu.temperature` | Processor temperatures: the package and each core | Series, one per device | Lhm | AgentElevated | Celsius |
| `lhm.cpu.load` | Processor load: the total and each core | Series, one per device | Lhm | AgentElevated | Percent |
| `lhm.cpu.clock` | Each core's clock, and the bus clock | Series, one per device | Lhm | AgentElevated | Megahertz |
| `lhm.cpu.power` | Processor power: the package, the cores | Series, one per device | Lhm | AgentElevated | Watts |
| `lhm.cpu.voltage` | Processor voltages | Series, one per device | Lhm | AgentElevated | Volts |
| `lhm.board.model` | The motherboard's maker and model | MachineFact | Lhm | AgentElevated | Text |
| `lhm.board.sensor_chip` | The board's sensor chip | MachineFact | Lhm | AgentElevated | Text |
| `lhm.board.temperature` | The board's temperature sensors | Series, one per device | Lhm | AgentElevated | Celsius |
| `lhm.board.fan` | Each fan header's speed | Series, one per device | Lhm | AgentElevated | Rpm |
| `lhm.board.fan_control` | Each fan header's duty | Series, one per device | Lhm | AgentElevated | Percent |
| `lhm.board.voltage` | The board's voltage rails | Series, one per device | Lhm | AgentElevated | Volts |
| `lhm.memory.modules` | The memory modules: size, speed, maker's part name - never a serial number | MachineFact | Lhm | AgentElevated | Table |
| `lhm.memory.load` | Memory in use: physical and virtual | Series, one per device | Lhm | AgentElevated | Percent |
| `lhm.memory.temperature` | Each memory module's temperature, where it has a sensor | Series, one per device | Lhm | AgentElevated | Celsius |
**What the Agent could reach and does not**
| Id | What it is | Scope | Source | Reach | Unit |
|---|---|---|---|---|---|
| `lhm.psu` | Power-supply sensors: reading them makes the library search every USB device | MachineFact | Lhm | Refused | Table |
| `lhm.controller` | Fan-controller sensors: the same search of USB devices | MachineFact | Lhm | Refused | Table |
| `lhm.battery` | Battery sensors | MachineFact | Lhm | Deferred | Table |
| `lhm.storage.models` | The drives' model names: the library cannot list drives without touching removable ones | MachineFact | Lhm | Deferred | Table |
| `lhm.storage.temperature` | Each drive's temperature: the same, so the storage group is not opened | Series, one per device | Lhm | Deferred | Celsius |
| `nvapi.gpu.board_serial` | The card's board serial number | MachineFact | Nvapi | Identifier | Text |
| `nvapi.gpu.uuid` | The card's unique id | MachineFact | Nvapi | Identifier | Text |
| `nvapi.display.edid` | A display's EDID block, which carries its serial number | MachineFact, one per device | Nvapi | Identifier | Text |
| `nvapi.encoder.session_processes` | Which programs are encoding | Series | Nvapi | Identifier | Table |
| `nvapi.gpu.power` | Card power through NVAPI (LibreHardwareMonitor reads it) | Series | Nvapi | NotInHeaders | Watts |
| `nvapi.gpu.fan_duty` | Fan duty through NVAPI (LibreHardwareMonitor reads it) | Series | Nvapi | NotInHeaders | Percent |
| `nvapi.gpu.voltage` | Card voltage through NVAPI (LibreHardwareMonitor reads it) | Series | Nvapi | NotInHeaders | Volts |
| `nvapi.gpu.ram_type` | The card's memory type | MachineFact | Nvapi | NotInHeaders | Text |
**Inside the game: calls the Overlay already hooks**
| Id | What it is | Scope | Source | Reach | Unit |
|---|---|---|---|---|---|
| `sl.dlss.output_size` | The output size the game gave DLSS | SessionFact | Streamline | Game | Text |
| `sl.dlss.presets` | The DLSS model preset per quality mode | SessionFact | Streamline | Game | Table |
| `sl.dlss.hdr_input` | The game told DLSS its colour buffers are HDR | SessionFact | Streamline | Game | Flag |
| `sl.dlss.auto_exposure` | DLSS auto-exposure | SessionFact | Streamline | Game | Flag |
| `sl.dlss.alpha_upscaling` | DLSS upscales the alpha channel | SessionFact | Streamline | Game | Flag |
| `sl.dlss.exposure` | Pre-exposure and exposure scale given to DLSS | SessionFact | Streamline | Game | Table |
| `ffx.upscale.sharpening` | FSR sharpening: on or off, and its strength | SessionFact | FidelityFx | Game | Table |
| `ffx.upscale.jitter` | The largest jitter offset the game gave FSR | SessionFact | FidelityFx | Game | Table |
| `ffx.upscale.exposure` | Pre-exposure given to FSR | SessionFact | FidelityFx | Game | Text |
| `ffx.upscale.depth` | Near and far planes and the range of the field of view given to FSR | SessionFact | FidelityFx | Game | Table |
| `ffx.upscale.flags` | The flags of the game's FSR dispatch | SessionFact | FidelityFx | Game | Text |
| `ffx.upscale.frame_time_delta` | The frame time the game reported to FSR | Series | FidelityFx | Game | Milliseconds |
| `ffx.memory_usage` | FSR's own video memory, when the game asks it | Series | FidelityFx | Game | Mebibytes |
**Inside the game: hooks that are not built**
| Id | What it is | Scope | Source | Reach | Unit |
|---|---|---|---|---|---|
| `sl.constants.jitter` | The jitter offsets the game gave Streamline | SessionFact | Streamline | NewHook | Text |
| `sl.constants.motion_vectors` | Motion-vector scale, and whether they are 3D, dilated, jittered | SessionFact | Streamline | NewHook | Text |
| `sl.constants.depth` | Near and far planes, and whether depth is inverted | SessionFact | Streamline | NewHook | Text |
| `sl.constants.projection` | Field of view, aspect ratio, orthographic or not | SessionFact | Streamline | NewHook | Text |
| `sl.constants.resets` | How often the game reset the upscaler's history | SessionFact | Streamline | NewHook | Count |
| `sl.feature.versions` | Each Streamline feature's version and its NGX model version | SessionFact | Streamline | NewHook | Table |
| `sl.feature.requirements` | What each Streamline feature requires: operating system, driver, buffers | SessionFact | Streamline | NewHook | Table |
| `sl.init.preferences` | The preferences the game started Streamline with | SessionFact | Streamline | NewHook | Text |
| `ffx.framegen.config` | The game's FSR frame-generation configuration | SessionFact | FidelityFx | NewHook | Text |
| `sl.constants.camera` | Camera position, axes and matrices | SessionFact | Streamline | PlayerState | Text |
**Inside the game: routes a spike decides**
| Id | What it is | Scope | Source | Reach | Unit |
|---|---|---|---|---|---|
| `nvapi.reflex.mode` | Reflex: low-latency mode, boost, the frame-rate limit | SessionFact | Nvapi | Spike | Text |
| `nvapi.reflex.sleep_status` | What the driver's low-latency state is | SessionFact | Nvapi | Spike | Text |
| `nvapi.reflex.frame_report` | Latency per frame: simulation, render submit, present, driver, OS queue, GPU render | Series, one per device | Nvapi | Spike | Microseconds |
| `sl.dlss.optimal_settings` | The render size and sharpness DLSS recommends | SessionFact | Streamline | Spike | Text |
| `sl.dlss.vram_estimate` | DLSS's own estimate of its video memory | Series | Streamline | Spike | Mebibytes |
| `sl.dlssg.options` | DLSS frame generation: mode, frames to generate | SessionFact | Streamline | Spike | Text |
| `sl.dlssg.state` | DLSS frame generation: status, the most frames it can generate | SessionFact | Streamline | Spike | Text |
| `sl.dlssg.frames_presented` | Frames DLSS frame generation presented, by its own count | Series | Streamline | Spike | Count |
| `sl.dlssg.vram_estimate` | DLSS frame generation's estimate of its video memory | Series | Streamline | Spike | Mebibytes |
| `sl.dlssd.options` | Ray reconstruction's options | SessionFact | Streamline | Spike | Text |
| `sl.nis.options` | NVIDIA Image Scaling's options | SessionFact | Streamline | Spike | Text |
| `sl.deepdvc.options` | RTX Dynamic Vibrance's options | SessionFact | Streamline | Spike | Text |
| `sl.reflex.state` | Reflex through Streamline: availability and its frame reports | SessionFact | Streamline | Spike | Table |
| `sl.pcl.markers` | PC-latency markers the game sets | Series | Streamline | Spike | Count |
**Closed by a licence**
| Id | What it is | Scope | Source | Reach | Unit |
|---|---|---|---|---|---|
| `ngx.parameters` | NGX parameters: the quality value, the DLSS hints | SessionFact | Ngx | Licence | Table |
| `xess.options` | XeSS's options | SessionFact | Xess | Licence | Table |
| `sl.nvperf` | Streamline's performance counters (NSight Perf SDK licence) | Series | Streamline | Licence | Table |
+1 -1
View File
@@ -1027,7 +1027,7 @@ injected or layered**.
If `OpenProcess` with the needed rights fails (protected process, higher integrity), do **not** escalate creatively. Report "cannot attach" and offer Tier-2. Never attempt to acquire privileges beyond running the Agent elevated at the user's explicit request.
> **The explicit request exists since beta.10 (owner decision D34, 2026-09-27): the admin mode.** An option off by default,
> turned on through a versioned disclosure (`Safety_AdminMode_*`, `agent-admin-dialog/2` *(`/1` until 2026-11-11, when Advanced metrics widened what the option adds — D101)*) that states what it adds, what it
> turned on through a versioned disclosure (`Safety_AdminMode_*`, `agent-admin-dialog/1`) that states what it adds, what it
> does not change, how Windows asks and the risk of a per-user install; then **Windows asks at every start of the Agent**
> (`01_ARCHITECTURE` ADR-9). What it does NOT do, each held by code rather than by this paragraph:
>
-5
View File
@@ -1860,11 +1860,6 @@ Moved verbatim, in this order.
| M9 ✅ | **Closed 2026-08-02 by a decision.** The old file/module detection does not exist in this repository and the owner confirmed there is no copy elsewhere, so **"build a minimal static-hint detector as the measurement baseline" is now P0 item 3** (`15_ROADMAP`). It needs no guard and no injection. Until it exists, ADR-7's headline claim stays out of the README rather than being asserted unmeasured |
| M10 ❓ | **§CPU — is the CPU temperature this build reads the right sensor, and does it read at all on the owner's machine?** `LhmCpuTemperatureReader` (2026-09-21) opens a CPU-only LibreHardwareMonitor `Computer` when the Agent is elevated AND `PawnIo.IsInstalled`, takes the package sensor (`CPU Package` / `Core (Tctl/Tdie)`) and falls back to the hottest core. It was written against LHM's sensor names and a fake `ILhmComputer`; **no elevated run with PawnIO has been taken.** | **The measurement is one session:** Agent elevated, PawnIO installed, a five-minute capture with HWiNFO or Ryzen Master open beside it. Pre-committed: `max_cpu_temp` within 3 °C of the reference's package peak → keep; a core sensor picked where a package sensor exists, or a reading tens of degrees off (a distance-to-TjMax sensor mistaken for a temperature) → fix `Pick` and re-run; nothing read at all → `cpu_temp` stays N/A and `legal/ACCURACY.md` says processor temperature is not measured. CPU **load** and memory are not in question: `TheRealCountersAnswerOnThisMachine` reads them on every gate run. |
| M11 🅓 | **The game's VRAM budget and `budget_exceeded_pct` (FR-4.5's second half), 2026-10-03.** D43 reads the game's usage from outside (the `GPU Process Memory` counters); the budget the OS grants the process is what DXGI's `QueryVideoMemoryInfo` returns to the *calling* process (§M7), so only an in-process call — the Overlay's background thread, which today only checks for a stop — or `D3DKMTQueryStatistics`' `PROCESS_SEGMENT_GROUP` query (documented "Reserved for system use") could read it. **Deferred by decision:** neither is built; `vram_budget_exceeded_pct` stays NULL and the budget N/A, and the in-process route would change what the Disclaimer says the Overlay's thread does. Reopening it needs that decision, not a measurement. | — |
| M12 ❓ | **Advanced metrics — which NVAPI rows answer on real hardware (D101, 2026-11-11).** `18_GPU_VENDOR_APIS` §The inventory lists sixty `nvapi.` rows whose reach is `Agent`. They are declared in the vendored headers; **none has been called on a GPU**, and CI has no driver, so it never takes that branch. Unknown per row: whether the RTX 5080 on the current driver answers or returns `NVAPI_NOT_SUPPORTED` (the memory-temperature target already does not exist on that card). | **The measurement is the bridge's probe on the owner's PC**, then the page itself (the release's owner-only item). Pre-committed: a call that does not answer → that row is N/A with NVAPI's own status as the reason, and nothing is put in its place; a call that hangs or faults twice → the row is off for the session (§Runtime policy); a value that contradicts the vendor's own tool → the row is withheld until it is explained. **Half answered the same day, by the bridge's own test on the dev box** (ctest `fl_nvapi_bridge`, AVAILABLE branch; RTX 5080): every fact answers (`present = 0xFFFFF`), eight of ten live groups answer (`0x33F` — no board and no power-supply temperature sensor on this card: N/A, by the first pre-committed outcome), the display answers its four groups, the global profile lists 24 settings; figures in `18_GPU_VENDOR_APIS` §L3. **Still open**: the same values on the page beside the vendor's own tool, and the session rows (`nvapi.session.*`), which need a game. **And one thing seen once and not explained**: in one test run of about a dozen that day, `FlNvReadLive` came back with no field at all although `FlNvReadFacts`, a moment earlier in the same process, had answered everything; nine further runs did not show it. A handle the driver invalidated is the usual cause of that shape, and nothing here re-enumerates after `FlNvInit`. Pre-committed for the reader that owns the thread: two readings in a row with no field → release and initialise the bridge again, once, and say so in the log; if that does not bring the fields back the layer is off for the session, as any layer that fails twice is. |
| M13 ❓ | **Advanced metrics — LibreHardwareMonitor's CPU, memory, motherboard and storage groups, elevated, with PawnIO (D103, 2026-11-11).** Never opened by any build: §M10's elevated run has not been taken either, and this is a larger surface — a sensor chip on the LPC bus, the embedded controller, SPD over SMBus, SMART. Unknown: whether each group opens on the owner's board, what a refresh costs, whether opening the storage group touches removable drives (this PC once had a failing USB drive), and whether any group enables a privilege (`PrivilegeFootprintTests`). | **One elevated run with the probe verb, before the option exists.** Pre-committed: the storage group cannot be opened without touching removable drives → `lhm.storage.*` stays N/A in beta.39 and its reach reads `Deferred`; a node that throws twice → skipped for the session; the Agent above 1% of one core or 150 MB with the option on (NFR-2) → the slow groups are read less often or dropped before the release; a privilege enabled by a group → that group is not opened, and the owner is asked. **Two of the four answered 2026-11-11, before the option exists.** (1) **Storage: not opened, by the first outcome.** LibreHardwareMonitor 0.9.6's `StorageGroup` lists every drive through DiskInfoToolkit's `ReloadStorages` with no filter by bus and follows drives plugged in later — it cannot be opened without touching removable drives. `lhm.storage.*` reads `Deferred`, and `LhmGroups` has no member for it. (2) **Cost, unelevated, measured with `probe-advanced`** on the dev box: one refresh of the graphics-card group alone is 14 ms of processor time (62 ms elapsed) — 1.4% of one core at one a second, above NFR-2 — and one NVAPI read 0.4 ms. By the third outcome the sensor library is read every fifth tick (0.28%). **Still open, and the owner's**: the same probe as administrator with PawnIO — whether the processor, memory and motherboard groups open on this board, what they cost, and `PrivilegeFootprintTests`' new case on a token that holds the privileges (CI's does; the dev box's unelevated run passes by construction). **The first run was taken on 2026-11-12, by the owner, in ordinary use** (0.1.0-beta.40, the Agent as administrator with PawnIO, an i7-14700KF on a board with an IT8689E chip, an RTX 5080), and read here from a copy of the ledger and the Agent's log, not from a probe. **The groups open and read**: nine of ten sessions stored 119 processor series (a clock and a load per thread, temperatures, powers, voltages), 14 memory series and 21 motherboard series (six fans, six temperatures, nine voltages) beside the card's 41 — 195 from the sensor library in all. **No value was compared with another tool**; that is still the owner's. **Two faults, one cause** (`Infrastructure.Telemetry.LhmLibrary`): the Agent held up to three `Computer`s at once, and the library keeps the driver it reads the processor through and its bus mutexes per process — closing one `Computer` let go of them under the others. After seven sessions the Advanced reader's processor device threw `NullReferenceException` twice and was left alone (the page lost the processor until the reader reopened); once a session's start met another instance's close, the reader's `Open` threw `ObjectDisposedException`, and that session stored 17 series instead of 212. **Fixed 2026-11-12**: opens and closes are serialised and a `Computer` is parked, not closed, while another is in use. The cause is read from the log's timing and was not reproduced — it needs this elevation — so **whether the faults are gone is the owner's next sessions to show**: no `advanced: a device is left alone` and no `did not open` in the Agent's log. |
| M16 ✅ | **The L2 telemetry layer's cost — the first number, and it is above NFR-2 (found 2026-11-11, measuring something else).** `LhmTelemetrySource` refreshes LibreHardwareMonitor's graphics-card group once a second in every recorded session. `probe-advanced` measured that refresh, through the same library and the same group, at **14 ms of processor time** on the dev box (RTX 5080, 41 mapped sensors, about twenty of them the Direct3D engine nodes the library enumerates per card) — 1.4% of one core, where NFR-2 allows the whole Agent 1% during capture and `14_TESTING` §Hook overhead's Agent figure has never been measured. This is a measurement of the call, not yet of a session: L2's own poller was not instrumented. | **Measure L2 in a session** (the Agent's processor time over a ten-minute capture, telemetry at 1000 ms and at 2000 ms). Pre-committed: at or under 1% → this row closes with the number; above → the owner chooses between a slower default for `telemetry.interval_ms`, reading the sensors the layer keeps from NVAPI on NVIDIA cards (L3 already has most, at 0.4 ms), or amending NFR-2 to what is measured. Not decided here, and nothing about L2 changes in the Advanced-metrics train. **Measured in a real Agent, 2026-11-11 (owner decision D110), and answered (D117).** `tools/agent-cost.ps1` runs the shipped `FrameLedger.Agent.exe --console capture` against a copy of hook-harness in a scratch data folder — a session that is not hooked, so the telemetry poller runs as in every session and nothing drains frames — and reads the Agent process's own processor time at exit; the cost per second is the slope between a 45 s and a 165 s session, two runs of each. Dev box (RTX 5080, not elevated, layers `l1+lhm+nvapi`): **19.3 ms of processor time per second of session = 1.93 % of one core with Advanced metrics off** (2,312 and 2,312 ms over 45 s; 4,594 and 4,656 ms over 165 s), **20.4 ms = 2.04 % with it on** (2,984 and 3,000; 5,547 and 5,344); peak working set 113 MiB and 119 MiB. A first pass with 30 s and 90 s sessions gave 1.56 % and 2.21 % — its two short runs differed by 670 ms, which is why the lengths were raised. So the probe's number holds in a session: the Agent's steady cost is about twice NFR-2's 1 %, nearly all of it the layer every session has always used, and the new option adds about a tenth of a percent. **The owner's answer: NFR-2 is amended to ≤ 2.5 % of one core** — the limit had never been measured, the sensors keep their one reading a second, and nothing in the code changes. Not measured: a hooked session (the drain's cost on top), a session with the Agent elevated and PawnIO's groups open, another PC. |
| M14 ❓ | **Reflex latency per frame — is there a route within rules 4 and 5? (Train C, 2026-11-11.)** `17_HOOK_ENGINE` §Memory / latency names hooks on `NvAPI_D3D_SetSleepMode` / `SetLatencyMarker` and a call to `NvAPI_D3D_GetLatency`. NVAPI resolves all three through `nvapi_QueryInterface` by id — they are not exports, so a hook on them is a patch at an address learned at run time, the class refused on 2026-08-09. The route to try first needs no hook: the Overlay's own background thread **calls** `GetLatency` with the device of the swap chain it already hooks, once a second (the call returns the last 64 frames' reports). Unknown: whether calling into the driver from that thread is safe on every device kind, what it costs, what it returns when the game never enabled Reflex, and what it means for the Disclaimer's sentence about that thread. | **A spike on `hook-harness` and a stub first, then one real title.** Pre-committed: no route without a patch at a run-time address or a loader-lock call on the game's thread → Reflex stays N/A and the page says why; overhead above NFR-1 → the same. The owner says go or no on the spike's result. |
| M15 ❓ | **The Streamline state behind `slGetFeatureFunction` — re-examined, not reopened (Train D, 2026-11-11).** The owner asked for the refusal in `handoff/history/p0-queue-1-6.md` to be looked at again. `18_GPU_VENDOR_APIS` §The trains states the route to try (hook the export, hand back a wrapper for a fixed list of names) and what it raises: the wrapper is a write to what the game receives, which rule 4 forbids as written; a wrapper must outlive the Overlay's unhook; a game that fetched its functions before the hook existed is never seen. | **A written design against each of the five grounds, then a spike.** Pre-committed: any ground unanswered → the route stays refused, and `sl.dlssg.*`, `sl.reflex.*` and the rest of that block read N/A with "refused" as the reason. Proceeding needs the owner's amendment of rule 4, asked with the rule quoted. |
| M10 ✅ | ~~PDH `\GPU Engine(*)\Utilization Percentage` summed across engines does not reproduce the Task Manager figure the doc invokes. Decide what we actually report and label it accordingly~~ **Decided 2026-09-09 (PR-E1): L1 does not read the engine counters at all.** `LoadPct` is L2's vendor-reported `GPU Core` load (measured ✓ on NVIDIA, §M5 row R1) and is labelled *GPU load (vendor)* wherever it is shown; on a machine without L2 the field is N/A, never a sum that is not the number the user expects. What L1 does read from PDH is one counter, `\GPU Adapter Memory(luid_…_phys_0)\Dedicated Usage`, bound by LUID — the figure Task Manager labels "Dedicated GPU memory", measured 1301 MB at an idle desktop on the RTX 5080. Reopening this needs a measurement of `max(engine)` against Task Manager's own number, not a decision |
#### §M5 — the decision table, pre-committed 2026-09-03 BEFORE the first run
+86 -151
View File
@@ -76,10 +76,6 @@ owner-only items stay below; the history of every train, the passed owner-only i
| `§beta.34` | [`handoff/history/0.1.0-beta.34.md`](handoff/history/0.1.0-beta.34.md) |
| `§beta.35` | [`handoff/history/0.1.0-beta.35.md`](handoff/history/0.1.0-beta.35.md) |
| `§beta.36` | [`handoff/history/0.1.0-beta.36.md`](handoff/history/0.1.0-beta.36.md) |
| `§beta.37` | [`handoff/history/0.1.0-beta.37.md`](handoff/history/0.1.0-beta.37.md) |
| `§beta.38`, `§NEXT` (the owner's request of 2026-11-11, the four trains) | [`handoff/history/0.1.0-beta.38.md`](handoff/history/0.1.0-beta.38.md) |
| `§beta.39`, train B's plan as approved (its `§NEXT`) | [`handoff/history/0.1.0-beta.39.md`](handoff/history/0.1.0-beta.39.md) |
| `§beta.40`, what the owner's first sessions with it showed, train B's traps | [`handoff/history/0.1.0-beta.40.md`](handoff/history/0.1.0-beta.40.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) |
@@ -87,75 +83,100 @@ owner-only items stay below; the history of every train, the passed owner-only i
---
## **START HERE** — 2026-11-12, 0.1.0-beta.41: one fix — the sensor library is no longer closed under its other users
## **START HERE** — 2026-11-11, 0.1.0-beta.37: the main line on .NET 11, what an alpha is now, and why no C# 15 yet
*Status is `docs/changelog/0.1.0-beta.41.md`; this is what no other file carries.* 0.1.0-beta.40 was released in the
small hours of 2026-11-12 and the owner ran it that same night on eight games, as administrator with PawnIO — the
first elevated run there has been. A copy of the ledger and the Agent's log showed the in-game readings working
(Lies of P, the first real game read) and **a defect of train A that only that elevation can show**: three
LibreHardwareMonitor `Computer`s in one Agent, and the library's per-process state closed by one under the others.
This release is that fix and nothing else: #400 (0.1.0-beta.40's release facts; two comparisons SonarCloud flagged),
#401 (`LhmLibrary`), and this one. **Everything about train B — what was built, what the owner's sessions showed,
the traps — is [`handoff/history/0.1.0-beta.40.md`](handoff/history/0.1.0-beta.40.md)**; the fix is
[`18_GPU_VENDOR_APIS.md`](18_GPU_VENDOR_APIS.md) §Advanced metrics and [`20_OPEN_QUESTIONS.md`](20_OPEN_QUESTIONS.md)
§M13.
*Status is `docs/changelog/0.1.0-beta.37.md`; this is what no other file carries.* The owner, with two screenshots — a
Qodana Ultimate licence in the JetBrains console, and the Qodana Cloud project's setup page: "Bạn có thể bắt đầu với phiên
cải tiến cho .net 11 và set up cho qodana cho tất cả ngôn ngữ (gói ultimate) nhé." The session D92 had left for after
.NET 11's release (2026-11-10), and Qodana for every language on the Ultimate licence. One plan, approved whole, in
three parts: **beta.37** (#376 the move, #379 what an alpha is, #380 .NET 11's API and the C# 15 finding, and this
release) → **alpha.4** → **Qodana Ultimate in two reports**. This section is the first part; the other two follow it on
`main` the same way.
### What this release decided
**Decisions (asked while planning, do not re-ask):**
- **D118 — the fix is released at once as 0.1.0-beta.41, and train B's numbers move by one.** D113 had named
beta.41 for the train's second release. Told so, the owner chose to release the fix now. The train's second
release is **beta.42**, its third **beta.43**, train C **beta.44**, train D **beta.45**. Released changelogs and
moved HANDOFF sections keep the numbers of their day; so do the comments in `fl_shm.h` and `ShmLayout.cs` (the
members "0.1.0-beta.41" and "beta.42" fill), **deliberately**: touching them would have changed source that is
loaded into a game in a release that says the game-side code is beta.40's line for line. The release that fills
a member rewrites its comment.
- **The reads of the sensor library are not put under one lock**, only its opens and closes. A lock around every
read would have put a session's once-a-second poll behind the Advanced reader's, undoing the separate threads
that keep a hanging sensor from holding up the other reader.
- **D94 — the main line moves to .NET 11 now.** Asked whether the betas move or only alpha.4 — with
`20_OPEN_QUESTIONS` §G's table quoted: two alphas on the released runtime and an owner's run of a hooked title first —
the owner chose "Chuyển main sang .NET 11 ngay". Condition (a) of that table was **set aside, not met**;
`12_BUILD` §The main line's .NET says what stood in for it, and owner-only item 34 is the run it asked for.
- **D95 — Windows 10 22H2 is not blocked, and is stated as untested and unsupported** ("Vẫn chạy, ghi rõ không được hỗ
trợ"). NFR-8 is amended; a processor needs SSE4.2 and POPCNT.
- **D96 — C# 15 in the same release** ("Áp dụng cả C# 15 ngay trong beta.37"). The plan narrowed it in writing, and was
approved with that: a construct only where the build, CodeQL and Qodana all read it.
- **D97 — all three legal texts reworded** ("Sửa cả ba văn bản"): EULA 1.7, Disclaimer 2.14, Alpha notice 1.1. Their
text was in the plan and approved with it.
- **D98 — alpha.4, then the alpha line rests** until a newer .NET has a preview ("alpha.4 rồi nghỉ tới .NET 12
Preview").
- **The order**: beta.37 → alpha.4 first, Qodana after; and Qodana in **two reports from the start** (the third part's
decision, D99).
### NEXT
**Choices made here:**
1. **The owner runs item 39** (this fix, on the PC that showed the fault) **and the rest of item 38** (an FSR 3.1+
title; two sessions of one running game; the cost; the values of Lies of P against the game's own settings).
2. **0.1.0-beta.42 — train B's second release — when the owner says item 38 passed**: `slSetConstants` and
`ffxConfigure`. A plan of its own first. What it must settle, beside what
[`handoff/history/0.1.0-beta.40.md`](handoff/history/0.1.0-beta.40.md) §NEXT lists (`kMaxPatches = 48`, the window
of `sl::Constants` pinned outside the camera members, the per-call overhead, the gate's list for the two new
structs):
- **`FLT_MAX` in an FSR depth plane.** Lies of P gave `cameraFar = 10` and no `cameraNear`; most likely the
plane at infinity is `FLT_MAX`, which the Overlay refuses as "nobody set this". Decide whether it is stored as
"infinite" — an Overlay change, with its overhead stated.
- **Valor Mortis.** One exit by access violation 51 seconds after injection under beta.40, none under an earlier
build, not attributed. Its crash count is 1; a second such end switches its hooking off. Before adding a hook
to that game's process, ask the owner whether it happened again.
- **The release numbers in the comments** of `fl_shm.h`, `ShmLayout.cs`, `hook-harness` and `guard_test.cpp` for
the members that release fills (D118).
3. **0.1.0-beta.43 — the third — when the owner says the one before passed**: `slGetFeatureVersion` and
`slGetFeatureRequirements`.
4. **Trains C and D** (beta.44, beta.45) each begin with a spike and end in the owner's go or no.
- **No C# 15 construct is used, although the owner asked for them.** The rule decided it, not a preference:
ReSharper's engine, which Qodana runs, reads none of the four (`13_CI_CD` §C# 15 and the analyses, `spike-notes`
§29). Unions would not have been the form in any case — the SDK's own CA1815 asks every union to hand-write its
equality, and the shapes that wanted one are closed record hierarchies. What the release takes is API.
- **.NET 11's `IHost.RunAsync` is accepted, not wrapped**: a failed background service now ends the Agent through its
crash report. A catch there would hide a fault, and could not reproduce .NET 10's exit exactly either.
- **A resting alpha says so in the build, not only in its notes**: the anti-cheat list reaches a user only inside a
release, so an alpha nobody updates carries an ageing one. `FlAlphaLineRests` is stamped on both lines; the `alpha`
branch sets it to false when it next tries a .NET.
- **"A prerelease .NET" is said only by a build that runs on one**, read from the runtime's own description — the next
preview alpha says it again with no change to the code.
- **`release.yml` names the .NET 10 runtime `vpk` needs**, rather than relying on the hosted image carrying one.
- **The Community Qodana job was kept alive across the move** by installing the SDK into its container — an interim;
the Ultimate linter replaces the job in the third part.
- **The 2026-10-31 forms stay where they read as well** (`json.AsSpan().TrimStart().StartsWith('[')` avoids a string):
.NET 11's `char` overloads replaced a span only where the span was there for .NET 10's sake.
### Left open by this session
**Measured on the way** (`spike-notes` §28 and §29): the gate on SDK 11.0.100 — two analyzer sites beyond RC3's
twenty-one, both in tests written after the last alpha; `IHost.RunAsync` rethrowing, observed for the first time; the
first delta across two runtime majors (372 of 443 files patched, 72.6 MB on the rehearsal); `main`'s first full CodeQL
C# analysis on `net11.0` (1,221 of 1,221 files, the same 23 unresolved `Windows.Win32` types as on .NET 10); the
SonarScanner 12.0.0 on the 11.0 runtime; InspectCode 2026.2.3.1 and 2026.3.0 against each C# 15 construct.
- ~~**This release's own facts** — the tag's run, the digests, the delta — are not in any file yet: the release is cut
after this text. Record them in the next pull request.~~ **Recorded 2026-11-12: 0.1.0-beta.41 was released
2026-11-11T22:38:39Z** (05:38 on the 12th in the owner's time zone) from the signed tag on `a6b95e8` (#402), by
run 43111028661 — green at the first attempt, one run for the one tag push. Eight assets; the seven digests of
`SHA256SUMS.txt` equal the ones GitHub computed; the shipped natives carry `FL_BUILD_ID v0.1.0-beta.41`. The delta
from beta.40 is 807,692 bytes beside a full package of 110,708,416 — "Delta processed 0452 files. 0022 patched,
0430 unchanged". The wiki was published by run 43113525941. The rehearsal on the release branch (run 43108189693)
had made a delta of 841,038 bytes with the same file counts.
- **The fix has not been seen to work.** It was written from the log's timing; the fault needs an elevated Agent with
PawnIO. Item 39 is the check, and `20_OPEN_QUESTIONS` §M13 stays open until then.
- **`LIMITATIONS.md` and the accuracy statement still say the processor's, the memory's and the motherboard's
sensors "have never been read on real hardware".** They have been read on one PC and compared with nothing. The
owner's to reword.
- **SonarCloud's `csharpsquid:S3869` on `ParentDump.cs`** is open on `main` until the owner accepts it again (item 38
(j); the owner said on 2026-11-12 that they will). Until then `main`'s `sonarcloud` job is red on that one line.
- **Items 36 (d) (`LogNoteW`) and 37 are still open**; the ledger shows part of 37 (e) happened — the elevated
groups opened and read — and nothing of it was compared with another tool. The alpha line still rests (D98).
**Traps met on the way:**
- **A pull request's CodeQL C# run is an overlay analysis**: it extracts the changed files on top of `main`'s cached
database, and its "scanned N out of N" is `main`'s baseline. #376 wrote "CodeQL reads `net11.0` whole" from one and
was corrected, dated, two pull requests later with `main`'s own run. For anything the extractor has not met, dispatch
`codeql.yml` on the branch (it takes `workflow_dispatch` since #380).
- **`ShmDrainIntegrationTests.TheGuardInjectsTheOverlayAndTheReaderDrainsRealFrames` failed once on the dev box** —
"our own harness must not start matching the blocklist mid-run": the guard's re-scan refused the harness in one gate
run of five. The class passed three times in a row straight after and no guard code had changed; not looked into.
- **A wiki page names no version** (`wiki-check`): "since 0.1.0-alpha.4" in `wiki/Releasing.md` was red. The guide's
pages may.
- **The runner queue**: with three workflows per pull request and a probe's pull request open beside the train,
`check` waited about 25 minutes for a runner. Cancel a probe's runs once it has told what it can.
- **A Bash heredoc halves the backslashes** of an inline Python regex — write the script with the Write tool.
- **`x.Should().NotBeNull(); x!.Member`**: ReSharper reads the `!` as redundant (Qodana's one finding on #376) and the
compiler wants it. Keep the value the assertion needs, not the object.
- **CA2025** on a lambda that captures a `using` variable in a test: await inside a `try`, assert after.
- **A local gate reseeds `%LOCALAPPDATA%\FrameLedger\rules`** while the owner's installed copy runs beside it: the
files were hashed before and after every gate (identical each time — the repository's rules were the installed ones).
**Owner-only:** item 34 — beta.37 on real hardware, a hooked session on .NET 11.0.0, and Windows 10 if a PC with it is
at hand.
### 0.1.0-alpha.4 — the fourth alpha, the same day, and the last for now (D98)
`alpha` takes main at this pull request — `v0.1.0-beta.37` and these notes, no other change — by a merge commit. **This
sync is not like the three before it**: main now holds what the switch held (`global.json`, the TFM, the three
packages, `legal/licenses/nuget/`, the *Transitive* row), so every switch file conflicts, and each is resolved by
taking main's — the branch's RC3 lines go, `RELEASE_LINE` stays `alpha`, and `git diff --name-only origin/main` on the
merged tree must print that one name. Its gate must pass on `alpha` before the pull request is merged by hand (the
branch has no auto-merge); the release runs from the signed tag `v0.1.0-alpha.4` on `alpha`, with its delta from
alpha.3. Its notes are `docs/changelog/0.1.0-alpha.4.md`: the warning, and that it is the last alpha for now.
- **After it the line rests** (`12_BUILD` §The alpha line): no sync follows a beta and no alpha is cut until a newer
.NET has a preview. `FlAlphaLineRests` in `Directory.Build.props` says so to the build; the next trial sets it to
`false` on `alpha` with the rest of the switch.
- **What a resting alpha costs its user** is in its notes, the guide and its banner: no update, the anti-cheat list
included; and once ten betas have followed it, a copy of alpha.3 or older no longer finds alpha.4 (Velopack reads
the newest ten releases).
**Owner-only:** item 35 — the fourth alpha on real hardware, and the beta installed over it.
**Owner-only:** item 39 — beta.41 on the PC that showed the fault: several sessions as administrator with PawnIO,
the Advanced page open and closed between them, and the Agent's log afterwards.
## Owner-only — no PR can close these
@@ -429,72 +450,6 @@ the Advanced page open and closed between them, and the Agent's log afterwards.
experimental-build warning — and Help ▸ About reads *Alpha build — runs on .NET 11.0.0*, with no "prerelease".
(d) **Then install beta.37 over it**: the installer asks to replace it; the beta opens the ledger, shows no Alpha
notice, and its update channel is no longer locked.
36. **beta.38, and the two Qodana reports** (D99, D100). (a) **The update from beta.37**: Help ▸ Check for updates
offers beta.38 — a small download — and *Restart to update* installs it; no terms window. (b) **Links still open**:
the documentation from the Help menu, a document's page on GitHub from its window, a link inside the user guide
and inside the update notes, and the source link in Help ▸ About each open in the browser, as before. (c) **Qodana Cloud**: the projects `frameledger` and
`frameledger-cpp` each show a report from `main` with no problem. A job's log says *Qodana license plan: Ultimate*
and the day the subscription is active until; when it lapses both jobs go red — advisory, never a blocked merge —
and `qodana.yaml` says the way back. (d) **`LogNoteW`**: the Overlay has one function nothing calls
(`src/native/FrameLedger.Overlay/src/dllmain.cpp`). Say whether it is removed — a pull request of its own, eleven
lines — or kept; either way the `.editorconfig` section that names it is then removed or reworded.
37. **beta.39, Advanced metrics on real hardware** (D101–D109). (a) **The update from beta.38**: the terms window
shows the **Privacy Policy 2.15** and the **Disclaimer 2.15** once; the ledger moves to schema 23 and every
earlier session opens as before. (b) **The switch**: Settings ▸ Recording ▸ *Advanced metrics* on — **Advanced**
appears as the last item on the left at once, **Ctrl+6** opens it; off — it goes, and Ctrl+6 does nothing.
(c) **This PC, on the RTX 5080**: the facts (firmware, cores, memory sizes, the display's HDR and variable
refresh), the *Right now* table beside the NVIDIA app or HWiNFO — the first comparison of any of these values
with another tool — and the chart moving; a fan's *Read at* a few seconds behind the memory's. Leave the page: the
Agent's log says the reader closes some fifteen seconds later, and opens again when the page does. (d) **A
session with a real game, the option on**: it is on *Session* with its statistics and its chart; its summary has
**Advanced metrics…** and the button opens it there; *variable refresh was active* and the colour space against
what the game and the display really did; the driver's settings for the game against the NVIDIA app. A session
recorded with the option off is not on the list. (e) **As administrator, with PawnIO installed** — the first run
there has ever been (`20_OPEN_QUESTIONS` §M10, §M13): the processor per core, the memory and the motherboard's
sensors appear on *This PC* and *Sources* says *Read*; watch for a pause or a hang when the page first opens,
and compare a few values with HWiNFO. Without it, *Sources* gives the reason in words. (f) **What it costs**: the
Agent's processor time and memory during a session with the option on and with it off (NFR-2: ~~1 %~~ 2.5 % of one
core since D117, 150 MB) — ~~and with that in hand, the answer to §M16~~ §M16 was measured without a game and
answered on 2026-11-11; what is left for a real game is the hooked session and the elevated one. (g) **The words**: the `vi` strings read as a Vietnamese
speaker would write them; the `ja` strings marked `review`. (h) **A copy of the ledger** (`--data-dir`) that holds
such a session: the page is there, opens on *Session*, and *This PC* says it is a copy.
38. **beta.40, Advanced metrics inside a real game** (D111–D116; train B's first release — beta.41 is not begun
until this passes). (a) **The update from beta.39**: the terms window shows the **Privacy Policy 2.16** once, and
not the Disclaimer; a game that was **running across the update** is refused until it is restarted, with the
reason, and measured normally after. (b) **The option off, a hooked game that uses DLSS or FSR**: the game runs
and is measured as in beta.39; the session is not on the Advanced page's list; nothing in the Agent's or the
Overlay's log mentions the upscaler's options. (c) **The option on, a title that upscales through FSR 3.1 or
later** (AMD's `amd_fidelityfx_*.dll` in its folder; a title on the older FSR 3.0 interface, such as one that
ships `ffx_fsr3_x64.dll` alone, is expected to show none): on *Session*, under Upscaling, sharpening on or off
and its strength against the game's own setting; the field of view as a range, against the game's slider (it is
the **vertical** angle, in radians with degrees beside it) — and wider after zooming or aiming; the near and far
planes; the flags; the chart of the frame time the game reported beside the session's own frame time; FSR's
memory only if the game asks for it. (d) **The option on, a DLSS title**: most are expected to say *the game made
none of the calls these are read from*. If one shows rows, this is the first sight of them anywhere: the output
size against the display resolution, the preset letters against the NVIDIA app's override or the DLSS
indicator, HDR input against the game's HDR setting. Write down which title did. (e) **The sentence under the
session** says which of the three it was, and the session's summary still names the upscaler and its quality as
before. (f) **Two sessions of one game that kept running**, both with the option on: the second one's field-of-
view range and counts are its own, not the first one's carried over. (g) **A game under the user-mode anti-cheat
exception**, the option on: it runs, the session is hooked, and its trial is not ended by anything new. (h) **What
it costs**: the game's own frame rate with the option on and off, and the Agent's processor time in a hooked
session (NFR-2: 2.5 % of one core). (i) **The words**: the fourteen new `vi` strings and the Settings text; the
`ja` ones are marked `review`. (j) **SonarCloud**: accept `csharpsquid:S3869` on
`src/FrameLedger.Infrastructure/Diagnostics/ParentDump.cs` again — the same call the acceptance of beta.24 covers,
raised anew because #398 moved it (`13_CI_CD` §SonarCloud says why it is safe); until then `main`'s reliability
rating on new code shows E for that one line.
39. **beta.41, the sensor library on the PC that showed the fault** (D118; `20_OPEN_QUESTIONS` §M13). (a) **The
update from beta.40**: no terms window, the ledger opens as before; a game running across the update is refused
until restarted, as after every update. (b) **As administrator with PawnIO, Advanced metrics on**: five or more
sessions of different games, some with the Advanced page left open on *This PC* throughout, some with it closed,
one started within a few seconds of another ending. **Afterwards the Agent's log (Logs page, or
`agent-<date>.log`) holds no `advanced: a device is left alone` and no `advanced: the sensor library did not
open`**, and every one of those sessions has its processor, memory and motherboard readings on *Session* (about
two hundred series; a session with seventeen is the fault). (c) **The page after a session ends**: the
processor's rows on *This PC* are still there and still moving, without reopening the page. (d) **Not as
administrator**: nothing differs from beta.40 — the card's sensors and the driver's figures, and *Sources* says
why the rest is not read. (e) While there, the part of item 37 (e) nobody has done: a few of the processor's and
the motherboard's values beside HWiNFO.
**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 —
@@ -607,26 +562,6 @@ Where each owner decision is recorded — the file and its section, and a label
| D96 | [`13_CI_CD.md`](13_CI_CD.md) §C# 15 and the analyses | C# 15 on the main line from beta.37, a construct only where the build, CodeQL and Qodana read it — none of the four yet (Qodana's engine reads none, 2026-11-11), so beta.37 takes .NET 11's API and no syntax; no preview feature |
| D97 | [`../legal/ALPHA_NOTICE.md`](../legal/ALPHA_NOTICE.md) | an alpha is "a beta's source built to try a newer version of .NET, at times a prerelease one": EULA 1.7, Disclaimer 2.14 (with a paragraph on Windows and the processor), Alpha notice 1.1, approved with the plan; the App says "a prerelease .NET" only where the runtime is one |
| D98 | [`12_BUILD.md`](12_BUILD.md) §The alpha line | alpha.4 is beta.37's source on .NET 11.0.0, and then the alpha line rests until a newer .NET has a preview; a resting alpha tells its user to install the beta |
| D99 | [`13_CI_CD.md`](13_CI_CD.md) §Qodana | Qodana for .NET on the Ultimate licence, in two reports from the start: the managed code to the Qodana Cloud project `frameledger`, the C++ to `frameledger-cpp` |
| D100 | [`13_CI_CD.md`](13_CI_CD.md) §Qodana | an inspection is switched off where the engine that raised it reads — ReSharper's in `.editorconfig`, the rest in `qodana.yaml` (amends D93); hints are off as a severity; in code loaded into a game only defects are fixed |
| D101 | [`18_GPU_VENDOR_APIS.md`](18_GPU_VENDOR_APIS.md) §Advanced metrics | "Thông số nâng cao" — Advanced metrics: the option `telemetry.advanced`, off by default, and off means nothing more is read or stored and the navigation item is hidden; everything reachable inside a game follows in stages, four trains A–D |
| D102 | [`18_GPU_VENDOR_APIS.md`](18_GPU_VENDOR_APIS.md) §Advanced metrics | stored in full with the session, in tables of their own (`machine_profiles`, `session_advanced`, schema 0023) and not in columns of `sessions`; series under `adv.` names with NaN, not −1, for a tick with no reading |
| D103 | [`18_GPU_VENDOR_APIS.md`](18_GPU_VENDOR_APIS.md) §Advanced metrics | LibreHardwareMonitor's CPU, memory, motherboard and storage groups only when the Agent already runs as administrator with PawnIO — the page links to that setting and never asks; power-supply and fan-controller groups refused, battery deferred |
| D104 | [`18_GPU_VENDOR_APIS.md`](18_GPU_VENDOR_APIS.md) §Advanced metrics | identifiers are never read: the card's serial number and unique id, a display's EDID, the list of programs that are encoding |
| D105 | [`18_GPU_VENDOR_APIS.md`](18_GPU_VENDOR_APIS.md) §Advanced metrics | the navigation item is the pane's last; Ctrl+1–5 keep their pages and Ctrl+6 opens it only while the option is on |
| D106 | [`18_GPU_VENDOR_APIS.md`](18_GPU_VENDOR_APIS.md) §Advanced metrics | a `.partial` chunk of an unknown type with a right checksum is skipped, where it ended the read |
| D107 | [`18_GPU_VENDOR_APIS.md`](18_GPU_VENDOR_APIS.md) §Advanced metrics | with no game running the Agent reads sensors only while the page is open |
| D108 | [`18_GPU_VENDOR_APIS.md`](18_GPU_VENDOR_APIS.md) §Advanced metrics | "never call a setter" is a build gate: every `NvAPI_*` call of the bridge is held to a committed list |
| D110 | [`20_OPEN_QUESTIONS.md`](20_OPEN_QUESTIONS.md) §M16 | the L2 telemetry layer's cost is measured in a real Agent before anything is changed (`tools/agent-cost.ps1`); what to do about the number is asked after |
| D117 | [`02_SPEC.md`](02_SPEC.md) NFR-2 | asked with the measurement in hand (1.93 % off, 2.04 % on): NFR-2 is amended to ≤ 2.5 % of one core during capture; the sensors keep one reading a second and no code changes |
| D111 | [`18_GPU_VENDOR_APIS.md`](18_GPU_VENDOR_APIS.md) §Train B | inside the game too, off means nothing more is read: the Overlay reads new fields and installs new hooks only while the Agent's control word says the session records Advanced metrics |
| D112 | [`18_GPU_VENDOR_APIS.md`](18_GPU_VENDOR_APIS.md) §Train B | `slInit` is not hooked in train B; if ever, never `applicationId`, `projectId` or the paths |
| D113 | [`18_GPU_VENDOR_APIS.md`](18_GPU_VENDOR_APIS.md) §Train B | train B is three releases: beta.40 fields of calls already hooked (no new patch site), beta.41 `slSetConstants` + `ffxConfigure`, beta.42 `slGetFeatureVersion` + `slGetFeatureRequirements`; each waits for the owner's run of the one before; C is beta.43, D beta.44 |
| D114 | [`18_GPU_VENDOR_APIS.md`](18_GPU_VENDOR_APIS.md) §Train B | the field of view is stored as a session's range, never as a series |
| D115 | [`17_HOOK_ENGINE.md`](17_HOOK_ENGINE.md) §Which struct version carries which field | a tail member of a vendor struct is read only where the upstream tags prove it is there |
| D116 | [`18_GPU_VENDOR_APIS.md`](18_GPU_VENDOR_APIS.md) §Train B | "never the camera" is a build gate: `tools/overlay-fields-check.ps1` |
| D118 | [`18_GPU_VENDOR_APIS.md`](18_GPU_VENDOR_APIS.md) §Train B | told that the sensor-library fix would take the number D113 gave train B's second release, the owner chose to release it at once as 0.1.0-beta.41: the train's second and third releases are beta.42 and beta.43, train C beta.44, train D beta.45 |
| D109 | [`../legal/DISCLAIMER.md`](../legal/DISCLAIMER.md) §5, §5A | asked on 2026-11-11 with both sentences quoted: the Disclaimer goes to 2.15 with the Privacy Policy — PawnIO and the admin mode are no longer "for the CPU temperature" alone; with Advanced metrics on they also read the processor's, the memory's and the motherboard's sensors. The admin mode's disclosure follows (`agent-admin-dialog/2`) |
---
-69
View File
@@ -1,69 +0,0 @@
<!-- Moved from CHANGELOG.md's [Unreleased] when 0.1.0-beta.38 was cut, 2026-11-11 (D66). CHANGELOG.md lists every release. -->
## [0.1.0-beta.38] - 2026-11-11
**The thirty-eighth pre-release: the App opens web and mail links only.** One small hardening, and nothing else you
see, record or measure changes. The one place in the App that hands a link to Windows now refuses any address that is
not `http`, `https` or `mailto`, where it trusted each caller to have checked — Windows runs whatever it is handed, and
a `file:` address is a program. Every link the App shows already was one of those three, so no link you could click
before stops working. The rest of this release is for developers: Qodana — JetBrains' code analysis — now reads the C#
with its Rider-based linter and, as a second report, the C++. The same unsigned installer: verify its hash against
`SHA256SUMS.txt`, then *More info → Run anyway*.
**Updating from `0.1.0-beta.37`:** 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: the code FrameLedger loads into a game is
0.1.0-beta.37's, line for line.
**No alpha follows this release**: the alpha line rests (`guide/11-alpha-builds.md`).
### Changed
- **Every place that starts a process was read, and the App now opens web and mail links only.** JetBrains' rule for
"a process started with something that is not a literal" reported 35 places — 11 in the product, 24 in tests. Each
was read: what it starts, and where the path and the arguments come from (the table in `docs/13_CI_CD.md` §Qodana).
None takes a value from outside the PC or from a file FrameLedger did not write, except the path and arguments of
the game the user added. One was hardened: `ShellUrlOpener` — what opens a link in the browser or the mail client —
now refuses any address that is not `http`, `https` or `mailto` itself, where it trusted each caller to have
checked; the shell runs whatever it is handed, and a `file:` address is a program. Every caller already passed one
of the project's own pages or a link held to those schemes, so no link you could click before stops working. The
rule stays on: the files its results were read in are listed in `qodana.yaml`, so a new file that starts a
process is reported — by path on the plugin's one inspection, since a rule's own id is honoured nowhere (three
runs measured it). And a test of the repository's own, `ProcessStartSitesTests`, in the gate, fails on a new file
that starts a process, or registers a scheduled task, until it has been read and listed.
- **Qodana for .NET, on the Ultimate licence, reads the managed code** (developers only; owner decisions D99 and D100).
The owner took an Ultimate licence for the Qodana Cloud organisation and asked for Qodana over every language. The
job — `managed`, *Qodana (managed)* in a pull request's checks — now runs Qodana for .NET (Rider's engine) in native
mode on a Windows runner, after a `dotnet build`, where the Community linter ran in a Linux container. Besides the
C#, the XAML and the `.resx` it reads the Markdown and XML around the solution, and JetBrains' security rules read
the C#. Its first run reported 3,953 problems, 3,607 of them **hints** — the level an editor offers without
underlining anything, which the Community linter never reported; hints are off as a severity. Of the 347 left: a vi
or ja string equal to the English one (271) is off in `.editorconfig` for `.resx` files — names, units and format
strings are not translated; two Markdown inspections (table padding, and anchors computed otherwise than GitHub
does) and the application manifest's XML are off in `qodana.yaml`; six results in `PrimaryDisplay.cs` are the
linter's own fault (an internal assertion, in its log) and are excluded for that file; one test expression was
simplified. The gate stays zero problems and the job stays advisory. An inspection is now switched off **where the
engine that raised it reads** — one of ReSharper's in `.editorconfig`, what has no key there in `qodana.yaml` — which
amends D93's "never in `qodana.yaml`" (`docs/13_CI_CD.md` §Qodana). The C++ goes to a second report, the next pull
request's.
- **Qodana reads the C++ too, as a second report** (developers only; owner decision D99). The job `native` has CMake
write a Visual Studio solution for `src/native` (the preset `x64-vs-analysis`; nothing ships from it) and runs
Qodana for .NET over it — ReSharper's C++ inspections and the clang-tidy checks they bundle — with settings of its
own (`qodana-native.yaml`), reporting to a Qodana Cloud project of its own. Its first run reported 4,695 problems,
4,040 of them hints; of the 655 left, 494 are distinct (a file compiled into three targets is reported three
times). Nearly all of them are not faults, and `.editorconfig` now says why in fifty-four lines, each with its
reason: clang's opinion of code that only MSVC builds (`__try`, a function pointer got by name, struct padding);
the engine misreading `std::atomic_ref`, zero-initialised API structures and tests of `constexpr` functions;
proposals to restate working code in a newer idiom; and what a probe or a test does on purpose. Eleven things
were fixed, none changing what a shipped binary does: `std::size` for four hand-written array lengths, two
multiplications done in a narrower type than their result, two unused member functions, an unused type alias, two
unused includes. **In code loaded into a game nothing was changed**: the report found no defect there, and what it
did say about those files is listed in `docs/13_CI_CD.md` §Qodana — among it one function in the Overlay that
nothing calls (`LogNoteW`), which is recorded for the owner and not removed (D100). The gate is zero problems and the job is advisory, like the other.
### Fixed
- **A test that failed on a busy machine** (developers only). `ShmDrainIntegrationTests`' drain under supervision
ended after one guard evaluation whenever the first scan was slow enough for fifty presents to be waiting, and
then failed its own "supervised more than once"; the loop now supervises at least twice whatever the first
drain holds.
-125
View File
@@ -1,125 +0,0 @@
<!-- Moved from CHANGELOG.md's [Unreleased] when 0.1.0-beta.39 was cut, 2026-11-11 (D66). CHANGELOG.md lists every release. -->
## [0.1.0-beta.39] - 2026-11-11
**The thirty-ninth pre-release: Advanced metrics.** A new setting, **off unless you switch it on** — Settings ▸
Recording ▸ *Advanced metrics* — and a page of its own. With it on, the capture agent reads more from the graphics
driver and the hardware sensors during a session and keeps it with the session: the graphics card's memory, load,
clocks, fans, voltages and power in detail; what each display can do with HDR and variable refresh, and what the
game's display did; the driver's settings, global and for the game; and — when the agent runs as administrator with
PawnIO installed — the processor per core, the memory and the motherboard's sensors. The **Advanced** page (the last
item on the left, **Ctrl+6**) shows it under what it belongs to: **This PC**, read only while the page is open and
never stored; **Session**, what one session kept, in tables and a chart; **Sources**, every reading FrameLedger knows
of and, for each one it does not read, why. With the setting off, nothing more is read or stored and the page is not
there. The same unsigned installer: verify its hash against `SHA256SUMS.txt`, then *More info → Run anyway*.
**What it is not, yet.** None of these readings has been checked against another tool. The processor's, the memory's
and the motherboard's sensors have never been read on real hardware — the first run as administrator with PawnIO is
still to come. The driver's own figures exist on NVIDIA cards only, and no AMD or Intel card was tested. A drive's
temperature is not read. Nothing is read inside the game by this release: the readings that need a hook come with
later ones. `LIMITATIONS.md` §Sensors lists every limit.
**Updating from `0.1.0-beta.38`:** Help ▸ Check for updates, then *Restart to update* with no game running. The terms
window shows the **Privacy Policy 2.15** and the **Disclaimer 2.15** once — they name what Advanced metrics reads and
stores, only while it is on, and that PawnIO and the administrator mode then read more than the CPU temperature. The
ledger moves to **schema 23** (two tables are added; nothing that was there changes), so a 0.1.0-beta.38 cannot open
it afterwards. The detection rules stay at `2026.11.2`. With the setting off, nothing about capture or measurement
changes: the code FrameLedger loads into a game — the overlay, the Vulkan layer, the shared-memory layout, the
injector — is 0.1.0-beta.38's, line for line.
*The entries below are in the order the seven pull requests landed. One that says "not yet" describes that pull
request; a later entry is what followed.*
### Added
- **"Advanced metrics" is planned, and its inventory is written — nothing reads it yet.** The owner asked for a
setting, *Thông số nâng cao*, with a navigation item of its own that shows as much as the NVAPI and Streamline
headers and PawnIO make available, each value under what it belongs to: one game session, or the PC. This pull
request is the first of that train and changes nothing you can see or record. It adds the list everything else in
the train reads — `AdvancedMetricCatalog`, 137 entries: what the Agent will read from NVAPI and
LibreHardwareMonitor (the card's firmware, architecture and cores; its memory with evictions and promotions; its
utilisation by domain; what a display can do with HDR and variable refresh; the driver's profile; and, as
administrator with PawnIO, the processor per core, the motherboard, the memory modules and the drives'
temperatures), what can only be read inside a game and waits for a later release, **and what is never read with the
reason** — a serial number, a display's EDID, the list of programs that are encoding, the camera's position, what
a vendor's licence closes. `docs/18_GPU_VENDOR_APIS.md` §Advanced metrics holds the design, the owner's decisions
D101–D108 and the same list as a table; a test fails when the table and the catalog differ in either direction.
- **The NVIDIA bridge can read what Advanced metrics will show — and nothing calls it yet.**
`FrameLedger.NvapiBridge.dll`, the library the Agent loads into its own process and never into a game, gains five
reads (its ABI 3): the card's facts — firmware version, architecture, ray-tracing and tensor core counts, base and
boost clocks, its memory sizes, the driver's package; what it says now — free and used video memory with evictions
and promotions, the frame-buffer, video and bus utilisation, the performance state, the encoder's load; what each
connected display can do with HDR and variable refresh; the state of the display a game presents on; and every
setting of a driver profile. On the development PC's RTX 5080 all twenty facts and eight of the ten live groups
answer — the card has no board or power-supply temperature sensor, so those two will read N/A.
**It reads no identifier**: no serial number, no unique id, no display EDID, and not which programs are encoding.
- **"The bridge never calls a setter" is now a build check.** A new gate, `tools/nvapi-readonly-check.ps1`, compares
every NVAPI call in the bridge's source with a committed list of forty-four reads, in both directions, and refuses a
name that sets, saves, restores, registers or controls something — or returns an identifier — even when someone
adds it to the list.
- **The reader behind Advanced metrics exists, was measured on a real PC, and is still not switched on.** One
reader for the whole Agent, on a thread of its own, that runs only while a session or the page needs it: NVIDIA's
figures every second, and every sensor LibreHardwareMonitor has for the graphics card — each fan and its duty, the
core voltage, PCI Express traffic, the load of every engine. When the Agent runs as administrator with PawnIO
installed it will also read the processor per core, the memory and the motherboard's sensor chip.
**A drive's temperature is not read**: the library cannot list drives without touching removable ones, so that
group is never opened and the value will read N/A with that reason.
- **`FrameLedger.CaptureHost probe-advanced`** (a developer tool, not shipped): runs that reader for a few seconds
on your own rights and prints everything it read and what it cost. On the development PC it read 35 facts and 58
values a second — and showed that one refresh of the sensor library takes 14 ms of processor time, so the reader
refreshes it every five seconds, where NVIDIA's own figures (0.4 ms) stay at one a second.
- **The ledger can hold Advanced metrics — and holds none yet.** Schema 23 adds two tables: one for the facts of
the PC, stored once per distinct set, and one for what a session recorded with the option on knows — its own
facts, which sources answered and why the others did not, and the statistics of its extra series. Nothing is
added to the session row itself, so what the JSON export and a bug bundle carry does not grow. The extra series
are stored beside the others under names of their own, with a real "no reading" for a second in which a sensor
was not read. One hour of them is about 0.2 MB. **A session recorded with the option off stores nothing of this**,
and the option does not exist yet. *A 0.1.0-beta.38 cannot open a ledger a later build has migrated.*
- **Settings ▸ Recording ▸ Advanced metrics — the switch exists, off by default.** On, the capture agent reads more
from the graphics driver and the hardware sensors during a session and stores it with the session: the graphics
card's memory, load, clocks, fans, voltages and power in detail, what each display can do with HDR and variable
refresh and what the game's display did, the driver's settings for the game — and, when the agent runs as
administrator with PawnIO installed, the processor per core, the memory and the motherboard's sensors. **Off,
nothing more is read or stored**, and the shared reader is not even started. It applies from the next session, and
a session recorded while it was off is not filled in later. NVIDIA's figures are read once a second, the sensors
every five. **No page shows what is stored yet** — that is the next pull requests' — and none of it is in an
export or a bug report.
- **The App can ask the agent what this PC reads right now — and no page asks yet.** A new request,
`GetAdvancedMachine`, answers what the agent's shared reader last read: the PC's facts, the newest value of every
series, and which sources answer or why they do not. It never touches a sensor itself, so it cannot hold up the
pipe. Each request also keeps the reader running for five seconds, which is how "with no game running, sensors are
read only while the page is open" works without anything telling the agent that a page closed. With Advanced
metrics off it answers that it is off, and nothing is read. On the App's side `AdvancedMachineFeed` asks once a
second while a page watches it and keeps each value with the moment it was read.
- **The Advanced page.** While Advanced metrics is on, **Advanced** is the last item in the list on the left, and
**Ctrl+6** opens it. **This PC** shows what the graphics driver and the sensors say right now — the card's
firmware, cores and memory, what each display can do, the driver's settings, and every reading with the time it
was read at and a chart of its last five minutes. It is read only while the page is open, and is not stored.
**Session** shows what a session recorded with the option on kept: the PC as it was, what belonged to that session,
the lowest, average and highest of each reading, and a chart over the session. **Sources** lists every reading
FrameLedger knows of and, for each one it does not read, why — the agent is not an administrator, PawnIO is not
installed, it comes with a later release, or it is never read. A session's summary has an **Advanced metrics…**
button that opens that session there. In `en`, `vi` and `ja`; the user guide has a page for it.
- **The terms window shows the Privacy Policy 2.15 and the Disclaimer 2.15 once.** The Privacy Policy names what
Advanced metrics reads and stores, only while it is on, and what it never reads: a serial number, a display's
identification data, a list of other programs. The Disclaimer's two sentences about PawnIO and about running the
agent as administrator said "the CPU temperature"; they now also name the processor's, the memory's and the
motherboard's sensors, read with Advanced metrics on. The same sentence changed in Settings, the first run, the
administrator dialog, the guide and `LIMITATIONS.md`.
### Changed
- **A crash file from a newer build no longer loses its tail in an older one.** The file a session writes as it goes
(so that a crash keeps what was recorded) is made of chunks; a reader that met a chunk of a kind it did not know
stopped there. It now passes over a whole chunk it does not know and reads on.
### Fixed
- **A sentence in the documents that kept a function from being called.** `docs/18_GPU_VENDOR_APIS.md` said the
vendored NVAPI headers do not declare `NvAPI_GPU_GetMemoryInfoEx`. They do — in `nvapi_lite_common.h`, which
`nvapi.h` includes; the search that found nothing had looked in `nvapi.h` alone. The row is corrected, and the
bridge will call it for the advanced memory rows. Nothing about the memory figures FrameLedger shows today changes.
-99
View File
@@ -1,99 +0,0 @@
<!-- Moved from CHANGELOG.md's [Unreleased] when 0.1.0-beta.40 was cut, 2026-11-12 (D66). CHANGELOG.md lists every release. -->
## [0.1.0-beta.40] - 2026-11-12
**The fortieth pre-release: Advanced metrics, inside the game.** With **Advanced metrics** on (Settings ▸ Recording;
off unless you switch it on), a session of a game FrameLedger measures from inside now also keeps **what the game
itself tells its upscaler**: for DLSS the output size, the model preset for each quality mode, whether the game said
its colour buffers are HDR, auto-exposure, alpha upscaling and the exposure values; for FSR the sharpening, the
largest jitter offset, the exposure, the near and far planes, the **range** of the field of view, the flags, the
frame time the game reported and FSR's own video memory when the game asked for it. The **Advanced** page shows them
under the session, in the vendor's own notation, and the session says in a sentence what became of them. With the
setting off nothing more is read inside a game: the component in the game runs the same reads as before, and a test
that injects into a window sending all of it finds the new memory region empty to the last byte. The same unsigned
installer: verify its hash against `SHA256SUMS.txt`, then *More info → Run anyway*.
**What it is not, yet.** **None of this has been read from a real game** — only from the project's own test window.
**Many games will show nothing**: most set their DLSS options through a call FrameLedger cannot intercept, and the
FSR rows need FSR 3.1 or later through AMD's own library (a game that upscales through the older FSR 3.0 interface
shows none). The session then says *the game made none of the calls these are read from* — which never means the
game uses no upscaler; its summary names the upscaler as before. These are the game's words to the upscaler, not a
check of what the upscaler did. **Never read:** where the camera is, which way it looks, its matrices — a build
check refuses those names anywhere in the code loaded into a game. No new hook is installed by this release; two
further steps of this train add hooks, each after this one has been run on real games. `LIMITATIONS.md` §Sensors
lists every limit.
**Updating from `0.1.0-beta.39`:** Help ▸ Check for updates, then *Restart to update* with no game running. The terms
window shows the **Privacy Policy 2.16** once — it names what is stored of the game's upscaler parameters, only with
Advanced metrics on and only for a game FrameLedger injects into, and what is never read. The Disclaimer stays 2.15.
**A game that is running when you update must be restarted before FrameLedger measures it again**: the shared memory
between the game and the agent has a new layout (version 5), and the component inside the game is new. The ledger
stays at schema 23 and the detection rules at `2026.11.2`.
*The entries below are in the order the four pull requests landed. One that says "not yet" describes that pull
request; a later entry is what followed.*
### Added
- **Advanced metrics inside the game is planned — three releases, and nothing reads it yet.** The readings that
exist only inside a game — the options a game gives DLSS and FSR, FSR's own memory, later the constants a game
gives Streamline and its frame-generation configuration — come in three steps (owner decisions D110–D116):
first more fields of calls FrameLedger already intercepts, with no new hook; then two new hooks; then two more.
Each step waits for the one before to be run on real games. With Advanced metrics off, nothing more is read
inside a game either. This pull request changes nothing you can see or record: it records the decisions, and
**which version of each vendor struct carries which field**, compared across every upstream release of Streamline
2.x and of the FidelityFX API — a field is read only where it is proven to be there.
- **`tools/agent-cost.ps1`** (a developer tool): what the shipped capture agent costs while it records, measured on
the real program against the project's own test window, with Advanced metrics off and on.
- **The shared memory between a game and the agent has room for what a game tells its upscaler — and nothing
writes it yet.** Its layout is version 5: one new region, sized once for the three releases of this train, and
one new word by which the agent says "this session records Advanced metrics". With that word at zero — every
session, until the next pull request, and afterwards every session with the option off — the region stays empty and
the component inside the game does exactly what it did before. **A game that is running when you update must be
restarted before FrameLedger measures it again**, as after every update.
- **The component inside a game can read what the game tells its upscaler — and only when asked.** For a game
FrameLedger injects into, and only while the agent asks for it (nothing asks yet: that is the next pull request,
and then only with Advanced metrics on), the calls FrameLedger already intercepts are read a little further: the
options a game hands DLSS with each evaluation (output size, presets, exposure, three switches), what it hands
FSR with each upscale (sharpening, the jitter's size, exposure, the depth range, the field of view as a range,
flags, the frame time it reports), and FSR's own memory when the game itself asks for it. **No new hook**, and
with the request off the same code as before runs: a test injects into a window that sends all of it and finds
the new memory region empty to the last byte. **Never the camera's position, its axes or its matrices** — a
build check now refuses those names anywhere in the code loaded into a game (`tools/overlay-fields-check.ps1`).
Many games set their DLSS options through a call that cannot be intercepted, and will show nothing here.
Measured cost while asked: 22–23 billionths of a second per frame for FSR, 10–12 for DLSS; not measurable when
not asked.
- **A second session of a game that kept running starts its summaries afresh.** The ranges and counts kept inside the
game belong to the session that asked for them: each session asks with a request of its own, and the agent reads
only what answers it.
- **Advanced metrics: what the game tells DLSS and FSR, kept with the session.** With Advanced metrics on, a session
of a game FrameLedger measures from inside now also keeps what the game itself handed to its upscaler: for DLSS the
output size, the model preset for each quality mode, whether the game said its colour buffers are HDR,
auto-exposure, alpha upscaling and the exposure values; for FSR the sharpening, the largest jitter offset, the
exposure, the near and far planes, the **range** of the field of view, the flags, the frame time the game reported
(as a chart) and FSR's own video memory at the moments the game asked. The Advanced page shows them under the
session, in the vendor's own notation. **Many games will show nothing**, and the session says why — most games
set their DLSS options through a call FrameLedger cannot see, and the FSR rows need FSR 3.1 or later through AMD's
library; it never means the game uses no upscaler. **Never read:** where the camera is, which way it looks, its
matrices. With the option off nothing more is read inside a game, exactly as before. Not yet read from a real game.
- **Privacy Policy 2.16** names the above: what is stored, only with the option on and only for a game FrameLedger
injects into, and what is never read. You are shown it once after updating.
### Changed
- **The agent's processor budget says what was measured.** The specification promised that the capture agent uses
at most 1 % of one processor core while recording; nobody had measured it. Measured on the development PC it is
1.93 % — 2.04 % with Advanced metrics on — nearly all of it the once-a-second read of the graphics card's sensors
that every session has always made, and its memory is 113 MiB (119 with the option on) against a limit of 150.
The owner chose to keep the readings and amend the limit: **NFR-2 is now ≤ 2.5 % of one core** (D117). Nothing the
agent does changes.
### Fixed
- **A crash dump is tried up to three times.** When FrameLedger or its agent stops on an error it never expected, a
small helper writes a dump of the program for a bug report - while the program's other threads are still
running. Windows can fail that once when the program changes under it, and one failure used to mean no dump at
all. It is now tried again, twice, a moment apart.
-41
View File
@@ -1,41 +0,0 @@
<!-- Moved from CHANGELOG.md's [Unreleased] when 0.1.0-beta.41 was cut, 2026-11-12 (D66). CHANGELOG.md lists every release. -->
## [0.1.0-beta.41] - 2026-11-12
**The forty-first pre-release: one fix, for Advanced metrics with the agent as administrator.** If you run the
capture agent as administrator with PawnIO installed and have **Advanced metrics** on, 0.1.0-beta.40 and
0.1.0-beta.39, which has the same code and where it was not looked for, could lose sensors: after most sessions the Advanced page stopped showing the processor's readings
until it was reopened, and now and then a whole session was stored with the graphics driver's seventeen readings
and none of the two hundred from the sensor library. The agent was closing the sensor library in one place while
another place was still reading it. It now opens and closes it in one place only, and never while something is
reading. If you do not use that combination, nothing changes for you. The same unsigned installer: verify its hash
against `SHA256SUMS.txt`, then *More info → Run anyway*.
**What it is not, yet.** The fix was made from the agent's log of ten real sessions; the fault needs an
administrator's agent with PawnIO to show, and has not been seen to be gone on such a PC yet. After a few sessions
the agent's log (Logs page) should no longer say *a device is left alone* or *the sensor library did not open*.
Everything 0.1.0-beta.40's notes say is not yet done still stands.
**Updating from `0.1.0-beta.40`:** Help ▸ Check for updates, then *Restart to update* with no game running. No
terms to read again, no change to the ledger (schema 23), the detection rules stay at `2026.11.2`. **The code
FrameLedger loads into a game — the overlay, the Vulkan layer, the shared-memory layout, the injector — is
0.1.0-beta.40's, line for line**; as after every update, a game that was running across it must be restarted
before it is measured again.
**A note on numbers.** The plan for Advanced metrics had named 0.1.0-beta.41 for its next step inside the game (two
new hooks). This fix took the number; that step is now 0.1.0-beta.42, and the ones after it move by one as well.
### Fixed
- **Advanced metrics: the processor's sensors no longer drop out after a session, and a session no longer loses its
sensors at the start.** With the agent running as administrator and PawnIO installed, the sensor library was being
closed by one part of the agent while another part was still reading it. After most sessions the Advanced page
lost the processor's readings until it was reopened, and one session in ten stored only the graphics driver's
seventeen series instead of two hundred and twelve. The agent now opens and closes the sensor library in one
place, and does not close it while anything is still reading. Found in the first sessions recorded that way; the
cause was read from the log and could not be reproduced without that setup, so the next sessions will show
whether it is gone — the agent's log should no longer say *a device is left alone* or *the sensor library did not
open*. Nothing changes in the code loaded into a game.
- **Two comparisons in the Advanced-metrics code say what they mean.** Whether a game gave FSR one field of view or
a range of them was decided by comparing two decimal numbers for equality; it is now decided by comparing the two
stored values bit for bit. Nothing you see changes. (Found by SonarCloud after 0.1.0-beta.40 was merged.)
-205
View File
@@ -1,205 +0,0 @@
# HANDOFF history — 0.1.0-beta.37
*Moved verbatim from `docs/HANDOFF.md` when 0.1.0-beta.38 was cut, 2026-11-11 (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 then.*
## **START HERE** — 2026-11-11, 0.1.0-beta.37: the main line on .NET 11, what an alpha is now, and why no C# 15 yet
*Status is `docs/changelog/0.1.0-beta.37.md`; this is what no other file carries.* The owner, with two screenshots — a
Qodana Ultimate licence in the JetBrains console, and the Qodana Cloud project's setup page: "Bạn có thể bắt đầu với phiên
cải tiến cho .net 11 và set up cho qodana cho tất cả ngôn ngữ (gói ultimate) nhé." The session D92 had left for after
.NET 11's release (2026-11-10), and Qodana for every language on the Ultimate licence. One plan, approved whole, in
three parts: **beta.37** (#376 the move, #379 what an alpha is, #380 .NET 11's API and the C# 15 finding, and this
release) → **alpha.4** → **Qodana Ultimate in two reports**. This section is the first part; the other two follow it on
`main` the same way.
**Decisions (asked while planning, do not re-ask):**
- **D94 — the main line moves to .NET 11 now.** Asked whether the betas move or only alpha.4 — with
`20_OPEN_QUESTIONS` §G's table quoted: two alphas on the released runtime and an owner's run of a hooked title first —
the owner chose "Chuyển main sang .NET 11 ngay". Condition (a) of that table was **set aside, not met**;
`12_BUILD` §The main line's .NET says what stood in for it, and owner-only item 34 is the run it asked for.
- **D95 — Windows 10 22H2 is not blocked, and is stated as untested and unsupported** ("Vẫn chạy, ghi rõ không được hỗ
trợ"). NFR-8 is amended; a processor needs SSE4.2 and POPCNT.
- **D96 — C# 15 in the same release** ("Áp dụng cả C# 15 ngay trong beta.37"). The plan narrowed it in writing, and was
approved with that: a construct only where the build, CodeQL and Qodana all read it.
- **D97 — all three legal texts reworded** ("Sửa cả ba văn bản"): EULA 1.7, Disclaimer 2.14, Alpha notice 1.1. Their
text was in the plan and approved with it.
- **D98 — alpha.4, then the alpha line rests** until a newer .NET has a preview ("alpha.4 rồi nghỉ tới .NET 12
Preview").
- **The order**: beta.37 → alpha.4 first, Qodana after; and Qodana in **two reports from the start** (the third part's
decision, D99).
**Choices made here:**
- **No C# 15 construct is used, although the owner asked for them.** The rule decided it, not a preference:
ReSharper's engine, which Qodana runs, reads none of the four (`13_CI_CD` §C# 15 and the analyses, `spike-notes`
§29). Unions would not have been the form in any case — the SDK's own CA1815 asks every union to hand-write its
equality, and the shapes that wanted one are closed record hierarchies. What the release takes is API.
- **.NET 11's `IHost.RunAsync` is accepted, not wrapped**: a failed background service now ends the Agent through its
crash report. A catch there would hide a fault, and could not reproduce .NET 10's exit exactly either.
- **A resting alpha says so in the build, not only in its notes**: the anti-cheat list reaches a user only inside a
release, so an alpha nobody updates carries an ageing one. `FlAlphaLineRests` is stamped on both lines; the `alpha`
branch sets it to false when it next tries a .NET.
- **"A prerelease .NET" is said only by a build that runs on one**, read from the runtime's own description — the next
preview alpha says it again with no change to the code.
- **`release.yml` names the .NET 10 runtime `vpk` needs**, rather than relying on the hosted image carrying one.
- **The Community Qodana job was kept alive across the move** by installing the SDK into its container — an interim;
the Ultimate linter replaces the job in the third part.
- **The 2026-10-31 forms stay where they read as well** (`json.AsSpan().TrimStart().StartsWith('[')` avoids a string):
.NET 11's `char` overloads replaced a span only where the span was there for .NET 10's sake.
**Measured on the way** (`spike-notes` §28 and §29): the gate on SDK 11.0.100 — two analyzer sites beyond RC3's
twenty-one, both in tests written after the last alpha; `IHost.RunAsync` rethrowing, observed for the first time; the
first delta across two runtime majors (372 of 443 files patched, 72.6 MB on the rehearsal); `main`'s first full CodeQL
C# analysis on `net11.0` (1,221 of 1,221 files, the same 23 unresolved `Windows.Win32` types as on .NET 10); the
SonarScanner 12.0.0 on the 11.0 runtime; InspectCode 2026.2.3.1 and 2026.3.0 against each C# 15 construct.
**Traps met on the way:**
- **A pull request's CodeQL C# run is an overlay analysis**: it extracts the changed files on top of `main`'s cached
database, and its "scanned N out of N" is `main`'s baseline. #376 wrote "CodeQL reads `net11.0` whole" from one and
was corrected, dated, two pull requests later with `main`'s own run. For anything the extractor has not met, dispatch
`codeql.yml` on the branch (it takes `workflow_dispatch` since #380).
- **`ShmDrainIntegrationTests.TheGuardInjectsTheOverlayAndTheReaderDrainsRealFrames` failed once on the dev box** —
"our own harness must not start matching the blocklist mid-run": the guard's re-scan refused the harness in one gate
run of five. The class passed three times in a row straight after and no guard code had changed; not looked into.
- **A wiki page names no version** (`wiki-check`): "since 0.1.0-alpha.4" in `wiki/Releasing.md` was red. The guide's
pages may.
- **The runner queue**: with three workflows per pull request and a probe's pull request open beside the train,
`check` waited about 25 minutes for a runner. Cancel a probe's runs once it has told what it can.
- **A Bash heredoc halves the backslashes** of an inline Python regex — write the script with the Write tool.
- **`x.Should().NotBeNull(); x!.Member`**: ReSharper reads the `!` as redundant (Qodana's one finding on #376) and the
compiler wants it. Keep the value the assertion needs, not the object.
- **CA2025** on a lambda that captures a `using` variable in a test: await inside a `try`, assert after.
- **A local gate reseeds `%LOCALAPPDATA%\FrameLedger\rules`** while the owner's installed copy runs beside it: the
files were hashed before and after every gate (identical each time — the repository's rules were the installed ones).
**The release (the tag, 2026-11-11).** Rehearsed first (`release.yml` dispatched on the release branch, run
42926539241), then the signed tag `v0.1.0-beta.37` on `1a7fbf3`: run 42930394186, published 2026-11-11T00:36:54Z.
Eight assets, the seven listed in `SHA256SUMS.txt` equal to the digests GitHub computed; `FL_BUILD_ID v0.1.0-beta.37`
in the shipped natives. The delta across two major runtimes exists — the stop condition the plan had named: "Delta
processed 0443 files. 0373 patched, 0070 unchanged, 0009 new, 0017 removed", 72,681,960 bytes beside a full package of
110,325,368. The wiki was published by its own run (42932792575).
**Owner-only:** item 34 — beta.37 on real hardware, a hooked session on .NET 11.0.0, and Windows 10 if a PC with it is
at hand.
### 0.1.0-alpha.4 — the fourth alpha, the same day, and the last for now (D98)
`alpha` takes main at this pull request — `v0.1.0-beta.37` and these notes, no other change — by a merge commit. **This
sync is not like the three before it**: main now holds what the switch held (`global.json`, the TFM, the three
packages, `legal/licenses/nuget/`, the *Transitive* row), so every switch file conflicts, and each is resolved by
taking main's — the branch's RC3 lines go, `RELEASE_LINE` stays `alpha`, and `git diff --name-only origin/main` on the
merged tree must print that one name. Its gate must pass on `alpha` before the pull request is merged by hand (the
branch has no auto-merge); the release runs from the signed tag `v0.1.0-alpha.4` on `alpha`, with its delta from
alpha.3. Its notes are `docs/changelog/0.1.0-alpha.4.md`: the warning, and that it is the last alpha for now.
- **After it the line rests** (`12_BUILD` §The alpha line): no sync follows a beta and no alpha is cut until a newer
.NET has a preview. `FlAlphaLineRests` in `Directory.Build.props` says so to the build; the next trial sets it to
`false` on `alpha` with the rest of the switch.
- **What a resting alpha costs its user** is in its notes, the guide and its banner: no update, the anti-cheat list
included; and once ten betas have followed it, a copy of alpha.3 or older no longer finds alpha.4 (Velopack reads
the newest ten releases).
**The sync and the release (2026-11-11).** #382 put the notes on main (`428b723`); #383 merged main into `alpha` by
hand (`134115b`): twenty-seven conflicts, every one resolved to main's side, and `git diff --name-only origin/main
origin/alpha` prints `RELEASE_LINE` alone. Rehearsed on `alpha` (run 42933603983: channel `alpha`, a delta from
alpha.3), then the signed tag `v0.1.0-alpha.4`: run 42935876535, published 2026-11-11T01:16:22Z as *FrameLedger
0.1.0-alpha.4 (experimental alpha)*, a pre-release. Eight assets, seven of seven digests equal; "Delta processed 0448
files. 0369 patched, 0079 unchanged, 0004 new, 0005 removed", 18,207,557 bytes; `FrameLedger.App-alpha-Setup.exe`,
`releases.alpha.json`; the wiki run skipped, as it does for an alpha.
- **One tag push started two release runs** (42935876535 and 42935878584, both `push`, created in the same second;
the tag was pushed once). `release.yml`'s concurrency group made the second wait for the first, and it then began
the whole build again. It was cancelled once the first had published: it could only have ended red, at
`gh release create` on a release that existed. If a tag ever shows two runs, let the first finish, verify the
release, then cancel the other.
**Owner-only:** item 35 — the fourth alpha on real hardware, and the beta installed over it.
### Qodana for .NET on the Ultimate licence — the managed report (D99, D100)
*Status is `docs/13_CI_CD.md` §Qodana and `CHANGELOG.md`; this is what no other file carries.* The third part of the
plan, in two pull requests: this one moves the existing job to Qodana for .NET (Rider's engine, native on a Windows
runner) and settles what it reports over the managed code; the next adds the C++ as a second report.
**Decisions:**
- **D99 — two reports from the start** ("Hai báo cáo ngay từ đầu"). The owner made a second Qodana Cloud project,
`frameledger-cpp`, and the secret `QODANA_TOKEN_NATIVE`; the managed report goes to `frameledger` with
`QODANA_TOKEN`. Both secrets are the owner's; no token was ever read or handled here.
- **D100 — where an inspection is switched off** (the plan's design, approved with it; it amends D93's "never in
`qodana.yaml`"): in the place the engine that raised it reads — one of ReSharper's in `.editorconfig`; what has no
key there in `qodana.yaml`. Hints are off as a severity. In code loaded into a game only defects are fixed.
**Choices made here:**
- **JetBrains' security rules stay on, scoped by path — which took four runs to find.** Every result was read first
(the table in `13_CI_CD` §Qodana), and one place hardened (`ShellUrlOpener` refuses anything but `http`, `https`
and `mailto`). Then the files read had to be told to the linter, and a rule's own id is honoured nowhere:
`ignore`, an `exclude` path and `enabled: false` each left all 36 results standing. The report's own
`log/effective.profile.xml` and `qodana_inspections_summary.csv` gave the answer — one inspection,
`OpenGrepInspection`, produces every rule's results, and it does take a path. Between the third run and the
fourth the rules were written as off, with a test in their place; the test stayed (`ProcessStartSitesTests`, in
the gate, and wider than the rule), the rules came back on.
- **`PrimaryDisplay.cs` was not changed to please the linter.** Its six results come from an internal assertion in
this linter's build (in the job's `backend.log`), not from the file; the first guess — that the engine misreads an
`unsafe` tuple — was wrong, and a rewrite made on it was reverted. Two inspections are excluded for that one file,
to be removed when a linter build reads it.
- **What the Ultimate licence offers and this job does not use**: quick-fixes (the job cannot push, on purpose), code
coverage in Qodana, FlexInspect. If the licence lapses the job is red and advisory; the way back is in `qodana.yaml`.
**Traps:**
- **A security rule's id is not an inspection.** The OpenGrep plugin's rules all report through
`OpenGrepInspection`; only that name works in `qodana.yaml`, and only by path. Read
`log/qodana_inspections_summary.csv` in the report artifact to see which inspection produced a result before
spending a run on a guess.
- **A report artifact is a zip inside the download, with backslash paths**: `unzip` extracts it and exits non-zero
on the warnings, so do not chain on its exit code.
- **A linter result can be the linter's fault**: read the job's log directory (the report artifact carries it) for an
`AssertionException` before changing the code it points at.
- **A Qodana run of the managed job takes fifteen to seventeen minutes**, most of it the scan; a pull request's own run
reads the whole solution (`pr-mode: false`), so there is no quick partial run to iterate on.
**Then:** the native report, in the pull request after it — the next section.
### Qodana — the native report: the C++ through a solution CMake writes (D99, D100)
*Status is `docs/13_CI_CD.md` §Qodana and `CHANGELOG.md`; this is what no other file carries.* The second pull request
of the third part: the job `native`, `qodana-native.yaml`, the preset `x64-vs-analysis`, fifty-four `.editorconfig`
lines for the C++ and eleven small fixes outside code loaded into a game.
**Choices made here:**
- **One linter for both reports.** Qodana for .NET is the only linter of JetBrains' that reads this C++ (MSVC-only;
`qodana-cpp` and `qodana-clang` are Linux images), and it wants a Visual Studio solution — so CMake writes one. The
generated solution is never built from, beyond the one header a build generates.
- **No `.clang-tidy` file.** The plan had expected one. Every clang-tidy check and clang diagnostic the engine runs
has an `.editorconfig` key of ReSharper's, so D100's "where the engine reads" is one file for all of the C++, and
the repository gains no clang-tidy configuration that a developer's editor would start obeying.
- **Most of what it reported is not a fault, and the settings say why, line by line**: clang's opinion of code only
MSVC builds; the engine misreading `atomic_ref`, zero-initialised API structures and constexpr tests; proposals of
a newer idiom. Eleven things were fixed. **In code loaded into a game nothing was changed**: no defect was found
there.
- **`LogNoteW` (`FrameLedger.Overlay/src/dllmain.cpp`) is dead code, and it is still there — the owner's call.**
Nothing calls it. D100 changes code loaded into a game for a defect only, and an unused function is not one, so
it was not removed on a linter's word; `.editorconfig` leaves that one file unread for an unused function, in a
section that says to remove it with the function. Removing it is eleven lines with no caller: a pull request of
its own, whose overhead statement is that the function was never reached.
- **"Possibly unused `#include`" is off, not obeyed.** Ten of the twelve reported outside the game are a file
including what it uses (`<cstring>` for `std::memset`) although `<windows.h>` already brought it; removing them
would have made the files depend on an accident.
**Traps:**
- **InspectCode cannot load the native solution on the owner's PC** (Visual Studio 18 Insiders' MSBuild crashes it,
2026.2.3.1 and 2026.3.0 alike), so C++ results are read from CI: dispatch `qodana.yml` on the branch, download
`qodana-report-native`, unzip the inner `qodana-report.zip`.
- **A file compiled into three targets is reported three times**: count distinct results (rule, file, line), not rows.
- **A shortened line is a clang-format change two lines away**: the gate's clang-format step failed on an alignment
that the edit above it had made possible. Run clang-format on every native file touched before the gate.
- **Do not switch branches while a gate runs** — a probe branch was made during a local native build, which changed
and restored two sources under it. Nothing came of it; the next gate was run on a still tree.
-104
View File
@@ -1,104 +0,0 @@
# HANDOFF history — 0.1.0-beta.38
*Moved verbatim from `docs/HANDOFF.md` when 0.1.0-beta.39 was cut, 2026-11-11 (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 then, and a path it writes is relative to `docs/`.*
## **START HERE** — 2026-11-11, 0.1.0-beta.38: Qodana Ultimate in two reports — and the next work is the owner's "Thông số nâng cao"
*Status is `docs/changelog/0.1.0-beta.38.md`; this is what no other file carries.* This release closes the plan of
2026-11-11 — **beta.37** → **alpha.4** → **Qodana Ultimate in two reports**. The plan was one session's, and its START
HERE was moved whole: all three parts, the decisions D94–D100, the choices and the traps are
[`handoff/history/0.1.0-beta.37.md`](handoff/history/0.1.0-beta.37.md) — the two Qodana sections are its last two.
#384 moved the managed job to Qodana for .NET and settled what it reports; #385 added the C++ as a second report; this
release ships the one change to shipped code that came of it: the App's link opener refuses anything but a web or a
mail address.
### NEXT — the owner's request of 2026-11-11, for the session(s) after this one
Sent while this session was still running, and recorded here as it was written:
> "Xong phiên này, bạn cập nhật (những) phiên tiếp theo với các phiên bản về Setting "Thông số nâng cao" hoặc tương tự
> và hiển thị tại 1 navigation riêng, khai thác số liệu, dữ liệu, biểu đồ mức tối đa, toản bộ mà các header `.h` của
> Streamline và NVAPI hoặc pawnIO có thể sử dụng và hiển thị nhé."
That is: once this session is done, the following session or sessions — and their versions — are about a setting
called *"Thông số nâng cao"* (advanced metrics) or similar, shown in **a navigation item of its own**, that exploits
to the maximum the numbers, the data and the charts that the `.h` headers of **Streamline** and **NVAPI**, or
**PawnIO**, make available.
**Nothing of it was designed or begun here.** It is a new task, and it starts the way every train does — a plan, with
the owner's decisions asked while planning. What follows is this session's reading, not the owner's words:
- **An inventory comes first, from the headers in the tree**: `src/native/third_party/streamline`, `nvapi`,
`fidelityfx`; and what LibreHardwareMonitorLib reads through PawnIO (CPU and board sensors — optional, elevated
only). For each item: what it is, and **where it can be read from** — the Agent's own process (NVAPI through
`FrameLedger.NvapiBridge`, LibreHardwareMonitor) or only inside the game, through a hook (Streamline).
- **Anything read inside a game is a hook**, and the rules that govern hooks are not this feature's to bend: rules 4
and 5, `17_HOOK_ENGINE` §Hook inventory, the overhead stated, the open S-series of `20_OPEN_QUESTIONS`; the
anti-cheat guard and rule 2 untouched. Rule 6 governs any frame rate it shows beside frame generation, rule 7 any
Yes/No it shows, and rule 8 says it calls nothing on the network.
- **Questions that are the owner's**: on or off by default; what is stored in the ledger (a schema change, the size
of a session) and what is shown live only; what a PC without an NVIDIA card shows (N/A, never a guess); whether
the page asks for the elevation PawnIO needs; how many releases, and in what order.
- **What a new page owes**: strings in `en`, `vi`, `ja`; `ACCESSIBILITY.md` §For contributors for the page and each
chart; `LIMITATIONS.md` and the guide; `08_UI`.
#### Planned 2026-11-11, and approved by the owner — four trains, the first begun
The plan was made the same day, the owner's decisions asked while planning. **The design, the decisions D101–D108 and
the inventory are [`18_GPU_VENDOR_APIS.md`](18_GPU_VENDOR_APIS.md) §Advanced metrics**; what follows is only what that
section does not carry — the order, and what was asked.
- **The owner's four answers.** (1) Inside the game: **everything, in stages — and the refusal of 2026-08-09 is
re-examined**, not taken as final. (2) **Stored in full with the session.** (3) **Off by default, and off means
nothing more is read or stored**; the navigation item is hidden. (4) PawnIO: **the page says what is missing and
links to the admin mode's setting** (D34); it never asks for the rights itself.
- **Four trains, one release each, in this order**: **A** (0.1.0-beta.39) what the Agent can read — NVAPI,
LibreHardwareMonitor — with storage and the page, **and nothing changed in code loaded into a game**; **B**
(beta.40) inside the game, on calls already hooked and on functions Streamline exports, shared-memory layout 5;
**C** (beta.41) Reflex latency, after a spike; **D** (beta.42) the Streamline state behind `slGetFeatureFunction`,
after a spike. **Why this order**: A needs no hook, so it ships the page, the storage and the option first and
every later train only fills rows; B is hooks of a kind already built; C and D are routes nobody has proven safe,
and each ends in the owner's go or no.
- **The approval covers train A whole** — its eight pull requests through the release. **B, C and D each begin with a
plan of their own**, their decisions asked then. For D the owner will be asked one thing nothing else has needed:
handing the game a wrapper in place of the function it asked for is a write, and rule 4 as written forbids it.
- **Train A's pull requests**: (1) decisions, inventory, the catalog; (2) the NVAPI bridge's ABI 3 and the read-only
gate; (3) LibreHardwareMonitor's groups and the shared reader, not yet composed; (4) the `.partial` chunks and
schema 0023, produced by nobody yet; (5) the option goes live, with Privacy 2.15; (6) the pipe request and the
App's feed; (7) the page, the navigation item, Ctrl+6; (8) the release. A setting and its guide text, a navigation
item and its guide text, a schema script and its writer each land in ONE pull request — the guide tests, the
viewer-mode test and the registry test are red otherwise.
- **What the owner will be asked to run** (the release's owner-only item): the NVAPI rows on the RTX 5080 — CI has no
driver and never takes that branch; one run as administrator with PawnIO, which is also the first there has ever
been (`20_OPEN_QUESTIONS` §M10); the Agent's processor time and memory with the option on and off (NFR-2).
- **A trap already paid for**: LibreHardwareMonitor's storage group may touch every drive when it opens, and this
PC once had a failing USB drive. If the group cannot be opened without touching removable drives, storage stays
N/A in beta.39 — decided before the first run, not after it. **It cannot (read in the library's source,
2026-11-11), so it is not opened**: a drive's temperature reads N/A in beta.39, and the reason is on the page.
- **Measure before composing.** `FrameLedger.CaptureHost probe-advanced` ran the reader on this PC before any Agent
code used it, and found the sensor library's refresh at 14 ms of processor time — so the reader reads it every
fifth tick. The same number says the telemetry layer every session already uses costs more than NFR-2 allows
(`20_OPEN_QUESTIONS` §M16): **not this train's to fix, and the owner's to decide** — ask it when this train is out.
### Left open by this session
- **`LogNoteW`** (`src/native/FrameLedger.Overlay/src/dllmain.cpp`): a function nothing calls, found by the native
report and **not removed** — D100 changes code loaded into a game for a defect only, and dead code is not one. The
owner says whether it goes (owner-only item 36 (d)); `.editorconfig` has a section, naming it, that goes with it.
- ~~**This release's own facts** — the tag's run, the digests, the delta — are not in any file yet: the release is cut
after this text. Record them in the next pull request, as beta.37's and alpha.4's were in #384.~~ **Recorded
2026-11-11, in the first pull request of the Advanced-metrics train: 0.1.0-beta.38 was released
2026-11-11T02:56:51Z** from the signed tag on `b7d6550`, by run 42947853293 — one run for the one tag push, where
alpha.4's push had started two. Eight assets; the seven digests of `SHA256SUMS.txt` equal the ones GitHub computed;
the shipped natives carry `FL_BUILD_ID v0.1.0-beta.38`. The delta from beta.37 is 699,201 bytes beside a full
package of 110,325,438 — "Delta processed 0452 files. 0022 patched, 0430 unchanged". The wiki was published by run
42949461191. The rehearsal on the release branch (run 42944533749) had made a delta of 727,036 bytes with the same
file counts.
- **The Qodana licence** is read from the job's log (*Qodana license plan: Ultimate*, and the day the subscription is
active until). When it lapses both jobs are red and advisory; `qodana.yaml`'s first comment is the way back.
- **C# 15's constructs** wait for a ReSharper engine that reads them (`20_OPEN_QUESTIONS` §G, the row added with
beta.37): the linter is now Qodana for .NET, whose engine is the same one — re-run the canary (`spike-notes` §29)
when the action's pin moves.
- **The alpha line rests** (D98). No sync and no alpha follow this release.
**Owner-only:** item 36 — beta.38 on real hardware, the links, the two Qodana Cloud projects, and `LogNoteW`.
-111
View File
@@ -1,111 +0,0 @@
# HANDOFF history — 0.1.0-beta.39
*Moved verbatim from `docs/HANDOFF.md` when 0.1.0-beta.40 was cut, 2026-11-12 (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 then, and a path it writes is relative to `docs/`.*
## **START HERE** — 2026-11-11, 0.1.0-beta.39: Advanced metrics, train A — and train B begins with a plan of its own
*Status is `docs/changelog/0.1.0-beta.39.md`; this is what no other file carries.* The owner's request of 2026-11-11
— a setting, *Thông số nâng cao*, with a navigation item of its own — was planned the same day, approved, and its
**first train of four is this release**: what the Agent can read (NVAPI, LibreHardwareMonitor), stored with the
session, shown on a page, and **nothing changed in code loaded into a game**. Seven pull requests and this one:
#387 (decisions, inventory, the catalog), #388 (the NVAPI bridge's ABI 3, the read-only gate), #389 (the shared
reader, measured before composed), #390 (schema 0023, the `.partial` chunks), #391 (the switch, Privacy 2.15,
Disclaimer 2.15), #392 (the pipe request, the App's feed), #393 (the page, the navigation item, Ctrl+6). **The
design, the decisions D101–D108 and the inventory are [`18_GPU_VENDOR_APIS.md`](18_GPU_VENDOR_APIS.md) §Advanced
metrics; the screen is `08_UI` §Advanced.** The request as the owner wrote it, the four answers and the order of the
four trains are [`handoff/history/0.1.0-beta.38.md`](handoff/history/0.1.0-beta.38.md) §NEXT.
### What this train decided that the plan had not
- **D109 — the Disclaimer goes to 2.15 with the Privacy Policy.** The plan approved the Privacy Policy's content only.
Writing #391 found two sentences of the Disclaimer (§5, §5A) that said PawnIO and the admin mode were for the CPU
temperature alone, which the option makes false; the owner was asked with both quoted and chose to amend them. The
admin mode's own disclosure followed (`agent-admin-dialog/2`).
- **Storage is not read at all** (D103's outcome, decided before the first run): LibreHardwareMonitor cannot list
drives without touching removable ones, so the group is never opened and a drive's temperature is N/A with that
reason. Power supplies and fan controllers are refused for the same kind of reason (a search of every USB device).
- **The sensors are read every fifth second**, NVIDIA's figures every second — set by a measurement
(`CaptureHost probe-advanced`: 14 ms of processor time per refresh of the sensor library), not by taste.
- **The page's hold on the reader is the request itself**: nothing tells the Agent that a page opened or closed
(`07_IPC` `GetAdvancedMachine`). A design with an "open" and a "close" message was not written, because a pipe
that drops would leave the reader running.
### NEXT
1. ~~**Ask the owner `20_OPEN_QUESTIONS` §M16 before anything else.**~~ **Asked 2026-11-11 — D110: measure it in a
real Agent first.** `tools/agent-cost.ps1` does, and §M16 holds the numbers: 1.93 % of one core with Advanced
metrics off, 2.04 % on. **D117: NFR-2 is amended to ≤ 2.5 %**; nothing in the code changes.
2. ~~**Train B (0.1.0-beta.40) starts with a plan of its own**~~ **Train B was planned and approved the same day**
(D111–D116): [`18_GPU_VENDOR_APIS.md`](18_GPU_VENDOR_APIS.md) §Train B is the design. What that section does not
carry:
- **The approval covers 0.1.0-beta.40 whole** — five pull requests: (1) the decisions, the struct-version table,
§M16 measured; (2) shared-memory layout 5, written by nobody yet; (3) the Overlay reads the extra fields of the
calls it already hooks, behind the control word, with `overlay-fields-check` and the overhead measured; (4) the
Agent's sampler, the catalog's new reach, the page's words, Privacy 2.16; (5) the release, owner-only item 38.
- **beta.41 and beta.42 are designed and not begun.** Each starts only when the owner says the release before it
passed its owner-only item on real games — that wait is what the split is for.
- **The design was reviewed against the code before approval, and the review changed it**: the split itself; the
struct-version table (the tree holds one version of each header); storing a vendor `Boolean` or preset as its
value plus one and refusing the vendors' sentinels (`INVALID_FLOAT` is FLT_MAX); flags as "ever seen" masks and
the frame time as a sum the watchdog drains, since a value sampled once a second aliases a per-frame one; the
new region written by the watchdog alone and only while requested; `AdvancedSources`' new member optional, so a
beta.39 row still parses; `kMaxPatches = 48` to be checked before a patch is added.
3. **Trains C and D** (Reflex latency; the Streamline state behind `slGetFeatureFunction`) each begin with a spike
and end in the owner's go or no. D needs an amendment of rule 4 if it goes ahead — handing the game a wrapper is
a write — and that question is put to the owner then, not assumed.
### Left open by this session
- ~~**This release's own facts** — the tag's run, the digests, the delta — are not in any file yet: the release is cut
after this text. Record them in the next pull request, as beta.38's were in #387.~~ **Recorded 2026-11-11, in the
first pull request of train B: 0.1.0-beta.39 was released 2026-11-11T13:52:07Z** from the signed tag on `e63cd49`
(#394), by run 43031168146 — green at the first attempt, one run for the one tag push. Eight assets; the seven
digests of `SHA256SUMS.txt` equal the ones GitHub computed; the shipped natives carry `FL_BUILD_ID v0.1.0-beta.39`.
The delta from beta.38 is 3,144,205 bytes beside a full package of 110,678,706 — "Delta processed 0452 files. 0026
patched, 0426 unchanged". The wiki was published by run 43033077805. The rehearsal on the release branch (run
43026873256) had made a delta of 3,159,090 bytes with the same file counts.
- **Nothing here was seen in the running App.** The page was rendered to images from a test over fixture data and
looked at; a chart does not render into such an image. No real Agent answered a real App, no session was recorded
with the option on, and no value was compared with another tool. All of that is owner-only item 37.
- **The first run as administrator with PawnIO is still to come** (`20_OPEN_QUESTIONS` §M10, §M13): the processor,
memory and motherboard groups have been opened on no PC. The reader leaves a device alone after two faults, and
runs on a thread of its own, so a sensor that hangs holds up neither a session's samples nor the pipe — that is
the design, and it has not been tried.
- **The `vi` strings were written by the assistant and the `ja` ones are marked `review`** — 245 keys each, every
catalog entry among them.
- **`LogNoteW`** is still there (owner-only item 36 (d)), and the alpha line still rests (D98): no alpha follows this
release.
### Traps this train paid for
- **A pull request whose workflows never start.** #390 was opened and GitHub started none of its three workflows —
`gh pr checks` said "no checks reported" ten minutes later, with nothing queued. Closing and reopening the pull
request starts them (`pull_request: reopened`); **closing drops auto-merge, so enable it again.** After every
`gh pr create`, ask the API for the runs of the head commit before walking away.
- **`ShmDrainIntegrationTests.TheGuardInjectsTheOverlayAndTheReaderDrainsRealFrames` was red once** in a local gate
(#392's first run): the guard's re-scan refused the harness mid-run, under the gate's load. It passed alone and in
the rerun; nothing in that pull request is on its path; it was not diagnosed. ~~If it shows again, read the verdict's
reason first — the assertion prints only that it was a refusal.~~ **It showed again the same day** (train B's first
local gate), on another line: the Overlay's status was still `Init` with fifty records already drained. That one
is a race in the test and is fixed — the Overlay publishes `Ready` after its last hook, later than its first
record, so the test now waits `Init` out, bounded. The refusal was not reproduced; the assertion now prints the
verdict, so the next one says why.
- **`PagesLoadTests.EveryTextFollowsAThemeSwitch` was red once on a hosted runner** (#393's first run, green three
times locally): *Settings: "Processor" shows in a fresh one only*. Every build of the Settings page in that fixture
made a `SystemInfoViewModel` of its own, whose lines arrive from the thread pool, so two pages built a moment apart
could differ by a row. The fixture now loads one and awaits it (`Surfaces.SystemInfo`) — fixed in the release's
pull request, test code only. A surface whose view model loads by itself is loaded once, awaited, then shared.
- **SonarCloud's coverage of new code** (advisory, 80 % asked) was 75.3 % on #391: the uncovered part was Win32
(`WindowGeometryProbe.MonitorDeviceOf`). A lookup that takes a named window, as `Observe` does, can be tested
against the harness's window; one that only searches for a visible window cannot, on a hosted runner.
- **The App's own accessibility tests will refuse a page** that sets `AutomationProperties.LiveSetting` in XAML, that
names a page-local resource key, whose item types have no `ToString`, or whose grid has an unnamed filler column —
and a navigation item or a guide page that the guide's contents do not name. All of it is one test run away:
run `FrameLedger.App.Tests` whole before the gate.
- **An image of a page from a test** (`RenderTargetBitmap` over the hosted frame) shows the layout and the text, and
costs a temporary test; ScottPlot draws nothing into it.
- **`sed -i` on a file the Write tool made** is harmless only because both are LF until the normalising step; on a
CRLF file it is the trap `handoff/traps.md` already names.
**Owner-only:** item 37 — beta.39 on real hardware: the update and its two terms, the switch and the page, a session
with a real game, the first run as administrator with PawnIO, and what the Agent costs with the option on and off.
-148
View File
@@ -1,148 +0,0 @@
# HANDOFF history — 0.1.0-beta.40
*Moved verbatim from `docs/HANDOFF.md` when 0.1.0-beta.41 was cut, 2026-11-12 (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 then, and a path it writes is relative to `docs/`. **Its release numbers are those of the day it was written**: what it calls beta.41 and beta.42 are train B's second and third releases, now beta.42 and beta.43 (D118).*
## **START HERE** — 2026-11-12, 0.1.0-beta.40: Advanced metrics inside the game, the first of train B's three releases
*Status is `docs/changelog/0.1.0-beta.40.md`; this is what no other file carries.* Train B of the owner's
"Thông số nâng cao" was planned and approved on 2026-11-11 (D110–D117) as **three releases**, and this is the first:
what a hooked game tells its upscaler, read from **calls the Overlay already hooked — no new patch site** — only
while the session records Advanced metrics. Four pull requests and this one: #395 (the decisions, the struct-version
table, §M16 measured, NFR-2 amended), #396 (shared-memory layout 5, region 5), #397 (the Overlay's reads, the
`overlay-fields-check` gate, the overhead measured), #398 (the Agent's sampler, the catalog's reach `Game`, the
page's words, Privacy Policy 2.16). **The design is [`18_GPU_VENDOR_APIS.md`](18_GPU_VENDOR_APIS.md) §Train B; the
contract of the new region is [`07_IPC.md`](07_IPC.md) §Region 5; what each hooked call reads is
[`17_HOOK_ENGINE.md`](17_HOOK_ENGINE.md) §Hook inventory.** The plan as approved, the review that changed it and the
order of the trains are [`handoff/history/0.1.0-beta.39.md`](handoff/history/0.1.0-beta.39.md) §NEXT.
### What this train decided that the plan had not
None of these is an owner decision; each was found while building, and is written where it binds.
- **"On" is a request of the session's own, not a 1** (#397, `07_IPC` §Region 5). The plan had the control word as
0 or 1. A game outlives a session, and the Overlay's summaries with it — a second session of a game that kept
running would have read the first one's field-of-view range and counts. The Agent now writes a value no session of
that ring used, the watchdog starts its summaries afresh at a value it has not seen and names it in every
publication, and the reader keeps only a publication that names its own. Found while writing the injected test,
before anything shipped; layout 5 was changed in place (`reserved0` became `request`), which was possible only
because no release had carried it.
- **One module's calls are counted**, for the memory query as for the dispatch: a loader that passes a call on to a
leaf's export is seen at two hooks.
- **Five of the thirteen entries are tables**, not text (`sl.dlss.presets`, `sl.dlss.exposure`,
`ffx.upscale.sharpening`, `.jitter`, `.depth`): a row's name is the vendor's own member name, so nothing but a
switch's on/off and a flag's name needs translating. The catalog's unit and two summaries changed; no id did.
- **What became of the in-game entries is stored with the session** (`AdvancedSources.InGame`): read, nothing seen,
not hooked. Without it a session whose game set its DLSS options through `slDLSSSetOptions` would look like a
game with no upscaler.
- **The Disclaimer stays 2.15.** The accuracy statement gained an item, as in beta.19, beta.20 and beta.25, none of
which moved it; the Privacy Policy went to 2.16 with the content the plan approved.
- **A crash dump is tried three times** (#398). Not this train's subject: `CrashDumpHelperTests` failed under the
full gate for the third time in two days, and the cause — `MiniDumpWriteDump` of a running process that changes
under it — costs a real crash its only dump in exactly the same way.
### NEXT
1. **The owner runs item 38** — this release on real games. **Nothing of train B is begun before that**: the wait
is what the split into three releases is for (D113).
2. **0.1.0-beta.41, when the owner says item 38 passed**: two new hooks, `slSetConstants` and `ffxConfigure`. The
design is in `18` §Train B and the plan in [`handoff/history/0.1.0-beta.39.md`](handoff/history/0.1.0-beta.39.md)
§NEXT; region 5 already has their members (`sl*`, `ffxFg*`), so no layout changes. What to settle first, in a
plan of its own: `kMaxPatches = 48` against the patch count with the new rows; the window of `sl::Constants` that
is read, pinned by `static_assert` so that the camera members stay outside it; the overhead of a call made every
frame for every viewport, measured before the merge; `overlay-fields-check`'s list and its parameters for the two
new structs.
3. **0.1.0-beta.42, when the owner says the one before passed**: `slGetFeatureVersion` and
`slGetFeatureRequirements` — calls a game makes while starting, so most sessions will say the game did not make
them after FrameLedger attached. The release notes and the page say so.
4. **Trains C and D** (Reflex latency → beta.43; the Streamline state behind `slGetFeatureFunction` → beta.44) each
begin with a spike and end in the owner's go or no. D needs an amendment of rule 4 if it goes ahead.
### Left open by this session
- ~~**This release's own facts** — the tag's run, the digests, the delta — are not in any file yet: the release is cut
after this text. Record them in the next pull request, as beta.39's were in #395.~~ **Recorded 2026-11-12, in the
pull request after the release: 0.1.0-beta.40 was released 2026-11-11T19:30:13Z** (02:30 on the 12th in the
owner's time zone, which is the date the changelog carries; the legal documents' *Effective* date is the UTC one,
2026-11-11 — the fifth release to straddle midnight that way, after beta.9, .10, .12 and .14) from the signed tag
on `5268332` (#399), by run 43085044822 — green at the first attempt, one run for the one tag push. Eight assets;
the seven digests of `SHA256SUMS.txt` equal the ones GitHub computed; the shipped natives carry `FL_BUILD_ID
v0.1.0-beta.40`. The delta from beta.39 is 2,413,166 bytes beside a full package of 110,707,319 — "Delta processed
0452 files. 0025 patched, 0427 unchanged". The wiki was published by run 43087844607. The rehearsal on the release
branch (run 43082208739) had made a delta of 2,426,184 bytes with the same file counts.
- **Nothing here was read from a real game, and nothing was seen in the running App.** The values come from
`hook-harness --advanced` and the FidelityFX stub; the page's new rows were loaded by its tests and looked at by
nobody. All of it is owner-only item 38.
- **Whether any shipping title chains `sl::DLSSOptions` into `slEvaluateFeature`** is not known. If none of the
owner's games does, the six `sl.dlss.*` entries read N/A everywhere until train D, and the page already says why.
- **The aliasable part of FSR's memory** is read and published and not shown: the catalog has one memory entry.
- **What the owner's first evening with it showed** (2026-11-12, read from a copy of the ledger and the Agent's log;
ten hooked sessions on eight games, no fault in any, the Overlay `Ready` at every end):
- **Read from a real game for the first time: Lies of P** (FSR 3 through `amd_fidelityfx_dx12.dll` 1.0.1, the
SDK 1.1.x monolith) — sharpening on at 0.5, jitter up to 0.48 / 0.49 of a pixel, pre-exposure 0.25–1, a vertical
field of view from 21.6° to 73.7°, no flag, and a reported frame time whose median is 16.67 ms beside a native
rate of 55.6 FPS. The series starts 83 seconds in and has no gap after. Whether these match the game's own
settings is still the owner's to say (item 38 (c)).
- **`cameraNear` is absent there and `cameraFar` is 10.** Most likely the game runs an inverted, infinite depth
and passes `FLT_MAX` for the plane at infinity, which the Overlay refuses as a value nobody set. "Infinite" would
be the true answer. It is a change in code loaded into a game: decide it in beta.41's plan, not before.
- **Every other game said *the game made none of the calls***, as expected: all ran DLSS. Dying Light: The Beast
evaluates DLSS through Streamline and chains no `DLSSOptions` — the first evidence on that open question, and
it is a no. Valor Mortis, Phantom Blade Zero, Clair Obscur and Kingdom Come: Deliverance II ship AMD's FSR 3.1+
libraries and did not upscale through them in these sessions, so **no FSR 3.1+ title has been read yet**.
- **The option off stored nothing** (Black Myth: Wukong, one session each way), and **a game under the user-mode
anti-cheat exception ran with it on** (Girls' Frontline 2, trial 1 of 2).
- **Valor Mortis ended with an access violation 51 seconds after injection, once**; the next launch ran fourteen
minutes on the same build. The Overlay counted no fault and Windows logged no application error. Not attributed
and not ruled out; its crash count stands at 1, and a second such end switches its hooking off.
- **The sensor library was closed under its other users** — a defect of train A that only an elevated Agent with
PawnIO can show. `20_OPEN_QUESTIONS` §M13 has what was seen; `LhmLibrary` is the fix; the owner's next sessions
say whether it holds.
- **`LIMITATIONS.md` and the accuracy statement still say the processor's, the memory's and the motherboard's
sensors "have never been read on real hardware".** They have now been read on one PC and compared with nothing.
The sentence is the owner's to reword.
- ~~**SonarCloud on #398** had not answered when this was written; #397's three findings are fixed in #398.~~
**It answered after the merge, with three findings on new code**, handled in the pull request after the release:
two `csharpsquid:S1244` in `InGameAdvancedSampler` — a lowest and a highest float compared with `==` to tell one
value from a range; they are now told apart by their bits, which is what was meant — and one
`csharpsquid:S3869`, a blocker, on `ParentDump`'s `DangerousGetHandle`. That one is **not new and not fixed**: the
owner accepted it in beta.24 (`13_CI_CD` §SonarCloud), #398 moved the same expression into a new method, and
SonarCloud tracks an issue by its place. It needs the owner's *Accept* again — item 38 (j).
- **The `vi` strings were written by the assistant and the `ja` ones are marked `review`** — fourteen more keys and
the reworded Settings text.
- **`LogNoteW`** is still there (owner-only item 36 (d)), item 37 is still unrun, and the alpha line still rests
(D98): no alpha follows this release.
### Traps this train paid for
- **A library that is "one object per user" may still be one per process underneath.** Three `Computer`s of
LibreHardwareMonitor shared a driver handle and mutexes; each was tested alone, unelevated, where the shared part
is never opened. Before composing a second instance of anything that talks to a driver, ask what its `Close`
closes. And `first ??= TryClose(x)` in a loop stops closing at the first throw — the test for "all are closed
even when one throws" caught it in the fix itself.
- **A heredoc in the tool's shell breaks on an odd number of apostrophes** — a script with `game's` in it fails with
"unexpected EOF while looking for matching `'`" before Python ever runs. Write the script to a file and run the
file.
- **A region that outlives its reader needs to say whose data it holds.** Region 4 never had the problem — it is
the swap chain's state, the same for any session. Region 5 holds summaries, and a summary has a beginning. Ask of
any new shared state: what does the second session of the same process read in its first second?
- **SonarCloud's engine does not see a Catch2 `REQUIRE` end a path**: `REQUIRE(OpenRingFor(pid, r))` followed by
`r.st->…` is a null dereference to it (`cpp:S2259`, a failed gate on new code). An explicit `return` after the
`REQUIRE` is what it follows. And a `LARGE_INTEGER` read through `QuadPart` is initialised through `QuadPart`
(`cpp:S6232`) — `13_CI_CD` §SonarCloud has had the rule since #336; new code still forgot it.
- **SonarCloud fails after the merge.** Its job is advisory and slower than the required checks, so auto-merge lands
the pull request first. Read its result on the merged pull request before building on it.
- **`MA0051` counts sixty lines, comments included**, and `CaptureSession.SuperviseAsync` was at fifty-nine: one
line more is a build error. What a session asks once belongs where the session's state is made, not in the loop.
- **`RCS1242` refuses `in` for a struct that is not `readonly`** — the mirror structs are not. Pass the object that
holds the struct and take `ref readonly` inside.
- **`/W4 /WX` refuses `alignas` on a struct it then has to pad** (C4324): align the variable, not the type.
- **The `.resx` files hold a literal apostrophe**, not `&apos;`: an edit script that searches for the entity finds
nothing and stops half-way through.
- **`ISessionRepository.FindAdvancedSensorsAsync` returns `t_ms` too**: "no advanced series" is "no series under
`adv.`", not an empty list.
- **PowerShell reads a backtick in a double-quoted string as an escape** (`` `r `` is a carriage return) and
`"$name: text"` as a scoped variable: in a gate's messages, quote names with apostrophes and write `${name}:`.
**Owner-only:** item 38 — beta.40 on real games: the update and the Privacy Policy 2.16, a game that was running
across the update, an FSR 3.1+ title and a DLSS title with the option on, the same with it off, a second session of
a game that kept running, a game under the user-mode anti-cheat exception, and what the Agent costs.
-29
View File
@@ -63,35 +63,6 @@ are kept because they record what each version changed and why (owner decision D
>
> Version 2.5 (2026-09-27, 0.1.0-beta.10) adds how a tracked game's window is shown — read from Windows — and the engine build name read from an Unreal Engine game's executable. It is also the first version to say two things the software already did: it reads the **content** of a library game's executable (markers in its first 8 MB and its import table, since the detection of engines and features; and, when a session starts, the graphics-library markers in the whole file), and it reads the processor load and the memory in use (since 0.1.0-beta.3). Nothing here leaves your device, as before.
### What version 2.16 of the Privacy Policy changed (0.1.0-beta.40)
**Advanced metrics inside the game** (train B, owner decisions D111–D116; the content approved with the plan, once
for the train's three releases). §1's item on Advanced metrics gains what a session stores **for a game FrameLedger
injects into, only while the option is on**: what the game passed to its upscaler in the calls FrameLedger
intercepts — the output size, presets and exposure values it gave DLSS, whether it said its colour buffers are HDR,
auto-exposure and alpha upscaling; the sharpening, the jitter's size, the exposure, the depth range, the lowest and
highest field of view and the flags it gave FSR, the frame time it reported, FSR's own memory when the game asked —
and what is never read: where the camera is, which way it looks, its matrices. It also says that switching the option
off stops the reading inside a game as well. §4 had always named "the parameters your games pass to the graphics APIs
it intercepts"; it now says that with the option on more of the upscaling calls' parameters are read **and stored**,
which is what is new. The accuracy block gains an item: these are the game's words to the upscaler, not a check of
what the upscaler did, and many games show none. The Disclaimer stays 2.15, as the accuracy statement's additions
have not moved it before (beta.19, beta.20, beta.25). §2 is unchanged: nothing is sent.
### What version 2.15 of the Privacy Policy and of the Disclaimer changed (0.1.0-beta.39)
**Advanced metrics** (owner decisions D101–D108; the Privacy Policy's content approved with the plan, the Disclaimer's
two sentences by the owner's answer of 2026-11-11). Privacy Policy §1 gains one item — what a session stores **only
while the option is on**: more sensor series of the graphics card, and of the processor, the memory and the motherboard
when the Agent runs as administrator with PawnIO; a description of the hardware; what each display can do and what the
game's display did; the graphics driver's settings, global and for the game — and what is never read: a serial
number, a display's EDID, a list of other programs. §3A says an export and a bug report do not carry it. §4 names the
same as things the software can observe, only while the option is on. The Disclaimer's §5 and §5A said PawnIO and the
admin mode were for the CPU temperature alone; both now name the processor's, the memory's and the motherboard's
sensors with the option on. The accuracy block gains an item that says none of these readings has been checked
against another tool. §2 is unchanged: nothing is sent, as before. (Versions 2.12 to 2.14 of the Privacy Policy and
2.12 to 2.14 of the Disclaimer are recorded in the changelog of the release that carried each.)
### What version 2.11 of the Privacy Policy changed (0.1.0-beta.23)
A game's page shows its artwork (beta.23 PR-3, owner decisions D60/D61; the wording approved with the plan). §1 adds the
+1 -1
View File
@@ -99,7 +99,7 @@ The last thing P1 owes (§R4 moved it here because it needs P2's drain and recor
| 2 | OFF | | | |
| 3 | OFF | | | |
Gates: FPS delta ≤ 0.5 %, Agent CPU ≤ 1 % of a core *(≤ 2.5 % since 2026-11-11, D117)*, Agent RSS ≤ 150 MB. **Overlay resident ≤ 8 MB is
Gates: FPS delta ≤ 0.5 %, Agent CPU ≤ 1 % of a core, Agent RSS ≤ 150 MB. **Overlay resident ≤ 8 MB is
not measured by the runbook** and is left blank rather than guessed: it is a module inside the game
process, and reading the target's memory is what CLAUDE.md rule 4 forbids — an external tool that
inspects module sizes is the way to fill it.
+2 -11
View File
@@ -20,7 +20,7 @@ What each part of FrameLedger shows and what each button does. What the numbers
update** (it waits while a game is being recorded); and the safety notices — a game's hooking refused, measurement
stopped, hooking turned off — each with one button that only says you have read it.
**The pages** are on the left: **Dashboard**, **Games**, **Compare**, **Logs**, and **Settings** at the bottom. **Advanced** joins them, after Logs, while Advanced metrics is switched on.
**The pages** are on the left: **Dashboard**, **Games**, **Compare**, **Logs**, and **Settings** at the bottom.
## The menus
@@ -107,7 +107,6 @@ It opens from a session row, from the Dashboard, and from the notice when a sess
- **Frame generation in this session** — a bar and a table of every frame-generation state the session held, when it
held more than one, with how frame generation was set.
- **Tags and notes** with **Save**, and **Export CSV**, **Export JSON**, **Export PNG**.
- **Advanced metrics…**, for a session recorded with Advanced metrics on: it opens that session on the Advanced page.
## Compare
@@ -121,13 +120,6 @@ not) and **frame generation** — a session you ticked stays in the list. **Clea
What FrameLedger and its agent wrote down. Choose **App** or **Agent**, a level, and search; **Pause** stops the view from
following new lines. **Open logs folder**, and **Export bug bundle**, which does the same as Help ▸ Report a bug….
## Advanced
There only while Settings ▸ Recording ▸ **Advanced metrics** is on. Three tabs: **This PC** — what the graphics
driver and the sensors say right now, read only while the page is open; **Session** — what a session recorded with
the option on kept, in a table and a chart; **Sources** — every reading FrameLedger knows of, and for each one it
does not read, why. [Advanced metrics](12-advanced-metrics.md) describes each.
## Settings
Every switch and box is described in [Every setting](08-settings.md).
@@ -141,8 +133,7 @@ is ready.
## Keyboard and mouse
- **Ctrl+1** … **Ctrl+5** open Dashboard, Games, Compare, Logs and Settings, and put the keyboard in that page;
**Ctrl+6** opens Advanced while Advanced metrics is on.
- **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.
+1 -2
View File
@@ -22,7 +22,6 @@ The link under them, *Read what the hook does and does not do*, opens the safety
| **Minimum session length (s)** | A shorter session is not kept. 5 to 600 seconds. *Agent.* | 30 |
| **Sensor interval (ms)** | How often the PC's sensors are read during a session. 500 to 2000 ms. *Agent.* | 1000 |
| **Raw series kept per game** | How many of each game's newest sessions keep their per-frame data; older ones keep their statistics. 0 keeps everything. *Agent.* | 20 |
| **Advanced metrics** | Reads more from the graphics driver and the hardware sensors during a session — the graphics card's memory and load in detail, each fan and voltage, what your display can do, the driver's settings for the game — and stores it with the session. Off: nothing more is read or stored. It applies from the next session; a session recorded while it was off is not filled in later. While it is on, the **Advanced** page is in the list on the left ([Advanced metrics](12-advanced-metrics.md)). *Agent.* | Off |
## Data
@@ -35,7 +34,7 @@ The link under them, *Read what the hook does and does not do*, opens the safety
| Setting | What it does | Default |
|---|---|---|
| **Run the agent as administrator** | Lets FrameLedger measure games that run as administrator, and — with PawnIO installed — read CPU temperature and, when *Advanced metrics* is on, the processor's, the memory's and the motherboard's sensors. Windows asks every time the agent starts, at logon too. A warning explains the risk first; read [Limitations](../LIMITATIONS.md#running-the-agent-as-administrator). The agent restarts to apply it, or at its next start if a game is being recorded. | Off |
| **Run the agent as administrator** | Lets FrameLedger measure games that run as administrator, and read CPU temperature with PawnIO installed. Windows asks every time the agent starts, at logon too. A warning explains the risk first; read [Limitations](../LIMITATIONS.md#running-the-agent-as-administrator). The agent restarts to apply it, or at its next start if a game is being recorded. | Off |
| **Start the agent at logon** | **Register**, **Repair** or **Remove** a task that starts the agent when you log on, for your user only and without administrator rights. Without it, FrameLedger starts the agent when you open it. | Not installed |
## Appearance
-83
View File
@@ -1,83 +0,0 @@
# Advanced metrics
A session's summary shows the figures most people want. **Advanced metrics** is for looking closer: everything the
graphics driver and the hardware sensors will say about your PC, kept with each session and shown on a page of its
own.
It is **off unless you switch it on**, and while it is off nothing more is read or stored.
## Switch it on
Settings ▸ Recording ▸ **Advanced metrics**. A new item, **Advanced**, appears at the end of the list on the left
(**Ctrl+6**). Sessions you record from then on keep the extra readings; a session recorded while it was off is not
filled in later.
## This PC
What your PC says right now.
- **About this PC** — the graphics card's firmware, architecture and cores, its memory sizes, the driver's package,
what each display can do with HDR and variable refresh, and the driver's global settings. A row with a number in
brackets unfolds into a list.
- **Right now** — every reading with the time it was read at. NVIDIA's own figures are read every second; the
sensors (fans, voltages, loads) every five seconds, so a sensor's value can be a few seconds old, and its time
says so.
- **Over time** — choose a reading and see its last five minutes. More than eight lines at once cannot be told
apart, so a reading with many parts (every processor core, say) is drawn as its lowest, average and highest.
These readings are taken **only while this page is open or a game is being recorded**, and what the page shows is
not stored.
## Session
Choose a session recorded with Advanced metrics on. You see the PC as it was then, what belonged to that session
alone — whether variable refresh was in use on the display the game ran on, the colour space the game presented in,
the driver's settings for that game — the lowest, average and highest of every reading, and a chart over the
session's length.
### What the game told its upscaler
For a game FrameLedger measures **from inside** (hooking is on for it), a session recorded with Advanced metrics on
also keeps what the game itself handed to DLSS and FSR:
- **DLSS** — the output size, the model preset for each quality mode, whether the game said its colour buffers are
HDR, auto-exposure, alpha upscaling, and the exposure values.
- **FSR** — sharpening (on or off, and how strong), the largest jitter offset, the exposure, the near and far planes,
the **range** of the field of view over the session, the flags of the call, the frame time the game reported, and
FSR's own video memory at the moments the game asked for it.
These are the game's own words to the upscaler, shown in the vendor's notation (`preExposure`, preset `K`).
FrameLedger does not check what the upscaler did with them.
**Many games will show nothing here**, and the line under the session says why: *the game made none of the calls
these are read from* — most games set their DLSS options through a call FrameLedger cannot see, and only games that
use FSR 3.1 or later through AMD's own library show the FSR rows — or *the session was not measured inside the game*.
It never means the game uses no upscaler; the session's summary still names the upscaler as before.
**Where the camera is, which way it looks and its matrices are never read.** The field of view is kept as a lowest
and a highest value, never as a line over time.
A session's summary has an **Advanced metrics…** button that opens that session here.
## Sources
Every reading FrameLedger knows of, with what it belongs to (this PC, a session, or a session over time), where it
comes from, and whether it is read. Where it is not, the reason is written out:
- **the capture agent is not running as administrator**, or **PawnIO is not installed** — the processor's, the
memory's and the motherboard's sensors need both ([Every setting](08-settings.md), *Run the agent as
administrator*);
- **not present on this PC** — the driver's own figures exist on NVIDIA cards only;
- **read inside a game FrameLedger measures, when the game makes the call** — what the game tells DLSS and FSR
(above). Some further readings inside the game **come with a later release**;
- **never read** — a serial number, a display's identification data, which other programs are encoding, the camera's
position in the game. FrameLedger does not read these at all.
## Good to know
- A reading that could not be taken is **N/A**, never a guess and never a zero.
- **A drive's temperature is not read**: the sensor library cannot list drives without touching removable ones.
- None of these readings has been checked against another tool yet.
- They are not part of an exported session or a bug report.
More limits are on the [Limitations](../LIMITATIONS.md) page, under *Sensors*.
+2 -3
View File
@@ -4,7 +4,7 @@ FrameLedger records how your games run on this PC — frame rate, frame times, t
with, temperatures, and how much memory the game uses — and keeps every session so you can compare them later.
Everything stays on your PC.
Each page below takes a minute or two to read. The first six are the guide; the next six are there to look things up.
Each page below takes a minute or two to read. The first six are the guide; the next five are there to look things up.
1. [Install and first start](01-install.md)
2. [Record a game](02-record-a-game.md)
@@ -17,8 +17,7 @@ Each page below takes a minute or two to read. The first six are the guide; the
9. [When something goes wrong](09-troubleshooting.md)
10. [Words FrameLedger uses](10-glossary.md)
11. [Alpha builds](11-alpha-builds.md) — the experimental builds on a new .NET, and how to go back
12. [Advanced metrics](12-advanced-metrics.md) — everything the driver and the sensors say, if you switch it on
13. [The terms, in plain words](terms-in-plain-words.md)
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). How it works with the keyboard alone, a screen reader or a contrast theme, and how to report a problem:
+2 -15
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-11-11.** The software is a beta; its latest
> **beta is `0.1.0-beta.41`** (2026-11-12), 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.37`** (2026-11-11), an unsigned installer built from that tag with its
> checksums published beside it (alphas — experimental builds that try a newer .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
@@ -101,19 +101,6 @@
> Windows once a second and charted. Processor temperature is read only when the Agent runs as
> administrator — an option, off by default, for which Windows asks at every start of the Agent — with
> PawnIO installed, and that reading has not yet been checked on real hardware; everywhere else it is `N/A`.
> - **Advanced metrics (since beta.39; off unless you switch it on in Settings):** with it on, a session also stores
> what the graphics driver and the sensor library report about the hardware — the graphics card's memory, load,
> clocks, fans, voltages and power in detail, what a display can do, the driver's settings for the game — as they
> report it: NVIDIA's figures once a second, the sensor library's every five seconds. None of these readings has
> been checked against another tool. The processor's, the memory's and the motherboard's need the Agent as
> administrator with PawnIO and have never been read on real hardware; a drive's temperature is not read. The
> Advanced page shows them as they were stored, and what the PC reads at the moment only while that page is open.
> - **What a game tells its upscaler (since beta.40; only with Advanced metrics on, only for a game measured from
> inside):** the output size, presets and exposure a game hands DLSS, and the sharpening, jitter, exposure, depth
> range, field-of-view range, flags and frame time it hands FSR, are read from the arguments of the calls
> FrameLedger intercepts and shown as the game stated them — not checked against what the upscaler did. Most games
> set their DLSS options through a call that cannot be intercepted and show none; the FSR values need FSR 3.1 or
> later through AMD's own library. None of it has been read from a real game yet.
> - **Safety:** every pre-injection check runs before injection, including the signed-by-a-known-vendor
> half of the suspicious-module rule. During every capture the Agent re-runs the checks every 30 s and
> stops capturing on a refusal: a Direct3D or OpenGL game's hooks are removed, and the Vulkan layer
+5 -19
View File
@@ -1,6 +1,6 @@
# FrameLedger — Disclaimer
**Version:** 2.15 · **Effective:** {{RELEASE_DATE}}
**Version:** 2.14 · **Effective:** {{RELEASE_DATE}}
## 0. This is pre-release software
@@ -120,8 +120,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-11-11.** The software is a beta; its latest
> **beta is `0.1.0-beta.41`** (2026-11-12), 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.37`** (2026-11-11), an unsigned installer built from that tag with its
> checksums published beside it (alphas — experimental builds that try a newer .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
@@ -210,19 +210,6 @@ Frame timing is derived from high-resolution timestamps taken at the moment the
> Windows once a second and charted. Processor temperature is read only when the Agent runs as
> administrator — an option, off by default, for which Windows asks at every start of the Agent — with
> PawnIO installed, and that reading has not yet been checked on real hardware; everywhere else it is `N/A`.
> - **Advanced metrics (since beta.39; off unless you switch it on in Settings):** with it on, a session also stores
> what the graphics driver and the sensor library report about the hardware — the graphics card's memory, load,
> clocks, fans, voltages and power in detail, what a display can do, the driver's settings for the game — as they
> report it: NVIDIA's figures once a second, the sensor library's every five seconds. None of these readings has
> been checked against another tool. The processor's, the memory's and the motherboard's need the Agent as
> administrator with PawnIO and have never been read on real hardware; a drive's temperature is not read. The
> Advanced page shows them as they were stored, and what the PC reads at the moment only while that page is open.
> - **What a game tells its upscaler (since beta.40; only with Advanced metrics on, only for a game measured from
> inside):** the output size, presets and exposure a game hands DLSS, and the sharpening, jitter, exposure, depth
> range, field-of-view range, flags and frame time it hands FSR, are read from the arguments of the calls
> FrameLedger intercepts and shown as the game stated them — not checked against what the upscaler did. Most games
> set their DLSS options through a call that cannot be intercepted and show none; the FSR values need FSR 3.1 or
> later through AMD's own library. None of it has been read from a real game yet.
> - **Safety:** every pre-injection check runs before injection, including the signed-by-a-known-vendor
> half of the suspicious-module rule. During every capture the Agent re-runs the checks every 30 s and
> stops capturing on a refusal: a Direct3D or OpenGL game's hooks are removed, and the Vulkan layer
@@ -264,15 +251,14 @@ be the difference between a game that runs and one that does not. Turn hooking o
## 5. Hardware and drivers
FrameLedger reads GPU telemetry through vendor libraries that ship with your graphics driver. It **only reads** — it never changes clocks, fan curves, power limits, or any other hardware setting. Optional CPU-temperature support — and, with Advanced metrics on, reading the processor's, the memory's and the motherboard's sensors — relies on the separate third-party **PawnIO** driver, which you install at your own discretion under its own license; some anti-cheat systems object to third-party kernel drivers regardless of what they are used for.
FrameLedger reads GPU telemetry through vendor libraries that ship with your graphics driver. It **only reads** — it never changes clocks, fan curves, power limits, or any other hardware setting. Optional CPU-temperature support relies on the separate third-party **PawnIO** driver, which you install at your own discretion under its own license; some anti-cheat systems object to third-party kernel drivers regardless of what they are used for.
## 5A. Running the capture agent as administrator — optional, and your decision
Since 0.1.0-beta.10 a Settings option, off unless you turn it on, starts FrameLedger's capture agent as administrator.
**Windows asks you every time the agent starts** — also when you sign in — and the prompt names an unknown publisher,
because FrameLedger is not code-signed. It lets FrameLedger open and measure a game that itself runs as administrator,
and read the CPU temperature — and, with Advanced metrics on, the processor's, the memory's and the motherboard's
sensors — where PawnIO is installed. It changes nothing in the anti-cheat guard (§2, §2A), opens no
and read the CPU temperature where PawnIO is installed. It changes nothing in the anti-cheat guard (§2, §2A), opens no
process that Windows or an anti-cheat driver protects, and never starts a game as administrator: games you start from
FrameLedger run with your standard rights.
+3 -4
View File
@@ -1,6 +1,6 @@
# FrameLedger — Privacy Policy
**Version:** 2.16 · **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.**
@@ -11,7 +11,6 @@ Stored in `%LOCALAPPDATA%\FrameLedger` on your device:
- Your game library entries (names, executable paths, metadata you or the app filled in, and whether each one is recorded).
- Images you choose for a game (Edit…), copied into the `covers` folder; choosing the store's image again, or removing the game together with its sessions, deletes the copy. Artwork a store's app keeps on your PC, or a game ships in its own folder, is shown from where it is and not copied.
- Performance sessions: frame timing series, computed statistics, hardware sensor series (temperatures, load, power, memory usage, and the graphics card's clock speeds, fan speed, memory temperature and whether its power limit or heat held it back), the game's own memory use (its dedicated and shared video memory, private working set, working set and commit, once a second), session duration, crash flags, the graphics driver's settings the game ran under (NVIDIA only), how the game's window was shown (full-screen, borderless or windowed, for how long, its size and the monitor's), tags and notes you write.
- **Only while Settings ▸ Advanced metrics is on** (it is off unless you switch it on), with each session: more hardware sensor series — the graphics card's memory use in detail, its load by part, its clocks, voltages, currents, power, each fan and its video encoder's use; and, when the capture agent runs as administrator with PawnIO installed, the processor's temperatures, load, clocks, power and voltages by core, the memory in use and its modules' temperatures, and the motherboard's temperatures, fans and voltages — and a description of the hardware: the graphics card's firmware version, architecture, bus and memory sizes, the graphics driver's package and the chipset it names, the motherboard's and the memory modules' model names, what each connected display can do (the HDR formats it accepts, its brightness range, variable refresh), whether variable refresh was in use on the display the game ran on and the colour space the game presented in, and the graphics driver's settings — its global ones and the ones it holds for the game (NVIDIA only). For a game FrameLedger injects into, a session then also stores what the game itself passed to its upscaler in the calls FrameLedger intercepts: the output size, the model presets and the exposure values it gave DLSS, whether it said its colour buffers are HDR, auto-exposure and alpha upscaling; and the sharpening, the size of the jitter, the exposure, the depth range, the lowest and highest field of view and the flags it gave FSR, the frame time it reported to FSR, and FSR's own video memory when the game asked for it — never where the game's camera is, which way it looks, or its matrices. No serial number, no display identification data (EDID) and no list of other programs is read or stored. Switching the option off stops the reading, inside a game as well; what earlier sessions stored stays with them until you delete those sessions.
- A hardware snapshot per session (CPU/GPU model, driver version, RAM size, OS build, display mode) used for the "what changed between sessions" feature.
- App settings, logs (rotated daily — the app keeps 7 days, the capture agent 14 — including the logs written by the component loaded into games), and, after a crash of the app itself, crash dump files.
- Which games you enabled code injection for, and when you consented.
@@ -39,11 +38,11 @@ The "Report a bug" feature builds a zip file **on your device**, shows you exact
## 3A. Sharing an export or a bug report
An exported session (CSV or JSON) and a bug report can contain your games' names and **the paths to their files** — which include your **Windows user name** when a game is installed under your user folder — your hardware model, graphics driver and Windows build, the times you played, and your tags and notes. What a session stores only while Advanced metrics is on (§1) is in neither: an export and a bug report carry what they carried before. A bug report removes user directory paths from its logs; an export is written as it is. Look at a file before you share it. Once you share it, it is outside FrameLedger: whoever receives it, and the site you post it to, can read it under their own terms.
An exported session (CSV or JSON) and a bug report can contain your games' names and **the paths to their files** — which include your **Windows user name** when a game is installed under your user folder — your hardware model, graphics driver and Windows build, the times you played, and your tags and notes. A bug report removes user directory paths from its logs; an export is written as it is. Look at a file before you share it. Once you share it, it is outside FrameLedger: whoever receives it, and the site you post it to, can read it under their own terms.
## 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) — and, only while Advanced metrics is on, more of the parameters of the upscaling calls, which are then stored with the session (sizes, presets, exposure, sharpening, the jitter's size, the depth range, the range of the field of view, flags, the reported frame time, the upscaler's own memory), never the camera's position, direction or matrices; 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; and — only while Advanced metrics is on — that driver's description of the graphics card and of each connected display, what it reports about the display a tracked game's window is on, its settings for a tracked game and its global ones (read only), and, when the capture agent runs as administrator with PawnIO installed, the sensors and model names of the processor, the memory and the motherboard (never a drive's), all of which are also read with no game running while the Advanced page is open, to show them there, and are not stored then; 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.
-45
View File
@@ -1,45 +0,0 @@
# Qodana's settings for the `native` job of .github/workflows/qodana.yml (owner decision D99, 2026-11-11;
# docs/13_CI_CD.md §Qodana).
#
# The C++ of src/native, read by Qodana for .NET (qodana-dotnet: Rider's engine, whose C++ is ReSharper C++) in native
# mode on a Windows runner. That linter is the only one that can: the native layer is MSVC-only, and JetBrains' two
# C/C++ linters (qodana-cpp, qodana-clang) are Linux images. It reads C++ through a Visual Studio solution, and
# src/native is a CMake tree, so the job generates one first - the `x64-vs-analysis` preset - and builds from it only
# the one header a build generates (the blocklist floor). Nothing else is compiled.
#
# A report of its own, in a Qodana Cloud project of its own (`frameledger-cpp`, the QODANA_TOKEN_NATIVE secret): the
# managed report (qodana.yaml) leaves src/native out, so every file is in exactly one of the two.
version: "1.0"
linter: qodana-dotnet
withinDocker: false
profile:
base:
name: qodana.recommended
groups:
- groupId: Hints
groups:
- "severity:TYPO"
inspections:
- group: Hints
enabled: false
dotnet:
solution: build/native/x64-vs-analysis/FrameLedgerNative.slnx
# The flags the shipped binaries are built with (the x64-release preset's build type).
configuration: RelWithDebInfo
platform: x64
# What is not FrameLedger's code: what CMake generates and fetches (MinHook, Catch2, jsmn, the floor header), the
# vendored SDK headers, the fixtures that carry the vendors' names on purpose, a compiled shader as a byte array.
exclude:
- name: All
paths:
- build
- src/native/third_party
- src/native/tools/vendor-stubs
- src/native/tools/hook-harness/dxr_raygen_dxil.h
failureConditions:
severityThresholds:
any: 0
+15 -99
View File
@@ -1,113 +1,29 @@
# Qodana's settings for the `managed` job of .github/workflows/qodana.yml (owner decisions D93, 2026-11-10, and D99,
# 2026-11-11; docs/13_CI_CD.md §Qodana).
# Qodana's settings for .github/workflows/qodana.yml (owner decision D93, 2026-11-10; docs/13_CI_CD.md §Qodana).
#
# The linter is Qodana for .NET (qodana-dotnet: Rider's engine), in NATIVE mode - on the job's own Windows runner, with
# the .NET SDK global.json names, no container. It needs the Ultimate licence the Qodana Cloud organisation holds since
# 2026-11-10; the Community linter (qodana-cdnet, InspectCode in a Linux container) ran here until then, and is the way
# back if the subscription ever lapses - `linter: qodana-cdnet`, and the job on ubuntu-latest again.
# The linter is Qodana Community for .NET (ReSharper's InspectCode in a Linux container), and not Qodana for .NET
# (Rider): that one needs an Ultimate licence, and the Qodana Cloud organisation holds a 30-day trial, so a job
# built on it would turn red the day the trial ends. The Community linter runs under every licence.
#
# It reads the solution's C#, XAML and .resx, and what Rider's own plugins read of the repository around it (Markdown,
# XML, and JetBrains' security rules over the C#). Not the C++: that is qodana-native.yaml's report, over the Visual
# Studio solution CMake generates, sent to a Qodana Cloud project of its own.
# It analyses the C# of FrameLedger.slnx - and its XAML and .resx - and nothing native: src/native is a CMake
# tree no solution names, and it is MSVC-only, which no Linux container compiles. CodeQL and SonarCloud read the C++.
#
# Everything a run needs to know is here and nothing is an action argument, so `qodana scan` on a developer's PC reads
# the same settings. The linter's version is the action's (the action pins the CLI, the CLI its linter), so the one pin
# is the action's commit in the workflow.
# The linter's image is the action's own version (the action pins the CLI, the CLI its image), so the one pin is the
# action's commit in the workflow.
version: "1.0"
linter: qodana-dotnet
withinDocker: false
linter: qodana-cdnet
# WHERE AN INSPECTION IS SWITCHED OFF (docs/13_CI_CD.md §Qodana, CLAUDE.md §Coding conventions): one of ReSharper's -
# C#, XAML, .resx - in .editorconfig, where Rider reads it too. Here only what has no key there: a whole severity and
# the IntelliJ platform's own inspections (Markdown, XML) under `profile`; and, under `exclude` further down, the files
# JetBrains' security rules were read in, and one file the linter itself fails on. Each with its reason above it.
profile:
base:
name: qodana.recommended
groups:
# A HINT is what the editor offers without underlining anything (ReSharper's lowest level; this linter files it as
# TYPO, Qodana as Low): "invert if", "convert to LINQ", a trailing comma, and every Roslyn analyzer message below
# the level this build makes an error. The Community linter never reported them, and the rule D93 set is about
# warnings and suggestions. 3,607 of this job's first 3,953 results were hints (run 42923079119).
- groupId: Hints
groups:
- "severity:TYPO"
inspections:
- group: Hints
enabled: false
# Rider wants a table's columns padded to one width. The tables here are written to be diffed: a cell's text changes
# and its row alone moves.
- inspection: MarkdownIncorrectTableFormatting
enabled: false
# It computes a heading's anchor its own way; the documents are read on GitHub, whose anchors these links follow
# (`#display-mode--both-tiers-beta10` for "Display mode — both tiers (beta.10)"), and tools/wiki-build.ps1 checks
# the links of every page it publishes. All three it reported resolve on GitHub.
- inspection: MarkdownUnresolvedHeaderReference
enabled: false
# A Windows application manifest: the linter has no schema for urn:schemas-microsoft-com:asm.v1 and reports every
# element of the file as undeclared.
- inspection: XmlHighlighting
ignore:
- "src/FrameLedger.App/app.manifest"
# INTERIM, from beta.37's move to .NET 11 (D94, 2026-11-11) until the Ultimate linter's pull request replaces this
# file: the linter's image carries the .NET SDKs 8 to 10, and main builds on 11. The SDK global.json names is installed
# into the container before the build, with the line JetBrains' page gives for an SDK the image lacks.
bootstrap: curl -fsSL https://dot.net/v1/dotnet-install.sh | bash -s -- --jsonfile /data/project/global.json -i /usr/share/dotnet
dotnet:
solution: FrameLedger.slnx
configuration: Release
# What is not FrameLedger's code, or not code at all - SonarQube.Analysis.xml's list, for its reasons - and what the
# other report reads.
exclude:
- name: All
paths:
- src/native
- src/FrameLedger.App/Strings.Designer.cs
- tests/fixtures
- legal/licenses
- docs/vendor-exports.json
- src/FrameLedger.Infrastructure/Persistence/Migrations
- build
- out
# JETBRAINS' SECURITY RULES (the OpenGrep plugin: pattern rules, several hundred of them) stay on, and the files
# their results were READ in are listed here - so a new file that starts a process, or builds an SQL text, is
# reported. Two rules fired, 36 times, on 2026-11-11: "a process is started with something that is not a literal"
# (35) - and starting processes is part of what FrameLedger is: the Agent beside the App, the game the user added,
# Explorer on a folder, the browser on a link - and the same for an SQL text (1: a constant field, every value a
# parameter). docs/13_CI_CD.md §Qodana has each place, what it starts and where that comes from.
#
# The name is the PLUGIN'S ONE INSPECTION, not a rule's: every rule's result is produced by OpenGrepInspection, and
# a rule's own id is honoured nowhere - not by `ignore`, not by an `exclude` path, not by `enabled: false` (three
# runs, 42932842462, 42935752891 and 42938295264: all 36 stood each time; the server is handed every rule file
# whatever the profile says). So a file listed here is left out of ALL of the plugin's rules, which is the price.
# ProcessStartSitesTests, in the gate, names the same files and fails on a new one.
- name: OpenGrepInspection
paths:
- src/FrameLedger.App/Services/AgentLauncher.cs
- src/FrameLedger.App/Services/AgentTool.cs
- src/FrameLedger.App/Services/Explorer.cs
- src/FrameLedger.App/Services/ShellStarter.cs
- src/FrameLedger.App/Services/ShellUrlOpener.cs
- src/FrameLedger.App/ViewModels/SettingsViewModel.cs
- src/FrameLedger.Infrastructure/Capture/ProcessLauncher.cs
- src/FrameLedger.Infrastructure/Diagnostics/CrashDumpWriter.cs
- src/FrameLedger.Infrastructure/Startup/AgentElevation.cs
- src/FrameLedger.Infrastructure/Startup/LogonTask.cs
- src/FrameLedger.Infrastructure/Persistence/SqliteSessionRepository.cs
# The tests start what they test - the harness, the Agent, a process to hold a handle on (24 of the 35).
- tests
# THE LINTER'S OWN FAULT, not the file's: resolving `PInvoke.EnumDisplaySettings(null, ...)` - the `null` to PCWSTR
# conversion - the engine of this linter's build (QDNET-262.12299) fails an internal assertion
# ("IsStandardImplicitConversionFromExpression(conversion.Kind)", in its log), loses the method, and reports its
# three locals and the file's three usings as unused. The compiler builds it with warnings as errors, and
# InspectCode 2026.2.3.1 and 2026.3.0 report nothing there. To be removed when a linter build reads the file.
- name: UnusedVariable.Compiler
paths:
- src/FrameLedger.Infrastructure/Recording/PrimaryDisplay.cs
- name: RedundantUsingDirective
paths:
- src/FrameLedger.Infrastructure/Recording/PrimaryDisplay.cs
# The gate: no problem at all. What the linter reports is settled where it is found - fixed, or its inspection
# switched off with the reason beside it - so a count above zero is something new.
# switched off in .editorconfig with the reason beside it (InspectCode reads its severities there, and so does
# Rider) - so a count above zero is something new.
failureConditions:
severityThresholds:
any: 0
@@ -1,7 +1,6 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using FrameLedger.Application.Advanced;
using FrameLedger.Application.AntiCheat;
using FrameLedger.Application.Capture;
using FrameLedger.Application.Consent;
@@ -44,7 +43,6 @@ internal sealed class AgentRecording
private readonly WindowGeometryProbe _display = new();
private readonly UserModeExceptionLapsePolicy _exceptionLapse;
private readonly ICrashReporterSightings _reporters;
private readonly IAdvancedHardware _advanced;
public AgentRecording(
IGameConsentStore store,
@@ -69,10 +67,8 @@ internal sealed class AgentRecording
IUserModeExceptionSwitch exceptions,
IOverlayToleranceChannel tolerance,
UserModeExceptionLapsePolicy exceptionLapse,
ICrashReporterSightings reporters,
IAdvancedHardware advanced)
ICrashReporterSightings reporters)
{
_advanced = advanced;
_reporters = reporters;
_profiles = profiles;
_exceptions = exceptions;
@@ -123,21 +119,18 @@ internal sealed class AgentRecording
_partials,
_finalizer,
_crashes,
options => Poller(options.TelemetryInterval, options.AdvancedMetrics ? _advanced : null),
static options => Poller(options.TelemetryInterval),
TimeProvider.System,
new RecorderOptions { MinimumSessionLength = minimum, PartialFlushInterval = flush },
_observer,
_policy,
_profiles,
_exceptionLapse,
_reporters,
_advanced);
_reporters);
}
/// <summary>L1 + L2 + L3 under the composite, one poller per session; the poller owns and disposes the layers. The interval is the session's (<c>telemetry.interval_ms</c>, D16).</summary>
/// <param name="interval">Between two polls.</param>
/// <param name="advanced">The Agent's shared advanced reader when the session records Advanced metrics (D101); null — the option off — composes none.</param>
public static TelemetryPoller Poller(TimeSpan interval, IAdvancedHardware? advanced = null)
public static TelemetryPoller Poller(TimeSpan interval)
{
// Ownership walks up one step at a time and each local is nulled at its hand-off, so a throw
// anywhere below disposes exactly what nobody owns yet.
@@ -168,7 +161,7 @@ internal sealed class AgentRecording
// The game process's own memory (beta.12, D43): read from outside it through FrameLedger.ProcessStats.dll, for
// whichever process the capture loop tells the poller to follow. Absent DLL = N/A, never a fault.
game = new GameMemoryReader(new NativeProcessStats());
var poller = new TelemetryPoller(composite, new TelemetryPollerOptions { Interval = interval }, TimeProvider.System, ownsSource: true, system, game, advanced);
var poller = new TelemetryPoller(composite, new TelemetryPollerOptions { Interval = interval }, TimeProvider.System, ownsSource: true, system, game);
composite = null;
system = null;
game = null;
@@ -2,7 +2,6 @@
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using FrameLedger.Agent.Hosting;
using FrameLedger.Application.Advanced;
using FrameLedger.Application.AntiCheat;
using FrameLedger.Application.Capture;
using FrameLedger.Application.Consent;
@@ -121,15 +120,6 @@ internal static class AgentServices
services.AddSingleton<ISeriesCodec, DeflateSeriesCodec>();
services.AddSingleton<SessionFinalizer>();
services.AddSingleton(static sp => new PartialRecovery(sp.GetRequiredService<IPartialSessionStore>(), sp.GetRequiredService<SessionFinalizer>()));
// Advanced metrics (owner decisions D101 and D107): ONE reader for the whole Agent, on a thread of its own, that
// runs only while a session recorded with the option on - or the App's page - holds it, and closes ten seconds
// after the last lets go. Constructing it opens nothing; a PC idling with the Agent in the tray reads no sensor
// for this. The container disposes it with the host.
services.AddSingleton<IAdvancedHardware>(static _ => new AdvancedHardwareHub(
static () => AdvancedHardwareReader.OverThisPc(TimeProvider.System, static line => Serilog.Log.Information("{Line}", line)),
interval: TimeSpan.FromSeconds(1),
linger: TimeSpan.FromSeconds(10),
static line => Serilog.Log.Information("{Line}", line)));
services.AddSingleton<AgentRecording>();
}
@@ -256,18 +246,11 @@ internal static class AgentServices
services.AddSingleton<CapturePause>();
services.TryAddSingleton<IAgentLifetime, NoAgentLifetime>();
services.AddSingleton(static sp => CommandHandler(sp));
// GetAdvancedMachine (D101/D107): the App's page asks once a second while it is open, and each request is its
// hold on the shared reader for a few seconds - so nothing has to tell the Agent that the page closed.
services.AddSingleton(static sp => new AdvancedMachineResponder(
sp.GetRequiredService<IAdvancedHardware>(),
ct => sp.GetRequiredService<RegisteredSettings>().GetBooleanAsync(SettingsRegistry.TelemetryAdvanced, ct),
TimeProvider.System));
services.AddSingleton<IIpcRequestHandler>(static sp => new AgentRequestHandler(
AgentIdentityFactory.OfThisProcess(sp.GetRequiredService<AgentPaths>().VkLayerDirectory, sp.GetService<AgentElevationState>()?.Outcome),
TelemetryDescriptor(),
() => sp.GetRequiredService<SessionEventPublisher>().Status,
() => sp.GetRequiredService<AgentCommandHandler>(),
sp.GetRequiredService<AdvancedMachineResponder>()));
() => sp.GetRequiredService<AgentCommandHandler>()));
services.AddSingleton(static sp => new PipeServer(
sp.GetRequiredService<PipeServerOptions>(),
sp.GetRequiredService<IIpcRequestHandler>(),
-10
View File
@@ -108,10 +108,6 @@ public partial class App : System.Windows.Application
LoggingLevel.SetDebug(await registered.GetBooleanAsync(SettingsRegistry.LogDebug).ConfigureAwait(true));
FpsDecimals.Two = await registered.GetBooleanAsync(SettingsRegistry.UiFpsDecimals).ConfigureAwait(true);
ScrollBarHiding.Apply(await registered.GetBooleanAsync(SettingsRegistry.UiHideScrollBars).ConfigureAwait(true));
// Advanced metrics (D101/D105): the page is offered while the option is on - and in a viewer also when the copy holds
// a session recorded with it on, since that is what a copy is opened to look at.
AdvancedOption.IsOn = await registered.GetBooleanAsync(SettingsRegistry.TelemetryAdvanced).ConfigureAwait(true)
|| (UiPaths.IsViewer && (await new SqliteSessionRepository(_db).ListAdvancedAsync(1).ConfigureAwait(true)).Count > 0);
var closePolicy = new WindowClosePolicy { MinimizeToTray = await registered.GetBooleanAsync(SettingsRegistry.UiMinimizeToTray).ConfigureAwait(true) };
_host = BuildHost(_db, appearance, registered, closePolicy);
@@ -363,9 +359,6 @@ public partial class App : System.Windows.Application
builder.Services.AddTransient<GameDetailViewModel>();
builder.Services.AddTransient<ComparePage>();
builder.Services.AddTransient<CompareViewModel>();
builder.Services.AddTransient<AdvancedPage>();
builder.Services.AddTransient<AdvancedViewModel>();
builder.Services.AddSingleton<AdvancedSelection>();
builder.Services.AddTransient<LogsPage>();
builder.Services.AddTransient<LogsViewModel>();
builder.Services.AddTransient<SettingsPage>();
@@ -490,9 +483,6 @@ public partial class App : System.Windows.Application
sp.GetRequiredService<Application.Play.IGogGalaxyLocator>(),
sp.GetRequiredService<IShellStarter>(),
sp.GetRequiredService<IAgentRequests>()));
// Advanced metrics (D101/D107): "this PC, now" for its page. It asks the Agent only while a page watches it, and a
// viewer's link is never connected - so it says "no agent" there.
services.AddSingleton(static sp => new AdvancedMachineFeed(sp.GetRequiredService<IAgentRequests>(), TimeProvider.System));
services.AddSingleton<IExecutableIdentitySource, ExecutableIdentitySource>();
services.AddSingleton(static sp => new LibraryImporter(
sp.GetServices<IStoreLibrarySource>(),
@@ -1,11 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.App.Charts;
/// <summary>One line of the Advanced page's chart: its legend text and its points.</summary>
/// <param name="Label">What the line is.</param>
/// <param name="Xs">Seconds from the session's start, or OLE automation dates for a live chart.</param>
/// <param name="Ys">The values, in the unit of the catalog entry.</param>
[System.Diagnostics.CodeAnalysis.SuppressMessage("Performance", "CA1819:Properties should not return arrays", Justification = "a data carrier for the chart, as SensorSeries is")]
public sealed record AdvancedChartLine(string Label, double[] Xs, double[] Ys);
@@ -1,13 +0,0 @@
<!-- SPDX-License-Identifier: GPL-3.0-only -->
<!-- Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE -->
<UserControl x:Class="FrameLedger.App.Charts.AdvancedSeriesChart"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:charts="clr-namespace:FrameLedger.App.Charts"
xmlns:res="clr-namespace:FrameLedger.App"
MinHeight="260">
<!-- 08_UI §Advanced: one catalog entry over time - its series, or their lowest, average and highest above eight. The
table beside it on the page lists the same readings (A11y_ChartData_Advanced). -->
<charts:ChartPlot x:Name="Plot" AutomationProperties.Name="{x:Static res:Strings.A11y_Chart_Advanced}" AutomationProperties.HelpText="{x:Static res:Strings.A11y_ChartData_Advanced}" />
</UserControl>
@@ -1,90 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using System.Windows.Controls;
using ScottPlot;
using ScottPlot.Plottables;
namespace FrameLedger.App.Charts;
/// <summary>
/// The Advanced page's chart (owner decision D101): the series of one catalog entry over time. <see cref="TimeOfDay"/>
/// says what the horizontal axis is — the clock, for what the PC reads now, or seconds from a session's start — and is
/// set once, before the first <see cref="Show"/>: a date axis replaces the bottom axis and is not swapped back.
/// </summary>
/// <remarks>
/// Lines differ by pattern and marker as well as by colour (<see cref="ChartPatterns"/>), so a chart read without
/// colour still tells them apart; and a series with one reading is a point, not an invisible line.
/// </remarks>
public partial class AdvancedSeriesChart : UserControl
{
private bool _dateAxis;
public AdvancedSeriesChart()
{
InitializeComponent();
ChartTheme.Attach(Plot);
}
/// <summary>True when the points' x values are OLE automation dates (a live chart); false for seconds from a session's start.</summary>
public bool TimeOfDay { get; set; }
public Plot ScottPlot => Plot.Plot;
/// <summary>How many lines the last <see cref="Show"/> drew — what a test reads.</summary>
public int DrawnLines { get; private set; }
/// <summary>Draws <paramref name="lines"/> against <paramref name="unit"/>; no line clears the chart.</summary>
public void Show(IReadOnlyList<AdvancedChartLine> lines, string unit)
{
ArgumentNullException.ThrowIfNull(lines);
Plot plot = Plot.Plot;
plot.Clear();
if (TimeOfDay && !_dateAxis)
{
// Before the theme and the labels: the date axis REPLACES the bottom axis and would drop both (TrendChart).
plot.Axes.DateTimeTicksBottom();
_dateAxis = true;
}
ChartTheme.Apply(plot);
plot.XLabel(TimeOfDay ? Strings.Advanced_Chart_Time : Strings.Advanced_Chart_Seconds);
plot.YLabel(unit ?? string.Empty);
ChartPalette p = ChartTheme.Current;
Color[] palette = [p.Native, p.Displayed, p.Percentile, p.Sensor, p.SensorSecondary, p.Stutter, p.Histogram, p.Segment];
int drawn = 0;
foreach (AdvancedChartLine line in lines)
{
if (line.Xs.Length == 0 || line.Xs.Length != line.Ys.Length)
{
continue;
}
Scatter scatter = plot.Add.Scatter(line.Xs, line.Ys, palette[drawn % palette.Length]);
scatter.LineWidth = 2;
scatter.MarkerSize = line.Xs.Length == 1 ? 7 : 0;
scatter.LegendText = line.Label;
ChartPatterns.Line(scatter, drawn);
if (line.Xs.Length == 1)
{
ChartPatterns.Points(scatter, drawn);
}
drawn++;
}
DrawnLines = drawn;
if (drawn > 0)
{
plot.Axes.AutoScale();
plot.ShowLegend(Alignment.UpperLeft);
}
else
{
plot.HideLegend();
}
Plot.Refresh();
}
}
@@ -37,49 +37,6 @@ public sealed class SessionSeriesLoader
public Task<IReadOnlyList<SensorSeries>> LoadSensorsAsync(long sessionId, CancellationToken ct = default) =>
Task.Run(async () => (IReadOnlyList<SensorSeries>)DecodeSensors(await _sessions.FindSensorsAsync(sessionId, ct).ConfigureAwait(false), offsetS: 0), ct);
/// <summary>
/// The session's advanced series (owner decision D102), timed from the session's start by the same <c>t_ms</c> clock
/// as the sensors. A tick with no reading — NaN, and most ticks of a sensor read every fifth — is left out, never drawn
/// as a zero; a series may be negative, so nothing else is. Empty for a session recorded with the option off. On the
/// thread pool, as <see cref="LoadAsync"/>.
/// </summary>
public Task<IReadOnlyList<SensorSeries>> LoadAdvancedAsync(long sessionId, CancellationToken ct = default) =>
Task.Run(async () => DecodeAdvanced(await _sessions.FindAdvancedSensorsAsync(sessionId, ct).ConfigureAwait(false)), ct);
/// <summary>The advanced blobs decoded: <c>t_ms</c> is their clock, NaN is "no reading".</summary>
public static IReadOnlyList<SensorSeries> DecodeAdvanced(IReadOnlyList<SensorBlob> blobs)
{
ArgumentNullException.ThrowIfNull(blobs);
SensorBlob? clock = blobs.FirstOrDefault(static s => string.Equals(s.Series, "t_ms", StringComparison.Ordinal));
float[]? tMs = clock is null || !string.Equals(clock.Codec, SeriesCodec.Tag, StringComparison.Ordinal) ? null : SeriesCodec.DecodeFloat32(clock.Data.ToArray());
var result = new List<SensorSeries>();
foreach (SensorBlob blob in blobs)
{
if (string.Equals(blob.Series, "t_ms", StringComparison.Ordinal) || !string.Equals(blob.Codec, SeriesCodec.Tag, StringComparison.Ordinal))
{
continue;
}
float[] values = SeriesCodec.DecodeFloat32(blob.Data.ToArray());
var xs = new List<double>();
var ys = new List<double>();
for (int i = 0; i < values.Length; i++)
{
if (float.IsNaN(values[i]))
{
continue;
}
xs.Add(tMs is not null && i < tMs.Length ? tMs[i] / 1000.0 : i / Math.Max(blob.Hz, 0.001));
ys.Add(values[i]);
}
result.Add(new SensorSeries(blob.Series, [.. xs], [.. ys]));
}
return result;
}
private async Task<SessionSeries?> ReadAndDecodeAsync(long sessionId, CancellationToken ct)
{
FrameBlobs? frames = await _sessions.FindFramesAsync(sessionId, ct).ConfigureAwait(false);
-8
View File
@@ -24,14 +24,11 @@
<KeyBinding Command="{Binding ViewModel.NavigateToCommand}" CommandParameter="3" Key="D3" Modifiers="Control" />
<KeyBinding Command="{Binding ViewModel.NavigateToCommand}" CommandParameter="4" Key="D4" Modifiers="Control" />
<KeyBinding Command="{Binding ViewModel.NavigateToCommand}" CommandParameter="5" Key="D5" Modifiers="Control" />
<!-- Ctrl+6 (owner decision D105): the Advanced page, only while its option is on - ShellShortcuts refuses it otherwise. -->
<KeyBinding Command="{Binding ViewModel.NavigateToCommand}" CommandParameter="6" Key="D6" Modifiers="Control" />
<KeyBinding Command="{Binding ViewModel.NavigateToCommand}" CommandParameter="1" Key="NumPad1" Modifiers="Control" />
<KeyBinding Command="{Binding ViewModel.NavigateToCommand}" CommandParameter="2" Key="NumPad2" Modifiers="Control" />
<KeyBinding Command="{Binding ViewModel.NavigateToCommand}" CommandParameter="3" Key="NumPad3" Modifiers="Control" />
<KeyBinding Command="{Binding ViewModel.NavigateToCommand}" CommandParameter="4" Key="NumPad4" Modifiers="Control" />
<KeyBinding Command="{Binding ViewModel.NavigateToCommand}" CommandParameter="5" Key="NumPad5" Modifiers="Control" />
<KeyBinding Command="{Binding ViewModel.NavigateToCommand}" CommandParameter="6" Key="NumPad6" Modifiers="Control" />
</ui:FluentWindow.InputBindings>
<!--
@@ -189,11 +186,6 @@
<ui:NavigationViewItem Content="{x:Static res:Strings.Nav_Logs}"
Icon="{ui:SymbolIcon DocumentText24}"
TargetPageType="{x:Type pages:LogsPage}" />
<!-- Advanced metrics (owner decisions D101/D105): last in the menu, and there only while the option is on. -->
<ui:NavigationViewItem Content="{x:Static res:Strings.Nav_Advanced}"
Icon="{ui:SymbolIcon DataUsage24}"
TargetPageType="{x:Type pages:AdvancedPage}"
Visibility="{Binding Path=(services:AdvancedOption.IsOn), Converter={StaticResource BoolToVis}}" />
</ui:NavigationView.MenuItems>
<ui:NavigationView.FooterMenuItems>
<ui:NavigationViewItem Content="{x:Static res:Strings.Nav_Settings}"
-183
View File
@@ -1,183 +0,0 @@
<!-- SPDX-License-Identifier: GPL-3.0-only -->
<!-- Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE -->
<Page x:Class="FrameLedger.App.Pages.AdvancedPage"
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:charts="clr-namespace:FrameLedger.App.Charts"
xmlns:controls="clr-namespace:FrameLedger.App.Controls"
xmlns:res="clr-namespace:FrameLedger.App"
xmlns:vm="clr-namespace:FrameLedger.App.ViewModels"
Title="{x:Static res:Strings.Advanced_Header}"
Foreground="{DynamicResource TextFillColorPrimaryBrush}"
ScrollViewer.CanContentScroll="False">
<!--
08_UI §Advanced (owner decision D101). Three tabs, by what a value belongs to: This PC - what the Agent reads now,
asked only while this page is on screen (D107) and never stored; Session - what a session recorded with the option
on stored; Sources - every entry of the catalog with whether it is read, or why not. A reason is always words,
never a colour alone, and each chart has its readings in a table beside it.
-->
<Page.Resources>
<!-- One fact: label and value in two columns that line up within a group; a table-valued fact unfolds its rows.
Both templates are implicit - found by the type they show - so nothing on the page names a resource key. -->
<DataTemplate DataType="{x:Type vm:AdvancedFactRow}">
<StackPanel>
<Grid Margin="0,2,0,0" Visibility="{Binding HasDetails, Converter={StaticResource InverseBoolToVis}}">
<Grid.ColumnDefinitions>
<ColumnDefinition Width="Auto" SharedSizeGroup="AdvancedFactLabel" />
<ColumnDefinition Width="*" />
</Grid.ColumnDefinitions>
<TextBlock MaxWidth="460" Style="{StaticResource FieldLabel}" Text="{Binding Label}" TextWrapping="Wrap" />
<TextBlock Grid.Column="1" Style="{StaticResource FieldValue}" Text="{Binding Value}" TextWrapping="Wrap" />
</Grid>
<Expander Margin="0,2,0,4" Visibility="{Binding HasDetails, Converter={StaticResource BoolToVis}}">
<Expander.Header>
<TextBlock TextWrapping="Wrap">
<Run Text="{Binding Label, Mode=OneWay}" /><Run Text=" (" /><Run Text="{Binding Value, Mode=OneWay}" /><Run Text=")" />
</TextBlock>
</Expander.Header>
<ItemsControl Margin="12,4,0,0" Focusable="False" Grid.IsSharedSizeScope="True" ItemsSource="{Binding Details}">
<ItemsControl.ItemTemplate>
<DataTemplate DataType="{x:Type vm:AdvancedDetailRow}">
<Grid>
<Grid.ColumnDefinitions>
<ColumnDefinition Width="Auto" SharedSizeGroup="AdvancedDetailName" />
<ColumnDefinition Width="*" />
</Grid.ColumnDefinitions>
<TextBlock MaxWidth="460" Style="{StaticResource FieldLabel}" Text="{Binding Name}" TextWrapping="Wrap" />
<TextBlock Grid.Column="1" Style="{StaticResource FieldValue}" Text="{Binding Value}" TextWrapping="Wrap" />
</Grid>
</DataTemplate>
</ItemsControl.ItemTemplate>
</ItemsControl>
</Expander>
</StackPanel>
</DataTemplate>
<!-- A group of the catalog under its heading. -->
<DataTemplate DataType="{x:Type vm:AdvancedFactGroup}">
<StackPanel Margin="0,12,0,0">
<ui:TextBlock AutomationProperties.HeadingLevel="Level3" FontTypography="BodyStrong" Text="{Binding Title}" />
<ItemsControl Margin="0,4,0,0" Focusable="False" Grid.IsSharedSizeScope="True" ItemsSource="{Binding Rows}" />
</StackPanel>
</DataTemplate>
</Page.Resources>
<ScrollViewer VerticalScrollBarVisibility="Auto">
<StackPanel Style="{StaticResource PageRoot}">
<ui:TextBlock AutomationProperties.HeadingLevel="Level1" FontTypography="Title" Text="{x:Static vm:AdvancedViewModel.Header}" />
<TabControl Margin="0,16,0,0" SelectedIndex="{Binding ViewModel.SelectedTab, Mode=TwoWay}">
<!-- This PC: read now, by the Agent, only while this page is open. -->
<TabItem Header="{x:Static vm:AdvancedViewModel.TabMachine}">
<StackPanel Margin="0,12,0,0">
<ui:TextBlock Style="{StaticResource SecondaryText}" Text="{x:Static res:Strings.Advanced_Machine_Intro}" TextWrapping="Wrap" />
<ui:TextBlock Margin="0,8,0,0" Text="{Binding ViewModel.MachineStatus}" TextWrapping="Wrap" />
<ui:TextBlock Margin="0,4,0,0" Style="{StaticResource SecondaryText}" Text="{x:Static res:Strings.Advanced_Elevation_Hint}" TextWrapping="Wrap"
Visibility="{Binding ViewModel.ShowElevationHint, Converter={StaticResource BoolToVis}}" />
<ui:TextBlock Margin="0,20,0,0" AutomationProperties.HeadingLevel="Level2" FontTypography="Subtitle" Text="{x:Static res:Strings.Advanced_Facts_Header}" />
<ItemsControl Focusable="False" ItemsSource="{Binding ViewModel.MachineGroups}" />
<ui:TextBlock Margin="0,20,0,0" AutomationProperties.HeadingLevel="Level2" FontTypography="Subtitle" Text="{x:Static res:Strings.Advanced_Now_Header}" />
<DataGrid MaxHeight="360" Margin="0,8,0,0" AutoGenerateColumns="False" AutomationProperties.Name="{x:Static res:Strings.Advanced_Now_Header}"
CanUserAddRows="False" HeadersVisibility="Column" IsReadOnly="True" ItemsSource="{Binding ViewModel.LiveRows}" SelectionMode="Single">
<DataGrid.Columns>
<DataGridTextColumn Width="Auto" MinWidth="320" Binding="{Binding Label}" Header="{x:Static res:Strings.Advanced_Col_Name}" />
<DataGridTextColumn Width="Auto" MinWidth="120" Binding="{Binding Value}" Header="{x:Static res:Strings.Advanced_Col_Value}" />
<DataGridTextColumn Width="Auto" MinWidth="110" Binding="{Binding ReadAt}" Header="{x:Static res:Strings.Advanced_Col_ReadAt}" />
<DataGridTemplateColumn Width="*" CanUserResize="False" CanUserSort="False" IsReadOnly="True" controls:CellName.Path="Label" />
</DataGrid.Columns>
</DataGrid>
<ui:TextBlock Margin="0,20,0,0" AutomationProperties.HeadingLevel="Level2" FontTypography="Subtitle" Text="{x:Static res:Strings.Advanced_Chart_Header}" />
<StackPanel Margin="0,8,0,0" Orientation="Horizontal">
<ui:TextBlock Margin="0,0,8,0" VerticalAlignment="Center" Text="{x:Static res:Strings.Advanced_Chart_Metric}" />
<ComboBox MinWidth="360" AutomationProperties.Name="{x:Static res:Strings.A11y_Advanced_Metric}" DisplayMemberPath="Label"
ItemsSource="{Binding ViewModel.LiveMetrics}" SelectedItem="{Binding ViewModel.SelectedLiveMetric, Mode=TwoWay}" />
</StackPanel>
<ui:TextBlock Margin="0,6,0,0" Style="{StaticResource SecondaryText}" Text="{x:Static res:Strings.Advanced_Chart_LiveNote}" TextWrapping="Wrap" />
<ui:TextBlock Margin="0,4,0,0" Style="{StaticResource SecondaryText}" Text="{x:Static res:Strings.Advanced_Chart_Band}" TextWrapping="Wrap"
Visibility="{Binding ViewModel.LiveBand, Converter={StaticResource BoolToVis}}" />
<ui:TextBlock Margin="0,12,0,0" Style="{StaticResource SecondaryText}" Text="{x:Static res:Strings.Advanced_Chart_Empty}"
Visibility="{Binding ViewModel.LiveChartEmpty, Converter={StaticResource BoolToVis}}" />
<charts:AdvancedSeriesChart x:Name="LiveChart" Height="320" Margin="0,8,0,0" TimeOfDay="True"
Visibility="{Binding ViewModel.LiveChartEmpty, Converter={StaticResource InverseBoolToVis}}" />
</StackPanel>
</TabItem>
<!-- Session: what one session recorded with the option on stored. -->
<TabItem Header="{x:Static vm:AdvancedViewModel.TabSession}">
<StackPanel Margin="0,12,0,0">
<ui:TextBlock Style="{StaticResource SecondaryText}" Text="{x:Static res:Strings.Advanced_Session_Empty}" TextWrapping="Wrap"
Visibility="{Binding ViewModel.NoSessions, Converter={StaticResource BoolToVis}}" />
<StackPanel Visibility="{Binding ViewModel.NoSessions, Converter={StaticResource InverseBoolToVis}}">
<StackPanel Orientation="Horizontal">
<ui:TextBlock Margin="0,0,8,0" VerticalAlignment="Center" Text="{x:Static res:Strings.Advanced_Session_Pick}" />
<ComboBox MinWidth="420" AutomationProperties.Name="{x:Static res:Strings.A11y_Advanced_Session}" DisplayMemberPath="Text"
ItemsSource="{Binding ViewModel.SessionOptions}" SelectedItem="{Binding ViewModel.SelectedSession, Mode=TwoWay}" />
</StackPanel>
<ui:TextBlock Margin="0,8,0,0" Style="{StaticResource SecondaryText}" Text="{Binding ViewModel.SessionSources}" TextWrapping="Wrap"
Visibility="{Binding ViewModel.SessionSources, Converter={StaticResource NullToCollapsed}}" />
<ui:TextBlock Margin="0,20,0,0" AutomationProperties.HeadingLevel="Level2" FontTypography="Subtitle" Text="{x:Static res:Strings.Advanced_Session_Facts}" />
<ItemsControl Focusable="False" ItemsSource="{Binding ViewModel.SessionGroups}" />
<ui:TextBlock Margin="0,20,0,0" AutomationProperties.HeadingLevel="Level2" FontTypography="Subtitle" Text="{x:Static res:Strings.Advanced_Session_Stats}" />
<ui:TextBlock Margin="0,8,0,0" Style="{StaticResource SecondaryText}" Text="{x:Static res:Strings.Advanced_Session_NoStats}" TextWrapping="Wrap"
Visibility="{Binding ViewModel.SessionHasNoStats, Converter={StaticResource BoolToVis}}" />
<DataGrid MaxHeight="360" Margin="0,8,0,0" AutoGenerateColumns="False" AutomationProperties.Name="{x:Static res:Strings.Advanced_Session_Stats}"
CanUserAddRows="False" HeadersVisibility="Column" IsReadOnly="True" ItemsSource="{Binding ViewModel.SessionStats}" SelectionMode="Single"
Visibility="{Binding ViewModel.SessionHasNoStats, Converter={StaticResource InverseBoolToVis}}">
<DataGrid.Columns>
<DataGridTextColumn Width="Auto" MinWidth="320" Binding="{Binding Label}" Header="{x:Static res:Strings.Advanced_Col_Name}" />
<DataGridTextColumn Width="Auto" MinWidth="90" Binding="{Binding Samples}" Header="{x:Static res:Strings.Advanced_Col_Samples}" />
<DataGridTextColumn Width="Auto" MinWidth="110" Binding="{Binding Min}" Header="{x:Static res:Strings.Advanced_Min}" />
<DataGridTextColumn Width="Auto" MinWidth="110" Binding="{Binding Mean}" Header="{x:Static res:Strings.Advanced_Mean}" />
<DataGridTextColumn Width="Auto" MinWidth="110" Binding="{Binding Max}" Header="{x:Static res:Strings.Advanced_Max}" />
<DataGridTemplateColumn Width="*" CanUserResize="False" CanUserSort="False" IsReadOnly="True" controls:CellName.Path="Label" />
</DataGrid.Columns>
</DataGrid>
<ui:TextBlock Margin="0,20,0,0" AutomationProperties.HeadingLevel="Level2" FontTypography="Subtitle" Text="{x:Static res:Strings.Advanced_Chart_Header}" />
<ui:TextBlock Margin="0,8,0,0" Style="{StaticResource SecondaryText}" Text="{x:Static res:Strings.Advanced_Session_NoSeries}" TextWrapping="Wrap"
Visibility="{Binding ViewModel.SessionSeriesGone, Converter={StaticResource BoolToVis}}" />
<StackPanel Margin="0,8,0,0" Orientation="Horizontal">
<ui:TextBlock Margin="0,0,8,0" VerticalAlignment="Center" Text="{x:Static res:Strings.Advanced_Chart_Metric}" />
<ComboBox MinWidth="360" AutomationProperties.Name="{x:Static res:Strings.A11y_Advanced_Metric}" DisplayMemberPath="Label"
ItemsSource="{Binding ViewModel.SessionMetrics}" SelectedItem="{Binding ViewModel.SelectedSessionMetric, Mode=TwoWay}" />
</StackPanel>
<ui:TextBlock Margin="0,4,0,0" Style="{StaticResource SecondaryText}" Text="{x:Static res:Strings.Advanced_Chart_Band}" TextWrapping="Wrap"
Visibility="{Binding ViewModel.SessionBand, Converter={StaticResource BoolToVis}}" />
<ui:TextBlock Margin="0,12,0,0" Style="{StaticResource SecondaryText}" Text="{x:Static res:Strings.Advanced_Chart_Empty}"
Visibility="{Binding ViewModel.SessionChartEmpty, Converter={StaticResource BoolToVis}}" />
<charts:AdvancedSeriesChart x:Name="SessionChart" Height="320" Margin="0,8,0,0"
Visibility="{Binding ViewModel.SessionChartEmpty, Converter={StaticResource InverseBoolToVis}}" />
</StackPanel>
</StackPanel>
</TabItem>
<!-- Sources: the whole catalog, read or not, with the reason. -->
<TabItem Header="{x:Static vm:AdvancedViewModel.TabSources}">
<StackPanel Margin="0,12,0,0">
<ui:TextBlock Style="{StaticResource SecondaryText}" Text="{x:Static res:Strings.Advanced_Sources_Intro}" TextWrapping="Wrap" />
<ui:TextBlock Margin="0,8,0,0" Text="{Binding ViewModel.SourcesNow}" TextWrapping="Wrap"
Visibility="{Binding ViewModel.SourcesNow, Converter={StaticResource NullToCollapsed}}" />
<ui:TextBlock Margin="0,4,0,0" Style="{StaticResource SecondaryText}" Text="{x:Static res:Strings.Advanced_Elevation_Hint}" TextWrapping="Wrap" />
<DataGrid MaxHeight="560" Margin="0,12,0,0" AutoGenerateColumns="False" AutomationProperties.Name="{x:Static vm:AdvancedViewModel.TabSources}"
CanUserAddRows="False" HeadersVisibility="Column" IsReadOnly="True" ItemsSource="{Binding ViewModel.SourceRows}" SelectionMode="Single">
<DataGrid.Columns>
<DataGridTextColumn Width="Auto" MinWidth="320" MaxWidth="520" Binding="{Binding Label}" Header="{x:Static res:Strings.Advanced_Col_Name}" />
<DataGridTextColumn Width="Auto" MinWidth="120" Binding="{Binding Scope}" Header="{x:Static res:Strings.Advanced_Col_Scope}" />
<DataGridTextColumn Width="Auto" MinWidth="140" Binding="{Binding Source}" Header="{x:Static res:Strings.Advanced_Col_Source}" />
<DataGridTextColumn Width="Auto" MinWidth="260" Binding="{Binding Status}" Header="{x:Static res:Strings.Advanced_Col_Status}" />
<DataGridTemplateColumn Width="*" CanUserResize="False" CanUserSort="False" IsReadOnly="True" controls:CellName.Path="Label" />
</DataGrid.Columns>
</DataGrid>
</StackPanel>
</TabItem>
</TabControl>
</StackPanel>
</ScrollViewer>
</Page>
@@ -1,47 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using FrameLedger.App.ViewModels;
using Wpf.Ui.Abstractions.Controls;
namespace FrameLedger.App.Pages;
/// <summary>
/// The Advanced page (owner decision D101; <c>08_UI</c> §Advanced). The view model asks the Agent about this PC only
/// between <c>Loaded</c> and <c>Unloaded</c> — which is what lets the Agent stop reading sensors when no game runs
/// and the page is closed (D107) — and the two charts are drawn here from the lines it presents.
/// </summary>
public partial class AdvancedPage : INavigableView<AdvancedViewModel>
{
public AdvancedPage(AdvancedViewModel viewModel)
{
ViewModel = viewModel ?? throw new ArgumentNullException(nameof(viewModel));
DataContext = this;
InitializeComponent();
ViewModel.LivePresented += OnLivePresented;
ViewModel.SessionPresented += OnSessionPresented;
OnLivePresented(this, EventArgs.Empty);
OnSessionPresented(this, EventArgs.Empty);
Loaded += (_, _) => ViewModel.Attach();
Unloaded += (_, _) => ViewModel.Detach();
IsVisibleChanged += (_, e) =>
{
// A window hidden to the tray is not on screen either: the Agent is not asked for a page nobody sees.
if (e.NewValue is true && IsLoaded)
{
ViewModel.Attach();
}
else if (e.NewValue is false)
{
ViewModel.Detach();
}
};
}
public AdvancedViewModel ViewModel { get; }
private void OnLivePresented(object? sender, EventArgs e) => LiveChart.Show(ViewModel.LiveLines, ViewModel.LiveUnit);
private void OnSessionPresented(object? sender, EventArgs e) => SessionChart.Show(ViewModel.SessionLines, ViewModel.SessionUnit);
}
@@ -214,19 +214,6 @@
SpinButtonPlacementMode="Inline"
Value="{Binding ViewModel.RetentionRawSessions, Mode=TwoWay}" />
</ui:CardControl>
<!-- Advanced metrics (owner decision D101, 2026-11-11): off by default, and off means nothing more is read or
stored. The Agent reads it at each session's start, so it is off in a viewer like every setting it reads. -->
<ui:CardControl Margin="0,8,0,0" Icon="{ui:SymbolIcon DataUsage24}">
<ui:CardControl.Header>
<StackPanel>
<ui:TextBlock FontTypography="BodyStrong" Text="{x:Static res:Strings.Settings_Advanced_Label}" />
<ui:TextBlock MaxWidth="560" HorizontalAlignment="Left" Style="{StaticResource SecondaryText}" Text="{x:Static res:Strings.Settings_Advanced_Body}" TextWrapping="Wrap" />
</StackPanel>
</ui:CardControl.Header>
<ui:ToggleSwitch AutomationProperties.Name="{x:Static res:Strings.Settings_Advanced_Label}"
IsChecked="{Binding ViewModel.AdvancedMetrics, Mode=TwoWay}"
IsEnabled="{Binding ViewModel.ActsOnThisPc}" />
</ui:CardControl>
<!-- beta.12: "Record games launched outside FrameLedger" stood here; nothing read it (capture.background,
06_DATA_MODEL §Settings registry), and with no way to start a game from the App "off" could only have
meant recording nothing. Removed until a launch path exists. -->
@@ -1,26 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.App.Services;
/// <summary>What <see cref="AdvancedMachineFeed"/> last learnt from the Agent about "this PC, now" (owner decision D101).</summary>
public enum AdvancedFeedState
{
/// <summary>Nobody watches: nothing is asked, and the Agent's reader is not held for the page.</summary>
Stopped,
/// <summary>Asked, and the Agent's reader has not finished its first read.</summary>
Waiting,
/// <summary>The last request was answered with a snapshot.</summary>
Live,
/// <summary>The Agent answered that Advanced metrics is off: it reads nothing.</summary>
Off,
/// <summary>No Agent answered — not connected, a viewer, a request that timed out or failed. What was shown stays, as old as it is.</summary>
NoAgent,
/// <summary>The Agent is an older one that does not know the request.</summary>
OlderAgent,
}
@@ -1,12 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using System.Runtime.InteropServices;
namespace FrameLedger.App.Services;
/// <summary>One live reading of an advanced series: its value and when the Agent's reader read it.</summary>
/// <param name="At">The tick it was read on, by the Agent's clock.</param>
/// <param name="Value">The value, in the unit of its catalog entry.</param>
[StructLayout(LayoutKind.Auto)]
public readonly record struct AdvancedLivePoint(DateTimeOffset At, double Value);
@@ -1,296 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using FrameLedger.Application.Advanced;
using FrameLedger.Infrastructure.Ipc;
using FrameLedger.Shared.Ipc;
using Serilog;
namespace FrameLedger.App.Services;
/// <summary>
/// "This PC, now" for the Advanced page (owner decisions D101 and D107): while somebody watches, asks the Agent
/// <c>GetAdvancedMachine</c> once a second and keeps what it answered — the facts, the last value of every series, a
/// short history of each for the live charts, and which sources answer.
/// </summary>
/// <remarks>
/// <para>
/// <b>Watching is what makes the Agent read.</b> Each request keeps the Agent's shared reader running for a few
/// seconds (<c>Application.Ipc.AdvancedMachineResponder</c>), so nothing is asked — and with no game running no sensor
/// is read — unless a page holds <see cref="Watch"/>. The page lets go when it is unloaded or its window is hidden.
/// </para>
/// <para>
/// <b>Nothing here is stored.</b> The history lives in memory, a few minutes long, and is gone with the App; what a
/// session stores is the Agent's, in the ledger.
/// </para>
/// <para>
/// It fires <see cref="Changed"/> on the thread pool, like the Agent's link; a view model marshals through
/// <c>UiThread</c>.
/// </para>
/// </remarks>
public sealed class AdvancedMachineFeed : IDisposable
{
/// <summary>How many points of each series are kept for the live charts: five minutes at one a second.</summary>
public const int HistoryPoints = 300;
private static readonly TimeSpan _defaultInterval = TimeSpan.FromSeconds(1);
private readonly IAgentRequests _agent;
private readonly TimeProvider _clock;
private readonly TimeSpan _interval;
private readonly Lock _gate = new();
private readonly Dictionary<string, AdvancedLivePoint> _values = new(StringComparer.Ordinal);
private readonly Dictionary<string, Queue<AdvancedLivePoint>> _history = new(StringComparer.Ordinal);
private IReadOnlyList<AdvancedFact> _facts = [];
private string? _factsHash;
private long _lastTick = long.MinValue;
private IReadOnlyList<AdvancedSeriesInfo> _series = [];
private AdvancedSources _sources = AdvancedSources.Unknown;
private int _watchers;
private CancellationTokenSource? _stop;
private volatile AdvancedMachineView _current = AdvancedMachineView.Stopped;
/// <summary>Over the App's requests to the Agent — a viewer's link is never connected, and the feed says so.</summary>
public AdvancedMachineFeed(IAgentRequests agent, TimeProvider clock, TimeSpan? interval = null)
{
_agent = agent ?? throw new ArgumentNullException(nameof(agent));
_clock = clock ?? throw new ArgumentNullException(nameof(clock));
_interval = interval ?? _defaultInterval;
}
/// <summary>After every request while watched, and once when the last watcher lets go.</summary>
public event EventHandler? Changed;
/// <summary>What was last learnt.</summary>
public AdvancedMachineView Current => _current;
/// <summary>
/// Asks the Agent once a second until the returned handle is disposed. The first watcher starts the asking and the
/// last one stops it; a handle disposed twice counts once.
/// </summary>
public IDisposable Watch()
{
lock (_gate)
{
if (_watchers++ == 0)
{
var stop = new CancellationTokenSource();
_stop = stop;
_ = Task.Run(() => RunAsync(stop.Token), CancellationToken.None);
}
}
return new Watcher(this);
}
/// <summary>The kept points of one series, oldest first; empty for a series never read.</summary>
public IReadOnlyList<AdvancedLivePoint> HistoryOf(string series)
{
lock (_gate)
{
return _history.TryGetValue(series, out Queue<AdvancedLivePoint>? points) ? [.. points] : [];
}
}
/// <summary>One request and what it came to. The loop's body, and what a test calls.</summary>
public async Task PollOnceAsync(CancellationToken ct = default)
{
AdvancedFeedState state;
AdvancedMachineAck? ack = null;
try
{
string? hash;
lock (_gate)
{
hash = _factsHash;
}
IpcEnvelope envelope = await _agent.RequestAsync(IpcMessageType.GetAdvancedMachine, new GetAdvancedMachineRequest(hash), ct).ConfigureAwait(false);
ack = IpcCodec.Payload<AdvancedMachineAck>(envelope);
state = ack switch
{
null => AdvancedFeedState.NoAgent,
{ Ready: false } => AdvancedFeedState.Waiting,
_ => AdvancedFeedState.Live,
};
}
catch (IpcRequestException ex) when (string.Equals(ex.Code, IpcErrorCode.AdvancedOff, StringComparison.Ordinal))
{
state = AdvancedFeedState.Off;
}
catch (IpcRequestException ex) when (string.Equals(ex.Code, IpcErrorCode.UnknownType, StringComparison.Ordinal))
{
state = AdvancedFeedState.OlderAgent;
}
catch (IpcRequestException ex)
{
Log.Warning("advanced: GetAdvancedMachine failed ({Code}: {Message})", ex.Code, ex.Message);
state = AdvancedFeedState.NoAgent;
}
catch (Exception ex) when (ex is InvalidOperationException or TimeoutException or System.IO.IOException)
{
// Not connected (a viewer never is), no answer in time, or the pipe dropped: the next second asks again.
state = AdvancedFeedState.NoAgent;
}
if (!ct.IsCancellationRequested)
{
// A request still in flight when the last watcher let go answers nobody: "stopped" was already said.
Publish(state, ack);
}
}
public void Dispose()
{
CancellationTokenSource? stop;
lock (_gate)
{
_watchers = 0;
stop = _stop;
_stop = null;
}
stop?.Cancel();
stop?.Dispose();
}
private async Task RunAsync(CancellationToken ct)
{
using var timer = new PeriodicTimer(_interval, _clock);
try
{
do
{
await PollOnceAsync(ct).ConfigureAwait(false);
}
while (await timer.WaitForNextTickAsync(ct).ConfigureAwait(false));
}
catch (OperationCanceledException)
{
// The last watcher let go.
}
}
private void Release()
{
CancellationTokenSource? stop;
lock (_gate)
{
if (_watchers == 0 || --_watchers > 0)
{
return;
}
stop = _stop;
_stop = null;
}
stop?.Cancel();
stop?.Dispose();
Publish(AdvancedFeedState.Stopped, ack: null);
}
private void Publish(AdvancedFeedState state, AdvancedMachineAck? ack)
{
AdvancedMachineView view;
lock (_gate)
{
if (state == AdvancedFeedState.Off)
{
// Off means nothing is read: what was shown is not "now" any more, and is not kept as if it were.
Forget();
}
else if (state == AdvancedFeedState.Live && ack is not null)
{
Apply(ack);
}
view = new AdvancedMachineView(
state,
_lastTick == long.MinValue ? null : DateTimeOffset.FromUnixTimeMilliseconds(_lastTick),
_facts,
new Dictionary<string, AdvancedLivePoint>(_values, StringComparer.Ordinal),
_series,
_sources);
}
_current = view;
Changed?.Invoke(this, EventArgs.Empty);
}
private void Forget()
{
_values.Clear();
_history.Clear();
_facts = [];
_factsHash = null;
_lastTick = long.MinValue;
_series = [];
_sources = AdvancedSources.Unknown;
}
private void Apply(AdvancedMachineAck ack)
{
if (ack.FactsJson is not null)
{
_facts = AdvancedJson.ParseFacts(ack.FactsJson);
_factsHash = ack.FactsHash;
}
else if (!string.Equals(ack.FactsHash, _factsHash, StringComparison.Ordinal))
{
// The Agent holds other facts than the ones kept here and sent none: ask for them outright next time.
_factsHash = null;
}
_sources = new AdvancedSources(StatusOf(ack.Nvapi), ack.NvapiCode, StatusOf(ack.Sensors), StatusOf(ack.ElevatedSensors));
var series = new List<AdvancedSeriesInfo>(ack.Series.Count);
foreach (AdvancedSeriesLabel label in ack.Series)
{
series.Add(new AdvancedSeriesInfo(label.Series, label.MetricId, label.Label));
}
_series = series;
if (ack.TakenAtUnixMs == _lastTick)
{
// The same tick as a second ago - the reader's interval and this one are not in step: no new point.
return;
}
_lastTick = ack.TakenAtUnixMs;
DateTimeOffset at = DateTimeOffset.FromUnixTimeMilliseconds(ack.TakenAtUnixMs);
foreach (AdvancedReadingValue reading in ack.Readings)
{
var point = new AdvancedLivePoint(at, reading.Value);
_values[reading.Series] = point;
if (!_history.TryGetValue(reading.Series, out Queue<AdvancedLivePoint>? points))
{
points = new Queue<AdvancedLivePoint>();
_history[reading.Series] = points;
}
points.Enqueue(point);
while (points.Count > HistoryPoints)
{
points.Dequeue();
}
}
}
/// <summary>A state by its name on the wire; a name this build does not know — a newer Agent's — is unknown, never a guess.</summary>
private static AdvancedSourceStatus StatusOf(string? name) =>
Enum.TryParse(name, ignoreCase: false, out AdvancedSourceStatus status) && Enum.IsDefined(status) ? status : AdvancedSourceStatus.Unknown;
private sealed class Watcher(AdvancedMachineFeed feed) : IDisposable
{
private int _released;
public void Dispose()
{
if (Interlocked.Exchange(ref _released, 1) == 0)
{
feed.Release();
}
}
}
}
@@ -1,37 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using FrameLedger.Application.Advanced;
namespace FrameLedger.App.Services;
/// <summary>
/// "This PC, now" as the App last learnt it from the Agent (owner decision D101). Immutable: the feed publishes a new
/// one after each request and a page keeps whichever it took.
/// </summary>
/// <param name="State">What the last request came to.</param>
/// <param name="TakenAt">The Agent's tick the newest values are of; null before the first snapshot.</param>
/// <param name="Facts">The PC's facts, as the ledger would store them.</param>
/// <param name="Values">
/// The last value seen of each series, with the tick it was read on. A slow source is read every few ticks and its
/// value is not repeated between, so "the value now" is the last one seen — and its age is part of it.
/// </param>
/// <param name="Series">The members of the catalog's families the reader has met, with the hardware's own labels.</param>
/// <param name="Sources">Which sources answer, and why the others do not.</param>
public sealed record AdvancedMachineView(
AdvancedFeedState State,
DateTimeOffset? TakenAt,
IReadOnlyList<AdvancedFact> Facts,
IReadOnlyDictionary<string, AdvancedLivePoint> Values,
IReadOnlyList<AdvancedSeriesInfo> Series,
AdvancedSources Sources)
{
/// <summary>Nothing asked, nothing known.</summary>
public static AdvancedMachineView Stopped { get; } = new(
AdvancedFeedState.Stopped,
TakenAt: null,
[],
new Dictionary<string, AdvancedLivePoint>(StringComparer.Ordinal),
[],
AdvancedSources.Unknown);
}
@@ -1,39 +0,0 @@
// 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>
/// Whether the Advanced page is offered (owner decisions D101 and D105): its navigation item is there, and Ctrl+6
/// opens it, only while this is on. Set at start from <c>telemetry.advanced</c> and again whenever Settings moves the
/// switch; in a viewer it is also on when the copy holds a session recorded with the option on, since that is what a
/// copy is opened to look at.
/// </summary>
/// <remarks>
/// A static that XAML binds to, as <see cref="ContrastTheme"/> is: the shell's navigation item lives in the window's
/// XAML, which a language change rebuilds, and a setting read once at start would not follow the switch.
/// </remarks>
public static class AdvancedOption
{
private static bool _isOn;
/// <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;
public static bool IsOn
{
get => _isOn;
set
{
if (_isOn == value)
{
return;
}
_isOn = value;
StaticPropertyChanged?.Invoke(null, new PropertyChangedEventArgs(nameof(IsOn)));
}
}
}
@@ -1,26 +0,0 @@
// 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 session the Advanced page should show when it next opens: a session's summary names it, then navigates. One
/// slot, taken once — a page opened from the navigation pane afterwards shows its newest session as usual.
/// </summary>
public sealed class AdvancedSelection
{
private long _sessionId;
/// <summary>A session was asked for: a page already on screen takes it now.</summary>
public event EventHandler? Requested;
/// <summary>Asks the page to show <paramref name="sessionId"/> - now if it is on screen, else the next time it opens.</summary>
public void Request(long sessionId)
{
Interlocked.Exchange(ref _sessionId, sessionId);
Requested?.Invoke(this, EventArgs.Empty);
}
/// <summary>The session asked for since the last call, or null.</summary>
public long? Take() => Interlocked.Exchange(ref _sessionId, 0) is > 0 and long id ? id : null;
}
@@ -41,7 +41,6 @@ public static class EmbeddedDocuments
"guide/09-troubleshooting.md",
"guide/10-glossary.md",
"guide/11-alpha-builds.md",
"guide/12-advanced-metrics.md",
"guide/terms-in-plain-words.md",
];
@@ -60,7 +60,6 @@ public sealed class SessionSummaryOpener : ISessionSummaryOpener, ISessionWindow
new TriStateOverridePrompt(() => window!.Dialogs),
_services.GetRequiredService<IFileSaver>(),
_services.GetRequiredService<IMessageStrip>());
viewModel.ShowAdvanced = ShowAdvanced;
window = new SessionSummaryWindow(viewModel, _services.GetRequiredService<IThemeApplier>(), _services.GetRequiredService<AppearanceSettings>())
{
Owner = _shell.Current,
@@ -86,17 +85,6 @@ public sealed class SessionSummaryOpener : ISessionSummaryOpener, ISessionWindow
}
/// <summary>The open window, back in front of the user: out of the taskbar first if it was minimised.</summary>
/// <summary>The summary's "Advanced metrics…": the page is asked for that session, opened, and the main window brought forward.</summary>
private void ShowAdvanced(long sessionId)
{
_services.GetRequiredService<AdvancedSelection>().Request(sessionId);
_services.GetRequiredService<IPageNavigator>().Navigate<Pages.AdvancedPage>();
if (_shell.Current is { } main)
{
BringForward(main);
}
}
private static void BringForward(Window window)
{
if (window.WindowState == WindowState.Minimized)
@@ -31,10 +31,6 @@ public static class ShellShortcuts
case "4":
navigator.Navigate<LogsPage>();
return true;
case "6" when AdvancedOption.IsOn:
// Owner decision D105: the Advanced page keeps its number free while its option is off.
navigator.Navigate<AdvancedPage>();
return true;
case "5":
navigator.Navigate<SettingsPage>();
return true;
+1 -19
View File
@@ -6,30 +6,12 @@ using System.Diagnostics;
namespace FrameLedger.App.Services;
/// <summary>
/// <see cref="IUrlOpener"/> through the shell (<c>UseShellExecute</c>), the same launch every other link in the App makes; a
/// refusal is logged, never thrown. The shell runs whatever it is handed - a <c>file:</c> address is a program - so this
/// opens web and mail links only, and says so itself rather than trusting each caller to have checked (2026-11-11: every
/// caller passes one of the project's own pages or a link <c>MarkdownLinks</c> has already held to these schemes).
/// </summary>
/// <summary><see cref="IUrlOpener"/> through the shell (<c>UseShellExecute</c>), the same launch every other link in the App makes; a refusal is logged, never thrown.</summary>
public sealed class ShellUrlOpener : IUrlOpener
{
/// <summary>Whether <paramref name="url"/> is a link the shell may be handed: absolute, and <c>http</c>, <c>https</c> or <c>mailto</c>.</summary>
public static bool IsOpenable(Uri url)
{
ArgumentNullException.ThrowIfNull(url);
return url.IsAbsoluteUri && url.Scheme is "https" or "http" or "mailto";
}
public bool Open(Uri url)
{
ArgumentNullException.ThrowIfNull(url);
if (!IsOpenable(url))
{
Serilog.Log.Warning("ui: not opened - {Url} is neither a web nor a mail link", url);
return false;
}
try
{
using Process? _ = Process.Start(new ProcessStartInfo(url.AbsoluteUri) { UseShellExecute = true });
-783
View File
@@ -29,12 +29,9 @@ public static class Strings
/// <summary>Every key, for an audit that walks them.</summary>
public static IReadOnlyList<string> Keys { get; } =
[
nameof(A11y_Advanced_Metric),
nameof(A11y_Advanced_Session),
nameof(A11y_Agent_Connected),
nameof(A11y_Change_Format),
nameof(A11y_ChangeMarker_Format),
nameof(A11y_Chart_Advanced),
nameof(A11y_Chart_Clocks),
nameof(A11y_Chart_Compare),
nameof(A11y_Chart_ControlType),
@@ -48,7 +45,6 @@ public static class Strings
nameof(A11y_Chart_Temps),
nameof(A11y_Chart_Trend),
nameof(A11y_Chart_Vram),
nameof(A11y_ChartData_Advanced),
nameof(A11y_ChartData_Compare),
nameof(A11y_ChartData_Latency),
nameof(A11y_ChartData_Sessions),
@@ -106,259 +102,6 @@ public static class Strings
nameof(AddGame_Dialog_Title),
nameof(AddGame_Failed_Format),
nameof(AddGame_Filter),
nameof(Adv_ffx_framegen_config),
nameof(Adv_ffx_memory_usage),
nameof(Adv_ffx_upscale_depth),
nameof(Adv_ffx_upscale_exposure),
nameof(Adv_ffx_upscale_flags),
nameof(Adv_ffx_upscale_frame_time_delta),
nameof(Adv_ffx_upscale_jitter),
nameof(Adv_ffx_upscale_sharpening),
nameof(Adv_lhm_battery),
nameof(Adv_lhm_board_fan),
nameof(Adv_lhm_board_fan_control),
nameof(Adv_lhm_board_model),
nameof(Adv_lhm_board_sensor_chip),
nameof(Adv_lhm_board_temperature),
nameof(Adv_lhm_board_voltage),
nameof(Adv_lhm_controller),
nameof(Adv_lhm_cpu_clock),
nameof(Adv_lhm_cpu_load),
nameof(Adv_lhm_cpu_power),
nameof(Adv_lhm_cpu_temperature),
nameof(Adv_lhm_cpu_voltage),
nameof(Adv_lhm_gpu_clock),
nameof(Adv_lhm_gpu_current),
nameof(Adv_lhm_gpu_fan),
nameof(Adv_lhm_gpu_fan_control),
nameof(Adv_lhm_gpu_load),
nameof(Adv_lhm_gpu_memory),
nameof(Adv_lhm_gpu_power),
nameof(Adv_lhm_gpu_temperature),
nameof(Adv_lhm_gpu_throughput),
nameof(Adv_lhm_gpu_voltage),
nameof(Adv_lhm_memory_load),
nameof(Adv_lhm_memory_modules),
nameof(Adv_lhm_memory_temperature),
nameof(Adv_lhm_psu),
nameof(Adv_lhm_storage_models),
nameof(Adv_lhm_storage_temperature),
nameof(Adv_ngx_parameters),
nameof(Adv_nvapi_clock_video),
nameof(Adv_nvapi_display_adaptive_sync_off),
nameof(Adv_nvapi_display_edid),
nameof(Adv_nvapi_display_hdr_formats),
nameof(Adv_nvapi_display_luminance_max),
nameof(Adv_nvapi_display_luminance_max_frame_average),
nameof(Adv_nvapi_display_luminance_min),
nameof(Adv_nvapi_display_max_frame_interval),
nameof(Adv_nvapi_display_vrr_support),
nameof(Adv_nvapi_driver_base_branch),
nameof(Adv_nvapi_driver_chipset),
nameof(Adv_nvapi_driver_dch),
nameof(Adv_nvapi_driver_global_profile),
nameof(Adv_nvapi_driver_interface_version),
nameof(Adv_nvapi_driver_package),
nameof(Adv_nvapi_encoder_fps),
nameof(Adv_nvapi_encoder_latency),
nameof(Adv_nvapi_encoder_session_processes),
nameof(Adv_nvapi_encoder_sessions),
nameof(Adv_nvapi_gpu_architecture),
nameof(Adv_nvapi_gpu_board_serial),
nameof(Adv_nvapi_gpu_bus_type),
nameof(Adv_nvapi_gpu_clock_base_core),
nameof(Adv_nvapi_gpu_clock_base_memory),
nameof(Adv_nvapi_gpu_clock_boost_core),
nameof(Adv_nvapi_gpu_clock_boost_memory),
nameof(Adv_nvapi_gpu_core_count),
nameof(Adv_nvapi_gpu_external),
nameof(Adv_nvapi_gpu_fan_duty),
nameof(Adv_nvapi_gpu_pci_ids),
nameof(Adv_nvapi_gpu_power),
nameof(Adv_nvapi_gpu_ram_bus_width),
nameof(Adv_nvapi_gpu_ram_type),
nameof(Adv_nvapi_gpu_rt_cores),
nameof(Adv_nvapi_gpu_system_type),
nameof(Adv_nvapi_gpu_temp_default_max),
nameof(Adv_nvapi_gpu_tensor_cores),
nameof(Adv_nvapi_gpu_type),
nameof(Adv_nvapi_gpu_uuid),
nameof(Adv_nvapi_gpu_vbios_version),
nameof(Adv_nvapi_gpu_voltage),
nameof(Adv_nvapi_limit_ac_battery),
nameof(Adv_nvapi_limit_api),
nameof(Adv_nvapi_limit_insufficient_power),
nameof(Adv_nvapi_load_bus),
nameof(Adv_nvapi_load_framebuffer),
nameof(Adv_nvapi_load_video),
nameof(Adv_nvapi_pstate),
nameof(Adv_nvapi_reflex_frame_report),
nameof(Adv_nvapi_reflex_mode),
nameof(Adv_nvapi_reflex_sleep_status),
nameof(Adv_nvapi_session_driver_profile),
nameof(Adv_nvapi_session_source_colorspace),
nameof(Adv_nvapi_session_vrr_display_mode),
nameof(Adv_nvapi_session_vrr_enabled),
nameof(Adv_nvapi_session_vrr_possible),
nameof(Adv_nvapi_session_vrr_requested),
nameof(Adv_nvapi_temp_board),
nameof(Adv_nvapi_temp_power_supply),
nameof(Adv_nvapi_vram_available),
nameof(Adv_nvapi_vram_dedicated),
nameof(Adv_nvapi_vram_dedicated_available),
nameof(Adv_nvapi_vram_eviction_count),
nameof(Adv_nvapi_vram_evictions_size),
nameof(Adv_nvapi_vram_framebuffer_physical),
nameof(Adv_nvapi_vram_framebuffer_virtual),
nameof(Adv_nvapi_vram_in_use),
nameof(Adv_nvapi_vram_promotion_count),
nameof(Adv_nvapi_vram_promotions_size),
nameof(Adv_nvapi_vram_shared),
nameof(Adv_nvapi_vram_system),
nameof(Adv_sl_constants_camera),
nameof(Adv_sl_constants_depth),
nameof(Adv_sl_constants_jitter),
nameof(Adv_sl_constants_motion_vectors),
nameof(Adv_sl_constants_projection),
nameof(Adv_sl_constants_resets),
nameof(Adv_sl_deepdvc_options),
nameof(Adv_sl_dlss_alpha_upscaling),
nameof(Adv_sl_dlss_auto_exposure),
nameof(Adv_sl_dlss_exposure),
nameof(Adv_sl_dlss_hdr_input),
nameof(Adv_sl_dlss_optimal_settings),
nameof(Adv_sl_dlss_output_size),
nameof(Adv_sl_dlss_presets),
nameof(Adv_sl_dlss_vram_estimate),
nameof(Adv_sl_dlssd_options),
nameof(Adv_sl_dlssg_frames_presented),
nameof(Adv_sl_dlssg_options),
nameof(Adv_sl_dlssg_state),
nameof(Adv_sl_dlssg_vram_estimate),
nameof(Adv_sl_feature_requirements),
nameof(Adv_sl_feature_versions),
nameof(Adv_sl_init_preferences),
nameof(Adv_sl_nis_options),
nameof(Adv_sl_nvperf),
nameof(Adv_sl_pcl_markers),
nameof(Adv_sl_reflex_state),
nameof(Adv_xess_options),
nameof(Advanced_Chart_Band),
nameof(Advanced_Chart_Empty),
nameof(Advanced_Chart_Header),
nameof(Advanced_Chart_LiveNote),
nameof(Advanced_Chart_Metric),
nameof(Advanced_Chart_Seconds),
nameof(Advanced_Chart_Time),
nameof(Advanced_Col_Name),
nameof(Advanced_Col_ReadAt),
nameof(Advanced_Col_Samples),
nameof(Advanced_Col_Scope),
nameof(Advanced_Col_Source),
nameof(Advanced_Col_Status),
nameof(Advanced_Col_Value),
nameof(Advanced_Elevation_Hint),
nameof(Advanced_Facts_Header),
nameof(Advanced_Header),
nameof(Advanced_InGameLine),
nameof(Advanced_Machine_Intro),
nameof(Advanced_Max),
nameof(Advanced_Mean),
nameof(Advanced_Min),
nameof(Advanced_Now_Header),
nameof(Advanced_Session_Empty),
nameof(Advanced_Session_Facts),
nameof(Advanced_Session_NoSeries),
nameof(Advanced_Session_NoStats),
nameof(Advanced_Session_Pick),
nameof(Advanced_Session_Stats),
nameof(Advanced_Sources_Intro),
nameof(Advanced_SourcesLine),
nameof(Advanced_State_Live),
nameof(Advanced_State_NoAgent),
nameof(Advanced_State_Off),
nameof(Advanced_State_OlderAgent),
nameof(Advanced_State_Viewer),
nameof(Advanced_State_Waiting),
nameof(Advanced_Status_InGame),
nameof(Advanced_Status_Read),
nameof(Advanced_Status_Readable),
nameof(Advanced_Status_SourceSilent),
nameof(Advanced_Tab_Machine),
nameof(Advanced_Tab_Session),
nameof(Advanced_Tab_Sources),
nameof(AdvGroup_Board),
nameof(AdvGroup_Cpu),
nameof(AdvGroup_Display),
nameof(AdvGroup_Driver),
nameof(AdvGroup_FrameGeneration),
nameof(AdvGroup_Gpu),
nameof(AdvGroup_GpuMemory),
nameof(AdvGroup_Latency),
nameof(AdvGroup_Memory),
nameof(AdvGroup_Storage),
nameof(AdvGroup_Upscaling),
nameof(AdvInGame_NothingSeen),
nameof(AdvInGame_NotHooked),
nameof(AdvInGame_Reading),
nameof(AdvInGame_Unknown),
nameof(AdvReach_Deferred),
nameof(AdvReach_Game),
nameof(AdvReach_HookedCall),
nameof(AdvReach_Identifier),
nameof(AdvReach_Licence),
nameof(AdvReach_NewHook),
nameof(AdvReach_NotInHeaders),
nameof(AdvReach_PlayerState),
nameof(AdvReach_Refused),
nameof(AdvReach_Spike),
nameof(AdvScope_MachineFact),
nameof(AdvScope_Series),
nameof(AdvScope_SessionFact),
nameof(AdvSource_Faulted),
nameof(AdvSource_NotElevated),
nameof(AdvSource_NotPresent),
nameof(AdvSource_PawnIoMissing),
nameof(AdvSource_Reading),
nameof(AdvSource_Unknown),
nameof(AdvToken_adaptive_sync),
nameof(AdvToken_agp),
nameof(AdvToken_axi),
nameof(AdvToken_bt2100_pq),
nameof(AdvToken_desktop),
nameof(AdvToken_discrete),
nameof(AdvToken_dolby_vision),
nameof(AdvToken_draw_debug_view),
nameof(AdvToken_driver_default),
nameof(AdvToken_edr),
nameof(AdvToken_fpci),
nameof(AdvToken_game_ready),
nameof(AdvToken_gsync_module),
nameof(AdvToken_hdr10),
nameof(AdvToken_hdr10_plus),
nameof(AdvToken_hdr10_plus_gaming),
nameof(AdvToken_integrated),
nameof(AdvToken_laptop),
nameof(AdvToken_no_profile_for_game),
nameof(AdvToken_non_linear_color_pq),
nameof(AdvToken_non_linear_color_srgb),
nameof(AdvToken_none),
nameof(AdvToken_not_a_number),
nameof(AdvToken_not_supported),
nameof(AdvToken_off),
nameof(AdvToken_on),
nameof(AdvToken_on_and_off),
nameof(AdvToken_pci),
nameof(AdvToken_pci_express),
nameof(AdvToken_rtx_new_feature),
nameof(AdvToken_rtx_production),
nameof(AdvToken_scrgb_linear),
nameof(AdvToken_srgb),
nameof(AdvToken_studio),
nameof(AdvToken_ulmb),
nameof(AdvToken_usable_now),
nameof(AdvToken_user_set),
nameof(AdvToken_variable_refresh),
nameof(Agent_Banner_Missing_Body),
nameof(Agent_Banner_Offline_Body),
nameof(Agent_Banner_Offline_Title),
@@ -1058,7 +801,6 @@ public static class Strings
nameof(Menu_Tools_OpenDataFolder),
nameof(Menu_Tools_UpdateRules),
nameof(Menu_Tools_VulkanLayer),
nameof(Nav_Advanced),
nameof(Nav_Compare),
nameof(Nav_Dashboard),
nameof(Nav_Games),
@@ -1200,8 +942,6 @@ public static class Strings
nameof(Sessions_GameRamWs_Cell_Format),
nameof(Sessions_GameRamWs_Tooltip_Format),
nameof(Sessions_GameVram_Tooltip_Format),
nameof(Settings_Advanced_Body),
nameof(Settings_Advanced_Label),
nameof(Settings_Agent_Elevated),
nameof(Settings_Agent_Elevation_Body),
nameof(Settings_Agent_Elevation_Label),
@@ -1322,7 +1062,6 @@ public static class Strings
nameof(Store_Gog_Format),
nameof(Store_Steam_Format),
nameof(Store_Xbox_Format),
nameof(Summary_Advanced_Button),
nameof(Summary_Annotations_Header),
nameof(Summary_Crash_Body),
nameof(Summary_Crash_Title),
@@ -1526,18 +1265,12 @@ public static class Strings
nameof(Viewer_ChangesThisPc_Off),
];
public static string A11y_Advanced_Metric => ResourceManager.GetString(nameof(A11y_Advanced_Metric), Culture) ?? nameof(A11y_Advanced_Metric);
public static string A11y_Advanced_Session => ResourceManager.GetString(nameof(A11y_Advanced_Session), Culture) ?? nameof(A11y_Advanced_Session);
public static string A11y_Agent_Connected => ResourceManager.GetString(nameof(A11y_Agent_Connected), Culture) ?? nameof(A11y_Agent_Connected);
public static string A11y_Change_Format => ResourceManager.GetString(nameof(A11y_Change_Format), Culture) ?? nameof(A11y_Change_Format);
public static string A11y_ChangeMarker_Format => ResourceManager.GetString(nameof(A11y_ChangeMarker_Format), Culture) ?? nameof(A11y_ChangeMarker_Format);
public static string A11y_Chart_Advanced => ResourceManager.GetString(nameof(A11y_Chart_Advanced), Culture) ?? nameof(A11y_Chart_Advanced);
public static string A11y_Chart_Clocks => ResourceManager.GetString(nameof(A11y_Chart_Clocks), Culture) ?? nameof(A11y_Chart_Clocks);
public static string A11y_Chart_Compare => ResourceManager.GetString(nameof(A11y_Chart_Compare), Culture) ?? nameof(A11y_Chart_Compare);
@@ -1564,8 +1297,6 @@ public static class Strings
public static string A11y_Chart_Vram => ResourceManager.GetString(nameof(A11y_Chart_Vram), Culture) ?? nameof(A11y_Chart_Vram);
public static string A11y_ChartData_Advanced => ResourceManager.GetString(nameof(A11y_ChartData_Advanced), Culture) ?? nameof(A11y_ChartData_Advanced);
public static string A11y_ChartData_Compare => ResourceManager.GetString(nameof(A11y_ChartData_Compare), Culture) ?? nameof(A11y_ChartData_Compare);
public static string A11y_ChartData_Latency => ResourceManager.GetString(nameof(A11y_ChartData_Latency), Culture) ?? nameof(A11y_ChartData_Latency);
@@ -1680,512 +1411,6 @@ public static class Strings
public static string AddGame_Filter => ResourceManager.GetString(nameof(AddGame_Filter), Culture) ?? nameof(AddGame_Filter);
public static string Adv_ffx_framegen_config => ResourceManager.GetString(nameof(Adv_ffx_framegen_config), Culture) ?? nameof(Adv_ffx_framegen_config);
public static string Adv_ffx_memory_usage => ResourceManager.GetString(nameof(Adv_ffx_memory_usage), Culture) ?? nameof(Adv_ffx_memory_usage);
public static string Adv_ffx_upscale_depth => ResourceManager.GetString(nameof(Adv_ffx_upscale_depth), Culture) ?? nameof(Adv_ffx_upscale_depth);
public static string Adv_ffx_upscale_exposure => ResourceManager.GetString(nameof(Adv_ffx_upscale_exposure), Culture) ?? nameof(Adv_ffx_upscale_exposure);
public static string Adv_ffx_upscale_flags => ResourceManager.GetString(nameof(Adv_ffx_upscale_flags), Culture) ?? nameof(Adv_ffx_upscale_flags);
public static string Adv_ffx_upscale_frame_time_delta => ResourceManager.GetString(nameof(Adv_ffx_upscale_frame_time_delta), Culture) ?? nameof(Adv_ffx_upscale_frame_time_delta);
public static string Adv_ffx_upscale_jitter => ResourceManager.GetString(nameof(Adv_ffx_upscale_jitter), Culture) ?? nameof(Adv_ffx_upscale_jitter);
public static string Adv_ffx_upscale_sharpening => ResourceManager.GetString(nameof(Adv_ffx_upscale_sharpening), Culture) ?? nameof(Adv_ffx_upscale_sharpening);
public static string Adv_lhm_battery => ResourceManager.GetString(nameof(Adv_lhm_battery), Culture) ?? nameof(Adv_lhm_battery);
public static string Adv_lhm_board_fan => ResourceManager.GetString(nameof(Adv_lhm_board_fan), Culture) ?? nameof(Adv_lhm_board_fan);
public static string Adv_lhm_board_fan_control => ResourceManager.GetString(nameof(Adv_lhm_board_fan_control), Culture) ?? nameof(Adv_lhm_board_fan_control);
public static string Adv_lhm_board_model => ResourceManager.GetString(nameof(Adv_lhm_board_model), Culture) ?? nameof(Adv_lhm_board_model);
public static string Adv_lhm_board_sensor_chip => ResourceManager.GetString(nameof(Adv_lhm_board_sensor_chip), Culture) ?? nameof(Adv_lhm_board_sensor_chip);
public static string Adv_lhm_board_temperature => ResourceManager.GetString(nameof(Adv_lhm_board_temperature), Culture) ?? nameof(Adv_lhm_board_temperature);
public static string Adv_lhm_board_voltage => ResourceManager.GetString(nameof(Adv_lhm_board_voltage), Culture) ?? nameof(Adv_lhm_board_voltage);
public static string Adv_lhm_controller => ResourceManager.GetString(nameof(Adv_lhm_controller), Culture) ?? nameof(Adv_lhm_controller);
public static string Adv_lhm_cpu_clock => ResourceManager.GetString(nameof(Adv_lhm_cpu_clock), Culture) ?? nameof(Adv_lhm_cpu_clock);
public static string Adv_lhm_cpu_load => ResourceManager.GetString(nameof(Adv_lhm_cpu_load), Culture) ?? nameof(Adv_lhm_cpu_load);
public static string Adv_lhm_cpu_power => ResourceManager.GetString(nameof(Adv_lhm_cpu_power), Culture) ?? nameof(Adv_lhm_cpu_power);
public static string Adv_lhm_cpu_temperature => ResourceManager.GetString(nameof(Adv_lhm_cpu_temperature), Culture) ?? nameof(Adv_lhm_cpu_temperature);
public static string Adv_lhm_cpu_voltage => ResourceManager.GetString(nameof(Adv_lhm_cpu_voltage), Culture) ?? nameof(Adv_lhm_cpu_voltage);
public static string Adv_lhm_gpu_clock => ResourceManager.GetString(nameof(Adv_lhm_gpu_clock), Culture) ?? nameof(Adv_lhm_gpu_clock);
public static string Adv_lhm_gpu_current => ResourceManager.GetString(nameof(Adv_lhm_gpu_current), Culture) ?? nameof(Adv_lhm_gpu_current);
public static string Adv_lhm_gpu_fan => ResourceManager.GetString(nameof(Adv_lhm_gpu_fan), Culture) ?? nameof(Adv_lhm_gpu_fan);
public static string Adv_lhm_gpu_fan_control => ResourceManager.GetString(nameof(Adv_lhm_gpu_fan_control), Culture) ?? nameof(Adv_lhm_gpu_fan_control);
public static string Adv_lhm_gpu_load => ResourceManager.GetString(nameof(Adv_lhm_gpu_load), Culture) ?? nameof(Adv_lhm_gpu_load);
public static string Adv_lhm_gpu_memory => ResourceManager.GetString(nameof(Adv_lhm_gpu_memory), Culture) ?? nameof(Adv_lhm_gpu_memory);
public static string Adv_lhm_gpu_power => ResourceManager.GetString(nameof(Adv_lhm_gpu_power), Culture) ?? nameof(Adv_lhm_gpu_power);
public static string Adv_lhm_gpu_temperature => ResourceManager.GetString(nameof(Adv_lhm_gpu_temperature), Culture) ?? nameof(Adv_lhm_gpu_temperature);
public static string Adv_lhm_gpu_throughput => ResourceManager.GetString(nameof(Adv_lhm_gpu_throughput), Culture) ?? nameof(Adv_lhm_gpu_throughput);
public static string Adv_lhm_gpu_voltage => ResourceManager.GetString(nameof(Adv_lhm_gpu_voltage), Culture) ?? nameof(Adv_lhm_gpu_voltage);
public static string Adv_lhm_memory_load => ResourceManager.GetString(nameof(Adv_lhm_memory_load), Culture) ?? nameof(Adv_lhm_memory_load);
public static string Adv_lhm_memory_modules => ResourceManager.GetString(nameof(Adv_lhm_memory_modules), Culture) ?? nameof(Adv_lhm_memory_modules);
public static string Adv_lhm_memory_temperature => ResourceManager.GetString(nameof(Adv_lhm_memory_temperature), Culture) ?? nameof(Adv_lhm_memory_temperature);
public static string Adv_lhm_psu => ResourceManager.GetString(nameof(Adv_lhm_psu), Culture) ?? nameof(Adv_lhm_psu);
public static string Adv_lhm_storage_models => ResourceManager.GetString(nameof(Adv_lhm_storage_models), Culture) ?? nameof(Adv_lhm_storage_models);
public static string Adv_lhm_storage_temperature => ResourceManager.GetString(nameof(Adv_lhm_storage_temperature), Culture) ?? nameof(Adv_lhm_storage_temperature);
public static string Adv_ngx_parameters => ResourceManager.GetString(nameof(Adv_ngx_parameters), Culture) ?? nameof(Adv_ngx_parameters);
public static string Adv_nvapi_clock_video => ResourceManager.GetString(nameof(Adv_nvapi_clock_video), Culture) ?? nameof(Adv_nvapi_clock_video);
public static string Adv_nvapi_display_adaptive_sync_off => ResourceManager.GetString(nameof(Adv_nvapi_display_adaptive_sync_off), Culture) ?? nameof(Adv_nvapi_display_adaptive_sync_off);
public static string Adv_nvapi_display_edid => ResourceManager.GetString(nameof(Adv_nvapi_display_edid), Culture) ?? nameof(Adv_nvapi_display_edid);
public static string Adv_nvapi_display_hdr_formats => ResourceManager.GetString(nameof(Adv_nvapi_display_hdr_formats), Culture) ?? nameof(Adv_nvapi_display_hdr_formats);
public static string Adv_nvapi_display_luminance_max => ResourceManager.GetString(nameof(Adv_nvapi_display_luminance_max), Culture) ?? nameof(Adv_nvapi_display_luminance_max);
public static string Adv_nvapi_display_luminance_max_frame_average => ResourceManager.GetString(nameof(Adv_nvapi_display_luminance_max_frame_average), Culture) ?? nameof(Adv_nvapi_display_luminance_max_frame_average);
public static string Adv_nvapi_display_luminance_min => ResourceManager.GetString(nameof(Adv_nvapi_display_luminance_min), Culture) ?? nameof(Adv_nvapi_display_luminance_min);
public static string Adv_nvapi_display_max_frame_interval => ResourceManager.GetString(nameof(Adv_nvapi_display_max_frame_interval), Culture) ?? nameof(Adv_nvapi_display_max_frame_interval);
public static string Adv_nvapi_display_vrr_support => ResourceManager.GetString(nameof(Adv_nvapi_display_vrr_support), Culture) ?? nameof(Adv_nvapi_display_vrr_support);
public static string Adv_nvapi_driver_base_branch => ResourceManager.GetString(nameof(Adv_nvapi_driver_base_branch), Culture) ?? nameof(Adv_nvapi_driver_base_branch);
public static string Adv_nvapi_driver_chipset => ResourceManager.GetString(nameof(Adv_nvapi_driver_chipset), Culture) ?? nameof(Adv_nvapi_driver_chipset);
public static string Adv_nvapi_driver_dch => ResourceManager.GetString(nameof(Adv_nvapi_driver_dch), Culture) ?? nameof(Adv_nvapi_driver_dch);
public static string Adv_nvapi_driver_global_profile => ResourceManager.GetString(nameof(Adv_nvapi_driver_global_profile), Culture) ?? nameof(Adv_nvapi_driver_global_profile);
public static string Adv_nvapi_driver_interface_version => ResourceManager.GetString(nameof(Adv_nvapi_driver_interface_version), Culture) ?? nameof(Adv_nvapi_driver_interface_version);
public static string Adv_nvapi_driver_package => ResourceManager.GetString(nameof(Adv_nvapi_driver_package), Culture) ?? nameof(Adv_nvapi_driver_package);
public static string Adv_nvapi_encoder_fps => ResourceManager.GetString(nameof(Adv_nvapi_encoder_fps), Culture) ?? nameof(Adv_nvapi_encoder_fps);
public static string Adv_nvapi_encoder_latency => ResourceManager.GetString(nameof(Adv_nvapi_encoder_latency), Culture) ?? nameof(Adv_nvapi_encoder_latency);
public static string Adv_nvapi_encoder_session_processes => ResourceManager.GetString(nameof(Adv_nvapi_encoder_session_processes), Culture) ?? nameof(Adv_nvapi_encoder_session_processes);
public static string Adv_nvapi_encoder_sessions => ResourceManager.GetString(nameof(Adv_nvapi_encoder_sessions), Culture) ?? nameof(Adv_nvapi_encoder_sessions);
public static string Adv_nvapi_gpu_architecture => ResourceManager.GetString(nameof(Adv_nvapi_gpu_architecture), Culture) ?? nameof(Adv_nvapi_gpu_architecture);
public static string Adv_nvapi_gpu_board_serial => ResourceManager.GetString(nameof(Adv_nvapi_gpu_board_serial), Culture) ?? nameof(Adv_nvapi_gpu_board_serial);
public static string Adv_nvapi_gpu_bus_type => ResourceManager.GetString(nameof(Adv_nvapi_gpu_bus_type), Culture) ?? nameof(Adv_nvapi_gpu_bus_type);
public static string Adv_nvapi_gpu_clock_base_core => ResourceManager.GetString(nameof(Adv_nvapi_gpu_clock_base_core), Culture) ?? nameof(Adv_nvapi_gpu_clock_base_core);
public static string Adv_nvapi_gpu_clock_base_memory => ResourceManager.GetString(nameof(Adv_nvapi_gpu_clock_base_memory), Culture) ?? nameof(Adv_nvapi_gpu_clock_base_memory);
public static string Adv_nvapi_gpu_clock_boost_core => ResourceManager.GetString(nameof(Adv_nvapi_gpu_clock_boost_core), Culture) ?? nameof(Adv_nvapi_gpu_clock_boost_core);
public static string Adv_nvapi_gpu_clock_boost_memory => ResourceManager.GetString(nameof(Adv_nvapi_gpu_clock_boost_memory), Culture) ?? nameof(Adv_nvapi_gpu_clock_boost_memory);
public static string Adv_nvapi_gpu_core_count => ResourceManager.GetString(nameof(Adv_nvapi_gpu_core_count), Culture) ?? nameof(Adv_nvapi_gpu_core_count);
public static string Adv_nvapi_gpu_external => ResourceManager.GetString(nameof(Adv_nvapi_gpu_external), Culture) ?? nameof(Adv_nvapi_gpu_external);
public static string Adv_nvapi_gpu_fan_duty => ResourceManager.GetString(nameof(Adv_nvapi_gpu_fan_duty), Culture) ?? nameof(Adv_nvapi_gpu_fan_duty);
public static string Adv_nvapi_gpu_pci_ids => ResourceManager.GetString(nameof(Adv_nvapi_gpu_pci_ids), Culture) ?? nameof(Adv_nvapi_gpu_pci_ids);
public static string Adv_nvapi_gpu_power => ResourceManager.GetString(nameof(Adv_nvapi_gpu_power), Culture) ?? nameof(Adv_nvapi_gpu_power);
public static string Adv_nvapi_gpu_ram_bus_width => ResourceManager.GetString(nameof(Adv_nvapi_gpu_ram_bus_width), Culture) ?? nameof(Adv_nvapi_gpu_ram_bus_width);
public static string Adv_nvapi_gpu_ram_type => ResourceManager.GetString(nameof(Adv_nvapi_gpu_ram_type), Culture) ?? nameof(Adv_nvapi_gpu_ram_type);
public static string Adv_nvapi_gpu_rt_cores => ResourceManager.GetString(nameof(Adv_nvapi_gpu_rt_cores), Culture) ?? nameof(Adv_nvapi_gpu_rt_cores);
public static string Adv_nvapi_gpu_system_type => ResourceManager.GetString(nameof(Adv_nvapi_gpu_system_type), Culture) ?? nameof(Adv_nvapi_gpu_system_type);
public static string Adv_nvapi_gpu_temp_default_max => ResourceManager.GetString(nameof(Adv_nvapi_gpu_temp_default_max), Culture) ?? nameof(Adv_nvapi_gpu_temp_default_max);
public static string Adv_nvapi_gpu_tensor_cores => ResourceManager.GetString(nameof(Adv_nvapi_gpu_tensor_cores), Culture) ?? nameof(Adv_nvapi_gpu_tensor_cores);
public static string Adv_nvapi_gpu_type => ResourceManager.GetString(nameof(Adv_nvapi_gpu_type), Culture) ?? nameof(Adv_nvapi_gpu_type);
public static string Adv_nvapi_gpu_uuid => ResourceManager.GetString(nameof(Adv_nvapi_gpu_uuid), Culture) ?? nameof(Adv_nvapi_gpu_uuid);
public static string Adv_nvapi_gpu_vbios_version => ResourceManager.GetString(nameof(Adv_nvapi_gpu_vbios_version), Culture) ?? nameof(Adv_nvapi_gpu_vbios_version);
public static string Adv_nvapi_gpu_voltage => ResourceManager.GetString(nameof(Adv_nvapi_gpu_voltage), Culture) ?? nameof(Adv_nvapi_gpu_voltage);
public static string Adv_nvapi_limit_ac_battery => ResourceManager.GetString(nameof(Adv_nvapi_limit_ac_battery), Culture) ?? nameof(Adv_nvapi_limit_ac_battery);
public static string Adv_nvapi_limit_api => ResourceManager.GetString(nameof(Adv_nvapi_limit_api), Culture) ?? nameof(Adv_nvapi_limit_api);
public static string Adv_nvapi_limit_insufficient_power => ResourceManager.GetString(nameof(Adv_nvapi_limit_insufficient_power), Culture) ?? nameof(Adv_nvapi_limit_insufficient_power);
public static string Adv_nvapi_load_bus => ResourceManager.GetString(nameof(Adv_nvapi_load_bus), Culture) ?? nameof(Adv_nvapi_load_bus);
public static string Adv_nvapi_load_framebuffer => ResourceManager.GetString(nameof(Adv_nvapi_load_framebuffer), Culture) ?? nameof(Adv_nvapi_load_framebuffer);
public static string Adv_nvapi_load_video => ResourceManager.GetString(nameof(Adv_nvapi_load_video), Culture) ?? nameof(Adv_nvapi_load_video);
public static string Adv_nvapi_pstate => ResourceManager.GetString(nameof(Adv_nvapi_pstate), Culture) ?? nameof(Adv_nvapi_pstate);
public static string Adv_nvapi_reflex_frame_report => ResourceManager.GetString(nameof(Adv_nvapi_reflex_frame_report), Culture) ?? nameof(Adv_nvapi_reflex_frame_report);
public static string Adv_nvapi_reflex_mode => ResourceManager.GetString(nameof(Adv_nvapi_reflex_mode), Culture) ?? nameof(Adv_nvapi_reflex_mode);
public static string Adv_nvapi_reflex_sleep_status => ResourceManager.GetString(nameof(Adv_nvapi_reflex_sleep_status), Culture) ?? nameof(Adv_nvapi_reflex_sleep_status);
public static string Adv_nvapi_session_driver_profile => ResourceManager.GetString(nameof(Adv_nvapi_session_driver_profile), Culture) ?? nameof(Adv_nvapi_session_driver_profile);
public static string Adv_nvapi_session_source_colorspace => ResourceManager.GetString(nameof(Adv_nvapi_session_source_colorspace), Culture) ?? nameof(Adv_nvapi_session_source_colorspace);
public static string Adv_nvapi_session_vrr_display_mode => ResourceManager.GetString(nameof(Adv_nvapi_session_vrr_display_mode), Culture) ?? nameof(Adv_nvapi_session_vrr_display_mode);
public static string Adv_nvapi_session_vrr_enabled => ResourceManager.GetString(nameof(Adv_nvapi_session_vrr_enabled), Culture) ?? nameof(Adv_nvapi_session_vrr_enabled);
public static string Adv_nvapi_session_vrr_possible => ResourceManager.GetString(nameof(Adv_nvapi_session_vrr_possible), Culture) ?? nameof(Adv_nvapi_session_vrr_possible);
public static string Adv_nvapi_session_vrr_requested => ResourceManager.GetString(nameof(Adv_nvapi_session_vrr_requested), Culture) ?? nameof(Adv_nvapi_session_vrr_requested);
public static string Adv_nvapi_temp_board => ResourceManager.GetString(nameof(Adv_nvapi_temp_board), Culture) ?? nameof(Adv_nvapi_temp_board);
public static string Adv_nvapi_temp_power_supply => ResourceManager.GetString(nameof(Adv_nvapi_temp_power_supply), Culture) ?? nameof(Adv_nvapi_temp_power_supply);
public static string Adv_nvapi_vram_available => ResourceManager.GetString(nameof(Adv_nvapi_vram_available), Culture) ?? nameof(Adv_nvapi_vram_available);
public static string Adv_nvapi_vram_dedicated => ResourceManager.GetString(nameof(Adv_nvapi_vram_dedicated), Culture) ?? nameof(Adv_nvapi_vram_dedicated);
public static string Adv_nvapi_vram_dedicated_available => ResourceManager.GetString(nameof(Adv_nvapi_vram_dedicated_available), Culture) ?? nameof(Adv_nvapi_vram_dedicated_available);
public static string Adv_nvapi_vram_eviction_count => ResourceManager.GetString(nameof(Adv_nvapi_vram_eviction_count), Culture) ?? nameof(Adv_nvapi_vram_eviction_count);
public static string Adv_nvapi_vram_evictions_size => ResourceManager.GetString(nameof(Adv_nvapi_vram_evictions_size), Culture) ?? nameof(Adv_nvapi_vram_evictions_size);
public static string Adv_nvapi_vram_framebuffer_physical => ResourceManager.GetString(nameof(Adv_nvapi_vram_framebuffer_physical), Culture) ?? nameof(Adv_nvapi_vram_framebuffer_physical);
public static string Adv_nvapi_vram_framebuffer_virtual => ResourceManager.GetString(nameof(Adv_nvapi_vram_framebuffer_virtual), Culture) ?? nameof(Adv_nvapi_vram_framebuffer_virtual);
public static string Adv_nvapi_vram_in_use => ResourceManager.GetString(nameof(Adv_nvapi_vram_in_use), Culture) ?? nameof(Adv_nvapi_vram_in_use);
public static string Adv_nvapi_vram_promotion_count => ResourceManager.GetString(nameof(Adv_nvapi_vram_promotion_count), Culture) ?? nameof(Adv_nvapi_vram_promotion_count);
public static string Adv_nvapi_vram_promotions_size => ResourceManager.GetString(nameof(Adv_nvapi_vram_promotions_size), Culture) ?? nameof(Adv_nvapi_vram_promotions_size);
public static string Adv_nvapi_vram_shared => ResourceManager.GetString(nameof(Adv_nvapi_vram_shared), Culture) ?? nameof(Adv_nvapi_vram_shared);
public static string Adv_nvapi_vram_system => ResourceManager.GetString(nameof(Adv_nvapi_vram_system), Culture) ?? nameof(Adv_nvapi_vram_system);
public static string Adv_sl_constants_camera => ResourceManager.GetString(nameof(Adv_sl_constants_camera), Culture) ?? nameof(Adv_sl_constants_camera);
public static string Adv_sl_constants_depth => ResourceManager.GetString(nameof(Adv_sl_constants_depth), Culture) ?? nameof(Adv_sl_constants_depth);
public static string Adv_sl_constants_jitter => ResourceManager.GetString(nameof(Adv_sl_constants_jitter), Culture) ?? nameof(Adv_sl_constants_jitter);
public static string Adv_sl_constants_motion_vectors => ResourceManager.GetString(nameof(Adv_sl_constants_motion_vectors), Culture) ?? nameof(Adv_sl_constants_motion_vectors);
public static string Adv_sl_constants_projection => ResourceManager.GetString(nameof(Adv_sl_constants_projection), Culture) ?? nameof(Adv_sl_constants_projection);
public static string Adv_sl_constants_resets => ResourceManager.GetString(nameof(Adv_sl_constants_resets), Culture) ?? nameof(Adv_sl_constants_resets);
public static string Adv_sl_deepdvc_options => ResourceManager.GetString(nameof(Adv_sl_deepdvc_options), Culture) ?? nameof(Adv_sl_deepdvc_options);
public static string Adv_sl_dlss_alpha_upscaling => ResourceManager.GetString(nameof(Adv_sl_dlss_alpha_upscaling), Culture) ?? nameof(Adv_sl_dlss_alpha_upscaling);
public static string Adv_sl_dlss_auto_exposure => ResourceManager.GetString(nameof(Adv_sl_dlss_auto_exposure), Culture) ?? nameof(Adv_sl_dlss_auto_exposure);
public static string Adv_sl_dlss_exposure => ResourceManager.GetString(nameof(Adv_sl_dlss_exposure), Culture) ?? nameof(Adv_sl_dlss_exposure);
public static string Adv_sl_dlss_hdr_input => ResourceManager.GetString(nameof(Adv_sl_dlss_hdr_input), Culture) ?? nameof(Adv_sl_dlss_hdr_input);
public static string Adv_sl_dlss_optimal_settings => ResourceManager.GetString(nameof(Adv_sl_dlss_optimal_settings), Culture) ?? nameof(Adv_sl_dlss_optimal_settings);
public static string Adv_sl_dlss_output_size => ResourceManager.GetString(nameof(Adv_sl_dlss_output_size), Culture) ?? nameof(Adv_sl_dlss_output_size);
public static string Adv_sl_dlss_presets => ResourceManager.GetString(nameof(Adv_sl_dlss_presets), Culture) ?? nameof(Adv_sl_dlss_presets);
public static string Adv_sl_dlss_vram_estimate => ResourceManager.GetString(nameof(Adv_sl_dlss_vram_estimate), Culture) ?? nameof(Adv_sl_dlss_vram_estimate);
public static string Adv_sl_dlssd_options => ResourceManager.GetString(nameof(Adv_sl_dlssd_options), Culture) ?? nameof(Adv_sl_dlssd_options);
public static string Adv_sl_dlssg_frames_presented => ResourceManager.GetString(nameof(Adv_sl_dlssg_frames_presented), Culture) ?? nameof(Adv_sl_dlssg_frames_presented);
public static string Adv_sl_dlssg_options => ResourceManager.GetString(nameof(Adv_sl_dlssg_options), Culture) ?? nameof(Adv_sl_dlssg_options);
public static string Adv_sl_dlssg_state => ResourceManager.GetString(nameof(Adv_sl_dlssg_state), Culture) ?? nameof(Adv_sl_dlssg_state);
public static string Adv_sl_dlssg_vram_estimate => ResourceManager.GetString(nameof(Adv_sl_dlssg_vram_estimate), Culture) ?? nameof(Adv_sl_dlssg_vram_estimate);
public static string Adv_sl_feature_requirements => ResourceManager.GetString(nameof(Adv_sl_feature_requirements), Culture) ?? nameof(Adv_sl_feature_requirements);
public static string Adv_sl_feature_versions => ResourceManager.GetString(nameof(Adv_sl_feature_versions), Culture) ?? nameof(Adv_sl_feature_versions);
public static string Adv_sl_init_preferences => ResourceManager.GetString(nameof(Adv_sl_init_preferences), Culture) ?? nameof(Adv_sl_init_preferences);
public static string Adv_sl_nis_options => ResourceManager.GetString(nameof(Adv_sl_nis_options), Culture) ?? nameof(Adv_sl_nis_options);
public static string Adv_sl_nvperf => ResourceManager.GetString(nameof(Adv_sl_nvperf), Culture) ?? nameof(Adv_sl_nvperf);
public static string Adv_sl_pcl_markers => ResourceManager.GetString(nameof(Adv_sl_pcl_markers), Culture) ?? nameof(Adv_sl_pcl_markers);
public static string Adv_sl_reflex_state => ResourceManager.GetString(nameof(Adv_sl_reflex_state), Culture) ?? nameof(Adv_sl_reflex_state);
public static string Adv_xess_options => ResourceManager.GetString(nameof(Adv_xess_options), Culture) ?? nameof(Adv_xess_options);
public static string Advanced_Chart_Band => ResourceManager.GetString(nameof(Advanced_Chart_Band), Culture) ?? nameof(Advanced_Chart_Band);
public static string Advanced_Chart_Empty => ResourceManager.GetString(nameof(Advanced_Chart_Empty), Culture) ?? nameof(Advanced_Chart_Empty);
public static string Advanced_Chart_Header => ResourceManager.GetString(nameof(Advanced_Chart_Header), Culture) ?? nameof(Advanced_Chart_Header);
public static string Advanced_Chart_LiveNote => ResourceManager.GetString(nameof(Advanced_Chart_LiveNote), Culture) ?? nameof(Advanced_Chart_LiveNote);
public static string Advanced_Chart_Metric => ResourceManager.GetString(nameof(Advanced_Chart_Metric), Culture) ?? nameof(Advanced_Chart_Metric);
public static string Advanced_Chart_Seconds => ResourceManager.GetString(nameof(Advanced_Chart_Seconds), Culture) ?? nameof(Advanced_Chart_Seconds);
public static string Advanced_Chart_Time => ResourceManager.GetString(nameof(Advanced_Chart_Time), Culture) ?? nameof(Advanced_Chart_Time);
public static string Advanced_Col_Name => ResourceManager.GetString(nameof(Advanced_Col_Name), Culture) ?? nameof(Advanced_Col_Name);
public static string Advanced_Col_ReadAt => ResourceManager.GetString(nameof(Advanced_Col_ReadAt), Culture) ?? nameof(Advanced_Col_ReadAt);
public static string Advanced_Col_Samples => ResourceManager.GetString(nameof(Advanced_Col_Samples), Culture) ?? nameof(Advanced_Col_Samples);
public static string Advanced_Col_Scope => ResourceManager.GetString(nameof(Advanced_Col_Scope), Culture) ?? nameof(Advanced_Col_Scope);
public static string Advanced_Col_Source => ResourceManager.GetString(nameof(Advanced_Col_Source), Culture) ?? nameof(Advanced_Col_Source);
public static string Advanced_Col_Status => ResourceManager.GetString(nameof(Advanced_Col_Status), Culture) ?? nameof(Advanced_Col_Status);
public static string Advanced_Col_Value => ResourceManager.GetString(nameof(Advanced_Col_Value), Culture) ?? nameof(Advanced_Col_Value);
public static string Advanced_Elevation_Hint => ResourceManager.GetString(nameof(Advanced_Elevation_Hint), Culture) ?? nameof(Advanced_Elevation_Hint);
public static string Advanced_Facts_Header => ResourceManager.GetString(nameof(Advanced_Facts_Header), Culture) ?? nameof(Advanced_Facts_Header);
public static string Advanced_Header => ResourceManager.GetString(nameof(Advanced_Header), Culture) ?? nameof(Advanced_Header);
public static string Advanced_InGameLine => ResourceManager.GetString(nameof(Advanced_InGameLine), Culture) ?? nameof(Advanced_InGameLine);
public static string Advanced_Machine_Intro => ResourceManager.GetString(nameof(Advanced_Machine_Intro), Culture) ?? nameof(Advanced_Machine_Intro);
public static string Advanced_Max => ResourceManager.GetString(nameof(Advanced_Max), Culture) ?? nameof(Advanced_Max);
public static string Advanced_Mean => ResourceManager.GetString(nameof(Advanced_Mean), Culture) ?? nameof(Advanced_Mean);
public static string Advanced_Min => ResourceManager.GetString(nameof(Advanced_Min), Culture) ?? nameof(Advanced_Min);
public static string Advanced_Now_Header => ResourceManager.GetString(nameof(Advanced_Now_Header), Culture) ?? nameof(Advanced_Now_Header);
public static string Advanced_Session_Empty => ResourceManager.GetString(nameof(Advanced_Session_Empty), Culture) ?? nameof(Advanced_Session_Empty);
public static string Advanced_Session_Facts => ResourceManager.GetString(nameof(Advanced_Session_Facts), Culture) ?? nameof(Advanced_Session_Facts);
public static string Advanced_Session_NoSeries => ResourceManager.GetString(nameof(Advanced_Session_NoSeries), Culture) ?? nameof(Advanced_Session_NoSeries);
public static string Advanced_Session_NoStats => ResourceManager.GetString(nameof(Advanced_Session_NoStats), Culture) ?? nameof(Advanced_Session_NoStats);
public static string Advanced_Session_Pick => ResourceManager.GetString(nameof(Advanced_Session_Pick), Culture) ?? nameof(Advanced_Session_Pick);
public static string Advanced_Session_Stats => ResourceManager.GetString(nameof(Advanced_Session_Stats), Culture) ?? nameof(Advanced_Session_Stats);
public static string Advanced_Sources_Intro => ResourceManager.GetString(nameof(Advanced_Sources_Intro), Culture) ?? nameof(Advanced_Sources_Intro);
public static string Advanced_SourcesLine => ResourceManager.GetString(nameof(Advanced_SourcesLine), Culture) ?? nameof(Advanced_SourcesLine);
public static string Advanced_State_Live => ResourceManager.GetString(nameof(Advanced_State_Live), Culture) ?? nameof(Advanced_State_Live);
public static string Advanced_State_NoAgent => ResourceManager.GetString(nameof(Advanced_State_NoAgent), Culture) ?? nameof(Advanced_State_NoAgent);
public static string Advanced_State_Off => ResourceManager.GetString(nameof(Advanced_State_Off), Culture) ?? nameof(Advanced_State_Off);
public static string Advanced_State_OlderAgent => ResourceManager.GetString(nameof(Advanced_State_OlderAgent), Culture) ?? nameof(Advanced_State_OlderAgent);
public static string Advanced_State_Viewer => ResourceManager.GetString(nameof(Advanced_State_Viewer), Culture) ?? nameof(Advanced_State_Viewer);
public static string Advanced_State_Waiting => ResourceManager.GetString(nameof(Advanced_State_Waiting), Culture) ?? nameof(Advanced_State_Waiting);
public static string Advanced_Status_InGame => ResourceManager.GetString(nameof(Advanced_Status_InGame), Culture) ?? nameof(Advanced_Status_InGame);
public static string Advanced_Status_Read => ResourceManager.GetString(nameof(Advanced_Status_Read), Culture) ?? nameof(Advanced_Status_Read);
public static string Advanced_Status_Readable => ResourceManager.GetString(nameof(Advanced_Status_Readable), Culture) ?? nameof(Advanced_Status_Readable);
public static string Advanced_Status_SourceSilent => ResourceManager.GetString(nameof(Advanced_Status_SourceSilent), Culture) ?? nameof(Advanced_Status_SourceSilent);
public static string Advanced_Tab_Machine => ResourceManager.GetString(nameof(Advanced_Tab_Machine), Culture) ?? nameof(Advanced_Tab_Machine);
public static string Advanced_Tab_Session => ResourceManager.GetString(nameof(Advanced_Tab_Session), Culture) ?? nameof(Advanced_Tab_Session);
public static string Advanced_Tab_Sources => ResourceManager.GetString(nameof(Advanced_Tab_Sources), Culture) ?? nameof(Advanced_Tab_Sources);
public static string AdvGroup_Board => ResourceManager.GetString(nameof(AdvGroup_Board), Culture) ?? nameof(AdvGroup_Board);
public static string AdvGroup_Cpu => ResourceManager.GetString(nameof(AdvGroup_Cpu), Culture) ?? nameof(AdvGroup_Cpu);
public static string AdvGroup_Display => ResourceManager.GetString(nameof(AdvGroup_Display), Culture) ?? nameof(AdvGroup_Display);
public static string AdvGroup_Driver => ResourceManager.GetString(nameof(AdvGroup_Driver), Culture) ?? nameof(AdvGroup_Driver);
public static string AdvGroup_FrameGeneration => ResourceManager.GetString(nameof(AdvGroup_FrameGeneration), Culture) ?? nameof(AdvGroup_FrameGeneration);
public static string AdvGroup_Gpu => ResourceManager.GetString(nameof(AdvGroup_Gpu), Culture) ?? nameof(AdvGroup_Gpu);
public static string AdvGroup_GpuMemory => ResourceManager.GetString(nameof(AdvGroup_GpuMemory), Culture) ?? nameof(AdvGroup_GpuMemory);
public static string AdvGroup_Latency => ResourceManager.GetString(nameof(AdvGroup_Latency), Culture) ?? nameof(AdvGroup_Latency);
public static string AdvGroup_Memory => ResourceManager.GetString(nameof(AdvGroup_Memory), Culture) ?? nameof(AdvGroup_Memory);
public static string AdvGroup_Storage => ResourceManager.GetString(nameof(AdvGroup_Storage), Culture) ?? nameof(AdvGroup_Storage);
public static string AdvGroup_Upscaling => ResourceManager.GetString(nameof(AdvGroup_Upscaling), Culture) ?? nameof(AdvGroup_Upscaling);
public static string AdvInGame_NothingSeen => ResourceManager.GetString(nameof(AdvInGame_NothingSeen), Culture) ?? nameof(AdvInGame_NothingSeen);
public static string AdvInGame_NotHooked => ResourceManager.GetString(nameof(AdvInGame_NotHooked), Culture) ?? nameof(AdvInGame_NotHooked);
public static string AdvInGame_Reading => ResourceManager.GetString(nameof(AdvInGame_Reading), Culture) ?? nameof(AdvInGame_Reading);
public static string AdvInGame_Unknown => ResourceManager.GetString(nameof(AdvInGame_Unknown), Culture) ?? nameof(AdvInGame_Unknown);
public static string AdvReach_Deferred => ResourceManager.GetString(nameof(AdvReach_Deferred), Culture) ?? nameof(AdvReach_Deferred);
public static string AdvReach_Game => ResourceManager.GetString(nameof(AdvReach_Game), Culture) ?? nameof(AdvReach_Game);
public static string AdvReach_HookedCall => ResourceManager.GetString(nameof(AdvReach_HookedCall), Culture) ?? nameof(AdvReach_HookedCall);
public static string AdvReach_Identifier => ResourceManager.GetString(nameof(AdvReach_Identifier), Culture) ?? nameof(AdvReach_Identifier);
public static string AdvReach_Licence => ResourceManager.GetString(nameof(AdvReach_Licence), Culture) ?? nameof(AdvReach_Licence);
public static string AdvReach_NewHook => ResourceManager.GetString(nameof(AdvReach_NewHook), Culture) ?? nameof(AdvReach_NewHook);
public static string AdvReach_NotInHeaders => ResourceManager.GetString(nameof(AdvReach_NotInHeaders), Culture) ?? nameof(AdvReach_NotInHeaders);
public static string AdvReach_PlayerState => ResourceManager.GetString(nameof(AdvReach_PlayerState), Culture) ?? nameof(AdvReach_PlayerState);
public static string AdvReach_Refused => ResourceManager.GetString(nameof(AdvReach_Refused), Culture) ?? nameof(AdvReach_Refused);
public static string AdvReach_Spike => ResourceManager.GetString(nameof(AdvReach_Spike), Culture) ?? nameof(AdvReach_Spike);
public static string AdvScope_MachineFact => ResourceManager.GetString(nameof(AdvScope_MachineFact), Culture) ?? nameof(AdvScope_MachineFact);
public static string AdvScope_Series => ResourceManager.GetString(nameof(AdvScope_Series), Culture) ?? nameof(AdvScope_Series);
public static string AdvScope_SessionFact => ResourceManager.GetString(nameof(AdvScope_SessionFact), Culture) ?? nameof(AdvScope_SessionFact);
public static string AdvSource_Faulted => ResourceManager.GetString(nameof(AdvSource_Faulted), Culture) ?? nameof(AdvSource_Faulted);
public static string AdvSource_NotElevated => ResourceManager.GetString(nameof(AdvSource_NotElevated), Culture) ?? nameof(AdvSource_NotElevated);
public static string AdvSource_NotPresent => ResourceManager.GetString(nameof(AdvSource_NotPresent), Culture) ?? nameof(AdvSource_NotPresent);
public static string AdvSource_PawnIoMissing => ResourceManager.GetString(nameof(AdvSource_PawnIoMissing), Culture) ?? nameof(AdvSource_PawnIoMissing);
public static string AdvSource_Reading => ResourceManager.GetString(nameof(AdvSource_Reading), Culture) ?? nameof(AdvSource_Reading);
public static string AdvSource_Unknown => ResourceManager.GetString(nameof(AdvSource_Unknown), Culture) ?? nameof(AdvSource_Unknown);
public static string AdvToken_adaptive_sync => ResourceManager.GetString(nameof(AdvToken_adaptive_sync), Culture) ?? nameof(AdvToken_adaptive_sync);
public static string AdvToken_agp => ResourceManager.GetString(nameof(AdvToken_agp), Culture) ?? nameof(AdvToken_agp);
public static string AdvToken_axi => ResourceManager.GetString(nameof(AdvToken_axi), Culture) ?? nameof(AdvToken_axi);
public static string AdvToken_bt2100_pq => ResourceManager.GetString(nameof(AdvToken_bt2100_pq), Culture) ?? nameof(AdvToken_bt2100_pq);
public static string AdvToken_desktop => ResourceManager.GetString(nameof(AdvToken_desktop), Culture) ?? nameof(AdvToken_desktop);
public static string AdvToken_discrete => ResourceManager.GetString(nameof(AdvToken_discrete), Culture) ?? nameof(AdvToken_discrete);
public static string AdvToken_dolby_vision => ResourceManager.GetString(nameof(AdvToken_dolby_vision), Culture) ?? nameof(AdvToken_dolby_vision);
public static string AdvToken_draw_debug_view => ResourceManager.GetString(nameof(AdvToken_draw_debug_view), Culture) ?? nameof(AdvToken_draw_debug_view);
public static string AdvToken_driver_default => ResourceManager.GetString(nameof(AdvToken_driver_default), Culture) ?? nameof(AdvToken_driver_default);
public static string AdvToken_edr => ResourceManager.GetString(nameof(AdvToken_edr), Culture) ?? nameof(AdvToken_edr);
public static string AdvToken_fpci => ResourceManager.GetString(nameof(AdvToken_fpci), Culture) ?? nameof(AdvToken_fpci);
public static string AdvToken_game_ready => ResourceManager.GetString(nameof(AdvToken_game_ready), Culture) ?? nameof(AdvToken_game_ready);
public static string AdvToken_gsync_module => ResourceManager.GetString(nameof(AdvToken_gsync_module), Culture) ?? nameof(AdvToken_gsync_module);
public static string AdvToken_hdr10 => ResourceManager.GetString(nameof(AdvToken_hdr10), Culture) ?? nameof(AdvToken_hdr10);
public static string AdvToken_hdr10_plus => ResourceManager.GetString(nameof(AdvToken_hdr10_plus), Culture) ?? nameof(AdvToken_hdr10_plus);
public static string AdvToken_hdr10_plus_gaming => ResourceManager.GetString(nameof(AdvToken_hdr10_plus_gaming), Culture) ?? nameof(AdvToken_hdr10_plus_gaming);
public static string AdvToken_integrated => ResourceManager.GetString(nameof(AdvToken_integrated), Culture) ?? nameof(AdvToken_integrated);
public static string AdvToken_laptop => ResourceManager.GetString(nameof(AdvToken_laptop), Culture) ?? nameof(AdvToken_laptop);
public static string AdvToken_no_profile_for_game => ResourceManager.GetString(nameof(AdvToken_no_profile_for_game), Culture) ?? nameof(AdvToken_no_profile_for_game);
public static string AdvToken_non_linear_color_pq => ResourceManager.GetString(nameof(AdvToken_non_linear_color_pq), Culture) ?? nameof(AdvToken_non_linear_color_pq);
public static string AdvToken_non_linear_color_srgb => ResourceManager.GetString(nameof(AdvToken_non_linear_color_srgb), Culture) ?? nameof(AdvToken_non_linear_color_srgb);
public static string AdvToken_none => ResourceManager.GetString(nameof(AdvToken_none), Culture) ?? nameof(AdvToken_none);
public static string AdvToken_not_a_number => ResourceManager.GetString(nameof(AdvToken_not_a_number), Culture) ?? nameof(AdvToken_not_a_number);
public static string AdvToken_not_supported => ResourceManager.GetString(nameof(AdvToken_not_supported), Culture) ?? nameof(AdvToken_not_supported);
public static string AdvToken_off => ResourceManager.GetString(nameof(AdvToken_off), Culture) ?? nameof(AdvToken_off);
public static string AdvToken_on => ResourceManager.GetString(nameof(AdvToken_on), Culture) ?? nameof(AdvToken_on);
public static string AdvToken_on_and_off => ResourceManager.GetString(nameof(AdvToken_on_and_off), Culture) ?? nameof(AdvToken_on_and_off);
public static string AdvToken_pci => ResourceManager.GetString(nameof(AdvToken_pci), Culture) ?? nameof(AdvToken_pci);
public static string AdvToken_pci_express => ResourceManager.GetString(nameof(AdvToken_pci_express), Culture) ?? nameof(AdvToken_pci_express);
public static string AdvToken_rtx_new_feature => ResourceManager.GetString(nameof(AdvToken_rtx_new_feature), Culture) ?? nameof(AdvToken_rtx_new_feature);
public static string AdvToken_rtx_production => ResourceManager.GetString(nameof(AdvToken_rtx_production), Culture) ?? nameof(AdvToken_rtx_production);
public static string AdvToken_scrgb_linear => ResourceManager.GetString(nameof(AdvToken_scrgb_linear), Culture) ?? nameof(AdvToken_scrgb_linear);
public static string AdvToken_srgb => ResourceManager.GetString(nameof(AdvToken_srgb), Culture) ?? nameof(AdvToken_srgb);
public static string AdvToken_studio => ResourceManager.GetString(nameof(AdvToken_studio), Culture) ?? nameof(AdvToken_studio);
public static string AdvToken_ulmb => ResourceManager.GetString(nameof(AdvToken_ulmb), Culture) ?? nameof(AdvToken_ulmb);
public static string AdvToken_usable_now => ResourceManager.GetString(nameof(AdvToken_usable_now), Culture) ?? nameof(AdvToken_usable_now);
public static string AdvToken_user_set => ResourceManager.GetString(nameof(AdvToken_user_set), Culture) ?? nameof(AdvToken_user_set);
public static string AdvToken_variable_refresh => ResourceManager.GetString(nameof(AdvToken_variable_refresh), Culture) ?? nameof(AdvToken_variable_refresh);
public static string Agent_Banner_Missing_Body => ResourceManager.GetString(nameof(Agent_Banner_Missing_Body), Culture) ?? nameof(Agent_Banner_Missing_Body);
public static string Agent_Banner_Offline_Body => ResourceManager.GetString(nameof(Agent_Banner_Offline_Body), Culture) ?? nameof(Agent_Banner_Offline_Body);
@@ -3584,8 +2809,6 @@ public static class Strings
public static string Menu_Tools_VulkanLayer => ResourceManager.GetString(nameof(Menu_Tools_VulkanLayer), Culture) ?? nameof(Menu_Tools_VulkanLayer);
public static string Nav_Advanced => ResourceManager.GetString(nameof(Nav_Advanced), Culture) ?? nameof(Nav_Advanced);
public static string Nav_Compare => ResourceManager.GetString(nameof(Nav_Compare), Culture) ?? nameof(Nav_Compare);
public static string Nav_Dashboard => ResourceManager.GetString(nameof(Nav_Dashboard), Culture) ?? nameof(Nav_Dashboard);
@@ -3868,10 +3091,6 @@ public static class Strings
public static string Sessions_GameVram_Tooltip_Format => ResourceManager.GetString(nameof(Sessions_GameVram_Tooltip_Format), Culture) ?? nameof(Sessions_GameVram_Tooltip_Format);
public static string Settings_Advanced_Body => ResourceManager.GetString(nameof(Settings_Advanced_Body), Culture) ?? nameof(Settings_Advanced_Body);
public static string Settings_Advanced_Label => ResourceManager.GetString(nameof(Settings_Advanced_Label), Culture) ?? nameof(Settings_Advanced_Label);
public static string Settings_Agent_Elevated => ResourceManager.GetString(nameof(Settings_Agent_Elevated), Culture) ?? nameof(Settings_Agent_Elevated);
public static string Settings_Agent_Elevation_Body => ResourceManager.GetString(nameof(Settings_Agent_Elevation_Body), Culture) ?? nameof(Settings_Agent_Elevation_Body);
@@ -4112,8 +3331,6 @@ public static class Strings
public static string Store_Xbox_Format => ResourceManager.GetString(nameof(Store_Xbox_Format), Culture) ?? nameof(Store_Xbox_Format);
public static string Summary_Advanced_Button => ResourceManager.GetString(nameof(Summary_Advanced_Button), Culture) ?? nameof(Summary_Advanced_Button);
public static string Summary_Annotations_Header => ResourceManager.GetString(nameof(Summary_Annotations_Header), Culture) ?? nameof(Summary_Annotations_Header);
public static string Summary_Crash_Body => ResourceManager.GetString(nameof(Summary_Crash_Body), Culture) ?? nameof(Summary_Crash_Body);
File diff suppressed because it is too large. Load diff
+2 -785
View File
@@ -18,780 +18,9 @@
<resheader name="writer">
<value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
</resheader>
<data name="A11y_Advanced_Metric" xml:space="preserve">
<value>Reading to chart</value>
</data>
<data name="A11y_Advanced_Session" xml:space="preserve">
<value>Session to show</value>
</data>
<data name="A11y_Chart_Advanced" xml:space="preserve">
<value>Advanced reading over time</value>
</data>
<data name="A11y_ChartData_Advanced" xml:space="preserve">
<value>Each line is one reading. The table beside the chart lists the same readings.</value>
</data>
<data name="About_Title" xml:space="preserve">
<value>About FrameLedger</value>
</data>
<data name="Adv_ffx_framegen_config" xml:space="preserve">
<value>The game's FSR frame-generation configuration</value>
</data>
<data name="Adv_ffx_memory_usage" xml:space="preserve">
<value>FSR's own video memory, when the game asks it</value>
</data>
<data name="Adv_ffx_upscale_depth" xml:space="preserve">
<value>Near and far planes and the range of the field of view given to FSR</value>
</data>
<data name="Adv_ffx_upscale_exposure" xml:space="preserve">
<value>Pre-exposure given to FSR</value>
</data>
<data name="Adv_ffx_upscale_flags" xml:space="preserve">
<value>The flags of the game's FSR dispatch</value>
</data>
<data name="Adv_ffx_upscale_frame_time_delta" xml:space="preserve">
<value>The frame time the game reported to FSR</value>
</data>
<data name="Adv_ffx_upscale_jitter" xml:space="preserve">
<value>The largest jitter offset the game gave FSR</value>
</data>
<data name="Adv_ffx_upscale_sharpening" xml:space="preserve">
<value>FSR sharpening: on or off, and its strength</value>
</data>
<data name="Adv_lhm_battery" xml:space="preserve">
<value>Battery sensors</value>
</data>
<data name="Adv_lhm_board_fan" xml:space="preserve">
<value>Each fan header's speed</value>
</data>
<data name="Adv_lhm_board_fan_control" xml:space="preserve">
<value>Each fan header's duty</value>
</data>
<data name="Adv_lhm_board_model" xml:space="preserve">
<value>The motherboard's maker and model</value>
</data>
<data name="Adv_lhm_board_sensor_chip" xml:space="preserve">
<value>The board's sensor chip</value>
</data>
<data name="Adv_lhm_board_temperature" xml:space="preserve">
<value>The board's temperature sensors</value>
</data>
<data name="Adv_lhm_board_voltage" xml:space="preserve">
<value>The board's voltage rails</value>
</data>
<data name="Adv_lhm_controller" xml:space="preserve">
<value>Fan-controller sensors: the same search of USB devices</value>
</data>
<data name="Adv_lhm_cpu_clock" xml:space="preserve">
<value>Each core's clock, and the bus clock</value>
</data>
<data name="Adv_lhm_cpu_load" xml:space="preserve">
<value>Processor load: the total and each core</value>
</data>
<data name="Adv_lhm_cpu_power" xml:space="preserve">
<value>Processor power: the package, the cores</value>
</data>
<data name="Adv_lhm_cpu_temperature" xml:space="preserve">
<value>Processor temperatures: the package and each core</value>
</data>
<data name="Adv_lhm_cpu_voltage" xml:space="preserve">
<value>Processor voltages</value>
</data>
<data name="Adv_lhm_gpu_clock" xml:space="preserve">
<value>Every clock of the card</value>
</data>
<data name="Adv_lhm_gpu_current" xml:space="preserve">
<value>Every current of the card</value>
</data>
<data name="Adv_lhm_gpu_fan" xml:space="preserve">
<value>Every fan of the card</value>
</data>
<data name="Adv_lhm_gpu_fan_control" xml:space="preserve">
<value>Each fan's duty</value>
</data>
<data name="Adv_lhm_gpu_load" xml:space="preserve">
<value>Every load of the card: its engines, its bus, its memory controller</value>
</data>
<data name="Adv_lhm_gpu_memory" xml:space="preserve">
<value>The card's memory counters: total, free, used, Direct3D dedicated and shared</value>
</data>
<data name="Adv_lhm_gpu_power" xml:space="preserve">
<value>Every power reading of the card</value>
</data>
<data name="Adv_lhm_gpu_temperature" xml:space="preserve">
<value>Every temperature sensor of the card</value>
</data>
<data name="Adv_lhm_gpu_throughput" xml:space="preserve">
<value>PCI Express traffic to and from the card</value>
</data>
<data name="Adv_lhm_gpu_voltage" xml:space="preserve">
<value>Every voltage of the card</value>
</data>
<data name="Adv_lhm_memory_load" xml:space="preserve">
<value>Memory in use: physical and virtual</value>
</data>
<data name="Adv_lhm_memory_modules" xml:space="preserve">
<value>The memory modules: size, speed, maker's part name - never a serial number</value>
</data>
<data name="Adv_lhm_memory_temperature" xml:space="preserve">
<value>Each memory module's temperature, where it has a sensor</value>
</data>
<data name="Adv_lhm_psu" xml:space="preserve">
<value>Power-supply sensors: reading them makes the library search every USB device</value>
</data>
<data name="Adv_lhm_storage_models" xml:space="preserve">
<value>The drives' model names: the library cannot list drives without touching removable ones</value>
</data>
<data name="Adv_lhm_storage_temperature" xml:space="preserve">
<value>Each drive's temperature: the same, so the storage group is not opened</value>
</data>
<data name="Adv_ngx_parameters" xml:space="preserve">
<value>NGX parameters: the quality value, the DLSS hints</value>
</data>
<data name="Adv_nvapi_clock_video" xml:space="preserve">
<value>Video clock</value>
</data>
<data name="Adv_nvapi_display_adaptive_sync_off" xml:space="preserve">
<value>Adaptive sync is switched off on the display</value>
</data>
<data name="Adv_nvapi_display_edid" xml:space="preserve">
<value>A display's EDID block, which carries its serial number</value>
</data>
<data name="Adv_nvapi_display_hdr_formats" xml:space="preserve">
<value>HDR formats a display accepts: HDR10, HDR10+, HDR10+ Gaming, Dolby Vision, EDR</value>
</data>
<data name="Adv_nvapi_display_luminance_max" xml:space="preserve">
<value>A display's maximum luminance for HDR content</value>
</data>
<data name="Adv_nvapi_display_luminance_max_frame_average" xml:space="preserve">
<value>Its maximum frame-average light level</value>
</data>
<data name="Adv_nvapi_display_luminance_min" xml:space="preserve">
<value>Its minimum luminance</value>
</data>
<data name="Adv_nvapi_display_max_frame_interval" xml:space="preserve">
<value>The longest frame interval adaptive sync is set to hold</value>
</data>
<data name="Adv_nvapi_display_vrr_support" xml:space="preserve">
<value>Variable refresh: supported, G-SYNC module or adaptive sync, ULMB, usable at the current mode</value>
</data>
<data name="Adv_nvapi_driver_base_branch" xml:space="preserve">
<value>The driver's base branch</value>
</data>
<data name="Adv_nvapi_driver_chipset" xml:space="preserve">
<value>Chipset vendor and name, as the driver reports them</value>
</data>
<data name="Adv_nvapi_driver_dch" xml:space="preserve">
<value>The driver is a DCH package</value>
</data>
<data name="Adv_nvapi_driver_global_profile" xml:space="preserve">
<value>Every setting of the driver's global profile, read-only</value>
</data>
<data name="Adv_nvapi_driver_interface_version" xml:space="preserve">
<value>NVAPI's own interface version</value>
</data>
<data name="Adv_nvapi_driver_package" xml:space="preserve">
<value>Game Ready, Studio or an RTX enterprise branch</value>
</data>
<data name="Adv_nvapi_encoder_fps" xml:space="preserve">
<value>Average encoding rate of the active sessions</value>
</data>
<data name="Adv_nvapi_encoder_latency" xml:space="preserve">
<value>Average encoding latency</value>
</data>
<data name="Adv_nvapi_encoder_session_processes" xml:space="preserve">
<value>Which programs are encoding</value>
</data>
<data name="Adv_nvapi_encoder_sessions" xml:space="preserve">
<value>Active hardware-encoder sessions, all programs</value>
</data>
<data name="Adv_nvapi_gpu_architecture" xml:space="preserve">
<value>Chip architecture, implementation and revision</value>
</data>
<data name="Adv_nvapi_gpu_board_serial" xml:space="preserve">
<value>The card's board serial number</value>
</data>
<data name="Adv_nvapi_gpu_bus_type" xml:space="preserve">
<value>The bus the card sits on</value>
</data>
<data name="Adv_nvapi_gpu_clock_base_core" xml:space="preserve">
<value>Base core clock</value>
</data>
<data name="Adv_nvapi_gpu_clock_base_memory" xml:space="preserve">
<value>Base memory clock</value>
</data>
<data name="Adv_nvapi_gpu_clock_boost_core" xml:space="preserve">
<value>Boost core clock</value>
</data>
<data name="Adv_nvapi_gpu_clock_boost_memory" xml:space="preserve">
<value>Boost memory clock</value>
</data>
<data name="Adv_nvapi_gpu_core_count" xml:space="preserve">
<value>Graphics cores</value>
</data>
<data name="Adv_nvapi_gpu_external" xml:space="preserve">
<value>The card is an external one</value>
</data>
<data name="Adv_nvapi_gpu_fan_duty" xml:space="preserve">
<value>Fan duty through NVAPI (LibreHardwareMonitor reads it)</value>
</data>
<data name="Adv_nvapi_gpu_pci_ids" xml:space="preserve">
<value>PCI device, subsystem and revision ids - the model, not the unit</value>
</data>
<data name="Adv_nvapi_gpu_power" xml:space="preserve">
<value>Card power through NVAPI (LibreHardwareMonitor reads it)</value>
</data>
<data name="Adv_nvapi_gpu_ram_bus_width" xml:space="preserve">
<value>Width of the card's memory bus</value>
</data>
<data name="Adv_nvapi_gpu_ram_type" xml:space="preserve">
<value>The card's memory type</value>
</data>
<data name="Adv_nvapi_gpu_rt_cores" xml:space="preserve">
<value>Ray-tracing cores</value>
</data>
<data name="Adv_nvapi_gpu_system_type" xml:space="preserve">
<value>Laptop or desktop, as the driver sees the PC</value>
</data>
<data name="Adv_nvapi_gpu_temp_default_max" xml:space="preserve">
<value>The core sensor's default maximum temperature</value>
</data>
<data name="Adv_nvapi_gpu_tensor_cores" xml:space="preserve">
<value>Tensor cores</value>
</data>
<data name="Adv_nvapi_gpu_type" xml:space="preserve">
<value>Integrated or discrete graphics</value>
</data>
<data name="Adv_nvapi_gpu_uuid" xml:space="preserve">
<value>The card's unique id</value>
</data>
<data name="Adv_nvapi_gpu_vbios_version" xml:space="preserve">
<value>Video BIOS version</value>
</data>
<data name="Adv_nvapi_gpu_voltage" xml:space="preserve">
<value>Card voltage through NVAPI (LibreHardwareMonitor reads it)</value>
</data>
<data name="Adv_nvapi_limit_ac_battery" xml:space="preserve">
<value>Held back by a switch to battery on the tick: 100 or 0</value>
</data>
<data name="Adv_nvapi_limit_api" xml:space="preserve">
<value>Held back at a program's request on the tick: 100 or 0</value>
</data>
<data name="Adv_nvapi_limit_insufficient_power" xml:space="preserve">
<value>Held back by a missing power connector on the tick: 100 or 0</value>
</data>
<data name="Adv_nvapi_load_bus" xml:space="preserve">
<value>Bus-interface utilisation</value>
</data>
<data name="Adv_nvapi_load_framebuffer" xml:space="preserve">
<value>Frame-buffer (memory controller) utilisation</value>
</data>
<data name="Adv_nvapi_load_video" xml:space="preserve">
<value>Video-engine utilisation</value>
</data>
<data name="Adv_nvapi_pstate" xml:space="preserve">
<value>The card's current performance state (P-state id)</value>
</data>
<data name="Adv_nvapi_reflex_frame_report" xml:space="preserve">
<value>Latency per frame: simulation, render submit, present, driver, OS queue, GPU render</value>
</data>
<data name="Adv_nvapi_reflex_mode" xml:space="preserve">
<value>Reflex: low-latency mode, boost, the frame-rate limit</value>
</data>
<data name="Adv_nvapi_reflex_sleep_status" xml:space="preserve">
<value>What the driver's low-latency state is</value>
</data>
<data name="Adv_nvapi_session_driver_profile" xml:space="preserve">
<value>The settings the driver's profile for this game sets itself, read-only</value>
</data>
<data name="Adv_nvapi_session_source_colorspace" xml:space="preserve">
<value>The colour space the game presented in, as the driver reports it for the process</value>
</data>
<data name="Adv_nvapi_session_vrr_display_mode" xml:space="preserve">
<value>The display itself was in variable-refresh mode</value>
</data>
<data name="Adv_nvapi_session_vrr_enabled" xml:space="preserve">
<value>Variable refresh was active on the game's display</value>
</data>
<data name="Adv_nvapi_session_vrr_possible" xml:space="preserve">
<value>Variable refresh was possible on it</value>
</data>
<data name="Adv_nvapi_session_vrr_requested" xml:space="preserve">
<value>Variable refresh was requested for it</value>
</data>
<data name="Adv_nvapi_temp_board" xml:space="preserve">
<value>Board ambient temperature, where the card has the sensor</value>
</data>
<data name="Adv_nvapi_temp_power_supply" xml:space="preserve">
<value>The card's power-supply temperature, where it has the sensor</value>
</data>
<data name="Adv_nvapi_vram_available" xml:space="preserve">
<value>Dedicated video memory available now, all programs</value>
</data>
<data name="Adv_nvapi_vram_dedicated" xml:space="preserve">
<value>Dedicated video memory on the card</value>
</data>
<data name="Adv_nvapi_vram_dedicated_available" xml:space="preserve">
<value>Dedicated video memory available for surfaces</value>
</data>
<data name="Adv_nvapi_vram_eviction_count" xml:space="preserve">
<value>Evictions from dedicated video memory since the driver loaded</value>
</data>
<data name="Adv_nvapi_vram_evictions_size" xml:space="preserve">
<value>Memory released by evictions since the driver loaded</value>
</data>
<data name="Adv_nvapi_vram_framebuffer_physical" xml:space="preserve">
<value>Physical frame buffer size</value>
</data>
<data name="Adv_nvapi_vram_framebuffer_virtual" xml:space="preserve">
<value>Virtual frame buffer size</value>
</data>
<data name="Adv_nvapi_vram_in_use" xml:space="preserve">
<value>Dedicated video memory in use now, all programs: available for surfaces less available now</value>
</data>
<data name="Adv_nvapi_vram_promotion_count" xml:space="preserve">
<value>Promotions into dedicated video memory since the driver loaded</value>
</data>
<data name="Adv_nvapi_vram_promotions_size" xml:space="preserve">
<value>Memory moved in by promotions since the driver loaded</value>
</data>
<data name="Adv_nvapi_vram_shared" xml:space="preserve">
<value>Shared system memory the driver may commit</value>
</data>
<data name="Adv_nvapi_vram_system" xml:space="preserve">
<value>System memory the driver reserved at load</value>
</data>
<data name="Adv_sl_constants_camera" xml:space="preserve">
<value>Camera position, axes and matrices</value>
</data>
<data name="Adv_sl_constants_depth" xml:space="preserve">
<value>Near and far planes, and whether depth is inverted</value>
</data>
<data name="Adv_sl_constants_jitter" xml:space="preserve">
<value>The jitter offsets the game gave Streamline</value>
</data>
<data name="Adv_sl_constants_motion_vectors" xml:space="preserve">
<value>Motion-vector scale, and whether they are 3D, dilated, jittered</value>
</data>
<data name="Adv_sl_constants_projection" xml:space="preserve">
<value>Field of view, aspect ratio, orthographic or not</value>
</data>
<data name="Adv_sl_constants_resets" xml:space="preserve">
<value>How often the game reset the upscaler's history</value>
</data>
<data name="Adv_sl_deepdvc_options" xml:space="preserve">
<value>RTX Dynamic Vibrance's options</value>
</data>
<data name="Adv_sl_dlss_alpha_upscaling" xml:space="preserve">
<value>DLSS upscales the alpha channel</value>
</data>
<data name="Adv_sl_dlss_auto_exposure" xml:space="preserve">
<value>DLSS auto-exposure</value>
</data>
<data name="Adv_sl_dlss_exposure" xml:space="preserve">
<value>Pre-exposure and exposure scale given to DLSS</value>
</data>
<data name="Adv_sl_dlss_hdr_input" xml:space="preserve">
<value>The game told DLSS its colour buffers are HDR</value>
</data>
<data name="Adv_sl_dlss_optimal_settings" xml:space="preserve">
<value>The render size and sharpness DLSS recommends</value>
</data>
<data name="Adv_sl_dlss_output_size" xml:space="preserve">
<value>The output size the game gave DLSS</value>
</data>
<data name="Adv_sl_dlss_presets" xml:space="preserve">
<value>The DLSS model preset per quality mode</value>
</data>
<data name="Adv_sl_dlss_vram_estimate" xml:space="preserve">
<value>DLSS's own estimate of its video memory</value>
</data>
<data name="Adv_sl_dlssd_options" xml:space="preserve">
<value>Ray reconstruction's options</value>
</data>
<data name="Adv_sl_dlssg_frames_presented" xml:space="preserve">
<value>Frames DLSS frame generation presented, by its own count</value>
</data>
<data name="Adv_sl_dlssg_options" xml:space="preserve">
<value>DLSS frame generation: mode, frames to generate</value>
</data>
<data name="Adv_sl_dlssg_state" xml:space="preserve">
<value>DLSS frame generation: status, the most frames it can generate</value>
</data>
<data name="Adv_sl_dlssg_vram_estimate" xml:space="preserve">
<value>DLSS frame generation's estimate of its video memory</value>
</data>
<data name="Adv_sl_feature_requirements" xml:space="preserve">
<value>What each Streamline feature requires: operating system, driver, buffers</value>
</data>
<data name="Adv_sl_feature_versions" xml:space="preserve">
<value>Each Streamline feature's version and its NGX model version</value>
</data>
<data name="Adv_sl_init_preferences" xml:space="preserve">
<value>The preferences the game started Streamline with</value>
</data>
<data name="Adv_sl_nis_options" xml:space="preserve">
<value>NVIDIA Image Scaling's options</value>
</data>
<data name="Adv_sl_nvperf" xml:space="preserve">
<value>Streamline's performance counters (NSight Perf SDK licence)</value>
</data>
<data name="Adv_sl_pcl_markers" xml:space="preserve">
<value>PC-latency markers the game sets</value>
</data>
<data name="Adv_sl_reflex_state" xml:space="preserve">
<value>Reflex through Streamline: availability and its frame reports</value>
</data>
<data name="Adv_xess_options" xml:space="preserve">
<value>XeSS's options</value>
</data>
<data name="Advanced_Chart_Band" xml:space="preserve">
<value>More than eight series: the lowest, the average and the highest of them are drawn. The table lists each one.</value>
</data>
<data name="Advanced_Chart_Empty" xml:space="preserve">
<value>Nothing to draw yet.</value>
</data>
<data name="Advanced_Chart_Header" xml:space="preserve">
<value>Over time</value>
</data>
<data name="Advanced_Chart_LiveNote" xml:space="preserve">
<value>The last five minutes, kept in memory only.</value>
</data>
<data name="Advanced_Chart_Metric" xml:space="preserve">
<value>Show</value>
</data>
<data name="Advanced_Chart_Seconds" xml:space="preserve">
<value>Seconds from the session's start</value>
</data>
<data name="Advanced_Chart_Time" xml:space="preserve">
<value>Time</value>
</data>
<data name="Advanced_Col_Name" xml:space="preserve">
<value>Reading</value>
</data>
<data name="Advanced_Col_ReadAt" xml:space="preserve">
<value>Read at</value>
</data>
<data name="Advanced_Col_Samples" xml:space="preserve">
<value>Readings</value>
</data>
<data name="Advanced_Col_Scope" xml:space="preserve">
<value>Belongs to</value>
</data>
<data name="Advanced_Col_Source" xml:space="preserve">
<value>Source</value>
</data>
<data name="Advanced_Col_Status" xml:space="preserve">
<value>Status</value>
</data>
<data name="Advanced_Col_Value" xml:space="preserve">
<value>Value</value>
</data>
<data name="Advanced_Elevation_Hint" xml:space="preserve">
<value>The processor, the memory and the motherboard are read only when the capture agent runs as administrator with PawnIO installed (Settings ▸ Capture agent).</value>
</data>
<data name="Advanced_Facts_Header" xml:space="preserve">
<value>About this PC</value>
</data>
<data name="Advanced_Header" xml:space="preserve">
<value>Advanced metrics</value>
</data>
<data name="Advanced_InGameLine" xml:space="preserve">
<value>Inside the game: {0}.</value>
</data>
<data name="Advanced_Machine_Intro" xml:space="preserve">
<value>What the graphics driver and the hardware sensors say about this PC right now. It is read only while this page is open or a game is being recorded, and nothing shown here is stored.</value>
</data>
<data name="Advanced_Max" xml:space="preserve">
<value>Highest</value>
</data>
<data name="Advanced_Mean" xml:space="preserve">
<value>Average</value>
</data>
<data name="Advanced_Min" xml:space="preserve">
<value>Lowest</value>
</data>
<data name="Advanced_Now_Header" xml:space="preserve">
<value>Right now</value>
</data>
<data name="Advanced_Session_Empty" xml:space="preserve">
<value>No session has been recorded with Advanced metrics on yet. A session recorded while it was off is not filled in later.</value>
</data>
<data name="Advanced_Session_Facts" xml:space="preserve">
<value>The PC and the session</value>
</data>
<data name="Advanced_Session_NoSeries" xml:space="preserve">
<value>This session's per-second series are no longer kept (Settings ▸ Recording ▸ Raw series kept per game); its statistics are.</value>
</data>
<data name="Advanced_Session_NoStats" xml:space="preserve">
<value>No reading was stored for this session.</value>
</data>
<data name="Advanced_Session_Pick" xml:space="preserve">
<value>Session</value>
</data>
<data name="Advanced_Session_Stats" xml:space="preserve">
<value>Statistics of the session</value>
</data>
<data name="Advanced_Sources_Intro" xml:space="preserve">
<value>Everything FrameLedger knows how to read, and everything it does not read, with the reason.</value>
</data>
<data name="Advanced_SourcesLine" xml:space="preserve">
<value>NVIDIA driver: {0}. Graphics-card sensors: {1}. Processor, memory and motherboard sensors: {2}.</value>
</data>
<data name="Advanced_State_Live" xml:space="preserve">
<value>Read by the capture agent at {0}. NVIDIA's figures are read every second, the sensors every five.</value>
</data>
<data name="Advanced_State_NoAgent" xml:space="preserve">
<value>The capture agent is not answering. What is shown below is as old as its time says.</value>
</data>
<data name="Advanced_State_Off" xml:space="preserve">
<value>Advanced metrics is off, so nothing is read. Turn it on in Settings ▸ Recording.</value>
</data>
<data name="Advanced_State_OlderAgent" xml:space="preserve">
<value>The capture agent that is running is an older version and cannot answer this. Restart FrameLedger.</value>
</data>
<data name="Advanced_State_Viewer" xml:space="preserve">
<value>This is a copy of a ledger: nothing is read from this PC. The sessions stored in the copy are under Session.</value>
</data>
<data name="Advanced_State_Waiting" xml:space="preserve">
<value>The capture agent is opening its sources…</value>
</data>
<data name="Advanced_Status_InGame" xml:space="preserve">
<value>Read inside a game FrameLedger measures, when the game makes the call</value>
</data>
<data name="Advanced_Status_Read" xml:space="preserve">
<value>Read</value>
</data>
<data name="Advanced_Status_Readable" xml:space="preserve">
<value>Read when a session or this page asks</value>
</data>
<data name="Advanced_Status_SourceSilent" xml:space="preserve">
<value>Not read now: {0}</value>
</data>
<data name="Advanced_Tab_Machine" xml:space="preserve">
<value>This PC</value>
</data>
<data name="Advanced_Tab_Session" xml:space="preserve">
<value>Session</value>
</data>
<data name="Advanced_Tab_Sources" xml:space="preserve">
<value>Sources</value>
</data>
<data name="AdvGroup_Board" xml:space="preserve">
<value>Motherboard</value>
</data>
<data name="AdvGroup_Cpu" xml:space="preserve">
<value>Processor</value>
</data>
<data name="AdvGroup_Display" xml:space="preserve">
<value>Displays</value>
</data>
<data name="AdvGroup_Driver" xml:space="preserve">
<value>Graphics driver</value>
</data>
<data name="AdvGroup_FrameGeneration" xml:space="preserve">
<value>Frame generation</value>
</data>
<data name="AdvGroup_Gpu" xml:space="preserve">
<value>Graphics card</value>
</data>
<data name="AdvGroup_GpuMemory" xml:space="preserve">
<value>Graphics card memory</value>
</data>
<data name="AdvGroup_Latency" xml:space="preserve">
<value>Latency</value>
</data>
<data name="AdvGroup_Memory" xml:space="preserve">
<value>Memory</value>
</data>
<data name="AdvGroup_Storage" xml:space="preserve">
<value>Storage</value>
</data>
<data name="AdvGroup_Upscaling" xml:space="preserve">
<value>Upscaling</value>
</data>
<data name="AdvInGame_NotHooked" xml:space="preserve">
<value>the session was not measured inside the game</value>
</data>
<data name="AdvInGame_NothingSeen" xml:space="preserve">
<value>the game made none of the calls these are read from</value>
</data>
<data name="AdvInGame_Reading" xml:space="preserve">
<value>read from the game's own calls</value>
</data>
<data name="AdvInGame_Unknown" xml:space="preserve">
<value>not known</value>
</data>
<data name="AdvReach_Deferred" xml:space="preserve">
<value>Not read in this release</value>
</data>
<data name="AdvReach_Game" xml:space="preserve">
<value>Inside a game FrameLedger measures</value>
</data>
<data name="AdvReach_HookedCall" xml:space="preserve">
<value>Inside the game - comes with a later release</value>
</data>
<data name="AdvReach_Identifier" xml:space="preserve">
<value>Never read: it identifies this PC, a display or another program</value>
</data>
<data name="AdvReach_Licence" xml:space="preserve">
<value>Not read: the vendor's licence does not allow it</value>
</data>
<data name="AdvReach_NewHook" xml:space="preserve">
<value>Inside the game, with a new hook - comes with a later release</value>
</data>
<data name="AdvReach_NotInHeaders" xml:space="preserve">
<value>Not offered by this interface</value>
</data>
<data name="AdvReach_PlayerState" xml:space="preserve">
<value>Never read: it is the player's state in the game</value>
</data>
<data name="AdvReach_Refused" xml:space="preserve">
<value>Not read: it would make the sensor library search every USB device</value>
</data>
<data name="AdvReach_Spike" xml:space="preserve">
<value>Being studied; not decided</value>
</data>
<data name="AdvScope_MachineFact" xml:space="preserve">
<value>This PC</value>
</data>
<data name="AdvScope_Series" xml:space="preserve">
<value>A session, over time</value>
</data>
<data name="AdvScope_SessionFact" xml:space="preserve">
<value>A session</value>
</data>
<data name="AdvSource_Faulted" xml:space="preserve">
<value>failed while reading</value>
</data>
<data name="AdvSource_NotElevated" xml:space="preserve">
<value>the capture agent is not running as administrator</value>
</data>
<data name="AdvSource_NotPresent" xml:space="preserve">
<value>not present on this PC</value>
</data>
<data name="AdvSource_PawnIoMissing" xml:space="preserve">
<value>PawnIO is not installed</value>
</data>
<data name="AdvSource_Reading" xml:space="preserve">
<value>answering</value>
</data>
<data name="AdvSource_Unknown" xml:space="preserve">
<value>not asked yet</value>
</data>
<data name="AdvToken_adaptive_sync" xml:space="preserve">
<value>Adaptive sync</value>
</data>
<data name="AdvToken_agp" xml:space="preserve">
<value>AGP</value>
</data>
<data name="AdvToken_axi" xml:space="preserve">
<value>AXI</value>
</data>
<data name="AdvToken_bt2100_pq" xml:space="preserve">
<value>BT.2100 PQ (HDR10)</value>
</data>
<data name="AdvToken_desktop" xml:space="preserve">
<value>Desktop</value>
</data>
<data name="AdvToken_discrete" xml:space="preserve">
<value>Discrete</value>
</data>
<data name="AdvToken_dolby_vision" xml:space="preserve">
<value>Dolby Vision</value>
</data>
<data name="AdvToken_driver_default" xml:space="preserve">
<value>Driver default</value>
</data>
<data name="AdvToken_draw_debug_view" xml:space="preserve">
<value>Debug view</value>
</data>
<data name="AdvToken_edr" xml:space="preserve">
<value>EDR</value>
</data>
<data name="AdvToken_fpci" xml:space="preserve">
<value>FPCI</value>
</data>
<data name="AdvToken_game_ready" xml:space="preserve">
<value>Game Ready</value>
</data>
<data name="AdvToken_gsync_module" xml:space="preserve">
<value>G-SYNC module</value>
</data>
<data name="AdvToken_hdr10" xml:space="preserve">
<value>HDR10</value>
</data>
<data name="AdvToken_hdr10_plus" xml:space="preserve">
<value>HDR10+</value>
</data>
<data name="AdvToken_hdr10_plus_gaming" xml:space="preserve">
<value>HDR10+ Gaming</value>
</data>
<data name="AdvToken_integrated" xml:space="preserve">
<value>Integrated</value>
</data>
<data name="AdvToken_laptop" xml:space="preserve">
<value>Laptop</value>
</data>
<data name="AdvToken_no_profile_for_game" xml:space="preserve">
<value>The driver has no profile for this game</value>
</data>
<data name="AdvToken_non_linear_color_pq" xml:space="preserve">
<value>Non-linear colour, PQ</value>
</data>
<data name="AdvToken_non_linear_color_srgb" xml:space="preserve">
<value>Non-linear colour, sRGB</value>
</data>
<data name="AdvToken_none" xml:space="preserve">
<value>None</value>
</data>
<data name="AdvToken_not_a_number" xml:space="preserve">
<value>Not a number</value>
</data>
<data name="AdvToken_not_supported" xml:space="preserve">
<value>Not supported</value>
</data>
<data name="AdvToken_off" xml:space="preserve">
<value>Off</value>
</data>
<data name="AdvToken_on" xml:space="preserve">
<value>On</value>
</data>
<data name="AdvToken_on_and_off" xml:space="preserve">
<value>On at times, off at others</value>
</data>
<data name="AdvToken_pci" xml:space="preserve">
<value>PCI</value>
</data>
<data name="AdvToken_pci_express" xml:space="preserve">
<value>PCI Express</value>
</data>
<data name="AdvToken_rtx_new_feature" xml:space="preserve">
<value>RTX new-feature branch</value>
</data>
<data name="AdvToken_rtx_production" xml:space="preserve">
<value>RTX production branch</value>
</data>
<data name="AdvToken_scrgb_linear" xml:space="preserve">
<value>scRGB (linear)</value>
</data>
<data name="AdvToken_srgb" xml:space="preserve">
<value>sRGB</value>
</data>
<data name="AdvToken_studio" xml:space="preserve">
<value>Studio</value>
</data>
<data name="AdvToken_ulmb" xml:space="preserve">
<value>ULMB</value>
</data>
<data name="AdvToken_usable_now" xml:space="preserve">
<value>Usable at the current mode</value>
</data>
<data name="AdvToken_user_set" xml:space="preserve">
<value>Set by the user</value>
</data>
<data name="AdvToken_variable_refresh" xml:space="preserve">
<value>Variable refresh</value>
</data>
<data name="Agent_Banner_Missing_Body" xml:space="preserve">
<value>FrameLedger.Agent.exe was not found beside this application. Sessions are still readable; live status and capture control are not.</value>
</data>
@@ -1053,9 +282,6 @@
<data name="Menu_Tools_VulkanLayer" xml:space="preserve">
<value>Vulkan layer registration…</value>
</data>
<data name="Nav_Advanced" xml:space="preserve">
<value>Advanced</value>
</data>
<data name="Nav_Compare" xml:space="preserve">
<value>Compare</value>
</data>
@@ -1083,12 +309,6 @@
<data name="Rules_Update_Failed" xml:space="preserve">
<value>The agent did not answer the rules update.</value>
</data>
<data name="Settings_Advanced_Body" xml:space="preserve">
<value>Read more from the graphics driver and the hardware sensors during a session - the graphics card's memory and load in detail, each fan and voltage, what your display can do, the driver's settings for the game - and, in a game FrameLedger measures from inside, what the game tells DLSS and FSR (sizes, presets, sharpening, exposure - never where the camera is). All of it is stored with the session. Off: nothing more is read or stored, inside a game either. It applies from the next session, and a session recorded while it was off is not filled in later.</value>
</data>
<data name="Settings_Advanced_Label" xml:space="preserve">
<value>Advanced metrics</value>
</data>
<data name="Settings_Appearance_Header" xml:space="preserve">
<value>Appearance</value>
</data>
@@ -1734,9 +954,6 @@
<data name="Sessions_Col_Tier" xml:space="preserve">
<value>Tier</value>
</data>
<data name="Summary_Advanced_Button" xml:space="preserve">
<value>Advanced metrics…</value>
</data>
<data name="Tier_Dash_Tooltip" xml:space="preserve">
<value>—: frame generation was measured as none, so there is no displayed rate distinct from the native one</value>
</data>
@@ -2275,7 +1492,7 @@
<value>Running elevated.</value>
</data>
<data name="Settings_Agent_Elevation_Body" xml:space="preserve">
<value>Elevation is not required by any capture tier. It optionally unlocks CPU temperature and, with Advanced metrics on, the processor's, the memory's and the motherboard's sensors (both through PawnIO), and attaching to games that run elevated themselves. Everything else — hooking, measuring, recording — works without it.</value>
<value>Elevation is not required by any capture tier. It optionally unlocks CPU temperature (through PawnIO) and attaching to games that run elevated themselves. Everything else — hooking, measuring, recording — works without it.</value>
</data>
<data name="Settings_Agent_Elevation_Label" xml:space="preserve">
<value>Elevation</value>
@@ -2542,7 +1759,7 @@
<value>Accept</value>
</data>
<data name="FirstRun_Agent_Body" xml:space="preserve">
<value>FrameLedger starts a small capture agent beside itself, as a standard user — not elevated. Elevation is optional and is not required by any capture tier: it only unlocks CPU temperature and, with Advanced metrics on, the processor's, the memory's and the motherboard's sensors (both through PawnIO), and attaching to games that run elevated themselves. Below is what the agent reports about this machine.</value>
<value>FrameLedger starts a small capture agent beside itself, as a standard user — not elevated. Elevation is optional and is not required by any capture tier: it only unlocks CPU temperature (through PawnIO) and attaching to games that run elevated themselves. Below is what the agent reports about this machine.</value>
</data>
<data name="FirstRun_Agent_Header" xml:space="preserve">
<value>The capture agent</value>
+2 -785
View File
@@ -13,780 +13,9 @@
<resheader name="writer">
<value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
</resheader>
<data name="A11y_Advanced_Metric" xml:space="preserve">
<value>Chỉ số để vẽ biểu đồ</value>
</data>
<data name="A11y_Advanced_Session" xml:space="preserve">
<value>Phiên để hiển thị</value>
</data>
<data name="A11y_Chart_Advanced" xml:space="preserve">
<value>Chỉ số nâng cao theo thời gian</value>
</data>
<data name="A11y_ChartData_Advanced" xml:space="preserve">
<value>Mỗi đường là một chỉ số. Bảng cạnh biểu đồ liệt kê cùng các chỉ số đó.</value>
</data>
<data name="About_Title" xml:space="preserve">
<value>Giới thiệu FrameLedger</value>
</data>
<data name="Adv_ffx_framegen_config" xml:space="preserve">
<value>Cấu hình tạo khung hình FSR của game</value>
</data>
<data name="Adv_ffx_memory_usage" xml:space="preserve">
<value>Bộ nhớ video của riêng FSR, khi game hỏi</value>
</data>
<data name="Adv_ffx_upscale_depth" xml:space="preserve">
<value>Mặt phẳng gần, xa và khoảng góc nhìn đưa cho FSR</value>
</data>
<data name="Adv_ffx_upscale_exposure" xml:space="preserve">
<value>Tiền phơi sáng đưa cho FSR</value>
</data>
<data name="Adv_ffx_upscale_flags" xml:space="preserve">
<value>Các cờ trong lệnh dispatch FSR của game</value>
</data>
<data name="Adv_ffx_upscale_frame_time_delta" xml:space="preserve">
<value>Thời gian khung hình game báo cho FSR</value>
</data>
<data name="Adv_ffx_upscale_jitter" xml:space="preserve">
<value>Độ lệch jitter lớn nhất game đưa cho FSR</value>
</data>
<data name="Adv_ffx_upscale_sharpening" xml:space="preserve">
<value>Làm nét của FSR: bật hay tắt, và cường độ</value>
</data>
<data name="Adv_lhm_battery" xml:space="preserve">
<value>Cảm biến pin</value>
</data>
<data name="Adv_lhm_board_fan" xml:space="preserve">
<value>Tốc độ của từng chân cắm quạt</value>
</data>
<data name="Adv_lhm_board_fan_control" xml:space="preserve">
<value>Mức điều khiển của từng chân cắm quạt</value>
</data>
<data name="Adv_lhm_board_model" xml:space="preserve">
<value>Hãng và model bo mạch chủ</value>
</data>
<data name="Adv_lhm_board_sensor_chip" xml:space="preserve">
<value>Chip cảm biến của bo mạch</value>
</data>
<data name="Adv_lhm_board_temperature" xml:space="preserve">
<value>Các cảm biến nhiệt độ của bo mạch</value>
</data>
<data name="Adv_lhm_board_voltage" xml:space="preserve">
<value>Các đường điện áp của bo mạch</value>
</data>
<data name="Adv_lhm_controller" xml:space="preserve">
<value>Cảm biến bộ điều khiển quạt: cũng phải dò thiết bị USB như vậy</value>
</data>
<data name="Adv_lhm_cpu_clock" xml:space="preserve">
<value>Xung của từng nhân, và xung bus</value>
</data>
<data name="Adv_lhm_cpu_load" xml:space="preserve">
<value>Tải bộ xử lý: tổng và từng nhân</value>
</data>
<data name="Adv_lhm_cpu_power" xml:space="preserve">
<value>Công suất bộ xử lý: cả gói, các nhân</value>
</data>
<data name="Adv_lhm_cpu_temperature" xml:space="preserve">
<value>Nhiệt độ bộ xử lý: cả gói và từng nhân</value>
</data>
<data name="Adv_lhm_cpu_voltage" xml:space="preserve">
<value>Các điện áp của bộ xử lý</value>
</data>
<data name="Adv_lhm_gpu_clock" xml:space="preserve">
<value>Mọi xung nhịp của card</value>
</data>
<data name="Adv_lhm_gpu_current" xml:space="preserve">
<value>Mọi dòng điện của card</value>
</data>
<data name="Adv_lhm_gpu_fan" xml:space="preserve">
<value>Mọi quạt của card</value>
</data>
<data name="Adv_lhm_gpu_fan_control" xml:space="preserve">
<value>Mức điều khiển của từng quạt</value>
</data>
<data name="Adv_lhm_gpu_load" xml:space="preserve">
<value>Mọi mức tải của card: các bộ xử lý, bus, bộ điều khiển bộ nhớ</value>
</data>
<data name="Adv_lhm_gpu_memory" xml:space="preserve">
<value>Các bộ đếm bộ nhớ của card: tổng, trống, đã dùng, Direct3D chuyên dụng và dùng chung</value>
</data>
<data name="Adv_lhm_gpu_power" xml:space="preserve">
<value>Mọi số đo công suất của card</value>
</data>
<data name="Adv_lhm_gpu_temperature" xml:space="preserve">
<value>Mọi cảm biến nhiệt độ của card</value>
</data>
<data name="Adv_lhm_gpu_throughput" xml:space="preserve">
<value>Lưu lượng PCI Express đến và đi từ card</value>
</data>
<data name="Adv_lhm_gpu_voltage" xml:space="preserve">
<value>Mọi điện áp của card</value>
</data>
<data name="Adv_lhm_memory_load" xml:space="preserve">
<value>Bộ nhớ đang dùng: vật lý và ảo</value>
</data>
<data name="Adv_lhm_memory_modules" xml:space="preserve">
<value>Các thanh nhớ: dung lượng, tốc độ, tên linh kiện của hãng - không bao giờ có số sê-ri</value>
</data>
<data name="Adv_lhm_memory_temperature" xml:space="preserve">
<value>Nhiệt độ từng thanh nhớ, nếu có cảm biến</value>
</data>
<data name="Adv_lhm_psu" xml:space="preserve">
<value>Cảm biến bộ nguồn: đọc chúng khiến thư viện dò mọi thiết bị USB</value>
</data>
<data name="Adv_lhm_storage_models" xml:space="preserve">
<value>Tên model các ổ đĩa: thư viện không liệt kê được ổ mà không chạm vào ổ tháo rời</value>
</data>
<data name="Adv_lhm_storage_temperature" xml:space="preserve">
<value>Nhiệt độ từng ổ đĩa: cùng lý do, nên nhóm lưu trữ không được mở</value>
</data>
<data name="Adv_ngx_parameters" xml:space="preserve">
<value>Tham số NGX: giá trị chất lượng, các gợi ý DLSS</value>
</data>
<data name="Adv_nvapi_clock_video" xml:space="preserve">
<value>Xung video</value>
</data>
<data name="Adv_nvapi_display_adaptive_sync_off" xml:space="preserve">
<value>Adaptive sync đang tắt trên màn hình</value>
</data>
<data name="Adv_nvapi_display_edid" xml:space="preserve">
<value>Khối EDID của màn hình, có chứa số sê-ri của nó</value>
</data>
<data name="Adv_nvapi_display_hdr_formats" xml:space="preserve">
<value>Định dạng HDR màn hình nhận: HDR10, HDR10+, HDR10+ Gaming, Dolby Vision, EDR</value>
</data>
<data name="Adv_nvapi_display_luminance_max" xml:space="preserve">
<value>Độ chói tối đa của màn hình cho nội dung HDR</value>
</data>
<data name="Adv_nvapi_display_luminance_max_frame_average" xml:space="preserve">
<value>Mức sáng trung bình khung hình tối đa của màn hình</value>
</data>
<data name="Adv_nvapi_display_luminance_min" xml:space="preserve">
<value>Độ chói tối thiểu của màn hình</value>
</data>
<data name="Adv_nvapi_display_max_frame_interval" xml:space="preserve">
<value>Khoảng khung hình dài nhất mà adaptive sync được đặt để giữ</value>
</data>
<data name="Adv_nvapi_display_vrr_support" xml:space="preserve">
<value>Tần số quét biến thiên: có hỗ trợ, mô-đun G-SYNC hay adaptive sync, ULMB, dùng được ở chế độ hiện tại</value>
</data>
<data name="Adv_nvapi_driver_base_branch" xml:space="preserve">
<value>Nhánh gốc của driver</value>
</data>
<data name="Adv_nvapi_driver_chipset" xml:space="preserve">
<value>Hãng và tên chipset, theo driver báo</value>
</data>
<data name="Adv_nvapi_driver_dch" xml:space="preserve">
<value>Driver là gói DCH</value>
</data>
<data name="Adv_nvapi_driver_global_profile" xml:space="preserve">
<value>Mọi thiết lập trong profile toàn cục của driver, chỉ đọc</value>
</data>
<data name="Adv_nvapi_driver_interface_version" xml:space="preserve">
<value>Phiên bản giao diện của chính NVAPI</value>
</data>
<data name="Adv_nvapi_driver_package" xml:space="preserve">
<value>Game Ready, Studio hay một nhánh RTX doanh nghiệp</value>
</data>
<data name="Adv_nvapi_encoder_fps" xml:space="preserve">
<value>Tốc độ mã hoá trung bình của các phiên đang chạy</value>
</data>
<data name="Adv_nvapi_encoder_latency" xml:space="preserve">
<value>Độ trễ mã hoá trung bình</value>
</data>
<data name="Adv_nvapi_encoder_session_processes" xml:space="preserve">
<value>Những chương trình nào đang mã hoá</value>
</data>
<data name="Adv_nvapi_encoder_sessions" xml:space="preserve">
<value>Số phiên mã hoá phần cứng đang chạy, mọi chương trình</value>
</data>
<data name="Adv_nvapi_gpu_architecture" xml:space="preserve">
<value>Kiến trúc chip, bản triển khai và phiên bản</value>
</data>
<data name="Adv_nvapi_gpu_board_serial" xml:space="preserve">
<value>Số sê-ri bo mạch của card</value>
</data>
<data name="Adv_nvapi_gpu_bus_type" xml:space="preserve">
<value>Bus mà card cắm vào</value>
</data>
<data name="Adv_nvapi_gpu_clock_base_core" xml:space="preserve">
<value>Xung nhân cơ sở</value>
</data>
<data name="Adv_nvapi_gpu_clock_base_memory" xml:space="preserve">
<value>Xung bộ nhớ cơ sở</value>
</data>
<data name="Adv_nvapi_gpu_clock_boost_core" xml:space="preserve">
<value>Xung nhân tăng tốc</value>
</data>
<data name="Adv_nvapi_gpu_clock_boost_memory" xml:space="preserve">
<value>Xung bộ nhớ tăng tốc</value>
</data>
<data name="Adv_nvapi_gpu_core_count" xml:space="preserve">
<value>Số nhân đồ hoạ</value>
</data>
<data name="Adv_nvapi_gpu_external" xml:space="preserve">
<value>Card là card gắn ngoài</value>
</data>
<data name="Adv_nvapi_gpu_fan_duty" xml:space="preserve">
<value>Mức điều khiển quạt qua NVAPI (LibreHardwareMonitor đọc số này)</value>
</data>
<data name="Adv_nvapi_gpu_pci_ids" xml:space="preserve">
<value>Mã PCI của thiết bị, hệ con và phiên bản - là model, không phải từng chiếc</value>
</data>
<data name="Adv_nvapi_gpu_power" xml:space="preserve">
<value>Công suất card qua NVAPI (LibreHardwareMonitor đọc số này)</value>
</data>
<data name="Adv_nvapi_gpu_ram_bus_width" xml:space="preserve">
<value>Độ rộng bus bộ nhớ của card</value>
</data>
<data name="Adv_nvapi_gpu_ram_type" xml:space="preserve">
<value>Loại bộ nhớ của card</value>
</data>
<data name="Adv_nvapi_gpu_rt_cores" xml:space="preserve">
<value>Số nhân dò tia</value>
</data>
<data name="Adv_nvapi_gpu_system_type" xml:space="preserve">
<value>Laptop hay máy bàn, theo cách driver nhìn máy</value>
</data>
<data name="Adv_nvapi_gpu_temp_default_max" xml:space="preserve">
<value>Nhiệt độ tối đa mặc định của cảm biến nhân</value>
</data>
<data name="Adv_nvapi_gpu_tensor_cores" xml:space="preserve">
<value>Số nhân tensor</value>
</data>
<data name="Adv_nvapi_gpu_type" xml:space="preserve">
<value>Đồ hoạ tích hợp hay rời</value>
</data>
<data name="Adv_nvapi_gpu_uuid" xml:space="preserve">
<value>Mã định danh duy nhất của card</value>
</data>
<data name="Adv_nvapi_gpu_vbios_version" xml:space="preserve">
<value>Phiên bản Video BIOS</value>
</data>
<data name="Adv_nvapi_gpu_voltage" xml:space="preserve">
<value>Điện áp card qua NVAPI (LibreHardwareMonitor đọc số này)</value>
</data>
<data name="Adv_nvapi_limit_ac_battery" xml:space="preserve">
<value>Bị kìm do chuyển sang pin ở lần đọc: 100 hoặc 0</value>
</data>
<data name="Adv_nvapi_limit_api" xml:space="preserve">
<value>Bị kìm theo yêu cầu của một chương trình ở lần đọc: 100 hoặc 0</value>
</data>
<data name="Adv_nvapi_limit_insufficient_power" xml:space="preserve">
<value>Bị kìm do thiếu đầu cấp nguồn ở lần đọc: 100 hoặc 0</value>
</data>
<data name="Adv_nvapi_load_bus" xml:space="preserve">
<value>Mức dùng giao tiếp bus</value>
</data>
<data name="Adv_nvapi_load_framebuffer" xml:space="preserve">
<value>Mức dùng frame buffer (bộ điều khiển bộ nhớ)</value>
</data>
<data name="Adv_nvapi_load_video" xml:space="preserve">
<value>Mức dùng bộ xử lý video</value>
</data>
<data name="Adv_nvapi_pstate" xml:space="preserve">
<value>Trạng thái hiệu năng hiện tại của card (mã P-state)</value>
</data>
<data name="Adv_nvapi_reflex_frame_report" xml:space="preserve">
<value>Độ trễ từng khung hình: mô phỏng, gửi lệnh dựng hình, present, driver, hàng đợi hệ điều hành, GPU dựng hình</value>
</data>
<data name="Adv_nvapi_reflex_mode" xml:space="preserve">
<value>Reflex: chế độ độ trễ thấp, boost, giới hạn tốc độ khung hình</value>
</data>
<data name="Adv_nvapi_reflex_sleep_status" xml:space="preserve">
<value>Trạng thái độ trễ thấp của driver</value>
</data>
<data name="Adv_nvapi_session_driver_profile" xml:space="preserve">
<value>Các thiết lập mà profile của driver cho game này tự đặt, chỉ đọc</value>
</data>
<data name="Adv_nvapi_session_source_colorspace" xml:space="preserve">
<value>Không gian màu game xuất ra, theo driver báo cho tiến trình</value>
</data>
<data name="Adv_nvapi_session_vrr_display_mode" xml:space="preserve">
<value>Chính màn hình đã ở chế độ tần số quét biến thiên</value>
</data>
<data name="Adv_nvapi_session_vrr_enabled" xml:space="preserve">
<value>Tần số quét biến thiên đã hoạt động trên màn hình của game</value>
</data>
<data name="Adv_nvapi_session_vrr_possible" xml:space="preserve">
<value>Tần số quét biến thiên khả dụng trên màn hình đó</value>
</data>
<data name="Adv_nvapi_session_vrr_requested" xml:space="preserve">
<value>Tần số quét biến thiên đã được yêu cầu cho màn hình đó</value>
</data>
<data name="Adv_nvapi_temp_board" xml:space="preserve">
<value>Nhiệt độ môi trường trên bo của card, nếu card có cảm biến</value>
</data>
<data name="Adv_nvapi_temp_power_supply" xml:space="preserve">
<value>Nhiệt độ khối cấp nguồn của card, nếu card có cảm biến</value>
</data>
<data name="Adv_nvapi_vram_available" xml:space="preserve">
<value>Bộ nhớ video chuyên dụng còn trống lúc này, mọi chương trình</value>
</data>
<data name="Adv_nvapi_vram_dedicated" xml:space="preserve">
<value>Bộ nhớ video chuyên dụng trên card</value>
</data>
<data name="Adv_nvapi_vram_dedicated_available" xml:space="preserve">
<value>Bộ nhớ video chuyên dụng dùng được cho bề mặt</value>
</data>
<data name="Adv_nvapi_vram_eviction_count" xml:space="preserve">
<value>Số lần bị đẩy khỏi bộ nhớ video chuyên dụng, tính từ lúc driver nạp</value>
</data>
<data name="Adv_nvapi_vram_evictions_size" xml:space="preserve">
<value>Bộ nhớ được giải phóng do bị đẩy ra, tính từ lúc driver nạp</value>
</data>
<data name="Adv_nvapi_vram_framebuffer_physical" xml:space="preserve">
<value>Kích thước frame buffer vật lý</value>
</data>
<data name="Adv_nvapi_vram_framebuffer_virtual" xml:space="preserve">
<value>Kích thước frame buffer ảo</value>
</data>
<data name="Adv_nvapi_vram_in_use" xml:space="preserve">
<value>Bộ nhớ video chuyên dụng đang dùng lúc này, mọi chương trình: phần dùng được cho bề mặt trừ phần còn trống</value>
</data>
<data name="Adv_nvapi_vram_promotion_count" xml:space="preserve">
<value>Số lần thăng cấp vào bộ nhớ video chuyên dụng, tính từ lúc driver nạp</value>
</data>
<data name="Adv_nvapi_vram_promotions_size" xml:space="preserve">
<value>Bộ nhớ được đưa vào do thăng cấp, tính từ lúc driver nạp</value>
</data>
<data name="Adv_nvapi_vram_shared" xml:space="preserve">
<value>Bộ nhớ hệ thống dùng chung driver có thể cấp</value>
</data>
<data name="Adv_nvapi_vram_system" xml:space="preserve">
<value>Bộ nhớ hệ thống driver giữ lúc nạp</value>
</data>
<data name="Adv_sl_constants_camera" xml:space="preserve">
<value>Vị trí, các trục và ma trận của camera</value>
</data>
<data name="Adv_sl_constants_depth" xml:space="preserve">
<value>Mặt phẳng gần và xa, và độ sâu có bị đảo hay không</value>
</data>
<data name="Adv_sl_constants_jitter" xml:space="preserve">
<value>Độ lệch jitter game đưa cho Streamline</value>
</data>
<data name="Adv_sl_constants_motion_vectors" xml:space="preserve">
<value>Tỉ lệ vector chuyển động, và chúng có là 3D, giãn nở, có jitter hay không</value>
</data>
<data name="Adv_sl_constants_projection" xml:space="preserve">
<value>Góc nhìn, tỉ lệ khung, phép chiếu trực giao hay không</value>
</data>
<data name="Adv_sl_constants_resets" xml:space="preserve">
<value>Số lần game đặt lại lịch sử của bộ nâng cấp</value>
</data>
<data name="Adv_sl_deepdvc_options" xml:space="preserve">
<value>Các tuỳ chọn của RTX Dynamic Vibrance</value>
</data>
<data name="Adv_sl_dlss_alpha_upscaling" xml:space="preserve">
<value>DLSS nâng cấp cả kênh alpha</value>
</data>
<data name="Adv_sl_dlss_auto_exposure" xml:space="preserve">
<value>Tự động phơi sáng của DLSS</value>
</data>
<data name="Adv_sl_dlss_exposure" xml:space="preserve">
<value>Tiền phơi sáng và hệ số phơi sáng đưa cho DLSS</value>
</data>
<data name="Adv_sl_dlss_hdr_input" xml:space="preserve">
<value>Game báo cho DLSS rằng bộ đệm màu là HDR</value>
</data>
<data name="Adv_sl_dlss_optimal_settings" xml:space="preserve">
<value>Kích thước dựng hình và độ nét DLSS khuyến nghị</value>
</data>
<data name="Adv_sl_dlss_output_size" xml:space="preserve">
<value>Kích thước đầu ra game đưa cho DLSS</value>
</data>
<data name="Adv_sl_dlss_presets" xml:space="preserve">
<value>Preset mô hình DLSS theo từng chế độ chất lượng</value>
</data>
<data name="Adv_sl_dlss_vram_estimate" xml:space="preserve">
<value>Ước tính của chính DLSS về bộ nhớ video nó dùng</value>
</data>
<data name="Adv_sl_dlssd_options" xml:space="preserve">
<value>Các tuỳ chọn của Ray Reconstruction</value>
</data>
<data name="Adv_sl_dlssg_frames_presented" xml:space="preserve">
<value>Số khung tạo khung hình DLSS đã hiển thị, theo bộ đếm của chính nó</value>
</data>
<data name="Adv_sl_dlssg_options" xml:space="preserve">
<value>Tạo khung hình DLSS: chế độ, số khung cần tạo</value>
</data>
<data name="Adv_sl_dlssg_state" xml:space="preserve">
<value>Tạo khung hình DLSS: trạng thái, số khung tối đa có thể tạo</value>
</data>
<data name="Adv_sl_dlssg_vram_estimate" xml:space="preserve">
<value>Ước tính của tạo khung hình DLSS về bộ nhớ video nó dùng</value>
</data>
<data name="Adv_sl_feature_requirements" xml:space="preserve">
<value>Yêu cầu của từng tính năng Streamline: hệ điều hành, driver, bộ đệm</value>
</data>
<data name="Adv_sl_feature_versions" xml:space="preserve">
<value>Phiên bản từng tính năng Streamline và phiên bản mô hình NGX của nó</value>
</data>
<data name="Adv_sl_init_preferences" xml:space="preserve">
<value>Các tuỳ chọn game dùng khi khởi động Streamline</value>
</data>
<data name="Adv_sl_nis_options" xml:space="preserve">
<value>Các tuỳ chọn của NVIDIA Image Scaling</value>
</data>
<data name="Adv_sl_nvperf" xml:space="preserve">
<value>Bộ đếm hiệu năng của Streamline (giấy phép NSight Perf SDK)</value>
</data>
<data name="Adv_sl_pcl_markers" xml:space="preserve">
<value>Các mốc PC-latency game đặt</value>
</data>
<data name="Adv_sl_reflex_state" xml:space="preserve">
<value>Reflex qua Streamline: có khả dụng không và các báo cáo khung hình của nó</value>
</data>
<data name="Adv_xess_options" xml:space="preserve">
<value>Các tuỳ chọn của XeSS</value>
</data>
<data name="Advanced_Chart_Band" xml:space="preserve">
<value>Hơn tám chuỗi: biểu đồ vẽ giá trị thấp nhất, trung bình và cao nhất của chúng. Bảng liệt kê từng chuỗi.</value>
</data>
<data name="Advanced_Chart_Empty" xml:space="preserve">
<value>Chưa có gì để vẽ.</value>
</data>
<data name="Advanced_Chart_Header" xml:space="preserve">
<value>Theo thời gian</value>
</data>
<data name="Advanced_Chart_LiveNote" xml:space="preserve">
<value>Năm phút gần nhất, chỉ giữ trong bộ nhớ.</value>
</data>
<data name="Advanced_Chart_Metric" xml:space="preserve">
<value>Hiển thị</value>
</data>
<data name="Advanced_Chart_Seconds" xml:space="preserve">
<value>Giây tính từ đầu phiên</value>
</data>
<data name="Advanced_Chart_Time" xml:space="preserve">
<value>Thời gian</value>
</data>
<data name="Advanced_Col_Name" xml:space="preserve">
<value>Chỉ số</value>
</data>
<data name="Advanced_Col_ReadAt" xml:space="preserve">
<value>Đọc lúc</value>
</data>
<data name="Advanced_Col_Samples" xml:space="preserve">
<value>Số lần đọc</value>
</data>
<data name="Advanced_Col_Scope" xml:space="preserve">
<value>Thuộc về</value>
</data>
<data name="Advanced_Col_Source" xml:space="preserve">
<value>Nguồn</value>
</data>
<data name="Advanced_Col_Status" xml:space="preserve">
<value>Trạng thái</value>
</data>
<data name="Advanced_Col_Value" xml:space="preserve">
<value>Giá trị</value>
</data>
<data name="Advanced_Elevation_Hint" xml:space="preserve">
<value>Bộ xử lý, bộ nhớ và bo mạch chỉ được đọc khi capture agent chạy quyền quản trị và máy đã cài PawnIO (Cài đặt ▸ Capture agent).</value>
</data>
<data name="Advanced_Facts_Header" xml:space="preserve">
<value>Về máy này</value>
</data>
<data name="Advanced_Header" xml:space="preserve">
<value>Thông số nâng cao</value>
</data>
<data name="Advanced_InGameLine" xml:space="preserve">
<value>Bên trong game: {0}.</value>
</data>
<data name="Advanced_Machine_Intro" xml:space="preserve">
<value>Những gì driver đồ hoạ và các cảm biến phần cứng cho biết về máy này lúc này. Chỉ được đọc khi trang này đang mở hoặc đang ghi một game, và những gì hiện ở đây không được lưu.</value>
</data>
<data name="Advanced_Max" xml:space="preserve">
<value>Cao nhất</value>
</data>
<data name="Advanced_Mean" xml:space="preserve">
<value>Trung bình</value>
</data>
<data name="Advanced_Min" xml:space="preserve">
<value>Thấp nhất</value>
</data>
<data name="Advanced_Now_Header" xml:space="preserve">
<value>Lúc này</value>
</data>
<data name="Advanced_Session_Empty" xml:space="preserve">
<value>Chưa có phiên nào được ghi khi Thông số nâng cao đang bật. Phiên ghi lúc tắt sẽ không được bổ sung về sau.</value>
</data>
<data name="Advanced_Session_Facts" xml:space="preserve">
<value>Máy và phiên</value>
</data>
<data name="Advanced_Session_NoSeries" xml:space="preserve">
<value>Chuỗi theo giây của phiên này không còn được giữ (Cài đặt ▸ Ghi phiên ▸ Số chuỗi thô giữ lại mỗi game); thống kê thì vẫn còn.</value>
</data>
<data name="Advanced_Session_NoStats" xml:space="preserve">
<value>Phiên này không lưu số đo nào.</value>
</data>
<data name="Advanced_Session_Pick" xml:space="preserve">
<value>Phiên</value>
</data>
<data name="Advanced_Session_Stats" xml:space="preserve">
<value>Thống kê của phiên</value>
</data>
<data name="Advanced_Sources_Intro" xml:space="preserve">
<value>Mọi thứ FrameLedger biết cách đọc, và mọi thứ nó không đọc, kèm lý do.</value>
</data>
<data name="Advanced_SourcesLine" xml:space="preserve">
<value>Driver NVIDIA: {0}. Cảm biến card đồ hoạ: {1}. Cảm biến bộ xử lý, bộ nhớ và bo mạch: {2}.</value>
</data>
<data name="Advanced_State_Live" xml:space="preserve">
<value>Capture agent đọc lúc {0}. Số liệu của NVIDIA được đọc mỗi giây, các cảm biến mỗi năm giây.</value>
</data>
<data name="Advanced_State_NoAgent" xml:space="preserve">
<value>Capture agent không trả lời. Những gì hiện bên dưới cũ đúng như thời điểm ghi kèm.</value>
</data>
<data name="Advanced_State_Off" xml:space="preserve">
<value>Thông số nâng cao đang tắt nên không đọc gì cả. Bật ở Cài đặt ▸ Ghi phiên.</value>
</data>
<data name="Advanced_State_OlderAgent" xml:space="preserve">
<value>Capture agent đang chạy là bản cũ hơn và không trả lời được yêu cầu này. Hãy khởi động lại FrameLedger.</value>
</data>
<data name="Advanced_State_Viewer" xml:space="preserve">
<value>Đây là bản sao của một sổ ghi: không đọc gì từ máy này. Các phiên lưu trong bản sao nằm ở thẻ Phiên.</value>
</data>
<data name="Advanced_State_Waiting" xml:space="preserve">
<value>Capture agent đang mở các nguồn đọc…</value>
</data>
<data name="Advanced_Status_InGame" xml:space="preserve">
<value>Được đọc bên trong game mà FrameLedger đo, khi game thực hiện lời gọi đó</value>
</data>
<data name="Advanced_Status_Read" xml:space="preserve">
<value>Đang đọc</value>
</data>
<data name="Advanced_Status_Readable" xml:space="preserve">
<value>Được đọc khi một phiên hoặc trang này yêu cầu</value>
</data>
<data name="Advanced_Status_SourceSilent" xml:space="preserve">
<value>Hiện không đọc được: {0}</value>
</data>
<data name="Advanced_Tab_Machine" xml:space="preserve">
<value>Máy này</value>
</data>
<data name="Advanced_Tab_Session" xml:space="preserve">
<value>Phiên</value>
</data>
<data name="Advanced_Tab_Sources" xml:space="preserve">
<value>Nguồn</value>
</data>
<data name="AdvGroup_Board" xml:space="preserve">
<value>Bo mạch chủ</value>
</data>
<data name="AdvGroup_Cpu" xml:space="preserve">
<value>Bộ xử lý</value>
</data>
<data name="AdvGroup_Display" xml:space="preserve">
<value>Màn hình</value>
</data>
<data name="AdvGroup_Driver" xml:space="preserve">
<value>Driver đồ hoạ</value>
</data>
<data name="AdvGroup_FrameGeneration" xml:space="preserve">
<value>Tạo khung hình</value>
</data>
<data name="AdvGroup_Gpu" xml:space="preserve">
<value>Card đồ hoạ</value>
</data>
<data name="AdvGroup_GpuMemory" xml:space="preserve">
<value>Bộ nhớ card đồ hoạ</value>
</data>
<data name="AdvGroup_Latency" xml:space="preserve">
<value>Độ trễ</value>
</data>
<data name="AdvGroup_Memory" xml:space="preserve">
<value>Bộ nhớ</value>
</data>
<data name="AdvGroup_Storage" xml:space="preserve">
<value>Lưu trữ</value>
</data>
<data name="AdvGroup_Upscaling" xml:space="preserve">
<value>Nâng cấp hình ảnh</value>
</data>
<data name="AdvInGame_NotHooked" xml:space="preserve">
<value>phiên này không được đo bên trong game</value>
</data>
<data name="AdvInGame_NothingSeen" xml:space="preserve">
<value>game không thực hiện lời gọi nào để đọc các mục này</value>
</data>
<data name="AdvInGame_Reading" xml:space="preserve">
<value>đã đọc từ chính các lời gọi của game</value>
</data>
<data name="AdvInGame_Unknown" xml:space="preserve">
<value>không rõ</value>
</data>
<data name="AdvReach_Deferred" xml:space="preserve">
<value>Không đọc trong bản phát hành này</value>
</data>
<data name="AdvReach_Game" xml:space="preserve">
<value>Bên trong game mà FrameLedger đo</value>
</data>
<data name="AdvReach_HookedCall" xml:space="preserve">
<value>Bên trong game - sẽ có ở bản phát hành sau</value>
</data>
<data name="AdvReach_Identifier" xml:space="preserve">
<value>Không bao giờ đọc: nó định danh máy này, một màn hình hoặc chương trình khác</value>
</data>
<data name="AdvReach_Licence" xml:space="preserve">
<value>Không đọc: giấy phép của hãng không cho phép</value>
</data>
<data name="AdvReach_NewHook" xml:space="preserve">
<value>Bên trong game, cần hook mới - sẽ có ở bản phát hành sau</value>
</data>
<data name="AdvReach_NotInHeaders" xml:space="preserve">
<value>Giao diện này không cung cấp</value>
</data>
<data name="AdvReach_PlayerState" xml:space="preserve">
<value>Không bao giờ đọc: đó là trạng thái của người chơi trong game</value>
</data>
<data name="AdvReach_Refused" xml:space="preserve">
<value>Không đọc: việc này khiến thư viện cảm biến dò mọi thiết bị USB</value>
</data>
<data name="AdvReach_Spike" xml:space="preserve">
<value>Đang nghiên cứu; chưa quyết định</value>
</data>
<data name="AdvScope_MachineFact" xml:space="preserve">
<value>Máy này</value>
</data>
<data name="AdvScope_Series" xml:space="preserve">
<value>Một phiên, theo thời gian</value>
</data>
<data name="AdvScope_SessionFact" xml:space="preserve">
<value>Một phiên</value>
</data>
<data name="AdvSource_Faulted" xml:space="preserve">
<value>gặp lỗi khi đọc</value>
</data>
<data name="AdvSource_NotElevated" xml:space="preserve">
<value>capture agent không chạy quyền quản trị</value>
</data>
<data name="AdvSource_NotPresent" xml:space="preserve">
<value>không có trên máy này</value>
</data>
<data name="AdvSource_PawnIoMissing" xml:space="preserve">
<value>chưa cài PawnIO</value>
</data>
<data name="AdvSource_Reading" xml:space="preserve">
<value>đang trả lời</value>
</data>
<data name="AdvSource_Unknown" xml:space="preserve">
<value>chưa được hỏi</value>
</data>
<data name="AdvToken_adaptive_sync" xml:space="preserve">
<value>Adaptive sync</value>
</data>
<data name="AdvToken_agp" xml:space="preserve">
<value>AGP</value>
</data>
<data name="AdvToken_axi" xml:space="preserve">
<value>AXI</value>
</data>
<data name="AdvToken_bt2100_pq" xml:space="preserve">
<value>BT.2100 PQ (HDR10)</value>
</data>
<data name="AdvToken_desktop" xml:space="preserve">
<value>Máy bàn</value>
</data>
<data name="AdvToken_discrete" xml:space="preserve">
<value>Rời</value>
</data>
<data name="AdvToken_dolby_vision" xml:space="preserve">
<value>Dolby Vision</value>
</data>
<data name="AdvToken_driver_default" xml:space="preserve">
<value>Mặc định của driver</value>
</data>
<data name="AdvToken_draw_debug_view" xml:space="preserve">
<value>Chế độ xem gỡ lỗi</value>
</data>
<data name="AdvToken_edr" xml:space="preserve">
<value>EDR</value>
</data>
<data name="AdvToken_fpci" xml:space="preserve">
<value>FPCI</value>
</data>
<data name="AdvToken_game_ready" xml:space="preserve">
<value>Game Ready</value>
</data>
<data name="AdvToken_gsync_module" xml:space="preserve">
<value>Mô-đun G-SYNC</value>
</data>
<data name="AdvToken_hdr10" xml:space="preserve">
<value>HDR10</value>
</data>
<data name="AdvToken_hdr10_plus" xml:space="preserve">
<value>HDR10+</value>
</data>
<data name="AdvToken_hdr10_plus_gaming" xml:space="preserve">
<value>HDR10+ Gaming</value>
</data>
<data name="AdvToken_integrated" xml:space="preserve">
<value>Tích hợp</value>
</data>
<data name="AdvToken_laptop" xml:space="preserve">
<value>Laptop</value>
</data>
<data name="AdvToken_no_profile_for_game" xml:space="preserve">
<value>Driver không có profile cho game này</value>
</data>
<data name="AdvToken_non_linear_color_pq" xml:space="preserve">
<value>Màu phi tuyến, PQ</value>
</data>
<data name="AdvToken_non_linear_color_srgb" xml:space="preserve">
<value>Màu phi tuyến, sRGB</value>
</data>
<data name="AdvToken_none" xml:space="preserve">
<value>Không có</value>
</data>
<data name="AdvToken_not_a_number" xml:space="preserve">
<value>Không phải số</value>
</data>
<data name="AdvToken_not_supported" xml:space="preserve">
<value>Không hỗ trợ</value>
</data>
<data name="AdvToken_off" xml:space="preserve">
<value>Tắt</value>
</data>
<data name="AdvToken_on" xml:space="preserve">
<value>Bật</value>
</data>
<data name="AdvToken_on_and_off" xml:space="preserve">
<value>Lúc bật, lúc tắt</value>
</data>
<data name="AdvToken_pci" xml:space="preserve">
<value>PCI</value>
</data>
<data name="AdvToken_pci_express" xml:space="preserve">
<value>PCI Express</value>
</data>
<data name="AdvToken_rtx_new_feature" xml:space="preserve">
<value>Nhánh RTX tính năng mới</value>
</data>
<data name="AdvToken_rtx_production" xml:space="preserve">
<value>Nhánh RTX production</value>
</data>
<data name="AdvToken_scrgb_linear" xml:space="preserve">
<value>scRGB (tuyến tính)</value>
</data>
<data name="AdvToken_srgb" xml:space="preserve">
<value>sRGB</value>
</data>
<data name="AdvToken_studio" xml:space="preserve">
<value>Studio</value>
</data>
<data name="AdvToken_ulmb" xml:space="preserve">
<value>ULMB</value>
</data>
<data name="AdvToken_usable_now" xml:space="preserve">
<value>Dùng được ở chế độ hiện tại</value>
</data>
<data name="AdvToken_user_set" xml:space="preserve">
<value>Do người dùng đặt</value>
</data>
<data name="AdvToken_variable_refresh" xml:space="preserve">
<value>Tần số quét biến thiên</value>
</data>
<data name="Agent_Banner_Missing_Body" xml:space="preserve">
<value>Không tìm thấy FrameLedger.Agent.exe cạnh ứng dụng. Vẫn đọc được các phiên chơi; trạng thái trực tiếp và điều khiển thu thập thì không.</value>
</data>
@@ -1048,9 +277,6 @@
<data name="Menu_Tools_VulkanLayer" xml:space="preserve">
<value>Đăng ký Vulkan layer…</value>
</data>
<data name="Nav_Advanced" xml:space="preserve">
<value>Nâng cao</value>
</data>
<data name="Nav_Compare" xml:space="preserve">
<value>So sánh</value>
</data>
@@ -1078,12 +304,6 @@
<data name="Rules_Update_Failed" xml:space="preserve">
<value>Agent không phản hồi yêu cầu cập nhật quy tắc.</value>
</data>
<data name="Settings_Advanced_Body" xml:space="preserve">
<value>Đọc thêm từ driver đồ hoạ và các cảm biến phần cứng trong lúc ghi phiên - bộ nhớ và tải của card đồ hoạ ở mức chi tiết, từng quạt và điện áp, khả năng của màn hình, thiết lập của driver cho game - và, với game mà FrameLedger đo từ bên trong, những gì game đưa cho DLSS và FSR (kích thước, preset, làm nét, phơi sáng - không bao giờ là vị trí camera). Tất cả được lưu cùng phiên. Tắt: không đọc và không lưu thêm gì, kể cả bên trong game. Áp dụng từ phiên kế tiếp; phiên đã ghi lúc tắt sẽ không được bổ sung về sau.</value>
</data>
<data name="Settings_Advanced_Label" xml:space="preserve">
<value>Thông số nâng cao</value>
</data>
<data name="Settings_Appearance_Header" xml:space="preserve">
<value>Giao diện</value>
</data>
@@ -1729,9 +949,6 @@
<data name="Sessions_Col_Tier" xml:space="preserve">
<value>Tier</value>
</data>
<data name="Summary_Advanced_Button" xml:space="preserve">
<value>Thông số nâng cao…</value>
</data>
<data name="Tier_Dash_Tooltip" xml:space="preserve">
<value>—: đã đo là không có frame generation, nên không có FPS hiển thị khác với FPS gốc</value>
</data>
@@ -2270,7 +1487,7 @@
<value>Đang chạy với quyền quản trị.</value>
</data>
<data name="Settings_Agent_Elevation_Body" xml:space="preserve">
<value>Không tier nào cần quyền quản trị. Nó chỉ tuỳ chọn mở khoá nhiệt độ CPU và, khi bật Thông số nâng cao, cảm biến của bộ xử lý, bộ nhớ và bo mạch (đều qua PawnIO), cùng việc gắn vào game tự chạy với quyền quản trị. Mọi thứ khác — hook, đo, ghi — đều chạy không cần.</value>
<value>Không tier nào cần quyền quản trị. Nó chỉ tuỳ chọn mở khoá nhiệt độ CPU (qua PawnIO) và gắn vào game tự chạy với quyền quản trị. Mọi thứ khác — hook, đo, ghi — đều chạy không cần.</value>
</data>
<data name="Settings_Agent_Elevation_Label" xml:space="preserve">
<value>Quyền quản trị</value>
@@ -2537,7 +1754,7 @@
<value>Chấp nhận</value>
</data>
<data name="FirstRun_Agent_Body" xml:space="preserve">
<value>FrameLedger khởi động một capture agent nhỏ bên cạnh nó, với quyền người dùng thường — không nâng quyền. Nâng quyền là tuỳ chọn và không tier thu thập nào yêu cầu: nó chỉ mở khoá nhiệt độ CPU và, khi bật Thông số nâng cao, cảm biến của bộ xử lý, bộ nhớ và bo mạch (đều qua PawnIO), cùng việc gắn vào game tự chạy với quyền quản trị. Bên dưới là những gì agent báo cáo về máy này.</value>
<value>FrameLedger khởi động một capture agent nhỏ bên cạnh nó, với quyền người dùng thường — không nâng quyền. Nâng quyền là tuỳ chọn và không tier thu thập nào yêu cầu: nó chỉ mở khoá nhiệt độ CPU (qua PawnIO) và gắn vào game tự chạy với quyền quản trị. Bên dưới là những gì agent báo cáo về máy này.</value>
</data>
<data name="FirstRun_Agent_Header" xml:space="preserve">
<value>Capture agent</value>
@@ -1,13 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.App.ViewModels;
/// <summary>One row under a table-valued fact of the Advanced page: a driver setting, a memory module.</summary>
/// <param name="Name">What the row is, in the words it was stored with.</param>
/// <param name="Value">Its value, a token of it in this language.</param>
public sealed record AdvancedDetailRow(string Name, string Value)
{
/// <summary>What a screen reader says for the row: its name and its value.</summary>
public override string ToString() => Name + ": " + Value;
}
@@ -1,13 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.App.ViewModels;
/// <summary>The facts of one group of the catalog - the graphics card, the displays - under its heading.</summary>
/// <param name="Title">The group in this language.</param>
/// <param name="Rows">Its facts, in the catalog's order.</param>
public sealed record AdvancedFactGroup(string Title, IReadOnlyList<AdvancedFactRow> Rows)
{
/// <summary>What a screen reader says for the group: its title.</summary>
public override string ToString() => Title;
}
@@ -1,17 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.App.ViewModels;
/// <summary>One fact of the Advanced page: what it is, its value in one line, and the rows of a table-valued one.</summary>
/// <param name="Label">The catalog entry in this language, with the display or device it is about.</param>
/// <param name="Value">The value in its unit; for a table, how many rows it has.</param>
/// <param name="Details">The rows of a table-valued fact; empty for every other.</param>
public sealed record AdvancedFactRow(string Label, string Value, IReadOnlyList<AdvancedDetailRow> Details)
{
/// <summary>Whether there are rows to unfold.</summary>
public bool HasDetails => Details.Count > 0;
/// <summary>What a screen reader says for the row: its label and its value.</summary>
public override string ToString() => Label + ": " + Value;
}
@@ -1,145 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using System.Globalization;
using FrameLedger.Application.Advanced;
namespace FrameLedger.App.ViewModels;
/// <summary>
/// The words of the Advanced page (owner decision D101): a catalog entry's label, a group's, a token's, a source's
/// state — each a key of <c>Strings.resx</c> made from the thing's own name — and a value in its unit.
/// </summary>
/// <remarks>
/// A key that is not there reads as the thing's own name, never as nothing: a ledger written by a newer build can
/// hold a token this build has no word for, and the page shows what was stored.
/// </remarks>
public static class AdvancedLabels
{
/// <summary>A catalog entry's label; its English summary where no string names it.</summary>
public static string Of(AdvancedMetric metric)
{
ArgumentNullException.ThrowIfNull(metric);
return Lookup(metric.LabelKey) ?? metric.Summary;
}
/// <summary>A member of a family: the family's label and what the hardware calls the member.</summary>
public static string Member(string family, string? member) => string.IsNullOrWhiteSpace(member) ? family : family + " — " + member;
public static string Group(AdvancedGroup group) => Lookup("AdvGroup_" + group) ?? group.ToString();
public static string Scope(AdvancedScope scope) => Lookup("AdvScope_" + scope) ?? scope.ToString();
/// <summary>A source's name. These are the vendors' own names and are the same in every language.</summary>
public static string Source(AdvancedSource source) => source switch
{
AdvancedSource.Nvapi => "NVAPI",
AdvancedSource.Lhm => "LibreHardwareMonitor",
AdvancedSource.Streamline => "Streamline",
AdvancedSource.FidelityFx => "FidelityFX",
AdvancedSource.Ngx => "NGX",
AdvancedSource.Xess => "XeSS",
_ => source.ToString(),
};
/// <summary>Why an entry that is not read is not.</summary>
public static string Reach(AdvancedReach reach) => Lookup("AdvReach_" + reach) ?? reach.ToString();
public static string Status(AdvancedSourceStatus status) => Lookup("AdvSource_" + status) ?? status.ToString();
/// <summary>What became, in one session, of the entries read inside the game (0.1.0-beta.40).</summary>
public static string InGame(AdvancedInGameStatus status) => Lookup("AdvInGame_" + status) ?? status.ToString();
/// <summary>A token the driver's answer was mapped to; the token itself where this build has no word for it.</summary>
public static string Token(string token) => Lookup("AdvToken_" + token) ?? token;
/// <summary>A number in its unit. A flag is yes or no; a count has no unit.</summary>
public static string Number(double value, AdvancedUnit unit)
{
CultureInfo c = CultureInfo.CurrentCulture;
return unit switch
{
AdvancedUnit.Flag => value != 0 ? Strings.Common_Yes : Strings.Common_No,
AdvancedUnit.Celsius => value.ToString("0.#", c) + " °C",
AdvancedUnit.Percent => value.ToString("0.#", c) + " %",
AdvancedUnit.Megahertz => value.ToString("0.#", c) + " MHz",
AdvancedUnit.Mebibytes => value.ToString("N0", c) + " MiB",
AdvancedUnit.Watts => value.ToString("0.#", c) + " W",
AdvancedUnit.Volts => value.ToString("0.###", c) + " V",
AdvancedUnit.Amperes => value.ToString("0.##", c) + " A",
AdvancedUnit.Rpm => value.ToString("N0", c) + " RPM",
AdvancedUnit.Microseconds => value.ToString("N0", c) + " µs",
AdvancedUnit.Milliseconds => value.ToString("0.##", c) + " ms",
AdvancedUnit.Nits => value.ToString("0.####", c) + " cd/m²",
AdvancedUnit.FramesPerSecond => value.ToString("0.#", c) + " FPS",
AdvancedUnit.BytesPerSecond => Rate(value, c),
AdvancedUnit.Bits => value.ToString("N0", c) + " bit",
_ => value.ToString("0.###", c),
};
}
/// <summary>The unit's symbol for a chart's axis; empty where the value has none.</summary>
public static string Unit(AdvancedUnit unit) => unit switch
{
AdvancedUnit.Celsius => "°C",
AdvancedUnit.Percent => "%",
AdvancedUnit.Megahertz => "MHz",
AdvancedUnit.Mebibytes => "MiB",
AdvancedUnit.Watts => "W",
AdvancedUnit.Volts => "V",
AdvancedUnit.Amperes => "A",
AdvancedUnit.Rpm => "RPM",
AdvancedUnit.Microseconds => "µs",
AdvancedUnit.Milliseconds => "ms",
AdvancedUnit.Nits => "cd/m²",
AdvancedUnit.FramesPerSecond => "FPS",
AdvancedUnit.BytesPerSecond => "B/s",
AdvancedUnit.Bits => "bit",
_ => string.Empty,
};
/// <summary>
/// A fact's value in one line: a number in its unit, a text as it is, tokens in this language. A table has no one
/// line — its rows are shown under it — so it reads as how many rows it has.
/// </summary>
public static string Value(AdvancedValue value, AdvancedUnit unit)
{
ArgumentNullException.ThrowIfNull(value);
if (value.Number is double number)
{
return Number(number, unit);
}
if (value.Tokens is { } tokens)
{
return tokens.Count == 0 ? Strings.Common_NotAvailable : string.Join(", ", tokens.Select(Token));
}
if (value.Rows is { } rows)
{
return rows.Count.ToString(CultureInfo.CurrentCulture);
}
return string.IsNullOrEmpty(value.Text) ? Strings.Common_NotAvailable : value.Text;
}
/// <summary>One row of a table-valued fact: its token in this language where it has one, else what was stored.</summary>
public static string RowValue(AdvancedRow row)
{
ArgumentNullException.ThrowIfNull(row);
return row.Token is { Length: > 0 } token ? Token(token) : row.Value;
}
private static string Rate(double bytesPerSecond, CultureInfo c) => Math.Abs(bytesPerSecond) switch
{
>= 1024 * 1024 => (bytesPerSecond / (1024 * 1024)).ToString("0.#", c) + " MiB/s",
>= 1024 => (bytesPerSecond / 1024).ToString("0.#", c) + " KiB/s",
_ => bytesPerSecond.ToString("0", c) + " B/s",
};
private static string? Lookup(string key)
{
string? found = Strings.ResourceManager.GetString(key, Strings.Culture);
return string.IsNullOrEmpty(found) ? null : found;
}
}
@@ -1,14 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.App.ViewModels;
/// <summary>One series as it reads now: its label, its last value in its unit, and when that value was read.</summary>
/// <param name="Label">The catalog entry in this language, with the hardware's name for a member of a family.</param>
/// <param name="Value">The last value read.</param>
/// <param name="ReadAt">The time it was read at - a sensor read every fifth second is as old as this says.</param>
public sealed record AdvancedLiveRow(string Label, string Value, string ReadAt)
{
/// <summary>What a screen reader says for the row: its label and its value.</summary>
public override string ToString() => Label + ": " + Value;
}
@@ -1,10 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.App.ViewModels;
/// <summary>A catalog entry the chart can draw, in the selector: its id and its label in this language.</summary>
public sealed record AdvancedMetricOption(string Id, string Label)
{
public override string ToString() => Label;
}
@@ -1,250 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using System.Globalization;
using FrameLedger.App.Charts;
using FrameLedger.App.Services;
using FrameLedger.Application.Advanced;
using FrameLedger.Application.Recording;
namespace FrameLedger.App.ViewModels;
/// <summary>
/// Turns what the Agent read — or a session stored — into what the Advanced page shows (owner decision D101): facts
/// under their groups, series under their labels, and every catalog entry with whether it is read or why not. Pure:
/// no I/O, no state, so every rule here has a test.
/// </summary>
[System.Diagnostics.CodeAnalysis.SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format strings are resources that follow the UI culture, which changes at runtime")]
public static class AdvancedPresenter
{
/// <summary>Above this many members a family is drawn as its lowest, average and highest — more lines than that cannot be told apart.</summary>
public const int MaxLines = 8;
private static readonly Dictionary<string, int> _order = AdvancedMetricCatalog.All
.Select(static (m, i) => (m.Id, i))
.ToDictionary(static p => p.Id, static p => p.i, StringComparer.Ordinal);
/// <summary>
/// The facts under their groups, in the catalog's order. A fact whose id this build does not know — stored by a
/// newer one — is shown under its own id, last, rather than dropped.
/// </summary>
public static IReadOnlyList<AdvancedFactGroup> Groups(IReadOnlyList<AdvancedFact> facts)
{
ArgumentNullException.ThrowIfNull(facts);
var groups = new SortedDictionary<int, (string Title, List<(int Order, string Instance, AdvancedFactRow Row)> Rows)>();
foreach (AdvancedFact fact in facts)
{
AdvancedMetric? metric = AdvancedMetricCatalog.Find(fact.Id);
int group = metric is null ? int.MaxValue : (int)metric.Group;
if (!groups.TryGetValue(group, out (string Title, List<(int, string, AdvancedFactRow)> Rows) bucket))
{
bucket = (metric is null ? Strings.Common_NotAvailable : AdvancedLabels.Group(metric.Group), []);
groups[group] = bucket;
}
string label = AdvancedLabels.Member(metric is null ? fact.Id : AdvancedLabels.Of(metric), fact.Instance);
AdvancedDetailRow[] details = [.. (fact.Value.Rows ?? []).Select(static r => new AdvancedDetailRow(r.Name, AdvancedLabels.RowValue(r)))];
var row = new AdvancedFactRow(label, AdvancedLabels.Value(fact.Value, metric?.Unit ?? AdvancedUnit.None), details);
bucket.Rows.Add((OrderOf(fact.Id), fact.Instance ?? string.Empty, row));
}
return [.. groups.Values.Select(static g => new AdvancedFactGroup(
g.Title,
[.. g.Rows.OrderBy(static r => r.Order).ThenBy(static r => r.Instance, StringComparer.Ordinal).Select(static r => r.Row)]))];
}
/// <summary>
/// The catalog entry a series belongs to and its label: the family's with the hardware's own name for a member, as
/// the directory gives it; the entry's for a series that is one. A series nothing names keeps its own name.
/// </summary>
public static (AdvancedMetric? Metric, string Label) Resolve(string series, IReadOnlyList<AdvancedSeriesInfo> directory)
{
ArgumentNullException.ThrowIfNull(series);
ArgumentNullException.ThrowIfNull(directory);
foreach (AdvancedSeriesInfo info in directory)
{
if (string.Equals(info.Series, series, StringComparison.Ordinal) && AdvancedMetricCatalog.Find(info.MetricId) is { } family)
{
return (family, AdvancedLabels.Member(AdvancedLabels.Of(family), info.Label));
}
}
if (!series.StartsWith(AdvancedMetric.SeriesPrefix, StringComparison.Ordinal))
{
return (null, series);
}
string id = series[AdvancedMetric.SeriesPrefix.Length..];
if (AdvancedMetricCatalog.Find(id) is { } exact)
{
return (exact, AdvancedLabels.Of(exact));
}
// A member whose directory entry is gone: the family is the longest id the name starts with.
AdvancedMetric? owner = null;
foreach (AdvancedMetric metric in AdvancedMetricCatalog.All)
{
if (metric.IsFamily && id.StartsWith(metric.Id + ".", StringComparison.Ordinal) && (owner is null || metric.Id.Length > owner.Id.Length))
{
owner = metric;
}
}
return owner is null ? (null, series) : (owner, AdvancedLabels.Member(AdvancedLabels.Of(owner), id[(owner.Id.Length + 1)..]));
}
/// <summary>Every series as it reads now, in the catalog's order: its value in its unit and the time it was read at.</summary>
public static IReadOnlyList<AdvancedLiveRow> Live(AdvancedMachineView view)
{
ArgumentNullException.ThrowIfNull(view);
return [.. view.Values
.Select(pair => (pair.Key, Resolved: Resolve(pair.Key, view.Series), Point: pair.Value))
.OrderBy(static r => r.Resolved.Metric is null ? int.MaxValue : OrderOf(r.Resolved.Metric.Id))
.ThenBy(static r => r.Resolved.Label, StringComparer.CurrentCulture)
.Select(static r => new AdvancedLiveRow(
r.Resolved.Label,
AdvancedLabels.Number(r.Point.Value, r.Resolved.Metric?.Unit ?? AdvancedUnit.None),
r.Point.At.ToLocalTime().ToString("T", CultureInfo.CurrentCulture)))];
}
/// <summary>The catalog entries that have at least one of these series, in the catalog's order — what the chart's selector offers.</summary>
public static IReadOnlyList<AdvancedMetricOption> Metrics(IEnumerable<string> series, IReadOnlyList<AdvancedSeriesInfo> directory)
{
ArgumentNullException.ThrowIfNull(series);
return [.. series
.Select(s => Resolve(s, directory).Metric)
.OfType<AdvancedMetric>()
.DistinctBy(static m => m.Id, StringComparer.Ordinal)
.OrderBy(static m => OrderOf(m.Id))
.Select(static m => new AdvancedMetricOption(m.Id, AdvancedLabels.Of(m)))];
}
/// <summary>
/// The lines of one catalog entry: one per series of it — or, above <see cref="MaxLines"/>, the lowest, the
/// average and the highest across them at each moment, which is what can still be read off a chart.
/// </summary>
/// <returns>The lines, and whether they are that band.</returns>
public static (IReadOnlyList<AdvancedChartLine> Lines, bool Band) Lines(string metricId, IEnumerable<SensorSeries> series, IReadOnlyList<AdvancedSeriesInfo> directory)
{
ArgumentNullException.ThrowIfNull(metricId);
ArgumentNullException.ThrowIfNull(series);
var members = new List<AdvancedChartLine>();
foreach (SensorSeries one in series)
{
(AdvancedMetric? metric, string label) = Resolve(one.Name, directory);
if (metric is not null && string.Equals(metric.Id, metricId, StringComparison.Ordinal) && one.Values.Length > 0)
{
members.Add(new AdvancedChartLine(label, one.TimesS, one.Values));
}
}
members.Sort(static (a, b) => StringComparer.CurrentCulture.Compare(a.Label, b.Label));
return members.Count <= MaxLines ? (members, false) : (Band(members), true);
}
/// <summary>The statistics a session stored, one row a series, in the catalog's order.</summary>
public static IReadOnlyList<AdvancedStatRow> Stats(IReadOnlyDictionary<string, SensorSeriesStats> stats, IReadOnlyList<AdvancedSeriesInfo> directory)
{
ArgumentNullException.ThrowIfNull(stats);
return [.. stats
.Select(pair => (Resolved: Resolve(pair.Key, directory), pair.Value))
.OrderBy(static r => r.Resolved.Metric is null ? int.MaxValue : OrderOf(r.Resolved.Metric.Id))
.ThenBy(static r => r.Resolved.Label, StringComparer.CurrentCulture)
.Select(static r =>
{
AdvancedUnit unit = r.Resolved.Metric?.Unit ?? AdvancedUnit.None;
return new AdvancedStatRow(
r.Resolved.Label,
r.Value.N.ToString("N0", CultureInfo.CurrentCulture),
NumberOrNone(r.Value.Min, unit),
NumberOrNone(r.Value.Mean, unit),
NumberOrNone(r.Value.Max, unit));
})];
}
/// <summary>
/// Every entry of the catalog with whether it is read, or why it is not. <paramref name="now"/> is the sources'
/// state where it is known — the page is live — and null where it is not: then an entry the Agent reads says
/// when it is read rather than claiming that it is being read.
/// </summary>
public static IReadOnlyList<AdvancedSourceRow> Sources(AdvancedSources? now) =>
[.. AdvancedMetricCatalog.All.Select(m => new AdvancedSourceRow(
AdvancedLabels.Of(m),
AdvancedLabels.Scope(m.Scope),
AdvancedLabels.Source(m.Source),
StatusOf(m, now),
m.IsRead))];
/// <summary>The three sources' states in one sentence.</summary>
public static string SourcesLine(AdvancedSources sources)
{
ArgumentNullException.ThrowIfNull(sources);
string line = string.Format(
CultureInfo.CurrentCulture,
Strings.Advanced_SourcesLine,
AdvancedLabels.Status(sources.Nvapi),
AdvancedLabels.Status(sources.Sensors),
AdvancedLabels.Status(sources.ElevatedSensors));
// A session's row also says what became of the entries read inside the game; the machine's live state and a
// row stored before 0.1.0-beta.40 do not, and then the sentence is not there.
return sources.InGame is { } inGame
? line + " " + string.Format(CultureInfo.CurrentCulture, Strings.Advanced_InGameLine, AdvancedLabels.InGame(inGame))
: line;
}
private static string StatusOf(AdvancedMetric metric, AdvancedSources? now)
{
if (!metric.IsRead)
{
return AdvancedLabels.Reach(metric.Reach);
}
if (metric.Reach == AdvancedReach.Game)
{
// Not a state of the PC: it is read inside a game being measured, when that game makes the call.
return Strings.Advanced_Status_InGame;
}
AdvancedSourceStatus? state = now is null ? null : (metric.Source, metric.Reach) switch
{
(AdvancedSource.Nvapi, _) => now.Nvapi,
(AdvancedSource.Lhm, AdvancedReach.AgentElevated) => now.ElevatedSensors,
(AdvancedSource.Lhm, _) => now.Sensors,
_ => null,
};
return state switch
{
AdvancedSourceStatus.Reading => Strings.Advanced_Status_Read,
null or AdvancedSourceStatus.Unknown => Strings.Advanced_Status_Readable,
_ => string.Format(CultureInfo.CurrentCulture, Strings.Advanced_Status_SourceSilent, AdvancedLabels.Status(state.Value)),
};
}
private static List<AdvancedChartLine> Band(List<AdvancedChartLine> members)
{
var at = new SortedDictionary<double, (double Min, double Max, double Sum, int N)>();
foreach (AdvancedChartLine line in members)
{
for (int i = 0; i < line.Xs.Length && i < line.Ys.Length; i++)
{
double y = line.Ys[i];
at[line.Xs[i]] = at.TryGetValue(line.Xs[i], out (double Min, double Max, double Sum, int N) seen)
? (Math.Min(seen.Min, y), Math.Max(seen.Max, y), seen.Sum + y, seen.N + 1)
: (y, y, y, 1);
}
}
double[] xs = [.. at.Keys];
return
[
new AdvancedChartLine(Strings.Advanced_Min, xs, [.. at.Values.Select(static v => v.Min)]),
new AdvancedChartLine(Strings.Advanced_Mean, xs, [.. at.Values.Select(static v => v.Sum / v.N)]),
new AdvancedChartLine(Strings.Advanced_Max, xs, [.. at.Values.Select(static v => v.Max)]),
];
}
private static string NumberOrNone(double? value, AdvancedUnit unit) => value is double v ? AdvancedLabels.Number(v, unit) : Strings.Common_NotAvailable;
private static int OrderOf(string id) => _order.GetValueOrDefault(id, int.MaxValue);
}
@@ -1,10 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.App.ViewModels;
/// <summary>A session recorded with Advanced metrics on, in the selector: its id, and its game and start in words.</summary>
public sealed record AdvancedSessionOption(long SessionId, string Text)
{
public override string ToString() => Text;
}
@@ -1,16 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.App.ViewModels;
/// <summary>One entry of the catalog on the Sources tab: what it is, what it belongs to, where it comes from, and whether it is read - or why not.</summary>
/// <param name="Label">The entry in this language.</param>
/// <param name="Scope">This PC, a session, or a session over time.</param>
/// <param name="Source">The interface it comes from.</param>
/// <param name="Status">Read, or the reason it is not - in words, never by colour alone.</param>
/// <param name="IsRead">Whether the Agent reads it at all.</param>
public sealed record AdvancedSourceRow(string Label, string Scope, string Source, string Status, bool IsRead)
{
/// <summary>What a screen reader says for the row: its label and whether it is read, or why not.</summary>
public override string ToString() => Label + ": " + Status;
}
@@ -1,11 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.App.ViewModels;
/// <summary>One stored series of a session in numbers: how many readings, and their lowest, average and highest.</summary>
public sealed record AdvancedStatRow(string Label, string Samples, string Min, string Mean, string Max)
{
/// <summary>What a screen reader says for the row: its label and its average.</summary>
public override string ToString() => Label + ": " + Mean;
}
@@ -1,419 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using System.Globalization;
using CommunityToolkit.Mvvm.ComponentModel;
using FrameLedger.App.Charts;
using FrameLedger.App.Services;
using FrameLedger.Application.Advanced;
using FrameLedger.Application.Persistence;
using FrameLedger.Application.Recording;
namespace FrameLedger.App.ViewModels;
/// <summary>
/// The Advanced page (owner decision D101; <c>08_UI</c> §Advanced): what the vendor interfaces make available, each
/// value under what it belongs to. <b>This PC</b> is what the Agent reads now — asked only while the page is on screen
/// (D107), never stored; <b>Session</b> is what a session recorded with the option on stored; <b>Sources</b> is every
/// entry of the catalog with whether it is read, or why it is not.
/// </summary>
/// <remarks>
/// Nothing here reads hardware: the Agent does, and a session's numbers come from the ledger. In a viewer there is no
/// Agent, so This PC says so and the page opens on Session.
/// </remarks>
[System.Diagnostics.CodeAnalysis.SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format strings are resources that follow the UI culture, which changes at runtime")]
public sealed partial class AdvancedViewModel : ObservableObject
{
/// <summary>How many of the newest sessions recorded with the option on the selector offers.</summary>
public const int SessionsOffered = 50;
private const int _sessionTab = 1;
private readonly AdvancedMachineFeed _feed;
private readonly ISessionRepository _sessions;
private readonly IGameRepository _games;
private readonly SessionSeriesLoader _loader;
private readonly AdvancedSelection _selection;
private readonly UiMode _mode;
private readonly UiThread _ui = new();
private IDisposable? _watch;
private bool _attached;
private IReadOnlyList<AdvancedFact>? _shownFacts;
private AdvancedSources? _shownSources;
private bool _sourcesShown;
private bool _settingSession;
private IReadOnlyList<SensorSeries> _sessionSeries = [];
private IReadOnlyList<AdvancedSeriesInfo> _sessionDirectory = [];
[ObservableProperty]
private int _selectedTab;
[ObservableProperty]
private string _machineStatus = string.Empty;
[ObservableProperty]
private IReadOnlyList<AdvancedFactGroup> _machineGroups = [];
[ObservableProperty]
private IReadOnlyList<AdvancedLiveRow> _liveRows = [];
[ObservableProperty]
private IReadOnlyList<AdvancedMetricOption> _liveMetrics = [];
[ObservableProperty]
private AdvancedMetricOption? _selectedLiveMetric;
[ObservableProperty]
private bool _liveBand;
[ObservableProperty]
private bool _liveChartEmpty = true;
[ObservableProperty]
private bool _showElevationHint;
[ObservableProperty]
private IReadOnlyList<AdvancedSessionOption> _sessionOptions = [];
[ObservableProperty]
private AdvancedSessionOption? _selectedSession;
[ObservableProperty]
private bool _noSessions;
[ObservableProperty]
private string? _sessionSources;
[ObservableProperty]
private IReadOnlyList<AdvancedFactGroup> _sessionGroups = [];
[ObservableProperty]
private IReadOnlyList<AdvancedStatRow> _sessionStats = [];
[ObservableProperty]
private bool _sessionHasNoStats;
[ObservableProperty]
private bool _sessionSeriesGone;
[ObservableProperty]
private IReadOnlyList<AdvancedMetricOption> _sessionMetrics = [];
[ObservableProperty]
private AdvancedMetricOption? _selectedSessionMetric;
[ObservableProperty]
private bool _sessionBand;
[ObservableProperty]
private bool _sessionChartEmpty = true;
[ObservableProperty]
private IReadOnlyList<AdvancedSourceRow> _sourceRows = [];
[ObservableProperty]
private string? _sourcesNow;
public AdvancedViewModel(AdvancedMachineFeed feed, ISessionRepository sessions, IGameRepository games, SessionSeriesLoader loader, AdvancedSelection selection, UiMode? mode = null)
{
_feed = feed ?? throw new ArgumentNullException(nameof(feed));
_sessions = sessions ?? throw new ArgumentNullException(nameof(sessions));
_games = games ?? throw new ArgumentNullException(nameof(games));
_loader = loader ?? throw new ArgumentNullException(nameof(loader));
_selection = selection ?? throw new ArgumentNullException(nameof(selection));
_mode = mode ?? UiMode.Profile;
if (_mode.IsViewer)
{
// A copy is opened to look at its sessions; there is no Agent to say anything about this PC.
_selectedTab = _sessionTab;
_machineStatus = Strings.Advanced_State_Viewer;
}
ShowSources(sources: null);
Pending = LoadSessionsAsync();
}
public static string Header => Strings.Advanced_Header;
public static string TabMachine => Strings.Advanced_Tab_Machine;
public static string TabSession => Strings.Advanced_Tab_Session;
public static string TabSources => Strings.Advanced_Tab_Sources;
/// <summary>The load in flight — the sessions' list, or the selected session — for a test to await.</summary>
public Task Pending { get; private set; }
/// <summary>The lines of the live chart, as last presented.</summary>
public IReadOnlyList<AdvancedChartLine> LiveLines { get; private set; } = [];
/// <summary>The unit the live chart's values are in.</summary>
public string LiveUnit { get; private set; } = string.Empty;
/// <summary>The lines of the session's chart, as last presented.</summary>
public IReadOnlyList<AdvancedChartLine> SessionLines { get; private set; } = [];
/// <summary>The unit the session chart's values are in.</summary>
public string SessionUnit { get; private set; } = string.Empty;
/// <summary>The live chart's lines changed: the page draws them.</summary>
public event EventHandler? LivePresented;
/// <summary>The session chart's lines changed: the page draws them.</summary>
public event EventHandler? SessionPresented;
/// <summary>The page is on screen: start asking the Agent (D107 — only while it is), and show what is known.</summary>
public void Attach()
{
if (_attached)
{
return;
}
_attached = true;
_selection.Requested += OnSessionRequested;
TakeRequestedSession();
if (_mode.IsViewer)
{
return;
}
_feed.Changed += OnFeedChanged;
_watch = _feed.Watch();
ShowMachine(_feed.Current);
}
/// <summary>The page left the screen: stop asking, so the Agent lets its reader go.</summary>
public void Detach()
{
if (!_attached)
{
return;
}
_attached = false;
_selection.Requested -= OnSessionRequested;
_feed.Changed -= OnFeedChanged;
_watch?.Dispose();
_watch = null;
}
/// <summary>What the feed last learnt, shown. Public for a test, which has no feed loop to raise it.</summary>
public void ShowMachine(AdvancedMachineView view)
{
ArgumentNullException.ThrowIfNull(view);
MachineStatus = view.State switch
{
AdvancedFeedState.Live when view.TakenAt is DateTimeOffset at =>
string.Format(CultureInfo.CurrentCulture, Strings.Advanced_State_Live, at.ToLocalTime().ToString("T", CultureInfo.CurrentCulture)),
AdvancedFeedState.Off => Strings.Advanced_State_Off,
AdvancedFeedState.NoAgent => Strings.Advanced_State_NoAgent,
AdvancedFeedState.OlderAgent => Strings.Advanced_State_OlderAgent,
_ => Strings.Advanced_State_Waiting,
};
if (!ReferenceEquals(view.Facts, _shownFacts))
{
_shownFacts = view.Facts;
MachineGroups = AdvancedPresenter.Groups(view.Facts);
}
LiveRows = AdvancedPresenter.Live(view);
IReadOnlyList<AdvancedMetricOption> metrics = AdvancedPresenter.Metrics(view.Values.Keys, view.Series);
if (!metrics.SequenceEqual(LiveMetrics))
{
string? keep = SelectedLiveMetric?.Id;
LiveMetrics = metrics;
SelectedLiveMetric = metrics.FirstOrDefault(m => string.Equals(m.Id, keep, StringComparison.Ordinal)) ?? (metrics.Count > 0 ? metrics[0] : null);
}
ShowElevationHint = view.Sources.ElevatedSensors is AdvancedSourceStatus.NotElevated or AdvancedSourceStatus.PawnIoMissing;
ShowSources(view.State == AdvancedFeedState.Live ? view.Sources : null);
PresentLive(view);
}
partial void OnSelectedLiveMetricChanged(AdvancedMetricOption? value) => PresentLive(_feed.Current);
partial void OnSelectedSessionChanged(AdvancedSessionOption? value)
{
if (!_settingSession)
{
Pending = LoadSessionAsync(value?.SessionId);
}
}
partial void OnSelectedSessionMetricChanged(AdvancedMetricOption? value) => PresentSession();
private void OnSessionRequested(object? sender, EventArgs e) => _ui.Post(TakeRequestedSession);
/// <summary>A session's summary asked for it: the list is read again - it may be a session finished since - and that one shown.</summary>
private void TakeRequestedSession()
{
if (_attached && _selection.Take() is long asked)
{
Pending = LoadSessionsAsync(asked);
}
}
private void OnFeedChanged(object? sender, EventArgs e) => _ui.Post(() =>
{
if (_attached)
{
ShowMachine(_feed.Current);
}
});
private void ShowSources(AdvancedSources? sources)
{
if (_sourcesShown && Equals(sources, _shownSources))
{
return;
}
_sourcesShown = true;
_shownSources = sources;
SourceRows = AdvancedPresenter.Sources(sources);
SourcesNow = sources is null ? null : AdvancedPresenter.SourcesLine(sources);
}
private void PresentLive(AdvancedMachineView view)
{
IReadOnlyList<AdvancedChartLine> lines = [];
bool band = false;
string unit = string.Empty;
if (SelectedLiveMetric is { } metric)
{
unit = AdvancedLabels.Unit(AdvancedMetricCatalog.Find(metric.Id)?.Unit ?? AdvancedUnit.None);
var series = new List<SensorSeries>();
foreach (string name in view.Values.Keys)
{
if (string.Equals(AdvancedPresenter.Resolve(name, view.Series).Metric?.Id, metric.Id, StringComparison.Ordinal))
{
IReadOnlyList<AdvancedLivePoint> points = _feed.HistoryOf(name);
series.Add(new SensorSeries(name, [.. points.Select(static p => p.At.LocalDateTime.ToOADate())], [.. points.Select(static p => p.Value)]));
}
}
(lines, band) = AdvancedPresenter.Lines(metric.Id, series, view.Series);
}
LiveLines = lines;
LiveUnit = unit;
LiveBand = band;
LiveChartEmpty = lines.Count == 0;
LivePresented?.Invoke(this, EventArgs.Empty);
}
private void PresentSession()
{
IReadOnlyList<AdvancedChartLine> lines = [];
bool band = false;
string unit = string.Empty;
if (SelectedSessionMetric is { } metric)
{
unit = AdvancedLabels.Unit(AdvancedMetricCatalog.Find(metric.Id)?.Unit ?? AdvancedUnit.None);
(lines, band) = AdvancedPresenter.Lines(metric.Id, _sessionSeries, _sessionDirectory);
}
SessionLines = lines;
SessionUnit = unit;
SessionBand = band;
SessionChartEmpty = lines.Count == 0;
SessionPresented?.Invoke(this, EventArgs.Empty);
}
private async Task LoadSessionsAsync(long? asked = null)
{
IReadOnlyList<SessionRow> rows = await _sessions.ListAdvancedAsync(SessionsOffered).ConfigureAwait(true);
var options = new List<AdvancedSessionOption>(rows.Count + 1);
var names = new Dictionary<long, string>();
foreach (SessionRow row in rows)
{
options.Add(await OptionOfAsync(row, names).ConfigureAwait(true));
}
if (asked is long id && !options.Exists(o => o.SessionId == id)
&& await _sessions.FindAdvancedAsync(id).ConfigureAwait(true) is not null
&& await _sessions.FindByIdAsync(id).ConfigureAwait(true) is { } older)
{
// Asked for from its summary, and older than the newest fifty: it is offered all the same.
options.Add(await OptionOfAsync(older, names).ConfigureAwait(true));
}
long? keep = asked ?? SelectedSession?.SessionId;
SessionOptions = options;
NoSessions = options.Count == 0;
AdvancedSessionOption? next = options.Find(o => o.SessionId == keep) ?? (options.Count > 0 ? options[0] : null);
if (asked is not null && next?.SessionId == asked)
{
SelectedTab = _sessionTab;
}
// The selection is set without its own load, and the load is awaited here: one read of the session, in this task.
_settingSession = true;
SelectedSession = next;
_settingSession = false;
await LoadSessionAsync(next?.SessionId).ConfigureAwait(true);
}
private async Task<AdvancedSessionOption> OptionOfAsync(SessionRow row, Dictionary<long, string> names)
{
if (!names.TryGetValue(row.GameId, out string? name))
{
name = (await _games.FindByIdAsync(row.GameId).ConfigureAwait(true))?.Name ?? Strings.Common_NotAvailable;
names[row.GameId] = name;
}
return new AdvancedSessionOption(row.Id, name + " — " + Formats.Date(row.StartedAt));
}
private async Task LoadSessionAsync(long? sessionId)
{
AdvancedSessionRow? row = sessionId is long id ? await _sessions.FindAdvancedAsync(id).ConfigureAwait(true) : null;
IReadOnlyList<SensorSeries> series = sessionId is long loaded && row is not null ? await _loader.LoadAdvancedAsync(loaded).ConfigureAwait(true) : [];
if (SelectedSession?.SessionId != sessionId)
{
return; // another session was chosen while this one was read
}
if (row is null)
{
_sessionSeries = [];
_sessionDirectory = [];
SessionSources = null;
SessionGroups = [];
SessionStats = [];
SessionHasNoStats = false;
SessionSeriesGone = false;
SessionMetrics = [];
SelectedSessionMetric = null;
PresentSession();
return;
}
(IReadOnlyList<AdvancedFact> sessionFacts, AdvancedSources sources) = AdvancedJson.ParseSession(row.FactsJson);
(IReadOnlyList<AdvancedSeriesInfo> directory, _) = AdvancedJson.ParseSeries(row.SeriesJson);
IReadOnlyDictionary<string, SensorSeriesStats> stats = AdvancedJson.ParseStats(row.StatsJson);
_sessionSeries = series;
_sessionDirectory = directory;
SessionSources = AdvancedPresenter.SourcesLine(sources);
SessionGroups = AdvancedPresenter.Groups([.. AdvancedJson.ParseFacts(row.MachineFactsJson), .. sessionFacts]);
SessionStats = AdvancedPresenter.Stats(stats, directory);
SessionHasNoStats = stats.Count == 0;
SessionSeriesGone = stats.Count > 0 && !series.Any(static s => s.Values.Length > 0);
string? keep = SelectedSessionMetric?.Id;
IReadOnlyList<AdvancedMetricOption> metrics = AdvancedPresenter.Metrics(series.Where(static s => s.Values.Length > 0).Select(static s => s.Name), directory);
SessionMetrics = metrics;
AdvancedMetricOption? next = metrics.FirstOrDefault(m => string.Equals(m.Id, keep, StringComparison.Ordinal)) ?? (metrics.Count > 0 ? metrics[0] : null);
if (Equals(next, SelectedSessionMetric))
{
PresentSession();
}
else
{
SelectedSessionMetric = next;
}
}
}
@@ -26,10 +26,6 @@ namespace FrameLedger.App.ViewModels;
[SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format strings are resources that follow the UI culture, which changes at runtime")]
public sealed partial class SessionSummaryViewModel : ObservableObject
{
/// <summary>Whether this session stored advanced metrics — it was recorded with the option on (owner decision D101).</summary>
[ObservableProperty]
private bool _hasAdvanced;
private readonly ISessionRepository _sessions;
private readonly IGameRepository _games;
private readonly ISessionAnnotationRepository _annotations;
@@ -252,14 +248,6 @@ public sealed partial class SessionSummaryViewModel : ObservableObject
public static string ExportPngText => Strings.Summary_Export_Png;
public static string AdvancedText => Strings.Summary_Advanced_Button;
/// <summary>
/// Opens this session on the Advanced page (owner decision D101); set by whoever opened the window. Null — a test, a
/// host with no shell — and the button does nothing.
/// </summary>
public Action<long>? ShowAdvanced { get; set; }
public SessionRow? Row { get; private set; }
public GameRow? Game { get; private set; }
@@ -296,8 +284,6 @@ public sealed partial class SessionSummaryViewModel : ObservableObject
}
NotFound = false;
// Recorded with Advanced metrics on: the row is there, and the button that leads to it is shown (D101).
HasAdvanced = await _sessions.FindAdvancedAsync(sessionId, ct).ConfigureAwait(true) is not null;
_annotation = await _annotations.FindAsync(sessionId, ct).ConfigureAwait(true);
_segments = await _sessions.FindSegmentsAsync(sessionId, ct).ConfigureAwait(true);
_snapshot = await _hardware.FindAsync(Row.SnapshotId, ct).ConfigureAwait(true);
@@ -312,15 +298,6 @@ public sealed partial class SessionSummaryViewModel : ObservableObject
[RelayCommand]
private Task SaveAnnotationAsync() => Run(SaveAnnotationCoreAsync);
[RelayCommand]
private void OpenAdvanced()
{
if (Row is { } row)
{
ShowAdvanced?.Invoke(row.Id);
}
}
[RelayCommand]
private Task ExportCsvAsync() => Run(() => ExportAsync("csv", "CSV|*.csv", WriteCsv));
@@ -80,13 +80,6 @@ public sealed partial class SettingsViewModel : ObservableObject
[ObservableProperty]
private bool _removeUninstalledGames;
/// <summary>
/// "Advanced metrics" (owner decision D101, <c>telemetry.advanced</c>, off by default): the Agent reads more from the
/// graphics driver and the sensors during a session and stores it; off, nothing more is read or stored.
/// </summary>
[ObservableProperty]
private bool _advancedMetrics;
[ObservableProperty]
private int _minSessionSeconds;
@@ -432,17 +425,6 @@ public sealed partial class SettingsViewModel : ObservableObject
partial void OnRemoveUninstalledGamesChanged(bool value) => Persist(SettingsRegistry.RetentionRemoveUninstalledGames, value);
partial void OnAdvancedMetricsChanged(bool value)
{
if (!_loading)
{
// The page's navigation item and Ctrl+6 follow the switch at once (D105); what is read follows at the next session.
AdvancedOption.IsOn = value;
}
Persist(SettingsRegistry.TelemetryAdvanced, value);
}
partial void OnHideAntiCheatHookingChanged(bool value) => Persist(SettingsRegistry.UiHideAntiCheatHooking, value);
/// <summary>D33: the option is one settings row the Agent reads at every session start and command; the list follows it.</summary>
@@ -598,7 +580,6 @@ public sealed partial class SettingsViewModel : ObservableObject
TelemetryIntervalMs = await _settings.GetIntegerAsync(SettingsRegistry.TelemetryIntervalMs).ConfigureAwait(true);
RetentionRawSessions = await _settings.GetIntegerAsync(SettingsRegistry.RetentionRawSessionsPerGame).ConfigureAwait(true);
RemoveUninstalledGames = await _settings.GetBooleanAsync(SettingsRegistry.RetentionRemoveUninstalledGames).ConfigureAwait(true);
AdvancedMetrics = await _settings.GetBooleanAsync(SettingsRegistry.TelemetryAdvanced).ConfigureAwait(true);
MinimizeToTray = await _settings.GetBooleanAsync(SettingsRegistry.UiMinimizeToTray).ConfigureAwait(true);
HideAntiCheatHooking = await _settings.GetBooleanAsync(SettingsRegistry.UiHideAntiCheatHooking).ConfigureAwait(true);
UserModeExceptions = await _settings.GetBooleanAsync(SettingsRegistry.HookingUserModeExceptions).ConfigureAwait(true);
@@ -242,9 +242,6 @@
<ui:Button Margin="8,0,0,0" Command="{Binding ViewModel.ExportJsonCommand}" Content="{x:Static vm:SessionSummaryViewModel.ExportJsonText}" />
<ui:Button Margin="8,0,0,0" Click="OnExportPng" Content="{x:Static vm:SessionSummaryViewModel.ExportPngText}"
IsEnabled="{Binding ViewModel.IsHooked}" />
<!-- Advanced metrics (D101): only for a session recorded with the option on; it opens that session on the page. -->
<ui:Button Margin="8,0,0,0" Command="{Binding ViewModel.OpenAdvancedCommand}" Content="{x:Static vm:SessionSummaryViewModel.AdvancedText}"
Visibility="{Binding ViewModel.HasAdvanced, Converter={StaticResource BoolToVis}}" />
</StackPanel>
</StackPanel>
</ScrollViewer>
@@ -1,16 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.Application.Advanced;
/// <summary>An <see cref="AdvancedSessionData"/> as the <c>.partial</c> carries it, so a session that is recovered keeps its facts.</summary>
internal sealed record AdvancedContextDocument
{
public List<AdvancedFactDocument> Machine { get; init; } = [];
public List<AdvancedFactDocument> Session { get; init; } = [];
public List<AdvancedSeriesInfoDocument> Series { get; init; } = [];
public AdvancedSources? Sources { get; init; }
}
@@ -1,16 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.Application.Advanced;
/// <summary>
/// One fact that was read: the catalog entry it is the value of, which member of a family it is, and the value.
/// </summary>
/// <param name="Id">An <see cref="AdvancedMetric.Id"/> whose scope is a fact.</param>
/// <param name="Instance">
/// For a family — a set of facts per display — which one: <c>1</c>, <c>2</c>… in the order the source listed them.
/// An ordinal on purpose: the source's own handle for a display changes from boot to boot and identifies nothing
/// worth storing (D104). Null for an entry that is one value.
/// </param>
/// <param name="Value">The value.</param>
public sealed record AdvancedFact(string Id, string? Instance, AdvancedValue Value);
@@ -1,20 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.Application.Advanced;
/// <summary>One <see cref="AdvancedFact"/> as it is stored: its id, which member of a family, and its value in whichever one shape it has.</summary>
internal sealed record AdvancedFactDocument
{
public string Id { get; init; } = string.Empty;
public string? Instance { get; init; }
public double? Number { get; init; }
public string? Text { get; init; }
public List<string>? Tokens { get; init; }
public List<AdvancedRowDocument>? Rows { get; init; }
}
@@ -1,23 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.Application.Advanced;
/// <summary>The heading an advanced metric is shown under.</summary>
public enum AdvancedGroup
{
/// <summary>Not stated. No entry of the catalog carries it.</summary>
None = 0,
Gpu = 1,
GpuMemory = 2,
Driver = 3,
Display = 4,
Cpu = 5,
Board = 6,
Memory = 7,
Storage = 8,
Upscaling = 9,
FrameGeneration = 10,
Latency = 11,
}
@@ -1,27 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.Application.Advanced;
/// <summary>
/// What became of the entries read inside the game (<see cref="AdvancedReach.Game"/>) in one session — the third
/// answer beside a value and "not read": why there is none (Advanced metrics train B, owner decision D111).
/// </summary>
public enum AdvancedInGameStatus
{
/// <summary>Not stated: a row stored before 0.1.0-beta.40, or a state nobody set.</summary>
Unknown = 0,
/// <summary>The game made at least one of the calls these entries are read from, and what it passed was read.</summary>
Reading = 1,
/// <summary>
/// The session was measured inside the game and the game made none of those calls where they can be seen — it
/// uses neither upscaler through the interfaces FrameLedger intercepts, or it sets its options through a call
/// that cannot be intercepted (<c>slDLSSSetOptions</c>). Not "the game uses none of it".
/// </summary>
NothingSeen = 2,
/// <summary>The session was not measured inside the game (Tier 2): there was no call to read.</summary>
NotHooked = 3,
}
@@ -1,200 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using System.Text.Json;
using FrameLedger.Application.Recording;
namespace FrameLedger.Application.Advanced;
/// <summary>
/// The one JSON form of what "Advanced metrics" stores and carries (owner decision D102): the facts of a PC, the facts
/// of a session, the directory of its series, and — in a <c>.partial</c> — all of it together.
/// </summary>
/// <remarks>
/// <para>
/// <b>Writing is strict and reading is tolerant</b>, like every JSON column here: what is written is exactly what the
/// types hold; what is read back and does not fit — a ledger edited by hand, a value in two shapes, a word that is not
/// a token — is left out, never thrown, and never guessed at.
/// </para>
/// <para>
/// <b>Only what the catalog says is read is written</b> (<see cref="Storable"/>). The readers have no way to produce
/// an identifier (D104); this is the same rule held once more at the door of the ledger, where a mistake would last.
/// </para>
/// </remarks>
public static class AdvancedJson
{
/// <summary>
/// The facts a ledger may hold: those whose id is a catalog entry this build reads. A fact of an entry that is an
/// identifier, the player's state, or simply unknown is not among them.
/// </summary>
public static IReadOnlyList<AdvancedFact> Storable(IReadOnlyList<AdvancedFact> facts)
{
ArgumentNullException.ThrowIfNull(facts);
return [.. facts.Where(static f => AdvancedMetricCatalog.Find(f.Id) is { IsRead: true })];
}
public static string OfFacts(IReadOnlyList<AdvancedFact> facts)
=> JsonSerializer.Serialize(Documents(facts), AdvancedJsonContext.Default.ListAdvancedFactDocument);
public static IReadOnlyList<AdvancedFact> ParseFacts(string? json)
=> Read(json, AdvancedJsonContext.Default.ListAdvancedFactDocument) is { } documents ? Facts(documents) : [];
public static string OfSession(IReadOnlyList<AdvancedFact> facts, AdvancedSources sources)
{
ArgumentNullException.ThrowIfNull(sources);
return JsonSerializer.Serialize(new AdvancedSessionDocument { Facts = Documents(facts), Sources = sources }, AdvancedJsonContext.Default.AdvancedSessionDocument);
}
public static (IReadOnlyList<AdvancedFact> Facts, AdvancedSources Sources) ParseSession(string? json)
=> Read(json, AdvancedJsonContext.Default.AdvancedSessionDocument) is { } document
? (Facts(document.Facts), document.Sources ?? AdvancedSources.Unknown)
: ([], AdvancedSources.Unknown);
public static string OfSeries(IReadOnlyList<AdvancedSeriesInfo> series, int dropped)
{
ArgumentNullException.ThrowIfNull(series);
ArgumentOutOfRangeException.ThrowIfNegative(dropped);
return JsonSerializer.Serialize(new AdvancedSeriesDocument { Series = SeriesDocuments(series), Dropped = dropped }, AdvancedJsonContext.Default.AdvancedSeriesDocument);
}
public static (IReadOnlyList<AdvancedSeriesInfo> Series, int Dropped) ParseSeries(string? json)
=> Read(json, AdvancedJsonContext.Default.AdvancedSeriesDocument) is { } document
? (Series(document.Series), Math.Max(0, document.Dropped))
: ([], 0);
public static string OfStats(IReadOnlyDictionary<string, SensorSeriesStats> stats)
{
ArgumentNullException.ThrowIfNull(stats);
return JsonSerializer.Serialize(new Dictionary<string, SensorSeriesStats>(stats, StringComparer.Ordinal), AdvancedJsonContext.Default.DictionaryStringSensorSeriesStats);
}
public static IReadOnlyDictionary<string, SensorSeriesStats> ParseStats(string? json)
=> Read(json, AdvancedJsonContext.Default.DictionaryStringSensorSeriesStats) ?? new Dictionary<string, SensorSeriesStats>(StringComparer.Ordinal);
/// <summary>A session's whole advanced context, for the <c>.partial</c>.</summary>
public static string OfContext(AdvancedSessionData data)
{
ArgumentNullException.ThrowIfNull(data);
return JsonSerializer.Serialize(
new AdvancedContextDocument
{
Machine = Documents(data.MachineFacts),
Session = Documents(data.SessionFacts),
Series = SeriesDocuments(data.Series),
Sources = data.Sources,
},
AdvancedJsonContext.Default.AdvancedContextDocument);
}
/// <summary>The context a <c>.partial</c> carried, or null when it carried none that reads.</summary>
public static AdvancedSessionData? ParseContext(string? json)
=> Read(json, AdvancedJsonContext.Default.AdvancedContextDocument) is { } document
? new AdvancedSessionData(Facts(document.Machine), Facts(document.Session), Series(document.Series), document.Sources ?? AdvancedSources.Unknown)
: null;
private static T? Read<T>(string? json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<T> type)
where T : class
{
if (string.IsNullOrWhiteSpace(json))
{
return null;
}
try
{
return JsonSerializer.Deserialize(json, type);
}
catch (JsonException)
{
return null;
}
}
private static List<AdvancedFactDocument> Documents(IReadOnlyList<AdvancedFact> facts)
{
ArgumentNullException.ThrowIfNull(facts);
return
[
.. facts.Select(static f => new AdvancedFactDocument
{
Id = f.Id,
Instance = f.Instance,
Number = f.Value.Number,
Text = f.Value.Text,
Tokens = f.Value.Tokens is { } tokens ? [.. tokens] : null,
Rows = f.Value.Rows is { } rows ? [.. rows.Select(static r => new AdvancedRowDocument { Name = r.Name, Value = r.Value, Token = r.Token })] : null,
}),
];
}
private static List<AdvancedFact> Facts(List<AdvancedFactDocument>? documents)
{
var facts = new List<AdvancedFact>(documents?.Count ?? 0);
foreach (AdvancedFactDocument d in documents ?? [])
{
if (!string.IsNullOrWhiteSpace(d?.Id) && ValueOf(d) is { } value)
{
facts.Add(new AdvancedFact(d.Id, string.IsNullOrWhiteSpace(d.Instance) ? null : d.Instance, value));
}
}
return facts;
}
/// <summary>The value of a stored fact when it has exactly one shape and that shape is well formed; null otherwise.</summary>
private static AdvancedValue? ValueOf(AdvancedFactDocument d)
{
int shapes = (d.Number is null ? 0 : 1) + (d.Text is null ? 0 : 1) + (d.Tokens is null ? 0 : 1) + (d.Rows is null ? 0 : 1);
if (shapes != 1)
{
return null;
}
if (d.Number is { } number)
{
return double.IsFinite(number) ? AdvancedValue.Of(number) : null;
}
if (d.Text is { } text)
{
return string.IsNullOrWhiteSpace(text) ? null : AdvancedValue.OfText(text);
}
if (d.Tokens is { } tokens)
{
return tokens.TrueForAll(static t => AdvancedValue.IsToken(t)) ? AdvancedValue.OfTokens(tokens) : null;
}
// A row with no name or no value is not a row: the whole fact is left out rather than shown with a hole in it.
var rows = new List<AdvancedRow>(d.Rows!.Count);
foreach (AdvancedRowDocument? r in d.Rows)
{
if (r?.Name is not { } name || r.Value is not { } value)
{
return null;
}
rows.Add(new AdvancedRow(name, value, r.Token));
}
return AdvancedValue.OfRows(rows);
}
private static List<AdvancedSeriesInfoDocument> SeriesDocuments(IReadOnlyList<AdvancedSeriesInfo> series)
=> [.. series.Select(static s => new AdvancedSeriesInfoDocument { Series = s.Series, MetricId = s.MetricId, Label = s.Label })];
/// <summary>The directory lines that are whole and name an advanced series; any other is left out.</summary>
private static List<AdvancedSeriesInfo> Series(List<AdvancedSeriesInfoDocument>? documents)
{
var series = new List<AdvancedSeriesInfo>(documents?.Count ?? 0);
foreach (AdvancedSeriesInfoDocument? d in documents ?? [])
{
if (d?.Series is { } name && d.MetricId is { } metric && d.Label is { } label && name.StartsWith(AdvancedMetric.SeriesPrefix, StringComparison.Ordinal))
{
series.Add(new AdvancedSeriesInfo(name, metric, label));
}
}
return series;
}
}
@@ -1,22 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using System.Text.Json.Serialization;
using FrameLedger.Application.Recording;
namespace FrameLedger.Application.Advanced;
/// <summary>Source-generated JSON for what "Advanced metrics" stores (D102); no reflection. Names are camel case, nulls are left out, and a status is its name.</summary>
[JsonSourceGenerationOptions(
WriteIndented = false,
PropertyNamingPolicy = JsonKnownNamingPolicy.CamelCase,
DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull,
UseStringEnumConverter = true)]
[JsonSerializable(typeof(List<AdvancedFactDocument>))]
[JsonSerializable(typeof(AdvancedSessionDocument))]
[JsonSerializable(typeof(AdvancedSeriesDocument))]
[JsonSerializable(typeof(AdvancedContextDocument))]
[JsonSerializable(typeof(Dictionary<string, SensorSeriesStats>))]
internal sealed partial class AdvancedJsonContext : JsonSerializerContext
{
}
@@ -1,47 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.Application.Advanced;
/// <summary>
/// One row of <see cref="AdvancedMetricCatalog"/>: a number, a fact or a family of sensors that a vendor interface
/// makes available, with the scope it belongs to and where it can be read from.
/// </summary>
/// <param name="Id">Lower case, dotted, starting with the source's prefix. It is on disk once a release stores it, and then never changes.</param>
/// <param name="Scope">The machine or one session.</param>
/// <param name="Source">The vendor interface.</param>
/// <param name="Reach">Where it can be read from, or why it is not read.</param>
/// <param name="Unit">What its value is.</param>
/// <param name="Group">The heading it is shown under.</param>
/// <param name="Summary">
/// What it is, in English, for <c>docs/18_GPU_VENDOR_APIS.md</c> §The inventory — the table there is held to this
/// text by a test. The App shows the translated string under <see cref="LabelKey"/>, never this.
/// </param>
public sealed record AdvancedMetric(
string Id,
AdvancedScope Scope,
AdvancedSource Source,
AdvancedReach Reach,
AdvancedUnit Unit,
AdvancedGroup Group,
string Summary)
{
/// <summary>The prefix of every advanced series in <c>sensor_blobs</c> (D102): a reader tells them from the fixed series by it.</summary>
public const string SeriesPrefix = "adv.";
/// <summary>
/// True when the entry is not one value but as many as the hardware has — a temperature per core, a fan per
/// header, a set of facts per display. Each instance is named by <see cref="AdvancedMetricCatalog.InstanceName"/>
/// and labelled by what the hardware calls it.
/// </summary>
public bool IsFamily { get; init; }
/// <summary>True when a build with the option on reads it: every other reach is a reason it reads N/A.</summary>
public bool IsRead => Reach is AdvancedReach.Agent or AdvancedReach.AgentElevated or AdvancedReach.Game;
/// <summary>The name of its series in <c>sensor_blobs</c> — for a family, the stem of its instances' names; null when it is not a series.</summary>
public string? SeriesName => Scope == AdvancedScope.Series ? SeriesPrefix + Id : null;
/// <summary>The key of its translated label in the App's resources.</summary>
public string LabelKey => "Adv_" + Id.Replace('.', '_');
}
@@ -1,267 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
using System.Collections.Frozen;
using static FrameLedger.Application.Advanced.AdvancedGroup;
using static FrameLedger.Application.Advanced.AdvancedReach;
using static FrameLedger.Application.Advanced.AdvancedSource;
using static FrameLedger.Application.Advanced.AdvancedUnit;
namespace FrameLedger.Application.Advanced;
/// <summary>
/// Everything "Advanced metrics" (owner decision D101) knows of: what the vendored NVAPI and Streamline headers, the
/// FidelityFX headers and LibreHardwareMonitor make available — what is read, and what is not with the reason.
/// </summary>
/// <remarks>
/// ONE LIST FOR EVERY CONSUMER. Before it, a metric's name, unit and label were repeated in three to five places
/// (the trend's enum, its unit switch, its label list, Compare's rows, the summary's cards). The reader that
/// collects, the recorder that stores, the page that shows and the table in
/// <c>docs/18_GPU_VENDOR_APIS.md</c> §The inventory all read this list, and a test holds that table to it — so an
/// entry cannot be stored without being shown, or documented as read while it is not.
/// <para>
/// AN ENTRY THAT IS NOT READ IS STILL AN ENTRY. The owner asked for everything the headers give; what stays out
/// stays out for a reason — a hook that is not built, a route nobody has proven safe, a licence, an identifier,
/// the player's own state — and the page's Sources tab says which.
/// </para>
/// </remarks>
public static class AdvancedMetricCatalog
{
/// <summary>
/// The entries, in the order the page lists them. An id is on disk from the first release that stores it and
/// never changes after; an entry is added at the end of its block.
/// </summary>
public static IReadOnlyList<AdvancedMetric> All { get; } =
[
// ---- NVAPI, the graphics card: facts -------------------------------------------------------------------
Machine("nvapi.gpu.type", Nvapi, Agent, Text, Gpu, "Integrated or discrete graphics"),
Machine("nvapi.gpu.system_type", Nvapi, Agent, Text, Gpu, "Laptop or desktop, as the driver sees the PC"),
Machine("nvapi.gpu.external", Nvapi, Agent, Flag, Gpu, "The card is an external one"),
Machine("nvapi.gpu.bus_type", Nvapi, Agent, Text, Gpu, "The bus the card sits on"),
Machine("nvapi.gpu.pci_ids", Nvapi, Agent, Text, Gpu, "PCI device, subsystem and revision ids - the model, not the unit"),
Machine("nvapi.gpu.vbios_version", Nvapi, Agent, Text, Gpu, "Video BIOS version"),
Machine("nvapi.gpu.architecture", Nvapi, Agent, Text, Gpu, "Chip architecture, implementation and revision"),
Machine("nvapi.gpu.core_count", Nvapi, Agent, Count, Gpu, "Graphics cores"),
Machine("nvapi.gpu.rt_cores", Nvapi, Agent, Count, Gpu, "Ray-tracing cores"),
Machine("nvapi.gpu.tensor_cores", Nvapi, Agent, Count, Gpu, "Tensor cores"),
Machine("nvapi.gpu.ram_bus_width", Nvapi, Agent, Bits, Gpu, "Width of the card's memory bus"),
Machine("nvapi.gpu.clock_base_core", Nvapi, Agent, Megahertz, Gpu, "Base core clock"),
Machine("nvapi.gpu.clock_base_memory", Nvapi, Agent, Megahertz, Gpu, "Base memory clock"),
Machine("nvapi.gpu.clock_boost_core", Nvapi, Agent, Megahertz, Gpu, "Boost core clock"),
Machine("nvapi.gpu.clock_boost_memory", Nvapi, Agent, Megahertz, Gpu, "Boost memory clock"),
Machine("nvapi.gpu.temp_default_max", Nvapi, Agent, Celsius, Gpu, "The core sensor's default maximum temperature"),
// ---- NVAPI, the card's memory --------------------------------------------------------------------------
Machine("nvapi.vram.dedicated", Nvapi, Agent, Mebibytes, GpuMemory, "Dedicated video memory on the card"),
Machine("nvapi.vram.dedicated_available", Nvapi, Agent, Mebibytes, GpuMemory, "Dedicated video memory available for surfaces"),
Machine("nvapi.vram.system", Nvapi, Agent, Mebibytes, GpuMemory, "System memory the driver reserved at load"),
Machine("nvapi.vram.shared", Nvapi, Agent, Mebibytes, GpuMemory, "Shared system memory the driver may commit"),
Machine("nvapi.vram.framebuffer_physical", Nvapi, Agent, Mebibytes, GpuMemory, "Physical frame buffer size"),
Machine("nvapi.vram.framebuffer_virtual", Nvapi, Agent, Mebibytes, GpuMemory, "Virtual frame buffer size"),
Sampled("nvapi.vram.available", Nvapi, Agent, Mebibytes, GpuMemory, "Dedicated video memory available now, all programs"),
Sampled("nvapi.vram.in_use", Nvapi, Agent, Mebibytes, GpuMemory, "Dedicated video memory in use now, all programs: available for surfaces less available now"),
Sampled("nvapi.vram.evictions_size", Nvapi, Agent, Mebibytes, GpuMemory, "Memory released by evictions since the driver loaded"),
Sampled("nvapi.vram.eviction_count", Nvapi, Agent, Count, GpuMemory, "Evictions from dedicated video memory since the driver loaded"),
Sampled("nvapi.vram.promotions_size", Nvapi, Agent, Mebibytes, GpuMemory, "Memory moved in by promotions since the driver loaded"),
Sampled("nvapi.vram.promotion_count", Nvapi, Agent, Count, GpuMemory, "Promotions into dedicated video memory since the driver loaded"),
// ---- NVAPI, the card over time -------------------------------------------------------------------------
Sampled("nvapi.load.framebuffer", Nvapi, Agent, Percent, Gpu, "Frame-buffer (memory controller) utilisation"),
Sampled("nvapi.load.video", Nvapi, Agent, Percent, Gpu, "Video-engine utilisation"),
Sampled("nvapi.load.bus", Nvapi, Agent, Percent, Gpu, "Bus-interface utilisation"),
Sampled("nvapi.clock.video", Nvapi, Agent, Megahertz, Gpu, "Video clock"),
Sampled("nvapi.pstate", Nvapi, Agent, Count, Gpu, "The card's current performance state (P-state id)"),
Sampled("nvapi.temp.board", Nvapi, Agent, Celsius, Gpu, "Board ambient temperature, where the card has the sensor"),
Sampled("nvapi.temp.power_supply", Nvapi, Agent, Celsius, Gpu, "The card's power-supply temperature, where it has the sensor"),
Sampled("nvapi.limit.ac_battery", Nvapi, Agent, Percent, Gpu, "Held back by a switch to battery on the tick: 100 or 0"),
Sampled("nvapi.limit.api", Nvapi, Agent, Percent, Gpu, "Held back at a program's request on the tick: 100 or 0"),
Sampled("nvapi.limit.insufficient_power", Nvapi, Agent, Percent, Gpu, "Held back by a missing power connector on the tick: 100 or 0"),
Sampled("nvapi.encoder.sessions", Nvapi, Agent, Count, Gpu, "Active hardware-encoder sessions, all programs"),
Sampled("nvapi.encoder.fps", Nvapi, Agent, FramesPerSecond, Gpu, "Average encoding rate of the active sessions"),
Sampled("nvapi.encoder.latency", Nvapi, Agent, Microseconds, Gpu, "Average encoding latency"),
// ---- NVAPI, the driver ---------------------------------------------------------------------------------
Machine("nvapi.driver.package", Nvapi, Agent, Text, Driver, "Game Ready, Studio or an RTX enterprise branch"),
Machine("nvapi.driver.dch", Nvapi, Agent, Flag, Driver, "The driver is a DCH package"),
Machine("nvapi.driver.base_branch", Nvapi, Agent, Text, Driver, "The driver's base branch"),
Machine("nvapi.driver.interface_version", Nvapi, Agent, Text, Driver, "NVAPI's own interface version"),
Machine("nvapi.driver.chipset", Nvapi, Agent, Text, Driver, "Chipset vendor and name, as the driver reports them"),
Machine("nvapi.driver.global_profile", Nvapi, Agent, Table, Driver, "Every setting of the driver's global profile, read-only"),
Session("nvapi.session.driver_profile", Nvapi, Agent, Table, Driver, "The settings the driver's profile for this game sets itself, read-only"),
// ---- NVAPI, displays -----------------------------------------------------------------------------------
MachineFamily("nvapi.display.hdr_formats", Nvapi, Agent, Text, Display, "HDR formats a display accepts: HDR10, HDR10+, HDR10+ Gaming, Dolby Vision, EDR"),
MachineFamily("nvapi.display.luminance_max", Nvapi, Agent, Nits, Display, "A display's maximum luminance for HDR content"),
MachineFamily("nvapi.display.luminance_min", Nvapi, Agent, Nits, Display, "Its minimum luminance"),
MachineFamily("nvapi.display.luminance_max_frame_average", Nvapi, Agent, Nits, Display, "Its maximum frame-average light level"),
MachineFamily("nvapi.display.vrr_support", Nvapi, Agent, Text, Display, "Variable refresh: supported, G-SYNC module or adaptive sync, ULMB, usable at the current mode"),
MachineFamily("nvapi.display.adaptive_sync_off", Nvapi, Agent, Flag, Display, "Adaptive sync is switched off on the display"),
MachineFamily("nvapi.display.max_frame_interval", Nvapi, Agent, Microseconds, Display, "The longest frame interval adaptive sync is set to hold"),
Session("nvapi.session.vrr_enabled", Nvapi, Agent, Flag, Display, "Variable refresh was active on the game's display"),
Session("nvapi.session.vrr_requested", Nvapi, Agent, Flag, Display, "Variable refresh was requested for it"),
Session("nvapi.session.vrr_possible", Nvapi, Agent, Flag, Display, "Variable refresh was possible on it"),
Session("nvapi.session.vrr_display_mode", Nvapi, Agent, Flag, Display, "The display itself was in variable-refresh mode"),
Session("nvapi.session.source_colorspace", Nvapi, Agent, Text, Display, "The colour space the game presented in, as the driver reports it for the process"),
// ---- LibreHardwareMonitor, the graphics card (every vendor, unelevated) ---------------------------------
SampledFamily("lhm.gpu.temperature", Lhm, Agent, Celsius, Gpu, "Every temperature sensor of the card"),
SampledFamily("lhm.gpu.load", Lhm, Agent, Percent, Gpu, "Every load of the card: its engines, its bus, its memory controller"),
SampledFamily("lhm.gpu.memory", Lhm, Agent, Mebibytes, GpuMemory, "The card's memory counters: total, free, used, Direct3D dedicated and shared"),
SampledFamily("lhm.gpu.clock", Lhm, Agent, Megahertz, Gpu, "Every clock of the card"),
SampledFamily("lhm.gpu.power", Lhm, Agent, Watts, Gpu, "Every power reading of the card"),
SampledFamily("lhm.gpu.fan", Lhm, Agent, Rpm, Gpu, "Every fan of the card"),
SampledFamily("lhm.gpu.fan_control", Lhm, Agent, Percent, Gpu, "Each fan's duty"),
SampledFamily("lhm.gpu.voltage", Lhm, Agent, Volts, Gpu, "Every voltage of the card"),
SampledFamily("lhm.gpu.current", Lhm, Agent, Amperes, Gpu, "Every current of the card"),
SampledFamily("lhm.gpu.throughput", Lhm, Agent, BytesPerSecond, Gpu, "PCI Express traffic to and from the card"),
// ---- LibreHardwareMonitor through PawnIO (the Agent as administrator, D103) -----------------------------
SampledFamily("lhm.cpu.temperature", Lhm, AgentElevated, Celsius, Cpu, "Processor temperatures: the package and each core"),
SampledFamily("lhm.cpu.load", Lhm, AgentElevated, Percent, Cpu, "Processor load: the total and each core"),
SampledFamily("lhm.cpu.clock", Lhm, AgentElevated, Megahertz, Cpu, "Each core's clock, and the bus clock"),
SampledFamily("lhm.cpu.power", Lhm, AgentElevated, Watts, Cpu, "Processor power: the package, the cores"),
SampledFamily("lhm.cpu.voltage", Lhm, AgentElevated, Volts, Cpu, "Processor voltages"),
Machine("lhm.board.model", Lhm, AgentElevated, Text, Board, "The motherboard's maker and model"),
Machine("lhm.board.sensor_chip", Lhm, AgentElevated, Text, Board, "The board's sensor chip"),
SampledFamily("lhm.board.temperature", Lhm, AgentElevated, Celsius, Board, "The board's temperature sensors"),
SampledFamily("lhm.board.fan", Lhm, AgentElevated, Rpm, Board, "Each fan header's speed"),
SampledFamily("lhm.board.fan_control", Lhm, AgentElevated, Percent, Board, "Each fan header's duty"),
SampledFamily("lhm.board.voltage", Lhm, AgentElevated, Volts, Board, "The board's voltage rails"),
Machine("lhm.memory.modules", Lhm, AgentElevated, Table, Memory, "The memory modules: size, speed, maker's part name - never a serial number"),
SampledFamily("lhm.memory.load", Lhm, AgentElevated, Percent, Memory, "Memory in use: physical and virtual"),
SampledFamily("lhm.memory.temperature", Lhm, AgentElevated, Celsius, Memory, "Each memory module's temperature, where it has a sensor"),
// ---- What the Agent could reach and does not ------------------------------------------------------------
Machine("lhm.psu", Lhm, Refused, Table, Board, "Power-supply sensors: reading them makes the library search every USB device"),
Machine("lhm.controller", Lhm, Refused, Table, Board, "Fan-controller sensors: the same search of USB devices"),
Machine("lhm.battery", Lhm, Deferred, Table, Board, "Battery sensors"),
Machine("lhm.storage.models", Lhm, Deferred, Table, Storage, "The drives' model names: the library cannot list drives without touching removable ones"),
SampledFamily("lhm.storage.temperature", Lhm, Deferred, Celsius, Storage, "Each drive's temperature: the same, so the storage group is not opened"),
Machine("nvapi.gpu.board_serial", Nvapi, Identifier, Text, Gpu, "The card's board serial number"),
Machine("nvapi.gpu.uuid", Nvapi, Identifier, Text, Gpu, "The card's unique id"),
MachineFamily("nvapi.display.edid", Nvapi, Identifier, Text, Display, "A display's EDID block, which carries its serial number"),
Sampled("nvapi.encoder.session_processes", Nvapi, Identifier, Table, Gpu, "Which programs are encoding"),
Sampled("nvapi.gpu.power", Nvapi, NotInHeaders, Watts, Gpu, "Card power through NVAPI (LibreHardwareMonitor reads it)"),
Sampled("nvapi.gpu.fan_duty", Nvapi, NotInHeaders, Percent, Gpu, "Fan duty through NVAPI (LibreHardwareMonitor reads it)"),
Sampled("nvapi.gpu.voltage", Nvapi, NotInHeaders, Volts, Gpu, "Card voltage through NVAPI (LibreHardwareMonitor reads it)"),
Machine("nvapi.gpu.ram_type", Nvapi, NotInHeaders, Text, GpuMemory, "The card's memory type"),
// ---- Inside the game: calls the Overlay already hooks (read since 0.1.0-beta.40, train B) ----------------
Session("sl.dlss.output_size", Streamline, Game, Text, Upscaling, "The output size the game gave DLSS"),
Session("sl.dlss.presets", Streamline, Game, Table, Upscaling, "The DLSS model preset per quality mode"),
Session("sl.dlss.hdr_input", Streamline, Game, Flag, Upscaling, "The game told DLSS its colour buffers are HDR"),
Session("sl.dlss.auto_exposure", Streamline, Game, Flag, Upscaling, "DLSS auto-exposure"),
Session("sl.dlss.alpha_upscaling", Streamline, Game, Flag, Upscaling, "DLSS upscales the alpha channel"),
Session("sl.dlss.exposure", Streamline, Game, Table, Upscaling, "Pre-exposure and exposure scale given to DLSS"),
Session("ffx.upscale.sharpening", FidelityFx, Game, Table, Upscaling, "FSR sharpening: on or off, and its strength"),
Session("ffx.upscale.jitter", FidelityFx, Game, Table, Upscaling, "The largest jitter offset the game gave FSR"),
Session("ffx.upscale.exposure", FidelityFx, Game, Text, Upscaling, "Pre-exposure given to FSR"),
Session("ffx.upscale.depth", FidelityFx, Game, Table, Upscaling, "Near and far planes and the range of the field of view given to FSR"),
Session("ffx.upscale.flags", FidelityFx, Game, Text, Upscaling, "The flags of the game's FSR dispatch"),
Sampled("ffx.upscale.frame_time_delta", FidelityFx, Game, Milliseconds, Upscaling, "The frame time the game reported to FSR"),
Sampled("ffx.memory_usage", FidelityFx, Game, Mebibytes, Upscaling, "FSR's own video memory, when the game asks it"),
// ---- Inside the game: hooks that are not built ----------------------------------------------------------
Session("sl.constants.jitter", Streamline, NewHook, Text, Upscaling, "The jitter offsets the game gave Streamline"),
Session("sl.constants.motion_vectors", Streamline, NewHook, Text, Upscaling, "Motion-vector scale, and whether they are 3D, dilated, jittered"),
Session("sl.constants.depth", Streamline, NewHook, Text, Upscaling, "Near and far planes, and whether depth is inverted"),
Session("sl.constants.projection", Streamline, NewHook, Text, Upscaling, "Field of view, aspect ratio, orthographic or not"),
Session("sl.constants.resets", Streamline, NewHook, Count, Upscaling, "How often the game reset the upscaler's history"),
Session("sl.feature.versions", Streamline, NewHook, Table, Upscaling, "Each Streamline feature's version and its NGX model version"),
Session("sl.feature.requirements", Streamline, NewHook, Table, Upscaling, "What each Streamline feature requires: operating system, driver, buffers"),
Session("sl.init.preferences", Streamline, NewHook, Text, Upscaling, "The preferences the game started Streamline with"),
Session("ffx.framegen.config", FidelityFx, NewHook, Text, FrameGeneration, "The game's FSR frame-generation configuration"),
Session("sl.constants.camera", Streamline, PlayerState, Text, Upscaling, "Camera position, axes and matrices"),
// ---- Inside the game: routes a spike decides ------------------------------------------------------------
Session("nvapi.reflex.mode", Nvapi, Spike, Text, Latency, "Reflex: low-latency mode, boost, the frame-rate limit"),
Session("nvapi.reflex.sleep_status", Nvapi, Spike, Text, Latency, "What the driver's low-latency state is"),
SampledFamily("nvapi.reflex.frame_report", Nvapi, Spike, Microseconds, Latency, "Latency per frame: simulation, render submit, present, driver, OS queue, GPU render"),
Session("sl.dlss.optimal_settings", Streamline, Spike, Text, Upscaling, "The render size and sharpness DLSS recommends"),
Sampled("sl.dlss.vram_estimate", Streamline, Spike, Mebibytes, Upscaling, "DLSS's own estimate of its video memory"),
Session("sl.dlssg.options", Streamline, Spike, Text, FrameGeneration, "DLSS frame generation: mode, frames to generate"),
Session("sl.dlssg.state", Streamline, Spike, Text, FrameGeneration, "DLSS frame generation: status, the most frames it can generate"),
Sampled("sl.dlssg.frames_presented", Streamline, Spike, Count, FrameGeneration, "Frames DLSS frame generation presented, by its own count"),
Sampled("sl.dlssg.vram_estimate", Streamline, Spike, Mebibytes, FrameGeneration, "DLSS frame generation's estimate of its video memory"),
Session("sl.dlssd.options", Streamline, Spike, Text, Upscaling, "Ray reconstruction's options"),
Session("sl.nis.options", Streamline, Spike, Text, Upscaling, "NVIDIA Image Scaling's options"),
Session("sl.deepdvc.options", Streamline, Spike, Text, Upscaling, "RTX Dynamic Vibrance's options"),
Session("sl.reflex.state", Streamline, Spike, Table, Latency, "Reflex through Streamline: availability and its frame reports"),
Sampled("sl.pcl.markers", Streamline, Spike, Count, Latency, "PC-latency markers the game sets"),
// ---- Closed by a licence --------------------------------------------------------------------------------
Session("ngx.parameters", Ngx, Licence, Table, Upscaling, "NGX parameters: the quality value, the DLSS hints"),
Session("xess.options", Xess, Licence, Table, Upscaling, "XeSS's options"),
Sampled("sl.nvperf", Streamline, Licence, Table, Gpu, "Streamline's performance counters (NSight Perf SDK licence)"),
];
private static readonly FrozenDictionary<string, AdvancedMetric> _byId = All.ToFrozenDictionary(static m => m.Id, StringComparer.Ordinal);
/// <summary>The entry with this id, or null.</summary>
public static AdvancedMetric? Find(string id)
{
ArgumentNullException.ThrowIfNull(id);
return _byId.GetValueOrDefault(id);
}
/// <summary>The longest key <see cref="InstanceName"/> accepts.</summary>
public const int MaxInstanceKeyLength = 48;
/// <summary>
/// The series name of one member of a family: the family's <see cref="AdvancedMetric.SeriesName"/>, a dot, and a
/// key made of lower-case letters, digits and underscores that names the sensor on this PC.
/// </summary>
/// <exception cref="ArgumentException">The entry is not a family of series, or the key is not such a key.</exception>
public static string InstanceName(AdvancedMetric family, string key)
{
ArgumentNullException.ThrowIfNull(family);
ArgumentNullException.ThrowIfNull(key);
if (!family.IsFamily || family.SeriesName is not string stem)
{
throw new ArgumentException($"{family.Id} is not a family of series", nameof(family));
}
if (!IsInstanceKey(key))
{
throw new ArgumentException($"'{key}' is not an instance key: 1 to {MaxInstanceKeyLength} of a-z, 0-9 and _", nameof(key));
}
return stem + "." + key;
}
/// <summary>True for 1 to <see cref="MaxInstanceKeyLength"/> characters of <c>a-z</c>, <c>0-9</c> and <c>_</c>.</summary>
public static bool IsInstanceKey(string key)
{
ArgumentNullException.ThrowIfNull(key);
if (key.Length is 0 or > MaxInstanceKeyLength)
{
return false;
}
foreach (char c in key)
{
if (c is not ((>= 'a' and <= 'z') or (>= '0' and <= '9') or '_'))
{
return false;
}
}
return true;
}
private static AdvancedMetric Machine(string id, AdvancedSource source, AdvancedReach reach, AdvancedUnit unit, AdvancedGroup group, string summary)
=> new(id, AdvancedScope.MachineFact, source, reach, unit, group, summary);
private static AdvancedMetric MachineFamily(string id, AdvancedSource source, AdvancedReach reach, AdvancedUnit unit, AdvancedGroup group, string summary)
=> new(id, AdvancedScope.MachineFact, source, reach, unit, group, summary) { IsFamily = true };
private static AdvancedMetric Session(string id, AdvancedSource source, AdvancedReach reach, AdvancedUnit unit, AdvancedGroup group, string summary)
=> new(id, AdvancedScope.SessionFact, source, reach, unit, group, summary);
private static AdvancedMetric Sampled(string id, AdvancedSource source, AdvancedReach reach, AdvancedUnit unit, AdvancedGroup group, string summary)
=> new(id, AdvancedScope.Series, source, reach, unit, group, summary);
private static AdvancedMetric SampledFamily(string id, AdvancedSource source, AdvancedReach reach, AdvancedUnit unit, AdvancedGroup group, string summary)
=> new(id, AdvancedScope.Series, source, reach, unit, group, summary) { IsFamily = true };
}
@@ -1,54 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.Application.Advanced;
/// <summary>
/// Where an advanced metric can be read from — or why it is not read. The catalog names what is NOT read beside what
/// is, so the page can say so with the reason instead of leaving a gap (<c>docs/18_GPU_VENDOR_APIS.md</c> §Advanced
/// metrics; rule 7's "N/A, never a guess" applied to a whole source).
/// </summary>
public enum AdvancedReach
{
/// <summary>Not stated. No entry of the catalog carries it.</summary>
None = 0,
/// <summary>The Agent reads it in its own process, unelevated.</summary>
Agent = 1,
/// <summary>The Agent reads it only when it already runs as administrator and PawnIO is installed (D103).</summary>
AgentElevated = 2,
/// <summary>An argument of a call the Overlay already hooks; not read yet.</summary>
HookedCall = 3,
/// <summary>Needs a hook on a function its module exports; the hook is not built.</summary>
NewHook = 4,
/// <summary>A route nobody has proven safe: a spike decides, and the owner says go or no.</summary>
Spike = 5,
/// <summary>A source the project decided not to open (D103).</summary>
Refused = 6,
/// <summary>A source left for later, with no decision against it.</summary>
Deferred = 7,
/// <summary>It identifies a device, a person or another program. Never read (D104).</summary>
Identifier = 8,
/// <summary>It is the game's own state — where the player is, where the camera looks. Never read (CLAUDE.md rule 4).</summary>
PlayerState = 9,
/// <summary>The vendor's licence forbids vendoring and re-declaring what reading it needs.</summary>
Licence = 10,
/// <summary>The vendor's public headers do not declare it.</summary>
NotInHeaders = 11,
/// <summary>
/// Read inside a game FrameLedger measures, from the arguments of a call the Overlay hooks, while the session
/// records Advanced metrics (train B, owner decision D111) — and only when the game makes that call.
/// </summary>
Game = 12,
}
@@ -1,12 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.Application.Advanced;
/// <summary>
/// One value of one advanced series at one tick. A series with no value on the tick has no reading — it is never a
/// zero, and in storage it is NaN (D102).
/// </summary>
/// <param name="Series">The series' name: <see cref="AdvancedMetric.SeriesName"/>, or an instance's name for a family.</param>
/// <param name="Value">The value, in the entry's unit. It may be negative: a voltage rail is.</param>
public readonly record struct AdvancedReading(string Series, double Value);
@@ -1,12 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.Application.Advanced;
/// <summary>
/// One row of a table-valued fact (<see cref="AdvancedUnit.Table"/>) — a driver setting, a memory module.
/// </summary>
/// <param name="Name">What the row is, in the vendor's own words; shown as it is.</param>
/// <param name="Value">Its value, in the vendor's own notation; shown as it is.</param>
/// <param name="Token">A word the App translates, saying something about the row — who set the value, say; or null.</param>
public sealed record AdvancedRow(string Name, string Value, string? Token = null);
@@ -1,18 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.Application.Advanced;
/// <summary>
/// An <see cref="AdvancedRow"/> as it is stored. Every member is nullable because a stored document is read
/// tolerantly: a ledger edited by hand can hold a row with no name, and the reader leaves that fact out rather than
/// trusting an annotation the text never promised to keep.
/// </summary>
internal sealed record AdvancedRowDocument
{
public string? Name { get; init; }
public string? Value { get; init; }
public string? Token { get; init; }
}
@@ -1,26 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.Application.Advanced;
/// <summary>
/// What an advanced metric belongs to (owner decision D101, <c>docs/18_GPU_VENDOR_APIS.md</c> §Advanced metrics): the
/// machine, or one game session. It decides where the value is stored and on which tab it is shown.
/// </summary>
public enum AdvancedScope
{
/// <summary>Not stated. No entry of the catalog carries it.</summary>
None = 0,
/// <summary>A fact about the PC that no session changes: stored once in <c>machine_profiles</c>, which a session points to.</summary>
MachineFact = 1,
/// <summary>A fact about one session — the game's display, the game's driver profile: <c>session_advanced.facts_json</c>.</summary>
SessionFact = 2,
/// <summary>
/// A value sampled over time. During a session it is stored with that session (<c>sensor_blobs</c>, under
/// <see cref="AdvancedMetric.SeriesName"/>); with no session it is shown while the page is open and stored nowhere.
/// </summary>
Series = 3,
}
@@ -1,15 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.Application.Advanced;
/// <summary>
/// <c>session_advanced.series_json</c>: what each stored series that is a member of a family is, and how many series
/// were left out because the session had more than the most one session stores.
/// </summary>
internal sealed record AdvancedSeriesDocument
{
public List<AdvancedSeriesInfoDocument> Series { get; init; } = [];
public int Dropped { get; init; }
}
@@ -1,16 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.Application.Advanced;
/// <summary>
/// One line of a session's series directory: a series that is one member of a family, the catalog entry it is a
/// member of, and what the hardware calls the sensor.
/// </summary>
/// <param name="Series">The series' name in <c>sensor_blobs</c> (<see cref="AdvancedMetricCatalog.InstanceName"/>).</param>
/// <param name="MetricId">The family's <see cref="AdvancedMetric.Id"/>.</param>
/// <param name="Label">
/// The hardware's own words — <c>Intel Core i7-14700K - CPU Core #3</c> — shown as they are. A family's members
/// differ from PC to PC, so their names cannot be translated strings; the family's name, which is, stands above them.
/// </param>
public sealed record AdvancedSeriesInfo(string Series, string MetricId, string Label);
@@ -1,14 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.Application.Advanced;
/// <summary>An <see cref="AdvancedSeriesInfo"/> as it is stored — nullable throughout, for the same reason as <see cref="AdvancedRowDocument"/>.</summary>
internal sealed record AdvancedSeriesInfoDocument
{
public string? Series { get; init; }
public string? MetricId { get; init; }
public string? Label { get; init; }
}
@@ -1,18 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.Application.Advanced;
/// <summary>
/// What one session knows of advanced metrics beside its series (owner decision D102): the PC's facts as they were
/// when it ran, its own facts, what each series is, and which sources answered.
/// </summary>
/// <param name="MachineFacts">The facts of the PC — stored once per distinct set, in <c>machine_profiles</c>.</param>
/// <param name="SessionFacts">The facts of this session — <c>session_advanced.facts_json</c>.</param>
/// <param name="Series">What each series that is a member of a family is, with the hardware's own label.</param>
/// <param name="Sources">Which sources answered while it ran, and why the others did not.</param>
public sealed record AdvancedSessionData(
IReadOnlyList<AdvancedFact> MachineFacts,
IReadOnlyList<AdvancedFact> SessionFacts,
IReadOnlyList<AdvancedSeriesInfo> Series,
AdvancedSources Sources);
@@ -1,12 +0,0 @@
// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
namespace FrameLedger.Application.Advanced;
/// <summary><c>session_advanced.facts_json</c>: one session's facts and the state of each source while it ran.</summary>
internal sealed record AdvancedSessionDocument
{
public List<AdvancedFactDocument> Facts { get; init; } = [];
public AdvancedSources? Sources { get; init; }
}
Loaded 100 of 252 files, more files were not shown because too many files have changed in this diff. Show more