parg

This is a C99 library with some basic stuff for bootstrapping a graphics engine. Currently it is tested against OpenGL 2.1 on OS X, and WebGL 1.0 via Emscripten.

The par library is a required submodule, so be sure to do this after cloning the repo:

$ git submodule update --init

The API is divided into modules, each of which has a single C file:

• token string-to-uint32 hashing, and a lookup table for uint32-to-string.
• asset unified way of loading buffers, shaders, and textures.
• buffer an untyped blob of memory that can live on the CPU or GPU.
• mesh triangle meshes and utilities for procedural geometry.
• texture thin wrapper around OpenGL texture objects.
• uniform thin wrapper around OpenGL shader uniforms.
• state thin wrapper around miscellaneous portions of the OpenGL state machine.
• varray an association of buffers with vertex attributes.
• draw thin wrapper around OpenGL draw calls.
• zcam simple map-style camera with basic zoom & pan controls.

How to Build for macOS

brew update
brew install cmake uncrustify glfw clang-format pkg-config
mkdir build ; cd build ; cmake .. ; make -j

You can then run a demo like this:

./trefoil

How to Build for WebGL on macOS

brew update
brew install cmake uncrustify glfw clang-format pkg-config emscripten
python emsetup.py
source aliases.sh
initjs && build

You can then run a demo like this:

build/trefoil
[Push Esc to quit]
cd web
python -m SimpleHTTPServer
[Open localhost:8000 in a web browser]

I'm currently using:

• glfw 3.3
• emscripten 1.36.5