Eclmist / SMath

A simple open-source math library for graphics applications

SMath

A C++20 header-only math library for graphics applications.

Introduction

SMath is a simple open-source C++20 math library for graphics applications.

SMath is used by both realtime and offline renderers:

• Ether - A realtime DirectX12 rendering engine
• Spectre - A physically based spectral raytracing library

Requirements

• Only CMake versions 3.8 and up is supported (for included CMakeList and unit test project)
• If compiling with GCC, use GCC10 and above
• C++20

Getting Started

Add all files in src into any C++20 project and include src/smath.h to get started.

The following are the currently available types, which can be typedef'd to your liking:

typedef SMath::Vector<double, 2>    Vector2;
typedef SMath::Vector<double, 3>    Vector3;
typedef SMath::Vector<double, 4>    Vector4;
typedef SMath::Vector<int, 2>       Vector2i;
typedef SMath::Vector<int, 3>       Vector3i;
typedef SMath::Point<double, 2>     Point2;
typedef SMath::Point<double, 3>     Point3;
typedef SMath::Point<int, 2>        Point2i;
typedef SMath::Point<int, 3>        Point3i;
typedef SMath::Normal<double, 3>    Normal3;
typedef SMath::Matrix<double, 3>    Matrix3x3;
typedef SMath::Matrix<double, 4>    Matrix4x4;
typedef SMath::Matrix<int, 3>       Matrix3x3i;
typedef SMath::Matrix<int, 4>       Matrix4x4i;

typedef SMath::Ray                  Ray;
typedef SMath::Rect                 Rect;
typedef SMath::Transform            Transform;

Usage

SMath is developed with Test Driven Development (TDD). As such, you can find all usages of basically every functionality in their respective unit tests.