Module telemetry 

Click telemetry → auto-zoom regions (ED.17 / M-EDIT).

Screen recorders earn their “cinematic” feel by punching in where the user is working — and the user tells you where that is every time they click. This module turns a recorded click log into ZoomSegments: clicks close together in time form one cluster, and each cluster becomes a zoom that opens just before the first click, holds through the last, and targets the cluster’s centroid. The result is an ordinary, fully-editable list of zooms (the user can nudge, delete, or retune any of them) — auto-zoom is a starting point, not a lock-in.

It is pure arithmetic over a click list, so it is exhaustively testable without a recorder. The OS-level capture that produces the click log (a per-platform surface, macOS first) is a separate follow-up; this is the generator that consumes it.

Structs

ClickEvent

A click captured during recording: a project frame plus a normalized position in the composed frame ((0, 0) top-left, (1, 1) bottom-right).

CursorSample

A cursor position sample at a project frame, normalized to the composed frame ((0, 0) top-left, (1, 1) bottom-right — the same convention as ClickEvent).

Functions

auto_zoom_segments

Generate auto-zoom regions from a click log.

cursor_at

The smoothed cursor position at project frame, for the ED.19 overlay.

cursor_is_static

Whether the cursor is effectively stationary at project frame — the basis for CursorConfig::hide_static.

ripples_at

Active click ripples at project frame, for the ED.19 overlay.