fireblade-engine/math has 52 GitHub stars and 6 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-16 04:22 UTC. Last push 2026-11-13.
What you can do
- Vectors: Vec2, Vec3, Vec4 for Float, Double, Int, and UInt.
- Matrices: Mat2x2, Mat3x3, Mat4x4 for Float and Double.
- Quaternions: Quat4f and Quat4d.
- Geometric Types: Point, Size, Rect.
Measured star growth
- in 24h
- 0
- in 7 days
- Collecting history
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
A dependency free, lightweight, fast math library for 2D and 3D vectors, quaternions and matrices in Swift with (optional) SIMD support.
Creative & MediaREADME.md
OriginalFirebladeMath
A dependency-free, lightweight, fast math library for 2D and 3D vectors, quaternions, and matrices in Swift with (optional) SIMD support. It is developed and maintained as part of the Fireblade Game Engine project.
✨ Features
- Vectors:
Vec2,Vec3,Vec4forFloat,Double,Int, andUInt. - Matrices:
Mat2x2,Mat3x3,Mat4x4forFloatandDouble. - Quaternions:
Quat4fandQuat4d. - Geometric Types:
Point,Size,Rect. - Math Functions: A comprehensive set of functions including
sin,cos,tan,asin,acos,atan2,dot,cross,normalize,reflect,refract, and many more. - One import, every platform:
import FirebladeMathis all you need, including the scalar functions (sin,sqrt,pow, ...). FirebladeMath resolves the platform's C library (Darwin, Glibc, Musl, Bionic, WASILibc, ucrt) itself, so the API is the same on macOS, iOS, Linux, Windows, WebAssembly, and Android. - SIMD Support: Uses Apple's
simdwhere available, with a portable implementation everywhere else. - Identical results up to rounding: Every public function is checked against reference values recorded on macOS on each platform CI tests on, and the portable implementation is compared against Apple's
simd. - Swift 6 Ready: Fully compatible with Swift 6 and
Sendableconformance. - Codable: Every public type is
Codable. Matrices encode as a flat array in column-major order (4, 9 or 16 values), quaternions as[x, y, z, w]; decoding a wrong value count throwsDecodingError.dataCorrupted.
🚀 Getting Started
📋 Prerequisites
- Swift 6.1 or higher
- Swift Package Manager (SPM)
💻 Installation
Add Fireblade Math as a dependency to your Package.swift file:
// swift-tools-version: 6.1
import PackageDescription
let package = Package(
name: "YourPackageName",
dependencies: [
.package(url: "https://github.com/fireblade-engine/math.git", from: "1.4.0")
],
targets: [
.target(
name: "YourTargetName",
dependencies: ["FirebladeMath"])
]
)
For more detailed information and API reference, please refer to the comprehensive documentation.
🛠 SIMD Trait
FirebladeMath uses the Swift package trait simd to select its implementation. The trait is enabled by default on Apple platforms, where FirebladeMath builds on Apple's simd; on all other platforms the portable implementation is used. Both produce the same results up to rounding.
To use the portable implementation on Apple platforms as well, depend on the package without its default traits:
.package(url: "https://github.com/fireblade-engine/math.git", from: "1.4.0", traits: [])
📖 Documentation
Comprehensive documentation for FirebladeMath is available online:
📖 Usage Examples
Vectors
import FirebladeMath
let v1 = Vec3f(1, 2, 3)
let v2 = Vec3f(4, 5, 6)
let dotProduct = dot(v1, v2)
let crossProduct = cross(v1, v2)
let unitVector = normalize(v1)
Matrices
import FirebladeMath
// Create a transformation matrix
var modelMatrix = Mat4x4f.identity
modelMatrix.translate(by: [10, 20, 30])
modelMatrix.rotate(by: .pi / 2, axis: [0, 1, 0])
// Project a point
let projection = Mat4x4f.perspectiveRH(fovy: .pi / 4, aspect: 16/9, zNear: 0.1, zFar: 100)
Quaternions
import FirebladeMath
let q = Quat4f(angle: .pi / 4, axis: [0, 1, 0])
let rotatedVector = q * Vec3f(1, 0, 0)
💁 How to contribute
If you want to contribute please see the CONTRIBUTION GUIDE first.
git clone [email protected]:fireblade-engine/math.gitcd mathmake setup
Before committing code please ensure to run:
make pre-commit(formats, lints, and runs the tests)
Further checks, all run in CI:
| Command | Purpose |
|---|---|
make test-portable |
Runs the tests without the simd trait; on Apple platforms this compares the portable implementation against Apple's simd. |
make check-inlinable |
Verifies that the public API is inlinable across module boundaries. |
make check-simd-coverage |
Verifies that every simd-backed function has a portable-vs-simd comparison test. |
make check-reference-coverage |
Verifies that every public function has cross-platform reference values. |
make reference-values |
Regenerates the reference values (macOS, default traits) after an intentional change of results. |
make benchmark |
Runs the benchmarks of FirebladeMath's own implementations in Benchmarks/. |
make benchmark-thresholds-check |
Checks the benchmarks' allocation thresholds (make benchmark-thresholds-update records new ones). |
This project is currently maintained by @ctreffs.
See also the list of contributors who participated in this project.
🔏 License
This project is licensed under the MIT License - see the LICENSE file for details.