GameMath is a small, free open-source math library for games.
We aim to provide to most useful common math routines you need in games, without over-engineering or trying to be overly scientific.
If you're missing anything, we'd love to see it - please refer to the Contributing file!
- Extensive vector structs for ints and floats (e.g. Vector2I, Vector3F)
- Basic geometric shapes (e.g. RectangleF, LineF)
- Intersection tests (e.g. line-line, line-circle)
- Angle operations (e.g. angle difference, angle between vectors)
- Interpolation (e.g. linear, sinusoidal, smoothstep)
- Advanced operations (e.g. Bresenham, ballistic trajectory)
- Pseudo-random number generators
- Utility methods (e.g. rounding and casting to int)
- Unit tests and references for non-trivial operations
- Public API documentation
You can either
- download BINARIES from the Releases page
- checkout SOURCES from this repository
Just import the GameMath namespace and you're good to go!
using GameMath;
To get an overview of the library, take a glimpse at the API documentation.
We don't want to impose any kind of coordinate system or origin on your implementation. Thus, we are avoiding property namings like "Right" or "Front", and use "MaxX" or "MaxZ" instead.
For each of our non-trivial implementations, we provide unit tests and references to algorithms. If anything's unclear, feel free to contact us. We'd love to improve our documentation.
We know that using a library like GameMath in production requires you to be completely sure about stability and compatibility. Thus, new releases of GameMath are created using Semantic Versioning. In short:
- Version numbers are specified as MAJOR.MINOR.PATCH.
- MAJOR version increases indicate incompatible changes with respect to the public GameMath API.
- MINOR version increases indicate new functionality that are backwards-compatible.
- PATCH version increases indicate backwards-compatible bug fixes.
We are sorry that you've experienced issues or are missing a feature! After verifying that you are using the latest version of GameMath and having checked whether a similar issue has already been reported, feel free to open a new issue. In order to help us resolving your problem as fast as possible, please include the following details in your report:
- Steps to reproduce
- What happened?
- What did you expect to happen?
After being able to reproduce the issue, we'll look into fixing it immediately.
(in alphabetical order)
- Paul Bourke
- Jeff G. Erickson
- Darel Rex Finley
- Christian Oeing
- Nick Prühs (Maintainer)
- Heiner Schmidt
- Martijn Segers
A warm thank you to everyone participating in this project in any way! Sometimes, math is complicated. You show that it doesn't need to be.
GameMath is released under the MIT license.