https://github.com/jpreiss/cmath3d
3d math library for C. Vectors, 3x3 matrices, quaternions, polytopes.
https://github.com/jpreiss/cmath3d
Last synced: 13 days ago
JSON representation
3d math library for C. Vectors, 3x3 matrices, quaternions, polytopes.
- Host: GitHub
- URL: https://github.com/jpreiss/cmath3d
- Owner: jpreiss
- License: mit
- Created: 2016-07-24T18:08:27.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2021-07-20T03:56:50.000Z (over 4 years ago)
- Last Synced: 2024-11-14T22:35:25.945Z (about 1 year ago)
- Language: C
- Homepage:
- Size: 142 KB
- Stars: 26
- Watchers: 6
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- AwesomeCppGameDev - cmath3d
README
[](https://codecov.io/gh/jpreiss/cmath3d/branch/master)
# cmath3d
3d math library for C. Vectors, 3x3 matrices, quaternions. 32-bit floats.
## motivation
This library is intended for embedded projects where C++ is not used.
In the author's opinion, C++'s feature set enables dramatically
more readable 3d math code. However, many embedded projects stick with C
by necessity or preference. The goal of this project is to create the
best possible programmer experience within the constraints of C syntax.
**If cmath3d is missing something you need, feature requests are encouraged.**
## design choices
Unlike many other C libraries of this type, `cmath3d` passes arguments
and returns results by value instead of by pointer and pointer-to-output.
This choice has several motivations:
- avoids the need to name non-meaningful intermediate results for the sake of taking their address
- enables nested expressions
- reduces bugs by allowing more variables to be declared `const`
- gives the optimizing compiler complete knowledge about function semantics,
theoretically enabling better optimizations
(see [Chandler Carruth's talk](https://www.youtube.com/watch?v=eR34r7HOU14))
Although Carruth's talk implies that using these functions with inline,
header-only definitions -- thus hiding no code from the compiler
in external object files -- will enable as good or better optimizations
than a pass-by-pointer version, in practice this library seems to consume
more stack memory than it should.
I am currently researching ways to fix this problem, since I believe
a SSA compiler with the ability to destructure structs should produce
optimal code from this library.
## note for users
If you use `cmath3d` in your project,
I would very much appreciate it if you leave a comment in [#2](https://github.com/jpreiss/cmath3d/issues/2).