cub3D | Notion

☃️ d2

[x] remember to delete unused function free_map_copy in parse_map_utils.c Since we eliminated flood fill there was no longer a need to copy the map, so the free function can be deleted.
[ ] double check if we need to init t_orientation and t_key_binding structs

December 1, 2025 9:00 AM (GMT+1) Projected Start date: December 1, 2025

Projected End date: (let’s try to get this done before the holidays - but ok for me if we don’t, though i’d still like to aim for before holidays 😅)

response fine by me ! @d2

[x] Agree on:
- [x] date: propose to finish before xmas?
- [x] otherwise breaks/holiday dates
- [x] bonus: ? ( i’d rather finish quickly, but am open to doing bonus if you want to do it)
- [x] theme
[x] Set up github
- [x] import libft to repository
[x] Set up notion

[x] Create the directory tree
[x] Add .gitignore, Makefile
[x] Create includes/cub3d.h with empty struct declarations and prototypes so we can compile as we go.
[x] create main.c
- [x] function to init_data() (all structs )
[x] Quick test: run make (even if Makefile just prints a message) to ensure build infra is ok.

[x] Define core structs in includes/:
- [x] t_game (pointers to map, player, mlx fields)
- [x] t_map (char **grid, width, height)
- [x] t_player (double x, y, dir_x, dir_y, plane_x, plane_y)
- [x] t_texture placeholder (for later)
[x] Implement minimal parse_cub (src/parsing/parse_cub.c):
- [x] Read file line-by-line.
- [x] Skip header parsing for now; accumulate lines that form the map.
- [x] Normalize map lines into a char ** (pad to same width with spaces).
- [x] Fill t_map fields.
[x] Implement find_player (src/parsing/find_player.c):
- [x] Scan grid for N/S/E/W.
- [x] Set player.x = col + 0.5, player.y = row + 0.5.
- [x] Set dir_x/dir_y and plane_x/plane_y according to orientation.
- [x] Replace player char with '0' in map.
[x] Test: create maps/valid/basic.cub and run program that only calls parse_cub and prints map dimensions and player pos/orientation.

[x] Implement init_mlx and init_game (src/init/):
- [x] mlx_init(), mlx_new_window(), create an image buffer for pixels.
- [x] Store pointers in t_game.
[x] Implement render_frame() (src/render/draw_background.c):
- [x] Fill top half with ceiling color and bottom half with floor color using pixel buffer.
- [x] Hook it into mlx_loop_hook.
[x] Wiring: main.c:
- [x] Call parse_cub, init_game, register hooks, mlx_loop.
[x] Test: run with a valid map — window opens and shows two solid rectangles (ceiling/floor).

[x] Implement raycast() master loop (src/raycast/raycast.c):
- [x] For each x column on screen compute ray direction.
- [x] Implement ray_setup to compute mapX/mapY, sideDist, deltaDist, stepX/stepY.
[x] Implement ray_dda (src/raycast/ray_dda.c):
- [x] Step through grid until a wall ('1') is hit.
- [x] Track which side was hit (NS/EW) to shade differently.
[x] Implement ray_distance & wall_projection:
- [x] Calculate perpendicular distance, compute lineHeight, drawStart, drawEnd.
[x] Implement draw_vertical_stripe to draw the wall slice as a solid color (differentiate sides).
[x] Test: Should be able to walk, rotate, and walls appear with perspective. Use maps/valid/big_map.cub for variety.

Goal: smooth player movement and rotation with collision detection.

[x] Hook events (src/events/window_hooks.c):
[x] Implement movement (src/events/player_move.c):
[x] Implement rotation (src/events/player_rotate.c):
[x] Add movement flags for smooth continuous motion (key press sets flag, release clears).
[x] Test: move into walls and ensure blocked; rotate and strafe behave well.

Pitfalls: forgetting fish-eye correction (use perpendicular distance), off-by-one with draw boundaries.

Goal: upgrade your parser to full .cub support and robust validation.

[x] Implement parse_textures and parse_colors (src/parsing/parse_textures.c & parse_colors.c):
[x] Implement map_normalize (pad rows) if not done earlier.
[x] Implement map_validate:
[x] Implement error_exit with meaningful messages and clean freeing.
[x] Test: use maps/invalid/* to verify each error case triggers the correct message.

Pitfalls: treating spaces as walls incorrectly — spaces are void outside map; need padded map for floodfill.