MathLib (ML)

ML is a cross-platform header-only SSE/AVX/NEON-accelerated math library, designed for computer graphics. It serves two goals:

• accelerate performance using SSE/AVX/NEON intrinsics
• be HLSL compatible and deliver functionality to both CPU and shader code without code duplication

Features:

• compile-time optimization level specialization: SSE3 (and below), +SSE4, +AVX1, +AVX2 (or NEON on ARM via sse2neon)
• int[2,3,4] types
• uint[2,3,4] types
• float[2,3,4] and float4x4 types
• double[2,3,4] and double4x4 types
• bool[2,3,4] types
• "small float" types for DL/ML
  • float8_e4m3_t[2,4,8], float8_e5m2_t[2,4,8] and float16_t[2,4,8]
• overloaded operators
• vector swizzling
• common functions: all, any, sign, abs, floor, round, ceil, fmod, frac, min, max, clamp, saturate, lerp, step, smoothstep and linearstep
• transcendental functions: sin, cos, tan, asin, acos, atan, atan2, sqrt, rsqrt, rcp, pow, log, log2, exp and exp2
• optimized data conversions and packing functionality
  • from fp32 to fp16, fp11, fp10, fp8_e4m3, fp8_e5m2, SNORM and UNORM (and back)
• vectors and matrices
• linear algebra miscellaneous functionality
• projective math miscellaneous functionality
• frustum & AABB primitives
• random numbers generation
• sorting

Important:

• sizeof(int3/uint3/float3) == sizeof(float4) on CPU
• sizeof(double3) == sizeof(double4) on CPU
• using namespace std can lead to name collisions
• inclusion of cmath and/or cstdlib (even implicitly) after ml.h leads to name collisions

Also includes ml.hlsli file which is a standalone HLSL math library usable in C++ code.

License

ML is licensed under the MIT License.