release 2.0 (#110)

Automated changes by
[create-pull-request](https://github.com/peter-evans/create-pull-request)
GitHub action

.github/dependabot.yml

@@ -0,0 +1,11 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "github-actions" # See documentation for possible values
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "weekly"

.github/workflows/fetch_dependencies.yml

@@ -0,0 +1,29 @@
+name: Fetch Dependencies
+
+on:
+  schedule:
+    - cron: '0 0 * * 0' # Runs weekly
+
+jobs:
+  update-dependencies:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout Repository
+      uses: actions/checkout@v4
+
+    - name: Run Fetch Dependencies Script
+      run: cd scripts && bash ./fetch_dependencies.sh
+
+    - name: Create Pull Request
+      uses: peter-evans/create-pull-request@v6
+      with:
+        title: update dependencies
+        commit-message: "[BOT] update dependencies"
+        committer: GitHub <noreply@github.com>
+        author: ${{ github.actor }} <${{ github.actor }}@users.noreply.github.com>
+        signoff: false
+        base: indev
+        branch: auto_deps_updates
+        labels: |
+          automated

.github/workflows/greetings.yml

@@ -0,0 +1,25 @@
+name: Greetings
+
+on: [pull_request_target, issues]
+
+jobs:
+  greeting:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      pull-requests: write
+    steps:
+    - uses: actions/first-interaction@v1
+      with:
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        issue-message: |
+          Hello! Thank you for filing an issue.
+
+            If this is a bug report, please include relevant logs to help us debug the problem (OS, MLX version, drivers installed, GPU type and vendor, ...)
+        pr-message: |
+            Hello! Thank you for your contribution.
+
+            If you are fixing a bug, please reference the issue number in the description.
+
+            If you are implementing a feature request, please explain all your changes in your pull request.
+

.github/workflows/linux_clang.yml

@@ -13,7 +13,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest]
+        os: [ubuntu-24.04]
         arch: [x86_64]
         mode: [release]
 
@@ -21,10 +21,6 @@ jobs:
     if: "!contains(github.event.head_commit.message, 'ci skip')"
 
     steps:
-    - name: Get current date as package key
-      id: cache_key
-      run: echo "key=$(date +'%W')" >> $GITHUB_OUTPUT
-
     - name: Checkout repository
       uses: actions/checkout@v4
 
@@ -35,8 +31,8 @@ jobs:
 
     # Build the lib
     - name: Build MacroLibX
-      run: make -j
+      run: make -j && make fclean && make debug 
 
-    # Build the test
+    # Build the example
-    - name: Build Test
+    - name: Build Example
-      run: cd test && clang main.c ../libmlx.so -lSDL2
+      run: cd example && bash ./build.sh

.github/workflows/linux_gcc.yml

@@ -13,7 +13,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest]
+        os: [ubuntu-24.04]
         arch: [x86_64]
         mode: [release]
 
@@ -21,10 +21,6 @@ jobs:
     if: "!contains(github.event.head_commit.message, 'ci skip')"
 
     steps:
-    - name: Get current date as package key
-      id: cache_key
-      run: echo "key=$(date +'%W')" >> $GITHUB_OUTPUT
-
     - name: Checkout repository
       uses: actions/checkout@v4
 
@@ -35,9 +31,9 @@ jobs:
 
     # Build the lib
     - name: Build MacroLibX
-      run: make TOOLCHAIN=gcc -j
+      run: make TOOLCHAIN=gcc -j && make fclean && make TOOLCHAIN=gcc debug
 
-    # Build the test
+    # Build the example
-    - name: Build Test
+    - name: Build Example
-      run: cd test && gcc main.c ../libmlx.so -lSDL2
+      run: cd example && bash ./build.sh
 

.github/workflows/macos_x86.yml

@@ -21,29 +21,19 @@ jobs:
     if: "!contains(github.event.head_commit.message, 'ci skip')"
 
     steps:
-    - name: Get current date as package key
-      id: cache_key
-      run: echo "key=$(date +'%W')" >> $GITHUB_OUTPUT
-
     - name: Checkout repository
       uses: actions/checkout@v4
 
     # Install system dependencies
-    - name: Install Vulkan SDK
-      uses: humbletim/install-vulkan-sdk@v1.1.1
-      with:
-        version: 1.3.204.1
-        cache: true
-
     - name: Install Dependancies
       run: |
         brew install SDL2
 
     # Build the lib
     - name: Build MacroLibX
-      run: make -j
+      run: make -j && make fclean && make debug 
 
-    # Build the test
+    # Build the example
-    - name: Build Test
+    - name: Build Example
-      run: cd test && clang main.c ../libmlx.so -lSDL2
+      run: cd example && bash ./build.sh
 

.github/workflows/windows.yml

@@ -28,13 +28,6 @@ jobs:
     - name: Checkout repository
       uses: actions/checkout@v4
 
-    # Install system dependencies
-    - name: Install Vulkan SDK
-      uses: humbletim/install-vulkan-sdk@v1.1.1
-      with:
-        version: 1.3.204.1
-        cache: true
-
     # Force xmake to a specific folder (for cache)
     - name: Set xmake env
       run: echo "XMAKE_GLOBALDIR=${{ runner.workspace }}/xmake-global" >> $GITHUB_ENV
@@ -50,18 +43,6 @@ jobs:
     - name: Update xmake repository
       run: xmake repo --update
 
-    # Fetch xmake dephash
-    - name: Retrieve dependencies hash
-      id: dep_hash
-      run: echo "hash=$(xmake l utils.ci.packageskey)" >> $GITHUB_OUTPUT
-
-    # Cache xmake dependencies
-    - name: Retrieve cached xmake dependencies
-      uses: actions/cache@v3
-      with:
-        path: ${{ env.XMAKE_GLOBALDIR }}/.xmake/packages
-        key: Windows-${{ matrix.arch }}-${{ matrix.mode }}-${{ steps.dep_hash.outputs.hash }}-W${{ steps.cache_key.outputs.key }}
-
     # Setup compilation mode and install project dependencies
     - name: Configure xmake and install dependencies
       run: xmake config --arch=${{ matrix.arch }} --mode=${{ matrix.mode }} --yes
@@ -69,7 +50,3 @@ jobs:
     # Build the mlx
     - name: Build MacroLibX
       run: xmake --yes
-
-    # Build the test
-    - name: Build Test
-      run: xmake build --yes Test

.gitignore

@@ -11,11 +11,15 @@
 *.tmp
 *.ilk
 *.pdb
+*.gch
+*.pch
+*.sym
 *.exe
+*vgcore.*
+*.gdb_history
 .vs/
 .xmake/
 .cache/
 objs/
 build/
-test/.gdb_history
+example/Test
-test/Test

CONTRIBUTING.md

@@ -0,0 +1,17 @@
+# How to contribute to the MacroLibX
+
+For any questions, suggestions or help [contact me](mailto:contact@kbz8.me)
+
+## **Found a bug?**
+
+* Avoid opening any new issues without having checked if your problem has already been reported. If there are no currently open issues that fit your problem's description, feel free to [add it](https://github.com/seekrs/MacroLibX/issues/new).
+
+* When writing an issue make sure to include a clear title and description as well as having filled out all the necessary information: System info, OS, OS-Version, ...
+
+* If possible add pictures of the issue.
+
+## Contributing
+
+Before thinking of adding a contribution, think. Is it necessary? Will this actually be a useful/required feature? Is your implementation good?
+Provide clear and documented explanation as to what was changed.
+

LICENSE

@@ -1,5 +1,5 @@
                              MIT License
-                     Copyright (c) 2022-2023 kbz_8
+                     Copyright (c) 2022-2024 kbz_8
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

Makefile

@@ -1,92 +1,178 @@
-# **************************************************************************** #
+NAME = libmlx.so
-#                                                                              #
+MAKE = make --no-print-directory
-#                                                         :::      ::::::::    #
-#    Makefile                                           :+:      :+:    :+:    #
-#                                                     +:+ +:+         +:+      #
-#    By: maldavid <kbz_8.dev@akel-engine.com>       +#+  +:+       +#+         #
-#                                                 +#+#+#+#+#+   +#+            #
-#    Created: 2022/10/04 16:43:41 by maldavid          #+#    #+#              #
-#    Updated: 2023/12/07 15:25:52 by kbz_8            ###   ########.fr        #
-#                                                                              #
-# **************************************************************************** #
 
-NAME		= libmlx.so
+OS ?= $(shell uname -s)
-
+DEBUG ?= false
-SRCS		=  $(wildcard $(addsuffix /*.cpp, ./src/core))
+TOOLCHAIN ?= clang
-SRCS		+= $(wildcard $(addsuffix /*.cpp, ./src/core/**))
+IMAGES_OPTIMIZED ?= true
-SRCS		+= $(wildcard $(addsuffix /*.cpp, ./src/platform))
-SRCS		+= $(wildcard $(addsuffix /*.cpp, ./src/renderer))
-SRCS		+= $(wildcard $(addsuffix /*.cpp, ./src/renderer/**))
-
-OBJ_DIR		= objs/makefile
-OBJS		= $(addprefix $(OBJ_DIR)/, $(SRCS:.cpp=.o))
-
-OS = $(shell uname -s)
-DEBUG		?= false
-TOOLCHAIN	?= clang
-IMAGES_OPTIMIZED	?= true
 FORCE_INTEGRATED_GPU ?= false
 GRAPHICS_MEMORY_DUMP ?= false
+PROFILER ?= false
+FORCE_WAYLAND ?= false
+DISABLE_ALL_SAFETIES ?= false
+_ENABLEDFLAGS =
 
-MODE	= "release"
+SRCS =  $(wildcard $(addsuffix /*.cpp, runtime/Sources/Core))
+SRCS += $(wildcard $(addsuffix /*.cpp, runtime/Sources/Graphics))
+SRCS += $(wildcard $(addsuffix /*.cpp, runtime/Sources/Platform))
+SRCS += $(wildcard $(addsuffix /*.cpp, runtime/Sources/Renderer))
+SRCS += $(wildcard $(addsuffix /*.cpp, runtime/Sources/Renderer/Vulkan))
+SRCS += $(wildcard $(addsuffix /*.cpp, runtime/Sources/Renderer/Pipelines))
+SRCS += $(wildcard $(addsuffix /*.cpp, runtime/Sources/Renderer/RenderPasses))
 
-CXX		= clang++
+OBJ_DIR = objs/make/$(shell echo $(OS) | tr '[:upper:]' '[:lower:]')
+OBJS := $(addprefix $(OBJ_DIR)/, $(SRCS:.cpp=.o))
+
+SHADERS_DIR = runtime/Includes/Embedded
+SHADERS_SRCS = $(wildcard $(addsuffix /*.nzsl, $(SHADERS_DIR)))
+SPVS = $(SHADERS_SRCS:.nzsl=.spv.h)
+
+CXX = clang++
+CXXFLAGS = -std=c++20 -fPIC -Wall -Wextra -DSDL_MAIN_HANDLED
+INCLUDES = -I./includes -I./runtime/Includes -I./runtime/Sources -I./third_party
+
+CXXPCHFLAGS = -xc++-header -std=c++20 -Wall -Wextra 
+
+PCH_SOURCE = runtime/Includes/PreCompiled.h
+GCH = runtime/Includes/PreCompiled.h.gch
+CCH = runtime/Includes/PreCompiled.h.pch
+PCH =
+
+NZSLC ?= nzslc
 
 ifeq ($(TOOLCHAIN), gcc)
 	CXX = g++
+	PCH = $(GCH)
+	CXXFLAGS += -Wno-error=cpp
+else
+	PCH = $(CCH)
+	CXXFLAGS += -Wno-error=#warning -include-pch $(PCH)
 endif
 
-CXXFLAGS	= -std=c++17 -O3 -fPIC
-INCLUDES	= -I./includes -I./src -I./third_party
-
-LDLIBS =
-
 ifeq ($(OS), Darwin)
-	LDLIBS += -lSDL2
+	LDFLAGS += -L /opt/homebrew/Cellar/lib -L /usr/local/Cellar -L /opt/homebrew/lib -lSDL2
+	INCLUDES += -I /opt/homebrew/Cellar/include -I /usr/local/Cellar/include -I /opt/homebrew/include
+	NAME = libmlx.dylib
 endif
 
 ifeq ($(DEBUG), true)
-	CXXFLAGS += -g -D DEBUG
+	CXXFLAGS += -g3 -O0 -D DEBUG
-	MODE = "debug"
+	LDFLAGS += -rdynamic
+else
+	CXXFLAGS += -O3
 endif
 
 ifeq ($(FORCE_INTEGRATED_GPU), true)
-	CXXFLAGS += -D FORCE_INTEGRATED_GPU
+	_ENABLEDFLAGS += FORCE_INTEGRATED_GPU
 endif
 
 ifeq ($(IMAGES_OPTIMIZED), true)
-	CXXFLAGS += -D IMAGE_OPTIMIZED
+	_ENABLEDFLAGS += IMAGE_OPTIMIZED
 endif
 
 ifeq ($(GRAPHICS_MEMORY_DUMP), true)
-	CXXFLAGS += -D GRAPHICS_MEMORY_DUMP
+	_ENABLEDFLAGS += GRAPHICS_MEMORY_DUMP
 endif
 
+ifeq ($(PROFILER), true)
+	_ENABLEDFLAGS += PROFILER
+endif
+
+ifeq ($(FORCE_WAYLAND), true)
+	_ENABLEDFLAGS += FORCE_WAYLAND
+endif
+
+ifeq ($(DISABLE_ALL_SAFETIES), true)
+	_ENABLEDFLAGS += DISABLE_ALL_SAFETIES
+endif
+
+CXXFLAGS += $(addprefix -D, $(_ENABLEDFLAGS))
+
 RM = rm -rf
 
-$(OBJ_DIR)/%.o: %.cpp
+TPUT = tput -T xterm-256color
-	@printf "\033[1;32m[compiling... "$(MODE)" "$(CXX)"]\033[1;00m "$<"\n"
+_RESET := $(shell $(TPUT) sgr0)
+_BOLD := $(shell $(TPUT) bold)
+_ITALIC := $(shell $(TPUT) sitm)
+_UNDER := $(shell $(TPUT) smul)
+_GREEN := $(shell $(TPUT) setaf 2)
+_YELLOW := $(shell $(TPUT) setaf 3)
+_RED := $(shell $(TPUT) setaf 1)
+_GRAY := $(shell $(TPUT) setaf 8)
+_PURPLE := $(shell $(TPUT) setaf 5)
+
+ifeq ($(DEBUG), true)
+	MODE := $(_RESET)$(_PURPLE)$(_BOLD)Debug$(_RESET)$(_PURPLE)
+	COLOR := $(_PURPLE)
+else
+	MODE := $(_RESET)$(_GREEN)$(_BOLD)Release$(_RESET)$(_GREEN)
+	COLOR := $(_GREEN)
+endif
+
+OBJS_TOTAL = $(words $(OBJS))
+N_OBJS := $(shell find $(OBJ_DIR) -type f -name '*.o' 2>/dev/null | wc -l)
+OBJS_TOTAL := $(shell echo $$(( $(OBJS_TOTAL) - $(N_OBJS) )))
+ifeq ($(OBJS_TOTAL), 0) # To avoid division per 0
+	OBJS_TOTAL := 1
+endif
+CURR_OBJ = 0
+
+$(OBJ_DIR)/%.o: %.cpp $(PCH)
+	@mkdir -p $(dir $@)
+	@$(eval CURR_OBJ=$(shell echo $$(( $(CURR_OBJ) + 1 ))))
+	@$(eval PERCENT=$(shell echo $$(( $(CURR_OBJ) * 100 / $(OBJS_TOTAL) ))))
+	@printf "$(COLOR)($(_BOLD)%3s%%$(_RESET)$(COLOR)) $(_RESET)Compiling $(_BOLD)$<$(_RESET)\n" "$(PERCENT)"
 	@$(CXX) $(CXXFLAGS) $(INCLUDES) -c $< -o $@
 
-all:		$(NAME)
+SPVS_TOTAL = $(words $(SPVS))
+N_SPVS := $(shell find $(SHADERS_DIR) -type f -name '*.spv.h' 2>/dev/null | wc -l)
+SPVS_TOTAL := $(shell echo $$(( $(SPVS_TOTAL) - $(N_SPVS) )))
+ifeq ($(SPVS_TOTAL), 0) # Same
+	SPVS_TOTAL := 1
+endif
+CURR_SPV = 0
 
-$(NAME):	$(OBJ_DIR) $(OBJS)
+%.spv.h: %.nzsl
-	@printf "\033[1;32m[linking ... "$(MODE)"]\033[1;00m "$@"\n"
+	@$(eval CURR_SPV=$(shell echo $$(( $(CURR_SPV) + 1 ))))
-	@$(CXX) -shared -o $(NAME) $(OBJS) $(LDLIBS)
+	@$(eval PERCENT=$(shell echo $$(( $(CURR_SPV) * 100 / $(SPVS_TOTAL) ))))
-	@printf "\033[1;32m[build finished]\033[1;00m\n"
+	@printf "$(COLOR)($(_BOLD)%3s%%$(_RESET)$(COLOR)) $(_RESET)Compiling $(_BOLD)$<$(_RESET)\n" "$(PERCENT)"
+	@$(NZSLC) --compile=spv-header $< -o $(SHADERS_DIR) --optimize
 
-$(OBJ_DIR):
+all: _printbuildinfos
-	@mkdir -p $(sort $(addprefix $(OBJ_DIR)/, $(dir $(SRCS))))
+	@$(MAKE) $(NAME)
-	@printf "\033[1;32m[created objs directory]\033[1;00m\n"
+
+$(PCH):
+	@printf "$(COLOR)($(_BOLD)%3s%%$(_RESET)$(COLOR)) $(_RESET)Compiling $(_BOLD)PreCompiled header$(_RESET)\n" "0"
+	@$(CXX) $(CXXPCHFLAGS) $(INCLUDES) $(PCH_SOURCE) -o $(PCH)
+
+$(NAME): $(OBJS)
+	@printf "Linking $(_BOLD)$(NAME)$(_RESET)\n"
+	@$(CXX) -shared -o $(NAME) $(OBJS) $(LDFLAGS)
+	@printf "$(_BOLD)$(NAME)$(_RESET) compiled $(COLOR)$(_BOLD)successfully$(_RESET)\n"
+
+_printbuildinfos:
+	@printf "$(_PURPLE)$(_BOLD)MacroLibX $(_RESET)Compiling in $(_BOLD)$(MODE)$(_RESET) mode on $(_BOLD)$(OS)$(_RESET) | Using $(_BOLD)$(CXX) ($(shell $(CXX) --version | head -n 1))$(_RESET), flags: $(_BOLD)$(_ENABLEDFLAGS)$(_RESET)\n"
+
+debug:
+	@$(MAKE) all DEBUG=true -j$(shell nproc)
+
+clean-shaders:
+	@$(RM) $(SPVS)
+
+shaders: clean-shaders $(SPVS)
 
 clean:
 	@$(RM) $(OBJ_DIR)
-	@printf "\033[1;32m[object files removed]\033[1;00m\n"
+	@printf "Cleaned $(_BOLD)$(OBJ_DIR)$(_RESET)\n"
+	@$(RM) $(GCH)
+	@$(RM) $(CCH)
+	@printf "Cleaned pre compiled header\n"
 
-fclean:		clean
+fclean: clean
 	@$(RM) $(NAME)
-	@printf "\033[1;32m["$(NAME)" removed]\033[1;00m\n"
+	@printf "Cleaned $(_BOLD)$(NAME)$(_RESET)\n"
 
-re:			fclean all
+re: fclean _printbuildinfos
+	@$(MAKE) $(NAME)
 
-.PHONY:		all clean fclean re
+.PHONY: all clean debug shaders clean-shaders fclean re

README.md

@@ -1,18 +1,38 @@
 <div align="center">
     <img src="./res/logo.png" alt="drawing" width="200"/>
     <div align="center">
-        <a href="https://github.com/420verfl0w/MacroLibX/actions/workflows/linux_clang.yml"><img src="https://github.com/420verfl0w/MacroLibX/actions/workflows/linux_clang.yml/badge.svg"></a>
+        <a href="https://github.com/seekrs/MacroLibX/actions/workflows/linux_clang.yml"><img src="https://github.com/seekrs/MacroLibX/actions/workflows/linux_clang.yml/badge.svg"></a>
-        <a href="https://github.com/420verfl0w/MacroLibX/actions/workflows/linux_gcc.yml"><img src="https://github.com/420verfl0w/MacroLibX/actions/workflows/linux_gcc.yml/badge.svg"></a>
+        <a href="https://github.com/seekrs/MacroLibX/actions/workflows/linux_gcc.yml"><img src="https://github.com/seekrs/MacroLibX/actions/workflows/linux_gcc.yml/badge.svg"></a>
-        <a href="https://github.com/420verfl0w/MacroLibX/actions/workflows/macos_x86.yml"><img src="https://github.com/420verfl0w/MacroLibX/actions/workflows/macos_x86.yml/badge.svg"></a>
+        <a href="https://github.com/seekrs/MacroLibX/actions/workflows/macos_x86.yml"><img src="https://github.com/seekrs/MacroLibX/actions/workflows/macos_x86.yml/badge.svg"></a>
     </div>
     <div align="center">
-        <a href="https://github.com/420verfl0w/MacroLibX/actions/workflows/windows.yml"><img src="https://github.com/420verfl0w/MacroLibX/actions/workflows/windows.yml/badge.svg"></a>
+        <a href="https://github.com/seekrs/MacroLibX/actions/workflows/windows.yml"><img src="https://github.com/seekrs/MacroLibX/actions/workflows/windows.yml/badge.svg"></a>
     </div>
 </div>
 
 ###### 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.
 
+## 🌟 Features
+
+### 🚀 Performances
+Built on top of Vulkan, the MacroLibX takes advantage of its very low-level nature to achieve high performance with great control over available resources.
+
+### 💻 Cross-Platform
+Designed to be totally cross-platform, it can run on any SDL2-supported platform that supports Vulkan (even the Nintendo Switch ! theoretically... ).
+
+### 🗿 Close to the old minilibx
+One of the guidelines of this lib was to get as close as possible to the old minilibx API, and therefore to the educational choices of the old minilibx.
+
+### 📖 It's all FOSS
+Everything in this repo is entirely free and open source, all available under the MIT license (even the third-party libraries used).
+
+### 🔍 Valgrind suppressions file
+Experimental for now, a [suppressions file for valgrind](./valgrind.supp) is given to remove potential leaks comming from Xorg, Nvidia drivers, SDL2, or any other tool which the user has no control. It is far from perfect at the moment and may allow some leaks but it will block the majority.
+
+### ⛔ Error system
+Strong error handling informing the user of problems with their code and even capable of informing them of graphics memory leaks that tools like Valgrind cannot detect.
+
 ## 🖥️ Installation
 
 ### Dependencies
@@ -38,6 +58,9 @@ sudo apt install libsdl2-2.0-0 libsdl2-dev build-essential
 <pre><code>sudo pacman -S sdl2</code></pre>
 </details>
 
+<br>
+Note that you need to have up do date video drivers with <code>libvulkan.so</code> installed.
+
 #### 🍎 macOS
 [MacroLibX](#) on macOS requires [SDL2](#) and [MoltenVK](https://github.com/KhronosGroup/MoltenVK). You can install both using the [Homebrew](https://brew.sh) package manager:
 ```sh
@@ -51,7 +74,7 @@ To build on Windows you may need to use the [xmake](https://xmake.io) build. [He
 ### Clone and Build
 Finally, you can clone the Git repository. When inside it, run the GNU `make` command to compile MacroLibX. 
 ```bash
-git clone https://github.com/420verfl0w/MacroLibX.git
+git clone https://github.com/seekrs/MacroLibX.git
 cd MacroLibX
 make
 ```
@@ -74,6 +97,9 @@ And you can enjoy your project
 ### 📦 Compile mode
 By default the mlx is built in release mode but you can switch to debug by using `make DEBUG=true`.
 
+### 🦺 Safety
+MacroLibX has a strong safety support, mainly by checking every pointer that you pass to it. But this safety has a cost that can be avoided by enabling `DISABLE_ALL_SAFETIES=true` before compiling but don't be afraid to recieve segmentation faults from the mlx.
+
 ### 🛠️ Set the toolchain
 If you want to use `GCC` to build the mlx you can use `make TOOLCHAIN=gcc`
 
@@ -87,5 +113,4 @@ You can force the mlx to use your integrated GPU by using `make FORCE_INTEGRATED
 The mlx can dump it's graphics memory use to json files every two seconds by enabling this option `make GRAPHICS_MEMORY_DUMP=true`.
 
 ## License
-
+This project and all its files, even the [`third_party`](./third_party) directory or unless otherwise mentionned, are licenced under the [MIT license](./LICENSE).
-This project and all its files, except the [`third_party`](./third_party) directory or unless otherwise mentionned, are licenced under the [MIT license](./LICENSE).

XMAKE_BUILD.md

@@ -10,6 +10,9 @@ Just as the Makfile build system, you can configure how xmake should build the M
 ### 📦 Compile mode
 You can configure xmake to build the mlx in debug mode or in release mode (release mode is enabled by default). To do so you can use `xmake config --mode=debug` or `xmake config --mode=release`.
 
+### 🦺 Safety
+MacroLibX has a strong safety support, mainly by checking every pointer that you pass to it. But this safety has a cost that can be avoided by enabling `xmake config --disable_all_safeties=y` before compiling but don't be afraid to recieve segmentation faults from the mlx.
+
 ### 🛠️ Set the toolchain
 To change the compilation toolchain you can use `xmake config --toolchain=[gcc|clang|...]`
 

compile_commands.json

@@ -1,642 +0,0 @@
-[
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/text_pipeline.o",
-      "src/renderer/text_pipeline.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/text_pipeline.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/text_pipeline.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/buffers/vk_vbo.o",
-      "src/renderer/buffers/vk_vbo.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/buffers/vk_vbo.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/buffers/vk_vbo.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/pixel_put.o",
-      "src/renderer/pixel_put.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/pixel_put.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/pixel_put.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/core/graphics.o",
-      "src/core/graphics.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/core/graphics.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/core/graphics.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/buffers/vk_ubo.o",
-      "src/renderer/buffers/vk_ubo.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/buffers/vk_ubo.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/buffers/vk_ubo.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/platform/inputs.o",
-      "src/platform/inputs.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/platform/inputs.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/platform/inputs.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/renderer.o",
-      "src/renderer/renderer.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/renderer.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/renderer.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/text_library.o",
-      "src/renderer/text_library.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/text_library.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/text_library.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/buffers/vk_buffer.o",
-      "src/renderer/buffers/vk_buffer.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/buffers/vk_buffer.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/buffers/vk_buffer.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/command/cmd_manager.o",
-      "src/renderer/command/cmd_manager.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/command/cmd_manager.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/command/cmd_manager.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/core/vk_device.o",
-      "src/renderer/core/vk_device.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/core/vk_device.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/core/vk_device.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/command/vk_cmd_buffer.o",
-      "src/renderer/command/vk_cmd_buffer.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/command/vk_cmd_buffer.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/command/vk_cmd_buffer.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/core/render_core.o",
-      "src/renderer/core/render_core.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/core/render_core.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/core/render_core.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/command/vk_cmd_pool.o",
-      "src/renderer/command/vk_cmd_pool.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/command/vk_cmd_pool.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/command/vk_cmd_pool.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/core/vk_instance.o",
-      "src/renderer/core/vk_instance.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/core/vk_instance.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/core/vk_instance.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/core/vk_semaphore.o",
-      "src/renderer/core/vk_semaphore.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/core/vk_semaphore.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/core/vk_semaphore.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/core/vk_queues.o",
-      "src/renderer/core/vk_queues.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/core/vk_queues.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/core/vk_queues.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/core/vk_validation_layers.o",
-      "src/renderer/core/vk_validation_layers.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/core/vk_validation_layers.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/core/vk_validation_layers.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/core/vk_surface.o",
-      "src/renderer/core/vk_surface.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/core/vk_surface.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/core/vk_surface.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/core/vk_fence.o",
-      "src/renderer/core/vk_fence.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/core/vk_fence.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/core/vk_fence.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/descriptors/vk_descriptor_pool.o",
-      "src/renderer/descriptors/vk_descriptor_pool.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/descriptors/vk_descriptor_pool.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/descriptors/vk_descriptor_pool.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/images/texture_atlas.o",
-      "src/renderer/images/texture_atlas.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/images/texture_atlas.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/images/texture_atlas.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/descriptors/vk_descriptor_set.o",
-      "src/renderer/descriptors/vk_descriptor_set.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/descriptors/vk_descriptor_set.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/descriptors/vk_descriptor_set.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/swapchain/vk_framebuffer.o",
-      "src/renderer/swapchain/vk_framebuffer.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/swapchain/vk_framebuffer.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/swapchain/vk_framebuffer.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/pipeline/pipeline.o",
-      "src/renderer/pipeline/pipeline.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/pipeline/pipeline.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/pipeline/pipeline.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/images/vk_image.o",
-      "src/renderer/images/vk_image.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/images/vk_image.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/images/vk_image.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/descriptors/vk_descriptor_set_layout.o",
-      "src/renderer/descriptors/vk_descriptor_set_layout.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/descriptors/vk_descriptor_set_layout.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/descriptors/vk_descriptor_set_layout.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/swapchain/vk_imageview.o",
-      "src/renderer/swapchain/vk_imageview.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/swapchain/vk_imageview.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/swapchain/vk_imageview.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/swapchain/vk_swapchain.o",
-      "src/renderer/swapchain/vk_swapchain.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/swapchain/vk_swapchain.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/swapchain/vk_swapchain.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/swapchain/vk_render_pass.o",
-      "src/renderer/swapchain/vk_render_pass.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/swapchain/vk_render_pass.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/swapchain/vk_render_pass.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/platform/window.o",
-      "src/platform/window.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/platform/window.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/platform/window.o"
-  },
-  {
-    "arguments": [
-      "/usr/bin/clang++",
-      "-std=c++17",
-      "-O3",
-      "-fPIC",
-      "-D",
-      "IMAGE_OPTIMIZED",
-      "-I./includes",
-      "-I./src",
-      "-I./third_party",
-      "-c",
-      "-o",
-      "src/renderer/images/texture.o",
-      "src/renderer/images/texture.cpp"
-    ],
-    "directory": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX",
-    "file": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/images/texture.cpp",
-    "output": "/home/kbz_8/Documents/Programmation/42/other/MacroLibX/src/renderer/images/texture.o"
-  }
-]

compile_flags.txt

@@ -0,0 +1,12 @@
+-xc++
+-std=c++20
+-Iruntime/Includes
+-Iruntime/Sources
+-Iincludes
+-Ithird_party
+-DMLX_BUILD
+-DSDL_MAIN_HANDLED
+-DDEBUG
+-DIMAGE_OPTIMIZED
+-D_REENTRANT
+-isystem/usr/include/SDL2

example/build.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+
+if [ -e a.out ]; then
+	rm a.out
+fi
+
+if [ $(uname -s) = 'Darwin' ]; then
+	clang main.c ../libmlx.dylib -L /opt/homebrew/lib -lSDL2 -lm -g;
+else
+	clang main.c ../libmlx.so -lSDL2 -lm -g -Wall -Wextra -Werror;
+fi

example/main.c

@@ -0,0 +1,195 @@
+#include <stdio.h>
+#include <math.h>
+#include "../includes/mlx.h"
+#include "../includes/mlx_extended.h"
+
+typedef struct
+{
+	mlx_context mlx;
+	mlx_window win;
+	mlx_image logo_png;
+	mlx_image logo_jpg;
+	mlx_image logo_bmp;
+	mlx_image img;
+} mlx_t;
+
+#define CIRCLE_RADIUS 50
+#define CIRCLE_DIAMETER (CIRCLE_RADIUS + CIRCLE_RADIUS)
+
+static mlx_color pixels_circle[CIRCLE_DIAMETER * CIRCLE_DIAMETER] = { 0 };
+
+#define THRESHOLD 200
+
+void update(void* param)
+{
+	static int i = 0;
+	mlx_t* mlx = (mlx_t*)param;
+
+	if(i > THRESHOLD)
+	{
+		mlx_clear_window(mlx->mlx, mlx->win, (mlx_color){ .rgba = 0x334D4DFF });
+		mlx_put_transformed_image_to_window(mlx->mlx, mlx->win, mlx->logo_bmp, 220, 40, 0.5f, 0.5f, i);
+	}
+
+	if(i >= THRESHOLD + THRESHOLD / 4)
+		mlx_set_font_scale(mlx->mlx, "default", 16.f);
+	else
+		mlx_set_font_scale(mlx->mlx, "default", 6.f);
+
+	mlx_string_put(mlx->mlx, mlx->win, 160, 120, (mlx_color){ .rgba = 0xFF2066FF }, "this text should be behind");
+
+	mlx_put_image_to_window(mlx->mlx, mlx->win, mlx->logo_png, 100, 100);
+	mlx_put_image_to_window(mlx->mlx, mlx->win, mlx->img, 150, 60);
+
+	mlx_set_font(mlx->mlx, "default");
+	mlx_string_put(mlx->mlx, mlx->win, 20, 50, (mlx_color){ .rgba = 0xFFFFFFFF }, "that's a text");
+
+	uint32_t color = 0;
+	for(int j = 0; j < 400; j++)
+	{
+		mlx_pixel_put(mlx->mlx, mlx->win, j, j, (mlx_color){ .rgba = 0x0000FFFF + (color << 24) });
+		mlx_pixel_put(mlx->mlx, mlx->win, 399 - j, j, (mlx_color){ .rgba = 0x0000FFFF });
+		color += (color < 255);
+	}
+
+	if(i < THRESHOLD)
+		mlx_put_transformed_image_to_window(mlx->mlx, mlx->win, mlx->logo_jpg, 210, 150, 0.5f, 2.0f, 0.0f);
+	else
+		mlx_put_transformed_image_to_window(mlx->mlx, mlx->win, mlx->logo_jpg, 210, 150, fabs(sin(i / 100.0f)), fabs(cos(i / 100.0f) * 2.0f), 0.0f);
+	mlx_set_font_scale(mlx->mlx, "default", 8.f);
+	mlx_string_put(mlx->mlx, mlx->win, 210, 175, (mlx_color){ .rgba = 0xFFAF2BFF }, "hidden");
+
+	mlx_pixel_put_region(mlx->mlx, mlx->win, 200, 170, CIRCLE_DIAMETER, CIRCLE_DIAMETER, pixels_circle);
+
+	i++; // Will overflow and I don't care
+}
+
+mlx_image create_image(mlx_t* mlx)
+{
+	mlx_image img = mlx_new_image(mlx->mlx, 100, 100);
+	for(int i = 0, j = 0, k = 0; i < (100 * 100) * 4; i += 4, j++)
+	{
+		if(j >= 100)
+		{
+			j = 0;
+			k++;
+		}
+		if(i < 10000 || i > 20000)
+		{
+			mlx_color pixel = {
+				.r = (uint8_t)k,
+				.g = (uint8_t)j,
+				.b = (uint8_t)i,
+				.a = 0x99
+			};
+			mlx_set_image_pixel(mlx->mlx, img, j, k, pixel);
+		}
+	}
+	return img;
+}
+
+void key_hook(int key, void* param)
+{
+	int x;
+	int y;
+	mlx_t* mlx = (mlx_t*)param;
+
+	mlx_mouse_get_pos(mlx->mlx, &x, &y);
+	switch(key)
+	{
+		case 41 : // ESCAPE
+			mlx_loop_end(mlx->mlx);
+		break;
+		case 22 : // (S)how
+			mlx_mouse_show(mlx->mlx);
+		break;
+		case 11 : // (H)ide
+			mlx_mouse_hide(mlx->mlx);
+		break;
+		case 6 : // (C)lear
+			mlx_clear_window(mlx->mlx, mlx->win, (mlx_color){ .rgba = 0x334D4DFF });
+		break;
+		case 79 : // RIGHT KEY
+			mlx_mouse_move(mlx->mlx, mlx->win, x + 10, y);
+		break;
+		case 80 : // LEFT KEY
+			mlx_mouse_move(mlx->mlx, mlx->win, x - 10, y);
+		break;
+		case 81 : // UP KEY
+			mlx_mouse_move(mlx->mlx, mlx->win, x, y + 10);
+		break;
+		case 82 : // DOWN KEY
+			mlx_mouse_move(mlx->mlx, mlx->win, x, y - 10);
+		break;
+
+		default : break;
+	}
+}
+
+void window_hook(int event, void* param)
+{
+	if(event == 0)
+		mlx_loop_end(((mlx_t*)param)->mlx);
+}
+
+#include <stdlib.h>
+
+int main(void)
+{
+	mlx_t mlx;
+	int w;
+	int h;
+	int dummy;
+
+	int i = 0;
+	for(int j = 0; j < CIRCLE_DIAMETER; j++)
+	{
+		for(int k = 0; k < CIRCLE_DIAMETER; k++, i++)
+		{
+			if((CIRCLE_RADIUS - j) * (CIRCLE_RADIUS - j) + (CIRCLE_RADIUS - k) * (CIRCLE_RADIUS - k) < CIRCLE_RADIUS * CIRCLE_RADIUS)
+				pixels_circle[i] = (mlx_color){ .rgba = 0xA10000FF + ((j * k * i) << 8) };
+		}
+	}
+
+	mlx.mlx = mlx_init();
+
+	mlx_window_create_info info = { 0 };
+	info.title = "My window";
+	info.width = 400;
+	info.height = 400;
+	info.is_resizable = true;
+	mlx.win = mlx_new_window(mlx.mlx, &info);
+
+	mlx_get_screen_size(mlx.mlx, mlx.win, &w, &h);
+	printf("screen size : %dx%d\n", w, h);
+
+	mlx_set_fps_goal(mlx.mlx, 60);
+
+	mlx_on_event(mlx.mlx, mlx.win, MLX_KEYDOWN, key_hook, &mlx);
+	mlx_on_event(mlx.mlx, mlx.win, MLX_WINDOW_EVENT, window_hook, &mlx);
+
+	mlx.logo_bmp = mlx_new_image_from_file(mlx.mlx, "42_logo.bmp", &dummy, &dummy);
+	mlx.logo_png = mlx_new_image_from_file(mlx.mlx, "42_logo.png", &dummy, &dummy);
+	mlx.logo_jpg = mlx_new_image_from_file(mlx.mlx, "42_logo.jpg", &dummy, &dummy);
+
+	mlx_pixel_put(mlx.mlx, mlx.win, 200, 10, (mlx_color){ .rgba = 0xFF00FFFF });
+	mlx_put_image_to_window(mlx.mlx, mlx.win, mlx.logo_png, 0, 0);
+
+	mlx.img = create_image(&mlx);
+
+	mlx_set_font_scale(mlx.mlx, "font.ttf", 16.f);
+	mlx_string_put(mlx.mlx, mlx.win, 20, 20, (mlx_color){ .rgba = 0x0020FFFF }, "that text will disappear");
+
+	mlx_add_loop_hook(mlx.mlx, update, &mlx);
+	mlx_loop(mlx.mlx);
+
+	mlx_destroy_image(mlx.mlx, mlx.logo_png);
+	mlx_destroy_image(mlx.mlx, mlx.logo_jpg);
+	mlx_destroy_image(mlx.mlx, mlx.logo_bmp);
+	mlx_destroy_image(mlx.mlx, mlx.img);
+	mlx_destroy_window(mlx.mlx, mlx.win);
+	
+	mlx_destroy_context(mlx.mlx);
+
+	return 0;
+}

example/run.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+
+bash ./build.sh
+./a.out

in_depth_features/build.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+
+if [ -e a.out ]; then
+	rm a.out
+fi
+
+if [ $(uname -s) = 'Darwin' ]; then
+	clang main.c ../../libmlx.dylib -L /opt/homebrew/lib -lSDL2 -lm -g;
+else
+	clang main.c ../../libmlx.so -lSDL2 -g -Wall -Wextra -Werror -lm;
+fi

in_depth_features/main.c

@@ -0,0 +1,99 @@
+#include <math.h>
+#include <stddef.h>
+#include "../../includes/mlx.h"
+#include "../../includes/mlx_extended.h"
+
+typedef struct
+{
+	mlx_context mlx;
+	mlx_window win;
+	mlx_image render_target;
+	mlx_window render_target_window;
+} mlx_t;
+
+void update(void* param)
+{
+	mlx_t* mlx = (mlx_t*)param;
+
+	mlx_clear_window(mlx->mlx, mlx->win, (mlx_color){ .rgba = 0x334D4DFF });
+
+	mlx_string_put(mlx->mlx, mlx->win, 160, 120, (mlx_color){ .rgba = 0xFF2066FF }, "text");
+	mlx_string_put(mlx->mlx, mlx->win, 20, 50, (mlx_color){ .rgba = 0xFFFFFFFF }, "that's a text");
+
+	for(int j = 0, color = 0; j < 400; j++)
+	{
+		mlx_pixel_put(mlx->mlx, mlx->win, j, j, (mlx_color){ .rgba = 0xFF0000FF + (color << 8) });
+		mlx_pixel_put(mlx->mlx, mlx->win, 399 - j, j, (mlx_color){ .rgba = 0x0000FFFF });
+		color += (color < 255);
+	}
+
+	for(int j = 0; j < 20; j++)
+	{
+		for(int k = 0; k < 20; k++)
+			mlx_pixel_put(mlx->mlx, mlx->win, 220 + j, 160 + k, (mlx_color){ .rgba = 0xFF0000FF });
+	}
+
+	mlx_string_put(mlx->mlx, mlx->render_target_window, 20, 20, (mlx_color){ .rgba = 0xAF2BFFFF }, "yippeeee");
+	for(int j = 0, color = 0; j < 200; j++)
+	{
+		mlx_pixel_put(mlx->mlx, mlx->render_target_window, j, j, (mlx_color){ .rgba = 0xFF0000FF + (color << 8) });
+		mlx_pixel_put(mlx->mlx, mlx->render_target_window, 199 - j, j, (mlx_color){ .rgba = 0x0000FFFF });
+		color += (color < 255);
+	}
+
+	static int i = 0;
+	i++;
+	mlx_put_transformed_image_to_window(mlx->mlx, mlx->win, mlx->render_target, 5, 100, 1.0f, 1.0f, i);
+}
+
+void key_hook(int key, void* param)
+{
+	mlx_t* mlx = (mlx_t*)param;
+	if(key == 41)
+		mlx_loop_end(mlx->mlx);
+}
+
+void window_hook(int event, void* param)
+{
+	if(event == 0)
+		mlx_loop_end(((mlx_t*)param)->mlx);
+}
+
+int main(void)
+{
+	mlx_t mlx;
+
+	mlx.mlx = mlx_init();
+
+	mlx_set_fps_goal(mlx.mlx, 60);
+
+	mlx_window_create_info info = { 0 };
+	info.title = "My window";
+	info.width = 400;
+	info.height = 400;
+	info.is_resizable = true;
+	mlx.win = mlx_new_window(mlx.mlx, &info);
+
+	mlx.render_target = mlx_new_image(mlx.mlx, 200, 200);
+	info.render_target = mlx.render_target;
+	info.title = NULL;
+	info.width = 200;
+	info.height = 200;
+	mlx.render_target_window = mlx_new_window(mlx.mlx, &info);
+	mlx_clear_window(mlx.mlx, mlx.render_target_window, (mlx_color){ .rgba = 0xC16868FF });
+
+	mlx_on_event(mlx.mlx, mlx.win, MLX_KEYDOWN, key_hook, &mlx);
+	mlx_on_event(mlx.mlx, mlx.win, MLX_WINDOW_EVENT, window_hook, &mlx);
+
+	mlx_add_loop_hook(mlx.mlx, update, &mlx);
+	mlx_loop(mlx.mlx);
+
+	mlx_destroy_window(mlx.mlx, mlx.win);
+	
+	mlx_destroy_window(mlx.mlx, mlx.render_target_window);
+	mlx_destroy_image(mlx.mlx, mlx.render_target);
+	
+	mlx_destroy_context(mlx.mlx);
+
+	return 0;
+}

in_depth_features/run.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+
+bash ./build.sh
+./a.out

includes/mlx.h

@@ -3,37 +3,283 @@
 /*                                                        :::      ::::::::   */
 /*   mlx.h                                              :+:      :+:    :+:   */
 /*                                                    +:+ +:+         +:+     */
-/*   By: maldavid <kbz_8.dev@akel-engine.com>       +#+  +:+       +#+        */
+/*   By: maldavid <contact@kbz8.me>                 +#+  +:+       +#+        */
 /*                                                +#+#+#+#+#+   +#+           */
 /*   Created: 2022/10/04 16:56:35 by maldavid          #+#    #+#             */
-/*   Updated: 2023/12/08 18:07:40 by kbz_8            ###   ########.fr       */
+/*   Updated: 2025/01/05 22:44:22 by maldavid         ###   ########.fr       */
 /*                                                                            */
 /* ************************************************************************** */
 
-// MacroLibX official repo https://github.com/420verfl0w/MacroLibX
+// MacroLibX official repo https://github.com/seekrs/MacroLibX
+// MacroLibX official website https://macrolibx.kbz8.me/
 
-#ifndef __MACRO_LIB_X_H__
+#ifndef MACROLIB_X_H
-#define __MACRO_LIB_X_H__
+#define MACROLIB_X_H
 
-#if defined(_WIN32) || defined(_WIN64)
+#include <stdbool.h>
-	#define MLX_EXPORT __declspec(dllexport)
+#include "mlx_profile.h"
-	#define MLX_IMPORT __declspec(dllimport)
-#else
-	#define MLX_EXPORT
-	#define MLX_IMPORT
-#endif
-
-#ifdef MLX_BUILD
-	#define MLX_API MLX_EXPORT
-#else
-	#define MLX_API MLX_IMPORT
-#endif
 
 #ifdef __cplusplus
 extern "C" {
 #endif
 
-typedef enum
+
+        /* MLX types */
+
+/**
+ * @brief           Opaque handle that represents the MLX context
+ */
+MLX_DEFINE_HANDLE(mlx_context);
+
+/**
+ * @brief           Opaque handle that represents a MLX window
+ */
+MLX_DEFINE_HANDLE(mlx_window);
+
+/**
+ * @brief           Opaque handle that represents a MLX image
+ */
+MLX_DEFINE_HANDLE(mlx_image);
+
+/**
+ * @brief           Union representing RGBA color with access to each part as bytes
+ */
+typedef union mlx_color
+{
+	struct
+	{
+		#if MLX_BYTEORDER == MLX_LITTLE_ENDIAN
+			uint8_t a;
+			uint8_t b;
+			uint8_t g;
+			uint8_t r;
+		#else
+			uint8_t r;
+			uint8_t g;
+			uint8_t b;
+			uint8_t a;
+		#endif
+	};
+	uint32_t rgba;
+} mlx_color;
+
+
+
+        /* MLX backend related functions */
+
+
+/**
+ * @brief           Initializes the MLX internal application
+ *
+ * @return (mlx_context) An opaque handler to the internal MLX application or NULL (0x0) in case of error
+ */
+MLX_API mlx_context mlx_init();
+
+/**
+ * @brief            Caps the FPS
+ *
+ * @param mlx        Internal MLX application
+ * @param fps        The FPS cap or 0 for vsync
+ */
+MLX_API void mlx_set_fps_goal(mlx_context mlx, int fps);
+
+/**
+ * @brief            Destroy internal MLX application
+ *
+ * @param mlx        Internal MLX application
+ */
+MLX_API void mlx_destroy_context(mlx_context mlx);
+
+
+
+        /* Window related functions */
+
+
+/**
+ * @brief           Descriptor structure for window creation
+ *
+ * Note: if a valid mlx_image is passed as render_target, this window will not be a real system window
+ * and will rather act as a gate to use any draw function to draw directly on an image.
+ *
+ * Ex: you could use mlx_string_put or mlx_pixel_put to draw on a given image and then use this image
+ * with mlx_put_image_to_window to render it on a real window.
+ *
+ * See experimental/RenderToTexture/main.c for a concrete example.
+ */
+typedef struct mlx_window_create_info
+{
+	mlx_image render_target;
+	const char* title;
+	int width;
+	int height;
+	bool is_fullscreen;
+	bool is_resizable;
+} mlx_window_create_info;
+
+/**
+ * @brief            Creates a new window
+ *
+ * @param mlx        Internal MLX application
+ * @param info       Pointer to a descriptor structure
+ *
+ * @return (mlx_widnow) An opaque handler to the internal MLX window or NULL (0x0) in case of error
+ */
+MLX_API mlx_window mlx_new_window(mlx_context mlx, const mlx_window_create_info* info);
+
+/**
+ * @brief            Destroys internal window
+ *
+ * @param mlx        Internal MLX application
+ * @param win        Internal window
+ */
+MLX_API void mlx_destroy_window(mlx_context mlx, mlx_window win);
+
+/**
+ * @brief            Sets window position
+ *
+ * @param mlx        Internal MLX application
+ * @param win        Internal window to move
+ * @param x          New x position
+ * @param y          New y position
+ */
+MLX_API void mlx_set_window_position(mlx_context mlx, mlx_window win, int x, int y);
+
+/**
+ * @brief            Sets window size
+ *
+ * @param mlx        Internal MLX application
+ * @param win        Internal window to move
+ * @param width      New width
+ * @param height     New height
+ */
+MLX_API void mlx_set_window_size(mlx_context mlx, mlx_window win, int width, int height);
+
+/**
+ * @brief            Sets window title
+ *
+ * @param mlx        Internal MLX application
+ * @param win        Internal window to move
+ * @param title      New title
+ */
+MLX_API void mlx_set_window_title(mlx_context mlx, mlx_window win, const char* title);
+
+/**
+ * @brief            Enables/Disables window fullscreen mode
+ *
+ * @param mlx        Internal MLX application
+ * @param win        Internal window to move
+ * @param enable     Switch or not to fullscreen
+ */
+MLX_API void mlx_set_window_fullscreen(mlx_context mlx, mlx_window win, bool enable);
+
+/**
+ * @brief            Gets window position
+ *
+ * @param mlx        Internal MLX application
+ * @param win        Internal window to move
+ * @param x          Pointers to get position of the window
+ * @param y          Pointers to get position of the window
+ */
+MLX_API void mlx_get_window_position(mlx_context mlx, mlx_window win, int* x, int* y);
+
+/**
+ * @brief            Gets window size
+ *
+ * @param mlx        Internal MLX application
+ * @param win        Internal window to move
+ * @param x          Pointers to get size of the window
+ * @param y          Pointers to get size of the window
+ */
+MLX_API void mlx_get_window_size(mlx_context mlx, mlx_window win, int* x, int* y);
+
+/**
+ * @brief            Clears the given window (resets all rendered data)
+ *
+ * @param mlx        Internal MLX application
+ * @param win        Internal window
+ */
+MLX_API void mlx_clear_window(mlx_context mlx, mlx_window win, mlx_color color);
+
+/**
+ * @brief            Get the size of the screen the given window is on
+ *
+ * @param mlx        Internal MLX application
+ * @param win        Internal window to choose screen the window is on
+ * @param w          Get width size
+ * @param h          Get height size
+ */
+MLX_API void mlx_get_screen_size(mlx_context mlx, mlx_window win, int* w, int* h);
+
+
+
+        /* Loop related functions */
+
+
+/**
+ * @brief            Gives another function to be executed at each loop turn
+ *
+ * @param mlx        Internal MLX application
+ * @param f          The function
+ * @param param      Param to give to the function passed
+ */
+MLX_API void mlx_add_loop_hook(mlx_context mlx, void(*f)(void*), void* param);
+
+/**
+ * @brief            Starts the internal main loop
+ *
+ * @param mlx        Internal MLX application
+ */
+MLX_API void mlx_loop(mlx_context mlx);
+
+/**
+ * @brief            Ends the internal run loop
+ *
+ * @param mlx        Internal MLX application
+ */
+MLX_API void mlx_loop_end(mlx_context mlx);
+
+
+
+        /* Events related functions */
+
+
+/**
+ * @brief            Shows mouse cursor
+ *
+ * @param mlx        Internal MLX application
+ */
+MLX_API void mlx_mouse_show(mlx_context mlx);
+
+/**
+ * @brief            Hides mouse cursor
+ *
+ * @param mlx        Internal MLX application
+ */
+MLX_API void mlx_mouse_hide(mlx_context mlx);
+
+/**
+ * @brief            Moves cursor to givent position
+ *
+ * @param mlx        Internal MLX application
+ * @param win        Internal window from which cursor moves
+ * @param x          X coordinate
+ * @param y          Y coordinate
+ */
+MLX_API void mlx_mouse_move(mlx_context mlx, mlx_window win, int x, int y);
+
+/**
+ * @brief            Get cursor's position
+ *
+ * @param mlx        Internal MLX application
+ * @param x          Get x coordinate
+ * @param y          Get y coordinate
+ */
+MLX_API void mlx_mouse_get_pos(mlx_context mlx, int* x, int* y);
+
+/**
+ * @brief            Type of event
+ */
+typedef enum mlx_event_type
 {
 	MLX_KEYDOWN = 0,
 	MLX_KEYUP = 1,
@@ -44,316 +290,153 @@ typedef enum
 } mlx_event_type;
 
 /**
- * @brief			Initializes the MLX internal application
+ * @brief            Gives a function to be executed on event type, does not override previous functions
  *
- * @return (void*)	An opaque pointer to the internal MLX application or NULL (0x0) in case of error
+ * @param mlx        Internal MLX application
+ * @param win        Internal window
+ * @param event      Event type (see union on top of this file)
+ * @param f          Function to be executed
+ * @param param      Parameter given to the function
  */
-MLX_API void* mlx_init();
+MLX_API void mlx_on_event(mlx_context mlx, mlx_window win, mlx_event_type event, void(*f)(int, void*), void* param);
 
-/**
- * @brief			Creates a new window
- *
- * @param mlx		Internal MLX application
- * @param w			Width of the window
- * @param h			Height of the window
- * @param title		Title of the window
- *
- * @return (void*)	An opaque pointer to the internal MLX window or NULL (0x0) in case of error
- */
-MLX_API void* mlx_new_window(void* mlx, int w, int h, const char* title);
 
-/**
- * @brief			Gives a function to be executed at each loop turn
- *
- * @param mlx		Internal MLX application
- * @param f			The function
- * @param param		Param to give to the function passed
- *
- * @return (int)	Always return 0, made this to copy the behaviour of the original MLX
- */
 
-MLX_API int mlx_loop_hook(void* mlx, int (*f)(void*), void* param);
+        /* Pixels drawing related functions */
-
-/**
- * @brief			Starts the internal main loop
- *
- * @param mlx		Internal MLX application
- *
- * @return (int)	Always return 0, made this to copy the behaviour of the original MLX
- */
-MLX_API int mlx_loop(void* mlx);
-
-/**
- * @brief			Ends the internal main loop
- *
- * @param mlx		Internal MLX application
- *
- * @return (int)	Always return 0, made this to copy the behaviour of the original MLX
- */
-MLX_API int mlx_loop_end(void* mlx);
-
-/**
- * @brief			Shows mouse cursor
- *
- * @return (int)	Always return 0, made this to copy the behaviour of the original MLX
- */
-MLX_API int mlx_mouse_show();
-
-/**
- * @brief			Hides mouse cursor
- *
- * @return (int)	Always return 0, made this to copy the behaviour of the original MLX
- */
-MLX_API int mlx_mouse_hide();
-
-/**
- * @brief			Moves cursor to givent position
- *
- * @param mlx		Internal MLX application
- * @param win		Internal window from which cursor moves
- * @param x			X coordinate
- * @param y			Y coordinate
- *
- * @return (int)	Always return 0, made this to copy the behaviour of the original MLX
- */
-MLX_API int mlx_mouse_move(void* mlx, void* win, int x, int y);
-
-/**
- * @brief			Get cursor's position
- *
- * @param mlx		Internal MLX application
- * @param x			Get x coordinate
- * @param y			Get y coordinate
- *
- * @return (int)	Always return 0, made this to copy the behaviour of the original MLX
- */
-MLX_API int mlx_mouse_get_pos(void* mlx, int* x, int* y);
 
 
 /**
- * @brief			Gives a function to be executed on event type
+ * @brief            Put a pixel in the window
  *
- * @param mlx		Internal MLX application
+ * @param mlx        Internal MLX application
- * @param win		Internal window
+ * @param win        Internal window
- * @param event		Event type (see union on top of this file)
+ * @param x          X coordinate
- * @param f			Function to be executed
+ * @param y          Y coordinate
- * @param param		Parameter given to the function
+ * @param color      Color of the pixel
- *
- * @return (int)	Always return 0, made this to copy the behaviour of the original MLX
  */
-MLX_API int mlx_on_event(void* mlx, void* win, mlx_event_type event, int (*f)(int, void*), void* param);
+MLX_API void mlx_pixel_put(mlx_context mlx, mlx_window win, int x, int y, mlx_color color);
+
+
+
+        /* Images related functions */
 
 
 /**
- * @brief			Put a pixel in the window
+ * @brief            Create a new empty image
  *
- * @param mlx		Internal MLX application
+ * @param mlx        Internal MLX application
- * @param win		Internal window
+ * @param width      Width of the image
- * @param x			X coordinate
+ * @param height     Height of the image
- * @param y			Y coordinate
- * @param color		Color of the pixel (coded on 3 bytes in an int, 0x00RRGGBB)
  *
- * Note : If your're reading pixel colors from an image, don't forget to shift them 
+ * @return (mlx_image) An opaque handler to the internal image or NULL (0x0) in case of error
- * one byte to the right as image pixels are encoded as 0xRRGGBBAA and pixel put takes 0x00RRGGBB.
- * 
- * @return (int)	Always return 0, made this to copy the behaviour of the original MLX
  */
-MLX_API int mlx_pixel_put(void* mlx, void* win, int x, int y, int color);
+MLX_API mlx_image mlx_new_image(mlx_context mlx, int width, int height);
-
 
 /**
- * @brief			Create a new empty image
+ * @brief            Create a new image from a png/jpg/bmp file
  *
- * @param mlx		Internal MLX application
+ * @param mlx        Internal MLX application
- * @param width		Width of the image
+ * @param filename   Path to the png file
- * @param height	Height of the image
+ * @param width      Get the width of the image
+ * @param heigth     Get the height of the image
  *
- * @return (void*)	An opaque pointer to the internal image or NULL (0x0) in case of error
+ * @return (mlx_image) An opaque handler to the internal image or NULL (0x0) in case of error
  */
-MLX_API void* mlx_new_image(void* mlx, int width, int height);
+MLX_API mlx_image mlx_new_image_from_file(mlx_context mlx, char* filename, int* width, int* height);
 
 /**
- * @brief					Get image pixel data
+ * @brief            Destroys internal image
  *
- * @param mlx				Internal MLX application
+ * @param mlx        Internal MLX application
- * @param img				Internal image
+ * @param img        Internal image
- * @param x					X coordinate in the image
+ */
- * @param y					Y coordinate in the image
+MLX_API void mlx_destroy_image(mlx_context mlx, mlx_image image);
+
+/**
+ * @brief            Get image pixel data
  *
- * @return (int)			Return the pixel data
+ * @param mlx        Internal MLX application
+ * @param img        Internal image
+ * @param x          X coordinate in the image
+ * @param y          Y coordinate in the image
+ *
+ * @return (int)     Return the pixel data
  *
  * /!\ If you run into glitches when writing or reading pixels from images /!\
  * You need to add IMAGES_OPTIMIZED=false to your make mlx command
  * ```
- * 	~ git clone https://github.com/420verfl0w/MacroLibX.git
+ *     ~ git clone https://github.com/seekrs/MacroLibX.git
- * 	~ cd MacroLibX
+ *     ~ cd MacroLibX
- * 	~ make IMAGES_OPTIMIZED=false
+ *     ~ make IMAGES_OPTIMIZED=false
  * ```
  */
-MLX_API int mlx_get_image_pixel(void* mlx, void* img, int x, int y);
+MLX_API mlx_color mlx_get_image_pixel(mlx_context mlx, mlx_image image, int x, int y);
 
 /**
- * @brief					Set image pixel data
+ * @brief            Set image pixel data
  *
- * @param mlx				Internal MLX application
+ * @param mlx        Internal MLX application
- * @param img				Internal image
+ * @param img        Internal image
- * @param x					X coordinate in the image
+ * @param x          X coordinate in the image
- * @param y					Y coordinate in the image
+ * @param y          Y coordinate in the image
- * @param color				Color of the pixel to set
+ * @param color      Color of the pixel to set
- *
- * @return (void)
  *
  * /!\ If you run into glitches when writing or reading pixels from images /!\
  * You need to add IMAGES_OPTIMIZED=false to your make mlx command
  * ```
- * 	~ git clone https://github.com/420verfl0w/MacroLibX.git
+ *     ~ git clone https://github.com/seekrs/MacroLibX.git
- * 	~ cd MacroLibX
+ *     ~ cd MacroLibX
- * 	~ make IMAGES_OPTIMIZED=false
+ *     ~ make IMAGES_OPTIMIZED=false
  * ```
  */
-MLX_API void mlx_set_image_pixel(void* mlx, void* img, int x, int y, int color);
+MLX_API void mlx_set_image_pixel(mlx_context mlx, mlx_image image, int x, int y, mlx_color color);
 
 /**
- * @brief			Put image to the given window
+ * @brief            Put image to the given window
  *
- * @param mlx		Internal MLX application
+ * @param mlx        Internal MLX application
- * @param win		Internal window
+ * @param win        Internal window
- * @param img		Internal image
+ * @param img        Internal image
- * @param x			X coordinate
+ * @param x          X coordinate
- * @param y			Y coordinate
+ * @param y          Y coordinate
- *
- * @return (int)	Always return 0, made this to copy the behaviour of the original MLX
  */
-MLX_API int mlx_put_image_to_window(void* mlx, void* win, void* img, int x, int y);
+MLX_API void mlx_put_image_to_window(mlx_context mlx, mlx_window win, mlx_image image, int x, int y);
 
-/**
+
- * @brief			Destroys internal image
+
- *
+        /* Strings drawing related functions */
- * @param mlx		Internal MLX application
- * @param img		Internal image
- *
- * @return (int)	Always return 0, made this to copy the behaviour of the original MLX
- */
-MLX_API int mlx_destroy_image(void* mlx, void* img);
 
 
 /**
- * @brief			Create a new image from a png file
+ * @brief            Put text in given window
  *
- * @param mlx		Internal MLX application
+ * @param mlx        Internal MLX application
- * @param filename	Path to the png file
+ * @param win        Internal window
- * @param width		Get the width of the image
+ * @param x          X coordinate
- * @param heigth	Get the height of the image
+ * @param y          Y coordinate
- *
+ * @param color      Color of the pixel
- * @return (void*)	An opaque pointer to the internal image or NULL (0x0) in case of error
+ * @param str        Text to put
  */
-MLX_API void* mlx_png_file_to_image(void* mlx, char* filename, int* width, int* height);
+MLX_API void mlx_string_put(mlx_context mlx, mlx_window win, int x, int y, mlx_color color, char* str);
 
 /**
- * @brief			Create a new image from a jpg file
+ * @brief            Loads a font to be used by `mlx_string_put`
  *
- * @param mlx		Internal MLX application
+ * @param mlx        Internal MLX application
- * @param filename	Path to the jpg file
+ * @param win        Internal window
- * @param width		Get the width of the image
+ * @param filepath   Filepath to the font or "default" to reset to the embedded font
- * @param heigth	Get the height of the image
- *
- * @return (void*)	An opaque pointer to the internal image or NULL (0x0) in case of error
  */
-MLX_API void* mlx_jpg_file_to_image(void* mlx, char* filename, int* width, int* height);
+MLX_API void mlx_set_font(mlx_context mlx, char* filepath);
 
 /**
- * @brief			Create a new image from a bmp file
+ * @brief            Loads a font to be used by `mlx_string_put` and scales it
  *
- * @param mlx		Internal MLX application
+ * @param mlx        Internal MLX application
- * @param filename	Path to the bmp file
+ * @param win        Internal window
- * @param width		Get the width of the image
+ * @param filepath   Filepath to the font or "default" to reset to the embedded font
- * @param heigth	Get the height of the image
+ * @param scale      Scale to apply to the font
- *
- * @return (void*)	An opaque pointer to the internal image or NULL (0x0) in case of error
  */
-MLX_API void* mlx_bmp_file_to_image(void* mlx, char* filename, int* width, int* height);
+MLX_API void mlx_set_font_scale(mlx_context mlx, char* filepath, float scale);
-
-
-/**
- * @brief			Put text in given window
- *
- * @param mlx		Internal MLX application
- * @param win		Internal window
- * @param x			X coordinate
- * @param y			Y coordinate
- * @param color		Color of the pixel (coded on 3 bytes in an int, 0x00RRGGBB)
- * @param str		Text to put
- *
- * @return (int)	Always return 0, made this to copy the behaviour of the original MLX
- */
-MLX_API int mlx_string_put(void* mlx, void* win, int x, int y, int color, char* str);
-
-
-/**
- * @brief			Loads a font to be used by `mlx_string_put`
- *
- * @param mlx		Internal MLX application
- * @param win		Internal window
- * @param filepath	Filepath to the font
- *
- * @return (void)	
- */
-MLX_API void mlx_set_font(void* mlx, void* win, char* filepath);
-
-/**
- * @brief			Loads a font to be used by `mlx_string_put` and scales it
- *
- * @param mlx		Internal MLX application
- * @param win		Internal window
- * @param filepath	Filepath to the font
- * @param scale		Scale to apply to the font
- *
- * @return (void)	
- */
-MLX_API void mlx_set_font_scale(void* mlx, void* win, char* filepath, float scale);
-
-
-/**
- * @brief			Clears the given window (resets all rendered data)
- *
- * @param mlx		Internal MLX application
- * @param win		Internal window
- *
- * @return (int)	Always return 0, made this to copy the behaviour of the original MLX
- */
-MLX_API int mlx_clear_window(void* mlx, void* win);
-
-
-/**
- * @brief			Destroys internal window
- *
- * @param mlx		Internal MLX application
- * @param win		Internal window
- *
- * @return (int)	Always return 0, made this to copy the behaviour of the original MLX
- */
-MLX_API int mlx_destroy_window(void* mlx, void* win);
-
-/**
- * @brief			Destroy internal MLX application
- *
- * @param mlx		Internal MLX application
- *
- * @return (int)	Always return 0, made this to copy the behaviour of the original MLX
- */
-MLX_API int mlx_destroy_display(void* mlx);
-
-
-/**
- * @brief			Get screen size
- *
- * @param mlx		Internal MLX application
- * @param x			Get X size
- * @param y			Get Y size
- *
- * @return (int)	Always return 0, made this to copy the behaviour of the original MLX
- */
-MLX_API int mlx_get_screens_size(void* mlx, int* w, int* h);
 
 #ifdef __cplusplus
 }

includes/mlx_extended.h

@@ -0,0 +1,178 @@
+/* ************************************************************************** */
+/*                                                                            */
+/*                                                        :::      ::::::::   */
+/*   mlx_extended.h                                     :+:      :+:    :+:   */
+/*                                                    +:+ +:+         +:+     */
+/*   By: maldavid <contact@kbz8.me>                 +#+  +:+       +#+        */
+/*                                                +#+#+#+#+#+   +#+           */
+/*   Created: 2024/12/14 16:17:10 by maldavid          #+#    #+#             */
+/*   Updated: 2025/01/08 12:37:15 by maldavid         ###   ########.fr       */
+/*                                                                            */
+/* ************************************************************************** */
+
+// MacroLibX official repo https://github.com/seekrs/MacroLibX
+// MacroLibX official website https://macrolibx.kbz8.me/
+
+#ifndef MACROLIB_X_EXTENDED_H
+#define MACROLIB_X_EXTENDED_H
+
+#include "mlx.h"
+#include <stddef.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+
+        /* Window related functions */
+
+
+/**
+ * @brief            Sets maximum window size
+ *
+ * @param mlx        Internal MLX application
+ * @param win        Internal window to move
+ * @param x          New x maximum size
+ * @param y          New y maximum size
+ */
+MLX_API void mlx_set_window_max_size(mlx_context mlx, mlx_window win, int x, int y);
+
+/**
+ * @brief            Sets minimum window size
+ *
+ * @param mlx        Internal MLX application
+ * @param win        Internal window to move
+ * @param x          New x minimum size
+ * @param y          New y minimum size
+ */
+MLX_API void mlx_set_window_min_size(mlx_context mlx, mlx_window win, int x, int y);
+
+/**
+ * @brief            Maximizes a window
+ *
+ * @param mlx        Internal MLX application
+ * @param win        Internal window to move
+ */
+MLX_API void mlx_maximise_window(mlx_context mlx, mlx_window win);
+
+/**
+ * @brief            Minimizes a window
+ *
+ * @param mlx        Internal MLX application
+ * @param win        Internal window to move
+ */
+MLX_API void mlx_minimize_window(mlx_context mlx, mlx_window win);
+
+/**
+ * @brief            Restore window to formal size
+ *
+ * @param mlx        Internal MLX application
+ * @param win        Internal window to move
+ */
+MLX_API void mlx_restore_window(mlx_context mlx, mlx_window win);
+
+
+
+        /* Pixels drawing related functions */
+
+
+/**
+ * @brief            Put an array of pixels in the window
+ *
+ * @param mlx        Internal MLX application
+ * @param win        Internal window
+ * @param x          X coordinate
+ * @param y          Y coordinate
+ * @param pixels     Array of pixels
+ * @param pixels_number Number of pixels
+ */
+MLX_API void mlx_pixel_put_array(mlx_context mlx, mlx_window win, int x, int y, mlx_color* pixels, size_t pixels_number);
+
+/**
+ * @brief            Put a region of pixels in the window
+ *
+ * @param mlx        Internal MLX application
+ * @param win        Internal window
+ * @param x          X coordinate
+ * @param y          Y coordinate
+ * @param w          Width
+ * @param h          Height
+ * @param pixels     Array of pixels
+ *
+ * Note: it is responsability of the user to make sure the size of `pixels` is
+ * big enough for the given region.
+ */
+MLX_API void mlx_pixel_put_region(mlx_context mlx, mlx_window win, int x, int y, int w, int h, mlx_color* pixels);
+
+
+
+        /* Images related functions */
+
+
+/**
+ * @brief            Get image region
+ *
+ * @param mlx        Internal MLX application
+ * @param img        Internal image
+ * @param x          X coordinate in the image
+ * @param y          Y coordinate in the image
+ * @param w          Width of the region
+ * @param y          Height of the region
+ * @param dst        Array of pixels to copy to
+ *
+ * Note: it is responsability of the user to make sure the size of `dst` is
+ * big enough for the given region.
+ *
+ * /!\ If you run into glitches when writing or reading pixels from images /!\
+ * You need to add IMAGES_OPTIMIZED=false to your make mlx command
+ * ```
+ *     ~ git clone https://github.com/seekrs/MacroLibX.git
+ *     ~ cd MacroLibX
+ *     ~ make IMAGES_OPTIMIZED=false
+ * ```
+ */
+MLX_API void mlx_get_image_region(mlx_context mlx, mlx_image image, int x, int y, int w, int h, mlx_color* dst);
+
+/**
+ * @brief            Set image region
+ *
+ * @param mlx        Internal MLX application
+ * @param img        Internal image
+ * @param x          X coordinate in the image
+ * @param y          Y coordinate in the image
+ * @param w          Width of the region
+ * @param y          Height of the region
+ * @param pixels     Array of pixels to copy from
+ *
+ * Note: it is responsability of the user to make sure the size of `pixels` is
+ * big enough for the given region.
+ *
+ * /!\ If you run into glitches when writing or reading pixels from images /!\
+ * You need to add IMAGES_OPTIMIZED=false to your make mlx command
+ * ```
+ *     ~ git clone https://github.com/seekrs/MacroLibX.git
+ *     ~ cd MacroLibX
+ *     ~ make IMAGES_OPTIMIZED=false
+ * ```
+ */
+MLX_API void mlx_set_image_region(mlx_context mlx, mlx_image image, int x, int y, int w, int h, mlx_color* pixels);
+
+/**
+ * @brief            Transform and put image to the given window
+ *
+ * @param mlx        Internal MLX application
+ * @param win        Internal window
+ * @param img        Internal image
+ * @param x          X coordinate
+ * @param y          Y coordinate
+ * @param scale_x    Scale x of the image
+ * @param scale_y    Scale y of the image
+ * @param angle      Rotation angle of the image (clockwise)
+ */
+MLX_API void mlx_put_transformed_image_to_window(mlx_context mlx, mlx_window win, mlx_image image, int x, int y, float scale_x, float scale_y, float angle);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif

includes/mlx_profile.h

@@ -0,0 +1,259 @@
+/* ************************************************************************** */
+/*                                                                            */
+/*                                                        :::      ::::::::   */
+/*   mlx_profile.h                                      :+:      :+:    :+:   */
+/*                                                    +:+ +:+         +:+     */
+/*   By: maldavid <kbz_8.dev@akel-engine.com>       +#+  +:+       +#+        */
+/*                                                +#+#+#+#+#+   +#+           */
+/*   Created: 2023/11/10 08:49:17 by maldavid          #+#    #+#             */
+/*   Updated: 2025/01/07 00:17:45 by maldavid         ###   ########.fr       */
+/*                                                                            */
+/* ************************************************************************** */
+
+#ifndef MACROLIBX_PROFILE_H
+#define MACROLIBX_PROFILE_H
+
+// Try to identify the compiler
+#if defined(__BORLANDC__)
+	#define MLX_COMPILER_BORDLAND
+#elif defined(__clang__)
+	#define MLX_COMPILER_CLANG
+	#ifdef __MINGW32__
+		#define MLX_COMPILER_MINGW
+		#ifdef __MINGW64_VERSION_MAJOR
+			#define MLX_COMPILER_MINGW_W64
+		#endif
+	#endif
+#elif defined(__GNUC__) || defined(__MINGW32__)
+	#define MLX_COMPILER_GCC
+	#ifdef __MINGW32__
+		#define MLX_COMPILER_MINGW
+		#ifdef __MINGW64_VERSION_MAJOR
+			#define MLX_COMPILER_MINGW_W64
+		#endif
+	#endif
+#elif defined(__INTEL_COMPILER) || defined(__ICL)
+	#define MLX_COMPILER_INTEL
+#elif defined(_MSC_VER)
+	#define MLX_COMPILER_MSVC
+#else
+	#define MLX_COMPILER_UNKNOWN
+	#warning "This compiler is not fully supported"
+#endif
+
+#if defined(_WIN32) || defined(__CYGWIN__)
+	#define MLX_PLAT_WINDOWS
+#elif defined(__linux__)
+	#define MLX_PLAT_LINUX
+#elif defined(__APPLE__) && defined(__MACH__)
+	#define MLX_PLAT_MACOS
+#elif defined(unix) || defined(__unix__) || defined(__unix)
+	#define MLX_PLAT_UNIX
+#elif defined(__sun) && defined(__SVR4)
+	#define MLX_PLAT_SOLARIS
+#elif defined(__OpenBSD__)
+	#define MLX_PLAT_OPENBSD
+#elif defined(__FreeBSD__) || defined(__FreeBSD_kernel__) || defined(__DragonFly__)
+	#define MLX_PLAT_FREEBSD
+#elif defined(__NetBSD__)
+	#define MLX_PLAT_NETBSD
+#else
+	#error "Unknown environment (not Windows, not Linux, not MacOS, not Unix)"
+#endif
+
+#ifdef MLX_PLAT_WINDOWS
+	#ifdef MLX_COMPILER_MSVC
+		#ifdef MLX_BUILD
+			#define MLX_API __declspec(dllexport)
+		#else
+			#define MLX_API __declspec(dllimport)
+		#endif
+	#elif defined(MLX_COMPILER_GCC)
+		#ifdef MLX_BUILD
+			#define MLX_API __attribute__((dllexport))
+		#else
+			#define MLX_API __attribute__((dllimport))
+		#endif
+	#else
+		#define MLX_API
+	#endif
+#elif defined(MLX_COMPILER_GCC)
+	#define MLX_API __attribute__((visibility("default")))
+#else
+	#define MLX_API
+#endif
+
+#if defined(__GNUC__) || (defined(__MWERKS__) && (__MWERKS__ >= 0x3000)) || (defined(__ICC) && (__ICC >= 600)) || defined(__ghs__)
+	#define MLX_FUNC_SIG __PRETTY_FUNCTION__
+#elif defined(__DMC__) && (__DMC__ >= 0x810)
+	#define MLX_FUNC_SIG __PRETTY_FUNCTION__
+#elif (defined(__FUNCSIG__) || (_MSC_VER))
+	#define MLX_FUNC_SIG __FUNCSIG__
+#elif (defined(__INTEL_COMPILER) && (__INTEL_COMPILER >= 600)) || (defined(__IBMCPP__) && (__IBMCPP__ >= 500))
+	#define MLX_FUNC_SIG __FUNCTION__
+#elif defined(__BORLANDC__) && (__BORLANDC__ >= 0x550)
+	#define MLX_FUNC_SIG __FUNC__
+#elif defined(__STDC_VERSION__) && (__STDC_VERSION__ >= 199901)
+	#define MLX_FUNC_SIG __func__
+#elif defined(__cplusplus) && (__cplusplus >= 201103)
+	#define MLX_FUNC_SIG __func__
+#else
+	#define MLX_FUNC_SIG "Unknown function"
+#endif
+
+#ifndef __cplusplus // if we compile in C
+	#ifdef __STDC__
+		#ifdef __STDC_VERSION__
+			#if __STDC_VERSION__ == 199409L
+				#define MLX_C_VERSION 1994
+			#elif __STDC_VERSION__ == 199901L
+				#define MLX_C_VERSION 1999
+			#elif __STDC_VERSION__ == 201112L
+				#define MLX_C_VERSION 2011
+			#elif __STDC_VERSION__ == 201710L
+				#define MLX_C_VERSION 2017
+			#elif __STDC_VERSION__ == 202311L
+				#define MLX_C_VERSION 2023
+			#else
+				#define MLX_C_VERSION 0
+			#endif
+		#else
+			#define MLX_C_VERSION 0
+		#endif
+	#else
+		#define MLX_C_VERSION 0
+	#endif
+#else
+	#define MLX_C_VERSION 0
+#endif
+
+#if defined(MLX_PLAT_WINDOWS)
+	#define VK_USE_PLATFORM_WIN32_KHR
+	#define VULKAN_LIB_NAME "vulkan-1.dll"
+#elif defined(MLX_PLAT_MACOS)
+	#define VK_USE_PLATFORM_MACOS_MVK
+	#define VK_USE_PLATFORM_METAL_EXT
+	#define VULKAN_LIB_NAME "libvulkan.dylib / libvulkan.1.dylib / libMoltenVK.dylib"
+#else
+	#define VK_USE_PLATFORM_XLIB_KHR
+	#define VK_USE_PLATFORM_WAYLAND_KHR
+	#define VULKAN_LIB_NAME "libvulkan.so / libvulkan.so.1"
+#endif
+
+#if !defined(MLX_FORCEINLINE)
+	#if defined(MLX_COMPILER_CLANG) || defined(MLX_COMPILER_GCC)
+		#define MLX_FORCEINLINE __attribute__((always_inline)) inline
+	#elif defined(MLX_COMPILER_MSVC)
+		#define MLX_FORCEINLINE __forceinline
+	#else
+		#define MLX_FORCEINLINE inline
+	#endif
+#endif
+
+#define MLX_LITTLE_ENDIAN 1234
+#define MLX_BIG_ENDIAN    4321
+
+#ifndef MLX_BYTEORDER
+	#if defined(MLX_PLAT_LINUX)
+		#include <endian.h>
+		#define MLX_BYTEORDER __BYTE_ORDER
+	#elif defined(MLX_PLAT_SOLARIS)
+		#include <sys/byteorder.h>
+		#if defined(_LITTLE_ENDIAN)
+			#define MLX_BYTEORDER MLX_LITTLE_ENDIAN
+		#elif defined(_BIG_ENDIAN)
+			#define MLX_BYTEORDER MLX_BIG_ENDIAN
+		#else
+			#error Unsupported endianness
+		#endif
+	#elif defined(MLX_PLAT_OPENBSD) || defined(__DragonFly__)
+		#include <endian.h>
+		#define MLX_BYTEORDER BYTE_ORDER
+	#elif defined(MLX_PLAT_FREEBSD) || defined(MLX_PLAT_NETBSD)
+		#include <sys/endian.h>
+		#define MLX_BYTEORDER BYTE_ORDER
+	#elif defined(__ORDER_LITTLE_ENDIAN__) && defined(__ORDER_BIG_ENDIAN__) && defined(__BYTE_ORDER__)
+		#if (__BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__)
+			#define MLX_BYTEORDER MLX_LITTLE_ENDIAN
+		#elif (__BYTE_ORDER__ == __ORDER_BIG_ENDIAN__)
+			#define MLX_BYTEORDER MLX_BIG_ENDIAN
+		#else
+			#error Unsupported endianness
+		#endif
+	#else
+		#if defined(__hppa__) || \
+			defined(__m68k__) || defined(mc68000) || defined(_M_M68K) || \
+			(defined(__MIPS__) && defined(__MIPSEB__)) || \
+			defined(__ppc__) || defined(__POWERPC__) || defined(__powerpc__) || defined(__PPC__) || \
+			defined(__sparc__) || defined(__sparc)
+			#define MLX_BYTEORDER MLX_BIG_ENDIAN
+		#else
+			#define MLX_BYTEORDER MLX_LITTLE_ENDIAN
+		#endif
+	#endif
+#endif
+
+#include <stdint.h>
+
+#define MLX_MAKE_VERSION(major, minor, patch) ((((uint32_t)(major)) << 22U) | (((uint32_t)(minor)) << 12U) | ((uint32_t)(patch)))
+
+#define MLX_VERSION_MAJOR(version) (((uint32_t)(version) >> 22U) & 0x7FU)
+#define MLX_VERSION_MINOR(version) (((uint32_t)(version) >> 12U) & 0x3FFU)
+#define MLX_VERSION_PATCH(version) ((uint32_t)(version) & 0xFFFU)
+
+#define MLX_DEFINE_HANDLE(object) typedef struct object##_handler* object
+
+#define MLX_VERSION MLX_MAKE_VERSION(2, 0, 0)
+#define MLX_TARGET_VULKAN_API_VERSION MLX_MAKE_VERSION(1, 0, 0)
+
+// Checking common assumptions
+#ifdef __cplusplus
+	#include <climits>
+
+	static_assert(CHAR_BIT == 8, "CHAR_BIT is expected to be 8");
+
+	static_assert(sizeof(int8_t)  == 1, "int8_t is not of the correct size" );
+	static_assert(sizeof(int16_t) == 2, "int16_t is not of the correct size");
+	static_assert(sizeof(int32_t) == 4, "int32_t is not of the correct size");
+	static_assert(sizeof(int64_t) == 8, "int64_t is not of the correct size");
+
+	static_assert(sizeof(uint8_t)  == 1, "uint8_t is not of the correct size" );
+	static_assert(sizeof(uint16_t) == 2, "uint16_t is not of the correct size");
+	static_assert(sizeof(uint32_t) == 4, "uint32_t is not of the correct size");
+	static_assert(sizeof(uint64_t) == 8, "uint64_t is not of the correct size");
+#elif MLX_C_VERSION >= 2011
+	#if MLX_C_VERSION < 2023
+		#include <assert.h>
+	#endif
+	#include <limits.h>
+
+	static_assert(CHAR_BIT == 8, "CHAR_BIT is expected to be 8");
+
+	static_assert(sizeof(int8_t)  == 1, "int8_t is not of the correct size" );
+	static_assert(sizeof(int16_t) == 2, "int16_t is not of the correct size");
+	static_assert(sizeof(int32_t) == 4, "int32_t is not of the correct size");
+	static_assert(sizeof(int64_t) == 8, "int64_t is not of the correct size");
+
+	static_assert(sizeof(uint8_t)  == 1, "uint8_t is not of the correct size" );
+	static_assert(sizeof(uint16_t) == 2, "uint16_t is not of the correct size");
+	static_assert(sizeof(uint32_t) == 4, "uint32_t is not of the correct size");
+	static_assert(sizeof(uint64_t) == 8, "uint64_t is not of the correct size");
+#else
+	#define STATIC_ASSERT(COND, MSG) typedef char static_assertion___##MSG[(COND)?1:-1]
+
+	#include <limits.h>
+
+	STATIC_ASSERT(CHAR_BIT == 8, CHAR_BIT_is_expected_to_be_8);
+
+	STATIC_ASSERT(sizeof(int8_t)  == 1,  int8_t_is_not_of_the_correct_size);
+	STATIC_ASSERT(sizeof(int16_t) == 2, int16_t_is_not_of_the_correct_size);
+	STATIC_ASSERT(sizeof(int32_t) == 4, int32_t_is_not_of_the_correct_size);
+	STATIC_ASSERT(sizeof(int64_t) == 8, int64_t_is_not_of_the_correct_size);
+
+	STATIC_ASSERT(sizeof(uint8_t)  == 1,  uint8_t_is_not_of_the_correct_size);
+	STATIC_ASSERT(sizeof(uint16_t) == 2, uint16_t_is_not_of_the_correct_size);
+	STATIC_ASSERT(sizeof(uint32_t) == 4, uint32_t_is_not_of_the_correct_size);
+	STATIC_ASSERT(sizeof(uint64_t) == 8, uint64_t_is_not_of_the_correct_size);
+#endif
+
+#endif

runtime/Includes/Core/Application.h

@@ -0,0 +1,73 @@
+#ifndef __MLX_APPLICATION__
+#define __MLX_APPLICATION__
+
+#include <Core/Graphics.h>
+#include <Platform/Inputs.h>
+#include <Core/ImagesRegistry.h>
+#include <Core/SDLManager.h>
+#include <Core/Memory.h>
+#include <Core/Fps.h>
+#include <Graphics/Font.h>
+#include <Graphics/Mesh.h>
+
+namespace mlx
+{
+	class Application
+	{
+		public:
+			Application();
+
+			inline void GetMousePos(int* x, int* y) noexcept;
+			inline void GetScreenSize(mlx_window win, int* w, int* h) noexcept;
+			inline void SetFPSCap(std::uint32_t fps) noexcept;
+
+			inline void OnEvent(mlx_window win, int event, void(*f)(int, void*), void* param) noexcept;
+
+			inline mlx_window NewGraphicsSuport(const mlx_window_create_info* info);
+			inline NonOwningPtr<GraphicsSupport> GetGraphicsSupport(mlx_window win);
+			inline void DestroyGraphicsSupport(mlx_window win);
+
+			mlx_image NewTexture(int w, int h);
+			mlx_image NewStbTexture(char* file, int* w, int* h); // stb textures are image files (png, jpg, bpm, ...)
+			inline NonOwningPtr<Texture> GetTexture(mlx_image image);
+			void DestroyTexture(mlx_image img);
+
+			inline void AddLoopHook(void(*f)(void*), void* param);
+			inline void LoopEnd() noexcept;
+
+			inline void LoadFont(const std::filesystem::path& filepath, float scale);
+
+			void Run() noexcept;
+
+			~Application();
+
+		private:
+			struct Hook
+			{
+				std::function<void(void*)> fn;
+				void* param;
+
+				Hook(std::function<void(void*)> fn, void* param) : fn(fn), param(param) {}
+			};
+
+		private:
+			std::unique_ptr<MemManager> p_mem_manager; // Putting ptr here to initialise them before inputs, even if it f*cks the padding
+			std::unique_ptr<SDLManager> p_sdl_manager;
+			FpsManager m_fps;
+			Inputs m_in;
+			FontRegistry m_font_registry;
+			ImageRegistry m_image_registry;
+			MeshRegistry m_mesh_registry;
+			std::vector<std::unique_ptr<GraphicsSupport>> m_graphics;
+			std::vector<Hook> m_hooks;
+			std::shared_ptr<Font> p_last_font_bound;
+			std::unique_ptr<RenderCore> p_render_core;
+			#ifdef PROFILER
+				std::unique_ptr<Profiler> p_profiler;
+			#endif
+	};
+}
+
+#include <Core/Application.inl>
+
+#endif // __MLX_APPLICATION__

runtime/Includes/Core/Application.inl

@@ -0,0 +1,142 @@
+#pragma once
+#include <Core/Application.h>
+#include <Core/Handles.h>
+#include <Embedded/DogicaTTF.h>
+
+#ifndef DISABLE_ALL_SAFETIES
+	#define CHECK_WINDOW_PTR(win, retval) \
+		if(win == nullptr) \
+		{ \
+			Error("invalid window handle (NULL)"); \
+			return retval; \
+		} \
+		else if(std::find_if(m_graphics.begin(), m_graphics.end(), [win](const std::unique_ptr<GraphicsSupport>& gs){ return gs && win->id == gs->GetID(); }) == m_graphics.end()) \
+		{ \
+			Error("invalid window handle"); \
+			return retval; \
+		} else {}
+
+	#define CHECK_IMAGE_PTR(img, retval) \
+		if(img == nullptr) \
+		{ \
+			Error("invalid image handle (NULL)"); \
+			return retval; \
+		} \
+		else if(!m_image_registry.IsTextureKnown(image->texture)) \
+		{ \
+			Error("invalid image handle"); \
+			return retval; \
+		} else {}
+#else
+	#define CHECK_WINDOW_PTR(win, retval)
+	#define CHECK_IMAGE_PTR(img, retval)
+#endif
+
+namespace mlx
+{
+	void Application::GetMousePos(int* x, int* y) noexcept
+	{
+		*x = m_in.GetX();
+		*y = m_in.GetY();
+	}
+
+	void Application::OnEvent(mlx_window win, int event, void(*f)(int, void*), void* param) noexcept
+	{
+		CHECK_WINDOW_PTR(win, );
+		if(!m_graphics[win->id]->HasWindow())
+			return;
+		m_in.OnEvent(m_graphics[win->id]->GetWindow()->GetID(), event, f, param);
+	}
+
+	void Application::SetFPSCap(std::uint32_t fps) noexcept
+	{
+		if(fps == 0)
+		{
+			SDL_DisplayMode mode;
+			if(!SDL_GetCurrentDisplayMode(1, &mode))
+				return;
+			fps = mode.refresh_rate;
+		}
+		m_fps.SetMaxFPS(fps);
+	}
+
+	mlx_window Application::NewGraphicsSuport(const mlx_window_create_info* info)
+	{
+		MLX_PROFILE_FUNCTION();
+		if(!info)
+		{
+			Error("invalid window create info (NULL)");
+			return nullptr;
+		}
+
+		mlx_window window;
+		try { window = new mlx_window_handler; }
+		catch(...) { return nullptr; }
+
+		m_graphics.emplace_back(std::make_unique<GraphicsSupport>(info, m_graphics.size()));
+		if(m_graphics.back()->HasWindow())
+			m_in.RegisterWindow(m_graphics.back()->GetWindow());
+		m_graphics.back()->GetScene().BindFont(p_last_font_bound);
+		window->id = m_graphics.back()->GetID();
+		return window;
+	}
+
+	NonOwningPtr<GraphicsSupport> Application::GetGraphicsSupport(mlx_window win)
+	{
+		CHECK_WINDOW_PTR(win, nullptr);
+		return m_graphics[win->id].get();
+	}
+
+	void Application::DestroyGraphicsSupport(mlx_window win)
+	{
+		MLX_PROFILE_FUNCTION();
+		CHECK_WINDOW_PTR(win, );
+		m_graphics[win->id].reset();
+		delete win;
+	}
+
+	void Application::LoadFont(const std::filesystem::path& filepath, float scale)
+	{
+		MLX_PROFILE_FUNCTION();
+		std::shared_ptr<Font> font = m_font_registry.GetFont(filepath, scale);
+		if(!font)
+		{
+			if(filepath.string() == "default")
+				font = std::make_shared<Font>("default", dogica_ttf, scale);
+			else
+				font = std::make_shared<Font>(filepath, scale);
+			font->BuildFont();
+			m_font_registry.RegisterFont(font);
+		}
+
+		p_last_font_bound = font;
+
+		for(auto& gs : m_graphics)
+		{
+			if(gs)
+				gs->GetScene().BindFont(font);
+		}
+	}
+
+	NonOwningPtr<Texture> Application::GetTexture(mlx_image image)
+	{
+		CHECK_IMAGE_PTR(image, nullptr);
+		NonOwningPtr<Texture> texture = image->texture;
+		if(!texture->IsInit())
+		{
+			Error("trying to use a texture that has been destroyed");
+			return nullptr;
+		}
+		return texture;
+	}
+
+	void Application::AddLoopHook(void(*f)(void*), void* param)
+	{
+		m_hooks.emplace_back(f, param);
+	}
+	
+	void Application::LoopEnd() noexcept
+	{
+		m_in.Finish();
+	}
+}

runtime/Includes/Core/Enums.h

@@ -0,0 +1,31 @@
+#ifndef __MLX_CORE_ENUMS__
+#define __MLX_CORE_ENUMS__
+
+#include <cstddef>
+
+namespace mlx
+{
+	enum class LogType
+	{
+		Message = 0,
+		Warning,
+		Error,
+		FatalError,
+		Debug,
+
+		EndEnum
+	};
+	constexpr std::size_t LogTypeCount = static_cast<std::size_t>(LogType::EndEnum);
+
+	enum class Event
+	{
+		ResizeEventCode = 56,
+		FrameBeginEventCode = 57,
+		FatalErrorEventCode = 168,
+
+		EndEnum
+	};
+	constexpr std::size_t EventCount = static_cast<std::size_t>(Event::EndEnum);
+}
+
+#endif

runtime/Includes/Core/EventBase.h

@@ -0,0 +1,12 @@
+#ifndef __MLX_BASE_EVENT__
+#define __MLX_BASE_EVENT__
+
+namespace mlx
+{
+	struct EventBase
+	{
+		virtual Event What() const = 0;
+	};
+}
+
+#endif

runtime/Includes/Core/EventBus.h

@@ -0,0 +1,23 @@
+#ifndef __MLX_EVENT_BUS__
+#define __MLX_EVENT_BUS__
+
+#include <Core/EventBase.h>
+#include <Core/EventListener.h>
+
+namespace mlx
+{
+	class EventBus
+	{
+		public:
+			EventBus() = delete;
+			static void Send(const std::string& listener_name, const EventBase& event);
+			static void SendBroadcast(const EventBase& event);
+			inline static void RegisterListener(const EventListener& listener) { s_listeners.push_back(listener); }
+			~EventBus() = delete;
+
+		private:
+			inline static std::vector<EventListener> s_listeners;
+	};
+}
+
+#endif

runtime/Includes/Core/EventListener.h

@@ -0,0 +1,25 @@
+#ifndef __MLX_EVENT_LISTENER__
+#define __MLX_EVENT_LISTENER__
+
+#include <Core/EventBase.h>
+
+namespace mlx
+{
+	class EventListener
+	{
+		public:
+			EventListener() = delete;
+			EventListener(std::function<void(const EventBase&)> functor, std::string name);
+
+			inline const std::string& GetName() const { return m_name; }
+			inline void Call(const EventBase& event) const noexcept { m_listen_functor(event); }
+
+			~EventListener() = default;
+
+		private:
+			std::function<void(const EventBase&)> m_listen_functor;
+			std::string m_name;
+	};
+}
+
+#endif

runtime/Includes/Core/Format.h

@@ -0,0 +1,18 @@
+#ifndef __MLX_FORMAT__
+#define __MLX_FORMAT__
+
+namespace mlx
+{
+	template<typename T, typename = void>
+	struct IsOstreamable : std::false_type {};
+
+	template<typename T>
+	struct IsOstreamable<T, std::void_t<decltype(std::declval<std::ostream>() << std::declval<T>())>> : std::true_type {};
+
+	template<typename... Args, std::enable_if_t<std::conjunction_v<IsOstreamable<Args>...>, int> = 0>
+	auto Format(std::string_view format, const Args&... args);
+}
+
+#include <Core/Format.inl>
+
+#endif

runtime/Includes/Core/Format.inl

@@ -0,0 +1,133 @@
+#pragma once
+#include <Core/Format.h>
+
+namespace mlx
+{
+	namespace Internal
+	{
+		template<typename It>
+		void Format(std::stringstream& ss, It first, It last)
+		{
+			for(auto it = first; it != last; ++it)
+			{
+				switch(*it)
+				{
+					case '%':
+						throw std::invalid_argument{"too few arguments"};
+					case '/':
+						++it;
+						if(it == last)
+							throw std::invalid_argument{"stray '/'"};
+						[[fallthrough]];
+
+					default: ss << *it;
+				}
+			}
+		}
+
+		template<typename It, typename T, typename... Args>
+		void Format(std::stringstream& ss, It first, It last, const T& arg, const Args&... args)
+		{
+			for(auto it = first; it != last; ++it)
+			{
+				switch(*it)
+				{
+					case '%':
+						ss << arg;
+						return Format(ss, ++it, last, args...);
+					case '/':
+						++it;
+						if(it == last)
+							throw std::invalid_argument{"stray '/'"};
+						[[fallthrough]];
+
+					default: ss << *it;
+				}
+			}
+			throw std::invalid_argument{"too many arguments"};
+		}
+
+		template<typename It>
+		void Format(std::ostream& os, It first, It last)
+		{
+			for(auto it = first; it != last; ++it)
+			{
+				switch(*it)
+				{
+					case '%':
+						throw std::invalid_argument{"too few arguments"};
+					case '/':
+						++it;
+						if(it == last)
+							throw std::invalid_argument{"stray '/'"};
+						[[fallthrough]];
+
+					default: os << *it;
+				}
+			}
+		}
+
+		template<typename It, typename T, typename... Args>
+		void Format(std::ostream& os, It first, It last, const T& arg, const Args&... args)
+		{
+			for(auto it = first; it != last; ++it)
+			{
+				switch(*it)
+				{
+					case '%':
+						os << arg;
+						return Format(os, ++it, last, args...);
+					case '/':
+						++it;
+						if(it == last)
+							throw std::invalid_argument{"stray '/'"};
+						[[fallthrough]];
+
+					default: os << *it;
+				}
+			}
+			throw std::invalid_argument{"too many arguments"};
+		}
+
+		template<typename... Args>
+		struct Formatter
+		{
+			std::string_view format;
+			std::tuple<const Args&...> args;
+		};
+
+		template<typename... Args, std::size_t... Is>
+		void FormatHelper(std::stringstream& ss, const Formatter<Args...>& formatter, std::index_sequence<Is...>)
+		{
+			Format(ss, formatter.format.begin(), formatter.format.end(),
+			std::get<Is>(formatter.args)...);
+		}
+
+		template<typename... Args>
+		std::stringstream& operator<<(std::stringstream& ss, const Formatter<Args...>& printer)
+		{
+			FormatHelper(ss, printer, std::index_sequence_for<Args...>{});
+			return ss;
+		}
+
+		template<typename... Args, std::size_t... Is>
+		void FormatHelper(std::ostream& os, const Formatter<Args...>& formatter, std::index_sequence<Is...>)
+		{
+			Format(os, formatter.format.begin(), formatter.format.end(),
+			std::get<Is>(formatter.args)...);
+		}
+
+		template<typename... Args>
+		std::ostream& operator<<(std::ostream& os, const Formatter<Args...>& printer)
+		{
+			FormatHelper(os, printer, std::index_sequence_for<Args...>{});
+			return os;
+		}
+	}
+
+	template<typename... Args, std::enable_if_t<std::conjunction_v<IsOstreamable<Args>...>, int>>
+	auto Format(std::string_view format, const Args&... args)
+	{
+		return Internal::Formatter<Args...>{format, std::forward_as_tuple(args...)};
+	}
+}

runtime/Includes/Core/Fps.h

@@ -0,0 +1,27 @@
+#ifndef __MLX_FPS__
+#define __MLX_FPS__
+
+namespace mlx
+{
+	class FpsManager
+	{
+		public:
+			FpsManager() = default;
+
+			void Init();
+			bool Update();
+			inline void SetMaxFPS(std::uint32_t fps) noexcept { m_max_fps = fps; m_ns = 1000000000.0 / fps; }
+
+			~FpsManager() = default;
+
+		private:
+			double m_ns = 1000000000.0 / 1'337'000.0;
+			std::int64_t m_fps_before = 0;
+			std::int64_t m_fps_now = 0;
+			std::int64_t m_timer = 0;
+			std::uint32_t m_max_fps = 1'337'000;
+			std::uint32_t m_fps_elapsed_time = 0;
+	};
+}
+
+#endif

runtime/Includes/Core/Graphics.h

@@ -0,0 +1,59 @@
+#ifndef __MLX_GRAPHICS__
+#define __MLX_GRAPHICS__
+
+#include <mlx.h>
+#include <Platform/Window.h>
+#include <Renderer/Renderer.h>
+#include <Graphics/Scene.h>
+#include <Graphics/Sprite.h>
+#include <Graphics/PutPixelManager.h>
+#include <Renderer/ScenesRenderer.h>
+#include <Maths/Mat4.h>
+
+namespace mlx
+{
+	class GraphicsSupport : public NonCopyable
+	{
+		public:
+			GraphicsSupport(const mlx_window_create_info* info, int id);
+
+			[[nodiscard]] MLX_FORCEINLINE int& GetID() noexcept { return m_id; }
+			[[nodiscard]] inline std::shared_ptr<Window> GetWindow() { return p_window; }
+
+			void Render() noexcept;
+
+			void ResetRenderData(mlx_color color) noexcept;
+
+			void PixelPut(int x, int y, mlx_color color) noexcept;
+			void PixelPutArray(int x, int y, mlx_color* color, std::size_t pixels_size) noexcept;
+			void PixelPutRegion(int x, int y, int w, int h, mlx_color* color) noexcept;
+			void StringPut(int x, int y, mlx_color color, std::string str);
+			void TexturePut(NonOwningPtr<class Texture> texture, int x, int y, float scale_x, float scale_y, float angle);
+
+			inline void TryEraseSpritesInScene(NonOwningPtr<Texture> texture) noexcept;
+
+			[[nodiscard]] MLX_FORCEINLINE bool HasWindow() const noexcept  { return m_has_window; }
+			[[nodiscard]] MLX_FORCEINLINE Renderer& GetRenderer() { return m_renderer; }
+			[[nodiscard]] MLX_FORCEINLINE Scene& GetScene() { return *p_scene; }
+
+			~GraphicsSupport();
+
+		private:
+			Renderer m_renderer;
+			SceneRenderer m_scene_renderer;
+			PutPixelManager m_put_pixel_manager;
+			std::shared_ptr<Window> p_window;
+			std::unique_ptr<Scene> p_scene;
+
+			std::uint64_t m_draw_layer = 0;
+
+			int m_id;
+
+			bool m_has_window;
+			bool m_pixelput_called = false;
+	};
+}
+
+#include <Core/Graphics.inl>
+
+#endif

runtime/Includes/Core/Graphics.inl

@@ -0,0 +1,11 @@
+#pragma once
+#include <Core/Graphics.h>
+
+namespace mlx
+{
+	void GraphicsSupport::TryEraseSpritesInScene(NonOwningPtr<Texture> texture) noexcept
+	{
+		MLX_PROFILE_FUNCTION();
+		p_scene->TryEraseSpriteFromTexture(texture);
+	}
+}

runtime/Includes/Core/Handles.h

@@ -0,0 +1,22 @@
+#ifndef __MLX_HANDLES__
+#define __MLX_HANDLES__
+
+extern "C"
+{
+	struct mlx_context_handler
+	{
+		mlx::NonOwningPtr<mlx::Application> app;
+	};
+
+	struct mlx_window_handler
+	{
+		int id;
+	};
+
+	struct mlx_image_handler
+	{
+		mlx::NonOwningPtr<mlx::Texture> texture;
+	};
+}
+
+#endif

runtime/Includes/Core/ImagesRegistry.h

@@ -0,0 +1,24 @@
+#ifndef __MLX_CORE_IMAGES_REGISTRY__
+#define __MLX_CORE_IMAGES_REGISTRY__
+
+namespace mlx
+{
+	class ImageRegistry
+	{
+		public:
+			ImageRegistry() = default;
+
+			inline void RegisterTexture(NonOwningPtr<class Texture> texture);
+			inline void UnregisterTexture(NonOwningPtr<class Texture> texture);
+			inline bool IsTextureKnown(NonOwningPtr<class Texture> texture);
+
+			~ImageRegistry() = default;
+
+		private:
+			std::unordered_set<NonOwningPtr<class Texture>> m_textures_registry;
+	};
+}
+
+#include <Core/ImagesRegistry.inl>
+
+#endif

runtime/Includes/Core/ImagesRegistry.inl

@@ -0,0 +1,20 @@
+#pragma once
+#include <Core/ImagesRegistry.h>
+
+namespace mlx
+{
+	void ImageRegistry::RegisterTexture(NonOwningPtr<class Texture> texture)
+	{
+		m_textures_registry.insert(texture);
+	}
+
+	void ImageRegistry::UnregisterTexture(NonOwningPtr<class Texture> texture)
+	{
+		m_textures_registry.erase(texture);
+	}
+
+	bool ImageRegistry::IsTextureKnown(NonOwningPtr<class Texture> texture)
+	{
+		return m_textures_registry.find(texture) != m_textures_registry.end();
+	}
+}

runtime/Includes/Core/Logs.h

@@ -0,0 +1,72 @@
+#ifndef __MLX_LOGS__
+#define __MLX_LOGS__
+
+#include <Core/Enums.h>
+
+namespace mlx
+{
+	template<typename... Args>
+	void DebugLog(unsigned int line, std::string_view file, std::string_view function, std::string message, const Args&... args);
+
+	template<typename... Args>
+	void Error(unsigned int line, std::string_view file, std::string_view function, std::string message, const Args&... args);
+
+	template<typename... Args>
+	void Warning(unsigned int line, std::string_view file, std::string_view function, std::string message, const Args&... args);
+
+	template<typename... Args>
+	void Message(unsigned int line, std::string_view file, std::string_view function, std::string message, const Args&... args);
+
+	template<typename... Args>
+	void FatalError(unsigned int line, std::string_view file, std::string_view function, std::string message, const Args&... args);
+
+	template<typename... Args>
+	void Verify(bool cond, unsigned int line, std::string_view file, std::string_view function, std::string message, const Args&... args);
+
+	class Logs
+	{
+		public:
+			Logs() = delete;
+
+			static void Report(LogType type, std::string message);
+			static void Report(LogType type, unsigned int line, std::string_view file, std::string_view function, std::string message);
+
+			~Logs() = delete;
+	};
+
+	#ifdef DEBUG
+		template<typename... Args>
+		void Assert(bool cond, unsigned int line, std::string_view file, std::string_view function, std::string message, const Args&... args);
+	#else
+		template<typename... Args>
+		void Assert([[maybe_unused]] bool cond, [[maybe_unused]] unsigned int line, [[maybe_unused]] std::string_view file, [[maybe_unused]] std::string_view function, [[maybe_unused]] std::string message, [[maybe_unused]] const Args&... args) {}
+	#endif
+}
+
+#include <Core/Logs.inl>
+
+namespace mlx
+{
+	#undef  DebugLog
+	#define DebugLog(...) DebugLog(__LINE__, __FILE__, __func__, __VA_ARGS__)
+
+	#undef  Message
+	#define Message(...) Message(__LINE__, __FILE__, __func__, __VA_ARGS__)
+
+	#undef  Warning
+	#define Warning(...) Warning(__LINE__, __FILE__, __func__, __VA_ARGS__)
+
+	#undef  Error
+	#define Error(...) Error(__LINE__, __FILE__, __func__, __VA_ARGS__)
+
+	#undef  FatalError
+	#define FatalError(...) FatalError(__LINE__, __FILE__, __func__, __VA_ARGS__)
+
+	#undef  Verify
+	#define Verify(cond, ...) Verify(cond, __LINE__, __FILE__, __func__, __VA_ARGS__)
+
+	#undef  Assert
+	#define Assert(cond, ...) Assert(cond, __LINE__, __FILE__, __func__, __VA_ARGS__)
+}
+
+#endif

runtime/Includes/Core/Logs.inl

@@ -0,0 +1,124 @@
+#pragma once
+#include <Core/Logs.h>
+#include <Core/Format.h>
+
+namespace mlx
+{
+	template<typename... Args>
+	void DebugLog(unsigned int line, std::string_view file, std::string_view function, std::string message, const Args&... args)
+	{
+		using namespace std::literals;
+		try
+		{
+			std::stringstream ss;
+			ss << Format(message, args...);
+			Logs::Report(LogType::Debug, line, file, function, ss.str());
+		}
+		catch(const std::exception& e)
+		{
+			Logs::Report(LogType::Error, line, file, function, "formatter exception catched in the log printer: "s + e.what());
+		}
+	}
+
+	template<typename... Args>
+	void Error(unsigned int line, std::string_view file, std::string_view function, std::string message, const Args&... args)
+	{
+		using namespace std::literals;
+		try
+		{
+			std::stringstream ss;
+			ss << Format(message, args...);
+			Logs::Report(LogType::Error, line, file, function, ss.str());
+		}
+		catch(const std::exception& e)
+		{
+			Logs::Report(LogType::Error, line, file, function, "formatter exception catched in the log printer: "s + e.what());
+		}
+	}
+
+	template<typename... Args>
+	void Warning(unsigned int line, std::string_view file, std::string_view function, std::string message, const Args&... args)
+	{
+		using namespace std::literals;
+		try
+		{
+			std::stringstream ss;
+			ss << Format(message, args...);
+			Logs::Report(LogType::Warning, line, file, function, ss.str());
+		}
+		catch(const std::exception& e)
+		{
+			Logs::Report(LogType::Error, line, file, function, "formatter exception catched in the log printer: "s + e.what());
+		}
+	}
+
+	template<typename... Args>
+	void Message(unsigned int line, std::string_view file, std::string_view function, std::string message, const Args&... args)
+	{
+		using namespace std::literals;
+		try
+		{
+			std::stringstream ss;
+			ss << Format(message, args...);
+			Logs::Report(LogType::Message, line, file, function, ss.str());
+		}
+		catch(const std::exception& e)
+		{
+			Logs::Report(LogType::Error, line, file, function, "formatter exception catched in the log printer: "s + e.what());
+		}
+	}
+
+	template<typename... Args>
+	void FatalError(unsigned int line, std::string_view file, std::string_view function, std::string message, const Args&... args)
+	{
+		using namespace std::literals;
+		try
+		{
+			std::stringstream ss;
+			ss << Format(message, args...);
+			Logs::Report(LogType::FatalError, line, file, function, ss.str());
+		}
+		catch(const std::exception& e)
+		{
+			Logs::Report(LogType::FatalError, line, file, function, "formatter exception catched in the log printer: "s + e.what());
+		}
+	}
+
+	template<typename... Args>
+	void Verify(bool cond, unsigned int line, std::string_view file, std::string_view function, std::string message, const Args&... args)
+	{
+		using namespace std::literals;
+		if(cond)
+			return;
+		try
+		{
+			std::stringstream ss;
+			ss << Format("Verification failed: %", message, args...);
+			Logs::Report(LogType::FatalError, line, file, function, ss.str());
+		}
+		catch(const std::exception& e)
+		{
+			Logs::Report(LogType::FatalError, line, file, function, "formatter exception catched in the log printer: "s + e.what());
+		}
+	}
+
+	#ifdef DEBUG
+		template<typename... Args>
+		void Assert(bool cond, unsigned int line, std::string_view file, std::string_view function, std::string message, const Args&... args)
+		{
+			using namespace std::literals;
+			if(cond)
+				return;
+			try
+			{
+				std::stringstream ss;
+				ss << Format("Assertion failed: %", message, args...);
+				Logs::Report(LogType::FatalError, line, file, function, ss.str());
+			}
+			catch(const std::exception& e)
+			{
+				Logs::Report(LogType::FatalError, line, file, function, "formatter exception catched in the log printer: "s + e.what());
+			}
+		}
+	#endif
+}

runtime/Includes/Core/Memory.h

@@ -0,0 +1,40 @@
+#ifndef __MLX_MEMORY__
+#define __MLX_MEMORY__
+
+namespace mlx
+{
+	class MemManager
+	{
+		public:
+			MemManager();
+
+			static void* Malloc(std::size_t size);
+			static void* AlignedMalloc(std::size_t alignment, std::size_t size);
+			static void* Calloc(std::size_t n, std::size_t size);
+			static void* AlignedCalloc(std::size_t alignment, std::size_t n, std::size_t size);
+			static void* Realloc(void* ptr, std::size_t size);
+			static void* AlignedRealloc(void* ptr, std::size_t alignment, std::size_t size);
+			static void Free(void* ptr);
+
+			static inline bool IsInit() noexcept { return s_instance != nullptr; }
+			static inline MemManager& Get() noexcept { return *s_instance; }
+
+			~MemManager();
+
+		private:
+			struct Descriptor
+			{
+				void* ptr;
+				std::size_t size;
+				bool aligned;
+
+				Descriptor(void* ptr, std::size_t size, bool aligned) : ptr(ptr), size(size), aligned(aligned) {}
+			};
+
+		private:
+			static MemManager* s_instance;
+			inline static std::vector<Descriptor> s_blocks;
+	};
+}
+
+#endif

runtime/Includes/Core/Profiler.h

@@ -0,0 +1,126 @@
+#ifndef __MLX_PROFILER__
+#define __MLX_PROFILER__
+
+namespace mlx
+{
+	using FloatingPointMilliseconds = std::chrono::duration<double, std::milli>;
+
+	struct ProfileResult
+	{
+		std::string name;
+		FloatingPointMilliseconds elapsed_time;
+		std::thread::id thread_id;
+	};
+
+	class Profiler
+	{
+		public:
+			Profiler(const Profiler&) = delete;
+			Profiler(Profiler&&) = delete;
+			Profiler() { BeginRuntimeSession(); s_instance = this; }
+
+			void AppendProfileData(ProfileResult&& result);
+
+			inline static bool IsInit() noexcept { return s_instance != nullptr; }
+			inline static Profiler& Get() noexcept { return *s_instance; }
+
+			~Profiler();
+
+		private:
+			void BeginRuntimeSession();
+			void WriteProfile(const ProfileResult& result);
+			void EndRuntimeSession();
+			inline void WriteHeader()
+			{
+				m_output_stream << "{\"profileData\":[{}";
+				m_output_stream.flush();
+			}
+
+			inline void WriteFooter()
+			{
+				m_output_stream << "]}";
+				m_output_stream.flush();
+			}
+
+		private:
+			static Profiler* s_instance;
+
+			std::unordered_map<std::string, std::pair<std::size_t, ProfileResult>> m_profile_data;
+			std::ofstream m_output_stream;
+			std::mutex m_mutex;
+			bool m_runtime_session_began = false;
+	};
+
+	class ProfilerTimer
+	{
+		public:
+			ProfilerTimer(const char* name) : m_name(name)
+			{
+				m_start_timepoint = std::chrono::steady_clock::now();
+			}
+
+			inline void Stop()
+			{
+				auto end_timepoint = std::chrono::steady_clock::now();
+				auto high_res_start = FloatingPointMilliseconds{ m_start_timepoint.time_since_epoch() };
+				auto elapsed_time = std::chrono::time_point_cast<std::chrono::milliseconds>(end_timepoint).time_since_epoch() - std::chrono::time_point_cast<std::chrono::milliseconds>(m_start_timepoint).time_since_epoch();
+
+				Profiler::Get().AppendProfileData({ m_name, elapsed_time, std::this_thread::get_id() });
+
+				m_stopped = true;
+			}
+
+			~ProfilerTimer()
+			{
+				if(!m_stopped)
+					Stop();
+			}
+
+		private:
+			std::chrono::time_point<std::chrono::steady_clock> m_start_timepoint;
+			const char* m_name;
+			bool m_stopped = false;
+	};
+
+	namespace ProfilerUtils 
+	{
+		template <std::size_t N>
+		struct ChangeResult
+		{
+			char data[N];
+		};
+
+		template <std::size_t N, std::size_t K>
+		constexpr auto CleanupOutputString(const char(&expr)[N], const char(&remove)[K])
+		{
+			ChangeResult<N> result = {};
+
+			std::size_t src_index = 0;
+			std::size_t dst_index = 0;
+			while(src_index < N)
+			{
+				std::size_t match_index = 0;
+				while(match_index < K - 1 && src_index + match_index < N - 1 && expr[src_index + match_index] == remove[match_index])
+					match_index++;
+				if(match_index == K - 1)
+					src_index += match_index;
+				result.data[dst_index++] = expr[src_index] == '"' ? '\'' : expr[src_index];
+				src_index++;
+			}
+			return result;
+		}
+	}
+}
+
+#ifdef PROFILER
+	#define MLX_PROFILE_SCOPE_LINE2(name, line) constexpr auto fixed_name_##line = ::mlx::ProfilerUtils::CleanupOutputString(name, "__cdecl ");\
+												::mlx::ProfilerTimer timer##line(fixed_name_##line.data)
+	#define MLX_PROFILE_SCOPE_LINE(name, line) MLX_PROFILE_SCOPE_LINE2(name, line)
+	#define MLX_PROFILE_SCOPE(name) MLX_PROFILE_SCOPE_LINE(name, __LINE__)
+	#define MLX_PROFILE_FUNCTION() MLX_PROFILE_SCOPE(MLX_FUNC_SIG)
+#else
+	#define MLX_PROFILE_SCOPE(name)
+	#define MLX_PROFILE_FUNCTION()
+#endif
+
+#endif

runtime/Includes/Core/SDLManager.h

@@ -0,0 +1,58 @@
+#ifndef __MLX_SDL_MANAGER__
+#define __MLX_SDL_MANAGER__
+
+#include <mlx.h>
+#include <Maths/Vec2.h>
+
+namespace mlx
+{
+	class SDLManager
+	{
+		public:
+			SDLManager();
+
+			Handle CreateWindow(const mlx_window_create_info* info, std::int32_t& id, bool hidden);
+			void DestroyWindow(Handle window) noexcept;
+
+			void InputsFetcher(std::function<void(mlx_event_type, int, int)> functor);
+
+			VkSurfaceKHR CreateVulkanSurface(Handle window, VkInstance instance) const noexcept;
+			std::vector<const char*> GetRequiredVulkanInstanceExtentions(Handle window) const noexcept;
+			Vec2ui GetVulkanDrawableSize(Handle window) const noexcept;
+			void MoveMouseOnWindow(Handle window, int x, int y) const noexcept;
+			void GetScreenSizeWindowIsOn(Handle window, int* x, int* y) const noexcept;
+			void SetWindowPosition(Handle window, int x, int y) const noexcept;
+			void SetWindowSize(Handle window, int x, int y) const noexcept;
+			void SetWindowTitle(Handle window, std::string_view title) const noexcept;
+			void SetWindowFullscreen(Handle window, bool enable) const noexcept;
+			void SetWindowMaxSize(Handle window, int x, int y) const noexcept;
+			void SetWindowMinSize(Handle window, int x, int y) const noexcept;
+			void MaximizeWindow(Handle window) const noexcept;
+			void MinimizeWindow(Handle window) const noexcept;
+			void RestoreWindow(Handle window) const noexcept;
+
+			void GetWindowPosition(Handle window, int* x, int* y) const noexcept;
+			void GetWindowSize(Handle window, int* x, int* y) const noexcept;
+
+			static void HideCursor() noexcept;
+			static void ShowCursor() noexcept;
+
+			std::int32_t GetX() const noexcept;
+			std::int32_t GetY() const noexcept;
+			std::int32_t GetXRel() const noexcept;
+			std::int32_t GetYRel() const noexcept;
+
+			inline static bool IsInit() noexcept { return s_instance != nullptr; }
+			inline static SDLManager& Get() noexcept { return *s_instance; }
+
+			~SDLManager();
+
+		private:
+			static SDLManager* s_instance;
+
+			std::unordered_set<Handle> m_windows_registry;
+			bool m_drop_sdl_responsability = false;
+	};
+}
+
+#endif

runtime/Includes/Core/UUID.h

@@ -0,0 +1,19 @@
+#ifndef __MLX_UUID__
+#define __MLX_UUID__
+
+namespace mlx
+{
+	class UUID
+	{
+		public:
+			UUID();
+			UUID(std::uint64_t uuid);
+
+			inline operator std::uint64_t() const { return m_uuid; }
+
+		private:
+			std::uint64_t m_uuid;
+	};
+}
+
+#endif

runtime/Includes/Embedded/DogicaTTF.h

@@ -1,21 +1,9 @@
-/* ************************************************************************** */
-/*                                                                            */
-/*                                                        :::      ::::::::   */
-/*   dogica_ttf.h                                       :+:      :+:    :+:   */
-/*                                                    +:+ +:+         +:+     */
-/*   By: maldavid <kbz_8.dev@akel-engine.com>       +#+  +:+       +#+        */
-/*                                                +#+#+#+#+#+   +#+           */
-/*   Created: 2023/04/11 16:20:25 by maldavid          #+#    #+#             */
-/*   Updated: 2023/12/08 19:13:00 by kbz_8            ###   ########.fr       */
-/*                                                                            */
-/* ************************************************************************** */
-
 #ifndef __MLX_DOGICA_TTF__
 #define __MLX_DOGICA_TTF__
 
 constexpr const unsigned int dogica_ttf_len = 33860;
 
-constexpr const unsigned char dogica_ttf[dogica_ttf_len] = {
+static const std::vector<unsigned char> dogica_ttf = {
 	0x00, 0x01, 0x00, 0x00, 0x00, 0x0e, 0x00, 0x80, 0x00, 0x03, 0x00, 0x60,
 	0x46, 0x46, 0x54, 0x4d, 0x8f, 0xe1, 0x5b, 0x60, 0x00, 0x00, 0x84, 0x28,
 	0x00, 0x00, 0x00, 0x1c, 0x47, 0x44, 0x45, 0x46, 0x00, 0x15, 0x00, 0x14,

runtime/Includes/Embedded/IconMlx.h

@@ -1,25 +1,11 @@
-/* ************************************************************************** */
-/*                                                                            */
-/*                                                        :::      ::::::::   */
-/*   icon_mlx.h                                         :+:      :+:    :+:   */
-/*                                                    +:+ +:+         +:+     */
-/*   By: maldavid <kbz_8.dev@akel-engine.com>       +#+  +:+       +#+        */
-/*                                                +#+#+#+#+#+   +#+           */
-/*   Created: 2023/11/25 11:23:16 by maldavid          #+#    #+#             */
-/*   Updated: 2023/11/25 11:55:51 by maldavid         ###   ########.fr       */
-/*                                                                            */
-/* ************************************************************************** */
-
 #ifndef __ICON_MLX__
 #define __ICON_MLX__
 
-#include <cstdint>
-
 constexpr const int logo_mlx_height = 125;
 constexpr const int logo_mlx_width = 125;
 constexpr const int logo_mlx_size = logo_mlx_height * logo_mlx_width * 4;
 
-inline static uint8_t logo_mlx[logo_mlx_size]  = {
+inline static std::uint8_t logo_mlx[logo_mlx_size]  = {
   0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 
   0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 
   0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 

runtime/Includes/Embedded/Shader2DFragment.nzsl

@@ -0,0 +1,28 @@
+[nzsl_version("1.0")]
+module;
+
+struct VertOut
+{
+	[location(0)] color: vec4[f32],
+	[location(1)] uv: vec2[f32]
+}
+
+struct FragOut
+{
+	[location(0)] color: vec4[f32]
+}
+
+external
+{
+	[set(1), binding(0)] u_texture: sampler2D[f32]
+}
+
+[entry(frag)]
+fn main(input: VertOut) -> FragOut
+{
+	let output: FragOut;
+	output.color = input.color * u_texture.Sample(input.uv);
+	if(output.color.w == 0.0)
+		discard;
+	return output;
+}

runtime/Includes/Embedded/Shader2DFragment.spv.h

@@ -0,0 +1,44 @@
+3,2,35,7,0,0,1,0,39,0,0,0,51,0,0,0,0,0,0,0,17,0,2,0,1,0,0,0,14,0,
+3,0,0,0,0,0,1,0,0,0,15,0,8,0,4,0,0,0,28,0,0,0,109,97,105,110,0,0,0,0,
+10,0,0,0,16,0,0,0,22,0,0,0,16,0,3,0,28,0,0,0,7,0,0,0,3,0,3,0,0,0,
+0,0,100,0,0,0,5,0,4,0,19,0,0,0,86,101,114,116,79,117,116,0,6,0,5,0,19,0,0,0,
+0,0,0,0,99,111,108,111,114,0,0,0,6,0,4,0,19,0,0,0,1,0,0,0,117,118,0,0,5,0,
+4,0,23,0,0,0,70,114,97,103,79,117,116,0,6,0,5,0,23,0,0,0,0,0,0,0,99,111,108,111,
+114,0,0,0,5,0,5,0,5,0,0,0,117,95,116,101,120,116,117,114,101,0,0,0,5,0,4,0,10,0,
+0,0,99,111,108,111,114,0,0,0,5,0,3,0,16,0,0,0,117,118,0,0,5,0,4,0,22,0,0,0,
+99,111,108,111,114,0,0,0,5,0,4,0,28,0,0,0,109,97,105,110,0,0,0,0,71,0,4,0,5,0,
+0,0,33,0,0,0,0,0,0,0,71,0,4,0,5,0,0,0,34,0,0,0,1,0,0,0,71,0,4,0,
+10,0,0,0,30,0,0,0,0,0,0,0,71,0,4,0,16,0,0,0,30,0,0,0,1,0,0,0,71,0,
+4,0,22,0,0,0,30,0,0,0,0,0,0,0,72,0,5,0,19,0,0,0,0,0,0,0,35,0,0,0,
+0,0,0,0,72,0,5,0,19,0,0,0,1,0,0,0,35,0,0,0,16,0,0,0,72,0,5,0,23,0,
+0,0,0,0,0,0,35,0,0,0,0,0,0,0,22,0,3,0,1,0,0,0,32,0,0,0,25,0,9,0,
+2,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,
+0,0,27,0,3,0,3,0,0,0,2,0,0,0,32,0,4,0,4,0,0,0,0,0,0,0,3,0,0,0,
+19,0,2,0,6,0,0,0,33,0,3,0,7,0,0,0,6,0,0,0,23,0,4,0,8,0,0,0,1,0,
+0,0,4,0,0,0,32,0,4,0,9,0,0,0,1,0,0,0,8,0,0,0,21,0,4,0,11,0,0,0,
+32,0,0,0,1,0,0,0,43,0,4,0,11,0,0,0,12,0,0,0,0,0,0,0,32,0,4,0,13,0,
+0,0,7,0,0,0,8,0,0,0,23,0,4,0,14,0,0,0,1,0,0,0,2,0,0,0,32,0,4,0,
+15,0,0,0,1,0,0,0,14,0,0,0,43,0,4,0,11,0,0,0,17,0,0,0,1,0,0,0,32,0,
+4,0,18,0,0,0,7,0,0,0,14,0,0,0,30,0,4,0,19,0,0,0,8,0,0,0,14,0,0,0,
+32,0,4,0,20,0,0,0,7,0,0,0,19,0,0,0,32,0,4,0,21,0,0,0,3,0,0,0,8,0,
+0,0,30,0,3,0,23,0,0,0,8,0,0,0,32,0,4,0,24,0,0,0,7,0,0,0,23,0,0,0,
+43,0,4,0,11,0,0,0,25,0,0,0,3,0,0,0,43,0,4,0,1,0,0,0,26,0,0,0,0,0,
+0,0,20,0,2,0,27,0,0,0,59,0,4,0,4,0,0,0,5,0,0,0,0,0,0,0,59,0,4,0,
+9,0,0,0,10,0,0,0,1,0,0,0,59,0,4,0,15,0,0,0,16,0,0,0,1,0,0,0,59,0,
+4,0,21,0,0,0,22,0,0,0,3,0,0,0,54,0,5,0,6,0,0,0,28,0,0,0,0,0,0,0,
+7,0,0,0,248,0,2,0,29,0,0,0,59,0,4,0,24,0,0,0,30,0,0,0,7,0,0,0,59,0,
+4,0,20,0,0,0,31,0,0,0,7,0,0,0,65,0,5,0,13,0,0,0,32,0,0,0,31,0,0,0,
+12,0,0,0,63,0,3,0,32,0,0,0,10,0,0,0,65,0,5,0,18,0,0,0,33,0,0,0,31,0,
+0,0,17,0,0,0,63,0,3,0,33,0,0,0,16,0,0,0,65,0,5,0,13,0,0,0,34,0,0,0,
+31,0,0,0,12,0,0,0,61,0,4,0,8,0,0,0,35,0,0,0,34,0,0,0,61,0,4,0,3,0,
+0,0,36,0,0,0,5,0,0,0,65,0,5,0,18,0,0,0,37,0,0,0,31,0,0,0,17,0,0,0,
+61,0,4,0,14,0,0,0,38,0,0,0,37,0,0,0,87,0,5,0,8,0,0,0,39,0,0,0,36,0,
+0,0,38,0,0,0,133,0,5,0,8,0,0,0,40,0,0,0,35,0,0,0,39,0,0,0,65,0,5,0,
+13,0,0,0,41,0,0,0,30,0,0,0,12,0,0,0,62,0,3,0,41,0,0,0,40,0,0,0,65,0,
+5,0,13,0,0,0,45,0,0,0,30,0,0,0,12,0,0,0,61,0,4,0,8,0,0,0,46,0,0,0,
+45,0,0,0,81,0,5,0,1,0,0,0,47,0,0,0,46,0,0,0,3,0,0,0,180,0,5,0,27,0,
+0,0,48,0,0,0,47,0,0,0,26,0,0,0,247,0,3,0,42,0,0,0,0,0,0,0,250,0,4,0,
+48,0,0,0,43,0,0,0,44,0,0,0,248,0,2,0,43,0,0,0,252,0,1,0,248,0,2,0,44,0,
+0,0,249,0,2,0,42,0,0,0,248,0,2,0,42,0,0,0,61,0,4,0,23,0,0,0,49,0,0,0,
+30,0,0,0,81,0,5,0,8,0,0,0,50,0,0,0,49,0,0,0,0,0,0,0,62,0,3,0,22,0,
+0,0,50,0,0,0,253,0,1,0,56,0,1,0

runtime/Includes/Embedded/Shader2DVertex.nzsl

@@ -0,0 +1,44 @@
+[nzsl_version("1.0")]
+module;
+
+struct VertIn
+{
+	[location(0)] pos: vec4[f32],
+	[location(1)] uv: vec2[f32]
+}
+
+struct VertOut
+{
+	[location(0)] color: vec4[f32],
+	[location(1)] uv: vec2[f32],
+	[builtin(position)] pos: vec4[f32]
+}
+
+struct ViewerData
+{
+	projection_matrix: mat4[f32]
+}
+
+struct SpriteData
+{
+	model_matrix: mat4[f32],
+	color: vec4[f32]
+}
+
+external
+{
+	[set(0), binding(0)] viewer_data: uniform[ViewerData],
+	model: push_constant[SpriteData]
+}
+
+[entry(vert)]
+fn main(input: VertIn) -> VertOut
+{
+	let position: vec4[f32] = vec4[f32](input.pos.xy, 0.0, 1.0);
+	input.uv *= -1.0;
+	let output: VertOut;
+	output.uv = input.uv;
+	output.color = model.color;
+	output.pos = viewer_data.projection_matrix * model.model_matrix * position;
+	return output;
+}

runtime/Includes/Embedded/Shader2DVertex.spv.h

@@ -0,0 +1,72 @@
+3,2,35,7,0,0,1,0,39,0,0,0,71,0,0,0,0,0,0,0,17,0,2,0,1,0,0,0,14,0,
+3,0,0,0,0,0,1,0,0,0,15,0,10,0,0,0,0,0,35,0,0,0,109,97,105,110,0,0,0,0,
+13,0,0,0,19,0,0,0,25,0,0,0,27,0,0,0,28,0,0,0,3,0,3,0,0,0,0,0,100,0,
+0,0,5,0,5,0,4,0,0,0,86,105,101,119,101,114,68,97,116,97,0,0,6,0,8,0,4,0,0,0,
+0,0,0,0,112,114,111,106,101,99,116,105,111,110,95,109,97,116,114,105,120,0,0,0,5,0,5,0,7,0,
+0,0,83,112,114,105,116,101,68,97,116,97,0,0,6,0,7,0,7,0,0,0,0,0,0,0,109,111,100,101,
+108,95,109,97,116,114,105,120,0,0,0,0,6,0,5,0,7,0,0,0,1,0,0,0,99,111,108,111,114,0,
+0,0,5,0,4,0,22,0,0,0,86,101,114,116,73,110,0,0,6,0,4,0,22,0,0,0,0,0,0,0,
+112,111,115,0,6,0,4,0,22,0,0,0,1,0,0,0,117,118,0,0,5,0,4,0,29,0,0,0,86,101,
+114,116,79,117,116,0,6,0,5,0,29,0,0,0,0,0,0,0,99,111,108,111,114,0,0,0,6,0,4,0,
+29,0,0,0,1,0,0,0,117,118,0,0,6,0,4,0,29,0,0,0,2,0,0,0,112,111,115,0,5,0,
+5,0,6,0,0,0,118,105,101,119,101,114,95,100,97,116,97,0,5,0,4,0,9,0,0,0,109,111,100,101,
+108,0,0,0,5,0,3,0,13,0,0,0,112,111,115,0,5,0,3,0,19,0,0,0,117,118,0,0,5,0,
+4,0,25,0,0,0,99,111,108,111,114,0,0,0,5,0,3,0,27,0,0,0,117,118,0,0,5,0,5,0,
+28,0,0,0,112,111,115,105,116,105,111,110,0,0,0,0,5,0,4,0,35,0,0,0,109,97,105,110,0,0,
+0,0,71,0,4,0,6,0,0,0,33,0,0,0,0,0,0,0,71,0,4,0,6,0,0,0,34,0,0,0,
+0,0,0,0,71,0,4,0,28,0,0,0,11,0,0,0,0,0,0,0,71,0,4,0,13,0,0,0,30,0,
+0,0,0,0,0,0,71,0,4,0,19,0,0,0,30,0,0,0,1,0,0,0,71,0,4,0,25,0,0,0,
+30,0,0,0,0,0,0,0,71,0,4,0,27,0,0,0,30,0,0,0,1,0,0,0,71,0,3,0,4,0,
+0,0,2,0,0,0,72,0,4,0,4,0,0,0,0,0,0,0,5,0,0,0,72,0,5,0,4,0,0,0,
+0,0,0,0,7,0,0,0,16,0,0,0,72,0,5,0,4,0,0,0,0,0,0,0,35,0,0,0,0,0,
+0,0,71,0,3,0,7,0,0,0,2,0,0,0,72,0,4,0,7,0,0,0,0,0,0,0,5,0,0,0,
+72,0,5,0,7,0,0,0,0,0,0,0,7,0,0,0,16,0,0,0,72,0,5,0,7,0,0,0,0,0,
+0,0,35,0,0,0,0,0,0,0,72,0,5,0,7,0,0,0,1,0,0,0,35,0,0,0,64,0,0,0,
+72,0,5,0,22,0,0,0,0,0,0,0,35,0,0,0,0,0,0,0,72,0,5,0,22,0,0,0,1,0,
+0,0,35,0,0,0,16,0,0,0,72,0,5,0,29,0,0,0,0,0,0,0,35,0,0,0,0,0,0,0,
+72,0,5,0,29,0,0,0,1,0,0,0,35,0,0,0,16,0,0,0,72,0,5,0,29,0,0,0,2,0,
+0,0,35,0,0,0,32,0,0,0,22,0,3,0,1,0,0,0,32,0,0,0,23,0,4,0,2,0,0,0,
+1,0,0,0,4,0,0,0,24,0,4,0,3,0,0,0,2,0,0,0,4,0,0,0,30,0,3,0,4,0,
+0,0,3,0,0,0,32,0,4,0,5,0,0,0,2,0,0,0,4,0,0,0,30,0,4,0,7,0,0,0,
+3,0,0,0,2,0,0,0,32,0,4,0,8,0,0,0,9,0,0,0,7,0,0,0,19,0,2,0,10,0,
+0,0,33,0,3,0,11,0,0,0,10,0,0,0,32,0,4,0,12,0,0,0,1,0,0,0,2,0,0,0,
+21,0,4,0,14,0,0,0,32,0,0,0,1,0,0,0,43,0,4,0,14,0,0,0,15,0,0,0,0,0,
+0,0,32,0,4,0,16,0,0,0,7,0,0,0,2,0,0,0,23,0,4,0,17,0,0,0,1,0,0,0,
+2,0,0,0,32,0,4,0,18,0,0,0,1,0,0,0,17,0,0,0,43,0,4,0,14,0,0,0,20,0,
+0,0,1,0,0,0,32,0,4,0,21,0,0,0,7,0,0,0,17,0,0,0,30,0,4,0,22,0,0,0,
+2,0,0,0,17,0,0,0,32,0,4,0,23,0,0,0,7,0,0,0,22,0,0,0,32,0,4,0,24,0,
+0,0,3,0,0,0,2,0,0,0,32,0,4,0,26,0,0,0,3,0,0,0,17,0,0,0,30,0,5,0,
+29,0,0,0,2,0,0,0,17,0,0,0,2,0,0,0,43,0,4,0,1,0,0,0,30,0,0,0,0,0,
+0,0,43,0,4,0,1,0,0,0,31,0,0,0,0,0,128,63,43,0,4,0,1,0,0,0,32,0,0,0,
+0,0,128,191,32,0,4,0,33,0,0,0,7,0,0,0,29,0,0,0,43,0,4,0,14,0,0,0,34,0,
+0,0,2,0,0,0,32,0,4,0,53,0,0,0,9,0,0,0,2,0,0,0,32,0,4,0,57,0,0,0,
+2,0,0,0,3,0,0,0,32,0,4,0,60,0,0,0,9,0,0,0,3,0,0,0,59,0,4,0,5,0,
+0,0,6,0,0,0,2,0,0,0,59,0,4,0,8,0,0,0,9,0,0,0,9,0,0,0,59,0,4,0,
+12,0,0,0,13,0,0,0,1,0,0,0,59,0,4,0,18,0,0,0,19,0,0,0,1,0,0,0,59,0,
+4,0,24,0,0,0,25,0,0,0,3,0,0,0,59,0,4,0,26,0,0,0,27,0,0,0,3,0,0,0,
+59,0,4,0,24,0,0,0,28,0,0,0,3,0,0,0,54,0,5,0,10,0,0,0,35,0,0,0,0,0,
+0,0,11,0,0,0,248,0,2,0,36,0,0,0,59,0,4,0,16,0,0,0,37,0,0,0,7,0,0,0,
+59,0,4,0,33,0,0,0,38,0,0,0,7,0,0,0,59,0,4,0,23,0,0,0,39,0,0,0,7,0,
+0,0,65,0,5,0,16,0,0,0,40,0,0,0,39,0,0,0,15,0,0,0,63,0,3,0,40,0,0,0,
+13,0,0,0,65,0,5,0,21,0,0,0,41,0,0,0,39,0,0,0,20,0,0,0,63,0,3,0,41,0,
+0,0,19,0,0,0,65,0,5,0,16,0,0,0,42,0,0,0,39,0,0,0,15,0,0,0,61,0,4,0,
+2,0,0,0,43,0,0,0,42,0,0,0,79,0,7,0,17,0,0,0,44,0,0,0,43,0,0,0,43,0,
+0,0,0,0,0,0,1,0,0,0,80,0,6,0,2,0,0,0,45,0,0,0,44,0,0,0,30,0,0,0,
+31,0,0,0,62,0,3,0,37,0,0,0,45,0,0,0,65,0,5,0,21,0,0,0,46,0,0,0,39,0,
+0,0,20,0,0,0,61,0,4,0,17,0,0,0,47,0,0,0,46,0,0,0,142,0,5,0,17,0,0,0,
+48,0,0,0,47,0,0,0,32,0,0,0,65,0,5,0,21,0,0,0,49,0,0,0,39,0,0,0,20,0,
+0,0,62,0,3,0,49,0,0,0,48,0,0,0,65,0,5,0,21,0,0,0,50,0,0,0,39,0,0,0,
+20,0,0,0,61,0,4,0,17,0,0,0,51,0,0,0,50,0,0,0,65,0,5,0,21,0,0,0,52,0,
+0,0,38,0,0,0,20,0,0,0,62,0,3,0,52,0,0,0,51,0,0,0,65,0,5,0,53,0,0,0,
+54,0,0,0,9,0,0,0,20,0,0,0,61,0,4,0,2,0,0,0,55,0,0,0,54,0,0,0,65,0,
+5,0,16,0,0,0,56,0,0,0,38,0,0,0,15,0,0,0,62,0,3,0,56,0,0,0,55,0,0,0,
+65,0,5,0,57,0,0,0,58,0,0,0,6,0,0,0,15,0,0,0,61,0,4,0,3,0,0,0,59,0,
+0,0,58,0,0,0,65,0,5,0,60,0,0,0,61,0,0,0,9,0,0,0,15,0,0,0,61,0,4,0,
+3,0,0,0,62,0,0,0,61,0,0,0,146,0,5,0,3,0,0,0,63,0,0,0,59,0,0,0,62,0,
+0,0,61,0,4,0,2,0,0,0,64,0,0,0,37,0,0,0,145,0,5,0,2,0,0,0,65,0,0,0,
+63,0,0,0,64,0,0,0,65,0,5,0,16,0,0,0,66,0,0,0,38,0,0,0,34,0,0,0,62,0,
+3,0,66,0,0,0,65,0,0,0,61,0,4,0,29,0,0,0,67,0,0,0,38,0,0,0,81,0,5,0,
+2,0,0,0,68,0,0,0,67,0,0,0,0,0,0,0,62,0,3,0,25,0,0,0,68,0,0,0,81,0,
+5,0,17,0,0,0,69,0,0,0,67,0,0,0,1,0,0,0,62,0,3,0,27,0,0,0,69,0,0,0,
+81,0,5,0,2,0,0,0,70,0,0,0,67,0,0,0,2,0,0,0,62,0,3,0,28,0,0,0,70,0,
+0,0,253,0,1,0,56,0,1,0

runtime/Includes/Embedded/ShaderScreenFragment.nzsl

@@ -0,0 +1,46 @@
+[nzsl_version("1.0")]
+module;
+
+struct VertOut
+{
+	[location(0)] uv : vec2[f32]
+}
+
+struct FragOut
+{
+	[location(0)] color: vec4[f32]
+}
+
+external
+{
+	[set(0), binding(0)] u_texture: sampler2D[f32]
+}
+
+option approximates_rgb: bool = false;
+
+fn LinearTosRGB(color: vec3[f32]) -> vec3[f32]
+{
+	const if(!approximates_rgb)
+	{
+		return select(
+			color > (0.0031308).rrr,
+			1.055 * pow(color, (1.0 / 2.4).rrr) - (0.055).rrr,
+			12.92 * color
+		);
+	}
+	else
+		return pow(color, (1.0 / 2.2).rrr);
+}
+
+option gamma_correction: bool = false;
+
+[entry(frag)]
+fn main(input: VertOut) -> FragOut
+{
+	let output: FragOut;
+	const if(gamma_correction)
+		output.color = vec4[f32](LinearTosRGB(u_texture.Sample(input.uv).xyz), 1.0);
+	else
+		output.color = u_texture.Sample(input.uv);
+	return output;
+}

runtime/Includes/Embedded/ShaderScreenFragment.spv.h

@@ -0,0 +1,31 @@
+3,2,35,7,0,0,1,0,39,0,0,0,34,0,0,0,0,0,0,0,17,0,2,0,1,0,0,0,14,0,
+3,0,0,0,0,0,1,0,0,0,15,0,7,0,4,0,0,0,21,0,0,0,109,97,105,110,0,0,0,0,
+10,0,0,0,18,0,0,0,16,0,3,0,21,0,0,0,7,0,0,0,3,0,3,0,0,0,0,0,100,0,
+0,0,5,0,4,0,14,0,0,0,86,101,114,116,79,117,116,0,6,0,4,0,14,0,0,0,0,0,0,0,
+117,118,0,0,5,0,4,0,19,0,0,0,70,114,97,103,79,117,116,0,6,0,5,0,19,0,0,0,0,0,
+0,0,99,111,108,111,114,0,0,0,5,0,5,0,5,0,0,0,117,95,116,101,120,116,117,114,101,0,0,0,
+5,0,3,0,10,0,0,0,117,118,0,0,5,0,4,0,18,0,0,0,99,111,108,111,114,0,0,0,5,0,
+4,0,21,0,0,0,109,97,105,110,0,0,0,0,71,0,4,0,5,0,0,0,33,0,0,0,0,0,0,0,
+71,0,4,0,5,0,0,0,34,0,0,0,0,0,0,0,71,0,4,0,10,0,0,0,30,0,0,0,0,0,
+0,0,71,0,4,0,18,0,0,0,30,0,0,0,0,0,0,0,72,0,5,0,14,0,0,0,0,0,0,0,
+35,0,0,0,0,0,0,0,72,0,5,0,19,0,0,0,0,0,0,0,35,0,0,0,0,0,0,0,22,0,
+3,0,1,0,0,0,32,0,0,0,25,0,9,0,2,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,27,0,3,0,3,0,0,0,2,0,0,0,32,0,
+4,0,4,0,0,0,0,0,0,0,3,0,0,0,19,0,2,0,6,0,0,0,33,0,3,0,7,0,0,0,
+6,0,0,0,23,0,4,0,8,0,0,0,1,0,0,0,2,0,0,0,32,0,4,0,9,0,0,0,1,0,
+0,0,8,0,0,0,21,0,4,0,11,0,0,0,32,0,0,0,1,0,0,0,43,0,4,0,11,0,0,0,
+12,0,0,0,0,0,0,0,32,0,4,0,13,0,0,0,7,0,0,0,8,0,0,0,30,0,3,0,14,0,
+0,0,8,0,0,0,32,0,4,0,15,0,0,0,7,0,0,0,14,0,0,0,23,0,4,0,16,0,0,0,
+1,0,0,0,4,0,0,0,32,0,4,0,17,0,0,0,3,0,0,0,16,0,0,0,30,0,3,0,19,0,
+0,0,16,0,0,0,32,0,4,0,20,0,0,0,7,0,0,0,19,0,0,0,32,0,4,0,31,0,0,0,
+7,0,0,0,16,0,0,0,59,0,4,0,4,0,0,0,5,0,0,0,0,0,0,0,59,0,4,0,9,0,
+0,0,10,0,0,0,1,0,0,0,59,0,4,0,17,0,0,0,18,0,0,0,3,0,0,0,54,0,5,0,
+6,0,0,0,21,0,0,0,0,0,0,0,7,0,0,0,248,0,2,0,22,0,0,0,59,0,4,0,20,0,
+0,0,23,0,0,0,7,0,0,0,59,0,4,0,15,0,0,0,24,0,0,0,7,0,0,0,65,0,5,0,
+13,0,0,0,25,0,0,0,24,0,0,0,12,0,0,0,63,0,3,0,25,0,0,0,10,0,0,0,61,0,
+4,0,3,0,0,0,26,0,0,0,5,0,0,0,65,0,5,0,13,0,0,0,27,0,0,0,24,0,0,0,
+12,0,0,0,61,0,4,0,8,0,0,0,28,0,0,0,27,0,0,0,87,0,5,0,16,0,0,0,29,0,
+0,0,26,0,0,0,28,0,0,0,65,0,5,0,31,0,0,0,30,0,0,0,23,0,0,0,12,0,0,0,
+62,0,3,0,30,0,0,0,29,0,0,0,61,0,4,0,19,0,0,0,32,0,0,0,23,0,0,0,81,0,
+5,0,16,0,0,0,33,0,0,0,32,0,0,0,0,0,0,0,62,0,3,0,18,0,0,0,33,0,0,0,
+253,0,1,0,56,0,1,0

runtime/Includes/Embedded/ShaderScreenVertex.nzsl

@@ -0,0 +1,31 @@
+[nzsl_version("1.0")]
+module;
+
+struct VertIn
+{
+	[builtin(vertex_index)] vert_index: i32
+}
+
+struct VertOut
+{
+	[location(0)] uv: vec2[f32],
+	[builtin(position)] position: vec4[f32]
+}
+
+const vertices = array[vec2[f32]](
+	vec2[f32](-1.0, -3.0),
+	vec2[f32](-1.0, 1.0),
+	vec2[f32]( 3.0, 1.0)
+);
+
+[entry(vert)]
+fn main(input: VertIn) -> VertOut
+{
+	let position = vertices[input.vert_index];
+
+	let output: VertOut;
+	output.position = vec4[f32](position, 0.0, 1.0);
+	output.uv = position * 0.5 + vec2[f32](0.5, 0.5);
+
+	return output;
+}

runtime/Includes/Embedded/ShaderScreenVertex.spv.h

@@ -0,0 +1,48 @@
+3,2,35,7,0,0,1,0,39,0,0,0,59,0,0,0,0,0,0,0,17,0,2,0,1,0,0,0,14,0,
+3,0,0,0,0,0,1,0,0,0,15,0,8,0,0,0,0,0,37,0,0,0,109,97,105,110,0,0,0,0,
+20,0,0,0,26,0,0,0,29,0,0,0,3,0,3,0,0,0,0,0,100,0,0,0,5,0,4,0,23,0,
+0,0,86,101,114,116,73,110,0,0,6,0,6,0,23,0,0,0,0,0,0,0,118,101,114,116,95,105,110,100,
+101,120,0,0,5,0,4,0,30,0,0,0,86,101,114,116,79,117,116,0,6,0,4,0,30,0,0,0,0,0,
+0,0,117,118,0,0,6,0,6,0,30,0,0,0,1,0,0,0,112,111,115,105,116,105,111,110,0,0,0,0,
+5,0,5,0,15,0,0,0,118,101,114,116,105,99,101,115,0,0,0,0,5,0,6,0,20,0,0,0,118,101,
+114,116,101,120,95,105,110,100,101,120,0,0,0,0,5,0,3,0,26,0,0,0,117,118,0,0,5,0,5,0,
+29,0,0,0,112,111,115,105,116,105,111,110,0,0,0,0,5,0,4,0,37,0,0,0,109,97,105,110,0,0,
+0,0,71,0,4,0,20,0,0,0,11,0,0,0,42,0,0,0,71,0,4,0,29,0,0,0,11,0,0,0,
+0,0,0,0,71,0,4,0,26,0,0,0,30,0,0,0,0,0,0,0,72,0,5,0,23,0,0,0,0,0,
+0,0,35,0,0,0,0,0,0,0,72,0,5,0,30,0,0,0,0,0,0,0,35,0,0,0,0,0,0,0,
+72,0,5,0,30,0,0,0,1,0,0,0,35,0,0,0,16,0,0,0,22,0,3,0,1,0,0,0,32,0,
+0,0,23,0,4,0,2,0,0,0,1,0,0,0,2,0,0,0,21,0,4,0,3,0,0,0,32,0,0,0,
+0,0,0,0,43,0,4,0,3,0,0,0,4,0,0,0,3,0,0,0,28,0,4,0,5,0,0,0,2,0,
+0,0,4,0,0,0,32,0,4,0,6,0,0,0,6,0,0,0,5,0,0,0,43,0,4,0,1,0,0,0,
+7,0,0,0,0,0,128,191,43,0,4,0,1,0,0,0,8,0,0,0,0,0,64,192,44,0,5,0,2,0,
+0,0,9,0,0,0,7,0,0,0,8,0,0,0,43,0,4,0,1,0,0,0,10,0,0,0,0,0,128,63,
+44,0,5,0,2,0,0,0,11,0,0,0,7,0,0,0,10,0,0,0,43,0,4,0,1,0,0,0,12,0,
+0,0,0,0,64,64,44,0,5,0,2,0,0,0,13,0,0,0,12,0,0,0,10,0,0,0,44,0,6,0,
+5,0,0,0,14,0,0,0,9,0,0,0,11,0,0,0,13,0,0,0,19,0,2,0,16,0,0,0,33,0,
+3,0,17,0,0,0,16,0,0,0,21,0,4,0,18,0,0,0,32,0,0,0,1,0,0,0,32,0,4,0,
+19,0,0,0,1,0,0,0,18,0,0,0,43,0,4,0,18,0,0,0,21,0,0,0,0,0,0,0,32,0,
+4,0,22,0,0,0,7,0,0,0,18,0,0,0,30,0,3,0,23,0,0,0,18,0,0,0,32,0,4,0,
+24,0,0,0,7,0,0,0,23,0,0,0,32,0,4,0,25,0,0,0,3,0,0,0,2,0,0,0,23,0,
+4,0,27,0,0,0,1,0,0,0,4,0,0,0,32,0,4,0,28,0,0,0,3,0,0,0,27,0,0,0,
+30,0,4,0,30,0,0,0,2,0,0,0,27,0,0,0,32,0,4,0,31,0,0,0,7,0,0,0,2,0,
+0,0,32,0,4,0,32,0,0,0,7,0,0,0,30,0,0,0,43,0,4,0,18,0,0,0,33,0,0,0,
+1,0,0,0,43,0,4,0,1,0,0,0,34,0,0,0,0,0,0,0,43,0,4,0,1,0,0,0,35,0,
+0,0,0,0,0,63,44,0,5,0,2,0,0,0,36,0,0,0,35,0,0,0,35,0,0,0,32,0,4,0,
+45,0,0,0,6,0,0,0,2,0,0,0,32,0,4,0,51,0,0,0,7,0,0,0,27,0,0,0,59,0,
+5,0,6,0,0,0,15,0,0,0,6,0,0,0,14,0,0,0,59,0,4,0,19,0,0,0,20,0,0,0,
+1,0,0,0,59,0,4,0,25,0,0,0,26,0,0,0,3,0,0,0,59,0,4,0,28,0,0,0,29,0,
+0,0,3,0,0,0,54,0,5,0,16,0,0,0,37,0,0,0,0,0,0,0,17,0,0,0,248,0,2,0,
+38,0,0,0,59,0,4,0,31,0,0,0,39,0,0,0,7,0,0,0,59,0,4,0,32,0,0,0,40,0,
+0,0,7,0,0,0,59,0,4,0,24,0,0,0,41,0,0,0,7,0,0,0,65,0,5,0,22,0,0,0,
+42,0,0,0,41,0,0,0,21,0,0,0,63,0,3,0,42,0,0,0,20,0,0,0,65,0,5,0,22,0,
+0,0,43,0,0,0,41,0,0,0,21,0,0,0,61,0,4,0,18,0,0,0,44,0,0,0,43,0,0,0,
+65,0,5,0,45,0,0,0,46,0,0,0,15,0,0,0,44,0,0,0,61,0,4,0,2,0,0,0,47,0,
+0,0,46,0,0,0,62,0,3,0,39,0,0,0,47,0,0,0,61,0,4,0,2,0,0,0,48,0,0,0,
+39,0,0,0,80,0,6,0,27,0,0,0,49,0,0,0,48,0,0,0,34,0,0,0,10,0,0,0,65,0,
+5,0,51,0,0,0,50,0,0,0,40,0,0,0,33,0,0,0,62,0,3,0,50,0,0,0,49,0,0,0,
+61,0,4,0,2,0,0,0,52,0,0,0,39,0,0,0,142,0,5,0,2,0,0,0,53,0,0,0,52,0,
+0,0,35,0,0,0,129,0,5,0,2,0,0,0,54,0,0,0,53,0,0,0,36,0,0,0,65,0,5,0,
+31,0,0,0,55,0,0,0,40,0,0,0,21,0,0,0,62,0,3,0,55,0,0,0,54,0,0,0,61,0,
+4,0,30,0,0,0,56,0,0,0,40,0,0,0,81,0,5,0,2,0,0,0,57,0,0,0,56,0,0,0,
+0,0,0,0,62,0,3,0,26,0,0,0,57,0,0,0,81,0,5,0,27,0,0,0,58,0,0,0,56,0,
+0,0,1,0,0,0,62,0,3,0,29,0,0,0,58,0,0,0,253,0,1,0,56,0,1,0

runtime/Includes/Graphics/Drawable.h

@@ -0,0 +1,58 @@
+#ifndef __MLX_DRAWABLE__
+#define __MLX_DRAWABLE__
+
+#include <Graphics/Enums.h>
+#include <Maths/Quaternions.h>
+#include <Maths/EulerAngles.h>
+
+namespace mlx
+{
+	class Drawable
+	{
+		friend class Render2DPass;
+
+		public:
+			inline Drawable(DrawableType type) : m_type(type) {}
+
+			inline void SetColor(Vec4f color) noexcept { m_color = std::move(color); }
+			inline void SetPosition(Vec2f position) noexcept { m_position = std::move(position); }
+			inline void SetScale(Vec2f scale) noexcept { m_scale = std::move(scale); }
+			inline void SetRotation(float rotation) noexcept { m_rotation = EulerAnglesf{ 0.0f, 0.0f, rotation }; }
+			inline void SetCenter(Vec2f center) noexcept { m_center = std::move(center); }
+
+			inline virtual void Update([[maybe_unused]] VkCommandBuffer cmd) {}
+
+			[[nodiscard]] MLX_FORCEINLINE const Vec4f& GetColor() const noexcept { return m_color; }
+			[[nodiscard]] MLX_FORCEINLINE const Vec2f& GetPosition() const noexcept { return m_position; }
+			[[nodiscard]] MLX_FORCEINLINE const Vec2f& GetScale() const noexcept { return m_scale; }
+			[[nodiscard]] MLX_FORCEINLINE const Quatf& GetRotation() const noexcept { return m_rotation; }
+			[[nodiscard]] MLX_FORCEINLINE const Vec2f& GetCenter() const noexcept { return m_center; }
+			[[nodiscard]] MLX_FORCEINLINE std::shared_ptr<Mesh> GetMesh() const { return p_mesh; }
+			[[nodiscard]] MLX_FORCEINLINE DrawableType GetType() const noexcept { return m_type; }
+
+			inline virtual ~Drawable() { if(p_set) p_set->ReturnDescriptorSetToPool(); }
+
+		protected:
+			[[nodiscard]] inline bool IsSetInit() const noexcept { return p_set && p_set->IsInit(); }
+			[[nodiscard]] inline VkDescriptorSet GetSet(std::size_t frame_index) const noexcept { return p_set ? p_set->GetSet(frame_index) : VK_NULL_HANDLE; }
+
+			inline void UpdateDescriptorSet(std::shared_ptr<DescriptorSet> set)
+			{
+				p_set = RenderCore::Get().GetDescriptorPoolManager().GetAvailablePool().RequestDescriptorSet(set->GetShaderLayout(), set->GetShaderType());
+			}
+
+			virtual void Bind(std::size_t frame_index, VkCommandBuffer cmd) = 0;
+
+		protected:
+			std::shared_ptr<DescriptorSet> p_set;
+			std::shared_ptr<Mesh> p_mesh;
+			Quatf m_rotation = Quatf::Identity();
+			Vec4f m_color = Vec4f{ 1.0f, 1.0f, 1.0f, 1.0f };
+			Vec2f m_position = Vec2f{ 0.0f, 0.0f };
+			Vec2f m_scale = Vec2f{ 1.0f, 1.0f };
+			Vec2f m_center = Vec2f{ 0.0f, 0.0f };
+			DrawableType m_type;
+	};
+}
+
+#endif

runtime/Includes/Graphics/Enums.h

@@ -0,0 +1,13 @@
+#ifndef __MLX_GRAPHICS_ENUMS__
+#define __MLX_GRAPHICS_ENUMS__
+
+namespace mlx
+{
+	enum class DrawableType
+	{
+		Sprite,
+		Text
+	};
+}
+
+#endif

runtime/Includes/Graphics/Font.h

@@ -0,0 +1,53 @@
+#ifndef __MLX_FONT__
+#define __MLX_FONT__
+
+#include <Renderer/Image.h>
+
+namespace mlx
+{
+	class Font
+	{
+		public:
+			Font(const std::filesystem::path& path, float scale) : m_build_data(path), m_name(path.string()), m_scale(scale) {}
+			Font(const std::string& name, const std::vector<std::uint8_t>& ttf_data, float scale) : m_build_data(ttf_data), m_name(name), m_scale(scale) {}
+
+			void BuildFont();
+			void Destroy();
+
+			inline const std::string& GetName() const { return m_name; }
+			inline float GetScale() const noexcept { return m_scale; }
+			inline const std::array<stbtt_packedchar, 96>& GetCharData() const { return m_cdata; }
+			inline const Texture& GetTexture() const noexcept { return m_atlas; }
+			inline bool operator==(const Font& rhs) const { return rhs.m_name == m_name && rhs.m_scale == m_scale; }
+			inline bool operator!=(const Font& rhs) const { return rhs.m_name != m_name || rhs.m_scale != m_scale; }
+
+			inline ~Font() { Destroy(); }
+
+		private:
+			std::array<stbtt_packedchar, 96> m_cdata;
+			Texture m_atlas;
+			std::variant<std::filesystem::path, std::vector<std::uint8_t>> m_build_data;
+			std::string m_name;
+			float m_scale;
+	};
+
+	class FontRegistry
+	{
+		public:
+			FontRegistry() = default;
+
+			inline void RegisterFont(std::shared_ptr<Font> font);
+			inline void UnregisterFont(std::shared_ptr<Font> font);
+			inline std::shared_ptr<Font> GetFont(const std::filesystem::path& name, float scale);
+			inline void Reset();
+
+			~FontRegistry() = default;
+
+		private:
+			std::unordered_set<std::shared_ptr<Font>> m_fonts_registry;
+	};
+}
+
+#include <Graphics/Font.inl>
+
+#endif

runtime/Includes/Graphics/Font.inl

@@ -0,0 +1,31 @@
+#pragma once
+#include <Graphics/Font.h>
+
+namespace mlx
+{
+	void FontRegistry::RegisterFont(std::shared_ptr<Font> font)
+	{
+		m_fonts_registry.insert(font);
+	}
+
+	void FontRegistry::UnregisterFont(std::shared_ptr<Font> font)
+	{
+		m_fonts_registry.erase(font);
+	}
+
+	std::shared_ptr<Font> FontRegistry::GetFont(const std::filesystem::path& name, float scale)
+	{
+		auto it = std::find_if(m_fonts_registry.begin(), m_fonts_registry.end(), [&name, scale](std::shared_ptr<Font> rhs)
+		{
+			return (name == rhs->GetName() && scale == rhs->GetScale());
+		});
+		return (it != m_fonts_registry.end() ? *it : nullptr);
+	}
+
+	void FontRegistry::Reset()
+	{
+		for(auto& font: m_fonts_registry)
+			font->Destroy();
+		m_fonts_registry.clear();
+	}
+}

runtime/Includes/Graphics/Mesh.h

@@ -0,0 +1,68 @@
+#ifndef __MLX_RENDERER_MESH__
+#define __MLX_RENDERER_MESH__
+
+#include <Renderer/Vertex.h>
+#include <Renderer/Buffer.h>
+#include <Utils/Buffer.h>
+
+namespace mlx
+{
+	class Mesh
+	{
+		public:
+			struct SubMesh
+			{
+				struct NoBuild {};
+
+				VertexBuffer vbo;
+				IndexBuffer ibo;
+				std::vector<Vertex> vertex_data;
+				std::vector<std::uint32_t> index_data;
+				std::size_t triangle_count = 0;
+
+				inline SubMesh(const std::vector<Vertex>& vertices, const std::vector<std::uint32_t>& indices);
+				inline SubMesh(const std::vector<Vertex>& vertices, const std::vector<std::uint32_t>& indices, NoBuild);
+			};
+
+		public:
+			Mesh() = default;
+
+			void Draw(VkCommandBuffer cmd, std::size_t& drawcalls, std::size_t& polygondrawn) const noexcept;
+			void Draw(VkCommandBuffer cmd, std::size_t& drawcalls, std::size_t& polygondrawn, std::size_t submesh_index) const noexcept;
+
+			inline std::size_t GetSubMeshCount() const { return m_sub_meshes.size(); }
+
+			inline void AddSubMesh(SubMesh mesh) { m_sub_meshes.emplace_back(std::move(mesh)); }
+			[[nodiscard]] inline SubMesh& GetSubMesh(std::size_t index) { return m_sub_meshes.at(index); }
+
+			~Mesh();
+
+		private:
+			std::vector<SubMesh> m_sub_meshes;
+	};
+
+	// A registry just to avoid destroying meshes when clearing a window
+	class MeshRegistry
+	{
+		public:
+			inline MeshRegistry();
+
+			inline void RegisterMesh(std::shared_ptr<Mesh> mesh);
+			inline std::shared_ptr<Mesh> FindMesh(const std::vector<Mesh::SubMesh>& sub_meshes);
+			inline void UnregisterMesh(std::shared_ptr<Mesh> mesh);
+			inline void Reset();
+
+			inline static bool IsInit() noexcept { return s_instance != nullptr; }
+			inline static MeshRegistry& Get() noexcept { return *s_instance; }
+
+			inline ~MeshRegistry();
+
+		private:
+			inline static MeshRegistry* s_instance = nullptr;
+			std::unordered_set<std::shared_ptr<Mesh>> m_meshes_registry;
+	};
+}
+
+#include <Graphics/Mesh.inl>
+
+#endif

runtime/Includes/Graphics/Mesh.inl

@@ -0,0 +1,77 @@
+#pragma once
+#include <Graphics/Mesh.h>
+
+namespace mlx
+{
+	Mesh::SubMesh::SubMesh(const std::vector<Vertex>& vertices, const std::vector<std::uint32_t>& indices) : vertex_data(vertices), index_data(indices)
+	{
+		CPUBuffer vb(vertices.size() * sizeof(Vertex));
+		std::memcpy(vb.GetData(), vertices.data(), vb.GetSize());
+		vbo.Init(vb.GetSize(), 0, "mlx_mesh");
+		vbo.SetData(std::move(vb));
+
+		CPUBuffer ib(indices.size() * sizeof(std::uint32_t));
+		std::memcpy(ib.GetData(), indices.data(), ib.GetSize());
+		ibo.Init(ib.GetSize(), 0, "mlx_mesh");
+		ibo.SetData(std::move(ib));
+
+		triangle_count = vertices.size() / 3;
+	}
+
+	Mesh::SubMesh::SubMesh(const std::vector<Vertex>& vertices, const std::vector<std::uint32_t>& indices, NoBuild) : vertex_data(vertices), index_data(indices) {}
+
+	MeshRegistry::MeshRegistry()
+	{
+		s_instance = this;
+	}
+
+	void MeshRegistry::RegisterMesh(std::shared_ptr<Mesh> mesh)
+	{
+		m_meshes_registry.insert(mesh);
+	}
+
+	std::shared_ptr<Mesh> MeshRegistry::FindMesh(const std::vector<Mesh::SubMesh>& sub_meshes)
+	{
+		for(const std::shared_ptr<Mesh>& mesh : m_meshes_registry)
+		{
+			if(mesh->GetSubMeshCount() != sub_meshes.size()) // If the number of submeshes is different than the one we want to find no need to test
+				continue;
+			bool found = true;
+			for(std::size_t i = 0; i < sub_meshes.size(); i++)
+			{
+				try
+				{
+					const Mesh::SubMesh& registered_sub_mesh = mesh->GetSubMesh(i);
+					if(registered_sub_mesh.vertex_data != sub_meshes[i].vertex_data || registered_sub_mesh.index_data != sub_meshes[i].index_data)
+					{
+						found = false;
+						break;
+					}
+				}
+				catch(...)
+				{
+					found = false;
+					break;
+				}
+			}
+			if(found)
+				return mesh;
+		}
+		return nullptr;
+	}
+
+	void MeshRegistry::UnregisterMesh(std::shared_ptr<Mesh> mesh)
+	{
+		m_meshes_registry.erase(mesh);
+	}
+
+	void MeshRegistry::Reset()
+	{
+		m_meshes_registry.clear();
+	}
+
+	MeshRegistry::~MeshRegistry()
+	{
+		s_instance = nullptr;
+	}
+}

runtime/Includes/Graphics/PutPixelManager.h

@@ -0,0 +1,32 @@
+#ifndef __MLX_PUT_PIXEL_MANAGER__
+#define __MLX_PUT_PIXEL_MANAGER__
+
+#include <Renderer/Image.h>
+
+namespace mlx
+{
+	class PutPixelManager
+	{
+		public:
+			PutPixelManager(NonOwningPtr<class Renderer> renderer) : p_renderer(renderer) {}
+
+			// Returns a valid pointer when a new texture has been created
+			NonOwningPtr<Texture> DrawPixel(int x, int y, std::uint64_t draw_layer, mlx_color color);
+			NonOwningPtr<Texture> DrawPixelsArray(int x, int y, std::uint64_t draw_layer, mlx_color* pixels, std::size_t pixels_size);
+			NonOwningPtr<Texture> DrawPixelsRegion(int x, int y, int w, int h, std::uint64_t draw_layer, mlx_color* pixels);
+			void ResetRenderData();
+
+			~PutPixelManager() = default;
+
+		private:
+			NonOwningPtr<Texture> GetLayer(std::uint64_t draw_layer, bool& is_newlayer);
+
+		private:
+			std::unordered_map<std::uint64_t, NonOwningPtr<Texture>> m_placements;
+			std::vector<std::unique_ptr<Texture>> m_textures;
+			NonOwningPtr<class Renderer> p_renderer;
+			std::size_t m_current_texture_index = 0;
+	};
+}
+
+#endif

runtime/Includes/Graphics/Scene.h

@@ -0,0 +1,50 @@
+#ifndef __MLX_SCENE__
+#define __MLX_SCENE__
+
+#include <Renderer/Renderer.h>
+#include <Graphics/Text.h>
+#include <Graphics/Font.h>
+#include <Graphics/Sprite.h>
+#include <Graphics/Drawable.h>
+#include <Renderer/ViewerData.h>
+#include <Maths/Vec4.h>
+
+namespace mlx
+{
+	class Scene
+	{
+		public:
+			Scene() = default;
+
+			Sprite& CreateSprite(NonOwningPtr<class Texture> texture) noexcept;
+			NonOwningPtr<Sprite> GetSpriteFromTexturePositionScaleRotation(NonOwningPtr<Texture> texture, const Vec2f& position, float scale_x, float scale_y, float rotation) const;
+			void TryEraseSpriteFromTexture(NonOwningPtr<Texture> texture);
+			bool IsTextureAtGivenDrawLayer(NonOwningPtr<Texture> texture, std::uint64_t draw_layer) const;
+
+			Text& CreateText(const std::string& text) noexcept;
+			NonOwningPtr<Text> GetTextFromPositionAndColor(const std::string& text, const Vec2f& position, const Vec4f& color) const;
+			bool IsTextAtGivenDrawLayer(const std::string& text, std::uint64_t draw_layer) const;
+
+			inline void BindFont(std::shared_ptr<Font> font) { Verify((bool)font, "invalid fond pointer"); p_bound_font = font; }
+
+			void BringToDrawLayer(NonOwningPtr<Drawable> drawable, std::uint64_t draw_layer);
+
+			inline void ResetScene(Vec4f clear) { m_drawables.clear(); m_clear_color = std::move(clear); m_has_scene_changed = true; }
+			inline const Vec4f& GetClearColor() const noexcept { return m_clear_color; }
+
+			[[nodiscard]] MLX_FORCEINLINE const std::vector<std::shared_ptr<Drawable>>& GetDrawables() const noexcept { return m_drawables; }
+
+			inline void ResetChangeChecker() noexcept { m_has_scene_changed = false; }
+			inline bool HasSceneChanged() const noexcept { return m_has_scene_changed; }
+
+			~Scene() = default;
+
+		private:
+			std::vector<std::shared_ptr<Drawable>> m_drawables;
+			std::shared_ptr<Font> p_bound_font;
+			Vec4f m_clear_color = { 0.0f, 0.0f, 0.0f, 1.0f };
+			bool m_has_scene_changed = false;
+	};
+}
+
+#endif

runtime/Includes/Graphics/Sprite.h

@@ -0,0 +1,45 @@
+#ifndef __MLX_SPRITE__
+#define __MLX_SPRITE__
+
+#include <Maths/Vec3.h>
+#include <Maths/Vec4.h>
+#include <Graphics/Mesh.h>
+#include <Renderer/Descriptor.h>
+#include <Renderer/Image.h>
+#include <Graphics/Drawable.h>
+
+namespace mlx
+{
+	class Sprite : public Drawable
+	{
+		friend class Render2DPass;
+
+		public:
+			Sprite(NonOwningPtr<Texture> texture);
+			Sprite(std::shared_ptr<Mesh> mesh, NonOwningPtr<Texture> texture);
+
+			MLX_FORCEINLINE void Update(VkCommandBuffer cmd) override
+			{
+				Verify((bool)p_texture, "a sprite has no texture attached (internal mlx issue, please report to the devs)");
+				p_texture->Update(cmd);
+			}
+
+			[[nodiscard]] MLX_FORCEINLINE NonOwningPtr<Texture> GetTexture() const { return p_texture; }
+
+			inline ~Sprite() = default;
+
+		private:
+			inline void Bind(std::size_t frame_index, VkCommandBuffer cmd) override
+			{
+				if(!p_set)
+					return;
+				p_set->SetImage(frame_index, 0, *p_texture);
+				p_set->Update(frame_index, cmd);
+			}
+
+		private:
+			NonOwningPtr<Texture> p_texture;
+	};
+}
+
+#endif

runtime/Includes/Graphics/Text.h

@@ -0,0 +1,40 @@
+#ifndef __MLX_TEXT__
+#define __MLX_TEXT__
+
+#include <Graphics/Font.h>
+#include <Graphics/Mesh.h>
+#include <Graphics/Drawable.h>
+
+namespace mlx
+{
+	class Text : public Drawable
+	{
+		friend class Render2DPass;
+
+		public:
+			Text(const std::string& text, std::shared_ptr<Font> font);
+			inline Text(const std::string& text, std::shared_ptr<Font> font, std::shared_ptr<Mesh> mesh) : Drawable(DrawableType::Text) { Init(text, font, mesh); }
+
+			[[nodiscard]] inline const std::string& GetText() const { return m_text; }
+			[[nodiscard]] inline std::shared_ptr<Font> GetFont() const { return p_font; }
+
+			virtual ~Text() = default;
+
+		private:
+			void Init(const std::string& text, std::shared_ptr<Font> font, std::shared_ptr<Mesh> mesh);
+
+			inline void Bind(std::size_t frame_index, VkCommandBuffer cmd) override
+			{
+				if(!p_set)
+					return;
+				p_set->SetImage(frame_index, 0, const_cast<Texture&>(p_font->GetTexture()));
+				p_set->Update(frame_index, cmd);
+			}
+
+		private:
+			std::shared_ptr<Font> p_font;
+			std::string m_text;
+	};
+}
+
+#endif

runtime/Includes/Maths/Angles.h

@@ -0,0 +1,106 @@
+#ifndef __MLX_ANGLES__
+#define __MLX_ANGLES__
+
+#include <Maths/Enums.h>
+
+namespace mlx
+{
+	template<typename T> struct EulerAngles;
+	template<typename T> struct Quat;
+
+	template<AngleUnit Unit, typename T>
+	struct Angle
+	{
+		T value;
+
+		constexpr Angle() = default;
+		constexpr Angle(T angle);
+		template<typename U> constexpr explicit Angle(const Angle<Unit, U>& Angle);
+		template<AngleUnit FromUnit> constexpr Angle(const Angle<FromUnit, T>& angle);
+		constexpr Angle(const Angle&) = default;
+		constexpr Angle(Angle&&) noexcept = default;
+		~Angle() = default;
+
+		constexpr bool ApproxEqual(const Angle& angle) const;
+		constexpr bool ApproxEqual(const Angle& angle, T max_difference) const;
+
+		T GetCos() const;
+		T GetSin() const;
+		std::pair<T, T> GetSinCos() const;
+		T GetTan() const;
+
+		constexpr Angle& Normalize();
+
+		template<AngleUnit ToUnit> T To() const;
+		template<AngleUnit ToUnit> Angle<ToUnit, T> ToAngle() const;
+		constexpr T ToDegrees() const;
+		constexpr Angle<AngleUnit::Degree, T> ToDegreeAngle() const;
+		EulerAngles<T> ToEulerAngles() const;
+		Quat<T> ToQuat() const;
+		constexpr T ToRadians() const;
+		constexpr Angle<AngleUnit::Radian, T> ToRadianAngle() const;
+		std::string ToString() const;
+		constexpr T ToTurns() const;
+		constexpr Angle<AngleUnit::Turn, T> ToTurnAngle() const;
+
+		constexpr Angle& operator=(const Angle&) = default;
+		constexpr Angle& operator=(Angle&&) noexcept = default;
+
+		constexpr Angle operator+() const;
+		constexpr Angle operator-() const;
+
+		constexpr Angle operator+(Angle other) const;
+		constexpr Angle operator-(Angle other) const;
+		constexpr Angle operator*(T scalar) const;
+		constexpr Angle operator/(T divider) const;
+
+		constexpr Angle& operator+=(Angle other);
+		constexpr Angle& operator-=(Angle other);
+		constexpr Angle& operator*=(T scalar);
+		constexpr Angle& operator/=(T divider);
+
+		constexpr bool operator==(Angle other) const;
+		constexpr bool operator!=(Angle other) const;
+		constexpr bool operator<(Angle other) const;
+		constexpr bool operator<=(Angle other) const;
+		constexpr bool operator>(Angle other) const;
+		constexpr bool operator>=(Angle other) const;
+
+		static constexpr bool ApproxEqual(const Angle& lhs, const Angle& rhs);
+		static constexpr bool ApproxEqual(const Angle& lhs, const Angle& rhs, T max_difference);
+		static constexpr Angle Clamp(Angle angle, Angle min, Angle max);
+		template<AngleUnit FromUnit> static constexpr Angle From(T value);
+		static constexpr Angle FromDegrees(T degrees);
+		static constexpr Angle FromRadians(T radians);
+		static constexpr Angle FromTurns(T turn);
+		static constexpr Angle Zero();
+	};
+
+	template<typename T>
+	using DegreeAngle = Angle<AngleUnit::Degree, T>;
+
+	using DegreeAngled = DegreeAngle<double>;
+	using DegreeAnglef = DegreeAngle<float>;
+
+	template<typename T>
+	using RadianAngle = Angle<AngleUnit::Radian, T>;
+
+	using RadianAngled = RadianAngle<double>;
+	using RadianAnglef = RadianAngle<float>;
+
+	template<typename T>
+	using TurnAngle = Angle<AngleUnit::Turn, T>;
+
+	using TurnAngled = TurnAngle<double>;
+	using TurnAnglef = TurnAngle<float>;
+
+	template<AngleUnit Unit, typename T> Angle<Unit, T> operator*(T scale, Angle<Unit, T> angle);
+
+	template<AngleUnit Unit, typename T> Angle<Unit, T> operator/(T divider, Angle<Unit, T> angle);
+
+	template<AngleUnit Unit, typename T> std::ostream& operator<<(std::ostream& out, Angle<Unit, T> angle);
+}
+
+#include <Maths/Angles.inl>
+
+#endif

runtime/Includes/Maths/Angles.inl

@@ -0,0 +1,493 @@
+#pragma once
+#include <Maths/Angles.h>
+
+#include <Maths/Constants.h>
+#include <Maths/MathsUtils.h>
+
+namespace mlx
+{
+	namespace Internal
+	{
+		template<AngleUnit From, AngleUnit To> struct AngleConversion;
+
+		template<AngleUnit Unit>
+		struct AngleConversion<Unit, Unit>
+		{
+			template<typename T>
+			static constexpr T Convert(T angle)
+			{
+				return angle;
+			}
+		};
+
+		template<>
+		struct AngleConversion<AngleUnit::Degree, AngleUnit::Radian>
+		{
+			template<typename T>
+			static constexpr T Convert(T angle)
+			{
+				return DegreeToRadian(angle);
+			}
+		};
+
+		template<>
+		struct AngleConversion<AngleUnit::Degree, AngleUnit::Turn>
+		{
+			template<typename T>
+			static constexpr T Convert(T angle)
+			{
+				return angle / T(360);
+			}
+		};
+
+		template<>
+		struct AngleConversion<AngleUnit::Radian, AngleUnit::Degree>
+		{
+			template<typename T>
+			static constexpr T Convert(T angle)
+			{
+				return RadianToDegree(angle);
+			}
+		};
+
+		template<>
+		struct AngleConversion<AngleUnit::Radian, AngleUnit::Turn>
+		{
+			template<typename T>
+			static constexpr T Convert(T angle)
+			{
+				return angle / Tau<T>();
+			}
+		};
+
+		template<>
+		struct AngleConversion<AngleUnit::Turn, AngleUnit::Degree>
+		{
+			template<typename T>
+			static constexpr T Convert(T angle)
+			{
+				return angle * T(360);
+			}
+		};
+
+		template<>
+		struct AngleConversion<AngleUnit::Turn, AngleUnit::Radian>
+		{
+			template<typename T>
+			static constexpr T Convert(T angle)
+			{
+				return angle * Tau<T>();
+			}
+		};
+
+		template<AngleUnit Unit> struct AngleUtils;
+
+		template<>
+		struct AngleUtils<AngleUnit::Degree>
+		{
+			template<typename T>
+			static constexpr T GetEpsilon()
+			{
+				return T(1e-4);
+			}
+
+			template<typename T>
+			static constexpr T GetLimit()
+			{
+				return 360;
+			}
+
+			template<typename T> static std::ostream& ToString(std::ostream& out, T value)
+			{
+				return out << "Angle(" << value << "deg)";
+			}
+		};
+
+		template<>
+		struct AngleUtils<AngleUnit::Radian>
+		{
+			template<typename T>
+			static constexpr T GetEpsilon()
+			{
+				return T(1e-5);
+			}
+
+			template<typename T>
+			static constexpr T GetLimit()
+			{
+				return Tau<T>();
+			}
+
+			template<typename T>
+			static std::ostream& ToString(std::ostream& out, T value)
+			{
+				return out << "Angle(" << value << "rad)";
+			}
+		};
+
+		template<>
+		struct AngleUtils<AngleUnit::Turn>
+		{
+			template<typename T>
+			static constexpr T GetEpsilon()
+			{
+				return T(1e-5);
+			}
+
+			template<typename T>
+			static constexpr T GetLimit()
+			{
+				return 1;
+			}
+
+			template<typename T>
+			static std::ostream& ToString(std::ostream& out, T value)
+			{
+				return out << "Angle(" << value << "turn)";
+			}
+		};
+
+		#ifdef MLX_PLAT_LINUX
+			template<typename T>
+			void SinCos(T x, T* sin, T* cos)
+			{
+				double s, c;
+				::sincos(x, &s, &c);
+				*sin = static_cast<T>(s);
+				*cos = static_cast<T>(c);
+			}
+
+			template<>
+			inline void SinCos(float x, float* s, float* c)
+			{
+				::sincosf(x, s, c);
+			}
+
+			template<>
+			inline void SinCos(long double x, long double* s, long double* c)
+			{
+				::sincosl(x, s, c);
+			}
+		#else
+			template<typename T>
+			void SinCos(T x, T* sin, T* cos)
+			{
+				*sin = std::sin(x);
+				*cos = std::cos(x);
+			}
+		#endif
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr Angle<Unit, T>::Angle(T angle) :
+	value(angle)
+	{
+	}
+
+	template<AngleUnit Unit, typename T>
+	template<typename U>
+	constexpr Angle<Unit, T>::Angle(const Angle<Unit, U>& angle) :
+	value(static_cast<T>(angle.value))
+	{
+	}
+
+	template<AngleUnit Unit, typename T>
+	template<AngleUnit FromUnit>
+	constexpr Angle<Unit, T>::Angle(const Angle<FromUnit, T>& angle) :
+	value(Internal::AngleConversion<FromUnit, Unit>::Convert(angle.value))
+	{
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr bool Angle<Unit, T>::ApproxEqual(const Angle& angle) const
+	{
+		return ApproxEqual(angle, Internal::AngleUtils<Unit>::template GetEpsilon<T>());
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr bool Angle<Unit, T>::ApproxEqual(const Angle& angle, T maxDifference) const
+	{
+		return NumberEquals(value, angle.value, maxDifference);
+	}
+
+	template<AngleUnit Unit, typename T>
+	T Angle<Unit, T>::GetCos() const
+	{
+		return std::cos(ToRadians());
+	}
+
+	template<AngleUnit Unit, typename T>
+	T Angle<Unit, T>::GetSin() const
+	{
+		return std::sin(ToRadians());
+	}
+
+	template<AngleUnit Unit, typename T>
+	std::pair<T, T> Angle<Unit, T>::GetSinCos() const
+	{
+		T sin, cos;
+		Internal::SinCos<T>(ToRadians(), &sin, &cos);
+
+		return std::make_pair(sin, cos);
+	}
+
+	template<AngleUnit Unit, typename T>
+	T Angle<Unit, T>::GetTan() const
+	{
+		return std::tan(ToRadians());
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr Angle<Unit, T>& Angle<Unit, T>::Normalize()
+	{
+		constexpr T limit = Internal::AngleUtils<Unit>::template GetLimit<T>();
+		constexpr T halfLimit = limit / T(2);
+
+		value = Mod(value + halfLimit, limit);
+		if (value < T(0))
+			value += limit;
+
+		value -= halfLimit;
+		return *this;
+	}
+
+	template<AngleUnit Unit, typename T>
+	template<AngleUnit ToUnit>
+	T Angle<Unit, T>::To() const
+	{
+		return Internal::AngleConversion<Unit, ToUnit>::Convert(value);
+	}
+
+	template<AngleUnit Unit, typename T>
+	template<AngleUnit ToUnit>
+	Angle<ToUnit, T> Angle<Unit, T>::ToAngle() const
+	{
+		return Angle<ToUnit, T>(To<ToUnit>());
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr T Angle<Unit, T>::ToDegrees() const
+	{
+		return To<AngleUnit::Degree>();
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr Angle<AngleUnit::Degree, T> Angle<Unit, T>::ToDegreeAngle() const
+	{
+		return ToAngle<AngleUnit::Degree>();
+	}
+
+	template<AngleUnit Unit, typename T>
+	EulerAngles<T> Angle<Unit, T>::ToEulerAngles() const
+	{
+		return EulerAngles<T>(0, 0, ToDegrees());
+	}
+
+	template<AngleUnit Unit, typename T>
+	Quat<T> Angle<Unit, T>::ToQuat() const
+	{
+		auto halfAngle = Angle(*this) / 2.f;
+		auto sincos = halfAngle.GetSinCos();
+		return Quat<T>(sincos.second, 0, 0, sincos.first);
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr T Angle<Unit, T>::ToRadians() const
+	{
+		return To<AngleUnit::Radian>();
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr Angle<AngleUnit::Radian, T> Angle<Unit, T>::ToRadianAngle() const
+	{
+		return ToAngle<AngleUnit::Radian>();
+	}
+
+	template<AngleUnit Unit, typename T>
+	std::string Angle<Unit, T>::ToString() const
+	{
+		std::ostringstream oss;
+		Internal::AngleUtils<Unit>::ToString(oss, value);
+
+		return oss.str();
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr T Angle<Unit, T>::ToTurns() const
+	{
+		return To<AngleUnit::Turn>(value);
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr Angle<AngleUnit::Turn, T> Angle<Unit, T>::ToTurnAngle() const
+	{
+		return ToAngle<AngleUnit::Turn>();
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr Angle<Unit, T> Angle<Unit, T>::operator+() const
+	{
+		return *this;
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr Angle<Unit, T> Angle<Unit, T>::operator-() const
+	{
+		return Angle(-value);
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr Angle<Unit, T> Angle<Unit, T>::operator+(Angle other) const
+	{
+		return Angle(value + other.value);
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr Angle<Unit, T> Angle<Unit, T>::operator-(Angle other) const
+	{
+		return Angle(value - other.value);
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr Angle<Unit, T> Angle<Unit, T>::operator*(T scalar) const
+	{
+		return Angle(value * scalar);
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr Angle<Unit, T> Angle<Unit, T>::operator/(T divider) const
+	{
+		return Angle(value / divider);
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr Angle<Unit, T>& Angle<Unit, T>::operator+=(Angle other)
+	{
+		value += other.value;
+		return *this;
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr Angle<Unit, T>& Angle<Unit, T>::operator-=(Angle other)
+	{
+		value -= other.value;
+		return *this;
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr Angle<Unit, T>& Angle<Unit, T>::operator*=(T scalar)
+	{
+		value *= scalar;
+		return *this;
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr Angle<Unit, T>& Angle<Unit, T>::operator/=(T divider)
+	{
+		value /= divider;
+		return *this;
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr bool Angle<Unit, T>::operator==(Angle other) const
+	{
+		return value == other.value;
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr bool Angle<Unit, T>::operator!=(Angle other) const
+	{
+		return value != other.value;
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr bool Angle<Unit, T>::operator<(Angle other) const
+	{
+		return value < other.value;
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr bool Angle<Unit, T>::operator<=(Angle other) const
+	{
+		return value <= other.value;
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr bool Angle<Unit, T>::operator>(Angle other) const
+	{
+		return value > other.value;
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr bool Angle<Unit, T>::operator>=(Angle other) const
+	{
+		return value >= other.value;
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr bool Angle<Unit, T>::ApproxEqual(const Angle& lhs, const Angle& rhs)
+	{
+		return lhs.ApproxEqual(rhs);
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr bool Angle<Unit, T>::ApproxEqual(const Angle& lhs, const Angle& rhs, T maxDifference)
+	{
+		return lhs.ApproxEqual(rhs, maxDifference);
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr Angle<Unit, T> Angle<Unit, T>::Clamp(Angle angle, Angle min, Angle max)
+	{
+		return Angle(std::clamp(angle.value, min.value, max.value));
+	}
+
+	template<AngleUnit Unit, typename T>
+	template<AngleUnit FromUnit>
+	constexpr Angle<Unit, T> Angle<Unit, T>::From(T value)
+	{
+		return Angle(Internal::AngleConversion<FromUnit, Unit>::Convert(value));
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr Angle<Unit, T> Angle<Unit, T>::FromDegrees(T degrees)
+	{
+		return From<AngleUnit::Degree>(degrees);
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr Angle<Unit, T> Angle<Unit, T>::FromRadians(T radians)
+	{
+		return From<AngleUnit::Radian>(radians);
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr Angle<Unit, T> Angle<Unit, T>::FromTurns(T turns)
+	{
+		return From<AngleUnit::Turn>(turns);
+	}
+
+	template<AngleUnit Unit, typename T>
+	constexpr Angle<Unit, T> Angle<Unit, T>::Zero()
+	{
+		return Angle(0);
+	}
+
+	template<AngleUnit Unit, typename T>
+	Angle<Unit, T> operator/(T scale, Angle<Unit, T> angle)
+	{
+		return Angle<Unit, T>(scale / angle.value);
+	}
+
+	template<AngleUnit Unit, typename T>
+	std::ostream& operator<<(std::ostream& out, Angle<Unit, T> angle)
+	{
+		return Internal::AngleUtils<Unit>::ToString(out, angle.value);
+	}
+
+	template<typename T, AngleUnit Unit>
+	constexpr Angle<Unit, T> Clamp(Angle<Unit, T> value, T min, T max)
+	{
+		return std::max(std::min(value.value, max), min);
+	}
+}

runtime/Includes/Maths/Constants.h

@@ -0,0 +1,83 @@
+#ifndef __MLX_MATHS_CONSTANTS__
+#define __MLX_MATHS_CONSTANTS__
+
+namespace mlx
+{
+	template<typename T> constexpr std::size_t BitCount = CHAR_BIT * sizeof(T);
+
+	template<typename T>
+	struct MathConstants
+	{
+		static constexpr T Infinity()
+		{
+			static_assert(std::numeric_limits<T>::has_infinity);
+			return std::numeric_limits<T>::infinity();
+		}
+
+		static constexpr T Max()
+		{
+			return std::numeric_limits<T>::max();
+		}
+
+		static constexpr T Min()
+		{
+			return std::numeric_limits<T>::min();
+		}
+
+		static constexpr T NaN()
+		{
+			static_assert(std::numeric_limits<T>::has_signaling_NaN);
+			return std::numeric_limits<T>::quiet_NaN();
+		}
+
+		// Math constants
+		static constexpr T HalfPi()
+		{
+			static_assert(std::is_floating_point_v<T>);
+			return T(1.5707963267948966192313216916398);
+		}
+
+		static constexpr T Pi()
+		{
+			static_assert(std::is_floating_point_v<T>);
+			return T(3.1415926535897932384626433832795);
+		}
+
+		static constexpr T Sqrt2()
+		{
+			static_assert(std::is_floating_point_v<T>);
+			return T(1.4142135623730950488016887242097);
+		}
+
+		static constexpr T Sqrt3()
+		{
+			static_assert(std::is_floating_point_v<T>);
+			return T(1.7320508075688772935274463415059);
+		}
+
+		static constexpr T Sqrt5()
+		{
+			static_assert(std::is_floating_point_v<T>);
+			return T(2.2360679774997896964091736687313);
+		}
+
+		static constexpr T Tau()
+		{
+			static_assert(std::is_floating_point_v<T>);
+			return T(6.2831853071795864769252867665590);
+		}
+	};
+
+	template<typename T = void> constexpr auto Infinity() { return MathConstants<T>::Infinity(); }
+	template<typename T = void> constexpr auto MaxValue() { return MathConstants<T>::Max(); }
+	template<typename T = void> constexpr auto MinValue() { return MathConstants<T>::Min(); }
+	template<typename T = void> constexpr auto NaN() { return MathConstants<T>::NaN(); }
+	template<typename T = void> constexpr auto HalfPi() { return MathConstants<T>::HalfPi(); }
+	template<typename T = void> constexpr auto Pi() { return MathConstants<T>::Pi(); }
+	template<typename T = void> constexpr auto Sqrt2() { return MathConstants<T>::Sqrt2(); }
+	template<typename T = void> constexpr auto Sqrt3() { return MathConstants<T>::Sqrt3(); }
+	template<typename T = void> constexpr auto Sqrt5() { return MathConstants<T>::Sqrt5(); }
+	template<typename T = void> constexpr auto Tau() { return MathConstants<T>::Tau(); }
+}
+
+#endif

runtime/Includes/Maths/Enums.h

@@ -0,0 +1,18 @@
+#ifndef __MLX_MATHS_ENUMS__
+#define __MLX_MATHS_ENUMS__
+
+namespace mlx
+{
+	enum class AngleUnit
+	{
+		Degree = 0,
+		Radian,
+		Turn,
+
+		EndEnum
+	};
+
+	constexpr std::size_t AngleUnitCount = static_cast<std::size_t>(AngleUnit::EndEnum);
+}
+
+#endif

runtime/Includes/Maths/EulerAngles.h

@@ -0,0 +1,55 @@
+#ifndef __MLX_EULER_ANGLES__
+#define __MLX_EULER_ANGLES__
+
+#include <Maths/Angles.h>
+
+namespace mlx
+{
+	template<typename T>
+	struct EulerAngles
+	{
+		constexpr EulerAngles() = default;
+		constexpr EulerAngles(DegreeAngle<T> P, DegreeAngle<T> Y, DegreeAngle<T> R);
+		constexpr EulerAngles(const DegreeAngle<T> angles[3]);
+		template<AngleUnit Unit> constexpr EulerAngles(const Angle<Unit, T>& angle);
+		constexpr EulerAngles(const Quat<T>& quat);
+		template<typename U> constexpr explicit EulerAngles(const EulerAngles<U>& angles);
+		constexpr EulerAngles(const EulerAngles&) = default;
+		constexpr EulerAngles(EulerAngles&&) = default;
+		~EulerAngles() = default;
+
+		constexpr bool ApproxEqual(const EulerAngles& angles, T maxDifference = std::numeric_limits<T>::epsilon()) const;
+
+		constexpr EulerAngles& Normalize();
+
+		Quat<T> ToQuat() const;
+		std::string ToString() const;
+
+		constexpr EulerAngles operator+(const EulerAngles& angles) const;
+		constexpr EulerAngles operator-(const EulerAngles& angles) const;
+
+		constexpr EulerAngles& operator=(const EulerAngles&) = default;
+		constexpr EulerAngles& operator=(EulerAngles&&) = default;
+
+		constexpr EulerAngles& operator+=(const EulerAngles& angles);
+		constexpr EulerAngles& operator-=(const EulerAngles& angles);
+
+		constexpr bool operator==(const EulerAngles& angles) const;
+		constexpr bool operator!=(const EulerAngles& angles) const;
+		constexpr bool operator<(const EulerAngles& angles) const;
+		constexpr bool operator<=(const EulerAngles& angles) const;
+		constexpr bool operator>(const EulerAngles& angles) const;
+		constexpr bool operator>=(const EulerAngles& angles) const;
+
+		static constexpr bool ApproxEqual(const EulerAngles& lhs, const EulerAngles& rhs, T maxDifference = std::numeric_limits<T>::epsilon());
+		static constexpr EulerAngles Zero();
+
+		DegreeAngle<T> pitch, yaw, roll;
+	};
+
+	using EulerAnglesf = EulerAngles<float>;
+}
+
+#include <Maths/EulerAngles.inl>
+
+#endif

runtime/Includes/Maths/EulerAngles.inl

@@ -0,0 +1,169 @@
+#pragma once
+#include <Maths/EulerAngles.h>
+
+namespace mlx
+{
+	template<typename T>
+	constexpr EulerAngles<T>::EulerAngles(DegreeAngle<T> P, DegreeAngle<T> Y, DegreeAngle<T> R) :
+		pitch(P), yaw(Y), roll(R)
+	{}
+
+	template<typename T>
+	constexpr EulerAngles<T>::EulerAngles(const DegreeAngle<T> angles[3]) :
+		EulerAngles(angles[0], angles[1], angles[2])
+	{}
+
+	template<typename T>
+	template<AngleUnit Unit>
+	constexpr EulerAngles<T>::EulerAngles(const Angle<Unit, T>& angle) :
+		EulerAngles(angle.ToEulerAngles())
+	{}
+
+	template<typename T>
+	constexpr EulerAngles<T>::EulerAngles(const Quat<T>& quat) :
+		EulerAngles(quat.ToEulerAngles())
+	{}
+
+	template<typename T>
+	template<typename U>
+	constexpr EulerAngles<T>::EulerAngles(const EulerAngles<U>& angles) :
+		pitch(DegreeAngle<T>(angles.pitch)), yaw(DegreeAngle<T>(angles.yaw)), roll(DegreeAngle<T>(angles.roll))
+	{}
+
+	template<typename T>
+	constexpr bool EulerAngles<T>::ApproxEqual(const EulerAngles& angles, T maxDifference) const
+	{
+		return pitch.ApproxEqual(angles.pitch, maxDifference) && yaw.ApproxEqual(angles.yaw, maxDifference) && roll.ApproxEqual(angles.roll, maxDifference);
+	}
+
+	template<typename T>
+	constexpr EulerAngles<T>& EulerAngles<T>::Normalize()
+	{
+		pitch.Normalize();
+		yaw.Normalize();
+		roll.Normalize();
+		return *this;
+	}
+
+	template<typename T>
+	Quat<T> EulerAngles<T>::ToQuat() const
+	{
+		// XYZ
+		auto [s1, c1] = (yaw / T(2.0)).GetSinCos();
+		auto [s2, c2] = (roll / T(2.0)).GetSinCos();
+		auto [s3, c3] = (pitch / T(2.0)).GetSinCos();
+
+		return Quat<T>(c1 * c2 * c3 - s1 * s2 * s3,
+						s1 * s2 * c3 + c1 * c2 * s3,
+						s1 * c2 * c3 + c1 * s2 * s3,
+						c1 * s2 * c3 - s1 * c2 * s3);
+	}
+
+	template<typename T>
+	std::string EulerAngles<T>::ToString() const
+	{
+		std::ostringstream ss;
+		ss << *this;
+		return ss.str();
+	}
+
+	template<typename T>
+	constexpr EulerAngles<T> EulerAngles<T>::operator+(const EulerAngles& angles) const
+	{
+		return EulerAngles(pitch + angles.pitch, yaw + angles.yaw, roll + angles.roll);
+	}
+
+	template<typename T>
+	constexpr EulerAngles<T> EulerAngles<T>::operator-(const EulerAngles& angles) const
+	{
+		return EulerAngles(pitch - angles.pitch, yaw - angles.yaw, roll - angles.roll);
+	}
+
+	template<typename T>
+	constexpr EulerAngles<T>& EulerAngles<T>::operator+=(const EulerAngles& angles)
+	{
+		pitch += angles.pitch;
+		yaw += angles.yaw;
+		roll += angles.roll;
+		return *this;
+	}
+
+	template<typename T>
+	constexpr EulerAngles<T>& EulerAngles<T>::operator-=(const EulerAngles& angles)
+	{
+		pitch -= angles.pitch;
+		yaw -= angles.yaw;
+		roll -= angles.roll;
+		return *this;
+	}
+
+	template<typename T>
+	constexpr bool EulerAngles<T>::operator==(const EulerAngles& angles) const
+	{
+		return pitch == angles.pitch && yaw == angles.yaw && roll == angles.roll;
+	}
+
+	template<typename T>
+	constexpr bool EulerAngles<T>::operator!=(const EulerAngles& angles) const
+	{
+		return !operator==(angles);
+	}
+
+	template<typename T>
+	constexpr bool EulerAngles<T>::operator<(const EulerAngles& angles) const
+	{
+		if (pitch != angles.pitch)
+			return pitch < angles.pitch;
+		if (yaw != angles.yaw)
+			return yaw < angles.yaw;
+		return roll < angles.roll;
+	}
+
+	template<typename T>
+	constexpr bool EulerAngles<T>::operator<=(const EulerAngles& angles) const
+	{
+		if (pitch != angles.pitch)
+			return pitch < angles.pitch;
+		if (yaw != angles.yaw)
+			return yaw < angles.yaw;
+		return roll <= angles.roll;
+	}
+
+	template<typename T>
+	constexpr bool EulerAngles<T>::operator>(const EulerAngles& angles) const
+	{
+		if (pitch != angles.pitch)
+			return pitch > angles.pitch;
+		if (yaw != angles.yaw)
+			return yaw > angles.yaw;
+		return roll > angles.roll;
+	}
+
+	template<typename T>
+	constexpr bool EulerAngles<T>::operator>=(const EulerAngles& angles) const
+	{
+		if (pitch != angles.pitch)
+			return pitch > angles.pitch;
+		if (yaw != angles.yaw)
+			return yaw > angles.yaw;
+		return roll >= angles.roll;
+	}
+
+	template<typename T>
+	constexpr bool EulerAngles<T>::ApproxEqual(const EulerAngles& lhs, const EulerAngles& rhs, T maxDifference)
+	{
+		return lhs.ApproxEqual(rhs, maxDifference);
+	}
+
+	template<typename T>
+	constexpr EulerAngles<T> EulerAngles<T>::Zero()
+	{
+		return EulerAngles(0, 0, 0);
+	}
+
+	template<typename T>
+	std::ostream& operator<<(std::ostream& out, const EulerAngles<T>& angles)
+	{
+		return out << "EulerAngles(" << angles.pitch << ", " << angles.yaw << ", " << angles.roll << ')';
+	}
+}

runtime/Includes/Maths/Mat4.h

@@ -0,0 +1,118 @@
+#ifndef __MLX_MAT4__
+#define __MLX_MAT4__
+
+#include <Maths/Angles.h>
+
+namespace mlx
+{
+	template<typename T> struct Vec2;
+	template<typename T> struct Vec3;
+	template<typename T> struct Vec4;
+	template<typename T> struct Quat;
+
+	template<typename T>
+	struct Mat4
+	{
+		T m11, m12, m13, m14;
+		T m21, m22, m23, m24;
+		T m31, m32, m33, m34;
+		T m41, m42, m43, m44;
+
+		constexpr Mat4() = default;
+		constexpr Mat4(T r11, T r12, T r13, T r14,
+						T r21, T r22, T r23, T r24,
+						T r31, T r32, T r33, T r34,
+						T r41, T r42, T r43, T r44);
+		constexpr Mat4(const T matrix[16]);
+		constexpr Mat4(const Mat4&) = default;
+		constexpr Mat4(Mat4&&) = default;
+
+		constexpr Mat4& ApplyRotation(const Quat<T>& rotation);
+		constexpr Mat4& ApplyScale(const Vec3<T>& scale);
+		constexpr Mat4& ApplyTranslation(const Vec3<T>& translation);
+
+		constexpr bool ApproxEqual(const Mat4& vec, T max_difference = std::numeric_limits<T>::epsilon()) const;
+
+		constexpr Mat4& Concatenate(const Mat4& matrix);
+		constexpr Mat4& ConcatenateTransform(const Mat4& matrix);
+
+		constexpr Vec4<T> GetColumn(std::size_t column) const;
+		constexpr T GetDeterminant() const;
+		constexpr T GetDeterminantTransform() const;
+		constexpr bool GetInverse(Mat4* dest) const;
+		constexpr bool GetInverseTransform(Mat4* dest) const;
+		Quat<T> GetRotation() const;
+		constexpr Vec4<T> GetRow(std::size_t row) const;
+		constexpr Vec3<T> GetScale() const;
+		constexpr Vec3<T> GetSquaredScale() const;
+		constexpr Vec3<T> GetTranslation() const;
+		constexpr void GetTransposed(Mat4* dest) const;
+
+		constexpr bool HasNegativeScale() const;
+		constexpr bool HasScale() const;
+
+		constexpr Mat4& Inverse(bool* succeeded = nullptr);
+		constexpr Mat4& InverseTransform(bool* succeeded = nullptr);
+
+		constexpr bool IsTransformMatrix() const;
+		constexpr bool IsIdentity() const;
+
+		constexpr Mat4& SetRotation(const Quat<T>& rotation);
+		constexpr Mat4& SetScale(const Vec3<T>& scale);
+		constexpr Mat4& SetTranslation(const Vec3<T>& translation);
+
+		std::string ToString() const;
+
+		constexpr Vec2<T> Transform(const Vec2<T>& vector, T z = 0.0, T w = 1.0) const;
+		constexpr Vec3<T> Transform(const Vec3<T>& vector, T w = 1.0) const;
+		constexpr Vec4<T> Transform(const Vec4<T>& vector) const;
+
+		constexpr Mat4& Transpose();
+
+		constexpr T& operator()(std::size_t x, std::size_t y);
+		constexpr const T& operator()(std::size_t x, std::size_t y) const;
+
+		constexpr T& operator[](std::size_t i);
+		constexpr const T& operator[](std::size_t i) const;
+
+		constexpr Mat4& operator=(const Mat4&) = default;
+		constexpr Mat4& operator=(Mat4&&) = default;
+
+		constexpr Mat4 operator*(const Mat4& matrix) const;
+		constexpr Vec2<T> operator*(const Vec2<T>& vector) const;
+		constexpr Vec3<T> operator*(const Vec3<T>& vector) const;
+		constexpr Vec4<T> operator*(const Vec4<T>& vector) const;
+		constexpr Mat4 operator*(T scalar) const;
+
+		constexpr Mat4& operator*=(const Mat4& matrix);
+		constexpr Mat4& operator*=(T scalar);
+
+		constexpr bool operator==(const Mat4& mat) const;
+		constexpr bool operator!=(const Mat4& mat) const;
+
+		static constexpr bool ApproxEqual(const Mat4& lhs, const Mat4& rhs, T max_difference = std::numeric_limits<T>::epsilon());
+		static constexpr Mat4 Concatenate(const Mat4& left, const Mat4& right);
+		static constexpr Mat4 ConcatenateTransform(const Mat4& left, const Mat4& right);
+		static constexpr Mat4 Identity();
+		static constexpr Mat4 LookAt(const Vec3<T>& eye, const Vec3<T>& target, const Vec3<T>& up = Vec3<T>::Up());
+		static constexpr Mat4 Ortho(T left, T right, T top, T bottom, T z_near = -1.0, T zFar = 1.0);
+		static Mat4 Perspective(RadianAngle<T> angle, T ratio, T z_near, T z_far);
+		static constexpr Mat4 Rotate(const Quat<T>& rotation);
+		static constexpr Mat4 Scale(const Vec3<T>& scale);
+		static constexpr Mat4 Translate(const Vec3<T>& translation);
+		static constexpr Mat4 Transform(const Vec3<T>& translation, const Quat<T>& rotation);
+		static constexpr Mat4 Transform(const Vec3<T>& translation, const Quat<T>& rotation, const Vec3<T>& scale);
+		static constexpr Mat4 TransformInverse(const Vec3<T>& translation, const Quat<T>& rotation);
+		static constexpr Mat4 TransformInverse(const Vec3<T>& translation, const Quat<T>& rotation, const Vec3<T>& scale);
+		static constexpr Mat4 Zero();
+
+		~Mat4() = default;
+	};
+
+	using Mat4d = Mat4<double>;
+	using Mat4f = Mat4<float>;
+}
+
+#include <Maths/Mat4.inl>
+
+#endif

runtime/Includes/Maths/Mat4.inl

@@ -0,0 +1,875 @@
+#pragma once
+#include <Maths/Mat4.h>
+
+#include <Maths/EulerAngles.h>
+#include <Maths/Quaternions.h>
+#include <Maths/Vec2.h>
+#include <Maths/Vec3.h>
+#include <Maths/Vec4.h>
+#include <Maths/MathsUtils.h>
+
+namespace mlx
+{
+	template<typename T>
+	constexpr Mat4<T>::Mat4(T r11, T r12, T r13, T r14,
+							T r21, T r22, T r23, T r24,
+							T r31, T r32, T r33, T r34,
+							T r41, T r42, T r43, T r44) :
+		m11(r11), m12(r12), m13(r13), m14(r14),
+		m21(r21), m22(r22), m23(r23), m24(r24),
+		m31(r31), m32(r32), m33(r33), m34(r34),
+		m41(r41), m42(r42), m43(r43), m44(r44)
+	{}
+
+	template<typename T>
+	constexpr Mat4<T>::Mat4(const T matrix[16]) :
+		Mat4(matrix[ 0], matrix[ 1], matrix[ 2], matrix[ 3],
+			matrix[ 4], matrix[ 5], matrix[ 6], matrix[ 7],
+			matrix[ 8], matrix[ 9], matrix[10], matrix[11],
+			matrix[12], matrix[13], matrix[14], matrix[15])
+	{}
+
+	template<typename T>
+	constexpr Mat4<T>& Mat4<T>::ApplyRotation(const Quat<T>& rotation)
+	{
+		return Concatenate(Mat4<T>::Rotate(rotation));
+	}
+
+	template<typename T>
+	constexpr Mat4<T>& Mat4<T>::ApplyScale(const Vec3<T>& scale)
+	{
+		m11 *= scale.x;
+		m12 *= scale.x;
+		m13 *= scale.x;
+
+		m21 *= scale.y;
+		m22 *= scale.y;
+		m23 *= scale.y;
+
+		m31 *= scale.z;
+		m32 *= scale.z;
+		m33 *= scale.z;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Mat4<T>& Mat4<T>::ApplyTranslation(const Vec3<T>& translation)
+	{
+		m41 += translation.x;
+		m42 += translation.y;
+		m43 += translation.z;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr bool Mat4<T>::ApproxEqual(const Mat4& mat, T maxDifference) const
+	{
+		for(unsigned int i = 0; i < 16; ++i)
+			if(!NumberEquals((&m11)[i], (&mat.m11)[i], maxDifference))
+				return false;
+
+		return true;
+	}
+
+	template<typename T>
+	constexpr Mat4<T>& Mat4<T>::Concatenate(const Mat4& matrix)
+	{
+		return operator=(Mat4(
+			m11 * matrix.m11 + m12 * matrix.m21 + m13 * matrix.m31 + m14 * matrix.m41,
+			m11 * matrix.m12 + m12 * matrix.m22 + m13 * matrix.m32 + m14 * matrix.m42,
+			m11 * matrix.m13 + m12 * matrix.m23 + m13 * matrix.m33 + m14 * matrix.m43,
+			m11 * matrix.m14 + m12 * matrix.m24 + m13 * matrix.m34 + m14 * matrix.m44,
+
+			m21 * matrix.m11 + m22 * matrix.m21 + m23 * matrix.m31 + m24 * matrix.m41,
+			m21 * matrix.m12 + m22 * matrix.m22 + m23 * matrix.m32 + m24 * matrix.m42,
+			m21 * matrix.m13 + m22 * matrix.m23 + m23 * matrix.m33 + m24 * matrix.m43,
+			m21 * matrix.m14 + m22 * matrix.m24 + m23 * matrix.m34 + m24 * matrix.m44,
+
+			m31 * matrix.m11 + m32 * matrix.m21 + m33 * matrix.m31 + m34 * matrix.m41,
+			m31 * matrix.m12 + m32 * matrix.m22 + m33 * matrix.m32 + m34 * matrix.m42,
+			m31 * matrix.m13 + m32 * matrix.m23 + m33 * matrix.m33 + m34 * matrix.m43,
+			m31 * matrix.m14 + m32 * matrix.m24 + m33 * matrix.m34 + m34 * matrix.m44,
+
+			m41 * matrix.m11 + m42 * matrix.m21 + m43 * matrix.m31 + m44 * matrix.m41,
+			m41 * matrix.m12 + m42 * matrix.m22 + m43 * matrix.m32 + m44 * matrix.m42,
+			m41 * matrix.m13 + m42 * matrix.m23 + m43 * matrix.m33 + m44 * matrix.m43,
+			m41 * matrix.m14 + m42 * matrix.m24 + m43 * matrix.m34 + m44 * matrix.m44
+		));
+	}
+
+	template<typename T>
+	constexpr Mat4<T>& Mat4<T>::ConcatenateTransform(const Mat4& matrix)
+	{
+		return operator=(Mat4(
+			m11*matrix.m11 + m12*matrix.m21 + m13*matrix.m31,
+			m11*matrix.m12 + m12*matrix.m22 + m13*matrix.m32,
+			m11*matrix.m13 + m12*matrix.m23 + m13*matrix.m33,
+			T(0.0),
+
+			m21*matrix.m11 + m22*matrix.m21 + m23*matrix.m31,
+			m21*matrix.m12 + m22*matrix.m22 + m23*matrix.m32,
+			m21*matrix.m13 + m22*matrix.m23 + m23*matrix.m33,
+			T(0.0),
+
+			m31*matrix.m11 + m32*matrix.m21 + m33*matrix.m31,
+			m31*matrix.m12 + m32*matrix.m22 + m33*matrix.m32,
+			m31*matrix.m13 + m32*matrix.m23 + m33*matrix.m33,
+			T(0.0),
+
+			m41*matrix.m11 + m42*matrix.m21 + m43*matrix.m31 + matrix.m41,
+			m41*matrix.m12 + m42*matrix.m22 + m43*matrix.m32 + matrix.m42,
+			m41*matrix.m13 + m42*matrix.m23 + m43*matrix.m33 + matrix.m43,
+			T(1.0)
+		));
+	}
+
+	template<typename T>
+	constexpr Vec4<T> Mat4<T>::GetColumn(std::size_t column) const
+	{
+		Assert(column < 4, "column index out of range");
+		const T* ptr = &m11 + column * 4;
+		return Vec4<T>(ptr[0], ptr[1], ptr[2], ptr[3]);
+	}
+
+	template<typename T>
+	constexpr T Mat4<T>::GetDeterminant() const
+	{
+		T A = m22*(m33*m44 - m43*m34) - m32*(m23*m44 - m43*m24) + m42*(m23*m34 - m33*m24);
+		T B = m12*(m33*m44 - m43*m34) - m32*(m13*m44 - m43*m14) + m42*(m13*m34 - m33*m14);
+		T C = m12*(m23*m44 - m43*m24) - m22*(m13*m44 - m43*m14) + m42*(m13*m24 - m23*m14);
+		T D = m12*(m23*m34 - m33*m24) - m22*(m13*m34 - m33*m14) + m32*(m13*m24 - m23*m14);
+
+		return m11*A - m21*B + m31*C - m41*D;
+	}
+
+	template<typename T>
+	constexpr T Mat4<T>::GetDeterminantTransform() const
+	{
+		T A = m22*m33 - m32*m23;
+		T B = m12*m33 - m32*m13;
+		T C = m12*m23 - m22*m13;
+
+		return m11*A - m21*B + m31*C;
+	}
+
+	template<typename T>
+	constexpr bool Mat4<T>::GetInverse(Mat4* dest) const
+	{
+		Assert(dest, "destination matrix must be valid");
+
+		T det = GetDeterminant();
+		if(det == T(0.0))
+			return false;
+
+		// http://stackoverflow.com/questions/1148309/inverting-a-4x4-matrix
+		T inv[16];
+		inv[0] = m22 * m33 * m44 -
+				 m22 * m34 * m43 -
+				 m32 * m23 * m44 +
+				 m32 * m24 * m43 +
+				 m42 * m23 * m34 -
+				 m42 * m24 * m33;
+
+		inv[1] = -m12 * m33 * m44 +
+				  m12 * m34 * m43 +
+				  m32 * m13 * m44 -
+				  m32 * m14 * m43 -
+				  m42 * m13 * m34 +
+				  m42 * m14 * m33;
+
+		inv[2] = m12 * m23 * m44 -
+				 m12 * m24 * m43 -
+				 m22 * m13 * m44 +
+				 m22 * m14 * m43 +
+				 m42 * m13 * m24 -
+				 m42 * m14 * m23;
+
+		inv[3] = -m12 * m23 * m34 +
+				  m12 * m24 * m33 +
+				  m22 * m13 * m34 -
+				  m22 * m14 * m33 -
+				  m32 * m13 * m24 +
+				  m32 * m14 * m23;
+
+		inv[4] = -m21 * m33 * m44 +
+				  m21 * m34 * m43 +
+				  m31 * m23 * m44 -
+				  m31 * m24 * m43 -
+				  m41 * m23 * m34 +
+				  m41 * m24 * m33;
+
+		inv[5] = m11 * m33 * m44 -
+				 m11 * m34 * m43 -
+				 m31 * m13 * m44 +
+				 m31 * m14 * m43 +
+				 m41 * m13 * m34 -
+				 m41 * m14 * m33;
+
+		inv[6] = -m11 * m23 * m44 +
+				  m11 * m24 * m43 +
+				  m21 * m13 * m44 -
+				  m21 * m14 * m43 -
+				  m41 * m13 * m24 +
+				  m41 * m14 * m23;
+
+		inv[7] = m11 * m23 * m34 -
+				 m11 * m24 * m33 -
+				 m21 * m13 * m34 +
+				 m21 * m14 * m33 +
+				 m31 * m13 * m24 -
+				 m31 * m14 * m23;
+
+		inv[8] = m21 * m32 * m44 -
+				 m21 * m34 * m42 -
+				 m31 * m22 * m44 +
+				 m31 * m24 * m42 +
+				 m41 * m22 * m34 -
+				 m41 * m24 * m32;
+
+		inv[9] = -m11 * m32 * m44 +
+				  m11 * m34 * m42 +
+				  m31 * m12 * m44 -
+				  m31 * m14 * m42 -
+				  m41 * m12 * m34 +
+				  m41 * m14 * m32;
+
+		inv[10] = m11 * m22 * m44 -
+				  m11 * m24 * m42 -
+				  m21 * m12 * m44 +
+				  m21 * m14 * m42 +
+				  m41 * m12 * m24 -
+				  m41 * m14 * m22;
+
+		inv[11] = -m11 * m22 * m34 +
+				   m11 * m24 * m32 +
+				   m21 * m12 * m34 -
+				   m21 * m14 * m32 -
+				   m31 * m12 * m24 +
+				   m31 * m14 * m22;
+
+		inv[12] = -m21 * m32 * m43 +
+				   m21 * m33 * m42 +
+				   m31 * m22 * m43 -
+				   m31 * m23 * m42 -
+				   m41 * m22 * m33 +
+				   m41 * m23 * m32;
+
+		inv[13] = m11 * m32 * m43 -
+				  m11 * m33 * m42 -
+				  m31 * m12 * m43 +
+				  m31 * m13 * m42 +
+				  m41 * m12 * m33 -
+				  m41 * m13 * m32;
+
+		inv[14] = -m11 * m22 * m43 +
+				   m11 * m23 * m42 +
+				   m21 * m12 * m43 -
+				   m21 * m13 * m42 -
+				   m41 * m12 * m23 +
+				   m41 * m13 * m22;
+
+		inv[15] = m11 * m22 * m33 -
+				  m11 * m23 * m32 -
+				  m21 * m12 * m33 +
+				  m21 * m13 * m32 +
+				  m31 * m12 * m23 -
+				  m31 * m13 * m22;
+
+		T invDet = T(1.0) / det;
+		for(unsigned int i = 0; i < 16; ++i)
+			inv[i] *= invDet;
+
+		*dest = inv;
+		return true;
+	}
+
+	template<typename T>
+	constexpr bool Mat4<T>::GetInverseTransform(Mat4* dest) const
+	{
+		Assert(dest, "destination matrix must be valid");
+
+		T det = GetDeterminantTransform();
+		if(det == T(0.0))
+			return false;
+
+
+		// http://stackoverflow.com/questions/1148309/inverting-a-4x4-matrix
+		T inv[16];
+		inv[0] = m22 * m33 - 
+				 m32 * m23;
+
+		inv[1] = -m12 * m33 +
+				  m32 * m13;
+
+		inv[2] = m12 * m23 -
+				m22 * m13;
+
+		inv[3] = T(0.0);
+
+		inv[4] = -m21 * m33 +
+				  m31 * m23;
+
+		inv[5] = m11 * m33 -
+				 m31 * m13;
+
+		inv[6] = -m11 * m23 +
+				  m21 * m13;
+
+		inv[7] = T(0.0);
+
+		inv[8] = m21 * m32 -
+				m31 * m22;
+
+		inv[9] = -m11 * m32 +
+				  m31 * m12;
+
+		inv[10] = m11 * m22 -
+				  m21 * m12;
+
+		inv[11] = T(0.0);
+
+		inv[12] = -m21 * m32 * m43 +
+				   m21 * m33 * m42 +
+				   m31 * m22 * m43 -
+				   m31 * m23 * m42 -
+				   m41 * m22 * m33 +
+				   m41 * m23 * m32;
+
+		inv[13] = m11 * m32 * m43 -
+				  m11 * m33 * m42 -
+				  m31 * m12 * m43 +
+				  m31 * m13 * m42 +
+				  m41 * m12 * m33 -
+				  m41 * m13 * m32;
+
+		inv[14] = -m11 * m22 * m43 +
+				   m11 * m23 * m42 +
+				   m21 * m12 * m43 -
+				   m21 * m13 * m42 -
+				   m41 * m12 * m23 +
+				   m41 * m13 * m22;
+
+		T invDet = T(1.0) / det;
+		for(unsigned int i = 0; i < 16; ++i)
+			inv[i] *= invDet;
+
+		inv[15] = T(1.0);
+
+		*dest = inv;
+		return true;
+	}
+
+	template<typename T>
+	Quat<T> Mat4<T>::GetRotation() const
+	{
+		// http://www.euclideanspace.com/maths/geometry/rotations/conversions/matrixToQuat/
+		Quat<T> quat;
+
+		T trace = m11 + m22 + m33;
+		if(trace > T(0.0))
+		{
+			T s = T(0.5) / std::sqrt(trace + T(1.0));
+			quat.w = T(0.25) / s;
+			quat.x = (m23 - m32) * s;
+			quat.y = (m31 - m13) * s;
+			quat.z = (m12 - m21) * s;
+		}
+		else
+		{
+			if(m11 > m22 && m11 > m33)
+			{
+				T s = T(2.0) * std::sqrt(T(1.0) + m11 - m22 - m33);
+
+				quat.w = (m23 - m32) / s;
+				quat.x = T(0.25) * s;
+				quat.y = (m21 + m12) / s;
+				quat.z = (m31 + m13) / s;
+			}
+			else if(m22 > m33)
+			{
+				T s = T(2.0) * std::sqrt(T(1.0) + m22 - m11 - m33);
+
+				quat.w = (m31 - m13) / s;
+				quat.x = (m21 + m12) / s;
+				quat.y = T(0.25) * s;
+				quat.z = (m32 + m23) / s;
+			}
+			else
+			{
+				T s = T(2.0) * std::sqrt(T(1.0) + m33 - m11 - m22);
+
+				quat.w = (m12 - m21) / s;
+				quat.x = (m31 + m13) / s;
+				quat.y = (m32 + m23) / s;
+				quat.z = T(0.25) * s;
+			}
+		}
+
+		return quat;
+	}
+
+	template<typename T>
+	constexpr Vec4<T> Mat4<T>::GetRow(std::size_t row) const
+	{
+		Assert(row < 4, "row index out of range");
+
+		const T* ptr = &m11;
+		return Vec4<T>(ptr[row], ptr[row+4], ptr[row+8], ptr[row+12]);
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Mat4<T>::GetScale() const
+	{
+		Vec3<T> squaredScale = GetSquaredScale();
+		return Vec3<T>(std::sqrt(squaredScale.x), std::sqrt(squaredScale.y), std::sqrt(squaredScale.z));
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Mat4<T>::GetSquaredScale() const
+	{
+		return Vec3<T>(m11 * m11 + m12 * m12 + m13 * m13,
+						m21 * m21 + m22 * m22 + m23 * m23,
+						m31 * m31 + m32 * m32 + m33 * m33);
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Mat4<T>::GetTranslation() const
+	{
+		return Vec3<T>(m41, m42, m43);
+	}
+
+	template<typename T>
+	constexpr void Mat4<T>::GetTransposed(Mat4* dest) const
+	{
+		(*dest) = Mat4f(
+			m11, m21, m31, m41,
+			m12, m22, m32, m42,
+			m13, m23, m33, m43,
+			m14, m24, m34, m44
+		);
+	}
+
+	template<typename T>
+	constexpr bool Mat4<T>::HasNegativeScale() const
+	{
+		return GetDeterminant() < T(0.0);
+	}
+
+	template<typename T>
+	constexpr bool Mat4<T>::HasScale() const
+	{
+		T t = m11*m11 + m21*m21 + m31*m31;
+		if(!NumberEquals(t, T(1.0)))
+			return true;
+
+		t = m12*m12 + m22*m22 + m32*m32;
+		if(!NumberEquals(t, T(1.0)))
+			return true;
+
+		t = m13*m13 + m23*m23 + m33*m33;
+		if(!NumberEquals(t, T(1.0)))
+			return true;
+
+		return false;
+	}
+
+	template<typename T>
+	constexpr Mat4<T>& Mat4<T>::Inverse(bool* succeeded)
+	{
+		bool result = GetInverse(this);
+		if(succeeded)
+			*succeeded = result;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Mat4<T>& Mat4<T>::InverseTransform(bool* succeeded)
+	{
+		bool result = GetInverseTransform(this);
+		if(succeeded)
+			*succeeded = result;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr bool Mat4<T>::IsTransformMatrix() const
+	{
+		return NumberEquals(m14, T(0.0)) && NumberEquals(m24, T(0.0)) && NumberEquals(m34, T(0.0)) && NumberEquals(m44, T(1.0));
+	}
+
+	template<typename T>
+	constexpr bool Mat4<T>::IsIdentity() const
+	{
+		return (NumberEquals(m11, T(1.0)) && NumberEquals(m12, T(0.0)) && NumberEquals(m13, T(0.0)) && NumberEquals(m14, T(0.0)) &&
+				NumberEquals(m21, T(0.0)) && NumberEquals(m22, T(1.0)) && NumberEquals(m23, T(0.0)) && NumberEquals(m24, T(0.0)) &&
+				NumberEquals(m31, T(0.0)) && NumberEquals(m32, T(0.0)) && NumberEquals(m33, T(1.0)) && NumberEquals(m34, T(0.0)) &&
+				NumberEquals(m41, T(0.0)) && NumberEquals(m42, T(0.0)) && NumberEquals(m43, T(0.0)) && NumberEquals(m44, T(1.0)));
+	}
+
+	template<typename T>
+	constexpr Mat4<T>& Mat4<T>::SetRotation(const Quat<T>& rotation)
+	{
+		T qw = rotation.w;
+		T qx = rotation.x;
+		T qy = rotation.y;
+		T qz = rotation.z;
+
+		T qx2 = qx * qx;
+		T qy2 = qy * qy;
+		T qz2 = qz * qz;
+
+		m11 = T(1.0) - T(2.0) * qy2 - T(2.0) * qz2;
+		m21 = T(2.0) * qx * qy - T(2.0) * qz * qw;
+		m31 = T(2.0) * qx * qz + T(2.0) * qy * qw;
+
+		m12 = T(2.0) * qx * qy + T(2.0) * qz * qw;
+		m22 = T(1.0) - T(2.0) * qx2 - T(2.0) * qz2;
+		m32 = T(2.0) * qy * qz - T(2.0) * qx * qw;
+
+		m13 = T(2.0) * qx * qz - T(2.0) * qy * qw;
+		m23 = T(2.0) * qy * qz + T(2.0) * qx * qw;
+		m33 = T(1.0) - T(2.0) * qx2 - T(2.0) * qy2;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Mat4<T>& Mat4<T>::SetScale(const Vec3<T>& scale)
+	{
+		m11 = scale.x;
+		m22 = scale.y;
+		m33 = scale.z;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Mat4<T>& Mat4<T>::SetTranslation(const Vec3<T>& translation)
+	{
+		m41 = translation.x;
+		m42 = translation.y;
+		m43 = translation.z;
+
+		return *this;
+	}
+
+	template<typename T>
+	std::string Mat4<T>::ToString() const
+	{
+		std::ostringstream ss;
+		ss << *this;
+
+		return ss.str();
+	}
+
+	template<typename T>
+	constexpr Vec2<T> Mat4<T>::Transform(const Vec2<T>& vector, T z, T w) const
+	{
+		return Vec2<T>(m11 * vector.x + m21 * vector.y + m31 * z + m41 * w,
+						m12 * vector.x + m22 * vector.y + m32 * z + m42 * w);
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Mat4<T>::Transform(const Vec3<T>& vector, T w) const
+	{
+		return Vec3<T>(m11 * vector.x + m21 * vector.y + m31 * vector.z + m41 * w,
+						m12 * vector.x + m22 * vector.y + m32 * vector.z + m42 * w,
+						m13 * vector.x + m23 * vector.y + m33 * vector.z + m43 * w);
+	}
+
+	template<typename T>
+	constexpr Vec4<T> Mat4<T>::Transform(const Vec4<T>& vector) const
+	{
+		return Vec4<T>(m11 * vector.x + m21 * vector.y + m31 * vector.z + m41 * vector.w,
+						m12 * vector.x + m22 * vector.y + m32 * vector.z + m42 * vector.w,
+						m13 * vector.x + m23 * vector.y + m33 * vector.z + m43 * vector.w,
+						m14 * vector.x + m24 * vector.y + m34 * vector.z + m44 * vector.w);
+	}
+
+	template<typename T>
+	constexpr Mat4<T>& Mat4<T>::Transpose()
+	{
+		std::swap(m12, m21);
+		std::swap(m13, m31);
+		std::swap(m14, m41);
+		std::swap(m23, m32);
+		std::swap(m24, m42);
+		std::swap(m34, m43);
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr T& Mat4<T>::operator()(std::size_t x, std::size_t y)
+	{
+		Assert(x <= 3, "index out of range");
+		Assert(y <= 3, "index out of range");
+
+		return (&m11)[y*4 + x];
+	}
+
+	template<typename T>
+	constexpr const T& Mat4<T>::operator()(std::size_t x, std::size_t y) const
+	{
+		Assert(x <= 3, "index out of range");
+		Assert(y <= 3, "index out of range");
+
+		return (&m11)[y*4+x];
+	}
+
+	template<typename T>
+	constexpr T& Mat4<T>::operator[](std::size_t i)
+	{
+		Assert(i <= 16, "index out of range");
+
+		return (&m11)[i];
+	}
+
+	template<typename T>
+	constexpr const T& Mat4<T>::operator[](std::size_t i) const
+	{
+		Assert(i <= 16, "index out of range");
+
+		return (&m11)[i];
+	}
+
+	template<typename T>
+	constexpr Mat4<T> Mat4<T>::operator*(const Mat4& matrix) const
+	{
+		Mat4 result(*this);
+		return result.Concatenate(matrix);
+	}
+
+	template<typename T>
+	constexpr Vec2<T> Mat4<T>::operator*(const Vec2<T>& vector) const
+	{
+		return Transform(vector);
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Mat4<T>::operator*(const Vec3<T>& vector) const
+	{
+		return Transform(vector);
+	}
+
+	template<typename T>
+	constexpr Vec4<T> Mat4<T>::operator*(const Vec4<T>& vector) const
+	{
+		return Transform(vector);
+	}
+
+	template<typename T>
+	constexpr Mat4<T> Mat4<T>::operator*(T scalar) const
+	{
+		Mat4 mat;
+		for(unsigned int i = 0; i < 16; ++i)
+			mat[i] = (&m11)[i] * scalar;
+
+		return mat;
+	}
+
+	template<typename T>
+	constexpr Mat4<T>& Mat4<T>::operator*=(const Mat4& matrix)
+	{
+		Concatenate(matrix);
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Mat4<T>& Mat4<T>::operator*=(T scalar)
+	{
+		for(unsigned int i = 0; i < 16; ++i)
+			(&m11)[i] *= scalar;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr bool Mat4<T>::operator==(const Mat4& mat) const
+	{
+		for(unsigned int i = 0; i < 16; ++i)
+			if((&m11)[i] != (&mat.m11)[i])
+				return false;
+
+		return true;
+	}
+
+	template<typename T>
+	constexpr bool Mat4<T>::operator!=(const Mat4& mat) const
+	{
+		return !operator==(mat);
+	}
+
+	template<typename T>
+	constexpr bool Mat4<T>::ApproxEqual(const Mat4& lhs, const Mat4& rhs, T maxDifference)
+	{
+		return lhs.ApproxEqual(rhs, maxDifference);
+	}
+
+	template<typename T>
+	constexpr Mat4<T> Mat4<T>::Concatenate(const Mat4& left, const Mat4& right)
+	{
+		Mat4 matrix(left); // Copy of left-hand side matrix
+		matrix.Concatenate(right); // Concatenation with right-hand side
+
+		return matrix;
+	}
+
+	template<typename T>
+	constexpr Mat4<T> Mat4<T>::ConcatenateTransform(const Mat4& left, const Mat4& right)
+	{
+		Mat4 matrix(left); // Copy of left-hand side matrix
+		matrix.ConcatenateTransform(right); // Affine concatenation with right-hand side
+
+		return matrix;
+	}
+
+	template<typename T>
+	constexpr Mat4<T> Mat4<T>::Identity()
+	{
+		return Mat4(
+			T(1.0), T(0.0), T(0.0), T(0.0),
+			T(0.0), T(1.0), T(0.0), T(0.0),
+			T(0.0), T(0.0), T(1.0), T(0.0),
+			T(0.0), T(0.0), T(0.0), T(1.0)
+		);
+	}
+
+	template<typename T>
+	constexpr Mat4<T> Mat4<T>::LookAt(const Vec3<T>& eye, const Vec3<T>& target, const Vec3<T>& up)
+	{
+		Vec3<T> f = Vec3<T>::Normalize(target - eye);
+		Vec3<T> s = Vec3<T>::Normalize(f.CrossProduct(up));
+		Vec3<T> u = s.CrossProduct(f);
+
+		return Mat4(
+			s.x, u.x, -f.x, T(0.0),
+			s.y, u.y, -f.y, T(0.0),
+			s.z, u.z, -f.z, T(0.0),
+			-s.DotProduct(eye), -u.DotProduct(eye), f.DotProduct(eye), T(1.0)
+		);
+	}
+
+	template<typename T>
+	constexpr Mat4<T> Mat4<T>::Ortho(T left, T right, T top, T bottom, T zNear, T zFar)
+	{
+		// http://msdn.microsoft.com/en-us/library/windows/desktop/bb204942(v=vs.85).aspx
+		return Mat4(
+			T(2.0) / (right - left),         T(0.0),                          T(0.0),                  T(0.0),
+			T(0.0),                          T(2.0) / (top - bottom),         T(0.0),                  T(0.0),
+			T(0.0),                          T(0.0),                          T(1.0) / (zNear - zFar), T(0.0),
+			(left + right) / (left - right), (top + bottom) / (bottom - top), zNear / (zNear - zFar),  T(1.0)
+		);
+	}
+
+	template<typename T>
+	Mat4<T> Mat4<T>::Perspective(RadianAngle<T> angle, T ratio, T zNear, T zFar)
+	{
+		angle /= T(2.0);
+
+		T yScale = angle.GetTan();
+
+		return Mat4(
+			T(1.0) / (ratio * yScale), T(0.0),             T(0.0),                          T(0.0),
+			T(0.0),                    T(-1.0) / (yScale), T(0.0),                          T(0.0),
+			T(0.0),                    T(0.0),             zFar / (zNear - zFar),           T(-1.0),
+			T(0.0),                    T(0.0),            -(zNear * zFar) / (zFar - zNear), T(0.0)
+		);
+	}
+
+	template<typename T>
+	constexpr Mat4<T> Mat4<T>::Rotate(const Quat<T>& rotation)
+	{
+		Mat4 matrix = Mat4::Identity();
+		matrix.SetRotation(rotation);
+
+		return matrix;
+	}
+
+	template<typename T>
+	constexpr Mat4<T> Mat4<T>::Scale(const Vec3<T>& scale)
+	{
+		return Mat4(
+			scale.x, T(0.0),  T(0.0),  T(0.0),
+			T(0.0),  scale.y, T(0.0),  T(0.0),
+			T(0.0),  T(0.0),  scale.z, T(0.0),
+			T(0.0),  T(0.0),  T(0.0),  T(1.0)
+		);
+	}
+
+	template<typename T>
+	constexpr Mat4<T> Mat4<T>::Translate(const Vec3<T>& translation)
+	{
+		return Mat4(
+			T(1.0), T(0.0), T(0.0), T(0.0),
+			T(0.0), T(1.0), T(0.0), T(0.0),
+			T(0.0), T(0.0), T(1.0), T(0.0),
+			translation.x, translation.y, translation.z, T(1.0)
+		);
+	}
+
+	template<typename T>
+	constexpr Mat4<T> Mat4<T>::Transform(const Vec3<T>& translation, const Quat<T>& rotation)
+	{
+		Mat4 mat = Mat4f::Identity();
+		mat.SetRotation(rotation);
+		mat.SetTranslation(translation);
+
+		return mat;
+	}
+
+	template<typename T>
+	constexpr Mat4<T> Mat4<T>::Transform(const Vec3<T>& translation, const Quat<T>& rotation, const Vec3<T>& scale)
+	{
+		Mat4 mat = Transform(translation, rotation);
+		mat.ApplyScale(scale);
+
+		return mat;
+	}
+
+	template<typename T>
+	constexpr Mat4<T> Mat4<T>::TransformInverse(const Vec3<T>& translation, const Quat<T>& rotation)
+	{
+		// A view matrix must apply an inverse transformation of the 'world' matrix
+		Quat<T> invRot = rotation.GetConjugate(); // Inverse of the rotation
+
+		return Transform(-(invRot * translation), invRot);
+	}
+
+	template<typename T>
+	constexpr Mat4<T> Mat4<T>::TransformInverse(const Vec3<T>& translation, const Quat<T>& rotation, const Vec3<T>& scale)
+	{
+		return TransformInverse(translation, rotation).ApplyScale(T(1.0) / scale);
+	}
+
+	template<typename T>
+	constexpr Mat4<T> Mat4<T>::Zero()
+	{
+		return Mat4(
+			T(0.0), T(0.0), T(0.0), T(0.0),
+			T(0.0), T(0.0), T(0.0), T(0.0),
+			T(0.0), T(0.0), T(0.0), T(0.0),
+			T(0.0), T(0.0), T(0.0), T(0.0)
+		);
+	}
+
+	template<typename T>
+	std::ostream& operator<<(std::ostream& out, const Mat4<T>& matrix)
+	{
+		return out << "Mat4(" << matrix.m11 << ", " << matrix.m12 << ", " << matrix.m13 << ", " << matrix.m14 << ",\n"
+			<< "        " <<        matrix.m21 << ", " << matrix.m22 << ", " << matrix.m23 << ", " << matrix.m24 << ",\n"
+			<< "        " <<        matrix.m31 << ", " << matrix.m32 << ", " << matrix.m33 << ", " << matrix.m34 << ",\n"
+			<< "        " <<        matrix.m41 << ", " << matrix.m42 << ", " << matrix.m43 << ", " << matrix.m44 << ')';
+	}
+
+	template<typename T>
+	constexpr Mat4<T> operator*(T scale, const Mat4<T>& matrix)
+	{
+		return matrix * scale;
+	}
+}

runtime/Includes/Maths/MathsUtils.h

@@ -0,0 +1,24 @@
+#ifndef __MLX_MATHS_UTILS__
+#define __MLX_MATHS_UTILS__
+
+namespace mlx
+{
+	template<typename T>
+	[[nodiscard]] constexpr T Mod(T x, T y) noexcept;
+
+	template<std::floating_point T>
+	[[nodiscard]] constexpr T DegreeToRadian(T degrees) noexcept;
+	
+	template<std::floating_point T>
+	[[nodiscard]] constexpr T RadianToDegree(T radians) noexcept;
+
+	template<typename T>
+	[[nodiscard]] constexpr T Clamp(T value, T min, T max) noexcept;
+	
+	template<typename T, typename T2>
+	[[nodiscard]] constexpr T Lerp(const T& from, const T& to, const T2& interpolation) noexcept;
+}
+
+#include <Maths/MathsUtils.inl>
+
+#endif

runtime/Includes/Maths/MathsUtils.inl

@@ -0,0 +1,44 @@
+#pragma once
+#include <Maths/MathsUtils.h>
+
+#include <Maths/Constants.h>
+
+namespace mlx
+{
+	template<typename T>
+	[[nodiscard]] constexpr T Mod(T x, T y) noexcept
+	{
+		if constexpr(std::is_floating_point_v<T>)
+		{
+			if(!std::is_constant_evaluated())
+				return x - static_cast<long long>(x / y) * y;
+			else
+				return std::fmod(x, y);
+		}
+		return x % y;
+	}
+
+	template<std::floating_point T>
+	[[nodiscard]] constexpr T DegreeToRadian(T degrees) noexcept
+	{
+		return degrees * (Pi<T>() / T(180.0));
+	}
+
+	template<std::floating_point T>
+	[[nodiscard]] constexpr T RadianToDegree(T radians) noexcept
+	{
+		return radians * (T(180.0) / Pi<T>());
+	}
+
+	template<typename T>
+	[[nodiscard]] constexpr T Clamp(T value, T min, T max) noexcept
+	{
+		return std::max(std::min(value, max), min);
+	}
+
+	template<typename T, typename T2>
+	[[nodiscard]] constexpr T Lerp(const T& from, const T& to, const T2& interpolation) noexcept
+	{
+		return static_cast<T>(from + interpolation * (to - from));
+	}
+}

runtime/Includes/Maths/Quaternions.h

@@ -0,0 +1,92 @@
+#ifndef __MLX_QUATERNIONS__
+#define __MLX_QUATERNIONS__
+
+#include <Maths/Angles.h>
+#include <Maths/Vec3.h>
+
+namespace mlx
+{
+	template<typename T>
+	struct Quat
+	{
+		T w, x, y, z;
+
+		constexpr Quat() = default;
+		constexpr Quat(T W, T X, T Y, T Z);
+		template<AngleUnit Unit> Quat(const Angle<Unit, T>& angle);
+		Quat(const EulerAngles<T>& angles);
+		constexpr Quat(RadianAngle<T> angle, const Vec3<T>& axis);
+		constexpr Quat(const T quat[4]);
+		template<typename U> constexpr explicit Quat(const Quat<U>& quat);
+		constexpr Quat(const Quat&) = default;
+		constexpr Quat(Quat&&) = default;
+
+		RadianAngle<T> AngleBetween(const Quat& vec) const;
+		constexpr bool ApproxEqual(const Quat& quat, T max_difference = std::numeric_limits<T>::epsilon()) const;
+
+		Quat& ComputeW();
+		constexpr Quat& Conjugate();
+
+		constexpr T DotProduct(const Quat& vec) const;
+
+		constexpr Quat GetConjugate() const;
+		Quat GetInverse() const;
+		Quat GetNormal(T* length = nullptr) const;
+
+		Quat& Inverse();
+
+		T Magnitude() const;
+
+		Quat& Normalize(T* length = nullptr);
+
+		constexpr T SquaredMagnitude() const;
+
+		RadianAngle<T> To2DAngle() const;
+		EulerAngles<T> ToEulerAngles() const;
+		std::string ToString() const;
+
+		constexpr Quat& operator=(const Quat& quat) = default;
+		constexpr Quat& operator=(Quat&&) = default;
+
+		constexpr Quat operator+(const Quat& quat) const;
+		constexpr Quat operator*(const Quat& quat) const;
+		constexpr Vec3<T> operator*(const Vec3<T>& vec) const;
+		constexpr Quat operator*(T scale) const;
+		constexpr Quat operator/(const Quat& quat) const;
+
+		constexpr Quat& operator+=(const Quat& quat);
+		constexpr Quat& operator*=(const Quat& quat);
+		constexpr Quat& operator*=(T scale);
+		constexpr Quat& operator/=(const Quat& quat);
+
+		constexpr bool operator==(const Quat& quat) const;
+		constexpr bool operator!=(const Quat& quat) const;
+		constexpr bool operator<(const Quat& quat) const;
+		constexpr bool operator<=(const Quat& quat) const;
+		constexpr bool operator>(const Quat& quat) const;
+		constexpr bool operator>=(const Quat& quat) const;
+
+		static RadianAngle<T> AngleBetween(const Quat& lhs, const Quat& rhs);
+		static constexpr bool ApproxEqual(const Quat& lhs, const Quat& rhs, T max_difference = std::numeric_limits<T>::epsilon());
+		static constexpr Quat Identity();
+		static constexpr Quat Lerp(const Quat& from, const Quat& to, T interpolation);
+		static Quat LookAt(const Vec3<T>& forward, const Vec3<T>& up);
+		static Quat Normalize(const Quat& quat, T* length = nullptr);
+		static Quat RotationBetween(const Vec3<T>& from, const Vec3<T>& to);
+		static Quat RotateTowards(const Quat& from, const Quat& to, RadianAngle<T> max_rotation);
+		static Quat Mirror(Quat quat, const Vec3<T>& axis);
+		static Quat Slerp(const Quat& from, const Quat& to, T interpolation);
+		static constexpr Quat Zero();
+
+		~Quat() = default;
+	};
+
+	using Quatd = Quat<double>;
+	using Quatf = Quat<float>;
+
+	template<typename T> std::ostream& operator<<(std::ostream& out, const Quat<T>& quat);
+}
+
+#include <Maths/Quaternions.inl>
+
+#endif

runtime/Includes/Maths/Quaternions.inl

@@ -0,0 +1,508 @@
+#pragma once
+#include <Maths/Quaternions.h>
+
+namespace mlx
+{
+	template<typename T>
+	constexpr Quat<T>::Quat(T W, T X, T Y, T Z) : w(W), x(X), y(Y), z(Z)
+	{}
+
+	template<typename T>
+	template<AngleUnit Unit>
+	Quat<T>::Quat(const Angle<Unit, T>& angle) : Quat(angle.ToQuat())
+	{}
+
+	template<typename T>
+	Quat<T>::Quat(const EulerAngles<T>& angles) : Quat(angles.ToQuat())
+	{}
+
+	template<typename T>
+	constexpr Quat<T>::Quat(RadianAngle<T> angle, const Vec3<T>& axis)
+	{
+		angle /= T(2.0);
+
+		Vec3<T> normalizedAxis = axis.GetNormal();
+
+		auto sincos = angle.GetSinCos();
+
+		w = sincos.second;
+		x = normalizedAxis.x * sincos.first;
+		y = normalizedAxis.y * sincos.first;
+		z = normalizedAxis.z * sincos.first;
+
+		Normalize();
+	}
+
+	template<typename T>
+	constexpr Quat<T>::Quat(const T quat[4]) : w(quat[0]), x(quat[1]), y(quat[2]), z(quat[3])
+	{}
+
+	template<typename T>
+	template<typename U>
+	constexpr Quat<T>::Quat(const Quat<U>& quat) : w(static_cast<T>(quat.w)), x(static_cast<T>(quat.x)), y(static_cast<T>(quat.y)), z(static_cast<T>(quat.z))
+	{}
+
+	template<typename T>
+	RadianAngle<T> Quat<T>::AngleBetween(const Quat& quat) const
+	{
+		T alpha = Vec3<T>::DotProduct(Vec3<T>(x, y, z), Vec3<T>(quat.x, quat.y, quat.z));
+		return std::acos(mlx::Clamp(alpha, T(-1.0), T(1.0)));
+	}
+
+	template<typename T>
+	constexpr bool Quat<T>::ApproxEqual(const Quat& quat, T maxDifference) const
+	{
+		return NumberEquals(w, quat.w, maxDifference) &&
+				NumberEquals(x, quat.x, maxDifference) &&
+				NumberEquals(y, quat.y, maxDifference) &&
+				NumberEquals(z, quat.z, maxDifference);
+	}
+
+	template<typename T>
+	Quat<T>& Quat<T>::ComputeW()
+	{
+		T t = T(1.0) - SquaredMagnitude();
+
+		if(t < T(0.0))
+			w = T(0.0);
+		else
+			w = -std::sqrt(t);
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Quat<T>& Quat<T>::Conjugate()
+	{
+		x = -x;
+		y = -y;
+		z = -z;
+		return *this;
+	}
+
+	template<typename T>
+	constexpr T Quat<T>::DotProduct(const Quat& quat) const
+	{
+		return w * quat.w + x * quat.x + y * quat.y + z * quat.z;
+	}
+
+	template<typename T>
+	constexpr Quat<T> Quat<T>::GetConjugate() const
+	{
+		Quat<T> quat(*this);
+		quat.Conjugate();
+		return quat;
+	}
+
+	template<typename T>
+	Quat<T> Quat<T>::GetInverse() const
+	{
+		Quat<T> quat(*this);
+		quat.Inverse();
+		return quat;
+	}
+
+	template<typename T>
+	Quat<T> Quat<T>::GetNormal(T* length) const
+	{
+		Quat<T> quat(*this);
+		quat.Normalize(length);
+		return quat;
+	}
+
+	template<typename T>
+	Quat<T>& Quat<T>::Inverse()
+	{
+		T norm = SquaredMagnitude();
+		if(norm > T(0.0))
+		{
+			T invNorm = T(1.0) / std::sqrt(norm);
+
+			w *= invNorm;
+			x *= -invNorm;
+			y *= -invNorm;
+			z *= -invNorm;
+		}
+
+		return *this;
+	}
+
+	template<typename T>
+	T Quat<T>::Magnitude() const
+	{
+		return std::sqrt(SquaredMagnitude());
+	}
+
+	template<typename T>
+	Quat<T>& Quat<T>::Normalize(T* length)
+	{
+		T norm = std::sqrt(SquaredMagnitude());
+		if(norm > T(0.0))
+		{
+			T invNorm = T(1.0) / norm;
+			w *= invNorm;
+			x *= invNorm;
+			y *= invNorm;
+			z *= invNorm;
+		}
+
+		if(length)
+			*length = norm;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr T Quat<T>::SquaredMagnitude() const
+	{
+		return w * w + x * x + y * y + z * z;
+	}
+
+	template<typename T>
+	RadianAngle<T> Quat<T>::To2DAngle() const
+	{
+		T siny_cosp = T(2.0) * (w * z + x * y);
+		T cosy_cosp = T(1.0) - T(2.0) * (y * y + z * z);
+
+		return std::atan2(siny_cosp, cosy_cosp);
+	}
+
+	template<typename T>
+	EulerAngles<T> Quat<T>::ToEulerAngles() const
+	{
+		T test = x * y + z * w;
+		if(test > T(0.499))
+			// singularity at north pole
+			return EulerAngles<T>(DegreeAngle<T>(T(0.0)), RadianAngle<T>(T(2.0) * std::atan2(x, w)), DegreeAngle<T>(T(90.0)));
+
+		if(test < T(-0.499))
+			// singularity at south pole
+			return EulerAngles<T>(DegreeAngle<T>(T(0.0)), RadianAngle<T>(T(-2.0) * std::atan2(x, w)), DegreeAngle<T>(T(-90.0)));
+
+		return EulerAngles<T>(RadianAngle<T>(std::atan2(T(2.0) * x * w - T(2.0) * y * z, T(1.0) - T(2.0) * x * x - T(2.0) * z * z)),
+								RadianAngle<T>(std::atan2(T(2.0) * y * w - T(2.0) * x * z, T(1.0) - T(2.0) * y * y - T(2.0) * z * z)),
+								RadianAngle<T>(std::asin(T(2.0) * test)));
+	}
+
+	template<typename T>
+	std::string Quat<T>::ToString() const
+	{
+		std::ostringstream ss;
+		ss << *this;
+
+		return ss.str();
+	}
+
+	template<typename T>
+	constexpr Quat<T> Quat<T>::operator+(const Quat& quat) const
+	{
+		Quat result;
+		result.w = w + quat.w;
+		result.x = x + quat.x;
+		result.y = y + quat.y;
+		result.z = z + quat.z;
+
+		return result;
+	}
+
+	template<typename T>
+	constexpr Quat<T> Quat<T>::operator*(const Quat& quat) const
+	{
+		Quat result;
+		result.w = w * quat.w - x * quat.x - y * quat.y - z * quat.z;
+		result.x = w * quat.x + x * quat.w + y * quat.z - z * quat.y;
+		result.y = w * quat.y + y * quat.w + z * quat.x - x * quat.z;
+		result.z = w * quat.z + z * quat.w + x * quat.y - y * quat.x;
+
+		return result;
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Quat<T>::operator*(const Vec3<T>& vec) const
+	{
+		Vec3<T> quatVec(x, y, z);
+		Vec3<T> uv = quatVec.CrossProduct(vec);
+		Vec3<T> uuv = quatVec.CrossProduct(uv);
+		uv *= T(2.0) * w;
+		uuv *= T(2.0);
+
+		return vec + uv + uuv;
+	}
+
+	template<typename T>
+	constexpr Quat<T> Quat<T>::operator*(T scale) const
+	{
+		return Quat(w * scale,
+					x * scale,
+					y * scale,
+					z * scale);
+	}
+
+	template<typename T>
+	constexpr Quat<T> Quat<T>::operator/(const Quat& quat) const
+	{
+		return quat.GetConjugate() * (*this);
+	}
+
+	template<typename T>
+	constexpr Quat<T>& Quat<T>::operator+=(const Quat& quat)
+	{
+		return operator=(operator+(quat));
+	}
+
+	template<typename T>
+	constexpr Quat<T>& Quat<T>::operator*=(const Quat& quat)
+	{
+		return operator=(operator*(quat));
+	}
+
+	template<typename T>
+	constexpr Quat<T>& Quat<T>::operator*=(T scale)
+	{
+		return operator=(operator*(scale));
+	}
+
+	template<typename T>
+	constexpr Quat<T>& Quat<T>::operator/=(const Quat& quat)
+	{
+		return operator=(operator/(quat));
+	}
+	
+	template<typename T>
+	constexpr bool Quat<T>::operator==(const Quat& quat) const
+	{
+		return w == quat.w && x == quat.x && y == quat.y && z == quat.z;
+	}
+
+	template<typename T>
+	constexpr bool Quat<T>::operator!=(const Quat& quat) const
+	{
+		return !operator==(quat);
+	}
+
+	template<typename T>
+	constexpr bool Quat<T>::operator<(const Quat& quat) const
+	{
+		if(w != quat.w)
+			return w < quat.w;
+
+		if(x != quat.x)
+			return x < quat.x;
+
+		if(y != quat.y)
+			return y < quat.y;
+
+		if(z != quat.z)
+			return z < quat.z;
+	}
+
+	template<typename T>
+	constexpr bool Quat<T>::operator<=(const Quat& quat) const
+	{
+		if(w != quat.w)
+			return w < quat.w;
+
+		if(x != quat.x)
+			return x < quat.x;
+
+		if(y != quat.y)
+			return y < quat.y;
+
+		if(z != quat.z)
+			return z <= quat.z;
+	}
+
+	template<typename T>
+	constexpr bool Quat<T>::operator>(const Quat& quat) const
+	{
+		if(w != quat.w)
+			return w > quat.w;
+
+		if(x != quat.x)
+			return x > quat.x;
+
+		if(y != quat.y)
+			return y > quat.y;
+
+		if(z != quat.z)
+			return z > quat.z;
+	}
+
+	template<typename T>
+	constexpr bool Quat<T>::operator>=(const Quat& quat) const
+	{
+		if(w != quat.w)
+			return w > quat.w;
+
+		if(x != quat.x)
+			return x > quat.x;
+
+		if(y != quat.y)
+			return y > quat.y;
+
+		if(z != quat.z)
+			return z >= quat.z;
+	}
+
+	template<typename T>
+	RadianAngle<T> Quat<T>::AngleBetween(const Quat& lhs, const Quat& rhs)
+	{
+		return lhs.AngleBetween(rhs);
+	}
+
+	template<typename T>
+	constexpr bool Quat<T>::ApproxEqual(const Quat& lhs, const Quat& rhs, T maxDifference)
+	{
+		return lhs.ApproxEqual(rhs, maxDifference);
+	}
+
+	template<typename T>
+	constexpr Quat<T> Quat<T>::Identity()
+	{
+		return Quat(1, 0, 0, 0);
+	}
+
+	template<typename T>
+	constexpr Quat<T> Quat<T>::Lerp(const Quat& from, const Quat& to, T interpolation)
+	{
+		Quat interpolated;
+		interpolated.w = mlx::Lerp(from.w, to.w, interpolation);
+		interpolated.x = mlx::Lerp(from.x, to.x, interpolation);
+		interpolated.y = mlx::Lerp(from.y, to.y, interpolation);
+		interpolated.z = mlx::Lerp(from.z, to.z, interpolation);
+
+		return interpolated;
+	}
+
+	template<typename T>
+	Quat<T> Quat<T>::LookAt(const Vec3<T>& forward, const Vec3<T>& up)
+	{
+		// From https://gamedev.stackexchange.com/questions/53129/quaternion-look-at-with-up-vector
+		Vec3<T> forward_w = Vec3<T>::Forward();
+		Vec3<T> axis = Vec3<T>::CrossProduct(forward, forward_w);
+		RadianAngle<T> angle = std::acos(Vec3<T>::DotProduct(forward, forward_w));
+
+		Vec3<T> third = Vec3<T>::CrossProduct(axis, forward_w);
+		if(Vec3<T>::DotProduct(third, forward) < 0)
+			angle = -angle;
+
+		Quat<T> q1 = Quat(angle, axis);
+
+		Vec3<T> up_l = q1 * up;
+		Vec3<T> right = Vec3<T>::Normalize(Vec3<T>::CrossProduct(forward, up));
+		Vec3<T> up_w = Vec3<T>::Normalize(Vec3<T>::CrossProduct(right, forward));
+
+		Vec3<T> axis2 = Vec3<T>::CrossProduct(up_l, up_w);
+		RadianAngle<T> angle2 = std::acos(Vec3<T>::DotProduct(forward, forward_w));
+
+		Quat<T> q2 = Quat(angle2, axis2);
+
+		return q2 * q1;
+	}
+
+	template<typename T>
+	Quat<T> Quat<T>::Normalize(const Quat& quat, T* length)
+	{
+		return quat.GetNormal(length);
+	}
+
+	template<typename T>
+	Quat<T> Quat<T>::RotationBetween(const Vec3<T>& from, const Vec3<T>& to)
+	{
+		T dot = from.DotProduct(to);
+		if(dot < T(-0.999999))
+		{
+			Vec3<T> crossProduct;
+			if(from.DotProduct(Vec3<T>::UnitX()) < T(0.999999))
+				crossProduct = Vec3<T>::UnitX().CrossProduct(from);
+			else
+				crossProduct = Vec3<T>::UnitY().CrossProduct(from);
+
+			crossProduct.Normalize();
+			return Quat(Pi<T>(), crossProduct);
+		}
+		else if(dot > T(0.999999))
+			return Quat::Identity();
+		else
+		{
+			T norm = std::sqrt(from.GetSquaredLength() * to.GetSquaredLength());
+			Vec3<T> crossProduct = from.CrossProduct(to);
+
+			return Quat(norm + dot, crossProduct.x, crossProduct.y, crossProduct.z).GetNormal();
+		}
+	}
+
+	template<typename T>
+	Quat<T> Quat<T>::RotateTowards(const Quat& from, const Quat& to, RadianAngle<T> maxRotation)
+	{
+		RadianAngle<T> rotationBetween = AngleBetween(from, to);
+		if(rotationBetween < maxRotation)
+			return to;
+
+		return Slerp(from, to, std::min(maxRotation.value / rotationBetween.value), 1.f);
+	}
+
+	template<typename T>
+	Quat<T> Quat<T>::Mirror(Quat quat, const Vec3<T>& axis)
+	{
+		T x = std::copysign(T(1.0), axis.x);
+		T y = std::copysign(T(1.0), axis.y);
+		T z = std::copysign(T(1.0), axis.z);
+
+		quat.x = y * z * quat.x;
+		quat.y = x * z * quat.y;
+		quat.z = x * y * quat.z;
+
+		return quat;
+	}
+
+	template<typename T>
+	Quat<T> Quat<T>::Slerp(const Quat& from, const Quat& to, T interpolation)
+	{
+		Quat q;
+
+		T cosOmega = from.DotProduct(to);
+		if(cosOmega < T(0.0))
+		{
+			// We invert everything
+			q = Quat(-to.w, -to.x, -to.y, -to.z);
+			cosOmega = -cosOmega;
+		}
+		else
+			q = Quat(to);
+
+		T k0, k1;
+		if(cosOmega > T(0.9999))
+		{
+			// Linear interpolation to avoid division by zero
+			k0 = T(1.0) - interpolation;
+			k1 = interpolation;
+		}
+		else
+		{
+			T sinOmega = std::sqrt(T(1.0) - cosOmega*cosOmega);
+			T omega = std::atan2(sinOmega, cosOmega);
+
+			// To avoid two divisions
+			sinOmega = T(1.0)/sinOmega;
+
+			k0 = std::sin((T(1.0) - interpolation) * omega) * sinOmega;
+			k1 = std::sin(interpolation*omega) * sinOmega;
+		}
+
+		Quat result(k0 * from.w, k0 * from.x, k0 * from.y, k0 * from.z);
+		return result += q * k1;
+	}
+
+	template<typename T>
+	constexpr Quat<T> Quat<T>::Zero()
+	{
+		return Quat(0, 0, 0, 0);
+	}
+
+	template<typename T>
+	std::ostream& operator<<(std::ostream& out, const Quat<T>& quat)
+	{
+		return out << "Quat(" << quat.w << " | " << quat.x << ", " << quat.y << ", " << quat.z << ')';
+	}
+}

runtime/Includes/Maths/Readme.md

@@ -0,0 +1 @@
+Highly inspired by [Nazara Maths library](https://github.com/NazaraEngine/NazaraEngine/tree/main/include/Nazara/Math)

runtime/Includes/Maths/Vec2.h

@@ -0,0 +1,109 @@
+#ifndef __MLX_VEC2__
+#define __MLX_VEC2__
+
+namespace mlx
+{
+	template <typename T> struct Vec3;
+	template <typename T> struct Vec4;
+
+	template <typename T>
+	struct Vec2
+	{
+		union { T x, r, s; };
+		union { T y, g, t; };
+
+		constexpr Vec2() = default;
+		constexpr Vec2(T X, T Y);
+		constexpr explicit Vec2(T scale);
+		template<typename U> constexpr explicit Vec2(const Vec2<U>& vec);
+		constexpr Vec2(const Vec2&) = default;
+		constexpr Vec2(Vec2&&) = default;
+		constexpr explicit Vec2(const Vec3<T>& vec);
+		constexpr explicit Vec2(const Vec4<T>& vec);
+
+		T AbsDotProduct(const Vec2& vec) const;
+		constexpr bool ApproxEqual(const Vec2& vec, T max_difference = std::numeric_limits<T>::epsilon()) const;
+
+		template<typename U = T> U Distance(const Vec2& vec) const;
+		constexpr T DotProduct(const Vec2& vec) const;
+
+		template<typename U = T> T GetLength() const;
+		Vec2 GetNormal(T* length = nullptr) const;
+		constexpr T GetSquaredLength() const;
+
+		constexpr Vec2& Maximize(const Vec2& vec);
+		constexpr Vec2& Minimize(const Vec2& vec);
+
+		Vec2& Normalize(T* length = nullptr);
+
+		constexpr T SquaredDistance(const Vec2& vec) const;
+
+		std::string ToString() const;
+
+		constexpr T& operator[](std::size_t i);
+		constexpr T operator[](std::size_t i) const;
+
+		constexpr const Vec2& operator+() const;
+		constexpr Vec2 operator-() const;
+
+		constexpr Vec2 operator+(const Vec2& vec) const;
+		constexpr Vec2 operator-(const Vec2& vec) const;
+		constexpr Vec2 operator*(const Vec2& vec) const;
+		constexpr Vec2 operator*(T scale) const;
+		constexpr Vec2 operator/(const Vec2& vec) const;
+		constexpr Vec2 operator/(T scale) const;
+		constexpr Vec2 operator%(const Vec2& vec) const;
+		constexpr Vec2 operator%(T mod) const;
+
+		constexpr Vec2& operator=(const Vec2&) = default;
+		constexpr Vec2& operator=(Vec2&&) = default;
+
+		constexpr Vec2& operator+=(const Vec2& vec);
+		constexpr Vec2& operator-=(const Vec2& vec);
+		constexpr Vec2& operator*=(const Vec2& vec);
+		constexpr Vec2& operator*=(T scale);
+		constexpr Vec2& operator/=(const Vec2& vec);
+		constexpr Vec2& operator/=(T scale);
+		constexpr Vec2& operator%=(const Vec2& vec);
+		constexpr Vec2& operator%=(T mod);
+
+		constexpr bool operator==(const Vec2& vec) const;
+		constexpr bool operator!=(const Vec2& vec) const;
+		constexpr bool operator<(const Vec2& vec) const;
+		constexpr bool operator<=(const Vec2& vec) const;
+		constexpr bool operator>(const Vec2& vec) const;
+		constexpr bool operator>=(const Vec2& vec) const;
+
+		static constexpr Vec2 Apply(T(*func)(T), const Vec2& vec);
+		static constexpr bool ApproxEqual(const Vec2& lhs, const Vec2& rhs, T max_difference = std::numeric_limits<T>::epsilon());
+		template<typename U = T> static U Distance(const Vec2& vec1, const Vec2& vec2);
+		static constexpr T DotProduct(const Vec2& vec1, const Vec2& vec2);
+		static constexpr Vec2 Lerp(const Vec2& from, const Vec2& to, T interpolation);
+		static Vec2 Normalize(const Vec2& vec);
+		static constexpr Vec2 Unit();
+		static constexpr Vec2 UnitX();
+		static constexpr Vec2 UnitY();
+		static constexpr Vec2 Zero();
+
+		~Vec2() = default;
+	};
+
+	using Vec2d = Vec2<double>;
+	using Vec2f = Vec2<float>;
+	using Vec2i = Vec2<int>;
+	using Vec2ui = Vec2<unsigned int>;
+	using Vec2i32 = Vec2<std::int32_t>;
+	using Vec2i64 = Vec2<std::int64_t>;
+	using Vec2ui32 = Vec2<std::uint32_t>;
+	using Vec2ui64 = Vec2<std::uint64_t>;
+
+	template<typename T> std::ostream& operator<<(std::ostream& out, const Vec2<T>& vec);
+
+	template<typename T> constexpr Vec2<T> operator*(T scale, const Vec2<T>& vec);
+	template<typename T> constexpr Vec2<T> operator/(T scale, const Vec2<T>& vec);
+	template<typename T> constexpr Vec2<T> operator%(T mod, const Vec2<T>& vec);
+}
+
+#include <Maths/Vec2.inl>
+
+#endif // __AK_VEC2__

runtime/Includes/Maths/Vec2.inl

@@ -0,0 +1,387 @@
+#pragma once
+#include <Maths/Vec2.h>
+
+namespace mlx
+{
+	template<typename T>
+	constexpr Vec2<T>::Vec2(T X, T Y) : x(X), y(Y) {}
+
+	template<typename T>
+	constexpr Vec2<T>::Vec2(T scale) : x(scale), y(scale) {}
+
+	template<typename T>
+	template<typename U>
+	constexpr Vec2<T>::Vec2(const Vec2<U>& vec) : x(static_cast<T>(vec.x)), y(static_cast<T>(vec.y)) {}
+
+	template<typename T>
+	constexpr Vec2<T>::Vec2(const Vec3<T>& vec) : x(vec.x), y(vec.y) {}
+
+	template<typename T>
+	constexpr Vec2<T>::Vec2(const Vec4<T>& vec) : x(vec.x), y(vec.y) {}
+
+	template<typename T>
+	T Vec2<T>::AbsDotProduct(const Vec2& vec) const
+	{
+		return std::abs(x * vec.x) + std::abs(y * vec.y);
+	}
+
+	template<typename T>
+	constexpr bool Vec2<T>::ApproxEqual(const Vec2& vec, T maxDifference) const
+	{
+		return NumberEquals(x, vec.x, maxDifference) && NumberEquals(y, vec.y, maxDifference);
+	}
+
+	template<typename T>
+	template<typename U>
+	U Vec2<T>::Distance(const Vec2& vec) const
+	{
+		return static_cast<U>(std::sqrt(SquaredDistance(vec)));
+	}
+
+	template<typename T>
+	constexpr T Vec2<T>::DotProduct(const Vec2& vec) const
+	{
+		return x * vec.x + y * vec.y;
+	}
+
+	template<typename T>
+	template<typename U>
+	T Vec2<T>::GetLength() const
+	{
+		return static_cast<U>(std::sqrt(static_cast<U>(GetSquaredLength())));
+	}
+
+	template<typename T>
+	Vec2<T> Vec2<T>::GetNormal(T* length) const
+	{
+		Vec2 vec(*this);
+		vec.Normalize(length);
+		return vec;
+	}
+
+	template<typename T>
+	constexpr T Vec2<T>::GetSquaredLength() const
+	{
+		return x * x + y * y;
+	}
+
+	template<typename T>
+	constexpr Vec2<T>& Vec2<T>::Maximize(const Vec2& vec)
+	{
+		if(vec.x > x)
+			x = vec.x;
+		if(vec.y > y)
+			y = vec.y;
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec2<T>& Vec2<T>::Minimize(const Vec2& vec)
+	{
+		if(vec.x < x)
+			x = vec.x;
+		if(vec.y < y)
+			y = vec.y;
+		return *this;
+	}
+
+	template<typename T>
+	Vec2<T>& Vec2<T>::Normalize(T* length)
+	{
+		T norm = GetLength();
+		if(norm > T(0.0))
+		{
+			T invNorm = T(1.0) / norm;
+			x *= invNorm;
+			y *= invNorm;
+		}
+		if(length)
+			*length = norm;
+		return *this;
+	}
+
+	template<typename T>
+	constexpr T Vec2<T>::SquaredDistance(const Vec2& vec) const
+	{
+		return (*this - vec).GetSquaredLength();
+	}
+
+	template<typename T>
+	std::string Vec2<T>::ToString() const
+	{
+		return "Vec2(" + std::to_string(x) + ", " + std::to_string(y) + ')';
+	}
+
+	template<typename T>
+	constexpr T& Vec2<T>::operator[](std::size_t i)
+	{
+		mlx::Assert(i < 2, "index out of range");
+		return *(&x + i);
+	}
+
+	template<typename T>
+	constexpr T Vec2<T>::operator[](std::size_t i) const
+	{
+		mlx::Assert(i < 2, "index out of range");
+		return *(&x + i);
+	}
+
+	template<typename T>
+	constexpr const Vec2<T>& Vec2<T>::operator+() const
+	{
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec2<T> Vec2<T>::operator-() const
+	{
+		return Vec2(-x, -y);
+	}
+
+	template<typename T>
+	constexpr Vec2<T> Vec2<T>::operator+(const Vec2& vec) const
+	{
+		return Vec2(x + vec.x, y + vec.y);
+	}
+
+	template<typename T>
+	constexpr Vec2<T> Vec2<T>::operator-(const Vec2& vec) const
+	{
+		return Vec2(x - vec.x, y - vec.y);
+	}
+
+	template<typename T>
+	constexpr Vec2<T> Vec2<T>::operator*(const Vec2& vec) const
+	{
+		return Vec2(x * vec.x, y * vec.y);
+	}
+
+	template<typename T>
+	constexpr Vec2<T> Vec2<T>::operator*(T scale) const
+	{
+		return Vec2(x * scale, y * scale);
+	}
+
+	template<typename T>
+	constexpr Vec2<T> Vec2<T>::operator/(const Vec2& vec) const
+	{
+		return Vec2(x / vec.x, y / vec.y);
+	}
+
+	template<typename T>
+	constexpr Vec2<T> Vec2<T>::operator/(T scale) const
+	{
+		return Vec2(x / scale, y / scale);
+	}
+
+	template<typename T>
+	constexpr Vec2<T> Vec2<T>::operator%(const Vec2& vec) const
+	{
+		return Vec2(Mod(x, vec.x), Mod(y, vec.y));
+	}
+
+	template<typename T>
+	constexpr Vec2<T> Vec2<T>::operator%(T mod) const
+	{
+		return Vec2(Mod(x, mod), Mod(y, mod));
+	}
+
+	template<typename T>
+	constexpr Vec2<T>& Vec2<T>::operator+=(const Vec2& vec)
+	{
+		x += vec.x;
+		y += vec.y;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec2<T>& Vec2<T>::operator-=(const Vec2& vec)
+	{
+		x -= vec.x;
+		y -= vec.y;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec2<T>& Vec2<T>::operator*=(const Vec2& vec)
+	{
+		x *= vec.x;
+		y *= vec.y;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec2<T>& Vec2<T>::operator*=(T scale)
+	{
+		x *= scale;
+		y *= scale;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec2<T>& Vec2<T>::operator/=(const Vec2& vec)
+	{
+		x /= vec.x;
+		y /= vec.y;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec2<T>& Vec2<T>::operator/=(T scale)
+	{
+		x /= scale;
+		y /= scale;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec2<T>& Vec2<T>::operator%=(const Vec2& vec)
+	{
+		x = Mod(x, vec.x);
+		y = Mod(y, vec.y);
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec2<T>& Vec2<T>::operator%=(T value)
+	{
+		x = Mod(x, value);
+		y = Mod(y, value);
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr bool Vec2<T>::operator==(const Vec2& vec) const
+	{
+		return x == vec.x && y == vec.y;
+	}
+
+	template<typename T>
+	constexpr bool Vec2<T>::operator!=(const Vec2& vec) const
+	{
+		return !operator==(vec);
+	}
+
+	template<typename T>
+	constexpr bool Vec2<T>::operator<(const Vec2& vec) const
+	{
+		if (x != vec.x)
+			return x < vec.x;
+
+		return y < vec.y;
+	}
+
+	template<typename T>
+	constexpr bool Vec2<T>::operator<=(const Vec2& vec) const
+	{
+		if (x != vec.x)
+			return x < vec.x;
+
+		return y <= vec.y;
+	}
+
+	template<typename T>
+	constexpr bool Vec2<T>::operator>(const Vec2& vec) const
+	{
+		if (x != vec.x)
+			return x > vec.x;
+
+		return y > vec.y;
+	}
+
+	template<typename T>
+	constexpr bool Vec2<T>::operator>=(const Vec2& vec) const
+	{
+		if (x != vec.x)
+			return x > vec.x;
+
+		return y >= vec.y;
+	}
+
+	template<typename T>
+	constexpr Vec2<T> Vec2<T>::Apply(T(*func)(T), const Vec2& vec)
+	{
+		return Vec2(func(vec.x), func(vec.y));
+	}
+
+	template<typename T>
+	constexpr bool Vec2<T>::ApproxEqual(const Vec2& lhs, const Vec2& rhs, T maxDifference)
+	{
+		return lhs.ApproxEqual(rhs, maxDifference);
+	}
+
+	template<typename T>
+	template<typename U>
+	U Vec2<T>::Distance(const Vec2& vec1, const Vec2& vec2)
+	{
+		return vec1.Distance<U>(vec2);
+	}
+
+	template<typename T>
+	constexpr T Vec2<T>::DotProduct(const Vec2& vec1, const Vec2& vec2)
+	{
+		return vec1.DotProduct(vec2);
+	}
+
+	template<typename T>
+	Vec2<T> Vec2<T>::Normalize(const Vec2& vec)
+	{
+		return vec.GetNormal();
+	}
+
+	template<typename T>
+	constexpr Vec2<T> Vec2<T>::Unit()
+	{
+		return Vec2(1, 1);
+	}
+
+	template<typename T>
+	constexpr Vec2<T> Vec2<T>::UnitX()
+	{
+		return Vec2(1, 0);
+	}
+
+	template<typename T>
+	constexpr Vec2<T> Vec2<T>::UnitY()
+	{
+		return Vec2(0, 1);
+	}
+
+	template<typename T>
+	constexpr Vec2<T> Vec2<T>::Zero()
+	{
+		return Vec2(0, 0);
+	}
+
+	template<typename T>
+	std::ostream& operator<<(std::ostream& out, const Vec2<T>& vec)
+	{
+		return out << "Vec2(" << vec.x << ", " << vec.y << ')';
+	}
+
+	template<typename T>
+	constexpr Vec2<T> operator*(T scale, const Vec2<T>& vec)
+	{
+		return Vec2<T>(scale * vec.x, scale * vec.y);
+	}
+
+	template<typename T>
+	constexpr Vec2<T> operator/(T scale, const Vec2<T>& vec)
+	{
+		return Vec2<T>(scale / vec.x, scale / vec.y);
+	}
+
+	template<typename T>
+	constexpr Vec2<T> operator%(T mod, const Vec2<T>& vec)
+	{
+		return Vec2<T>(Mod(mod, vec.x), Mod(mod, vec.y));
+	}
+}

runtime/Includes/Maths/Vec3.h

@@ -0,0 +1,126 @@
+#ifndef __MLX_VEC3__
+#define __MLX_VEC3__
+
+namespace mlx
+{
+	template<typename T> struct Vec2;
+	template<typename T> struct Vec4;
+
+	template<typename T>
+	struct Vec3
+	{
+		union { T x, r, s; };
+		union { T y, g, t; };
+		union { T z, b, p; };
+
+		constexpr Vec3() = default;
+		constexpr Vec3(T X, T Y, T Z);
+		constexpr Vec3(T X, const Vec2<T>& vec);
+		constexpr explicit Vec3(T scale);
+		constexpr Vec3(const Vec2<T>& vec, T Z = 0.0);
+		template<typename U> constexpr explicit Vec3(const Vec3<U>& vec);
+		constexpr Vec3(const Vec3&) = default;
+		constexpr Vec3(Vec3&&) = default;
+		constexpr explicit Vec3(const Vec4<T>& vec);
+
+		T AbsDotProduct(const Vec3& vec) const;
+		constexpr bool ApproxEqual(const Vec3& vec, T max_difference = std::numeric_limits<T>::epsilon()) const;
+
+		constexpr Vec3 CrossProduct(const Vec3& vec) const;
+
+		template<typename U = T> U Distance(const Vec3& vec) const;
+		constexpr T DotProduct(const Vec3& vec) const;
+
+		Vec3 GetAbs() const;
+		template<typename U = T> U GetLength() const;
+		Vec3 GetNormal(T* length = nullptr) const;
+		constexpr T GetSquaredLength() const;
+
+		constexpr Vec3& Maximize(const Vec3& vec);
+		constexpr Vec3& Minimize(const Vec3& vec);
+
+		Vec3& Normalize(T* length = nullptr);
+
+		constexpr T SquaredDistance(const Vec3& vec) const;
+
+		std::string ToString() const;
+
+		constexpr T& operator[](std::size_t i);
+		constexpr const T& operator[](std::size_t i) const;
+
+		constexpr const Vec3& operator+() const;
+		constexpr Vec3 operator-() const;
+
+		constexpr Vec3 operator+(const Vec3& vec) const;
+		constexpr Vec3 operator-(const Vec3& vec) const;
+		constexpr Vec3 operator*(const Vec3& vec) const;
+		constexpr Vec3 operator*(T scale) const;
+		constexpr Vec3 operator/(const Vec3& vec) const;
+		constexpr Vec3 operator/(T scale) const;
+		constexpr Vec3 operator%(const Vec3& vec) const;
+		constexpr Vec3 operator%(T mod) const;
+
+		constexpr Vec3& operator=(const Vec3&) = default;
+		constexpr Vec3& operator=(Vec3&&) = default;
+
+		constexpr Vec3& operator+=(const Vec3& vec);
+		constexpr Vec3& operator-=(const Vec3& vec);
+		constexpr Vec3& operator*=(const Vec3& vec);
+		constexpr Vec3& operator*=(T scale);
+		constexpr Vec3& operator/=(const Vec3& vec);
+		constexpr Vec3& operator/=(T scale);
+		constexpr Vec3& operator%=(const Vec3& vec);
+		constexpr Vec3& operator%=(T mod);
+
+		constexpr bool operator==(const Vec3& vec) const;
+		constexpr bool operator!=(const Vec3& vec) const;
+		constexpr bool operator<(const Vec3& vec) const;
+		constexpr bool operator<=(const Vec3& vec) const;
+		constexpr bool operator>(const Vec3& vec) const;
+		constexpr bool operator>=(const Vec3& vec) const;
+
+		static constexpr Vec3 Apply(T(*func)(T), const Vec3& vec);
+		static constexpr bool ApproxEqual(const Vec3& lhs, const Vec3& rhs, T max_difference = std::numeric_limits<T>::epsilon());
+		static constexpr Vec3 Backward();
+		static constexpr Vec3 Clamp(const Vec3& vec, const Vec3& min, const Vec3& max);
+		static constexpr Vec3 CrossProduct(const Vec3& vec1, const Vec3& vec2);
+		template<typename U = T> static U Distance(const Vec3& vec1, const Vec3& vec2);
+		static constexpr T DotProduct(const Vec3& vec1, const Vec3& vec2);
+		static constexpr Vec3 Down();
+		static constexpr Vec3 Forward();
+		static constexpr Vec3 Left();
+		static constexpr Vec3 Max(const Vec3& lhs, const Vec3& rhs);
+		static constexpr Vec3 Min(const Vec3& lhs, const Vec3& rhs);
+		static Vec3 Normalize(const Vec3& vec);
+		static constexpr Vec3 Right();
+		static constexpr T SquaredDistance(const Vec3& vec1, const Vec3& vec2);
+		static constexpr Vec3 Unit();
+		static constexpr Vec3 UnitX();
+		static constexpr Vec3 UnitY();
+		static constexpr Vec3 UnitZ();
+		static constexpr Vec3 Up();
+		static constexpr Vec3 Zero();
+
+		~Vec3() = default;
+	};
+
+	using Vec3b = Vec3<std::uint8_t>;
+	using Vec3d = Vec3<double>;
+	using Vec3f = Vec3<float>;
+	using Vec3i = Vec3<int>;
+	using Vec3ui = Vec3<unsigned int>;
+	using Vec3i32 = Vec3<std::int32_t>;
+	using Vec3i64 = Vec3<std::int64_t>;
+	using Vec3ui32 = Vec3<std::uint32_t>;
+	using Vec3ui64 = Vec3<std::uint64_t>;
+
+	template<typename T> std::ostream& operator<<(std::ostream& out, const Vec3<T>& vec);
+
+	template<typename T> constexpr Vec3<T> operator*(T scale, const Vec3<T>& vec);
+	template<typename T> constexpr Vec3<T> operator/(T scale, const Vec3<T>& vec);
+	template<typename T> constexpr Vec3<T> operator%(T scale, const Vec3<T>& vec);
+}
+
+#include <Maths/Vec3.inl>
+
+#endif // __AK_VEC3__

runtime/Includes/Maths/Vec3.inl

@@ -0,0 +1,508 @@
+#pragma once
+#include <Maths/Vec3.h>
+
+namespace mlx
+{
+	template<typename T>
+	constexpr Vec3<T>::Vec3(T X, T Y, T Z) : x(X), y(Y), z(Z) {}
+
+	template<typename T>
+	constexpr Vec3<T>::Vec3(T X, const Vec2<T>& vec) : x(X), y(vec.x), z(vec.y) {}
+
+	template<typename T>
+	constexpr Vec3<T>::Vec3(T scale) : x(scale), y(scale), z(scale) {}
+
+	template<typename T>
+	constexpr Vec3<T>::Vec3(const Vec2<T>& vec, T Z) : x(vec.x), y(vec.y), z(Z) {}
+
+	template<typename T>
+	template<typename U>
+	constexpr Vec3<T>::Vec3(const Vec3<U>& vec) : x(static_cast<T>(vec.x)), y(static_cast<T>(vec.y)), z(static_cast<T>(vec.z)) {}
+
+	template<typename T>
+	constexpr Vec3<T>::Vec3(const Vec4<T>& vec) : x(vec.x), y(vec.y), z(vec.z) {}
+
+	template<typename T>
+	T Vec3<T>::AbsDotProduct(const Vec3& vec) const
+	{
+		return std::abs(x * vec.x) + std::abs(y * vec.y) + std::abs(z * vec.z);
+	}
+
+	template<typename T>
+	constexpr bool Vec3<T>::ApproxEqual(const Vec3& vec, T maxDifference) const
+	{
+		return NumberEquals(x, vec.x, maxDifference) && NumberEquals(y, vec.y, maxDifference) && NumberEquals(z, vec.z, maxDifference);
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Vec3<T>::CrossProduct(const Vec3& vec) const
+	{
+		return Vec3(y * vec.z - z * vec.y, z * vec.x - x * vec.z, x * vec.y - y * vec.x);
+	}
+
+	template<typename T>
+	template<typename U>
+	U Vec3<T>::Distance(const Vec3& vec) const
+	{
+		return static_cast<U>(std::sqrt(static_cast<U>(SquaredDistance(vec))));
+	}
+
+	template<typename T>
+	constexpr T Vec3<T>::DotProduct(const Vec3& vec) const
+	{
+		return x * vec.x + y * vec.y + z * vec.z;
+	}
+
+	template<typename T>
+	Vec3<T> Vec3<T>::GetAbs() const
+	{
+		return Vec3(std::abs(x), std::abs(y), std::abs(z));
+	}
+
+	template<typename T>
+	template<typename U>
+	U Vec3<T>::GetLength() const
+	{
+		return static_cast<U>(std::sqrt(static_cast<U>(GetSquaredLength())));
+	}
+
+	template<typename T>
+	Vec3<T> Vec3<T>::GetNormal(T* length) const
+	{
+		Vec3 vec(*this);
+		vec.Normalize(length);
+
+		return vec;
+	}
+
+	template<typename T>
+	constexpr T Vec3<T>::GetSquaredLength() const
+	{
+		return x*x + y*y + z*z;
+	}
+
+	template<typename T>
+	constexpr Vec3<T>& Vec3<T>::Maximize(const Vec3& vec)
+	{
+		if (vec.x > x)
+			x = vec.x;
+
+		if (vec.y > y)
+			y = vec.y;
+
+		if (vec.z > z)
+			z = vec.z;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec3<T>& Vec3<T>::Minimize(const Vec3& vec)
+	{
+		if (vec.x < x)
+			x = vec.x;
+
+		if (vec.y < y)
+			y = vec.y;
+
+		if (vec.z < z)
+			z = vec.z;
+
+		return *this;
+	}
+
+	template<typename T>
+	Vec3<T>& Vec3<T>::Normalize(T* length)
+	{
+		T norm = GetLength();
+		if (norm > T(0.0))
+		{
+			T invNorm = T(1.0) / norm;
+			x *= invNorm;
+			y *= invNorm;
+			z *= invNorm;
+		}
+
+		if (length)
+			*length = norm;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr T Vec3<T>::SquaredDistance(const Vec3& vec) const
+	{
+		return (*this - vec).GetSquaredLength();
+	}
+
+	template<typename T>
+	std::string Vec3<T>::ToString() const
+	{
+		return "Vec3(" + std::to_string(x) + ", " + std::to_string(y) + ", " + std::to_string(z) + ')';
+	}
+
+	template<typename T>
+	constexpr T& Vec3<T>::operator[](std::size_t i)
+	{
+		mlx::Assert(i < 3, "index out of range");
+		return *(&x + i);
+	}
+
+	template<typename T>
+	constexpr const T& Vec3<T>::operator[](std::size_t i) const
+	{
+		mlx::Assert(i < 3, "index out of range");
+		return *(&x + i);
+	}
+
+	template<typename T>
+	constexpr const Vec3<T>& Vec3<T>::operator+() const
+	{
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Vec3<T>::operator-() const
+	{
+		return Vec3(-x, -y, -z);
+	}
+	template<typename T>
+	constexpr Vec3<T> Vec3<T>::operator+(const Vec3& vec) const
+	{
+		return Vec3(x + vec.x, y + vec.y, z + vec.z);
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Vec3<T>::operator-(const Vec3& vec) const
+	{
+		return Vec3(x - vec.x, y - vec.y, z - vec.z);
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Vec3<T>::operator*(const Vec3& vec) const
+	{
+		return Vec3(x * vec.x, y * vec.y, z * vec.z);
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Vec3<T>::operator*(T scale) const
+	{
+		return Vec3(x * scale, y * scale, z * scale);
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Vec3<T>::operator/(const Vec3& vec) const
+	{
+		return Vec3(x / vec.x, y / vec.y, z / vec.z);
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Vec3<T>::operator/(T scale) const
+	{
+		return Vec3(x / scale, y / scale, z / scale);
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Vec3<T>::operator%(const Vec3& vec) const
+	{
+		return Vec3(Mod(x, vec.x), Mod(y, vec.y), Mod(z, vec.z));
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Vec3<T>::operator%(T mod) const
+	{
+		return Vec3(Mod(x, mod), Mod(y, mod), Mod(z, mod));
+	}
+
+	template<typename T>
+	constexpr Vec3<T>& Vec3<T>::operator+=(const Vec3& vec)
+	{
+		x += vec.x;
+		y += vec.y;
+		z += vec.z;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec3<T>& Vec3<T>::operator-=(const Vec3& vec)
+	{
+		x -= vec.x;
+		y -= vec.y;
+		z -= vec.z;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec3<T>& Vec3<T>::operator*=(const Vec3& vec)
+	{
+		x *= vec.x;
+		y *= vec.y;
+		z *= vec.z;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec3<T>& Vec3<T>::operator*=(T scale)
+	{
+		x *= scale;
+		y *= scale;
+		z *= scale;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec3<T>& Vec3<T>::operator/=(const Vec3& vec)
+	{
+		x /= vec.x;
+		y /= vec.y;
+		z /= vec.z;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec3<T>& Vec3<T>::operator/=(T scale)
+	{
+		x /= scale;
+		y /= scale;
+		z /= scale;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec3<T>& Vec3<T>::operator%=(const Vec3& vec)
+	{
+		x = Mod(x, vec.x);
+		y = Mod(y, vec.y);
+		z = Mod(z, vec.z);
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec3<T>& Vec3<T>::operator%=(T mod)
+	{
+		x = Mod(x, mod);
+		y = Mod(y, mod);
+		z = Mod(z, mod);
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr bool Vec3<T>::operator==(const Vec3& vec) const
+	{
+		return x == vec.x && y == vec.y && z == vec.z;
+	}
+
+	template<typename T>
+	constexpr bool Vec3<T>::operator!=(const Vec3& vec) const
+	{
+		return !operator==(vec);
+	}
+
+	template<typename T>
+	constexpr bool Vec3<T>::operator<(const Vec3& vec) const
+	{
+		if (x != vec.x)
+			return x < vec.x;
+
+		if (y != vec.y)
+			return y < vec.y;
+
+		return z < vec.z;
+	}
+
+	template<typename T>
+	constexpr bool Vec3<T>::operator<=(const Vec3& vec) const
+	{
+		if (x != vec.x)
+			return x < vec.x;
+
+		if (y != vec.y)
+			return y < vec.y;
+
+		return z <= vec.z;
+	}
+
+	template<typename T>
+	constexpr bool Vec3<T>::operator>(const Vec3& vec) const
+	{
+		if (x != vec.x)
+			return x > vec.x;
+
+		if (y != vec.y)
+			return y > vec.y;
+
+		return z > vec.z;
+	}
+
+	template<typename T>
+	constexpr bool Vec3<T>::operator>=(const Vec3& vec) const
+	{
+		if (x != vec.x)
+			return x > vec.x;
+
+		if (y != vec.y)
+			return y > vec.y;
+
+		return z >= vec.z;
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Vec3<T>::Apply(T(*func)(T), const Vec3& vec)
+	{
+		return Vec3(func(vec.x), func(vec.y), func(vec.z));
+	}
+
+	template<typename T>
+	constexpr bool Vec3<T>::ApproxEqual(const Vec3& lhs, const Vec3& rhs, T maxDifference)
+	{
+		return lhs.ApproxEqual(rhs, maxDifference);
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Vec3<T>::CrossProduct(const Vec3& vec1, const Vec3& vec2)
+	{
+		return vec1.CrossProduct(vec2);
+	}
+
+	template<typename T>
+	constexpr T Vec3<T>::DotProduct(const Vec3& vec1, const Vec3& vec2)
+	{
+		return vec1.DotProduct(vec2);
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Vec3<T>::Backward()
+	{
+		return Vec3(0, 0, 1);
+	}
+
+	template<typename T>
+	template<typename U>
+	U Vec3<T>::Distance(const Vec3& vec1, const Vec3& vec2)
+	{
+		return vec1.Distance<U>(vec2);
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Vec3<T>::Down()
+	{
+		return Vec3(0, -1, 0);
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Vec3<T>::Forward()
+	{
+		return Vec3(0, 0, -1);
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Vec3<T>::Left()
+	{
+		return Vec3(-1, 0, 0);
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Vec3<T>::Max(const Vec3& lhs, const Vec3& rhs)
+	{
+		Vec3 max = lhs;
+		max.Maximize(rhs);
+
+		return max;
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Vec3<T>::Min(const Vec3& lhs, const Vec3& rhs)
+	{
+		Vec3 min = lhs;
+		min.Minimize(rhs);
+
+		return min;
+	}
+
+	template<typename T>
+	Vec3<T> Vec3<T>::Normalize(const Vec3& vec)
+	{
+		return vec.GetNormal();
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Vec3<T>::Right()
+	{
+		return Vec3(1, 0, 0);
+	}
+
+	template<typename T>
+	constexpr T Vec3<T>::SquaredDistance(const Vec3& vec1, const Vec3& vec2)
+	{
+		return vec1.SquaredDistance(vec2);
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Vec3<T>::Unit()
+	{
+		return Vec3(1);
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Vec3<T>::UnitX()
+	{
+		return Vec3(1, 0, 0);
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Vec3<T>::UnitY()
+	{
+		return Vec3(0, 1, 0);
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Vec3<T>::UnitZ()
+	{
+		return Vec3(0, 0, 1);
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Vec3<T>::Up()
+	{
+		return Vec3(0, 1, 0);
+	}
+
+	template<typename T>
+	constexpr Vec3<T> Vec3<T>::Zero()
+	{
+		return Vec3(0, 0, 0);
+	}
+
+	template<typename T>
+	std::ostream& operator<<(std::ostream& out, const Vec3<T>& vec)
+	{
+		return out << "Vec3(" << vec.x << ", " << vec.y << ", " << vec.z << ')';
+	}
+
+	template<typename T>
+	constexpr Vec3<T> operator*(T scale, const Vec3<T>& vec)
+	{
+		return Vec3<T>(scale * vec.x, scale * vec.y, scale * vec.z);
+	}
+
+	template<typename T>
+	constexpr Vec3<T> operator/(T scale, const Vec3<T>& vec)
+	{
+		return Vec3<T>(scale / vec.x, scale / vec.y, scale / vec.z);
+	}
+
+	template<typename T>
+	constexpr Vec3<T> operator%(T mod, const Vec3<T>& vec)
+	{
+		return Vec3<T>(Mod(mod, vec.x), Mod(mod, vec.y), Mod(mod, vec.z));
+	}
+}
+

runtime/Includes/Maths/Vec4.h

@@ -0,0 +1,108 @@
+#ifndef __MLX_VEC4__
+#define __MLX_VEC4__
+
+namespace mlx
+{
+	template<typename T> struct Vec2;
+	template<typename T> struct Vec3;
+
+	template<typename T>
+	struct Vec4
+	{
+		union { T x, r, s; };
+		union { T y, g, t; };
+		union { T z, b, p; };
+		union { T w, a, q; };
+
+		constexpr Vec4() = default;
+		constexpr Vec4(T X, T Y, T Z, T W = 1.0);
+		constexpr Vec4(T X, T Y, const Vec2<T>& vec);
+		constexpr Vec4(T X, const Vec2<T>& vec, T W);
+		constexpr Vec4(T X, const Vec3<T>& vec);
+		constexpr explicit Vec4(T scale);
+		constexpr Vec4(const Vec2<T>& vec, T Z = 0.0, T W = 1.0);
+		constexpr Vec4(const Vec3<T>& vec, T W = 1.0);
+		template<typename U> constexpr explicit Vec4(const Vec4<U>& vec);
+		constexpr Vec4(const Vec4&) = default;
+		constexpr Vec4(Vec4&&) = default;
+
+		T AbsDotProduct(const Vec4& vec) const;
+		constexpr bool ApproxEqual(const Vec4& vec, T max_difference = std::numeric_limits<T>::epsilon()) const;
+
+		constexpr T DotProduct(const Vec4& vec) const;
+
+		Vec4 GetNormal(T* length = nullptr) const;
+
+		constexpr Vec4& Maximize(const Vec4& vec);
+		constexpr Vec4& Minimize(const Vec4& vec);
+
+		Vec4& Normalize(T* length = nullptr);
+
+		std::string ToString() const;
+
+		constexpr Vec4& operator=(const Vec4&) = default;
+		constexpr Vec4& operator=(Vec4&&) = default;
+
+		constexpr T& operator[](std::size_t i);
+		constexpr const T& operator[](std::size_t i) const;
+
+		constexpr const Vec4& operator+() const;
+		constexpr Vec4 operator-() const;
+
+		constexpr Vec4 operator+(const Vec4& vec) const;
+		constexpr Vec4 operator-(const Vec4& vec) const;
+		constexpr Vec4 operator*(const Vec4& vec) const;
+		constexpr Vec4 operator*(T scale) const;
+		constexpr Vec4 operator/(const Vec4& vec) const;
+		constexpr Vec4 operator/(T scale) const;
+		constexpr Vec4 operator%(const Vec4& vec) const;
+		constexpr Vec4 operator%(T mod) const;
+
+		constexpr Vec4& operator+=(const Vec4& vec);
+		constexpr Vec4& operator-=(const Vec4& vec);
+		constexpr Vec4& operator*=(const Vec4& vec);
+		constexpr Vec4& operator*=(T scale);
+		constexpr Vec4& operator/=(const Vec4& vec);
+		constexpr Vec4& operator/=(T scale);
+		constexpr Vec4& operator%=(const Vec4& vec);
+		constexpr Vec4& operator%=(T mod);
+
+		constexpr bool operator==(const Vec4& vec) const;
+		constexpr bool operator!=(const Vec4& vec) const;
+		constexpr bool operator<(const Vec4& vec) const;
+		constexpr bool operator<=(const Vec4& vec) const;
+		constexpr bool operator>(const Vec4& vec) const;
+		constexpr bool operator>=(const Vec4& vec) const;
+
+		static constexpr Vec4 Apply(T(*func)(T), const Vec4& vec);
+		static constexpr bool ApproxEqual(const Vec4& lhs, const Vec4& rhs, T max_difference = std::numeric_limits<T>::epsilon());
+		static constexpr T DotProduct(const Vec4& vec1, const Vec4& vec2);
+		static Vec4 Normalize(const Vec4& vec);
+		static constexpr Vec4 UnitX();
+		static constexpr Vec4 UnitY();
+		static constexpr Vec4 UnitZ();
+		static constexpr Vec4 Zero();
+
+		~Vec4() = default;
+	};
+
+	using Vec4d = Vec4<double>;
+	using Vec4f = Vec4<float>;
+	using Vec4i = Vec4<int>;
+	using Vec4ui = Vec4<unsigned int>;
+	using Vec4i32 = Vec4<std::int32_t>;
+	using Vec4i64 = Vec4<std::int64_t>;
+	using Vec4ui32 = Vec4<std::uint32_t>;
+	using Vec4ui64 = Vec4<std::uint64_t>;
+
+	template<typename T> std::ostream& operator<<(std::ostream& out, const Vec4<T>& vec);
+
+	template<typename T> constexpr Vec4<T> operator*(T scale, const Vec4<T>& vec);
+	template<typename T> constexpr Vec4<T> operator/(T scale, const Vec4<T>& vec);
+	template<typename T> constexpr Vec4<T> operator%(T mod, const Vec4<T>& vec);
+}
+
+#include <Maths/Vec4.inl>
+
+#endif // __AK_VEC4__
+

runtime/Includes/Maths/Vec4.inl

@@ -0,0 +1,423 @@
+#pragma once
+#include <Maths/Vec4.h>
+
+namespace mlx
+{
+	template<typename T>
+	constexpr Vec4<T>::Vec4(T X, T Y, T Z, T W) : x(X), y(Y), z(Z), w(W) {}
+
+	template<typename T>
+	constexpr Vec4<T>::Vec4(T X, T Y, const Vec2<T>& vec) : x(X), y(Y), z(vec.x), w(vec.y) {}
+
+	template<typename T>
+	constexpr Vec4<T>::Vec4(T X, const Vec2<T>& vec, T W) : x(X), y(vec.x), z(vec.y), w(W) {}
+
+	template<typename T>
+	constexpr Vec4<T>::Vec4(T X, const Vec3<T>& vec) : x(X), y(vec.x), z(vec.y), w(vec.z) {}
+
+	template<typename T>
+	constexpr Vec4<T>::Vec4(T scale) : x(scale), y(scale), z(scale), w(scale) {}
+
+	template<typename T>
+	constexpr Vec4<T>::Vec4(const Vec2<T>& vec, T Z, T W) : x(vec.x), y(vec.y), z(Z), w(W) {}
+
+	template<typename T>
+	constexpr Vec4<T>::Vec4(const Vec3<T>& vec, T W) : x(vec.x), y(vec.y), z(vec.z), w(W) {}
+
+	template<typename T>
+	template<typename U>
+	constexpr Vec4<T>::Vec4(const Vec4<U>& vec) : x(static_cast<T>(vec.x)), y(static_cast<T>(vec.y)), z(static_cast<T>(vec.z)), w(static_cast<T>(vec.w)) {}
+
+	template<typename T>
+	T Vec4<T>::AbsDotProduct(const Vec4& vec) const
+	{
+		return std::abs(x * vec.x) + std::abs(y * vec.y) + std::abs(z * vec.z) + std::abs(w * vec.w);
+	}
+
+	template<typename T>
+	constexpr bool Vec4<T>::ApproxEqual(const Vec4& vec, T maxDifference) const
+	{
+		return NumberEquals(x, vec.x, maxDifference) && NumberEquals(y, vec.y, maxDifference) && NumberEquals(z, vec.z, maxDifference) && NumberEquals(w, vec.w, maxDifference);
+	}
+
+	template<typename T>
+	constexpr T Vec4<T>::DotProduct(const Vec4& vec) const
+	{
+		return x*vec.x + y*vec.y + z*vec.z + w*vec.w;
+	}
+
+	template<typename T>
+	Vec4<T> Vec4<T>::GetNormal(T* length) const
+	{
+		Vec4<T> vec(*this);
+		vec.Normalize(length);
+
+		return vec;
+	}
+
+	template<typename T>
+	constexpr Vec4<T>& Vec4<T>::Maximize(const Vec4& vec)
+	{
+		if (vec.x > x)
+			x = vec.x;
+
+		if (vec.y > y)
+			y = vec.y;
+
+		if (vec.z > z)
+			z = vec.z;
+
+		if (vec.w > w)
+			w = vec.w;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec4<T>& Vec4<T>::Minimize(const Vec4& vec)
+	{
+		if (vec.x < x)
+			x = vec.x;
+
+		if (vec.y < y)
+			y = vec.y;
+
+		if (vec.z < z)
+			z = vec.z;
+
+		if (vec.w < w)
+			w = vec.w;
+
+		return *this;
+	}
+
+	template<typename T>
+	Vec4<T>& Vec4<T>::Normalize(T* length)
+	{
+		T invLength = T(1.0) / w;
+		x *= invLength;
+		y *= invLength;
+		z *= invLength;
+
+		if (length)
+			*length = w;
+
+		w = T(1.0);
+
+		return *this;
+	}
+
+	template<typename T>
+	std::string Vec4<T>::ToString() const
+	{
+		std::ostringstream ss;
+		ss << *this;
+
+		return ss.str();
+	}
+
+	template<typename T>
+	constexpr T& Vec4<T>::operator[](std::size_t i)
+	{
+		mlx::Assert(i < 4, "index out of range");
+		return *(&x + i);
+	}
+
+	template<typename T>
+	constexpr const T& Vec4<T>::operator[](std::size_t i) const
+	{
+		mlx::Assert(i < 4, "index out of range");
+		return *(&x + i);
+	}
+
+	template<typename T>
+	constexpr const Vec4<T>& Vec4<T>::operator+() const
+	{
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec4<T> Vec4<T>::operator-() const
+	{
+		return Vec4(-x, -y, -z, -w);
+	}
+	template<typename T>
+	constexpr Vec4<T> Vec4<T>::operator+(const Vec4& vec) const
+	{
+		return Vec4(x + vec.x, y + vec.y, z + vec.z, w + vec.w);
+	}
+	template<typename T>
+	constexpr Vec4<T> Vec4<T>::operator-(const Vec4& vec) const
+	{
+		return Vec4(x - vec.x, y - vec.y, z - vec.z, w - vec.w);
+	}
+
+	template<typename T>
+	constexpr Vec4<T> Vec4<T>::operator*(const Vec4& vec) const
+	{
+		return Vec4(x * vec.x, y * vec.y, z * vec.z, w * vec.w);
+	}
+
+	template<typename T>
+	constexpr Vec4<T> Vec4<T>::operator*(T scale) const
+	{
+		return Vec4(x * scale, y * scale, z * scale, w * scale);
+	}
+
+	template<typename T>
+	constexpr Vec4<T> Vec4<T>::operator/(const Vec4& vec) const
+	{
+		return Vec4(x / vec.x, y / vec.y, z / vec.z, w / vec.w);
+	}
+
+	template<typename T>
+	constexpr Vec4<T> Vec4<T>::operator/(T scale) const
+	{
+		return Vec4(x / scale, y / scale, z / scale, w / scale);
+	}
+
+	template<typename T>
+	constexpr Vec4<T> Vec4<T>::operator%(const Vec4& vec) const
+	{
+		return Vec4(Mod(x, vec.x), Mod(y, vec.y), Mod(z, vec.z), Mod(w, vec.w));
+	}
+
+	template<typename T>
+	constexpr Vec4<T> Vec4<T>::operator%(T mod) const
+	{
+		return Vec4(Mod(x, mod), Mod(y, mod), Mod(z, mod), Mod(z, mod));
+	}
+
+	template<typename T>
+	constexpr Vec4<T>& Vec4<T>::operator+=(const Vec4& vec)
+	{
+		x += vec.x;
+		y += vec.y;
+		z += vec.z;
+		w += vec.w;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec4<T>& Vec4<T>::operator-=(const Vec4& vec)
+	{
+		x -= vec.x;
+		y -= vec.y;
+		z -= vec.z;
+		w -= vec.w;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec4<T>& Vec4<T>::operator*=(const Vec4& vec)
+	{
+		x *= vec.x;
+		y *= vec.y;
+		z *= vec.z;
+		w *= vec.w;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec4<T>& Vec4<T>::operator*=(T scale)
+	{
+		x *= scale;
+		y *= scale;
+		z *= scale;
+		w *= scale;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec4<T>& Vec4<T>::operator/=(const Vec4& vec)
+	{
+		x /= vec.x;
+		y /= vec.y;
+		z /= vec.z;
+		w /= vec.w;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec4<T>& Vec4<T>::operator/=(T scale)
+	{
+		x /= scale;
+		y /= scale;
+		z /= scale;
+		w /= scale;
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec4<T>& Vec4<T>::operator%=(const Vec4& vec)
+	{
+		x = Mod(x, vec.x);
+		y = Mod(y, vec.y);
+		z = Mod(z, vec.z);
+		w = Mod(w, vec.w);
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr Vec4<T>& Vec4<T>::operator%=(T mod)
+	{
+		x = Mod(x, mod);
+		y = Mod(y, mod);
+		z = Mod(z, mod);
+		w = Mod(w, mod);
+
+		return *this;
+	}
+
+	template<typename T>
+	constexpr bool Vec4<T>::operator==(const Vec4& vec) const
+	{
+		return x == vec.x && y == vec.y && z == vec.z && w == vec.w;
+	}
+
+	template<typename T>
+	constexpr bool Vec4<T>::operator!=(const Vec4& vec) const
+	{
+		return !operator==(vec);
+	}
+
+	template<typename T>
+	constexpr bool Vec4<T>::operator<(const Vec4& vec) const
+	{
+		if (x != vec.x)
+			return x < vec.x;
+
+		if (y != vec.y)
+			return y < vec.y;
+
+		if (z != vec.z)
+			return z < vec.z;
+
+		return w < vec.w;
+	}
+
+	template<typename T>
+	constexpr bool Vec4<T>::operator<=(const Vec4& vec) const
+	{
+		if (x != vec.x)
+			return x < vec.x;
+
+		if (y != vec.y)
+			return y < vec.y;
+
+		if (z != vec.z)
+			return z < vec.z;
+
+		return w <= vec.w;
+	}
+
+	template<typename T>
+	constexpr bool Vec4<T>::operator>(const Vec4& vec) const
+	{
+		if (x != vec.x)
+			return x > vec.x;
+
+		if (y != vec.y)
+			return y > vec.y;
+
+		if (z != vec.z)
+			return z > vec.z;
+
+		return w > vec.w;
+	}
+
+	template<typename T>
+	constexpr bool Vec4<T>::operator>=(const Vec4& vec) const
+	{
+		if (x != vec.x)
+			return x > vec.x;
+
+		if (y != vec.y)
+			return y > vec.y;
+
+		if (z != vec.z)
+			return z > vec.z;
+
+		return w >= vec.w;
+	}
+
+	template<typename T>
+	constexpr Vec4<T> Vec4<T>::Apply(T(*func)(T), const Vec4& vec)
+	{
+		return Vec4(func(vec.x), func(vec.y), func(vec.z), func(vec.w));
+	}
+
+	template<typename T>
+	constexpr bool Vec4<T>::ApproxEqual(const Vec4& lhs, const Vec4& rhs, T maxDifference)
+	{
+		return lhs.ApproxEqual(rhs, maxDifference);
+	}
+
+	template<typename T>
+	constexpr T Vec4<T>::DotProduct(const Vec4& vec1, const Vec4& vec2)
+	{
+		return vec1.DotProduct(vec2);
+	}
+
+	template<typename T>
+	Vec4<T> Vec4<T>::Normalize(const Vec4& vec)
+	{
+		return vec.GetNormal();
+	}
+
+	template<typename T>
+	constexpr Vec4<T> Vec4<T>::UnitX()
+	{
+		return Vec4(1, 0, 0, 1);
+	}
+
+	template<typename T>
+	constexpr Vec4<T> Vec4<T>::UnitY()
+	{
+		return Vec4(0, 1, 0, 1);
+	}
+
+	template<typename T>
+	constexpr Vec4<T> Vec4<T>::UnitZ()
+	{
+		return Vec4(0, 0, 1, 1);
+	}
+
+	template<typename T>
+	constexpr Vec4<T> Vec4<T>::Zero()
+	{
+		return Vec4(0, 0, 0, 1);
+	}
+
+	template<typename T>
+	std::ostream& operator<<(std::ostream& out, const Vec4<T>& vec)
+	{
+		return out << "Vec4(" << vec.x << ", " << vec.y << ", " << vec.z << ", " << vec.w << ')';
+	}
+
+	template<typename T>
+	constexpr Vec4<T> operator*(T scale, const Vec4<T>& vec)
+	{
+		return Vec4<T>(scale * vec.x, scale * vec.y, scale * vec.z, scale * vec.w);
+	}
+
+	template<typename T>
+	constexpr Vec4<T> operator/(T scale, const Vec4<T>& vec)
+	{
+		return Vec4<T>(scale / vec.x, scale / vec.y, scale / vec.z, scale / vec.w);
+	}
+
+	template<typename T>
+	constexpr Vec4<T> operator%(T mod, const Vec4<T>& vec)
+	{
+		return Vec4<T>(Mod(mod, vec.x), Mod(mod, vec.y), Mod(mod, vec.z), Mod(mod, vec.w));
+	}
+}
+

runtime/Includes/Platform/Inputs.h

@@ -0,0 +1,52 @@
+#ifndef __MLX_INPUTS__
+#define __MLX_INPUTS__
+
+#include <mlx.h>
+#include <mlx_profile.h>
+#include <Platform/Window.h>
+
+namespace mlx
+{
+	class Inputs
+	{
+		public:
+			struct Hook
+			{
+				std::function<void(int, void*)> fn;
+				void* param = nullptr;
+
+				Hook(std::function<void(int, void*)> fn, void* param) : fn(fn), param(param) {}
+			};
+
+		public:
+			Inputs() = default;
+
+			void FetchInputs();
+
+			inline void RegisterWindow(std::shared_ptr<Window> window) { m_windows[window->GetID()] = window; }
+
+			std::int32_t GetX() const noexcept;
+			std::int32_t GetY() const noexcept;
+			std::int32_t GetXRel() const noexcept;
+			std::int32_t GetYRel() const noexcept;
+
+			inline bool IsMouseMoving() const noexcept { return GetXRel() || GetYRel(); }
+			MLX_FORCEINLINE bool IsRunning() const noexcept { return m_run; }
+			MLX_FORCEINLINE constexpr void Finish() noexcept { m_run = false; }
+			MLX_FORCEINLINE constexpr void Run() noexcept { m_run = true; }
+
+			inline void OnEvent(std::uint32_t id, int event, void(*f)(int, void*), void* param) noexcept
+			{
+				m_events_hooks[id][event].emplace_back(f, param);
+			}
+
+			~Inputs() = default;
+
+		private:
+			std::unordered_map<std::uint32_t, std::shared_ptr<Window>> m_windows;
+			std::unordered_map<std::uint32_t, std::array<std::vector<Hook>, 6>> m_events_hooks;
+			bool m_run = false;
+	};
+}
+
+#endif

runtime/Includes/Platform/Window.h

@@ -0,0 +1,54 @@
+#ifndef __MLX_WINDOW__
+#define __MLX_WINDOW__
+
+#include <mlx.h>
+#include <Maths/Vec2.h>
+#include <Core/SDLManager.h>
+
+namespace mlx
+{
+	class Window
+	{
+		public:
+			Window(const mlx_window_create_info* info, bool hidden = false);
+
+			MLX_FORCEINLINE Handle GetWindowHandle() const noexcept { return p_window; }
+			MLX_FORCEINLINE int GetWidth() noexcept { SDLManager::Get().GetWindowSize(p_window, &m_width, &m_height); return m_width; }
+			MLX_FORCEINLINE int GetHeight() noexcept { SDLManager::Get().GetWindowSize(p_window, &m_width, &m_height); return m_height; }
+			MLX_FORCEINLINE std::uint32_t GetID() const noexcept { return m_id; }
+			MLX_FORCEINLINE const std::string& GetName() const { return m_name; }
+
+			MLX_FORCEINLINE void MoveMouse(int x, int y) { SDLManager::Get().MoveMouseOnWindow(p_window, x, y); }
+			MLX_FORCEINLINE void GetScreenSizeWindowIsOn(int* x, int* y) { SDLManager::Get().GetScreenSizeWindowIsOn(p_window, x, y); }
+
+			MLX_FORCEINLINE void SetPosition(int x, int y) { SDLManager::Get().SetWindowPosition(p_window, x, y); }
+			MLX_FORCEINLINE void SetSize(int x, int y) { SDLManager::Get().SetWindowSize(p_window, x, y); m_width = x; m_height = y; }
+			MLX_FORCEINLINE void SetTitle(std::string title) { SDLManager::Get().SetWindowTitle(p_window, title); m_name = std::move(title); }
+			MLX_FORCEINLINE void SetFullscreen(bool enable) { SDLManager::Get().SetWindowFullscreen(p_window, enable); }
+			MLX_FORCEINLINE void SetMaxSize(int x, int y) { SDLManager::Get().SetWindowMaxSize(p_window, x, y); }
+			MLX_FORCEINLINE void SetMinSize(int x, int y) { SDLManager::Get().SetWindowMinSize(p_window, x, y); }
+			MLX_FORCEINLINE void Maximize() { SDLManager::Get().MaximizeWindow(p_window); }
+			MLX_FORCEINLINE void Minimize() { SDLManager::Get().MinimizeWindow(p_window); }
+			MLX_FORCEINLINE void Restore() { SDLManager::Get().RestoreWindow(p_window); }
+
+			MLX_FORCEINLINE void GetPosition(int* x, int* y) { SDLManager::Get().GetWindowPosition(p_window, x, y); }
+			MLX_FORCEINLINE void GetSize(int* x, int* y) { *x = GetWidth(); *y = GetHeight(); }
+
+			MLX_FORCEINLINE VkSurfaceKHR CreateVulkanSurface(VkInstance instance) const noexcept { return SDLManager::Get().CreateVulkanSurface(p_window, instance); }
+			MLX_FORCEINLINE std::vector<const char*> GetRequiredVulkanInstanceExtentions() const noexcept { return SDLManager::Get().GetRequiredVulkanInstanceExtentions(p_window); }
+			MLX_FORCEINLINE Vec2ui GetVulkanDrawableSize() const noexcept { return SDLManager::Get().GetVulkanDrawableSize(p_window); }
+
+			void Destroy() noexcept;
+
+			~Window() { Destroy(); }
+
+		private:
+			std::string m_name;
+			Handle p_window = nullptr;
+			std::int32_t m_id;
+			int m_width = 0;
+			int m_height = 0;
+	};
+}
+
+#endif

runtime/Includes/PreCompiled.h

@@ -0,0 +1,121 @@
+#ifndef __MLX_PRE_COMPILED_HEADER__
+#define __MLX_PRE_COMPILED_HEADER__
+
+#define VK_NO_PROTOTYPES
+
+#include <mlx_profile.h>
+#include <mlx.h>
+
+#include <cstdio>
+#include <cstdarg>
+#include <iostream>
+#include <cstddef>
+#include <cstdint>
+#include <cstdlib>
+#include <cstring>
+#include <ctime>
+
+#include <vulkan/vulkan.h>
+
+#include <SDL2/SDL.h>
+#include <SDL2/SDL_vulkan.h>
+
+#include <functional>
+#include <memory>
+#include <list>
+#include <map>
+#include <unordered_map>
+#include <utility>
+#include <fstream>
+#include <filesystem>
+#include <thread>
+#include <mutex>
+#include <string>
+#include <string_view>
+#include <chrono>
+#include <unordered_set>
+#include <array>
+#include <optional>
+#include <set>
+#include <random>
+#include <concepts>
+#include <algorithm>
+#include <sstream>
+#include <iomanip>
+#include <iterator>
+#include <stb_truetype.h>
+#include <variant>
+#include <bit>
+#include <type_traits>
+#include <string_view>
+#include <sstream>
+#include <ostream>
+#include <ranges>
+
+// Experimentals
+#if __has_include(<format>)
+	#include <format>
+#elif __has_include(<experimental/format>)
+	#include <experimental/format>
+#else
+	#error <format> header not present in this STL
+#endif
+
+#ifndef MLX_PLAT_WINDOWS
+	#include <dlfcn.h>
+#endif
+
+#ifdef MLX_PLAT_LINUX
+	#include <math.h> // sincos
+#endif
+
+#include <Core/Memory.h>
+#include <Core/Logs.h>
+
+#define VMA_STATIC_VULKAN_FUNCTIONS 0
+#define VMA_DYNAMIC_VULKAN_FUNCTIONS 0
+#define VMA_VULKAN_VERSION 1000000
+#define VMA_SYSTEM_ALIGNED_MALLOC(size, alignment) (mlx::MemManager::AlignedMalloc(alignment, size))
+#define VMA_SYSTEM_ALIGNED_FREE(ptr) (mlx::MemManager::Free(ptr))
+//#define VMA_ASSERT(expr) (mlx::Assert(expr, "VMA Assertion: " #expr))
+#define VMA_ASSERT(expr) ((void)0)
+#define VMA_ASSERT_LEAK(expr) ((void)0) // Because why not
+
+#ifdef MLX_COMPILER_CLANG
+	#pragma clang diagnostic push
+	#pragma clang diagnostic ignored "-Weverything"
+		#include <vma.h>
+	#pragma clang diagnostic pop
+#elif defined(MLX_COMPILER_GCC)
+	#pragma GCC diagnostic push
+	#pragma GCC diagnostic ignored "-Wimplicit-fallthrough"
+	#pragma GCC diagnostic ignored "-Wmissing-field-initializers"
+	#pragma GCC diagnostic ignored "-Wunused-parameter"
+	#pragma GCC diagnostic ignored "-Wunused-variable"
+	#pragma GCC diagnostic ignored "-Wunused-function"
+	#pragma GCC diagnostic ignored "-Wparentheses"
+		#include <vma.h>
+	#pragma GCC diagnostic pop
+#else
+	#include <vma.h>
+#endif
+
+#include <Utils/AntiX11.h>
+#include <Utils/AntiWindows.h>
+
+#define KVF_IMPL_VK_NO_PROTOTYPES
+#ifdef DEBUG
+	#define KVF_ENABLE_VALIDATION_LAYERS
+#endif
+#include <kvf.h>
+
+#include <Core/EventBus.h>
+#include <Core/Profiler.h>
+#include <Utils/NonOwningPtr.h>
+#include <Utils/NonCopyable.h>
+
+constexpr const int RANGE = 1024;
+
+using Handle = void*;
+
+#endif

runtime/Includes/Renderer/Buffer.h

@@ -0,0 +1,87 @@
+#ifndef __MLX_GPU_BUFFER__
+#define __MLX_GPU_BUFFER__
+
+#include <Renderer/Enums.h>
+#include <Renderer/RenderCore.h>
+#include <Utils/Buffer.h>
+
+namespace mlx
+{
+	class GPUBuffer
+	{
+		public:
+			GPUBuffer() = default;
+
+			void Init(BufferType type, VkDeviceSize size, VkBufferUsageFlags usage, CPUBuffer data, [[maybe_unused]] std::string_view debug_name);
+			void Destroy() noexcept;
+
+			bool CopyFrom(const GPUBuffer& buffer) noexcept;
+
+			void Swap(GPUBuffer& buffer) noexcept;
+
+			template<typename T = void*>
+			[[nodiscard]] MLX_FORCEINLINE T GetMap() const noexcept { return reinterpret_cast<T>(p_map); }
+			[[nodiscard]] MLX_FORCEINLINE VkBuffer Get() const noexcept { return m_buffer; }
+			[[nodiscard]] MLX_FORCEINLINE VmaAllocation GetAllocation() const noexcept { return m_allocation; }
+			[[nodiscard]] MLX_FORCEINLINE VkDeviceSize GetSize() const noexcept { return m_size; }
+			[[nodiscard]] MLX_FORCEINLINE VkDeviceSize GetOffset() const noexcept { return m_offset; }
+
+			[[nodiscard]] inline bool IsInit() const noexcept { return m_buffer != VK_NULL_HANDLE; }
+
+			~GPUBuffer() = default;
+
+		protected:
+			void PushToGPU() noexcept;
+
+		protected:
+			#ifdef DEBUG
+				std::string m_debug_name;
+			#endif
+			VkBuffer m_buffer = VK_NULL_HANDLE;
+			VmaAllocation m_allocation;
+			VkDeviceSize m_offset = 0;
+			VkDeviceSize m_size = 0;
+			void* p_map = nullptr;
+
+		private:
+			void CreateBuffer(VkDeviceSize size, VkBufferUsageFlags usage, VmaAllocationCreateInfo alloc_info, [[maybe_unused]] std::string_view debug_name);
+
+		private:
+			VkBufferUsageFlags m_usage = 0;
+	};
+
+	class VertexBuffer : public GPUBuffer
+	{
+		public:
+			inline void Init(std::uint32_t size, VkBufferUsageFlags additional_flags, [[maybe_unused]] std::string_view debug_name) { GPUBuffer::Init(BufferType::LowDynamic, size, VK_BUFFER_USAGE_VERTEX_BUFFER_BIT | additional_flags, {}, std::move(debug_name)); }
+			void SetData(CPUBuffer data);
+			inline void Bind(VkCommandBuffer cmd) const noexcept { VkDeviceSize offset = 0; RenderCore::Get().vkCmdBindVertexBuffers(cmd, 0, 1, &m_buffer, &offset); }
+	};
+
+	class IndexBuffer : public GPUBuffer
+	{
+		public:
+			inline void Init(std::uint32_t size, VkBufferUsageFlags additional_flags, [[maybe_unused]] std::string_view debug_name) { GPUBuffer::Init(BufferType::LowDynamic, size, VK_BUFFER_USAGE_INDEX_BUFFER_BIT | additional_flags, {}, std::move(debug_name)); }
+			void SetData(CPUBuffer data);
+			inline void Bind(VkCommandBuffer cmd) const noexcept { RenderCore::Get().vkCmdBindIndexBuffer(cmd, m_buffer, 0, VK_INDEX_TYPE_UINT32); }
+	};
+
+	class UniformBuffer
+	{
+		public:
+			void Init(std::uint32_t size, [[maybe_unused]] std::string_view debug_name);
+			void SetData(CPUBuffer data, std::size_t frame_index);
+			void Destroy() noexcept;
+
+			inline VkDeviceSize GetSize(int i) const noexcept { return m_buffers[i].GetSize(); }
+			inline VkDeviceSize GetOffset(int i) const noexcept { return m_buffers[i].GetOffset(); }
+			inline VkBuffer GetVk(int i) const noexcept { return m_buffers[i].Get(); }
+			inline GPUBuffer& Get(int i) noexcept { return m_buffers[i]; }
+
+		private:
+			std::array<GPUBuffer, MAX_FRAMES_IN_FLIGHT> m_buffers;
+			std::array<void*, MAX_FRAMES_IN_FLIGHT> m_maps;
+	};
+}
+
+#endif

runtime/Includes/Renderer/Descriptor.h

@@ -0,0 +1,89 @@
+#ifndef __MLX_DESCRIPTOR_SET__
+#define __MLX_DESCRIPTOR_SET__
+
+#include <Renderer/Enums.h>
+#include <Renderer/RenderCore.h>
+#include <Renderer/Pipelines/Shader.h>
+
+namespace mlx
+{
+	struct Descriptor
+	{
+		NonOwningPtr<class GPUBuffer> storage_buffer_ptr;
+		NonOwningPtr<class GPUBuffer> uniform_buffer_ptr;
+		NonOwningPtr<class Image> image_ptr;
+		VkDescriptorType type;
+		std::uint32_t binding;
+	};
+
+	class DescriptorPool
+	{
+		public:
+			DescriptorPool() = default;
+
+			void Init() noexcept;
+			void Destroy() noexcept;
+
+			std::shared_ptr<class DescriptorSet> RequestDescriptorSet(const ShaderSetLayout& layout, ShaderType shader_type);
+			void ReturnDescriptorSet(std::shared_ptr<class DescriptorSet> set);
+
+			[[nodiscard]] inline VkDescriptorPool Get() const noexcept { return m_pool; }
+			[[nodiscard]] MLX_FORCEINLINE std::size_t GetNumberOfSetsAllocated() const noexcept { return m_allocation_count; }
+
+			~DescriptorPool() = default;
+
+		private:
+			std::vector<std::shared_ptr<class DescriptorSet>> m_free_sets;
+			std::vector<std::shared_ptr<class DescriptorSet>> m_used_sets;
+			VkDescriptorPool m_pool;
+			std::size_t m_allocation_count = 0;
+	};
+
+	class DescriptorPoolManager
+	{
+		public:
+			DescriptorPoolManager() = default;
+
+			DescriptorPool& GetAvailablePool();
+			void Destroy();
+
+			~DescriptorPoolManager() = default;
+
+		private:
+			std::vector<DescriptorPool> m_pools;
+	};
+
+	class DescriptorSet : public std::enable_shared_from_this<DescriptorSet>
+	{
+		friend DescriptorPool;
+
+		public:
+			void SetImage(std::size_t i, std::uint32_t binding, class Image& image);
+			void SetStorageBuffer(std::size_t i, std::uint32_t binding, class GPUBuffer& buffer);
+			void SetUniformBuffer(std::size_t i, std::uint32_t binding, class GPUBuffer& buffer);
+			void Update(std::size_t i, VkCommandBuffer cmd = VK_NULL_HANDLE) noexcept;
+
+			void ReturnDescriptorSetToPool();
+
+			[[nodiscard]] inline VkDescriptorSet GetSet(std::size_t i) const noexcept { return m_sets[i]; }
+			[[nodiscard]] MLX_FORCEINLINE bool IsInit() const noexcept { return m_sets[0] != VK_NULL_HANDLE; }
+			[[nodiscard]] MLX_FORCEINLINE VkDescriptorSetLayout GetVulkanLayout() const noexcept { return m_set_layout; }
+			[[nodiscard]] MLX_FORCEINLINE const ShaderSetLayout& GetShaderLayout() const { return m_shader_layout; }
+			[[nodiscard]] MLX_FORCEINLINE ShaderType GetShaderType() const noexcept { return m_shader_type; }
+
+			~DescriptorSet() = default;
+
+		private:
+			DescriptorSet(DescriptorPool& pool, VkDescriptorSetLayout vulkan_layout, const ShaderSetLayout& layout, std::array<VkDescriptorSet, MAX_FRAMES_IN_FLIGHT> vulkan_sets, ShaderType shader_type);
+
+		private:
+			ShaderSetLayout m_shader_layout;
+			std::vector<Descriptor> m_descriptors;
+			std::array<VkDescriptorSet, MAX_FRAMES_IN_FLIGHT> m_sets;
+			VkDescriptorSetLayout m_set_layout;
+			ShaderType m_shader_type;
+			DescriptorPool& m_pool;
+	};
+}
+
+#endif

runtime/Includes/Renderer/Enums.h

@@ -0,0 +1,32 @@
+#ifndef __MLX_RENDERER_ENUMS__
+#define __MLX_RENDERER_ENUMS__
+
+namespace mlx
+{
+	enum class BufferType
+	{
+		Constant = 0,
+		Staging,
+		HighDynamic, // typically stored in RAM
+		LowDynamic,  // typically stored in VRAM
+
+		EndEnum
+	};
+	constexpr std::size_t BufferTypeCount = static_cast<std::size_t>(BufferType::EndEnum);
+
+	enum class ImageType
+	{
+		Color = 0,
+
+		EndEnum
+	};
+	constexpr std::size_t ImageTypeCount = static_cast<std::size_t>(ImageType::EndEnum);
+
+	enum class ShaderType
+	{
+		Vertex,
+		Fragment
+	};
+}
+
+#endif

runtime/Includes/Renderer/Image.h

@@ -0,0 +1,108 @@
+#ifndef __MLX_IMAGE__
+#define __MLX_IMAGE__
+
+#include <Maths/Vec4.h>
+#include <Renderer/RenderCore.h>
+#include <Renderer/Buffer.h>
+#include <Utils/Buffer.h>
+#include <Renderer/Enums.h>
+
+namespace mlx
+{
+	class Image
+	{
+		public:
+			Image() = default;
+
+			inline void Init(VkImage image, VkFormat format, std::uint32_t width, std::uint32_t height, VkImageLayout layout, [[maybe_unused]] std::string_view debug_name) noexcept
+			{
+				m_image = image;
+				m_format = format;
+				m_width = width;
+				m_height = height;
+				m_layout = layout;
+				#ifdef DEBUG
+					m_debug_name = std::move(debug_name);
+				#endif
+			}
+
+			void Init(ImageType type, std::uint32_t width, std::uint32_t height, VkFormat format, VkImageTiling tiling, VkImageUsageFlags usage, bool is_multisampled, std::string_view debug_name);
+			void CreateImageView(VkImageViewType type, VkImageAspectFlags aspectFlags, int layer_count = 1) noexcept;
+			void CreateSampler() noexcept;
+			void TransitionLayout(VkImageLayout new_layout, VkCommandBuffer cmd = VK_NULL_HANDLE);
+			virtual void Clear(VkCommandBuffer cmd, Vec4f color);
+
+			void DestroySampler() noexcept;
+			void DestroyImageView() noexcept;
+			virtual void Destroy() noexcept;
+
+			[[nodiscard]] MLX_FORCEINLINE VkImage Get() const noexcept { return m_image; }
+			[[nodiscard]] MLX_FORCEINLINE VmaAllocation GetAllocation() const noexcept { return m_allocation; }
+			[[nodiscard]] MLX_FORCEINLINE VkImageView GetImageView() const noexcept { return m_image_view; }
+			[[nodiscard]] MLX_FORCEINLINE VkFormat GetFormat() const noexcept { return m_format; }
+			[[nodiscard]] MLX_FORCEINLINE VkImageTiling GetTiling() const noexcept { return m_tiling; }
+			[[nodiscard]] MLX_FORCEINLINE VkImageLayout GetLayout() const noexcept { return m_layout; }
+			[[nodiscard]] MLX_FORCEINLINE VkSampler GetSampler() const noexcept { return m_sampler; }
+			[[nodiscard]] MLX_FORCEINLINE std::uint32_t GetWidth() const noexcept { return m_width; }
+			[[nodiscard]] MLX_FORCEINLINE std::uint32_t GetHeight() const noexcept { return m_height; }
+			[[nodiscard]] MLX_FORCEINLINE bool IsInit() const noexcept { return m_image != VK_NULL_HANDLE; }
+			[[nodiscard]] MLX_FORCEINLINE ImageType GetType() const noexcept { return m_type; }
+
+			#ifdef DEBUG
+				[[nodiscard]] MLX_FORCEINLINE const std::string& GetDebugName() const { return m_debug_name; }
+			#endif
+
+			virtual ~Image() = default;
+
+		protected:
+			#ifdef DEBUG
+				std::string m_debug_name;
+			#endif
+			VmaAllocation m_allocation;
+			VkImage m_image = VK_NULL_HANDLE;
+			VkImageView m_image_view = VK_NULL_HANDLE;
+			VkSampler m_sampler = VK_NULL_HANDLE;
+			VkFormat m_format;
+			VkImageTiling m_tiling;
+			VkImageLayout m_layout = VK_IMAGE_LAYOUT_UNDEFINED;
+			ImageType m_type;
+			std::uint32_t m_width = 0;
+			std::uint32_t m_height = 0;
+			bool m_is_multisampled = false;
+	};
+
+	class Texture: public Image
+	{
+		public:
+			Texture() = default;
+			Texture(CPUBuffer pixels, std::uint32_t width, std::uint32_t height, VkFormat format, bool is_multisampled, [[maybe_unused]] std::string_view debug_name)
+			{
+				Init(std::move(pixels), width, height, format, is_multisampled, std::move(debug_name));
+			}
+
+			void Init(CPUBuffer pixels, std::uint32_t width, std::uint32_t height, VkFormat format, bool is_multisampled, [[maybe_unused]] std::string_view debug_name);
+			void Destroy() noexcept override;
+
+			void SetPixel(int x, int y, mlx_color color) noexcept;
+			void SetRegion(int x, int y, int w, int h, mlx_color* color) noexcept;
+			void SetLinearRegion(int x, int y, std::size_t len, mlx_color* color) noexcept;
+			mlx_color GetPixel(int x, int y) noexcept;
+			void GetRegion(int x, int y, int w, int h, mlx_color* dst) noexcept;
+			void Clear(VkCommandBuffer cmd, Vec4f color) override;
+
+			void Update(VkCommandBuffer cmd);
+
+			~Texture() override { Destroy(); }
+
+		private:
+			void OpenCPUBuffer();
+
+		private:
+			std::optional<GPUBuffer> m_staging_buffer;
+			bool m_has_been_modified = false;
+	};
+
+	Texture* StbTextureLoad(const std::filesystem::path& file, int* w, int* h);
+}
+
+#endif

runtime/Includes/Renderer/Memory.h

@@ -0,0 +1,36 @@
+#ifndef __MLX_VK_MEMORY__
+#define __MLX_VK_MEMORY__
+
+namespace mlx
+{
+	class GPUAllocator
+	{
+		public:
+			GPUAllocator() = default;
+
+			void Init(const VkAllocationCallbacks* callbacks) noexcept;
+			void Destroy() noexcept;
+
+			VmaAllocation CreateBuffer(const VkBufferCreateInfo* binfo, const VmaAllocationCreateInfo* vinfo, VkBuffer& buffer, const char* name = nullptr) noexcept;
+			void DestroyBuffer(VmaAllocation allocation, VkBuffer buffer, const char* name) noexcept;
+
+			VmaAllocation CreateImage(const VkImageCreateInfo* iminfo, const VmaAllocationCreateInfo* vinfo, VkImage& image, const char* name = nullptr) noexcept;
+			void DestroyImage(VmaAllocation allocation, VkImage image, const char* name) noexcept;
+
+			void MapMemory(VmaAllocation allocation, void** data) noexcept;
+			void UnmapMemory(VmaAllocation allocation) noexcept;
+
+			void DumpMemoryToJson();
+
+			void Flush(VmaAllocation allocation, VkDeviceSize size, VkDeviceSize offset) noexcept;
+
+			~GPUAllocator() = default;
+
+		private:
+			VmaAllocator m_allocator;
+			std::int32_t m_active_buffers_allocations = 0;
+			std::int32_t m_active_images_allocations = 0;
+	};
+}
+
+#endif

runtime/Includes/Renderer/Pipelines/Graphics.h

@@ -0,0 +1,60 @@
+#ifndef __MLX_GRAPHICS_PIPELINE__
+#define __MLX_GRAPHICS_PIPELINE__
+
+#include <Renderer/Image.h>
+#include <Utils/NonOwningPtr.h>
+#include <Renderer/Pipelines/Shader.h>
+#include <Renderer/Pipelines/Pipeline.h>
+
+namespace mlx
+{
+	struct GraphicPipelineDescriptor
+	{
+		std::shared_ptr<Shader> vertex_shader;
+		std::shared_ptr<Shader> fragment_shader;
+		std::vector<NonOwningPtr<Texture>> color_attachments;
+		NonOwningPtr<class Renderer> renderer = nullptr;
+		bool clear_color_attachments = true;
+		bool no_vertex_inputs = false;
+	};
+
+	class GraphicPipeline : public Pipeline
+	{
+		public:
+			GraphicPipeline() = default;
+
+			void Init(const GraphicPipelineDescriptor& descriptor, std::string_view debug_name);
+			bool BindPipeline(VkCommandBuffer cmd, std::size_t framebuffer_index, std::array<float, 4> clear) noexcept;
+			void EndPipeline(VkCommandBuffer cmd) noexcept override;
+			void Destroy() noexcept;
+
+			[[nodiscard]] inline VkPipeline GetPipeline() const override { return m_pipeline; }
+			[[nodiscard]] inline VkPipelineLayout GetPipelineLayout() const override { return m_pipeline_layout; }
+			[[nodiscard]] inline VkPipelineBindPoint GetPipelineBindPoint() const override { return VK_PIPELINE_BIND_POINT_GRAPHICS; }
+
+			~GraphicPipeline() = default;
+
+		private:
+			void CreateFramebuffers(const std::vector<NonOwningPtr<Texture>>& render_targets, bool clear_attachments);
+			void TransitionAttachments(VkCommandBuffer cmd = VK_NULL_HANDLE);
+
+			// Private override to remove access
+			bool BindPipeline(VkCommandBuffer) noexcept override { return false; };
+
+		private:
+			std::vector<NonOwningPtr<Texture>> m_attachments;
+			std::vector<VkFramebuffer> m_framebuffers;
+			std::vector<VkClearValue> m_clears;
+			#ifdef DEBUG
+				std::string m_debug_name;
+			#endif
+			std::shared_ptr<Shader> p_vertex_shader;
+			std::shared_ptr<Shader> p_fragment_shader;
+			VkRenderPass m_renderpass = VK_NULL_HANDLE;
+			VkPipeline m_pipeline = VK_NULL_HANDLE;
+			VkPipelineLayout m_pipeline_layout = VK_NULL_HANDLE;
+			NonOwningPtr<class Renderer> p_renderer;
+	};
+}
+
+#endif

runtime/Includes/Renderer/Pipelines/Pipeline.h

@@ -0,0 +1,22 @@
+#ifndef __MLX_PIPELINE__
+#define __MLX_PIPELINE__
+
+namespace mlx
+{
+	class Pipeline
+	{
+		public:
+			Pipeline() = default;
+
+			inline virtual bool BindPipeline(VkCommandBuffer command_buffer) noexcept { RenderCore::Get().vkCmdBindPipeline(command_buffer, GetPipelineBindPoint(), GetPipeline()); return true; }
+			inline virtual void EndPipeline([[maybe_unused]] VkCommandBuffer command_buffer) noexcept {}
+
+			virtual VkPipeline GetPipeline() const = 0;
+			virtual VkPipelineLayout GetPipelineLayout() const = 0;
+			virtual VkPipelineBindPoint GetPipelineBindPoint() const = 0;
+
+			virtual ~Pipeline() = default;
+	};
+}
+
+#endif

runtime/Includes/Renderer/Pipelines/Shader.h

@@ -0,0 +1,65 @@
+#ifndef __MLX_SHADER__
+#define __MLX_SHADER__
+
+#include <Renderer/Enums.h>
+
+namespace mlx
+{
+	struct ShaderSetLayout
+	{
+		std::vector<std::pair<int, VkDescriptorType>> binds;
+
+		ShaderSetLayout(std::vector<std::pair<int, VkDescriptorType> > b) : binds(std::move(b)) {}
+
+		inline bool operator==(const ShaderSetLayout& rhs) const { return binds == rhs.binds; }
+	};
+
+	struct ShaderPushConstantLayout
+	{
+		std::size_t offset;
+		std::size_t size;
+
+		ShaderPushConstantLayout(std::size_t o, std::size_t s) : offset(o), size(s) {}
+	};
+
+	struct ShaderLayout
+	{
+		std::vector<std::pair<int, ShaderSetLayout>> set_layouts;
+		std::vector<ShaderPushConstantLayout> push_constants;
+
+		ShaderLayout(std::vector<std::pair<int, ShaderSetLayout> > s, std::vector<ShaderPushConstantLayout> pc) : set_layouts(std::move(s)), push_constants(std::move(pc)) {}
+	};
+
+	struct ShaderPipelineLayoutPart
+	{
+		std::vector<VkPushConstantRange> push_constants;
+		std::vector<VkDescriptorSetLayout> set_layouts;
+	};
+
+	class Shader
+	{
+		public:
+			Shader(const std::vector<std::uint8_t>& bytecode, ShaderType type, ShaderLayout layout);
+
+			[[nodiscard]] inline const ShaderLayout& GetShaderLayout() const { return m_layout; }
+			[[nodiscard]] inline const std::vector<std::uint8_t>& GetByteCode() const noexcept { return m_bytecode; }
+			[[nodiscard]] inline const ShaderPipelineLayoutPart& GetPipelineLayout() const noexcept { return m_pipeline_layout_part; }
+			[[nodiscard]] inline VkShaderModule GetShaderModule() const noexcept { return m_module; }
+			[[nodiscard]] inline VkShaderStageFlagBits GetShaderStage() const noexcept { return m_stage; }
+
+			~Shader();
+
+		private:
+			void GeneratePipelineLayout(ShaderLayout layout);
+
+		private:
+			ShaderLayout m_layout;
+			ShaderPipelineLayoutPart m_pipeline_layout_part;
+			std::vector<std::uint8_t> m_bytecode;
+			std::vector<VkDescriptorSetLayout> m_set_layouts;
+			VkShaderStageFlagBits m_stage;
+			VkShaderModule m_module = VK_NULL_HANDLE;
+	};
+}
+
+#endif

runtime/Includes/Renderer/RenderCore.h

@@ -0,0 +1,58 @@
+#ifndef __MLX_RENDER_CORE__
+#define __MLX_RENDER_CORE__
+
+constexpr const int MAX_FRAMES_IN_FLIGHT = 2;
+
+#include <Renderer/Memory.h>
+#include <Renderer/Descriptor.h>
+
+namespace mlx
+{
+	#if defined(DEBUG) && defined(VK_EXT_debug_utils)
+		#define MLX_HAS_DEBUG_UTILS_FUNCTIONS
+	#endif
+
+	class RenderCore
+	{
+		public:
+			RenderCore();
+
+			[[nodiscard]] MLX_FORCEINLINE VkInstance GetInstance() const noexcept { return m_instance; }
+			[[nodiscard]] MLX_FORCEINLINE VkInstance& GetInstanceRef() noexcept { return m_instance; }
+			[[nodiscard]] MLX_FORCEINLINE VkDevice GetDevice() const noexcept { return m_device; }
+			[[nodiscard]] MLX_FORCEINLINE VkPhysicalDevice GetPhysicalDevice() const noexcept { return m_physical_device; }
+			[[nodiscard]] MLX_FORCEINLINE GPUAllocator& GetAllocator() noexcept { return m_allocator; }
+			[[nodiscard]] inline DescriptorPoolManager& GetDescriptorPoolManager() noexcept { return m_descriptor_pool_manager; }
+
+			inline void WaitDeviceIdle() const noexcept { vkDeviceWaitIdle(m_device); }
+
+			inline static bool IsInit() noexcept { return s_instance != nullptr; }
+			inline static RenderCore& Get() noexcept { return *s_instance; }
+
+			#define MLX_VULKAN_GLOBAL_FUNCTION(fn) PFN_##fn fn = nullptr;
+			#define MLX_VULKAN_INSTANCE_FUNCTION(fn) PFN_##fn fn = nullptr;
+			#define MLX_VULKAN_DEVICE_FUNCTION(fn) PFN_##fn fn = nullptr;
+				#include <Renderer/Vulkan/VulkanDefs.h>
+			#undef MLX_VULKAN_GLOBAL_FUNCTION
+			#undef MLX_VULKAN_INSTANCE_FUNCTION
+			#undef MLX_VULKAN_DEVICE_FUNCTION
+
+			~RenderCore();
+
+		private:
+			void LoadKVFGlobalVulkanFunctionPointers() const noexcept;
+			void LoadKVFInstanceVulkanFunctionPointers() const noexcept;
+			void LoadKVFDeviceVulkanFunctionPointers() const noexcept;
+
+		private:
+			static RenderCore* s_instance;
+
+			DescriptorPoolManager m_descriptor_pool_manager;
+			GPUAllocator m_allocator;
+			VkInstance m_instance = VK_NULL_HANDLE;
+			VkDevice m_device = VK_NULL_HANDLE;
+			VkPhysicalDevice m_physical_device = VK_NULL_HANDLE;
+	};
+}
+
+#endif

runtime/Includes/Renderer/RenderPasses/2DPass.h

@@ -0,0 +1,29 @@
+#ifndef __MLX_2D_PASS__
+#define __MLX_2D_PASS__
+
+#include <Renderer/RenderCore.h>
+#include <Renderer/Pipelines/Shader.h>
+#include <Renderer/Pipelines/Graphics.h>
+
+namespace mlx
+{
+	class Render2DPass
+	{
+		public:
+			Render2DPass() = default;
+			void Init();
+			void Pass(class Scene& scene, class Renderer& renderer, class Texture& render_target);
+			void Destroy();
+			~Render2DPass() = default;
+
+		private:
+			GraphicPipeline m_pipeline;
+			std::shared_ptr<DescriptorSet> p_viewer_data_set;
+			std::shared_ptr<UniformBuffer> p_viewer_data_buffer;
+			std::shared_ptr<DescriptorSet> p_texture_set;
+			std::shared_ptr<Shader> p_vertex_shader;
+			std::shared_ptr<Shader> p_fragment_shader;
+	};
+}
+
+#endif