hex/tests/golden/rune-commands-dark.png
Dax 60e753a333
annotate: record the screen under the pointer on wayland (labs), list hex annotate without a shortcuts portal (#2094)
* annotate: follow the pointer on Wayland, and list its command without a portal

Labs › Record the screen under the pointer (labs.annotate_pointer_screen,
Linux, off by default) asks the compositor which output the pointer is on
before each screen capture, using one ext-image-copy-capture pointer cursor
session per wl_output (no surface, no frames, two round trips), and keeps a
ScreenCast restore token per output (screencast-token-<output>) so each
monitor is asked once. After Start the token is saved for the output the
desktop actually recorded: mapping_id, else the xdg-output geometry holding
the stream's position, else the pointer's. Off, on X11, or when the lookup
fails, the one file behaves exactly as before.

Without a GlobalShortcuts portal the Annotate pane now shows the
`hex annotate toggle` command to bind instead of a recorder that can never
register, and General's desktop commands list it while Annotate is on.

docs/features/capture.md and labs.md carry the behavior, checks, and gaps.

* annotate: fix the Wayland pointer follow-ups and the macOS sampler

- macOS: the ScreenCaptureKit sampler's Start destructure includes the new
  portal_token field (E0027).
- portal: a mapping_id only names an output the outputs list knows;
  otherwise the stream's own geometry decides.
- pointer_output: release wl_pointer (v3+) and wl_seat (v5+), prefer a
  session that also reported a position when several entered, and say
  plainly that the lookup is a fixed two round trips, not a time bound.
- policy: the Annotate lock now reports for the new lab too.
- Annotate pane: its own singular no-portal note, translated.
- docs: the website leaves out the labs that only matter once Annotate is
  on (build.rs sets hex_capture on every macOS, Linux and Windows build);
  capture.md marks the wlroots software-cursor limit unverified.
- goldens: commands-dark and linux-labs-light re-blessed for the new
  Annotate command row and lab card.
2026-11-20 15:58:16 -05:00

214 KiB
1960x3440px