A C++ maths library... you might find this useful for games and graphics dev, it has a lot of useful intersection, geometric test and conversion functions, vector swizzling, gjk implementation and other handy features.

There is a Live Demo via WebAssembly and WebGL.

Supported Compilers: MSVC 2017+, GCC 7.0+, Clang 6.0+, EMCC 2.0.

C++11 or later is required. Tested with C++20, C++17, C++14 and C++11.

The entire library is header only, add the maths directory to your include search path and simply include:

#include "maths.h" // intersection, geometric tests and conversion functions #include "util.h" // min, max, swap, smoothstep, scalar functions.. etc #include "vec.h" // vector of any dimension and type #include "mat.h" // matrix of any dimension and type #include "quat.h" // quaternion of any type void maths() { // templated by size and type Vec<3, float> float3; Vec<2, int> int3; Mat<4, 4, double> double4x4; Quat<float> q; // common abbreviations for convenience Vec<3, float> vec3f; Vec<2, float> vec2f; Mat<3, 3, float> mat3f; // + common sizes and types for 2, 3, 4 dimensions, float, doubles, ints // quick common constructors vec3f zero = vec3f::zero(); vec3f one = vec3f::one(); vec3f red = vec3f::red(); mat4f identity = mat4f::identity(); // ... and so on // arithmetic operators vec3f result_add = zero + one; vec3f result_mul = zero * one; result_add += red; mat4f mat_result = mata * matb; // etc // overloaded functions and operations that feel lightweight and expressive vec3f norm = normalize(va); f32 dp = dot(va, vb); vec3f cp = cross(va, vb); quat q = normalize(q2); quat qd = dot(q, q); // + more // shader style funcs with scalar variants vec3f lerp = lerp(va, vb, 0.5f); f32 lerp = lerp(fa, fb, 0.75f); vec3f sat = saturate(va); quat q = slerp(qa, qb, 0.25f); // yeah! // cmath functions for vectors and swizzles vec2f v2_sin = sin(result_add.xy); vec3f v3_cos = cos(result_mul); vec2f v2_floor = floor(v2); // ... you get it! // swizzles for that shader like feeling! vec4f swizz = v.wzyx; // construct from swizzle swizz = v.xxxx; // assign from swizzle swizz.wyxz = v.xxyy; // assign swizzle to swizzle vec2f v2 = swizz.yz; // construct truncated swizz.wx = v.xy; // assign truncated swizz.xyz *= swizz2.www; // arithmetic on swizzles vec2 v2 = swizz.xy * 2.0f; // swizzle / scalar arithmetic // sometimes you may need to cast from swizzle to vec if c++ cant apply implicit casts f32 dp = dot((vec2f)swizz.xz, (vec2f)swizz.yy): }

Plane Classification: point_vs_plane, aabb_vs_plane, sphere_vs_plane, capsule_vs_plane, cone_vs_plane.

Overlaps: sphere_vs_sphere, sphere_vs_aabb, sphere_vs_obb, aabb_vs_aabb, aabb_vs_frustum, sphere_vs_frustum, sphere_vs_capsule, capsule_vs_capsule, obb_vs_obb, aabb_vs_obb, convex_hull_vs_convex_hull, gjk_2d, gjk_3d.

Point Inside: point_inside_aabb, point_inside_sphere, point_inside_obb, point_inside_triangle, point_inside_cone, point_inside_convex_hull, point_inside_poly, point_inside_frustum.

Closest Point: closest_point_on_aabb, closest_point_on_line, closest_point_on_plane, closest_point_on_obb, closest_point_on_sphere, closest_point_on_ray, closest_point_on_triangle, closest_point_on_polygon, closest_point_on_convex_hull, closest_point_on_cone.

Point Distance: point_aabb_distance, point_segment_distance, point_triangle_distance, distance_on_line, point_plane_distance, plane_distance, point_sphere_distance, point_polygon_distance, point_convex_hull_distance, point_cone_distance, point_obb_distance.

Ray / Line: ray_vs_plane, ray_vs_triangle, ray_vs_sphere, ray_vs_line_segment, ray_vs_aabb, ray_vs_obb, ray_vs_capsule, ray_vs_cylinder, line_vs_line, line_vs_poly, shortest_line_segment_between_lines, shortest_line_segment_between_line_segments.

Shader Style Functions: dot, cross, normalize, mag, mag2, dist, dist2, triple, vector_triple, lerp, nlerp, slerp, saturate, clamp, normalize, chebyshev_normalize, all, any, min, max, min_union, max_union, smoothstep, step, round, floor, ceil, abs, frac, trunc, exp, exp2, log, log2, sin, cos, tan, asin, acos, atan, sinh, cosh, tanh.

Graph Functions: smooth_start, smooth_stop, impulse, cubic_pulse, exp_step, parabola, pcurve, exp_sustained_impulse, sinc, gain, almost_identity, integral_smoothstep, quad_impulse, poly_impulse.

+ More included!

c++ --std=c++11 -Wno-braced-scalar-init .test/test.cpp -o .test/test && ./".test/test"

There is a provided display.natvis file which can be used with visual studio or vscode, this will display swizzles correctly when hovering in the debugger and prevent the huge union expansion from the swizzles.

Append the contents of display.lldb to your ~/.lldbinit for improved readability in xcode or commandline lldb debugging.