summaryrefslogtreecommitdiff
path: root/platformer/src/render.c
diff options
context:
space:
mode:
authorSchark <jordan@schark.online>2026-09-23 23:09:55 -0400
committerSchark <jordan@schark.online>2026-09-23 23:09:55 -0400
commitdab65412376d1b73381446f969c1461c24169811 (patch)
tree27adfec438a9bd9f3c96a740ab54016df5f68b80 /platformer/src/render.c
parentaf03f388cbcff795158ea8345b5c876470229e8b (diff)
downloadgamedev-dab65412376d1b73381446f969c1461c24169811.tar.gz
gamedev-dab65412376d1b73381446f969c1461c24169811.zip
Base prompts
Diffstat (limited to '')
-rw-r--r--platformer/src/render.c65
1 files changed, 65 insertions, 0 deletions
diff --git a/platformer/src/render.c b/platformer/src/render.c
new file mode 100644
index 0000000..a326b15
--- /dev/null
+++ b/platformer/src/render.c
@@ -0,0 +1,65 @@
+/*
+ * ============================================================
+ * FILE: render.c
+ *
+ * PURPOSE: Draws the whole scene with modern OpenGL 3.3 core and as little
+ * code as possible: a ground grid, the player as a box, and the
+ * player's drop shadow.
+ *
+ * FITS IN: Implements render.h. Reads Camera (camera.h), Player (player.h)
+ * and world_half_extent()/world_ground_height() (world.h). Uses the
+ * GL functions that window.c loaded through GLEW.
+ *
+ * IMPLEMENT:
+ * - ONE shader program, source written as string literals in this file
+ * (no shader files to load):
+ * vertex: in vec3 a_pos; uniform mat4 u_mvp; gl_Position = u_mvp * vec4(a_pos,1)
+ * fragment: uniform vec4 u_color; out vec4 frag; frag = u_color
+ * Add a static helper that compiles a shader and prints the info log
+ * on failure. Look up the uniform locations once in render_init.
+ *
+ * - Three meshes, each a VAO + VBO built once in render_init:
+ * 1. Ground grid: GL_LINES in the XZ plane at y = 0, one line every
+ * GRID_SPACING from -world_half_extent() to +world_half_extent(), in
+ * both directions. Put "major" lines (every GRID_MAJOR_EVERY-th) in a
+ * SEPARATE draw range so they can get a brighter color. The grid is
+ * what makes motion readable in a blank world, so explain that in a comment.
+ * 2. Unit cube: 36 vertices (GL_TRIANGLES), spanning x,z in [-0.5, 0.5]
+ * and y in [0, 1] so its origin is at the BOTTOM center, matching
+ * Body.pos being the feet.
+ * 3. Shadow disc: a GL_TRIANGLE_FAN circle of radius 1 in the XZ plane
+ * (~24 segments).
+ *
+ * - render_frame(cam, player, aspect):
+ * 1. glClearColor(SKY_COLOR_R/G/B), clear color + depth.
+ * 2. vp = camera_projection(cam, aspect) * camera_view(cam).
+ * 3. Grid: u_mvp = vp. Draw minor lines in a dim color, major lines brighter.
+ * 4. Shadow (drawn BEFORE the player):
+ * model = translate(player x, ground_y + 0.01, player z) * scale(r, 1, r)
+ * with r around PLAYER_HALF_WIDTH * 1.2. Dark color. The +0.01 lift
+ * stops z-fighting with the ground. Comment WHY the shadow exists:
+ * in SM64 the blob under Mario is the main cue for where you'll land.
+ * Without it, jumps in 3D are very hard to judge.
+ * ground_y = world_ground_height(player x, player z).
+ * 5. Player box:
+ * model = translate(body.pos) * rotate_y(facing_yaw)
+ * * scale(2*PLAYER_HALF_WIDTH, PLAYER_HEIGHT, 2*PLAYER_HALF_WIDTH)
+ * Bright color (e.g. red). Also draw a small second box as a "nose" on
+ * the front face (+Z in model space) so the facing direction is visible.
+ * That makes the turn rate tunable by eye.
+ * Everything uses the one shader, changing only u_mvp and u_color.
+ *
+ * - render_shutdown: delete the VAOs, VBOs and the program.
+ *
+ * CONVENTIONS: `s_` statics for GL handles. Model matrices built from
+ * math3d.h helpers. There's no lighting, so flat colors are fine.
+ *
+ * NOT IN SCOPE: Lighting, textures, models, text/HUD, anti-aliasing,
+ * interpolating between ticks (a README roadmap item).
+ *
+ * DONE WHEN: The scene shows a sky-colored background, a grid ground plane
+ * stretching to the world edge, a box with a visible nose that faces
+ * where it runs, and a shadow that stays on the ground under the
+ * box during a jump.
+ * ============================================================
+ */