Words FrameLedger uses - poli0981/frameledger GitHub Wiki

What the words on FrameLedger's screens mean, in alphabetical order. How each figure is computed is in the developers' metrics document.

  • 0.1% low, 1% low โ€” the frame rate of the game's slowest 0.1% and 1% of frames. The further they fall below the average, the less smooth the game felt. They need 10,000 and 1,000 of the game's own frames.
  • Agent (the capture agent) โ€” the program FrameLedger runs in the background, with your normal rights, that notices a game starting and records it.
  • Anti-cheat finding โ€” what FrameLedger's anti-cheat check found for a game: a component loaded into it, a file or folder of it, or the game itself on a list. A game with a finding is not hooked (Anti-cheat and safety).
  • Bug bundle โ€” the zip Help โ–ธ Report a bugโ€ฆ writes on your PC. Nothing is sent by FrameLedger.
  • Compare โ€” two to five sessions side by side, from any of your games.
  • Disable all hooking โ€” the switch that stops every game from being hooked at once, whatever each game's own switch says. Sessions are still recorded.
  • Displayed FPS โ€” the frames you saw, generated frames included.
  • FG factor โ€” Displayed FPS divided by Native FPS, shown as ร—1.9 FG.
  • FPS โ€” frames per second over the time measured.
  • Frame generation โ€” the technology (DLSS Frame Generation, FSR Frame Generation) that inserts frames the game did not render itself.
  • Frame time โ€” how long one frame took, in milliseconds.
  • Frame to frame โ€” how much one frame's time differs from the next. Lower is smoother.
  • Frames per watt โ€” the game's own frames per second for each watt the graphics card drew.
  • GPU held back โ€” how much of the time the card's power limit or its temperature slowed it down. NVIDIA cards only.
  • Hooking โ€” loading FrameLedger's small component into a game to measure it. Off for every game until you switch it on for that game.
  • Ledger โ€” the one database file that holds your library and sessions, %LOCALAPPDATA%\FrameLedger\ledger.db.
  • N/A โ€” not measured. Never 0, and never an estimate.
  • Native FPS โ€” the frames the game rendered itself.
  • Overlay build โ€” the version of the component that hooking loads into a game. It draws nothing on your screen.
  • Override โ€” your own Yes, No or N/A for a ray-tracing chip. The measured value is kept, and yours is marked as yours.
  • Presented FPS โ€” every frame the game handed to Windows, shown when frame generation could not be measured, with a note saying whether generated frames could be among them.
  • RAM (this game) โ€” the game's own memory, what Task Manager's Details tab shows as its private working set.
  • Ray tracing, Path tracing, Ray reconstruction โ€” read Yes, No or N/A. Ray tracing is measured on DirectX 12 games; path tracing is never stated as a fact.
  • Render scale โ€” the share of the screen's resolution the game drew at before upscaling. 100% means no upscaling.
  • Session โ€” one run of a game, from its start to its end. A session shorter than 30 seconds is not kept.
  • Steady state โ€” when frame generation changed during a session (menus, loading screens, a settings change), the figures are for the state that lasted longest, with the share of the session it covers: ร—1.9 FG ยท 75%.
  • Stutter โ€” frames that took more than twice as long as the frames around them, counted, with the share of time they took.
  • T1 โ€” a measured session. T2 โ€” a session that was only recorded: how long you played, your PC's sensors and the game's memory, with every frame figure N/A.
  • Tags and notes โ€” what you write on a session's summary.
  • Telemetry source โ€” which sensor readers work on this PC: l1 is Windows itself, lhm is LibreHardwareMonitor, nvapi is NVIDIA's own.
  • Time below 60 FPS โ€” how much of the session ran slower than 60 frames per second (and below 30, and below your display's refresh rate), not counting the tiny wobble of a game held at its frame limit.
  • Trend โ€” one point per measured session over time, on a game's page.
  • Upscaler โ€” the technology that draws the game at a lower resolution and scales it up (DLSS, FSR).
  • User-mode exception โ€” the one way to hook a game where anti-cheat was found: only an anti-cheat that runs entirely inside the game, one game at a time, after a warning. Its first two sessions are a trial.
  • Viewer โ€” FrameLedger opened over a copy of a data folder: no agent, nothing recorded, nothing changed.
  • VRAM (this game) โ€” the game's own video memory, what Task Manager shows as its Dedicated GPU memory.
  • VSync โ€” how many frames asked to wait for the display; tearing allowed, how many did not mind tearing. It is what the game asked: your graphics driver can override it.
  • Vulkan layer โ€” the component that measures Vulkan games, used only when FrameLedger starts a game itself.