diff options
Diffstat (limited to '')
| -rw-r--r-- | platformer/src/physics.c | 82 |
1 files changed, 82 insertions, 0 deletions
diff --git a/platformer/src/physics.c b/platformer/src/physics.c new file mode 100644 index 0000000..b04a78e --- /dev/null +++ b/platformer/src/physics.c @@ -0,0 +1,82 @@ +/* + * ============================================================ + * FILE: physics.c + * + * PURPOSE: Moves a Body forward one fixed tick: gravity, integration, + * landing on the ground, and staying inside the world. + * + * FITS IN: Implements physics.h. Called by player.c inside player_update(), + * AFTER the player has chosen its velocity for this tick. Uses + * world_ground_height() and world_clamp_to_bounds() from world.h. + * + * IMPLEMENT physics_step(b, dt), in this order: + * 1. Gravity: if !b->on_ground, vel.y -= GRAVITY * dt, then clamp vel.y to + * no lower than -TERMINAL_VELOCITY. + * (When on the ground, vel.y is left alone. A jump sets it positive + * before this call, and that's what lifts the body off the ground.) + * 2. Integrate (semi-implicit Euler: velocity was updated first, then position): + * pos += vel * dt + * Add a comment explaining why this order is stable enough for a + * fixed timestep. + * 3. Ground: ground = world_ground_height(pos.x, pos.z). + * if pos.y <= ground: pos.y = ground; if vel.y < 0, vel.y = 0; + * on_ground = true + * else: on_ground = false + * Note: on_ground must become false the moment a jump lifts the body, + * and walking off a ledge will also set it false once terrain exists. + * 4. Bounds: pos = world_clamp_to_bounds(pos). If x or z got clamped, + * zero that velocity component so the body doesn't "stick" against + * the edge while pushing into it. + * + * CONVENTIONS: dt is always TICK_DT in practice, but use the parameter rather + * than the constant so the function stays general. + * + * NOT IN SCOPE: Friction/acceleration (that's player movement *intent*, in + * player.c), wall/ceiling collision, slopes, sub-stepping. + * + * DONE WHEN: A body placed at y = 10 falls, speeds up, lands exactly on + * y = 0 with on_ground = true, and stays there. + * ============================================================ + */ + +#include "config.h" +#include "physics.h" +#include "world.h" + +void physics_step(Body *b, float dt) +{ + /* 1. Gravity. On the ground vel.y is left alone: a jump sets it positive + * before this call, and that's what lifts the body off the ground. */ + if (!b->on_ground) { + b->vel.y -= GRAVITY * dt; + if (b->vel.y < -TERMINAL_VELOCITY) + b->vel.y = -TERMINAL_VELOCITY; + } + + /* 2. Integrate with semi-implicit Euler: velocity was updated above, and + * position now moves with that NEW velocity. Unlike plain Euler (which + * uses the old velocity) this doesn't gain energy over time, and with a + * fixed dt the result is identical every run, so a jump always + * reaches the same height. */ + b->pos = vec3_add(b->pos, vec3_scale(b->vel, dt)); + + /* 3. Ground. Landing snaps the feet to the surface and kills the downward + * speed. on_ground goes false the moment a jump lifts the body (and, + * once terrain exists, when walking off a ledge). */ + float ground = world_ground_height(b->pos.x, b->pos.z); + if (b->pos.y <= ground) { + b->pos.y = ground; + if (b->vel.y < 0.0f) + b->vel.y = 0.0f; + b->on_ground = true; + } else { + b->on_ground = false; + } + + /* 4. Bounds. Zero the velocity into an edge we got clamped against, so + * the body doesn't "stick" to it while pushing into it. */ + Vec3 clamped = world_clamp_to_bounds(b->pos); + if (clamped.x != b->pos.x) b->vel.x = 0.0f; + if (clamped.z != b->pos.z) b->vel.z = 0.0f; + b->pos = clamped; +} |
