A collection of code/utilities/libraries that I have written from scratch, supporting Windows (MSCV), Mac and Linux (gcc or clang).
This repo contains code that I have already found or will find useful for my game development and graphics projects. Examples of projects being my Monte Carlo path tracer, OpenGL renderer and SDL2/OpenGL game engine. I found myself writing common code across all these projects so I decided to put it all in a single repo that all current (and future) projects can use. This repo will also continue to grow along with me. For anyone other than myself using this, all the code is considered to be for educational purposes and so I make no correctness nor optimality guarantees.
The design of these libraries and choices of which functions to implement are influenced by many great libraries I have seen and used (see Inspirations). Although I have taken influence from these sources, I have designed and coded my libraries to suit my needs and my tastes.
| File | Version | Description |
|---|---|---|
| rw_types.h | 0.2.0 | Defines or redefines common types |
| rw_math.h | 0.3.0 | Math library for games/graphics |
| rw_transform.h | 0.2.0 | Matrix transformation data structure and functions (pbrt inspired) |
| rw_time.h | 0.2.0 | High resolution timer (nanoseconds) and other related utilities |
| rw_memory.h | 0.2.0 | Custom memory allocation -- aligned_alloc, arena, etc. |
| rw_th.h | 0.1.0 | Multithreading/syncronization related functions |
All files are designed to be single(ish)-file headers. Usage is like Sean Barrett's
stb library. To reduce code repetition a little bit,
some libraries depend on others. For example, rw_transform.h depends on rw_math.h.
For specific usage instructions, please see the header block comment for the file of interest.
Generally, include the header file and define the library specific preprocessor value to include the implementation as well. Note that including just the header file, will NOT include the implementation.
For example,
#define RWNAMESPACE_IMPLEMENTATION
#include <rw_mylib.h>
Other options in place of RWNAMESPACE_IMPLEMENTATION are:
#define RWNAMESPACE_HEADER_ONLY
// OR
#define RWNAMESPACE_STATIC
Some libaries also have specific defines that can be included beforehand to
change some of the implementation details of the library.
For example (in rw_math.h),
// To use the fast inverse sqrt intrinsic, also include before
#define RWM_USE_MM_RSQRT
-
rw_bvh.h - Bounding Volume Hierachy (BVH). Move this in from path tracing project.
-
rw_buffer.h - Dynamic buffers, ring buffers etc. (Move this in from RTOS project)
-
rw_hashtable.h - Hashtable
-
rw_mesh.h - Migrate OBJ loader/mesh code from other projects here
-
rw_sort.h - Various sorting algorithms