diff options
| author | Schark <jordan@schark.online> | 2026-09-23 23:09:55 -0400 |
|---|---|---|
| committer | Schark <jordan@schark.online> | 2026-09-23 23:09:55 -0400 |
| commit | dab65412376d1b73381446f969c1461c24169811 (patch) | |
| tree | 27adfec438a9bd9f3c96a740ab54016df5f68b80 /platformer/src/math3d.h | |
| parent | af03f388cbcff795158ea8345b5c876470229e8b (diff) | |
| download | gamedev-dab65412376d1b73381446f969c1461c24169811.tar.gz gamedev-dab65412376d1b73381446f969c1461c24169811.zip | |
Base prompts
Diffstat (limited to '')
| -rw-r--r-- | platformer/src/math3d.h | 77 |
1 files changed, 77 insertions, 0 deletions
diff --git a/platformer/src/math3d.h b/platformer/src/math3d.h new file mode 100644 index 0000000..316e418 --- /dev/null +++ b/platformer/src/math3d.h @@ -0,0 +1,77 @@ +/* + * ============================================================ + * FILE: math3d.h + * + * PURPOSE: The small amount of vector/matrix math the game needs, written + * by hand so we don't pull in a math library. + * + * FITS IN: Header-only (every function is `static inline`). Included by + * any file that does math. Depends only on <math.h>. + * + * INTERFACE: Use these exact names: + * + * Constants + * M3D_PI 3.14159265358979f (C99 doesn't guarantee M_PI) + * + * Types (plain structs, passed and returned BY VALUE since they're small) + * typedef struct { float x, y; } Vec2; + * typedef struct { float x, y, z; } Vec3; + * typedef struct { float m[16]; } Mat4; COLUMN-MAJOR, element (row r, + * col c) is m[c*4 + r], so it can + * go straight to glUniformMatrix4fv + * with transpose = GL_FALSE. + * + * Scalar helpers + * float clampf(float v, float lo, float hi); + * float approachf(float current, float target, float max_step); + * moves current toward target by at most max_step, never overshoots. + * (Used for acceleration/friction.) + * float wrap_angle(float a); + * returns a in (-PI, PI]. + * float approach_angle(float current, float target, float max_step); + * like approachf but takes the SHORT way around the circle. + * (Used for turning the player.) + * + * Vec2 + * Vec2 vec2_make(float x, float y); + * float vec2_length(Vec2 v); + * + * Vec3 + * Vec3 vec3_make(float x, float y, float z); + * Vec3 vec3_add(Vec3 a, Vec3 b); + * Vec3 vec3_sub(Vec3 a, Vec3 b); + * Vec3 vec3_scale(Vec3 v, float s); + * float vec3_dot(Vec3 a, Vec3 b); + * Vec3 vec3_cross(Vec3 a, Vec3 b); + * float vec3_length(Vec3 v); + * Vec3 vec3_normalize(Vec3 v); returns (0,0,0) for zero-length input + * Vec3 vec3_lerp(Vec3 a, Vec3 b, float t); + * + * Mat4 + * Mat4 mat4_identity(void); + * Mat4 mat4_mul(Mat4 a, Mat4 b); result = a * b (b is applied first) + * Mat4 mat4_translate(Vec3 t); + * Mat4 mat4_scale(Vec3 s); + * Mat4 mat4_rotate_y(float angle); rotates +Z toward +X, i.e. + * (0,0,1) -> (sin a, 0, cos a) + * Mat4 mat4_perspective(float fovy_rad, float aspect, float near, float far); + * standard OpenGL (gluPerspective) form + * Mat4 mat4_look_at(Vec3 eye, Vec3 target, Vec3 up); + * standard OpenGL (gluLookAt) form + * + * CONVENTIONS: Right-handed, Y up. Radians everywhere. Keep each function a + * few lines with a short comment; this is a learning resource. + * Include guard: MATH3D_H. + * + * NOT IN SCOPE: Quaternions, matrix inverse, SIMD, Vec4, generic N-dim math. + * Add a function only when a caller needs it. + * + * DONE WHEN: All functions above compile cleanly under -std=c99 -Wall + * -Wextra, and mat4_perspective * mat4_look_at produces a + * correct view of the ground grid in render.c. + * ============================================================ + */ +#ifndef MATH3D_H +#define MATH3D_H + +#endif /* MATH3D_H */ |
