FdF is a 42 Project that aims to create an isometric 3D graphic representation of a terrain.
This project involves creating a graphical representation of a relief terrain in a schematic form. The program takes a file as input, containing coordinates representing points in space, and produces a wireframe rendering of the terrain. The rendering is displayed using an isometric projection based on the Bresenham algorithm.
The repository is organized with the following structure:
- Makefile: Automation script for compilation and project management.
- inc/: folder containing header files function prototypes and necessary definitions.
- src/*.c: Source files implementing various functions.
- The project must be written in C.
- Adherence to the
42 SchoolNorm is mandatory. - The program should not terminate unexpectedly, and memory must be handled properly to avoid leaks.
- Allowed External Functions: open, close, read, write, malloc, free, perror, strerror, exit
This project only support Linux and was tested on Ubuntu 18.04.
make
./fdf [map].fdfMaps are provided in the assets/maps/ folder.
arrow keys: Translationmouse wheel: Zoom+and-: HeightESC: Exit- Colored terrain based color
hexvalues in map files
- Render using an isometric projection based on
Bresenham algorithm. - Input coordinates provided in a file, with each number representing a point's position and altitude.
- Utilize Minilibx library for rendering. The MinilibX is a simple X-Window (X11R6) programming API in C, designed for students, suitable for X-beginners.
- Display the rendering in a window.
- Ensure smooth window management (resizing, minimizing, etc.).
- Understanding and implementing graphic rendering techniques.
- Working with external libraries like MiniLibX.
- Effectively managing memory and avoiding memory leaks.
- Developing a robust and well-structured C program.
- Handling user interactions in a graphical environment.
If the git submodules didn't clone properly, you can run the following commands to clone the submodules:
git submodule update --init --force --remoteFor macOS users, the project needs a X11 server to run. You can install it with Homebrew using the following command:
brew install xquartz libx11 libext
rebootIf you have an issue with the window size, you can change the corresponding macros in the include file fdf.h located in the inc/ folder:
# define WIDTH 1280
# define HEIGHT 720