Struct Clamping 

pub struct Clamping { /* private fields */ }

Android’s scroll feel — Flutter’s ClampingScrollPhysics: a drag never leaves the range (the excess is rejected outright, for the surface to show as a stretch or a glow instead), and a release runs Android’s own SplineOverScroller deceleration to a hard stop.

See the module docs for why nothing here clamps that curve itself.

Implementations

impl Clamping

pub fn new() -> Clamping

A standalone clamping physics (no chained parent).

pub fn chain(self, parent: impl ScrollPhysics + 'static) -> Clamping

Chain parent behind this physics, the module-wide composition convention (ScrollPhysics’ Chaining).

Trait Implementations

impl Debug for Clamping

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

Formats the value using the given formatter.

impl Default for Clamping

fn default() -> Clamping

Returns the “default value” for a type.

impl ScrollPhysics for Clamping

fn apply_boundary_conditions(&self, metrics: &ScrollMetrics, value: f64) -> f64

The whole of any past-extent excess is rejected, so the position itself never leaves [min, max]. The caller still learns how far the proposal went — that rejected distance is what a stretch or glow effect reads (this module’s parent’s design ruling).

fn create_ballistic_simulation( &self, metrics: &ScrollMetrics, velocity: f64, ) -> Option<Box<dyn Simulation>>

Android’s fling curve for a release with room to travel, and — as a safety arm this physics’ own boundary rule makes unreachable — a spring back to the nearest extent for a position that starts out of range.

fn parent(&self) -> Option<&dyn ScrollPhysics>

The chained parent physics, if this one was built via chain(...). None for a physics built standalone (the chain’s root).

fn apply_physics_to_user_offset( &self, metrics: &ScrollMetrics, offset: f64, ) -> f64

Map a raw user drag delta (finger px, signed in the content’s own direction) to the delta actually applied to the position. Must not alter the in-bounds portion of a drag — only a physics with an out-of-bounds opinion (e.g. added resistance) touches this.

fn should_accept_user_offset(&self, metrics: &ScrollMetrics) -> bool

Whether a user drag is allowed to move the position at all.

fn carried_momentum(&self, existing_velocity: f64) -> f64

Momentum (px/s) to add onto a new fling’s initial velocity when motion is already live (a re-fling mid-animation carries some of the old velocity forward rather than starting cold).

fn min_fling_velocity(&self) -> f64

The minimum release speed that starts a fling.

fn max_fling_velocity(&self) -> f64

The fastest fling speed this physics honors.

fn tolerance_for(&self, metrics: &ScrollMetrics) -> Tolerance

The velocity/distance tolerance a ballistic simulation settles within.

fn spring(&self) -> SpringDescription

The spring a bounce-back/snap simulation is built from.