SRL::Math::Interpolation Class Reference

Detailed Description

High-performance interpolation and easing library optimized for Saturn hardware.

The Interpolation class provides a comprehensive collection of interpolation and easing functions essential for smooth animations, camera movements, and procedural generation in games. All functions are implemented using fixed-point arithmetic to ensure consistent behavior across platforms and maximize performance on Saturn hardware.

Key features:

• Comprehensive set of interpolation methods (linear, cubic, Hermite, etc.)
• Extensive easing function library (sine, quad, cubic, elastic, bounce, etc.)
• Compile-time evaluation with constexpr for static animations
• No floating-point operations for consistent cross-platform behavior
• Optimized implementations for Saturn hardware
• Memory-efficient algorithms to minimize temporary allocations

Common applications:

• Animation blending and transitions
• Camera movement and smoothing
• UI element animations
• Procedural content generation
• Particle system parameter control
• Audio parameter modulation

Performance considerations:

• All functions use fixed-point arithmetic to avoid floating-point operations
• Higher-order interpolation methods (cubic, Hermite) are more computationally expensive than simpler methods (linear)
• Complex easing functions (elastic, bounce) require more calculations than basic functions (quad, cubic)
• When performance is critical, consider pre-computing interpolation values or using simpler interpolation methods

Implementation notes:

• Functions are designed to minimize temporary object creation
• Critical operations have specialized implementations for Saturn hardware
• Precision is carefully managed to prevent overflow/underflow in fixed-point math

See also

Fxp For details on the fixed-point implementation

Angle For angle interpolation functions

#include <interpolation.hpp>

Static Public Member Functions
static constexpr Fxp	BounceEaseIn (const Fxp &start, const Fxp &end, const Fxp &t)
	Bounce ease-in interpolation for reverse bouncing ball effect.
static constexpr Fxp	BounceEaseOut (const Fxp &start, const Fxp &end, const Fxp &t)
	Bounce ease-out interpolation for bouncing ball effect.
static constexpr Fxp	Clamp (const Fxp &value, const Fxp &min, const Fxp &max)
	Clamps a value between minimum and maximum bounds.
static constexpr Fxp	CubicEaseIn (const Fxp &start, const Fxp &end, const Fxp &t)
	Cubic ease-in interpolation for stronger acceleration.
static constexpr Fxp	CubicEaseOut (const Fxp &start, const Fxp &end, const Fxp &t)
	Cubic ease-out interpolation for stronger deceleration.
static constexpr Fxp	EaseIn (const Fxp &start, const Fxp &end, const Fxp &t)
	Quadratic ease-in interpolation for accelerating motion.
static constexpr Fxp	EaseOut (const Fxp &start, const Fxp &end, const Fxp &t)
	Quadratic ease-out interpolation for decelerating motion.
static constexpr Fxp	ElasticEaseIn (const Fxp &start, const Fxp &end, const Fxp &t)
	Elastic ease-in interpolation for spring-like motion.
static constexpr Fxp	Lerp (const Fxp &start, const Fxp &end, const Fxp &t)
	Linear interpolation between two fixed-point values.
static constexpr Fxp	Smoothstep (const Fxp &start, const Fxp &end, const Fxp &t)
	Smoothstep interpolation for smooth acceleration and deceleration.