math.h

Go to the documentation of this file.

 
#ifndef OPENSNES_MATH_H
#define OPENSNES_MATH_H
 
#include <snes/types.h>
 
/*============================================================================
 * Fixed-Point Type and Macros
 *============================================================================*/

typedef s16 fixed;

#define FIX(x) ((fixed)((x) << 8))

#define UNFIX(x) ((s16)((x) >> 8))

#define UNFIX_ROUND(x) ((s16)(((x) + 128) >> 8))

#define FIX_FRAC(x) ((u8)((x) & 0xFF))

#define FIX_MAKE(i, f) ((fixed)(((i) << 8) | (f)))
 
/*============================================================================
 * Fixed-Point Arithmetic
 *============================================================================*/

fixed fixMul(fixed a, fixed b);

fixed fixDiv(fixed a, fixed b);
 
/*============================================================================
 * Trigonometry (Lookup Tables)
 *============================================================================*/

extern const s16 sine_table[256];
 
inline fixed fixSin(u8 angle) {
    return sine_table[angle];
}

inline fixed fixCos(u8 angle) {
    /* cos(x) = sin(x + 90°) = sin(x + 64) */
    return sine_table[(u8)(angle + 64)];
}
 
/*============================================================================
 * Integer Math (Safe Alternatives)
 *============================================================================*/

u16 mul16(u16 a, u16 b);

u16 div16(u16 dividend, u16 divisor);

u16 mod16(u16 dividend, u16 divisor);
 
/*============================================================================
 * Utility Functions
 *============================================================================*/

fixed fixAbs(fixed x);

fixed fixClamp(fixed x, fixed min, fixed max);

fixed fixLerp(fixed a, fixed b, u8 t);
 
/*============================================================================
 * Square Root and Inverse Trigonometry
 *============================================================================*/

u16 sqrt16(u16 n);

fixed fixSqrt(fixed x);

u8 atan2_8(s16 dy, s16 dx);
 
/*============================================================================
 * Easing Curves (B6 final, 2026-05-22)
 *============================================================================*/

extern const u8 ease_quad_table[256];

inline u8 ease_in_quad(u8 t) {
    return ease_quad_table[t];
}

inline u8 ease_out_quad(u8 t) {
    return 255 - ease_quad_table[255 - t];
}
 
#endif /* OPENSNES_MATH_H */