Banjo API 1.1.0-alpha
Low-level C99 game development API
Loading...
Searching...
No Matches
math.h
Go to the documentation of this file.
1
53#ifndef BJ_MATH_H
54#define BJ_MATH_H
55
56#include <math.h>
57#include <float.h>
58
63
64#if defined(BJ_API_LONG_DOUBLE)
66 typedef long double bj_real;
68 #define BJ_F(x) x##L
70 #define BJ_EPSILON (LDBL_EPSILON)
71#elif defined(BJ_API_FLOAT64)
73 typedef double bj_real;
75 #define BJ_F(x) x
77 #define BJ_EPSILON (DBL_EPSILON)
78#else
80 typedef float bj_real;
82 #define BJ_F(x) x##f
84 #define BJ_EPSILON (FLT_EPSILON)
85#endif
86
90#define BJ_FI(x) BJ_F(1.0) / BJ_F(x)
91
93#define BJ_FZERO (BJ_F(0.0))
94
96
101
103#define BJ_PI_F (3.14159265358979323846f)
105#define BJ_TAU_F (6.28318530717958647692f)
107#define BJ_PI_D (3.14159265358979323846264338327950288)
109#define BJ_TAU_D (6.28318530717958647692528676655900576)
111#define BJ_PI_L (3.141592653589793238462643383279502884L)
113#define BJ_TAU_L (6.283185307179586476925286766559005768L)
115#define BJ_PI (BJ_F(3.141592653589793238462643383279502884))
117#define BJ_TAU (BJ_F(6.283185307179586476925286766559005768))
118
120
126
127#define bj_absf fabsf
128#define bj_acosf acosf
129#define bj_atan2f atan2f
130#define bj_copysignf copysignf
131#define bj_cosf cosf
132#define bj_expf expf
133#define bj_floorf floorf
134#define bj_fmodf fmodf
135#define bj_logf logf
136#define bj_maxf fmaxf
137#define bj_minf fminf
138#define bj_powf powf
139#define bj_roundf roundf
140#define bj_sinf sinf
141#define bj_sqrtf sqrtf
142#define bj_tanf tanf
143
145
151
152#define bj_absd fabs
153#define bj_acosd acos
154#define bj_atan2d atan2
155#define bj_copysignd copysign
156#define bj_cosd cos
157#define bj_expd exp
158#define bj_floord floor
159#define bj_fmodd fmod
160#define bj_logd log
161#define bj_maxd fmax
162#define bj_mind fmin
163#define bj_powd pow
164#define bj_roundd round
165#define bj_sind sin
166#define bj_sqrtd sqrt
167#define bj_tand tan
168
170
176
177#define bj_absl fabsl
178#define bj_acosl acosl
179#define bj_atan2l atan2l
180#define bj_copysignl copysignl
181#define bj_cosl cosl
182#define bj_expl expl
183#define bj_floorl floorl
184#define bj_fmodl fmodl
185#define bj_logl logl
186#define bj_maxl fmaxl
187#define bj_minl fminl
188#define bj_powl powl
189#define bj_roundl roundl
190#define bj_sinl sinl
191#define bj_sqrtl sqrtl
192#define bj_tanl tanl
193
195
201
202#if defined(BJ_API_LONG_DOUBLE)
203 #define bj_abs bj_absl
204 #define bj_acos bj_acosl
205 #define bj_atan2 bj_atan2l
206 #define bj_copysign bj_copysignl
207 #define bj_cos bj_cosl
208 #define bj_exp bj_expl
209 #define bj_floor bj_floorl
210 #define bj_fmod bj_fmodl
211 #define bj_log bj_logl
212 #define bj_max bj_maxl
213 #define bj_min bj_minl
214 #define bj_pow bj_powl
215 #define bj_round bj_roundl
216 #define bj_sin bj_sinl
217 #define bj_sqrt bj_sqrtl
218 #define bj_tan bj_tanl
219#elif defined(BJ_API_FLOAT64)
220 #define bj_abs bj_absd
221 #define bj_acos bj_acosd
222 #define bj_atan2 bj_atan2d
223 #define bj_copysign bj_copysignd
224 #define bj_cos bj_cosd
225 #define bj_exp bj_expd
226 #define bj_floor bj_floord
227 #define bj_fmod bj_fmodd
228 #define bj_log bj_logd
229 #define bj_max bj_maxd
230 #define bj_min bj_mind
231 #define bj_pow bj_powd
232 #define bj_round bj_roundd
233 #define bj_sin bj_sind
234 #define bj_sqrt bj_sqrtd
235 #define bj_tan bj_tand
236#else
237 #define bj_abs bj_absf
238 #define bj_acos bj_acosf
239 #define bj_atan2 bj_atan2f
240 #define bj_copysign bj_copysignf
241 #define bj_cos bj_cosf
242 #define bj_exp bj_expf
243 #define bj_floor bj_floorf
244 #define bj_fmod bj_fmodf
245 #define bj_log bj_logf
246 #define bj_max bj_maxf
247 #define bj_min bj_minf
248 #define bj_pow bj_powf
249 #define bj_round bj_roundf
250 #define bj_sin bj_sinf
251 #define bj_sqrt bj_sqrtf
252 #define bj_tan bj_tanf
253#endif
254
256
262
270static inline bj_real bj_clamp(bj_real x, bj_real lo, bj_real hi) {
271 return (x < lo) ? lo : (x > hi) ? hi : x;
272}
273
280static inline bj_real bj_step(bj_real edge, bj_real x) {
281 return (x < edge) ? BJ_FZERO : BJ_F(1.0);
282}
283
291static inline bj_real bj_smoothstep(bj_real e0, bj_real e1, bj_real x) {
292 bj_real t = (x - e0) / (e1 - e0);
293 t = (t < BJ_FZERO) ? BJ_FZERO : (t > BJ_F(1.0)) ? BJ_F(1.0) : t;
294 return t * t * (BJ_F(3.0) - BJ_F(2.0) * t);
295}
296
302static inline bj_real bj_fract(bj_real x) {
303 return x - bj_floor(x);
304}
305
313static inline bj_real bj_mod(bj_real x, bj_real y) {
314 bj_real m = bj_fmod(x, y);
315 if (m < BJ_FZERO) m += (y < BJ_FZERO) ? -y : y;
316 return m;
317}
318
320
339
346static inline int bj_real_eq (bj_real a, bj_real b) { return bj_abs(a - b) <= BJ_EPSILON; }
347
354static inline int bj_real_neq(bj_real a, bj_real b) { return !bj_real_eq(a, b); }
355
362static inline int bj_real_lt (bj_real a, bj_real b) { return (b - a) > BJ_EPSILON; }
363
370static inline int bj_real_gt (bj_real a, bj_real b) { return (a - b) > BJ_EPSILON; }
371
378static inline int bj_real_lte(bj_real a, bj_real b) { return !bj_real_gt(a, b); }
379
386static inline int bj_real_gte(bj_real a, bj_real b) { return !bj_real_lt(a, b); }
387
394static inline int bj_real_cmp(bj_real a, bj_real b) { return bj_real_lt(a,b) ? -1 : (bj_real_gt(a,b) ? 1 : 0); }
395
397
403
411 return bj_max(BJ_F(1.0), bj_max(bj_abs(a), bj_abs(b)));
412}
413
420static inline int bj_real_eq_rel (bj_real a, bj_real b) { bj_real s = bj_real_relative_scale(a,b); return bj_abs(a - b) <= (BJ_EPSILON * s); }
421
428static inline int bj_real_neq_rel(bj_real a, bj_real b) { return !bj_real_eq_rel(a, b); }
429
436static inline int bj_real_lt_rel (bj_real a, bj_real b) { bj_real s = bj_real_relative_scale(a,b); return (b - a) > (BJ_EPSILON * s); }
437
444static inline int bj_real_gt_rel (bj_real a, bj_real b) { bj_real s = bj_real_relative_scale(a,b); return (a - b) > (BJ_EPSILON * s); }
445
452static inline int bj_real_lte_rel(bj_real a, bj_real b) { return !bj_real_gt_rel(a, b); }
453
460static inline int bj_real_gte_rel(bj_real a, bj_real b) { return !bj_real_lt_rel(a, b); }
461
468static inline int bj_real_cmp_rel(bj_real a, bj_real b) { return bj_real_lt_rel(a,b) ? -1 : (bj_real_gt_rel(a,b) ? 1 : 0); }
469
471
477
483static inline int bj_real_is_zero(bj_real x) { return bj_abs(x) <= BJ_EPSILON; }
484
491static inline int bj_real_is_zero_scaled(bj_real x, bj_real scale) {
492 bj_real s = bj_max(BJ_F(1.0), bj_abs(scale));
493 return bj_abs(x) <= (BJ_EPSILON * s);
494}
495
501static inline bj_real bj_real_snap_zero(bj_real x) { return bj_real_is_zero(x) ? BJ_FZERO : x; }
502
509static inline bj_real bj_real_snorm_safe(bj_real x, bj_real len) { return bj_real_is_zero(len) ? BJ_FZERO : (x / len); }
510
512
516
517#endif /* BJ_MATH_H */
#define bj_floor
Floor.
Definition math.h:243
static int bj_real_gt_rel(bj_real a, bj_real b)
a > b by more than relative epsilon.
Definition math.h:444
static int bj_real_lte_rel(bj_real a, bj_real b)
a <= b within relative epsilon.
Definition math.h:452
static int bj_real_cmp_rel(bj_real a, bj_real b)
Three-way compare using relative epsilon.
Definition math.h:468
static bj_real bj_smoothstep(bj_real e0, bj_real e1, bj_real x)
Smooth Hermite step between e0 and e1.
Definition math.h:291
static bj_real bj_real_relative_scale(bj_real a, bj_real b)
Internal scale helper max(1, |a|, |b|).
Definition math.h:410
static int bj_real_eq_rel(bj_real a, bj_real b)
Equality within relative epsilon.
Definition math.h:420
static int bj_real_cmp(bj_real a, bj_real b)
Three-way compare using absolute epsilon.
Definition math.h:394
static int bj_real_neq_rel(bj_real a, bj_real b)
Inequality within relative epsilon.
Definition math.h:428
static int bj_real_gt(bj_real a, bj_real b)
a > b by more than absolute epsilon.
Definition math.h:370
static bj_real bj_clamp(bj_real x, bj_real lo, bj_real hi)
Clamp x to the closed interval [lo, hi].
Definition math.h:270
static bj_real bj_real_snorm_safe(bj_real x, bj_real len)
Safe scalar normalization.
Definition math.h:509
static int bj_real_lt(bj_real a, bj_real b)
a < b by more than absolute epsilon.
Definition math.h:362
#define BJ_FZERO
Zero constant in bj_real.
Definition math.h:93
#define bj_abs
Absolute value.
Definition math.h:237
static bj_real bj_fract(bj_real x)
Fractional part of x.
Definition math.h:302
static int bj_real_is_zero(bj_real x)
Absolute-zero test.
Definition math.h:483
static int bj_real_gte_rel(bj_real a, bj_real b)
a >= b within relative epsilon.
Definition math.h:460
#define bj_fmod
Floating modulus.
Definition math.h:244
static int bj_real_is_zero_scaled(bj_real x, bj_real scale)
Scaled zero test using max(1, |scale|).
Definition math.h:491
static int bj_real_neq(bj_real a, bj_real b)
Inequality within absolute epsilon.
Definition math.h:354
static bj_real bj_mod(bj_real x, bj_real y)
Positive modulus with non-negative result magnitude.
Definition math.h:313
static bj_real bj_step(bj_real edge, bj_real x)
Step function.
Definition math.h:280
static int bj_real_gte(bj_real a, bj_real b)
a >= b within absolute epsilon.
Definition math.h:386
#define BJ_EPSILON
Machine epsilon for bj_real when float is selected.
Definition math.h:84
static bj_real bj_real_snap_zero(bj_real x)
Snap to exact zero under absolute epsilon.
Definition math.h:501
#define BJ_F(x)
Literal suffix helper for bj_real when float is selected.
Definition math.h:82
static int bj_real_lt_rel(bj_real a, bj_real b)
a < b by more than relative epsilon.
Definition math.h:436
static int bj_real_lte(bj_real a, bj_real b)
a <= b within absolute epsilon.
Definition math.h:378
float bj_real
Selected real type for float configuration.
Definition math.h:80
#define bj_max
Maximum of two floats.
Definition math.h:246
static int bj_real_eq(bj_real a, bj_real b)
Equality within absolute epsilon.
Definition math.h:346
C99 math shim with bj_real precision type and scalar utilities.