zeroGL

A zero-dependencies, single-header 3D graphics library

Features

• Single-header library written in C with no external dependencies
• Programmable shaders
• Perspective-correct texture support
• Point/Ambient/Directional lighting
• Materials with specular and diffuse properties
• Camera and backface culling
• z-Buffering
• Load OBJ/MTL files (in separate library)

Getting started

To run the demo, download the latest .zip file from the releases page, uncompress it and run

Building the project

All systems using Zig

The project comes with a distribution for sdl2 under external/ . On other systems, just install SDL v2.28.2 (using apt or brew) and find the compiled libraries using sdl2-config --libs . To compile, just install zig (it's basically downloading a binary and adding it to your path) and then run:

Windows

> zig build-exe main.c external\upng\upng.c -O ReleaseFast --library c -I.\external\sdl2\include -Lexternal\sdl2\lib\x64 -lSDL2 -lSDL2main -femit-bin=target\main.exe

linux, macOS (replace /usr/local/lib with the path you found with sdl2-config --libs):

$ zig build-exe main.c external/upng/upng.c -O ReleaseFast --library c -I./external/sdl2/include -L/usr/local/lib -lSDL2main -lSDL2 -femit-bin=target/main

Windows

build.bat

Install Visual Studio Community 2022 (the C/C++ compilers may suffice) and then double-click the build.bat file. Alternatively, from the command-line run:

> build.bat

Using cl.exe

Install Visual Studio Community 2022 (the C/C++ compilers may suffice), then run:

> "c:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build\vcvarsall.bat" x86_amd64

> cl.exe /Zi /EHsc /O2 /nologo /Fotarget\obj\ /Fetarget\main.exe main.c external\upng\upng.c /I external\sdl2\include /link /LIBPATH:external\sdl2\lib\x64 SDL2.lib SDL2main.lib

Change the vcvarsall.bat path according to your VS installation.

Linux

On Linux sytems where SDL2 is installed, the exemple main program can also be built by running (again, replace /usr/local/lib with the path you found with sdl2-config --libs):

gcc main.c external/upng/upng.c -I./external/sdl2/include -L/usr/local/lib -lSDL2main -lSDL2 -lm -o target/main

VS Code

If you're using Visual Studio Code, then you can install Visual Studio Community 2022 (the C/C++ compilers may suffice) and also install the C/C++ extensions from Microsoft.

Open main.c on the editor and then click on Run C/C++ File on the top right corner. Remember to open VS Code from within a developer terminal (or run vcvarsall.bat on the terminal before opening VS Code from within it).

Current limitations

• No alpha compositing
• Diffuse colors on MTL files are used for as specular colors as well
• No multi-threading/SIMD
• Support only a subset of the OBJ specification