/* * ============================================================ * FILE: physics.h * * PURPOSE: Public interface for generic physical motion: a `Body` that * falls, moves, lands on floors, slides along walls and bumps its * head on ceilings. It knows nothing about players or controllers, * so enemies and objects can reuse it later. * * FITS IN: player.c owns a Body, sets its horizontal velocity from input, * then calls physics_step() once per tick. physics.c asks world.h * about floors, ceilings, overlapping boxes and the bounds. * * INTERFACE: Use these exact names: * * typedef struct Body { * Vec3 pos; position of the body's FEET (bottom center), meters * Vec3 vel; velocity, meters/second * bool on_ground; true if the body ended the last step standing on * something (the ground or a platform top) * float half_width; collision box half-size in x and z, meters * float height; collision box height above the feet, meters * float gravity_scale; multiplier on GRAVITY (1 = normal). The owner can * set 0 to take over vertical motion itself (the * player does while clinging to a wall). * bool hit_wall; true if the last step pushed the body out of a box's * SIDE (not a top or bottom) * Vec3 wall_normal; that side's outward normal (+-x or +-z, y = 0); * only meaningful if hit_wall * Box wall; the box that side belongs to; only meaningful if hit_wall * int ground_box; index (world_box) of the box the body stands on, or -1 * for the ground / in the air. Used to ride moving boxes. * } Body; * * void physics_step(Body *b, float dt); * * Include , "math3d.h" and "world.h" (for Box). * * CONVENTIONS: Include guard: PHYSICS_H. The collision shape is an axis-aligned * box that does not rotate (a spinning box would snag on walls). * * NOT IN SCOPE: Rigid bodies, rotation, mass, forces/impulses API, collision * between bodies, keeping a moving box's momentum after leaving it. * * DONE WHEN: player.c can move, land, and collide using only Body + physics_step. * ============================================================ */ #ifndef PHYSICS_H #define PHYSICS_H #include #include "math3d.h" #include "world.h" typedef struct Body { Vec3 pos; /* position of the body's FEET (bottom center), meters */ Vec3 vel; /* velocity, meters/second */ bool on_ground; /* true if the body ended the last step standing on something */ float half_width; /* collision box half-size in x and z, meters */ float height; /* collision box height above the feet, meters */ float gravity_scale; /* multiplier on GRAVITY; 1 = normal, 0 = the owner drives vel.y itself */ bool hit_wall; /* the last step pushed the body out of a box's side */ Vec3 wall_normal; /* that side's outward normal (+-x or +-z); only if hit_wall */ Box wall; /* the box that side belongs to; only if hit_wall */ int ground_box; /* world_box index stood on (-1 = ground or airborne); for riding moving boxes */ } Body; void physics_step(Body *b, float dt); #endif /* PHYSICS_H */