Enum TouchPhase 

pub enum TouchPhase {
    Began,
    Moved,
    Ended,
    Cancelled,
}

Input vocabulary, defined in crcbl_core::input and re-exported so a consumer of the event stream needs one use rather than two.

See the crate docs for why these live in crcbl-core. Where a ContactId is in its gesture.

A touchscreen has no “hover”: a contact exists from the moment it lands until the moment it goes away, so this is the lifecycle rather than a button state — which is why touch does not reuse ButtonState.

Variants

Began

The finger landed. The first event any ContactId gets.

Moved

It moved while down.

Ended

The user lifted it. The gesture completed, and a consumer commits whatever it meant — a tap fires, a stick centres, a drag lands where it was let go.

Cancelled

The system took the gesture away: the OS claimed it for an edge swipe, palm rejection changed its mind, the window lost focus, the browser decided the page was scrolling after all.

Not an Ended, and a consumer that treats it as one fires actions the user did not ask for. The position it carries is the last one the platform knew, not a place anyone chose, so the answer is to undo the interaction rather than complete it — the drag goes back, the tap does not fire, the stick centres without the character having lunged. What both share is that the contact is over: the id is gone either way, and a consumer that ignores this one is left holding a finger that will never move again.

Implementations

impl TouchPhase

pub const fn ends_contact(self) -> bool

Whether this phase ends the contact — Ended or Cancelled.

The test anything tracking live contacts writes; it is the reason they differ that the two variants exist for, not the fact that they both stop.

pub const fn as_str(self) -> &'static str

A short, stable name for logs and test assertions.

Trait Implementations

impl Clone for TouchPhase

fn clone(&self) -> TouchPhase

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for TouchPhase

impl Debug for TouchPhase

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

Formats the value using the given formatter.

impl Display for TouchPhase

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

Formats the value using the given formatter.

impl Eq for TouchPhase

impl Hash for TouchPhase

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for TouchPhase

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for TouchPhase