mirrors/HandmadeMath
1
0
Fork 0
mirror of https://github.com/HandmadeMath/HandmadeMath.git synced 2025-11-07 03:04:29 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add documentation for v0.5

Browse Source
This commit is contained in:
Ben Visness
2016-08-23 18:20:59 -05:00
parent 077bdcd346
commit c9ec065fd5
2 changed files with 31 additions and 18 deletions
Download Patch File Download Diff File Expand all files Collapse all files

46
HandmadeMath.h
View File

@@ -1,9 +1,11 @@
/* /*
HandmadeMath.h v0.4 HandmadeMath.h v0.5
This is a single header file with a bunch of useful functions for This is a single header file with a bunch of useful functions for
basic game math operations. basic game math operations.
========================================================================== ==========================================================================
You MUST You MUST
#define HANDMADE_MATH_IMPLEMENTATION #define HANDMADE_MATH_IMPLEMENTATION
@@ -15,12 +17,13 @@
#include "HandmadeMath.h" #include "HandmadeMath.h"
All other files should just #include "HandmadeMath.h" without the #define. All other files should just #include "HandmadeMath.h" without the #define.
========================================================================== ==========================================================================
For overloaded, and operator overloaded versions of the base C functions. For overloaded and operator overloaded versions of the base C functions,
You MUST you MUST
#define HANDMADE_MATH_CPP_MODE #define HANDMADE_MATH_CPP_MODE
in EXACTLY one C or C++ file that includes this header, BEFORE the in EXACTLY one C or C++ file that includes this header, BEFORE the
include, like this: include, like this:
@@ -30,9 +33,10 @@
#include "HandmadeMath.h" #include "HandmadeMath.h"
All other files should just #include "HandmadeMath.h" without the #define. All other files should just #include "HandmadeMath.h" without the #define.
========================================================================== ==========================================================================
To disable SSE intrinsics, for You MUST To disable SSE intrinsics, you MUST
#define HANDMADE_MATH_NO_SSE #define HANDMADE_MATH_NO_SSE
@@ -48,6 +52,7 @@
#define HANDMADE_MATH_IMPLEMENTATION #define HANDMADE_MATH_IMPLEMENTATION
#define HANDMADE_MATH_NO_SSE #define HANDMADE_MATH_NO_SSE
#include "HandmadeMath.h"
========================================================================== ==========================================================================
@@ -69,23 +74,23 @@
To Disable the CRT, you MUST To Disable the CRT, you MUST
#define HMM_SINF MySinF #define HMM_SINF MySinF
#define HMM_COSF MyCosF #define HMM_COSF MyCosF
#define HMM_TANF MyTanF #define HMM_TANF MyTanF
Provide your own implementations of SinF, CosF, and TanF Provide your own implementations of SinF, CosF, and TanF
in EXACTLY one C or C++ file that includes this header, BEFORE the in EXACTLY one C or C++ file that includes this header, BEFORE the
include, like this: include, like this:
#define HMM_SINF MySinF #define HMM_SINF MySinF
#define HMM_COSF MyCosF #define HMM_COSF MyCosF
#define HMM_TANF MyTanF #define HMM_TANF MyTanF
#define HANDMADE_MATH_IMPLEMENTATION #define HANDMADE_MATH_IMPLEMENTATION
#define HANDMADE_MATH_CPP_MODE #define HANDMADE_MATH_CPP_MODE
#include "HandmadeMath.h" #include "HandmadeMath.h"
If you do not define these HandmadeMath.h will use version the version If you do not define all three of these, HandmadeMath.h will use the
of these function that are provided by the CRT. versions of these functions that are provided by the CRT.
========================================================================== ==========================================================================
@@ -100,11 +105,18 @@
(*) Disabled warning 4201 on MSVC as it is legal is C11 (*) Disabled warning 4201 on MSVC as it is legal is C11
(*) Removed the f at the end of HMM_PI to get 64bit precision (*) Removed the f at the end of HMM_PI to get 64bit precision
0.3 0.3
(*) Added +=,-=, *=, /= for hmm_vec2, hmm_vec3, hmm_vec4 (*) Added +=, -=, *=, /= for hmm_vec2, hmm_vec3, hmm_vec4
0.4 0.4
(*) SSE Optimized HMM_SqrtF (*) SSE Optimized HMM_SqrtF
(*) SSE Optimized HMM_RSqrtF (*) SSE Optimized HMM_RSqrtF
(*) Removed CRT (*) Removed CRT
0.5
(*) Added scalar multiplication and division for vectors
and matrices
(*) Added matrix subtraction and += for hmm_mat4
(*) Reconciled all headers and implementations
(*) Tidied up, and filled in a few missing operators
LICENSE LICENSE

3
README.md
View File

@@ -5,6 +5,7 @@ Single-file public domain game math library for C/C++
Version | Changes | Version | Changes |
----------------|----------------| ----------------|----------------|
**0.5** | Added scalar operations on vectors and matrices, added += and -= for hmm_mat4, reconciled headers and implementations, tidied up in general |
**0.4** | Added SSE Optimized HMM_SqrtF, HMM_RSqrtF, Removed use of CRT | **0.4** | Added SSE Optimized HMM_SqrtF, HMM_RSqrtF, Removed use of CRT |
**0.3** | Added +=,-=, *=, /= for hmm_vec2, hmm_vec3, hmm_vec4 | **0.3** | Added +=,-=, *=, /= for hmm_vec2, hmm_vec3, hmm_vec4 |
**0.2b** | Disabled warning C4201 on MSVC, Added 64bit percision on HMM_PI | **0.2b** | Disabled warning C4201 on MSVC, Added 64bit percision on HMM_PI |
@@ -21,6 +22,6 @@ _ID: In Development_
This library is in the public domain. You can do whatever you want with them. This library is in the public domain. You can do whatever you want with them.
**Where can i contact you to ask quesitons ?** **Where can I contact you to ask questions?**
You can email me at: Zak@Handmade.Network You can email me at: Zak@Handmade.Network