ping_pong()

template<typename T >

T MayaFlux::Kinesis::ping_pong ( T  x, T  lo, T  hi  )

inlinenoexcept

Ping-pong (triangle wave): fold x back and forth in [lo, hi].

At x = lo the value is lo. It increases to hi then folds back toward lo. Period is 2 * (hi - lo). Use for oscillating parameters, bounce animations, or any signal that should reverse at the boundary instead of wrapping.

Example: ping_pong(1.3F, 0.F, 1.F) -> 0.7F

Definition at line 153 of file Scalar.hpp.

{
    const T range = hi - lo;
    if (range <= T { 0 })
        return lo;
    const T shifted = x - lo;
    const T period = T { 2 } * range;
    const T t = shifted - period * std::floor(shifted / period);
    return lo + (t < range ? t : period - t);
}