Skip to content
This repository has been archived by the owner on Sep 24, 2022. It is now read-only.
/ rw Public archive

A collection of code/utilities/libraries written from scratch for Windows/Mac/Linux

License

Notifications You must be signed in to change notification settings

raywan/rw

Repository files navigation

rw

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.

Table of Contents

Files

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

General Usage Instructions

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

TODO

  • 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

Inspirations

About

A collection of code/utilities/libraries written from scratch for Windows/Mac/Linux

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages