Optimized math for games, based on XNA APIs
C# Shell
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Fast Managed Math for Games

Mono.GameMath is a project to develop a highly-performant math library for games.

There will be three components:

  • the math library
  • a benchmark suite
  • an IL manipulation tool

The Library

The math library API is initially based on the XNA math API, in order to make it easy to port code, however it will likely be expanded. Non-math algorithms used in games may also be added if contributed.

The library will have the following ifdefed versions:

  • "safe" - as a baseline and for sandboxed platforms
  • unsafe - for architectures without SIMD support
  • unsafe + Mono.Simd

Architecture-specific versions tuned for JIT & SIMD behaviour may be added later if benchmarks indicate this is necessary.

The Benchmark Suite

The benchmark suite will consist of micro-benchmarks to measure individual functions, and macro-benchmarks to test the interaction of multiple functions. The purpose of the benchmark suite is to ensure that optimizations actually improve the performance, and to be able to evaluate performance on different runtimes and CPU architectures where JIT behaviour may differ.

The benchmark runner will be able to run the benchmarks against different versions of the library with different optimizations. It will also be able to compare results against recorded baselines.

The IL Tool

The IL manipulation tool will be used to create differently tuned versions of the library, and to optimize consuming code, based on by attributes in the code. It may inline functions, rewrite pass- by-value function calls to use pass-by-ref overloads (especially for overloaded operators), and perhaps other optimizations such as profile-guided optimization (it would be great if we could use attributes to annotate things for the JIT to inline or to heavily optimize).