gallery/vendor/i-slint-core/animations/simulations.rs
Greg Pomerantz 2f4768f354 Fix 120Hz scroll jank end-to-end: render-ahead present + full-cache eviction off the UI thread
Three root causes, all fixed and verified on the Pixel 9 Pro:

1. Present phase (backend + renderer): VSYNC_LOCKED_RENDER defers the
   render to the vsync wake; RENDER_AHEAD presents the previous frame at
   the start of render() (phase = wake + ~1.1 ms) and holds the new
   frame one slot. Crash fix: a held wgpu frame must be PRESENTED, never
   merely dropped, before the next acquire (AlreadyAcquired panic at
   launch otherwise); discard_pending_frame presents too.

2. Full-res prefetch churn (src/lib.rs): the 8-slot full cache cycled
   through a ~20-cell viewport forever (137 decodes/20 s) and each
   eviction free()'d a 50 MB Vec on the UI thread (20-52 ms CPU spikes,
   ~7/s = the residual SLOWEV NonMain jank). Fix: 60 s tombstone
   cooldown on evicted paths (idle prefetch skips, urgent tap bypasses)
   + off-thread reaper for the freed blobs (insert: 21 ms -> 4 us).

3. (earlier) Skia final flush + Mailbox present mode (vendor, M3).

Instrumentation (all behind --features perf): OTHR/INVK/INVK_TAG/FLCK
lines for cross-thread closure timing and push-site tagging.

Warm measured swipe, 8580-file grid: cadence median 8.33 ms (exact
120 Hz), p99 15.5 ms, 5/552 gaps >16.7 ms (0.9%, max 28.3 ms, zero
>33 ms); PRES phase median ~994 us, zero late frames. Docs updated
(docs/BUGS/scroll-jank-120hz.md, full scorecard + line reference).

Also: vendored i-slint-core + wgpu-hal (vkshim interposition patch),
vkshim profiling tooling, backend made a non-optional dep, debuggable
flag for simpleperf (REMOVE before shipping).
2026-10-30 02:49:23 -04:00

58 lines
1.7 KiB
Rust

// Copyright © SixtyFPS GmbH <info@slint.dev>
// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0
//! This module contains various physics simulations which can be used as animation (internally only yet).
//! Currently it is used in the flickable to animate the content position of the Flickable
//!
//! Currently it contains two simulations:
//! - `ConstantDeceleration`
//! - `ConstantDecelerationSpringDamper` with spring damper simulation when reaching the limit
pub mod constant_deceleration;
pub mod constant_deceleration_spring_damper;
pub mod spring;
use crate::animations::Instant;
/// The direction the simulation is running
#[derive(Debug)]
enum Direction {
/// The start value is smaller than the limit value
Increasing,
/// The start value is larger than the limit value
Decreasing,
}
/// Common simulation trait
/// All simulations must implement this trait
pub trait Simulation {
fn step(&mut self, current: &mut f32, new_tick: Instant) -> bool;
}
/// Trait to convert parameter objects into a simulation
/// All parameter objects must implement this trait!
pub trait Parameter {
type Output;
fn simulation(
self,
start_value: f32,
limit_value: core::pin::Pin<alloc::boxed::Box<crate::Property<f32>>>,
) -> Self::Output;
}
#[cfg(test)]
macro_rules! assert_approx_eq {
($a:expr, $b:expr) => {
assert!(($a - $b).abs() < 1e-4, "{} != {}", $a, $b);
};
}
#[cfg(test)]
pub(crate) use assert_approx_eq;
#[cfg(test)]
pub(crate) fn test_limit_property(
value: f32,
) -> core::pin::Pin<alloc::boxed::Box<crate::Property<f32>>> {
alloc::boxed::Box::pin(crate::Property::new(value))
}