MacroLibX

A rewrite of 42 School's MiniLibX using SDL2 and Vulkan.

The goal of this version is to provide a light, fast, and modern graphical tool while keeping the same API.

🖥️ Installation

Dependencies

You first need to install the proper dependencies for your operating-system.

🐧 Linux

Here are a few common cases for different Linux distributions:

For Ubuntu/Debian-based distros:

sudo apt update
sudo apt install libsdl2-2.0-0 libsdl2-dev build-essential

For ArchLinux-based distros:

sudo pacman -S sdl2

🍎 macOS

MacroLibX on macOS requires SDL2 and MoltenVK. You can install both using the Homebrew package manager:

brew install molten-vk
brew install SDL2

Clone and Build

Finally, you can clone the Git repository. When inside it, run the GNU make command to compile MacroLibX.

git clone https://github.com/420verfl0w/MacroLibX.git
cd MacroLibX
make

If you want to build using GCC you can add TOOLCHAIN=gcc to your make command

make TOOLCHAIN=gcc

🔨 Compile your project

To compile your project with MacroLibX, you just provide the shared library path in your compilation/linking command:

clang myApp.c /path/to/MacroLibX/libmlx.so -lSDL2

⚠️ Troubleshooting

If you run into glitches when writing or reading pixels from images

You need to add IMAGES_OPTIMIZED=false to your make command:

# In your cloned environment, inside the MacroLibX folder
make IMAGES_OPTIMIZED=false

License

This project and all its files, except the third_party directory or unless otherwise mentionned, are licenced under the MIT license.