From dab65412376d1b73381446f969c1461c24169811 Mon Sep 17 00:00:00 2001 From: Schark Date: Wed, 23 Sep 2026 23:09:55 -0400 Subject: Base prompts --- platformer/src/math3d.h | 77 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 77 insertions(+) create mode 100644 platformer/src/math3d.h (limited to 'platformer/src/math3d.h') 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 . + * + * 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 */ -- cgit v1.2.3-18-g5258