docs: the readouts dock, the cursors and measurement pages
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
1 parent
a2ce02db92
commit
ce3cc97b91
11 files changed
+205
-88
No files matched your search
+19
-10
@@ -423,15 +423,24 @@ precedent, not an exception.
|
||||
pauses, reports again with `dn=` per measurement, then resets and reports a third time. Three
|
||||
phases: `phase=0`, `phase=1` (after pause) and `phase=2` (after Reset). Needs
|
||||
`UDPSCOPE_ENABLE_ALL_MS` ahead of it and `UDPSCOPE_PROBE_MEASURE_MS` to add measurements first.
|
||||
- `UDPSCOPE_PROBE_SIDE_TAB_MS=3000` with `UDPSCOPE_EXIT_AFTER_MS=11000` — the measurements in the
|
||||
dock's Measure section, a forced pass, then the dock scrolled back to its top (the
|
||||
measurements out of view) and read again two seconds later. The probe pads the dock page and the cursors panel to
|
||||
3000 px each so the Measure section really starts below the viewport (`outside_at_top=1`) on any real window. **`advanced=4`
|
||||
is the assertion** (every accumulator gained passes while its section was out of view); `advanced=0` is the
|
||||
defect where the accumulation is gated on the visible section, which would leave a gap in min/max/avg for
|
||||
exactly as long as the trigger was on screen. It enables *and plots* its own signal, so it needs no other
|
||||
probe ahead of it. The reading's own entry is in `probe-readings.md`. (Probe name `dock_section_probe`; the
|
||||
variable and the `[side-tab-probe]` tag keep their old names so existing scripts keep working.)
|
||||
- `UDPSCOPE_PROBE_SIDE_TAB_MS=3000` with `UDPSCOPE_EXIT_AFTER_MS=11000` — the measurements while the
|
||||
`measure` page is **closed**: it adds four measurements, opens the page for a forced pass (the baseline),
|
||||
closes it, and reads the accumulators again two seconds later. **`advanced=<rows>` is the assertion**
|
||||
(every accumulator gained passes while the page was off screen); `advanced=0` is the defect where the
|
||||
accumulation is gated on what is visible, which would leave a gap in min/max/avg for exactly as long as the
|
||||
page was shut. It enables *and plots* its own signal, so it needs no other probe ahead of it, and it
|
||||
re-arms once after 400 ms (a buffer rebuild between baseline and report reads as a gated pass). It needs a
|
||||
config that has seen the first-run tour, which would close the page it opens (see the next-but-one bullet).
|
||||
The reading's own entry is in `probe-readings.md`. (Probe name `dock_section_probe`; the variable and the
|
||||
`[side-tab-probe]` tag keep their old names so existing scripts keep working. The measurements used to be a
|
||||
dock section the probe scrolled out of view, with padding; the dock now holds only readouts, so there is
|
||||
no scroll and no padding.)
|
||||
- `UDPSCOPE_PROBE_CURSORS_MS` and `UDPSCOPE_PROBE_MEASURES_MS` also print the dock's copy of what they read:
|
||||
a `dock cursors:` line after every `[cursors-probe]` report and a `dock measures:` line at the
|
||||
measures probe's added / settled / final stops. **`same_text=1` on every one** is the assertion that the
|
||||
dock and the page show one string; `fits=1` that the Readouts box is no wider than the dock. Entries in
|
||||
`probe-readings.md`. The exit chain also prints one `[readouts]` line (pages registered, the dock's one
|
||||
child, the dock's width, the pages' sensitivity, whether the stream has signals) on every exit-dump run.
|
||||
- `UDPSCOPE_PROBE_DOCK_SESSION_MS=2500` with `UDPSCOPE_EXIT_AFTER_MS=8000` -- the session file's `dock` key,
|
||||
end to end: the dock hidden, saved and reloaded; shown again; and a file from the previous version
|
||||
(`side_tab = "measure"`, no `dock`) loaded without an error. Three `[dock-session]` lines, each `ok=1`;
|
||||
@@ -447,7 +456,7 @@ precedent, not an exception.
|
||||
read `click_inside_closes=0 still_open=1 click_outside_closes=1 esc_closes=1 closed=1`. For a screenshot
|
||||
add `UDPSCOPE_PROBE_SLIDEOVER_HOLD=1`, which leaves the page open after line 1 (run with `GSK_RENDERER=cairo`
|
||||
and `import -window root`): the panel must be drawn over the traces, opaque.
|
||||
- **Slide-over and page probes (`SLIDEOVER`, `BADGES`, `SIGNAL_PAGES`, `SIGNAL_BADGES`) need a config that has already seen
|
||||
- **Slide-over and page probes (`SLIDEOVER`, `BADGES`, `SIGNAL_PAGES`, `SIGNAL_BADGES`, `SIDE_TAB`, `KEYS`) need a config that has already seen
|
||||
the first-run tour**: a fresh `XDG_CONFIG_HOME` auto-starts the tour at about 1.5 s, and a tour stop with no page closes the
|
||||
slide-over under the probe. Seed it with `mkdir -p $D/udpscope && printf 'tour_seen = true\n' > $D/udpscope/settings.toml`
|
||||
(or one short throw-away run, which writes the key when the tour starts) and run with `XDG_CONFIG_HOME=$D`. Delete the
|
||||
|
||||
Reference in new issue
Block a user