retroglyph-core 0.4.0

A 2D pseudographic terminal library -- core types, no backend
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

//! Time-driven value animation: [`Easing`] curves, a stateful, retargetable [`Tween`], and a
//! periodic [`oscillate`] helper.
//!
//! [`FrameClock`](crate::FrameClock) answers "how many fixed logic steps has this frame's elapsed
//! time earned"; this module answers a different question: "what's this one `f32` value right
//! now, partway through animating from A to B" (or, for [`oscillate`], partway through an
//! ongoing wave with no start or end). Two tools for two different shapes of motion:
//!
//! - [`Tween`]: a finite transition from one value to another over a fixed duration, reshaped
//!   by an [`Easing`] curve. Use it for things that start, run once, and stop: a fade-in, a
//!   value settling toward a new target.
//! - [`oscillate`]: a continuous periodic wave with no start or end. Use it for things that
//!   just keep going: a pulsing indicator, a breathing effect, the demo signal in gallery example
//!   11.
//!
//! Both follow the same explicit, app-owned state convention as
//! [`ListState`](https://docs.rs/retroglyph-widgets/latest/retroglyph_widgets/struct.ListState.html)
//! and [`Interaction`](https://docs.rs/retroglyph-widgets/latest/retroglyph_widgets/struct.Interaction.html):
//! a plain struct the caller constructs and stores itself, updated once per frame with
//! [`Frame::delta`](crate::Frame::delta), rather than a hidden global animation manager keyed by
//! an id the way egui's `Context::animate_value` works. One [`Tween`] animates one `f32`; an app
//! with several needs several `Tween`s, the same as it needs several `ListState`s for several
//! lists.
//!
//! Split across `easing.rs`/`tween.rs`/`oscillate.rs` (this file just re-exports), one file per
//! concept, since `Tween` builds directly on `Easing` and `oscillate` is a standalone helper.

mod easing;
mod oscillate;
mod tween;

pub use easing::Easing;
pub use oscillate::oscillate;
pub use tween::Tween;