A recreation of the MiniLibX library used by 42, using GLFW & glad, running on OpenGL. The goal of MLX42 is to replace the outdated and stale MiniLibX library.
For information and documentation about MLX42 check the wiki.
The main idea of MLX42 is to be a cross-platform graphics interface. In 42 everything runs (currently) on MacOS, but it's very useful to be able to work remotely on different machines. With MiniLibX this is not possible.
Almost all functions and types are fully documented giving you a clue as to how to approach and use the library. No more guessing and searching how something functions or is supposed to work.
A custom simple to use XPM-like format which has some minor differences to the XPM3 format.
Switching to MLX42 from MiniLibX is not a lot of work, most features present in MiniLibX are also present in MLX42, albeit with different prototypes.
In the very end a library is generated, compile your program with this library!
- Download MLX42
➜ ~ git clone https://github.com/codam-coding-college/MLX42.git
Via Homebrew / Homebrew42 by building from source.
- Install GLFW
Through brew:
➜ ~ brew update
➜ ~ brew install glfw
If you're studying at Codam you can simply link GLFW normally since its now installed on the macs.
-
Compile Program
With the normal brew version you can now simply compile the program with:
➜ ~ gcc main.c libmlx42.a -lglfw ...
You might have to specify the location explicitly:
➜ ~ gcc main.c libmlx42.a -lglfw -L /opt/homebrew/Cellar/glfw/3.3.6/lib/
However, with 42Homebrew you have additionally specify the location of the library like here:
➜ ~ gcc main.c libmlx42.a -I include -lglfw -L "/Users/$USER/.brew/opt/glfw/lib/"
Or, if studying at Codam, compile using the following flags:
➜ ~ gcc main.c libmlx42.a -I include -lglfw3 -framework Cocoa -framework OpenGL -framework IOKit
- Run!
-
Download the binaries directly here.
-
If possible move the contents of
lib
andinclude
of GLFW to/usr/local/lib
and/usr/local/include
respectively. If not possible, move the lib file to the root of MLX42 and move the GLFW directory in include to the include of MLX42. NOTE: For the lib choose the appropriate.a
&.dylib
file depending on your architecture.
When compiling with the static library, directly you should compile your program like this:
➜ ~ gcc main.c libmlx42.a libglfw3.a ... -framework Cocoa -framework OpenGL -framework IOKit
Else, simply compile like this:
➜ ~ gcc main.c libmlx42.a -lglfw ...
- Run
In case of any security warnings or MacOS telling you it can't verify the author/developer, go to Settings > Security & Privacy
.
There will be a pop-up at the bottom telling you that an application tried to run, click the option to let it run.
- Install the necessary packages:
For Debian like (Ubuntu, Mint, Pop OS...):
➜ ~ sudo apt update
➜ ~ sudo apt install build-essential libx11-dev libglfw3-dev libglfw3 xorg-dev
For Arch-linux (Manjaro, Endeavor, Garuda):
➜ ~ sudo pacman -S glfw-x11
OR (if you use sway/wlroots compositor or other wayland compositor)
➜ ~ sudo pacman -S glfw-wayland
-
Create a
main.c
file, includeMLX42/MLX42.h
, compile with-ldl -lglfw (or -lglfw3) -pthread -lm
, make sure to also do-I <include_path>
. -
Run.
- Set these variables in your
.zshrc
or.bashrc
:
export DISPLAY=$(ip route list default | awk '{print $3}'):0
export LIBGL_ALWAYS_INDIRECT=0
(If the DISPLAY export command is failing, see this StackOverflow post for alternatives)
-
Download and install an XServer application with extended configuration (XMing does not qualify) VcXsrv works: https://sourceforge.net/projects/vcxsrv/
-
Open Windows Defender Firewall, and follow these steps:
- Go to 'Allow an app or feature through Windows Defender Firewall'
- Change Settings
- Find the installed XServer, for VcXsrv that's 'VcXsrv windows server'
- Enable communication over Private and Public network Optionally you might be able to provide these settings on first launch of the XServer application, and they might not even show up in the list until the first time you start the app.
- Start the XLaunch application (for VcXsrv) and provide these configuration settings:
- Leave Display number on auto
- Start no client
- UNTICK
Native opengl
option - TICK
Disable access control
- Finish starting the server
- Probably all the other steps for Linux apply, just clone, build and run.
-
Download & Install MinGW
-
Simply click continue, select whatever your choice is. Once reaching the MinGW Installation Manager select:
- mingw32-base
- mingw32-gcc-g++
-
Apply by going to
Installation > Apply Changes
, after it's done, you may close the window. -
Download & Install CMake.
- Use the installer and select all default options.
-
For Windows we need to install an additional component to make the make command available.
-
Using the chocolatey package manager
➜ ~ choco install make
-
Using GnuWin (download & install)
-
-
If you used all default options, add these paths to your SYSTEM Environment variables:
- C:\MinGW\bin
- C:\Program Files\CMake\bin
- C:\Program Files (x86)\GnuWin32\bin
-
Download the GLFW source package and extract it somewhere.
-
Open the terminal and type
cmake-gui
, select the downloaded/extracted source folder, select any place you want the build output to be. -
Click on configure once and select the
MinGW Makefiles
, then finish. -
Set the CMAKE_INSTALL_PREFIX to
C:/GLFW
-
Click on configure again, and then generate.
-
Go to the build directory and do:
make
make install
-
Go to the directory you assigned in Step 10. Copy the GLFW folder in the include folder to
C:\MinGW\include
& copy the .a file in the lib folder toC:\MinGW\lib
. -
Compile your program with these flags:
-lglfw3
-lopengl32
-lgdi32
In the end you should have something like:
➜ ~ gcc main.c <Additional .c Files> libmlx42.a -lglfw3 -lopengl32 -lgdi32
- Run.
➜ ~ git clone https://github.com/codam-coding-college/MLX42.git
➜ ~ cd MLX42
➜ ~ make
The output library file is called libmlx42.a
.
/* ************************************************************************** */
/* */
/* :::::::: */
/* main.c :+: :+: */
/* +:+ */
/* By: W2Wizard <[email protected]> +#+ */
/* +#+ */
/* Created: 2022/01/31 00:40:08 by W2Wizard #+# #+# */
/* Updated: 2022/01/31 00:41:56 by W2Wizard ######## odam.nl */
/* */
/* ************************************************************************** */
#include "MLX42/MLX42.h"
#include <stdlib.h>
#include <stdio.h>
#include <unistd.h>
#include <memory.h>
#define WIDTH 256
#define HEIGHT 256
mlx_image_t *g_img;
void hook(void *param)
{
mlx_t *mlx;
mlx = param;
if (mlx_is_key_down(mlx, MLX_KEY_ESCAPE))
mlx_close_window(mlx);
if (mlx_is_key_down(mlx, MLX_KEY_UP))
g_img->instances[0].y -= 5;
if (mlx_is_key_down(mlx, MLX_KEY_DOWN))
g_img->instances[0].y += 5;
if (mlx_is_key_down(mlx, MLX_KEY_LEFT))
g_img->instances[0].x -= 5;
if (mlx_is_key_down(mlx, MLX_KEY_RIGHT))
g_img->instances[0].x += 5;
}
int32_t main(void)
{
mlx_t *mlx;
mlx = mlx_init(WIDTH, HEIGHT, "MLX42", true);
if (!mlx)
exit(EXIT_FAILURE);
g_img = mlx_new_image(mlx, 128, 128);
memset(g_img->pixels, 255, g_img->width * g_img->height * sizeof(int));
mlx_image_to_window(mlx, g_img, 0, 0);
mlx_loop_hook(mlx, &hook, mlx);
mlx_loop(mlx);
mlx_terminate(mlx);
return (EXIT_SUCCESS);
}