Struct Dwell 

pub struct Dwell { /* private fields */ }

How long a transient card has been up for someone to read, which is what its lifetime counts against. The clock runs only while the card is on screen and nobody holds it (the pointer on it, keyboard focus in it): a card that never fit on screen, or one being read, never runs out under the reader. The desktop’s notification banners keep it.

Implementations

impl Dwell

pub const fn new() -> Dwell

A card nobody has seen yet: nothing spent, the clock stopped.

pub fn spent(&self, now: Instant) -> Duration

Time the card has been readable on screen at now.

pub fn left(&self, lifetime: Duration, now: Instant) -> Duration

pub fn is_over(&self, lifetime: Duration, now: Instant) -> bool

Whether a lifetime has run out at now.

pub fn present(&mut self, now: Instant, on_screen: bool, held: bool)

Say whether the card is on_screen and whether someone held it at now. The clock runs exactly while it is on screen and unheld.

pub fn spend(&mut self, elapsed: Duration)

Count elapsed against the card, for a host that advances by frame deltas rather than reading a clock.

pub fn grant(&mut self, lifetime: Duration, now: Instant, floor: Duration)

Leave at least floor of a lifetime at now: a card the person just let go of gets a moment before it starts to leave, instead of fading the instant the pointer moves off it.

pub fn ends_at(&self, lifetime: Duration) -> Option<Instant>

When a lifetime runs out while the clock keeps running; None while it is stopped.

pub fn first_shown(&self) -> Option<Instant>

When the card first came on screen; None before it has.

pub fn is_running(&self) -> bool

Trait Implementations

impl Clone for Dwell

fn clone(&self) -> Dwell

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Dwell

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

Formats the value using the given formatter.

impl Default for Dwell

fn default() -> Dwell

Returns the “default value” for a type.

impl PartialEq for Dwell

fn eq(&self, other: &Dwell) -> 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 Copy for Dwell

impl Eq for Dwell

impl StructuralPartialEq for Dwell