Skip to content

BDSP Starter RNG: frame-pipeline performance plan - #581

Draft
dayfine wants to merge 1 commit into
bdsp/starter-rng-adoptfrom
bdsp/starter-rng-performance-plan
Draft

dayfine wants to merge 1 commit into
bdsp/starter-rng-adoptfrom
bdsp/starter-rng-performance-plan

Conversation

@dayfine

@dayfine dayfine commented Nov 15, 2026

Copy link
Copy Markdown
Owner

Stacked on fork PR #526 (bdsp/starter-rng-adopt). Base: bdsp/starter-rng-adopt. The diff shows only this documentation plan.

Problem

Live Starter RNG runs on the current M2 Pro/capture setup process only about 13 unique snapshots per second from a roughly 30 FPS source, with full-frame conversion stalls reaching 2.5 seconds and thousands of Stream History queue drops. The blink watchers also repeatedly analyze cached snapshots, so the solver receives an incomplete or distorted observation stream.

Change

Add a detailed performance plan covering:

  • the measured pipeline and failed-run baseline;
  • a scoped, programmatic Stream History video pause that preserves user settings and resumes via RAII;
  • timestamp-based fresh-frame gating for both eye watchers;
  • staged implementation and deterministic concurrency-test work;
  • live acceptance criteria, deferred optimizations, and open investigation questions.

This PR changes documentation only. It does not alter the detector, solver, history worker, or program behavior.

Tests

  • git diff --check
  • Documentation-only review; no C++ build required.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant