Struct ClampingSimulation 

pub struct ClampingSimulation { /* private fields */ }

Android OverScroller’s friction fling, bounded by a scroll range.

The content decelerates along Android’s spline and stops dead at min or max — no overshoot, no bounce. This is the Clamp half of the pair, and the physics every Teksilo scrollable gets unless its theme or its owner asks for the other one.

use std::time::Duration;
use teksilo_core::kinetic::{ClampingSimulation, ScrollSimulation};
use teksilo_tokens::ScrollPhysicsTokens;

let tokens = ScrollPhysicsTokens::DEFAULT;
let sim = ClampingSimulation::new(0.0, 4000.0, -1.0e6, 1.0e6, &tokens);
// Android's getSplineFlingDistance(4000) — see the tests for the arithmetic.
assert!((sim.position(sim.duration()) - 2156.95).abs() < 1.0);
assert!(sim.is_done(sim.duration()));

Implementations

impl ClampingSimulation

pub fn new( position: f32, velocity: f32, min: f32, max: f32, tokens: &ScrollPhysicsTokens, ) -> Self

A fling released at position with velocity, confined to [min, max].

Pass a very wide range for an unbounded coast — that is what FlingDriver does, since the widget receiving the re-dispatched deltas owns the real bounds.

pub fn duration(&self) -> Duration

How long the fling runs before the spline itself is spent. The simulation may finish earlier by hitting a bound.

pub fn distance(&self) -> f32

The signed distance the spline covers over its whole duration.

Trait Implementations

impl Clone for ClampingSimulation

fn clone(&self) -> ClampingSimulation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClampingSimulation

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

Formats the value using the given formatter.

impl ScrollSimulation for ClampingSimulation

fn position(&self, t: Duration) -> f32

Where the content is at t, in logical pixels.

fn velocity(&self, t: Duration) -> f32

How fast the content is moving at t, in logical pixels per second.

fn is_done(&self, t: Duration) -> bool

Whether the content has come to rest at or before t.