Cub3D

Welcome to the Cub3D project! Dive into the exciting world of raycasting and maze exploration with our interactive game. Learn about the DDA algorithm and how raycasting works in this creative 3D environment.

🤝 Authorship - Collaborative Work

We worked together to develop and enhance this project, sharing knowledge and experiences throughout the process :)

• Ricardo Melo - riolivei
• Luiza Zilio - lpicoli-

Table of Contents

• Project Overview
• Usage
• What is DDA?
• How Raycasting Works

Project Overview

Cub3D is more than just a game; it's a learning experience. Step into the shoes of a maze explorer and immerse yourself in the world of raycasting. Use your skills to navigate through a 3D maze, all while gaining an understanding of the DDA algorithm. The project was entirely written in C and MiniLibX library was used for graphic rendering.

What is DDA?

DDA stands for Digital Differential Analyzer, a mathematical algorithm used for generating lines, as we do in raycasting. In our context, DDA is the magic behind the scenes, helping us draw rays to create a 3D view of the maze.

Imagine DDA as your artist's brush, painting the pixels that make up our 3D world. It's a step-by-step process, calculating the intersections between the rays and the walls. It's the essential tool for drawing lines and shapes with precise, pixel-level accuracy.

How Raycasting Works

Raycasting is a fascinating technique used in video games to create a 3D perspective. It simulates how light rays travel through a scene. In our game, the player emits rays in all directions, just like a flashlight illuminating the path ahead.

As these rays hit walls, we calculate their lengths and angles, which ultimately create the illusion of depth. This is how you see the 3D maze, even though it's just a 2D grid. The rays cast the world around you, showing you what's near and far.

Usage

Let's get started on your journey of raycasting and maze exploration. Here's how:

1. Clone the repository:

git clone git@github.com:ziliolu/42_cub3D.git

2. Navigate to the project directory and compile it:

cd 42_cub3D && make

3. Choose a map from maps folder or test with your own map

./cub3D maps/valid/subject_map.cub

./cub3D path_to_your_own_map