2.0.0-rc1
Pre-release
This is a release candidate for Handmade Math 2.0. Please try it out and give us feedback.
After far too long, we are happy to release Handmade Math 2.0. Handmade Math 2.0 introduces the following new features and changes:
-
A concise naming scheme. Handmade Math 1.0 has extremely verbose names. For version 2, we've reworked them to use a terse naming scheme that will make expressions much more readable. Here are some examples:
HMM_MultiplyMat4ByVec4->HMM_MulM4V4HMM_MultiplyVec3f->HMM_MulV3FHMM_EqualsVec4->HMM_EqV4
This is obviously an extremely breaking change, but to ease the transition, we provide a tool to automatically rename Handmade Math functions and types in your codebase. See the
updatefolder of the repo. -
Matrix inverses. We are happy to finally provide our most long-requested feature. We now have a variety of functions for matrix inverses.
-
2x2 and 3x3 matrices. We now provide types
HMM_Mat2andHMM_Mat3. -
C11 generics. C programmers can now use "overloaded" functions like
HMM_Addinstead ofHMM_AddV2,HMM_AddV3, etc. Your expressions can now be a little more readable! -
Consistent (and configurable) angle units. Handmade Math 1.0 used radians for some operations and degrees for others. Handmade Math 2.0 makes all functions use the same angle units - but also makes those units configurable, so you can choose to use radians, degrees, or turns across your codebase. See the documentation in
HandmadeMath.h. -
Left-handed and right-handed operations. Handmade Math 2.0 has both left-handed and right-handed versions of all operations where handedness applies.
This release would not be possible without the help of @dev-dwarf. Many thanks for his contributions!
Other breaking changes:
- If you use Handmade Math without the standard library, the way you provide custom math functions has changed. You must now
#define HANDMADE_MATH_PROVIDE_MATH_FUNCTIONSin addition to#define HMM_SINFetc. HMM_ExpF,HMM_LogF,HMM_Power, andHMM_PowerFhave been removed. They were not used internally and provided no benefit.HMM_PREFIXhas been removed. If you wish to use a different prefix, find and replace withinHandmadeMath.h.- Semi-breaking: Vector length and normalization now uses fast inverse square root by default. This reduces precision, but should still be precise enough for games and graphics applications. (It's also the same level of precision as GLM.)
