Struct CoalescedSample 

#[non_exhaustive]
pub struct CoalescedSample {
    pub time: EventTime,
    pub window_position: Point,
    pub axes: PointerAxes,
}

One position the OS batched into a packet, with the axes it was sampled at and its own time.

A backend that reports a batch — a digitizer whose packets arrive faster than the window’s message rate, a platform with an explicit coalescing API — hands over one PointerSample per packet with the intermediate positions in PointerSample::coalesced. The alternative, one whole tree dispatch per digitizer packet, costs a hit test, an arbitration turn and a handler walk for a position no one had a chance to draw between.

Consumers see these through EventContext::coalesced. A drawing surface fans out over them and then over the sample’s own position; a velocity tracker integrates them; everything else ignores them, which costs nothing because the list is empty for every producer that does not batch.

Coordinates

window_position is window-logical, exactly like PointerSample::position and WidgetEvent::Scroll’s window_position, and is named for it. The router localises the event’s position against the captor’s current bounds; a batch has no single widget to localise against, and a handler that needs widget-local coordinates converts at the use site — a SceneView does it through SceneView::view_transform_signal.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

time: EventTime

When the device produced this position, on the tree’s timeline.

window_position: Point

Where, in window-logical coordinates. See the type’s docs.

axes: PointerAxes

The continuous axes as they read at this position — a digitizer varies pressure and tilt within a batch, and that variation is the whole reason to keep the intermediate samples rather than the endpoints.

Implementations

impl CoalescedSample

pub fn new(time: EventTime, window_position: Point) -> Self

One batched position. Axes default to “reported nothing”; set them with with_axes.

pub fn with_axes(self, axes: PointerAxes) -> Self

This position with its axes recorded.

Trait Implementations

impl Clone for CoalescedSample

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for CoalescedSample

impl Debug for CoalescedSample

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for CoalescedSample

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for CoalescedSample