Struct EdgeAim 

pub struct EdgeAim { /* private fields */ }

Reaching for something that waits at a display’s edge (a desk widget’s quiet form): the same transit-versus-aim reading as HoverIntent, for targets that are not under the pointer yet.

A sample aims at a target when both hold:

• it heads there: it lies in the convex hull of a recent position and the target, so a pointer moving away or sideways past it does not;
• it is coming to rest there: it is already slow inside the target, or it is decelerating so that, at constant deceleration, it stops inside the target.

A pointer thrown at the edge stops there without slowing first, and the display then sends no more motion: EdgeAim::rested_in reads that rest once the pointer has been still for SETTLE inside a target it arrived at from outside.

A pointer sweeping across or along a target at speed is in transit and aims at nothing, however close it passes; one predicted to run on past the display’s edge is not coming to rest anywhere yet; and one that has not moved aims at nothing either, so a pointer resting near an edge never counts.

The state is pure: every method takes the instant it reasons about.

Implementations

impl EdgeAim

pub fn clear(&mut self)

Forget the trajectory, e.g. when the pointer leaves the display or jumps to another one.

pub fn on_motion( &mut self, p: Point, now: Instant, targets: &[Rect], ) -> Option<usize>

A pointer sample at p. Returns the index of the target in targets the pointer is aiming at, the first one when several qualify.

pub fn rested_in(&self, now: Instant, targets: &[Rect]) -> Option<usize>

The target the pointer has come to rest in at now: still for SETTLE inside it, having arrived from outside it. A throw into a corner ends this way, with no slow sample to read.

pub fn settled(&self, now: Instant) -> bool

Whether the pointer is resting where it is: slow at its last sample, or silent for SETTLE since. Without motion seen, it is.

pub fn deadline(&self, now: Instant) -> Option<Instant>

When Self::settled next changes with no further input.

Trait Implementations

impl Clone for EdgeAim

fn clone(&self) -> EdgeAim

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EdgeAim

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

Formats the value using the given formatter.

impl Default for EdgeAim

fn default() -> EdgeAim

Returns the “default value” for a type.

impl PartialEq for EdgeAim

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for EdgeAim