complete documentation

color: add luminance function

.gitignore

@@ -41,10 +41,22 @@ packages/
 .anjuta/*
 *.anjuta*
 config.h.*
-config.h
+/config.h
 stamp*
 COPYING
 .idea/*
 *.VC.db
 cscope.*
 *-git-ignored-file.*
+test/*.trs
+test/test_*
+*.log
+test-*
+test/.libs/*
+test/tests
+cglm_arm/*
+cglm_test_ios/*
+cglm_test_iosTests/*
+docs/build/*
+win/cglm_test_*
+* copy.*

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "test/lib/cmocka"]
+	path = test/lib/cmocka
+	url = git://git.cryptomilk.org/projects/cmocka.git

.travis.yml

@@ -0,0 +1,59 @@
+language: c
+
+os:
+  - linux
+  - osx
+
+sudo: required
+dist: trusty
+
+compiler:
+  - clang
+  - gcc
+
+matrix:
+  fast_finish: true
+  exclude:
+    # Skip GCC builds on macOS.
+    - os: osx
+      compiler: gcc
+  include:
+    # Additional GCC builds for code coverage.
+    - os: linux
+      compiler: gcc
+      env: CODE_COVERAGE=ON
+
+cache:
+  apt: true
+
+addons:
+  apt:
+    packages:
+      - clang-3.6
+      - lcov
+
+branches:
+  only:
+    - master
+
+script:
+  - sh ./build-deps.sh
+  - sh ./autogen.sh
+  - if [[ "$CC" == "gcc" && "$CODE_COVERAGE" == "ON" ]]; then
+      ./configure CFLAGS="-ftest-coverage -fprofile-arcs";
+    else
+      ./configure;
+    fi
+  - make
+  - make check
+
+after_success:
+  - if [[ "$CC" == "gcc" && "$CODE_COVERAGE" == "ON" ]]; then
+      pip install --user cpp-coveralls
+      coveralls
+        --build-root .
+        --exclude lib
+        --exclude test
+        --gcov-options '\-lp'
+        --verbose;
+    fi

CONTRIBUTING.md

@@ -0,0 +1,53 @@
+# CONTRIBUTING
+
+Any contributions (code, documentation, ...) are welcome. This project uses [cmocka](http://cmocka.org) for testing, you may need to check their documentation 
+
+# New Features
+- This library may not accept all new features, it is better to create an issue and get approval before coding
+- You must add test for every new feature
+- The feature must be compiled in both UNIX/POSIX systems (e.g. macos, linux...) and Windows
+
+# Code Style
+This library is written with C99, don't try to add C++ files (yes it can compiled into lib),
+if you have enough reason to add C++ files than create an issue and get approval before coding,
+
+- All functions must have `glm` prefix
+- Lines should be wrapped at 80 characters.
+- Don't invent new style for existing ones
+- Use C89 style comments (`/* comments */`) not C++ style comments (`// comments`)
+- Don't use TABs instead use 2 spaces for TABs
+- All indents must be 2 spaces, not 1 nor 4 space
+- All functions in `include` folder must be exported by `CGLM_EXPORT` and wrapped by `extern "C" {` for C++
+- Crate new line for return type, attribs:
+
+```C
+CGLM_INLINE
+void
+glm_mul(mat4 m1, mat4 m2, mat4 dest)
+```
+
+not acceptable:
+
+```C
+CGLM_INLINE void glm_mul(mat4 m1, mat4 m2, mat4 dest)
+```
+- Variables must be declared at the top of a scope before usage:
+```C
+int x;
+int y;
+
+x = y = 0;
+```
+
+not acceptable:
+
+```C
+int x;
+
+x = 0;
+int y = 0;
+```
+
+- All files must retain same LICENSE statement
+- Code with warnings will not be accepted, please suppress them (not by disabling them)
+- Run code anaylysis before submitting pull requests, if you use Xcode you can enable Sanitizer in scheme, you can use valgrind in linux

CREDITS

@@ -0,0 +1,45 @@
+This library [initially] used some [piece of] implementations
+(may include codes) from these open source projects/resources:
+
+1. Affine Transforms
+The original glm repo (g-truc), url: https://github.com/g-truc/glm
+
+LICENSE[S]:
+  The Happy Bunny License (Modified MIT License)
+  The MIT License
+  Copyright (c) 2005 - 2016 G-Truc Creation
+
+FULL LICENSE: https://github.com/g-truc/glm/blob/master/copying.txt
+
+2. Quaternions
+Anton's OpenGL 4 Tutorials book source code:
+
+LICENSE:
+  OpenGL 4 Example Code.
+  Accompanies written series "Anton's OpenGL 4 Tutorials"
+  Email: anton at antongerdelan dot net
+  First version 27 Jan 2014
+  Copyright Dr Anton Gerdelan, Trinity College Dublin, Ireland.
+
+3. Euler Angles
+  David Eberly
+  Geometric Tools, LLC http://www.geometrictools.com/
+  Copyright (c) 1998-2016. All Rights Reserved.
+
+  Computing Euler angles from a rotation matrix (euler.pdf)
+  Gregory G. Slabaugh
+
+4. Extracting Planes
+Fast Extraction of Viewing Frustum Planes from the World-View-Projection Matrix
+Authors:
+  Gil Gribb (ggribb@ravensoft.com)
+  Klaus Hartmann (k_hartmann@osnabrueck.netsurf.de)
+
+5. Transform AABB
+Transform Axis Aligned Bounding Boxes:
+http://dev.theomader.com/transform-bounding-boxes/
+https://github.com/erich666/GraphicsGems/blob/master/gems/TransBox.c
+
+6. Cull frustum
+http://www.txutxi.com/?p=584
+http://old.cescg.org/CESCG-2002/DSykoraJJelinek/

LICENSE

@@ -19,36 +19,3 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
-
--
-
-This library [initially] used some [piece of] implementations
-(may include codes) from these open source projects/resources:
-
-1. Affine Transforms
-The original glm repo (g-truc), url: https://github.com/g-truc/glm
-
-LICENSE[S]:
-  The Happy Bunny License (Modified MIT License)
-  The MIT License
-  Copyright (c) 2005 - 2016 G-Truc Creation
-
-FULL LICENSE: https://github.com/g-truc/glm/blob/master/copying.txt
-
-2. Quaternions
-Anton's OpenGL 4 Tutorials book source code:
-
-LICENSE:
-  OpenGL 4 Example Code.
-  Accompanies written series "Anton's OpenGL 4 Tutorials"
-  Email: anton at antongerdelan dot net
-  First version 27 Jan 2014
-  Copyright Dr Anton Gerdelan, Trinity College Dublin, Ireland.
-
-3. Euler Angles
-  David Eberly
-  Geometric Tools, LLC http://www.geometrictools.com/
-  Copyright (c) 1998-2016. All Rights Reserved.
-
-  Computing Euler angles from a rotation matrix (euler.pdf)
-  Gregory G. Slabaugh

README.md

@@ -1,11 +1,47 @@
 # 🎥 OpenGL Mathematics (glm) for `C`
+[![Build Status](https://travis-ci.org/recp/cglm.svg?branch=master)](https://travis-ci.org/recp/cglm)
+[![Build status](https://ci.appveyor.com/api/projects/status/av7l3gc0yhfex8y4/branch/master?svg=true)](https://ci.appveyor.com/project/recp/cglm/branch/master)
+[![Documentation Status](https://readthedocs.org/projects/cglm/badge/?version=latest)](http://cglm.readthedocs.io/en/latest/?badge=latest)
+[![Coverage Status](https://coveralls.io/repos/github/recp/cglm/badge.svg?branch=master)](https://coveralls.io/github/recp/cglm?branch=master)
+[![Codacy Badge](https://api.codacy.com/project/badge/Grade/6a62b37d5f214f178ebef269dc4a6bf1)](https://www.codacy.com/app/recp/cglm?utm_source=github.com&utm_medium=referral&utm_content=recp/cglm&utm_campaign=Badge_Grade)
 
-The original glm library is for C++ only (templates, namespaces, classes...), this library targeted to C99 but currently you can use it for C89 safely by language extensions e.g `__register`
+The original glm library is for C++ only (templates, namespaces, classes...), this library targeted to C99 but currently you can use it for C89 safely by language extensions e.g `__restrict`
+
+#### Documentation
+
+Almost all functions (inline versions) and parameters are documented inside related headers. <br />
+Complete documentation: http://cglm.readthedocs.io
+
+#### Note for previous versions:
+
+- _dup (duplicate) is changed to _copy. For instance `glm_vec_dup -> glm_vec_copy`
+- OpenGL related functions are dropped to make this lib platform/third-party independent
+- make sure you have latest version and feel free to report bugs, troubles
 
 #### Note for C++ developers:
 If you don't aware about original GLM library yet, you may also want to look at:
 https://github.com/g-truc/glm
 
+#### Note for new comers (Important):
+- `vec4` and `mat4` variables must be aligned. (There will be unaligned versions later)
+- **in** and **[in, out]** parameters must be initialized (please). But **[out]** parameters not, initializing out param is  also redundant
+- All functions are inline if you don't want to use pre-compiled versions with glmc_ prefix, you can ignore build process. Just incliude headers.
+- if your debugger takes you to cglm headers then make sure you are not trying to copy vec4 to vec3 or alig issues...
+- Welcome!
+
+#### Note for experienced developers:
+- Since I'm testing this library in my projects, sometimes bugs occurs; finding that bug[s] and making improvements would be more easy with multiple developer/contributor and their projects or knowledge. Consider to make some tests if you suspect something is wrong and any feedbacks, contributions and bug reports are always welcome.
+
+#### Allocations?
+`cglm` doesn't alloc any memory on heap. So it doesn't provide any allocator. You should alloc memory for **out** parameters too if you pass pointer of memory location. Don't forget that **vec4** (also quat/**versor**) and **mat4** must be aligned (16-bytes), because *cglm* uses SIMD instructions to optimize most operations if available.
+
+#### Returning vector or matrix... ?
+Since almost all types are arrays and **C** doesn't allow returning arrays, so **cglm** doesn't support this feature. In the future *cglm* may use **struct** for some types for this purpose.
+
+#### Other APIs like Vulkan, Metal, Dx?
+Currently *cglm* uses default clip space configuration (-1, 1) for camera functions (perspective, extract corners...), in the future other clip space configurations will be supported
+
+<hr/>
 
 <table>
   <tbody>
@@ -22,7 +58,7 @@ https://github.com/g-truc/glm
   </tbody>
 </table>
 
-##Features
+## Features
 - general purpose matrix operations (mat4, mat3)
 - chain matrix multiplication (square only)
 - general purpose vector operations (cross, dot, rotate, proj, angle...)
@@ -35,16 +71,18 @@ https://github.com/g-truc/glm
 - euler angles / yaw-pitch-roll to matrix
 - extract euler angles
 - inline or pre-compiled function call
+- frustum (extract view frustum planes, corners...)
+- bounding box  (AABB in Frustum (culling), crop, merge...)
 
 <hr />
 
 You have two option to call a function/operation: inline or library call (link)
-Almost all functions are marked inline (always_inline) so compiler probably will inline. 
-To call pre-compiled version, just use `glmc_` (c stands for 'call') instead of `glm_`. 
+Almost all functions are marked inline (always_inline) so compiler probably will inline.
+To call pre-compiled version, just use `glmc_` (c stands for 'call') instead of `glm_`.
 
 ```C
-  #include <cglm.h>        /* for inline */
-  #include <cglm-call.h>   /* for library call (this also includes cglm.h) */
+  #include <cglm/cglm.h>   /* for inline */
+  #include <cglm/call.h>   /* for library call (this also includes cglm.h) */
 
   mat4 rot, trans, rt;
   /* ... */
@@ -76,30 +114,52 @@ glm_mul(T, R, modelMat);
 glm_inv_tr(modelMat);
 ```
 
-##License
+## License
 MIT. check the LICENSE file
 
 ## Build
 
 ### Unix (Autotools)
 
-```text
+```bash
+$ sh ./build-deps.sh # run only once (dependencies) [Optional].
+$ # You can pass this step if you don't want to run `make check` for tests.
+$ # cglm uses cmocka for tests and it may reqiure cmake for building it
+$
 $ sh autogen.sh
 $ ./configure
 $ make
-$ make install
+$ make check # [Optional] (if you run `sh ./build-deps.sh`)
 $ [sudo] make install
 ```
 
 ### Windows (MSBuild)
+Windows related build files, project files are located in `win` folder,
+make sure you are inside `cglm/win` folder.
+Code Analysis are enabled, it may take awhile to build
 
-```text
-TODO:
+```Powershell
+$ cd win
+$ .\build.bat
 ```
-##How to use
+if `msbuild` won't work (because of multi version VS) then try to build with `devenv`:
+```Powershell
+$ devenv cglm.sln /Build Release
+```
+
+### Building Docs
+First you need install Sphinx: http://www.sphinx-doc.org/en/master/usage/installation.html
+then:
+```bash
+$ cd docs
+$ sphinx-build source build
+```
+it will compile docs into build folder, you can run index.html inside that function.
+
+## How to use
 If you want to use inline versions of funcstions then; include main header
 ```C
-#include <cglm.h>
+#include <cglm/cglm.h>
 ```
 the haeder will include all headers. Then call func you want e.g. rotate vector by axis:
 ```C
@@ -118,15 +178,50 @@ like this function you may see `_to` postfix, this functions store results to an
 
 to call pre-compiled versions include header with `c` postfix, c means call. Pre-compiled versions are just wrappers.
 ```C
-#include <cglm-call.h>
+#include <cglm/call.h>
 ```
 this header will include all heaers with c postfix. You need to call functions with c posfix:
 ```C
 glmc_vec_normalize(vec);
 ```
 
-Function usage and parameters are documented inside related headers.
-##Notes
+Function usage and parameters are documented inside related headers. You may see same parameter passed twice in some examples like this:
+```C
+glm_mat4_mul(m1, m2, m1);
+
+/* or */
+glm_mat4_mul(m1, m1, m1);
+```
+the first two parameter are **[in]** and the last one is **[out]** parameter. After multiplied *m1* and *m2* the result is stored in *m1*. This is why we send *m1* twice. You may store result in different matrix, this just an example.
+
+## How to send matrix to OpenGL
+
+mat4 is array of vec4 and vec4 is array of floats. `glUniformMatrix4fv` functions accecpts `float*` as `value` (last param), so you can cast mat4 to float* or you can pass first column of matrix as beginning of memory of matrix:
+
+Option 1: Send first column
+```C
+glUniformMatrix4fv(location, 1, GL_FALSE, matrix[0]);
+
+/* array of matrices */
+glUniformMatrix4fv(location, 1, GL_FALSE, matrix[0][0]);
+```
+
+Option 2: Cast matrix to pointer type (also valid for multiple dimensional arrays)
+```C
+glUniformMatrix4fv(location, 1, GL_FALSE, (float *)matrix);
+```
+
+You can pass same way to another APIs e.g. Vulkan, DX...
+
+## Notes
 
 - This library uses float types only, does not support Integers, Double... yet
 - If headers are not working properly with your compiler, IDE please open an issue, because I'm using GCC and clang to test it maybe sometimes MSVC
+
+**TODO:**
+- [ ] Unit tests (In Progress)
+- [ ] Unit tests for comparing cglm with glm results
+- [x] Add version info
+- [ ] Unaligned operations (e.g. `glm_umat4_mul`)
+- [x] Extra documentation
+- [ ] ARM Neon Arch (In Progress)

appveyor.yml

@@ -0,0 +1,7 @@
+image: Visual Studio 2017
+
+build_script:
+- ps: >-
+    cd win
+
+    .\build.bat

autogen.sh

@@ -6,12 +6,15 @@
 # Full license can be found in the LICENSE file
 #
 
-cd `dirname "$0"`
+cd $(dirname "$0")
 
-if [ "`uname`" = "Darwin" ]; then
-  libtoolBin=$(which glibtoolize)
-  libtoolBinDir=$(dirname "${libtoolBin}")
-  ln -s $libtoolBin "${libtoolBinDir}/libtoolize"
+if [ "$(uname)" = "Darwin" ]; then
+libtoolBin=$(which glibtoolize)
+libtoolBinDir=$(dirname "${libtoolBin}")
+
+if [ ! -f "${libtoolBinDir}/libtoolize" ]; then
+ln -s $libtoolBin "${libtoolBinDir}/libtoolize"
+fi
 fi
 
 autoheader

build-deps.sh

@@ -0,0 +1,30 @@
+#! /bin/sh
+#
+# Copyright (c), Recep Aslantas.
+#
+# MIT License (MIT), http://opensource.org/licenses/MIT
+# Full license can be found in the LICENSE file
+#
+
+# check if deps are pulled
+git submodule update --init --recursive
+
+# fix glibtoolize
+
+cd $(dirname "$0")
+
+if [ "$(uname)" = "Darwin" ]; then
+  libtoolBin=$(which glibtoolize)
+  libtoolBinDir=$(dirname "${libtoolBin}")
+  ln -s $libtoolBin "${libtoolBinDir}/libtoolize"
+fi
+
+# general deps: gcc make autoconf automake libtool cmake
+
+# test - cmocka
+cd ./test/lib/cmocka
+mkdir build
+cd build
+cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug ..
+make -j8
+cd ../../../../

configure.ac

@@ -7,7 +7,7 @@
 #*****************************************************************************
 
 AC_PREREQ([2.69])
-AC_INIT([cglm], [0.1.0], [info@recp.me])
+AC_INIT([cglm], [0.3.4], [info@recp.me])
 AM_INIT_AUTOMAKE([-Wall -Werror foreign subdir-objects])
 
 AC_CONFIG_MACRO_DIR([m4])

docs/make.bat

@@ -0,0 +1,36 @@
+@ECHO OFF
+
+pushd %~dp0
+
+REM Command file for Sphinx documentation
+
+if "%SPHINXBUILD%" == "" (
+	set SPHINXBUILD=python -msphinx
+)
+set SOURCEDIR=source
+set BUILDDIR=build
+set SPHINXPROJ=cglm
+
+if "%1" == "" goto help
+
+%SPHINXBUILD% >NUL 2>NUL
+if errorlevel 9009 (
+	echo.
+	echo.The Sphinx module was not found. Make sure you have Sphinx installed,
+	echo.then set the SPHINXBUILD environment variable to point to the full
+	echo.path of the 'sphinx-build' executable. Alternatively you may add the
+	echo.Sphinx directory to PATH.
+	echo.
+	echo.If you don't have Sphinx installed, grab it from
+	echo.http://sphinx-doc.org/
+	exit /b 1
+)
+
+%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS%
+goto end
+
+:help
+%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS%
+
+:end
+popd

docs/source/affine-mat.rst

@@ -0,0 +1,77 @@
+.. default-domain:: C
+
+affine transform matrix (specialized functions)
+================================================================================
+
+Header: cglm/affine-mat.h
+
+We mostly use glm_mat4_* for 4x4 general and transform matrices. **cglm**
+provides optimized version of some functions. Because affine transform matrix is
+a known format, for instance all last item of first three columns is zero.
+
+You should be careful when using these functions. For instance :c:func:`glm_mul`
+assumes matrix will be this format:
+
+.. code-block:: text
+
+   R  R  R  X
+   R  R  R  Y
+   R  R  R  Z
+   0  0  0  W
+
+if you override zero values here then use :c:func:`glm_mat4_mul` version.
+You cannot use :c:func:`glm_mul` anymore.
+
+Same is also true for :c:func:`glm_inv_tr` if you only have rotation and
+translation then it will work as expected, otherwise you cannot use that.
+
+In the future it may accept scale factors too but currectly it does not.
+
+Table of contents (click func go):
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Functions:
+
+1. :c:func:`glm_mul`
+#. :c:func:`glm_inv_tr`
+
+Functions documentation
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. c:function:: void  glm_mul(mat4 m1, mat4 m2, mat4 dest)
+
+    | this is similar to glm_mat4_mul but specialized to affine transform
+
+    Matrix format should be:
+
+    .. code-block:: text
+
+       R  R  R  X
+       R  R  R  Y
+       R  R  R  Z
+       0  0  0  W
+
+    this reduces some multiplications. It should be faster than mat4_mul.
+    if you are not sure about matrix format then DON'T use this! use mat4_mul
+
+    Parameters:
+      | *[in]*  **m1**    affine matrix 1
+      | *[in]*  **m2**    affine matrix 2
+      | *[out]* **dest**  result matrix
+
+.. c:function:: void  glm_inv_tr(mat4 mat)
+
+    | inverse orthonormal rotation + translation matrix (ridig-body)
+
+    .. code-block:: text
+
+       X = | R  T |   X' = | R' -R'T |
+           | 0  1 |        | 0     1 |
+
+    use this if you only have rotation + translation, this should work faster
+    than :c:func:`glm_mat4_inv`
+
+    Don't use this if your matrix includes other things e.g. scale, shear...
+
+    Parameters:
+      | *[in,out]*  **mat**  affine matrix

docs/source/affine.rst

@@ -0,0 +1,242 @@
+.. default-domain:: C
+
+affine transforms
+================================================================================
+
+Header: cglm/affine.h
+
+Functions with **_make** prefix expect you don't have a matrix and they create
+a matrix for you. You don't need to pass identity matrix.
+
+But other functions expect you have a matrix and you want to transform them. If
+you didn't have any existing matrix you have to initialize matrix to identity
+before sending to transfrom functions.
+
+There are also functions to decompose transform matrix. These functions can't
+decompose matrix after projected.
+
+Table of contents (click to go):
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Functions:
+
+1. :c:func:`glm_translate_to`
+#. :c:func:`glm_translate`
+#. :c:func:`glm_translate_x`
+#. :c:func:`glm_translate_y`
+#. :c:func:`glm_translate_z`
+#. :c:func:`glm_translate_make`
+#. :c:func:`glm_scale_to`
+#. :c:func:`glm_scale_make`
+#. :c:func:`glm_scale`
+#. :c:func:`glm_scale1`
+#. :c:func:`glm_scale_uni`
+#. :c:func:`glm_rotate_x`
+#. :c:func:`glm_rotate_y`
+#. :c:func:`glm_rotate_z`
+#. :c:func:`glm_rotate_ndc_make`
+#. :c:func:`glm_rotate_make`
+#. :c:func:`glm_rotate_ndc`
+#. :c:func:`glm_rotate`
+#. :c:func:`glm_decompose_scalev`
+#. :c:func:`glm_uniscaled`
+#. :c:func:`glm_decompose_rs`
+#. :c:func:`glm_decompose`
+
+Functions documentation
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. c:function:: void  glm_translate_to(mat4 m, vec3 v, mat4 dest)
+
+    translate existing transform matrix by *v* vector and store result in dest
+
+    Parameters:
+      | *[in]*  **m**    affine transfrom
+      | *[in]*  **v**    translate vector [x, y, z]
+      | *[out]* **dest** translated matrix
+
+.. c:function:: void  glm_translate(mat4 m, vec3 v)
+
+    translate existing transform matrix by *v* vector
+    and stores result in same matrix
+
+    Parameters:
+      | *[in, out]* **m**  affine transfrom
+      | *[in]*      **v**  translate vector [x, y, z]
+
+.. c:function:: void  glm_translate_x(mat4 m, float x)
+
+    translate existing transform matrix by x factor
+
+    Parameters:
+      | *[in, out]* **m**  affine transfrom
+      | *[in]*      **v**  x factor
+
+.. c:function:: void  glm_translate_y(mat4 m, float y)
+
+    translate existing transform matrix by *y* factor
+
+    Parameters:
+      | *[in, out]* **m**  affine transfrom
+      | *[in]*      **v**  y factor
+
+.. c:function:: void  glm_translate_z(mat4 m, float z)
+
+    translate existing transform matrix by *z* factor
+
+    Parameters:
+      | *[in, out]* **m**  affine transfrom
+      | *[in]*      **v**  z factor
+
+.. c:function:: void  glm_translate_make(mat4 m, vec3 v)
+
+    creates NEW translate transform matrix by *v* vector.
+
+    Parameters:
+      | *[in, out]* **m**  affine transfrom
+      | *[in]*      **v**  translate vector [x, y, z]
+
+.. c:function:: void  glm_scale_to(mat4 m, vec3 v, mat4 dest)
+
+    scale existing transform matrix by *v* vector and store result in dest
+
+    Parameters:
+      | *[in]*  **m**    affine transfrom
+      | *[in]*  **v**    scale vector [x, y, z]
+      | *[out]* **dest** scaled matrix
+
+.. c:function:: void  glm_scale_make(mat4 m, vec3 v)
+
+    creates NEW scale matrix by v vector
+
+    Parameters:
+      | *[out]* **m** affine transfrom
+      | *[in]*  **v** scale vector [x, y, z]
+
+.. c:function:: void  glm_scale(mat4 m, vec3 v)
+
+    scales existing transform matrix by v vector
+    and stores result in same matrix
+
+    Parameters:
+      | *[in, out]* **m** affine transfrom
+      | *[in]*      **v** scale vector [x, y, z]
+
+.. c:function:: void  glm_scale1(mat4 m, float s)
+
+    DEPRECATED! Use glm_scale_uni
+
+.. c:function:: void  glm_scale_uni(mat4 m, float s)
+
+    applies uniform scale to existing transform matrix v = [s, s, s]
+    and stores result in same matrix
+
+    Parameters:
+      | *[in, out]* **m** affine transfrom
+      | *[in]*      **v** scale factor
+
+.. c:function:: void  glm_rotate_x(mat4 m, float angle, mat4 dest)
+
+    rotate existing transform matrix around X axis by angle
+    and store result in dest
+
+    Parameters:
+      | *[in]*  **m**     affine transfrom
+      | *[in]*  **angle** angle (radians)
+      | *[out]* **dest**  rotated matrix
+
+.. c:function:: void  glm_rotate_y(mat4 m, float angle, mat4 dest)
+
+    rotate existing transform matrix around Y axis by angle
+    and store result in dest
+
+    Parameters:
+      | *[in]*  **m**     affine transfrom
+      | *[in]*  **angle** angle (radians)
+      | *[out]* **dest**  rotated matrix
+
+.. c:function:: void  glm_rotate_z(mat4 m, float angle, mat4 dest)
+
+    rotate existing transform matrix around Z axis by angle
+    and store result in dest
+
+    Parameters:
+      | *[in]*  **m**     affine transfrom
+      | *[in]*  **angle** angle (radians)
+      | *[out]* **dest**  rotated matrix
+
+.. c:function:: void  glm_rotate_ndc_make(mat4 m, float angle, vec3 axis_ndc)
+
+    creates NEW rotation matrix by angle and axis
+    this name may change in the future. axis must be is normalized
+
+    Parameters:
+      | *[out]* **m**        affine transfrom
+      | *[in]*  **angle**    angle (radians)
+      | *[in]*  **axis_ndc** normalized axis
+
+.. c:function:: void  glm_rotate_make(mat4 m, float angle, vec3 axis)
+
+    creates NEW rotation matrix by angle and axis,
+    axis will be normalized so you don't need to normalize it
+
+    Parameters:
+      | *[out]* **m**    affine transfrom
+      | *[in]*  **axis** angle (radians)
+      | *[in]*  **axis** axis
+
+.. c:function:: void  glm_rotate_ndc(mat4 m, float angle, vec3 axis_ndc)
+
+    rotate existing transform matrix around Z axis by angle and axis
+    this name may change in the future, axis must be normalized.
+
+    Parameters:
+      | *[out]* **m**        affine transfrom
+      | *[in]*  **angle**    angle (radians)
+      | *[in]*  **axis_ndc** normalized axis
+
+.. c:function:: void  glm_rotate(mat4 m, float angle, vec3 axis)
+
+    rotate existing transform matrix around Z axis by angle and axis
+
+    Parameters:
+      | *[in, out]* **m**     affine transfrom
+      | *[in]*      **angle** angle (radians)
+      | *[in]*      **axis**  axis
+
+.. c:function:: void  glm_decompose_scalev(mat4 m, vec3 s)
+
+    decompose scale vector
+
+    Parameters:
+      | *[in]*  **m**  affine transform
+      | *[out]* **s**  scale vector (Sx, Sy, Sz)
+
+.. c:function:: bool  glm_uniscaled(mat4 m)
+
+    returns true if matrix is uniform scaled.
+    This is helpful for creating normal matrix.
+
+    Parameters:
+      | *[in]*  **m**   matrix
+
+.. c:function:: void  glm_decompose_rs(mat4 m, mat4 r, vec3 s)
+
+    decompose rotation matrix (mat4) and scale vector [Sx, Sy, Sz]
+    DON'T pass projected matrix here
+
+    Parameters:
+      | *[in]*  **m** affine transform
+      | *[out]* **r** rotation matrix
+      | *[out]* **s** scale matrix
+
+.. c:function:: void  glm_decompose(mat4 m, vec4 t, mat4 r, vec3 s)
+
+    decompose affine transform, TODO: extract shear factors.
+    DON'T pass projected matrix here
+
+    Parameters:
+      | *[in]*  **m** affine transfrom
+      | *[out]* **t** translation vector
+      | *[out]* **r** rotation matrix (mat4)
+      | *[out]* **s** scaling vector [X, Y, Z]

docs/source/api.rst

@@ -0,0 +1,46 @@
+API documentation
+================================
+
+Some functions may exist twice,
+once for their namespace and once for global namespace
+to make easier to write very common functions
+
+For instance, in general we use :code:`glm_vec_dot` to get dot product
+of two **vec3**. Now we can also do this with :code:`glm_dot`,
+same for *_cross* and so on...
+
+The original function stays where it is, the function in global namespace
+of same name is just an alias, so there is no call version of those functions.
+e.g there is no func like :code:`glmc_dot` because *glm_dot* is just alias for
+:code:`glm_vec_dot`
+
+By including **cglm/cglm.h** header you will include all inline version
+of functions. Since functions in this header[s] are inline you don't need to
+build or link *cglm* against your project.
+
+But by including **cglm/call.h** header you will include all *non-inline*
+version of functions. You need to build *cglm* and link it.
+Follow the :doc:`build` documentation for this
+
+.. toctree::
+   :maxdepth: 1
+   :caption: API categories:
+
+   affine
+   affine-mat
+   cam
+   frustum
+   box
+   quat
+   euler
+   mat4
+   mat3
+   vec3
+   vec3-ext
+   vec4
+   vec4-ext
+   color
+   plane
+   util
+   io
+   call

docs/source/box.rst

@@ -0,0 +1,92 @@
+.. default-domain:: C
+
+axis aligned bounding box (AABB)
+================================================================================
+
+Header: cglm/box.h
+
+Some convenient functions provided for AABB.
+
+**Definition of box:**
+
+cglm defines box as two dimensional array of vec3.
+The first element is **min** point and the second one is **max** point.
+If you have another type e.g. struct or even another representation then you must
+convert it before and after call cglm box function.
+
+Table of contents (click to go):
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Functions:
+
+1. :c:func:`glm_aabb_transform`
+#. :c:func:`glm_aabb_merge`
+#. :c:func:`glm_aabb_crop`
+#. :c:func:`glm_aabb_crop_until`
+
+Functions documentation
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. c:function:: void  glm_aabb_transform(vec3 box[2], mat4 m, vec3 dest[2])
+
+    | apply transform to Axis-Aligned Bounding Box
+
+    Parameters:
+      | *[in]*  **box**   bounding box
+      | *[in]*  **m**     transform matrix
+      | *[out]* **dest**  transformed bounding box
+
+.. c:function:: void  glm_aabb_merge(vec3 box1[2], vec3 box2[2], vec3 dest[2])
+
+    | merges two AABB bounding box and creates new one
+
+    two box must be in same space, if one of box is in different space then
+    you should consider to convert it's space by glm_box_space
+
+    Parameters:
+      | *[in]*  **box1** bounding box 1
+      | *[in]*  **box2** bounding box 2
+      | *[out]* **dest** merged bounding box
+
+.. c:function:: void  glm_aabb_crop(vec3 box[2], vec3 cropBox[2], vec3 dest[2])
+
+    | crops a bounding box with another one.
+
+    this could be useful for gettng a bbox which fits with view frustum and
+    object bounding boxes. In this case you crop view frustum box with objects
+    box
+
+    Parameters:
+      | *[in]*  **box**      bounding box 1
+      | *[in]*  **cropBox**  crop box
+      | *[out]* **dest**     cropped bounding box
+
+.. c:function:: void  glm_frustum_box(vec4 corners[8], mat4 m, vec3 box[2])
+
+    | crops a bounding box with another one.
+
+    this could be useful for gettng a bbox which fits with view frustum and
+    object bounding boxes. In this case you crop view frustum box with objects
+    box
+
+    Parameters:
+      | *[in]*  **box**      bounding box
+      | *[in]*  **cropBox**  crop box
+      | *[in]*  **clampBox** miniumum box
+      | *[out]* **dest**     cropped bounding box
+
+.. c:function:: bool  glm_aabb_frustum(vec3 box[2], vec4 planes[6])
+
+    | check if AABB intersects with frustum planes
+
+    this could be useful for frustum culling using AABB.
+
+    OPTIMIZATION HINT:
+       if planes order is similar to LEFT, RIGHT, BOTTOM, TOP, NEAR, FAR
+       then this method should run even faster because it would only use two
+       planes if object is not inside the two planes
+       fortunately cglm extracts planes as this order! just pass what you got!
+
+    Parameters:
+      | *[in]*   **box**     bounding box
+      | *[out]*  **planes**  frustum planes

docs/source/build.rst

@@ -0,0 +1,52 @@
+Building cglm
+================================
+
+| **cglm** does not have external dependencies except for unit testing.
+| When you pulled cglm repo with submodules all dependencies will be pulled too.
+| `build-deps.sh` will pull all dependencies/submodules and build for you.
+
+External dependencies:
+  * cmocka - for unit testing
+
+**NOTE:**
+If you only need to inline versions, you don't need to build **cglm**, you don't need to link it to your program.
+Just import cglm to your project as dependency / external lib by copy-paste then use it as usual
+
+**Unix (Autotools):**
+
+.. code-block:: bash
+  :linenos:
+
+  $ sh ./build-deps.sh    # run this only once (dependencies)
+
+  $ sh autogen.sh
+  $ ./configure
+  $ make
+  $ make check            # run tests (optional)
+  $ [sudo] make install   # install to system (optional)
+
+**make** will build cglm to **.libs** sub folder in project folder.
+If you don't want to install cglm to your system's folder you can get static and dynamic libs in this folder.
+
+**Build dependencies (windows):**
+
+Windows related build files, project files are located in win folder,
+make sure you are inside in cglm/win folder.
+
+Code Analysis are enabled, it may take awhile to build.
+
+.. code-block:: bash
+  :linenos:
+
+  $ cd win
+  $ .\build.bat
+
+if *msbuild* is not worked (because of multi versions of Visual Studio)
+then try to build with *devenv*:
+
+.. code-block:: bash
+  :linenos:
+
+  $ devenv cglm.sln /Build Release
+
+Currently tests are not available on Windows.

docs/source/call.rst

@@ -0,0 +1,19 @@
+.. default-domain:: C
+
+precompiled functions (call)
+================================================================================
+
+All funcitons in **glm_** namespace are forced to **inline**.
+Most functions also have pre-compiled version.
+
+Precompiled versions are in **glmc_** namespace. *c* in the namespace stands for
+"call".
+
+Since precompiled functions are just wrapper for inline verisons,
+these functions are not documented individually.
+It would be duplicate documentation also it
+would be hard to sync documentation between inline and call verison for me.
+
+By including **clgm/cglm.h** you include all inline verisons. To get precompiled
+versions you need to include **cglm/call.h** header it also includes all
+call versions plus *clgm/cglm.h* (inline verisons)

docs/source/cam.rst

@@ -0,0 +1,298 @@
+.. default-domain:: C
+
+camera
+======
+
+Header: cglm/cam.h
+
+There are many convenient functions for camera. For instance :c:func:`glm_look`
+is just wrapper for :c:func:`glm_lookat`. Sometimes you only have direction
+instead of target, so that makes easy to build view matrix using direction.
+There is also :c:func:`glm_look_anyup` function which can help build view matrix
+without providing UP axis. It uses :c:func:`glm_vec_ortho` to get a UP axis and
+builds view matrix.
+
+You can also *_default* versions of ortho and perspective to build projection
+fast if you don't care specific projection values.
+
+*_decomp* means decompose; these function can help to decompose projection
+matrices.
+
+ **NOTE**: Be careful when working with high range (very small near, very large
+ far) projection matrices. You may not get exact value you gave.
+ **float** type cannot store very high precision so you will lose precision.
+ Also your projection matrix will be inaccurate due to losing precision
+
+Table of contents (click to go):
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Functions:
+
+1. :c:func:`glm_frustum`
+#. :c:func:`glm_ortho`
+#. :c:func:`glm_ortho_aabb`
+#. :c:func:`glm_ortho_aabb_p`
+#. :c:func:`glm_ortho_aabb_pz`
+#. :c:func:`glm_ortho_default`
+#. :c:func:`glm_ortho_default_s`
+#. :c:func:`glm_perspective`
+#. :c:func:`glm_perspective_default`
+#. :c:func:`glm_perspective_resize`
+#. :c:func:`glm_lookat`
+#. :c:func:`glm_look`
+#. :c:func:`glm_look_anyup`
+#. :c:func:`glm_persp_decomp`
+#. :c:func:`glm_persp_decompv`
+#. :c:func:`glm_persp_decomp_x`
+#. :c:func:`glm_persp_decomp_y`
+#. :c:func:`glm_persp_decomp_z`
+#. :c:func:`glm_persp_decomp_far`
+#. :c:func:`glm_persp_decomp_near`
+#. :c:func:`glm_persp_fovy`
+#. :c:func:`glm_persp_aspect`
+#. :c:func:`glm_persp_sizes`
+
+Functions documentation
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. c:function:: void  glm_frustum(float left, float right, float bottom, float top, float nearVal, float farVal, mat4  dest)
+
+    | set up perspective peprojection matrix
+
+    Parameters:
+      | *[in]*  **left**      viewport.left
+      | *[in]*  **right**     viewport.right
+      | *[in]*  **bottom**    viewport.bottom
+      | *[in]*  **top**       viewport.top
+      | *[in]*  **nearVal**   near clipping plane
+      | *[in]*  **farVal**    far clipping plane
+      | *[out]* **dest**      result matrix
+
+.. c:function:: void  glm_ortho(float left, float right, float bottom, float top, float nearVal, float farVal, mat4  dest)
+
+    | set up orthographic projection matrix
+
+    Parameters:
+      | *[in]*  **left**      viewport.left
+      | *[in]*  **right**     viewport.right
+      | *[in]*  **bottom**    viewport.bottom
+      | *[in]*  **top**       viewport.top
+      | *[in]*  **nearVal**   near clipping plane
+      | *[in]*  **farVal**    far clipping plane
+      | *[out]* **dest**      result matrix
+
+.. c:function:: void  glm_ortho_aabb(vec3 box[2], mat4 dest)
+
+    | set up orthographic projection matrix using bounding box
+    | bounding box (AABB) must be in view space
+
+    Parameters:
+      | *[in]*  **box**   AABB
+      | *[in]*  **dest**  result matrix
+
+.. c:function:: void  glm_ortho_aabb_p(vec3 box[2], float padding, mat4 dest)
+
+    | set up orthographic projection matrix using bounding box
+    | bounding box (AABB) must be in view space
+
+    this version adds padding to box
+
+    Parameters:
+      | *[in]*  **box**      AABB
+      | *[in]*  **padding**  padding
+      | *[out]* **d**        result matrix
+
+.. c:function:: void  glm_ortho_aabb_pz(vec3 box[2], float padding, mat4 dest)
+
+    | set up orthographic projection matrix using bounding box
+    | bounding box (AABB) must be in view space
+
+    this version adds Z padding to box
+
+    Parameters:
+      | *[in]*  **box**      AABB
+      | *[in]*  **padding**  padding for near and far
+      | *[out]* **d**        result matrix
+
+    Returns:
+      square of norm / magnitude
+
+.. c:function:: void  glm_ortho_default(float aspect, mat4  dest)
+
+    | set up unit orthographic projection matrix
+
+    Parameters:
+      | *[in]*  **aspect** aspect ration ( width / height )
+      | *[out]* **dest**   result matrix
+
+.. c:function:: void  glm_ortho_default_s(float aspect, float size, mat4  dest)
+
+    | set up orthographic projection matrix with given CUBE size
+
+    Parameters:
+      | *[in]*  **aspect** aspect ration ( width / height )
+      | *[in]*  **size**   cube size
+      | *[out]* **dest**   result matrix
+
+.. c:function:: void  glm_perspective(float fovy, float aspect, float nearVal, float farVal, mat4  dest)
+
+    | set up perspective projection matrix
+
+    Parameters:
+      | *[in]*  **fovy**    field of view angle
+      | *[in]*  **aspect**  aspect ratio ( width / height )
+      | *[in]*  **nearVal** near clipping plane
+      | *[in]*  **farVal**  far clipping planes
+      | *[out]* **dest**    result matrix
+
+.. c:function:: void glm_perspective_default(float aspect, mat4 dest)
+
+     | set up perspective projection matrix with default near/far
+       and angle values
+
+    Parameters:
+      | *[in]*  **aspect** aspect aspect ratio ( width / height )
+      | *[out]* **dest**   result matrix
+
+.. c:function:: void  glm_perspective_resize(float aspect, mat4 proj)
+
+    | resize perspective matrix by aspect ratio ( width / height )
+      this makes very easy to resize proj matrix when window / viewport reized
+
+    Parameters:
+      | *[in]*      **aspect** aspect ratio ( width / height )
+      | *[in, out]* **proj**   perspective projection matrix
+
+.. c:function:: void  glm_lookat(vec3 eye, vec3 center, vec3 up, mat4 dest)
+
+    | set up view matrix
+
+    Parameters:
+    | *[in]*  **eye**     eye vector
+    | *[in]*  **center**  center vector
+    | *[in]*  **up**      up vector
+    | *[out]* **dest**    result matrix
+
+.. c:function:: void  glm_look(vec3 eye, vec3 dir, vec3 up, mat4 dest)
+
+    | set up view matrix
+
+    convenient wrapper for :c:func:`glm_lookat`: if you only have direction not
+    target self then this might be useful. Because you need to get target
+    from direction.
+
+    Parameters:
+      | *[in]*  **eye**     eye vector
+      | *[in]*  **center**  direction vector
+      | *[in]*  **up**      up vector
+      | *[out]* **dest**    result matrix
+
+.. c:function:: void  glm_look_anyup(vec3 eye, vec3 dir, mat4 dest)
+
+    | set up view matrix
+
+    convenient wrapper for :c:func:`glm_look` if you only have direction
+    and if you don't care what UP vector is then this might be useful
+    to create view matrix
+
+    Parameters:
+      | *[in]*  **eye**     eye vector
+      | *[in]*  **center**  direction vector
+      | *[out]* **dest**    result matrix
+
+.. c:function:: void  glm_persp_decomp(mat4 proj, float *nearVal, float *farVal, float *top, float *bottom, float *left, float *right)
+
+    | decomposes frustum values of perspective projection.
+
+    Parameters:
+      | *[in]*  **eye**       perspective projection matrix
+      | *[out]*  **nearVal**  near
+      | *[out]*  **farVal**   far
+      | *[out]*  **top**      top
+      | *[out]*  **bottom**   bottom
+      | *[out]*  **left**     left
+      | *[out]* **right**     right
+
+.. c:function:: void  glm_persp_decompv(mat4 proj, float dest[6])
+
+    | decomposes frustum values of perspective projection.
+    | this makes easy to get all values at once
+
+    Parameters:
+      | *[in]*   **proj**  perspective projection matrix
+      | *[out]*  **dest**  array
+
+.. c:function:: void  glm_persp_decomp_x(mat4 proj, float *left, float *right)
+
+    | decomposes left and right values of perspective projection.
+    | x stands for x axis (left / right axis)
+
+    Parameters:
+      | *[in]*   **proj**   perspective projection matrix
+      | *[out]*  **left**   left
+      | *[out]*  **right**  right
+
+.. c:function:: void  glm_persp_decomp_y(mat4 proj, float *top, float *bottom)
+
+    | decomposes top and bottom values of perspective projection.
+    | y stands for y axis (top / botom axis)
+
+    Parameters:
+      | *[in]*   **proj**    perspective projection matrix
+      | *[out]*  **top**     top
+      | *[out]*  **bottom**  bottom
+
+.. c:function:: void  glm_persp_decomp_z(mat4 proj, float *nearVal, float *farVal)
+
+    | decomposes near and far values of perspective projection.
+    | z stands for z axis (near / far axis)
+
+    Parameters:
+      | *[in]*   **proj**     perspective projection matrix
+      | *[out]*  **nearVal**  near
+      | *[out]*  **farVal**   far
+
+.. c:function:: void  glm_persp_decomp_far(mat4 proj, float * __restrict farVal)
+
+    | decomposes far value of perspective projection.
+
+    Parameters:
+      | *[in]*  **proj**    perspective projection matrix
+      | *[out]* **farVal**  far
+
+.. c:function:: void  glm_persp_decomp_near(mat4 proj, float * __restrict nearVal)
+
+    | decomposes near value of perspective projection.
+
+    Parameters:
+      | *[in]*  **proj**    perspective projection matrix
+      | *[out]* **nearVal** near
+
+.. c:function:: float  glm_persp_fovy(mat4 proj)
+
+    | returns field of view angle along the Y-axis (in radians)
+
+    if you need to degrees, use glm_deg to convert it or use this:
+    fovy_deg = glm_deg(glm_persp_fovy(projMatrix))
+
+    Parameters:
+      | *[in]*  **proj**  perspective projection matrix
+
+    Returns:
+      | fovy in radians
+
+.. c:function:: float  glm_persp_aspect(mat4 proj)
+
+    | returns aspect ratio of perspective projection
+
+    Parameters:
+      | *[in]*  **proj**  perspective projection matrix
+
+.. c:function:: void  glm_persp_sizes(mat4 proj, float fovy, vec4 dest)
+
+    | returns sizes of near and far planes of perspective projection
+
+    Parameters:
+      | *[in]*  **proj**  perspective projection matrix
+      | *[in]*  **fovy**  fovy (see brief)
+      | *[out]* **dest**  sizes order: [Wnear, Hnear, Wfar, Hfar]

docs/source/color.rst

@@ -0,0 +1,34 @@
+.. default-domain:: C
+
+color
+================================================================================
+
+Header: cglm/color.h
+
+Table of contents (click to go):
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Functions:
+
+1. :c:func:`glm_luminance`
+
+Functions documentation
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. c:function:: float  glm_luminance(vec3 rgb)
+
+    | averages the color channels into one value
+
+    This function uses formula in COLLADA 1.5 spec which is
+
+    .. code-block:: text
+
+       luminance = (color.r * 0.212671) +
+                   (color.g * 0.715160) +
+                   (color.b * 0.072169)
+
+    It is based on the ISO/CIE color standards (see ITU-R Recommendation BT.709-4),
+    that averages the color channels into one value
+
+    Parameters:
+      | *[in]*  **rgb**   RGB color

docs/source/conf.py

@@ -0,0 +1,199 @@
+# -*- coding: utf-8 -*-
+#
+# cglm documentation build configuration file, created by
+# sphinx-quickstart on Tue Jun  6 20:31:05 2017.
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#
+# import os
+# import sys
+# sys.path.insert(0, os.path.abspath('.'))
+
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+#
+# needs_sphinx = '1.0'
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    'sphinx.ext.doctest',
+    'sphinx.ext.todo',
+    'sphinx.ext.coverage',
+    'sphinx.ext.mathjax',
+    'sphinx.ext.ifconfig',
+    'sphinx.ext.viewcode',
+    'sphinx.ext.githubpages'
+]
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+#
+# source_suffix = ['.rst', '.md']
+source_suffix = '.rst'
+
+# The master toctree document.
+master_doc = 'index'
+
+# General information about the project.
+project = u'cglm'
+copyright = u'2017, Recep Aslantas'
+author = u'Recep Aslantas'
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The short X.Y version.
+version = u'0.3.4'
+# The full version, including alpha/beta/rc tags.
+release = u'0.3.4'
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This patterns also effect to html_static_path and html_extra_path
+exclude_patterns = []
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = 'sphinx'
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = False
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+#
+html_theme = 'alabaster'
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+#
+# html_theme_options = {}
+
+html_theme_options = {
+    'github_banner': 'true',
+    'github_button': 'true',
+    'github_user': 'recp',
+    'github_repo': 'cglm',
+    'travis_button': 'true',
+    'show_related': 'true',
+    'fixed_sidebar': 'true'
+}
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ['_static']
+
+
+# -- Options for HTMLHelp output ------------------------------------------
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = 'cglmdoc'
+
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #
+    # 'papersize': 'letterpaper',
+
+    # The font size ('10pt', '11pt' or '12pt').
+    #
+    # 'pointsize': '10pt',
+
+    # Additional stuff for the LaTeX preamble.
+    #
+    # 'preamble': '',
+
+    # Latex figure (float) alignment
+    #
+    # 'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (master_doc, 'cglm.tex', u'cglm Documentation',
+     u'Recep Aslantas', 'manual'),
+]
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (master_doc, 'cglm', u'cglm Documentation',
+     [author], 1)
+]
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (master_doc, 'cglm', u'cglm Documentation',
+     author, 'cglm', 'One line description of project.',
+     'Miscellaneous'),
+]
+
+# -- Options for Epub output -------------------------------------------------
+
+# Bibliographic Dublin Core info.
+epub_title = project
+epub_author = author
+epub_publisher = author
+epub_copyright = copyright
+
+# The unique identifier of the text. This can be a ISBN number
+# or the project homepage.
+#
+# epub_identifier = ''
+
+# A unique identification for the text.
+#
+# epub_uid = ''
+
+# A list of files that should not be packed into the epub file.
+epub_exclude_files = ['search.html']
+
+
+# -- Extension configuration -------------------------------------------------
+
+# -- Options for todo extension ----------------------------------------------
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True

docs/source/euler.rst

@@ -0,0 +1,171 @@
+.. default-domain:: C
+
+euler angles
+============
+
+Header: cglm/euler.h
+
+You may wonder what **glm_euler_sq** type ( **_sq** stands for sequence ) and
+:c:func:`glm_euler_by_order` do.
+I used them to convert euler angles in one coordinate system to another. For
+instance if you have **Z_UP** euler angles and if you want to convert it
+to **Y_UP** axis then :c:func:`glm_euler_by_order` is your friend. For more
+information check :c:func:`glm_euler_order` documentation
+
+You must pass arrays as array, if you use C compiler then you can use something
+like this:
+
+.. code-block:: c
+
+   float pitch, yaw, roll;
+   mat4  rot;
+
+   /* pitch = ...; yaw = ...; roll = ... */
+   glm_euler((vec3){pitch, yaw, roll}, rot);
+
+Rotation Conveniention
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Current *cglm*'s euler functions uses these convention:
+
+* Tait–Bryan angles (x-y-z convention)
+* Intrinsic rotations (pitch, yaw and roll).
+  This is reserve order of extrinsic (elevation, heading and bank) rotation
+* Right hand rule (actually all rotations in *cglm* use **RH**)
+* All angles used in *cglm* are **RADIANS** not degrees
+
+
+**NOTE**: The default :c:func:`glm_euler` function is the short name of
+:c:func:`glm_euler_xyz` this is why you can't see :c:func:`glm_euler_xyz`.
+When you see an euler function which doesn't have any X, Y, Z suffix then
+assume that uses **_xyz** (or instead it accept order as parameter).
+
+If rotation doesn't work properly, your options:
+
+1. If you use (or paste) degrees convert it to radians before calling an euler function
+
+.. code-block:: c
+
+   float pitch, yaw, roll;
+   mat4  rot;
+
+   /* pitch = degrees; yaw = degrees; roll = degrees */
+   glm_euler((vec3){glm_rad(pitch), glm_rad(yaw), glm_rad(roll)}, rot);
+
+2. Convention mismatch. You may have extrinsic angles,
+   if you do (if you must) then consider to use reverse order e.g if you have
+   **xyz** extrinsic then use **zyx**
+
+3. *cglm* may implemented it wrong, consider to create an issue to report it
+   or pull request to fix it
+
+Table of contents (click to go):
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Types:
+
+1. glm_euler_sq
+
+Functions:
+
+1. :c:func:`glm_euler_order`
+#. :c:func:`glm_euler_angles`
+#. :c:func:`glm_euler`
+#. :c:func:`glm_euler_zyx`
+#. :c:func:`glm_euler_zxy`
+#. :c:func:`glm_euler_xzy`
+#. :c:func:`glm_euler_yzx`
+#. :c:func:`glm_euler_yxz`
+#. :c:func:`glm_euler_by_order`
+
+Functions documentation
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. c:function:: glm_euler_sq  glm_euler_order(int ord[3])
+
+    | packs euler angles order to glm_euler_sq enum.
+
+    To use :c:func:`glm_euler_by_order` function you need *glm_euler_sq*. You
+    can get it with this function.
+
+    You can build param like this:
+
+    | X = 0, Y = 1, Z = 2
+
+    if you have ZYX order then you pass this: [2, 1, 0] = ZYX.
+    if you have YXZ order then you pass this: [1, 0, 2] = YXZ
+
+    As you can see first item specifies which axis will be first then the
+    second one specifies which one will be next an so on.
+
+    Parameters:
+      | *[in]*  **ord**  euler angles order [Angle1, Angle2, Angle2]
+
+    Returns:
+      packed euler order
+
+.. c:function:: void  glm_euler_angles(mat4 m, vec3 dest)
+
+    | extract euler angles (in radians) using xyz order
+
+    Parameters:
+      | *[in]*  **m**     affine transform
+      | *[out]* **dest**  angles vector [x, y, z]
+
+.. c:function:: void  glm_euler(vec3 angles, mat4 dest)
+
+    | build rotation matrix from euler angles
+
+    Parameters:
+      | *[in]*  **angles**  angles as vector [Ex, Ey, Ez]
+      | *[in]*  **dest**    rotation matrix
+
+.. c:function:: void  glm_euler_zyx(vec3 angles, mat4 dest)
+
+    | build rotation matrix from euler angles
+
+    Parameters:
+      | *[in]*  **angles**  angles as vector [Ez, Ey, Ex]
+      | *[in]*  **dest**    rotation matrix
+
+.. c:function:: void  glm_euler_zxy(vec3 angles, mat4 dest)
+
+    | build rotation matrix from euler angles
+
+    Parameters:
+      | *[in]*  **angles**  angles as vector [Ez, Ex, Ey]
+      | *[in]*  **dest**    rotation matrix
+
+.. c:function:: void  glm_euler_xzy(vec3 angles, mat4 dest)
+
+    | build rotation matrix from euler angles
+
+    Parameters:
+      | *[in]*  **angles**  angles as vector [Ex, Ez, Ey]
+      | *[in]*  **dest**    rotation matrix
+
+.. c:function:: void  glm_euler_yzx(vec3 angles, mat4 dest)
+
+    build rotation matrix from euler angles
+
+    Parameters:
+      | *[in]*  **angles**  angles as vector [Ey, Ez, Ex]
+      | *[in]*  **dest**    rotation matrix
+
+.. c:function:: void  glm_euler_yxz(vec3 angles, mat4 dest)
+
+    | build rotation matrix from euler angles
+
+    Parameters:
+      | *[in]*  **angles**  angles as vector [Ey, Ex, Ez]
+      | *[in]*  **dest**    rotation matrix
+
+.. c:function:: void glm_euler_by_order(vec3 angles, glm_euler_sq ord, mat4 dest)
+
+    | build rotation matrix from euler angles with given euler order.
+
+    Use :c:func:`glm_euler_order` function to build *ord* parameter
+
+    Parameters:
+      | *[in]*  **angles**  angles as vector (ord parameter spceifies angles order)
+      | *[in]*  **ord**     euler order
+      | *[in]*  **dest**    rotation matrix

docs/source/frustum.rst

@@ -0,0 +1,168 @@
+.. default-domain:: C
+
+frustum
+=============
+
+Header: cglm/frustum.h
+
+cglm provides convenient functions to extract frustum planes, corners...
+All extracted corners are **vec4** so you must create array of **vec4**
+not **vec3**. If you want to store them to save space you msut convert them
+yourself.
+
+**vec4** is used to speed up functions need to corners. This is why frustum
+fucntions use *vec4* instead of *vec3*
+
+Currenty related-functions use [-1, 1] clip space configuration to extract
+corners but you can override it by prodiving **GLM_CUSTOM_CLIPSPACE** macro.
+If you provide it then you have to all bottom macros as *vec4*
+
+Current configuration:
+
+.. code-block:: c
+
+   /* near */
+   GLM_CSCOORD_LBN {-1.0f, -1.0f, -1.0f, 1.0f}
+   GLM_CSCOORD_LTN {-1.0f,  1.0f, -1.0f, 1.0f}
+   GLM_CSCOORD_RTN { 1.0f,  1.0f, -1.0f, 1.0f}
+   GLM_CSCOORD_RBN { 1.0f, -1.0f, -1.0f, 1.0f}
+
+   /* far */
+   GLM_CSCOORD_LBF {-1.0f, -1.0f,  1.0f, 1.0f}
+   GLM_CSCOORD_LTF {-1.0f,  1.0f,  1.0f, 1.0f}
+   GLM_CSCOORD_RTF { 1.0f,  1.0f,  1.0f, 1.0f}
+   GLM_CSCOORD_RBF { 1.0f, -1.0f,  1.0f, 1.0f}
+
+
+Explain of short names:
+  * **LBN**: left  bottom near
+  * **LTN**: left  top    near
+  * **RTN**: right top    near
+  * **RBN**: right bottom near
+  * **LBF**: left  bottom far
+  * **LTF**: left  top    far
+  * **RTF**: right top    far
+  * **RBF**: right bottom far
+
+Table of contents (click to go):
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Macros:
+
+.. code-block:: c
+
+   GLM_LBN    0 /* left  bottom near */
+   GLM_LTN    1 /* left  top    near */
+   GLM_RTN    2 /* right top    near */
+   GLM_RBN    3 /* right bottom near */
+
+   GLM_LBF    4 /* left  bottom far  */
+   GLM_LTF    5 /* left  top    far  */
+   GLM_RTF    6 /* right top    far  */
+   GLM_RBF    7 /* right bottom far  */
+
+   GLM_LEFT   0
+   GLM_RIGHT  1
+   GLM_BOTTOM 2
+   GLM_TOP    3
+   GLM_NEAR   4
+   GLM_FAR    5
+
+Functions:
+
+1. :c:func:`glm_frustum_planes`
+#. :c:func:`glm_frustum_corners`
+#. :c:func:`glm_frustum_center`
+#. :c:func:`glm_frustum_box`
+#. :c:func:`glm_frustum_corners_at`
+
+Functions documentation
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. c:function:: void  glm_frustum_planes(mat4 m, vec4 dest[6])
+
+    | extracts view frustum planes
+
+    planes' space:
+     - if m = proj:     View Space
+     - if m = viewProj: World Space
+     - if m = MVP:      Object Space
+
+    You probably want to extract planes in world space so use viewProj as m
+    Computing viewProj:
+
+    .. code-block:: c
+
+       glm_mat4_mul(proj, view, viewProj);
+
+    Exracted planes order: [left, right, bottom, top, near, far]
+
+    Parameters:
+      | *[in]*  **m**     matrix
+      | *[out]* **dest**  exracted view frustum planes
+
+.. c:function:: void  glm_frustum_corners(mat4 invMat, vec4 dest[8])
+
+    | extracts view frustum corners using clip-space coordinates
+
+    corners' space:
+     - if m = invViewProj: World Space
+     - if m = invMVP:      Object Space
+
+    You probably want to extract corners in world space so use **invViewProj**
+    Computing invViewProj:
+
+    .. code-block:: c
+
+       glm_mat4_mul(proj, view, viewProj);
+       ...
+       glm_mat4_inv(viewProj, invViewProj);
+
+    if you have a near coord at **i** index,
+    you can get it's far coord by i + 4;
+    follow example below to understand that
+
+    For instance to find center coordinates between a near and its far coord:
+
+    .. code-block:: c
+
+       for (j = 0; j < 4; j++) {
+         glm_vec_center(corners[i], corners[i + 4], centerCorners[i]);
+       }
+
+    corners[i + 4] is far of corners[i] point.
+
+    Parameters:
+      | *[in]*  **invMat** matrix
+      | *[out]* **dest**   exracted view frustum corners
+
+.. c:function:: void  glm_frustum_center(vec4 corners[8], vec4 dest)
+
+    | finds center of view frustum
+
+    Parameters:
+      | *[in]*  **corners**  view frustum corners
+      | *[out]* **dest**     view frustum center
+
+.. c:function:: void  glm_frustum_box(vec4 corners[8], mat4 m, vec3 box[2])
+
+    | finds bounding box of frustum relative to given matrix e.g. view mat
+
+    Parameters:
+      | *[in]*  **corners**  view frustum corners
+      | *[in]*  **m**        matrix to convert existing conners
+      | *[out]* **box**      bounding box as array [min, max]
+
+.. c:function:: void  glm_frustum_corners_at(vec4  corners[8], float splitDist, float farDist, vec4  planeCorners[4])
+
+    | finds planes corners which is between near and far planes (parallel)
+
+    this will be helpful if you want to split a frustum e.g. CSM/PSSM. This will
+    find planes' corners but you will need to one more plane.
+    Actually you have it, it is near, far or created previously with this func ;)
+
+    Parameters:
+      | *[in]*   **corners**       frustum corners
+      | *[in]*   **splitDist**     split distance
+      | *[in]*   **farDist**       far distance (zFar)
+      | *[out]*  **planeCorners**  plane corners [LB, LT, RT, RB]

docs/source/getting_started.rst

@@ -0,0 +1,96 @@
+Getting Started
+================================
+
+Types:
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+**cglm** uses **glm** prefix for all functions e.g. glm_lookat. You can see supported types in common header file:
+
+.. code-block:: c
+  :linenos:
+
+   typedef float vec3[3];
+   typedef int  ivec3[3];
+   typedef CGLM_ALIGN(16) float vec4[4];
+
+   typedef vec3 mat3[3];
+   typedef vec4 mat4[4];
+
+   typedef vec4 versor;
+
+As you can see types don't store extra informations in favor of space.
+You can send these values e.g. matrix to OpenGL directly without casting or calling a function like *value_ptr*
+
+Aligment is Required:
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+**vec4** and **mat4** requires 16 byte aligment because vec4 and mat4 operations are
+vectorized by SIMD instructions (SSE/AVX).
+
+Allocations:
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+*cglm* doesn't alloc any memory on heap. So it doesn't provide any allocator.
+You must allocate memory yourself. You should alloc memory for out parameters too if you pass pointer of memory location.
+When allocating memory don't forget that **vec4** and **mat4** requires aligment.
+
+**NOTE:** Unaligned vec4 and unaligned mat4 operations will be supported in the future. Check todo list.
+Because you may want to multiply a CGLM matrix with external matrix.
+There is no guarantee that non-CGLM matrix is aligned. Unaligned types will have *u* prefix e.g. **umat4**
+
+Array vs Struct:
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+*cglm* uses arrays for vector and matrix types. So you can't access individual
+elements like vec.x, vec.y, vec.z... You must use subscript to access vector elements
+e.g. vec[0], vec[1], vec[2].
+
+Also I think it is more meaningful to access matrix elements with subscript
+e.g **matrix[2][3]** instead of **matrix._23**. Since matrix is array of vectors,
+vectors are also defined as array. This makes types homogeneous.
+
+**Return arrays?**
+
+Since C doesn't support return arrays, cglm also doesn't support this feature.
+
+Function design:
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. image:: cglm-intro.png
+   :width: 492px 
+   :height: 297px
+   :align: center
+
+cglm provides a few way to call a function to do same operation.
+
+* Inline - *glm_, glm_u*
+* Pre-compiled - *glmc_, glmc_u*
+
+For instance **glm_mat4_mul** is inline (all *glm_* functions are inline), to make it non-inline (pre-compiled),
+call it as **glmc_mat4_mul** from library, to use unaligned version use **glm_umat4_mul** (todo).
+
+Most functions have **dest** parameter for output. For instance mat4_mul func looks like this:
+
+.. code-block:: c
+
+   CGLM_INLINE
+   void
+   glm_mat4_mul(mat4 m1, mat4 m2, mat4 dest)
+
+The dest parameter is out parameter. Result will be stored in **dest**.
+Also in this case matrix multiplication order is dest = m1 * m2.
+
+* Changing parameter order will change the multiplication order.
+* You can pass all parameter same (this is similar to m1 `*=` m1), you can pass **dest** as m1 or m2 (this is similar to m1 `*=` m2)
+
+**v** postfix in function names
+-------------------------------
+
+You may see **v** postfix in some function names, v stands for vector.
+For instance consider a function that accepts three parameters x, y, z.
+This function may be overloaded by **v** postfix to accept vector (vec3) instead of separate parameters.
+In some places the v means that it will be apply to a vector.
+
+**_to** postfix in function names
+---------------------------------
+
+*_to* version of function will store the result in specified parameter instead of in-out parameter.
+Some functions don't have _to prefix but they still behave like this e.g. glm_mat4_mul.

docs/source/index.rst

@@ -0,0 +1,49 @@
+.. cglm documentation master file, created by
+   sphinx-quickstart on Tue Jun  6 20:31:05 2017.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+Welcome to cglm's documentation!
+================================
+
+**cglm** is optimized 3D math library written in C99 (compatible with C89).
+It is similar to original **glm** library except this is mainly for **C**
+
+This library stores matrices as column-major order but in the future row-major
+is considered to be supported as optional.
+
+Also currently only **float** type is supported for most operations.
+
+**Features**
+
+* general purpose matrix operations (mat4, mat3)
+* chain matrix multiplication (square only)
+* general purpose vector operations (cross, dot, rotate, proj, angle...)
+* affine transforms
+* matrix decomposition (extract rotation, scaling factor)
+* optimized affine transform matrices (mul, rigid-body inverse)
+* camera (lookat)
+* projections (ortho, perspective)
+* quaternions
+* euler angles / yaw-pitch-roll to matrix
+* extract euler angles
+* inline or pre-compiled function call
+* frustum (extract view frustum planes, corners...)
+* bounding box (AABB in Frustum (culling), crop, merge...)
+
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Table Of Contents:
+
+   build
+   getting_started
+   opengl
+   api
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`

docs/source/io.rst

@@ -0,0 +1,92 @@
+.. default-domain:: C
+
+io (input / output e.g. print)
+================================================================================
+
+Header: cglm/io.h
+
+There are some built-in print functions which may save your time,
+especially for debugging.
+
+All functions accept **FILE** parameter which makes very flexible.
+You can even print it to file on disk.
+
+In general you will want to print them to console to see results.
+You can use **stdout** and **stderr** to write results to console.
+Some programs may occupy **stdout** but you can still use **stderr**.
+Using **stderr** is suggested.
+
+Example to print mat4 matrix:
+
+.. code-block:: c
+
+   mat4 transform;
+   /* ... */
+   glm_mat4_print(transform, stderr);
+
+**NOTE:** print functions use **%0.4f** precision if you need more
+(you probably will in some cases), you can change it temporary.
+cglm may provide precision parameter in the future
+
+Table of contents (click to go):
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Functions:
+
+1. :c:func:`glm_mat4_print`
+#. :c:func:`glm_mat3_print`
+#. :c:func:`glm_vec4_print`
+#. :c:func:`glm_vec3_print`
+#. :c:func:`glm_ivec3_print`
+#. :c:func:`glm_versor_print`
+
+Functions documentation
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. c:function:: void  glm_mat4_print(mat4 matrix, FILE * __restrict ostream)
+
+    | print mat4 to given stream
+
+    Parameters:
+      | *[in]*  **matrix**   matrix
+      | *[in]*  **ostream**  FILE to write
+
+.. c:function:: void  glm_mat3_print(mat3 matrix, FILE * __restrict ostream)
+
+    | print mat3 to given stream
+
+    Parameters:
+      | *[in]*  **matrix**   matrix
+      | *[in]*  **ostream**  FILE to write
+
+.. c:function:: void  glm_vec4_print(vec4 vec, FILE * __restrict ostream)
+
+    | print vec4 to given stream
+
+    Parameters:
+      | *[in]*  **vec**      vector
+      | *[in]*  **ostream**  FILE to write
+
+.. c:function:: void  glm_vec3_print(vec3 vec, FILE * __restrict ostream)
+
+    | print vec3 to given stream
+
+    Parameters:
+      | *[in]*  **vec**      vector
+      | *[in]*  **ostream**  FILE to write
+
+.. c:function:: void  glm_ivec3_print(ivec3 vec, FILE * __restrict ostream)
+
+    | print ivec3 to given stream
+
+    Parameters:
+      | *[in]*  **vec**      vector
+      | *[in]*  **ostream**  FILE to write
+
+.. c:function:: void  glm_versor_print(versor vec, FILE * __restrict ostream)
+
+    | print quaternion to given stream
+
+    Parameters:
+      | *[in]*  **vec**      quaternion
+      | *[in]*  **ostream**  FILE to write

docs/source/mat3.rst

@@ -0,0 +1,134 @@
+.. default-domain:: C
+
+mat3
+====
+
+Header: cglm/mat3.h
+
+Table of contents (click to go):
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Macros:
+
+1. GLM_MAT3_IDENTITY_INIT
+#. GLM_MAT3_ZERO_INIT
+#. GLM_MAT3_IDENTITY
+#. GLM_MAT3_ZERO
+#. glm_mat3_dup(mat, dest)
+
+Functions:
+
+1. :c:func:`glm_mat3_copy`
+#. :c:func:`glm_mat3_identity`
+#. :c:func:`glm_mat3_mul`
+#. :c:func:`glm_mat3_transpose_to`
+#. :c:func:`glm_mat3_transpose`
+#. :c:func:`glm_mat3_mulv`
+#. :c:func:`glm_mat3_scale`
+#. :c:func:`glm_mat3_det`
+#. :c:func:`glm_mat3_inv`
+#. :c:func:`glm_mat3_swap_col`
+#. :c:func:`glm_mat3_swap_row`
+
+Functions documentation
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. c:function:: void  glm_mat3_copy(mat3 mat, mat3 dest)
+
+    copy mat3 to another one (dest).
+
+    Parameters:
+      | *[in]*  **mat**   source
+      | *[out]* **dest**  destination
+
+.. c:function:: void  glm_mat3_identity(mat3 mat)
+
+    copy identity mat3 to mat, or makes mat to identiy
+
+    Parameters:
+      | *[out]* **mat**  matrix
+
+.. c:function:: void  glm_mat3_mul(mat3 m1, mat3 m2, mat3 dest)
+
+    multiply m1 and m2 to dest
+    m1, m2 and dest matrices can be same matrix, it is possible to write this:
+
+    .. code-block:: c
+
+       mat3 m = GLM_MAT3_IDENTITY_INIT;
+       glm_mat3_mul(m, m, m);
+
+    Parameters:
+      | *[in]*  **m1**    left matrix
+      | *[in]*  **m2**    right matrix
+      | *[out]* **dest**  destination matrix
+
+.. c:function:: void  glm_mat3_transpose_to(mat3 m, mat3 dest)
+
+    transpose mat4 and store in dest
+    source matrix will not be transposed unless dest is m
+
+    Parameters:
+      | *[in]*  **mat**   source
+      | *[out]* **dest**  destination
+
+.. c:function:: void  glm_mat3_transpose(mat3 m)
+
+    tranpose mat3 and store result in same matrix
+
+    Parameters:
+      | *[in]*  **mat**   source
+      | *[out]* **dest**  destination
+
+.. c:function:: void  glm_mat3_mulv(mat3 m, vec3 v, vec3 dest)
+
+    multiply mat4 with vec4 (column vector) and store in dest vector
+
+    Parameters:
+      | *[in]*  **mat**   mat3 (left)
+      | *[in]*  **v**     vec3 (right, column vector)
+      | *[out]* **dest**  destination (result, column vector)
+
+.. c:function:: void  glm_mat3_scale(mat3 m, float s)
+
+    multiply matrix with scalar
+
+    Parameters:
+      | *[in, out]* **mat**   matrix
+      | *[in]*      **dest**  scalar
+
+.. c:function:: float  glm_mat3_det(mat3 mat)
+
+    returns mat3 determinant
+
+    Parameters:
+      | *[in]*  **mat**   matrix
+
+    Returns:
+        mat3 determinant
+
+.. c:function:: void glm_mat3_inv(mat3 mat, mat3 dest)
+
+    inverse mat3 and store in dest
+
+    Parameters:
+      | *[in]*  **mat**  matrix
+      | *[out]* **dest** destination (inverse matrix)
+
+.. c:function:: void  glm_mat3_swap_col(mat3 mat, int col1, int col2)
+
+    swap two matrix columns
+
+    Parameters:
+      | *[in, out]*  **mat**   matrix
+      | *[in]*       **col1**  col1
+      | *[in]*       **col2**  col2
+
+.. c:function:: void  glm_mat3_swap_row(mat3 mat, int row1, int row2)
+
+    swap two matrix rows
+
+    Parameters:
+      | *[in, out]*  **mat**   matrix
+      | *[in]*       **row1**  row1
+      | *[in]*       **row2**  row2

docs/source/mat4.rst

@@ -0,0 +1,231 @@
+.. default-domain:: C
+
+mat4
+====
+
+Header: cglm/mat4.h
+
+Important: :c:func:`glm_mat4_scale` multiplies mat4 with scalar, if you need to
+apply scale transform use :c:func:`glm_scale` functions.
+
+Table of contents (click to go):
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Macros:
+
+1. GLM_MAT4_IDENTITY_INIT
+#. GLM_MAT4_ZERO_INIT
+#. GLM_MAT4_IDENTITY
+#. GLM_MAT4_ZERO
+#. glm_mat4_udup(mat, dest)
+#. glm_mat4_dup(mat, dest)
+
+Functions:
+
+1. :c:func:`glm_mat4_ucopy`
+#. :c:func:`glm_mat4_copy`
+#. :c:func:`glm_mat4_identity`
+#. :c:func:`glm_mat4_pick3`
+#. :c:func:`glm_mat4_pick3t`
+#. :c:func:`glm_mat4_ins3`
+#. :c:func:`glm_mat4_mul`
+#. :c:func:`glm_mat4_mulN`
+#. :c:func:`glm_mat4_mulv`
+#. :c:func:`glm_mat4_mulv3`
+#. :c:func:`glm_mat4_transpose_to`
+#. :c:func:`glm_mat4_transpose`
+#. :c:func:`glm_mat4_scale_p`
+#. :c:func:`glm_mat4_scale`
+#. :c:func:`glm_mat4_det`
+#. :c:func:`glm_mat4_inv`
+#. :c:func:`glm_mat4_inv_fast`
+#. :c:func:`glm_mat4_swap_col`
+#. :c:func:`glm_mat4_swap_row`
+
+Functions documentation
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. c:function:: void  glm_mat4_ucopy(mat4 mat, mat4 dest)
+
+    copy mat4 to another one (dest). u means align is not required for dest
+
+    Parameters:
+      | *[in]*  **mat**   source
+      | *[out]* **dest**  destination
+
+.. c:function:: void  glm_mat4_copy(mat4 mat, mat4 dest)
+
+    copy mat4 to another one (dest).
+
+    Parameters:
+      | *[in]*  **mat**   source
+      | *[out]* **dest**  destination
+
+.. c:function:: void  glm_mat4_identity(mat4 mat)
+
+    copy identity mat4 to mat, or makes mat to identiy
+
+    Parameters:
+      | *[out]* **mat**  matrix
+
+.. c:function:: void  glm_mat4_pick3(mat4 mat, mat3 dest)
+
+    copy upper-left of mat4 to mat3
+
+    Parameters:
+      | *[in]*  **mat**   source
+      | *[out]* **dest**  destination
+
+.. c:function:: void  glm_mat4_pick3t(mat4 mat, mat4 dest)
+
+    copy upper-left of mat4 to mat3 (transposed)
+    the postfix t stands for transpose
+
+    Parameters:
+      | *[in]*  **mat**   source
+      | *[out]* **dest**  destination
+
+.. c:function:: void  glm_mat4_ins3(mat3 mat, mat4 dest)
+
+    copy mat3 to mat4's upper-left. this function does not fill mat4's other
+    elements. To do that use glm_mat4.
+
+    Parameters:
+      | *[in]*  **mat**   source
+      | *[out]* **dest**  destination
+
+.. c:function:: void  glm_mat4_mul(mat4 m1, mat4 m2, mat4 dest)
+
+    multiply m1 and m2 to dest
+    m1, m2 and dest matrices can be same matrix, it is possible to write this:
+
+    .. code-block:: c
+
+       mat4 m = GLM_MAT4_IDENTITY_INIT;
+       glm_mat4_mul(m, m, m);
+
+    Parameters:
+      | *[in]*  **m1**    left matrix
+      | *[in]*  **m2**    right matrix
+      | *[out]* **dest**  destination matrix
+
+.. c:function:: void glm_mat4_mulN(mat4 * __restrict matrices[], int len, mat4 dest)
+
+    mupliply N mat4 matrices and store result in dest
+    | this function lets you multiply multiple (more than two or more...)
+    | matrices
+
+    | multiplication will be done in loop, this may reduce instructions
+    | size but if **len** is too small then compiler may unroll whole loop
+
+    .. code-block:: c
+
+       mat m1, m2, m3, m4, res;
+       glm_mat4_mulN((mat4 *[]){&m1, &m2, &m3, &m4}, 4, res);
+
+    Parameters:
+      | *[in]*  **matrices** array of mat4
+      | *[in]*  **len**      matrices count
+      | *[out]* **dest**     destination matrix
+
+.. c:function:: void  glm_mat4_mulv(mat4 m, vec4 v, vec4 dest)
+
+    multiply mat4 with vec4 (column vector) and store in dest vector
+
+    Parameters:
+      | *[in]*  **m**     mat4 (left)
+      | *[in]*  **v**     vec4 (right, column vector)
+      | *[out]* **dest**  vec4 (result, column vector)
+
+.. c:function:: void  glm_mat4_mulv3(mat4 m, vec3 v, vec3 dest)
+
+    multiply vector with mat4's mat3 part(rotation)
+
+    Parameters:
+    | *[in]*  **m**     mat4 (left)
+    | *[in]*  **v**     vec3 (right, column vector)
+    | *[out]* **dest**  vec3 (result, column vector)
+
+.. c:function:: void  glm_mat4_transpose_to(mat4 m, mat4 dest)
+
+    transpose mat4 and store in dest
+    source matrix will not be transposed unless dest is m
+
+    Parameters:
+      | *[in]*  **m**     matrix
+      | *[out]* **dest**  destination matrix
+
+.. c:function:: void  glm_mat4_transpose(mat4 m)
+
+    tranpose mat4 and store result in same matrix
+
+    Parameters:
+      | *[in]*  **m**     source
+      | *[out]* **dest**  destination matrix
+
+.. c:function:: void  glm_mat4_scale_p(mat4 m, float s)
+
+    scale (multiply with scalar) matrix without simd optimization
+
+    Parameters:
+      | *[in, out]*  **m**  matrix
+      | *[in]*       **s**  scalar
+
+.. c:function:: void  glm_mat4_scale(mat4 m, float s)
+
+    scale (multiply with scalar) matrix
+    THIS IS NOT SCALE TRANSFORM, use glm_scale for that.
+
+    Parameters:
+      | *[in, out]*  **m**  matrix
+      | *[in]*       **s**  scalar
+
+.. c:function:: float  glm_mat4_det(mat4 mat)
+
+    mat4 determinant
+
+    Parameters:
+      | *[in]*  **mat**   matrix
+
+    Return:
+      | determinant
+
+.. c:function:: void  glm_mat4_inv(mat4 mat, mat4 dest)
+
+    inverse mat4 and store in dest
+
+    Parameters:
+      | *[in]*  **mat**   source
+      | *[out]* **dest**  destination matrix (inverse matrix)
+
+.. c:function:: void  glm_mat4_inv_fast(mat4 mat, mat4 dest)
+
+    inverse mat4 and store in dest
+
+    | this func uses reciprocal approximation without extra corrections
+    | e.g Newton-Raphson. this should work faster than normal,
+    | to get more precise use glm_mat4_inv version.
+
+    | NOTE: You will lose precision, glm_mat4_inv is more accurate
+
+    Parameters:
+      | *[in]*  **mat**   source
+      | *[out]* **dest**  destination
+
+.. c:function:: void  glm_mat4_swap_col(mat4 mat, int col1, int col2)
+
+    swap two matrix columns
+
+    Parameters:
+      | *[in, out]*  **mat**   matrix
+      | *[in]*       **col1**  col1
+      | *[in]*       **col2**  col2
+
+.. c:function:: void  glm_mat4_swap_row(mat4 mat, int row1, int row2)
+
+    swap two matrix rows
+
+    Parameters:
+      | *[in, out]*  **mat**   matrix
+      | *[in]*       **row1**  row1
+      | *[in]*       **row2**  row2

docs/source/opengl.rst

@@ -0,0 +1,61 @@
+How to send vector or matrix to OpenGL like API
+==================================================
+
+*cglm*'s vector and matrix types are arrays. So you can send them directly to a
+function which accecpts pointer. But you may got warnings for matrix because it is
+two dimensional array.
+
+Passing / Uniforming Matrix to OpenGL:
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+**glUniformMatrix4fv** accepts float pointer, you can pass matrix to that parameter
+and it should work but with warnings. "You can pass" doesn't mean that you must pass like that.
+
+**Correct options:**
+
+Correct doesn't mean correct way to use OpenGL it is just shows correct way to pass cglm type to it.
+
+1. Pass first column
+---------------------
+
+The goal is that pass address of matrix, first element of matrix is also address of matrix,
+because it is array of vectors and vector is array of floats.
+
+.. code-block:: c
+
+   mat4 matrix;
+   /* ... */
+   glUniformMatrix4fv(location, 1, GL_FALSE, matrix[0]);
+
+array of matrices:
+
+.. code-block:: c
+
+   mat4 matrix;
+   /* ... */
+   glUniformMatrix4fv(location, count, GL_FALSE, matrix[0][0]);
+
+1. Cast matrix to pointer
+--------------------------
+
+.. code-block:: c
+
+   mat4 matrix;
+   /* ... */
+   glUniformMatrix4fv(location, count, GL_FALSE, (float *)matrix);
+
+in this way, passing aray of matrices is same 
+
+Passing / Uniforming Vectors to OpenGL:¶
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You don't need to do extra thing when passing cglm vectors to OpengL or other APIs.
+Because a function like **glUniform4fv** accepts vector as pointer. cglm's vectors
+are array of floats. So you can pass it directly ot those functions:
+
+.. code-block:: c
+
+   vec4 vec;
+   /* ... */
+   glUniform4fv(location, 1, vec);
+
+this show how to pass **vec4** others are same.

docs/source/plane.rst

@@ -0,0 +1,33 @@
+.. default-domain:: C
+
+plane
+================================================================================
+
+Header: cglm/plane.h
+
+Plane extract functions are in frustum header and documented
+in :doc:`frustum` page.
+
+**Definition of plane:**
+
+Plane equation:  **Ax + By + Cz + D = 0**
+
+Plan is stored in **vec4** as **[A, B, C, D]**. (A, B, C) is normal and D is distance
+
+Table of contents (click to go):
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Functions:
+
+1. :c:func:`glm_plane_normalize`
+
+
+Functions documentation
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. c:function:: void  glm_plane_normalize(vec4 plane)
+
+    | normalizes a plane
+
+    Parameters:
+      | *[in, out]*  **plane**  pnale to normalize

docs/source/quat.rst

@@ -0,0 +1,124 @@
+.. default-domain:: C
+
+quaternions
+===========
+
+Header: cglm/quat.h
+
+ **Important:** *cglm* stores quaternion as [w, x, y, z] in memory, don't
+ forget that when changing quaternion items manually. For instance *quat[3]*
+ is *quat.z* and *quat[0*] is *quat.w*. This may change in the future if *cglm*
+ will got enough request to do that. Probably it will not be changed in near
+ future
+
+There are some TODOs for quaternions check TODO list to see them.
+
+Also **versor** is identity quaternion so the type may change to **vec4** or
+something else. This will not affect existing functions for your engine because
+*versor* is alias of *vec4*
+
+Table of contents (click to go):
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Macros:
+
+1. GLM_QUAT_IDENTITY_INIT
+#. GLM_QUAT_IDENTITY
+
+Functions:
+
+1. :c:func:`glm_quat_identity`
+#. :c:func:`glm_quat`
+#. :c:func:`glm_quatv`
+#. :c:func:`glm_quat_norm`
+#. :c:func:`glm_quat_normalize`
+#. :c:func:`glm_quat_dot`
+#. :c:func:`glm_quat_mulv`
+#. :c:func:`glm_quat_mat4`
+#. :c:func:`glm_quat_slerp`
+
+Functions documentation
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. c:function:: void  glm_quat_identity(versor q)
+
+    | makes given quat to identity
+
+    Parameters:
+      | *[in, out]*  **q**    quaternion
+
+.. c:function:: void  glm_quat(versor q, float  angle, float  x, float  y, float  z)
+
+    | creates NEW quaternion with individual axis components
+
+    Parameters:
+      | *[out]* **q**      quaternion
+      | *[in]*  **angle**  angle (radians)
+      | *[in]*  **x**      axis.x
+      | *[in]*  **y**      axis.y
+      | *[in]*  **z**      axis.z
+
+.. c:function:: void  glm_quatv(versor q, float  angle, vec3   v)
+
+    | creates NEW quaternion with axis vector
+
+    Parameters:
+      | *[out]* **q**      quaternion
+      | *[in]*  **angle**  angle (radians)
+      | *[in]*  **v**      axis
+
+.. c:function:: float  glm_quat_norm(versor q)
+
+    | returns norm (magnitude) of quaternion
+
+    Parameters:
+      | *[in]*  **a**  quaternion
+
+    Returns:
+      norm (magnitude)
+
+.. c:function:: void  glm_quat_normalize(versor q)
+
+    | normalize quaternion
+
+    Parameters:
+      | *[in, out]*  **q** quaternion
+
+.. c:function:: float  glm_quat_dot(versor q, versor r)
+
+    dot product of two quaternion
+
+    Parameters:
+      | *[in]*  **q1**   quaternion 1
+      | *[in]*  **q2**   quaternion 2
+
+    Returns:
+      dot product
+
+.. c:function:: void  glm_quat_mulv(versor q1, versor q2, versor dest)
+
+    | multiplies two quaternion and stores result in dest
+
+    Parameters:
+      | *[in]*  **q1**    quaternion 1
+      | *[in]*  **q2**    quaternion 2
+      | *[out]* **dest**  result quaternion
+
+.. c:function:: void  glm_quat_mat4(versor q, mat4 dest)
+
+    | convert quaternion to mat4
+
+    Parameters:
+      | *[in]*  **q**     quaternion
+      | *[out]* **dest**  result matrix
+
+.. c:function:: void glm_quat_slerp(versor q, versor r, float  t, versor dest)
+
+    | interpolates between two quaternions
+    | using spherical linear interpolation (SLERP)
+
+    Parameters:
+      | *[in]*  **q**     from
+      | *[in]*  **r**     to
+      | *[in]*  **t**     amout
+      | *[out]* **dest**  result quaternion

docs/source/util.rst

@@ -0,0 +1,93 @@
+.. default-domain:: C
+
+utils / helpers
+================================================================================
+
+Header: cglm/util.h
+
+
+
+Table of contents (click to go):
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Functions:
+
+1. :c:func:`glm_sign`
+#. :c:func:`glm_rad`
+#. :c:func:`glm_deg`
+#. :c:func:`glm_make_rad`
+#. :c:func:`glm_make_deg`
+#. :c:func:`glm_pow2`
+
+Functions documentation
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. c:function:: int  glm_sign(int val)
+
+    | returns sign of 32 bit integer as +1 or -1
+
+    Parameters:
+      | *[in]*  **val**   an integer
+
+    Returns:
+      sign of given number
+
+.. c:function:: float  glm_rad(float deg)
+
+    | convert degree to radians
+
+    Parameters:
+      | *[in]*  **deg**   angle in degrees
+
+.. c:function:: float glm_deg(float rad)
+
+    | convert radians to degree
+
+    Parameters:
+      | *[in]*  **rad**      angle in radians
+
+.. c:function:: void  glm_make_rad(float *degm)
+
+    | convert exsisting degree to radians. this will override degrees value
+
+    Parameters:
+      | *[in, out]*  **deg**      pointer to angle in degrees
+
+.. c:function:: void  glm_make_deg(float *rad)
+
+    | convert exsisting radians to degree. this will override radians value
+
+    Parameters:
+      | *[in, out]*  **rad**      pointer to angle in radians
+
+.. c:function:: float  glm_pow2(float x)
+
+    | multiplies given parameter with itself = x * x or powf(x, 2)
+
+    Parameters:
+      | *[in]*  **x** value
+
+    Returns:
+      square of a given number
+
+.. c:function:: float  glm_min(float a, float b)
+
+    | returns minimum of given two values
+
+    Parameters:
+      | *[in]*  **a** number 1
+      | *[in]*  **b** number 2
+
+    Returns:
+      minimum value
+
+.. c:function:: float  glm_max(float a, float b)
+
+    | returns maximum of given two values
+
+    Parameters:
+      | *[in]*  **a** number 1
+      | *[in]*  **b** number 2
+
+    Returns:
+      maximum value

docs/source/vec3-ext.rst

@@ -0,0 +1,98 @@
+.. default-domain:: C
+
+vec3 extra
+==========
+
+Header: cglm/vec3-ext.h
+
+There are some functions are in called in extra header. These are called extra
+because they are not used like other functions in vec3.h in the future some of
+these functions ma be moved to vec3 header.
+
+Table of contents (click to go):
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Functions:
+
+1. :c:func:`glm_vec_mulv`
+#. :c:func:`glm_vec_broadcast`
+#. :c:func:`glm_vec_eq`
+#. :c:func:`glm_vec_eq_eps`
+#. :c:func:`glm_vec_eq_all`
+#. :c:func:`glm_vec_eqv`
+#. :c:func:`glm_vec_eqv_eps`
+#. :c:func:`glm_vec_max`
+#. :c:func:`glm_vec_min`
+
+Functions documentation
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. c:function:: void  glm_vec_mulv(vec3 a, vec3 b, vec3 d)
+
+    multiplies individual items
+
+    Parameters:
+      | *[in]*  **a**  vec1
+      | *[in]*  **b**  vec2
+      | *[out]* **d**  destination (v1[0] * v2[0], v1[1] * v2[1], v1[2] * v2[2])
+
+.. c:function:: void  glm_vec_broadcast(float val, vec3 d)
+
+    fill a vector with specified value
+
+    Parameters:
+      | *[in]*  **val**   value
+      | *[out]* **dest**  destination
+
+.. c:function:: bool  glm_vec_eq(vec3 v, float val)
+
+    check if vector is equal to value (without epsilon)
+
+    Parameters:
+      | *[in]*  **v**    vector
+      | *[in]*  **val**  value
+
+.. c:function:: bool  glm_vec_eq_eps(vec3 v, float val)
+
+    check if vector is equal to value (with epsilon)
+
+    Parameters:
+      | *[in]*  **v**    vector
+      | *[in]*  **val**  value
+
+.. c:function:: bool  glm_vec_eq_all(vec3 v)
+
+    check if vectors members are equal (without epsilon)
+
+    Parameters:
+      | *[in]*  **v**   vector
+
+.. c:function:: bool  glm_vec_eqv(vec3 v1, vec3 v2)
+
+    check if vector is equal to another (without epsilon) vector
+
+    Parameters:
+      | *[in]*  **vec**   vector 1
+      | *[in]*  **vec**   vector 2
+
+.. c:function:: bool  glm_vec_eqv_eps(vec3 v1, vec3 v2)
+
+    check if vector is equal to another (with epsilon)
+
+    Parameters:
+      | *[in]*  **v1**    vector1
+      | *[in]*  **v2**    vector2
+
+.. c:function:: float  glm_vec_max(vec3 v)
+
+    max value of vector
+
+    Parameters:
+      | *[in]*  **v**    vector
+
+.. c:function:: float glm_vec_min(vec3 v)
+
+     min value of vector
+
+    Parameters:
+      | *[in]*  **v**  vector

docs/source/vec3.rst

@@ -0,0 +1,273 @@
+.. default-domain:: C
+
+vec3
+====
+
+Header: cglm/vec3.h
+
+We mostly use vectors in graphics math, to make writing code faster
+and easy to read, some *vec3* functions are aliased in global namespace.
+For instance :c:func:`glm_dot` is alias of :c:func:`glm_vec_dot`,
+alias means inline wrapper here. There is no call verison of alias functions
+
+There are also functions for rotating *vec3* vector. **_m4**, **_m3** prefixes
+rotate *vec3* with matrix.
+
+Table of contents (click to go):
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Macros:
+
+1. glm_vec_dup(v, dest)
+#. GLM_VEC3_ONE_INIT
+#. GLM_VEC3_ZERO_INIT
+#. GLM_VEC3_ONE
+#. GLM_VEC3_ZERO
+#. GLM_YUP
+#. GLM_ZUP
+#. GLM_XUP
+
+Functions:
+
+1. :c:func:`glm_vec3`
+#. :c:func:`glm_vec_copy`
+#. :c:func:`glm_vec_dot`
+#. :c:func:`glm_vec_cross`
+#. :c:func:`glm_vec_norm2`
+#. :c:func:`glm_vec_norm`
+#. :c:func:`glm_vec_add`
+#. :c:func:`glm_vec_sub`
+#. :c:func:`glm_vec_scale`
+#. :c:func:`glm_vec_scale_as`
+#. :c:func:`glm_vec_flipsign`
+#. :c:func:`glm_vec_inv`
+#. :c:func:`glm_vec_inv_to`
+#. :c:func:`glm_vec_normalize`
+#. :c:func:`glm_vec_normalize_to`
+#. :c:func:`glm_vec_distance`
+#. :c:func:`glm_vec_angle`
+#. :c:func:`glm_vec_rotate`
+#. :c:func:`glm_vec_rotate_m4`
+#. :c:func:`glm_vec_proj`
+#. :c:func:`glm_vec_center`
+#. :c:func:`glm_vec_maxv`
+#. :c:func:`glm_vec_minv`
+#. :c:func:`glm_vec_ortho`
+
+Functions documentation
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. c:function:: void  glm_vec3(vec4 v4, vec3 dest)
+
+    init vec3 using vec4
+
+    Parameters:
+      | *[in]*  **v4**    vector4
+      | *[out]* **dest**  destination
+
+.. c:function:: void  glm_vec_copy(vec3 a, vec3 dest)
+
+    copy all members of [a] to [dest]
+
+    Parameters:
+      | *[in]*  **a**     source
+      | *[out]* **dest**  destination
+
+.. c:function:: float  glm_vec_dot(vec3 a, vec3 b)
+
+    dot product of vec3
+
+    Parameters:
+      | *[in]*  **a**  vector1
+      | *[in]*  **b**  vector2
+
+    Returns:
+      dot product
+
+.. c:function:: void  glm_vec_cross(vec3 a, vec3 b, vec3 d)
+
+    cross product
+
+    Parameters:
+      | *[in]*  **a**  source 1
+      | *[in]*  **b**  source 2
+      | *[out]* **d**  destination
+
+.. c:function:: float  glm_vec_norm2(vec3 v)
+
+    norm * norm (magnitude) of vector
+
+    we can use this func instead of calling norm * norm, because it would call
+    sqrtf fuction twice but with this func we can avoid func call, maybe this is
+    not good name for this func
+
+    Parameters:
+      | *[in]*  **v**   vector
+
+    Returns:
+      square of norm / magnitude
+
+.. c:function:: float  glm_vec_norm(vec3 vec)
+
+    norm (magnitude) of vec3
+
+    Parameters:
+      | *[in]*  **vec**   vector
+
+.. c:function:: void  glm_vec_add(vec3 v1, vec3 v2, vec3 dest)
+
+    add v2 vector to v1 vector store result in dest
+
+    Parameters:
+      | *[in]*  **v1**    vector1
+      | *[in]*  **v2**    vector2
+      | *[out]* **dest**  destination vector
+
+.. c:function:: void  glm_vec_sub(vec3 v1, vec3 v2, vec3 dest)
+
+    subtract v2 vector from v1 vector store result in dest
+
+    Parameters:
+      | *[in]*  **v1**    vector1
+      | *[in]*  **v2**    vector2
+      | *[out]* **dest**  destination vector
+
+.. c:function:: void glm_vec_scale(vec3 v, float s, vec3 dest)
+
+     multiply/scale vec3 vector with scalar: result = v * s
+
+
+    Parameters:
+      | *[in]*  **v**     vector
+      | *[in]*  **s**     scalar
+      | *[out]* **dest**  destination vector
+
+.. c:function:: void  glm_vec_scale_as(vec3 v, float s, vec3 dest)
+
+    make vec3 vector scale as specified: result = unit(v) * s
+
+    Parameters:
+      | *[in]*  **v**     vector
+      | *[in]*  **s**     scalar
+      | *[out]* **dest**  destination vector
+
+.. c:function:: void  glm_vec_flipsign(vec3 v)
+
+    flip sign of all vec3 members
+
+    Parameters:
+    | *[in, out]*  **v**    vector
+
+.. c:function:: void  glm_vec_inv(vec3 v)
+
+    make vector as inverse/opposite of itself
+
+    Parameters:
+      | *[in, out]*  **v**    vector
+
+.. c:function:: void  glm_vec_inv_to(vec3 v, vec3 dest)
+
+    inverse/opposite vector
+
+    Parameters:
+      | *[in]*  **v**     source
+      | *[out]* **dest**  destination
+
+.. c:function:: void  glm_vec_normalize(vec3 v)
+
+    normalize vec3 and store result in same vec
+
+    Parameters:
+      | *[in, out]*  **v**    vector
+
+.. c:function:: void  glm_vec_normalize_to(vec3 vec, vec3 dest)
+
+     normalize vec3 to dest
+
+    Parameters:
+      | *[in]*   **vec**   source
+      | *[out]*  **dest**  destination
+
+.. c:function:: float  glm_vec_angle(vec3 v1, vec3 v2)
+
+    angle betwen two vector
+
+    Parameters:
+      | *[in]*  **v1**   vector1
+      | *[in]*  **v2**   vector2
+
+    Return:
+      | angle as radians
+
+.. c:function:: void  glm_vec_rotate(vec3 v, float angle, vec3 axis)
+
+     rotate vec3 around axis by angle using Rodrigues' rotation formula
+
+    Parameters:
+      | *[in, out]*  **v**      vector
+      | *[in]*       **axis**   axis vector (must be unit vector)
+      | *[out]*      **angle**  angle (radians)
+
+.. c:function:: void  glm_vec_rotate_m4(mat4 m, vec3 v, vec3 dest)
+
+    apply rotation matrix to vector
+
+    Parameters:
+      | *[in]*  **m**     affine matrix or rot matrix
+      | *[in]*  **v**     vector
+      | *[out]* **dest**  rotated vector
+
+.. c:function:: void  glm_vec_proj(vec3 a, vec3 b, vec3 dest)
+
+    project a vector onto b vector
+
+    Parameters:
+      | *[in]*  **a**     vector1
+      | *[in]*  **b**     vector2
+      | *[out]* **dest**  projected vector
+
+.. c:function:: void  glm_vec_center(vec3 v1, vec3 v2, vec3 dest)
+
+    find center point of two vector
+
+    Parameters:
+      | *[in]*  **v1**    vector1
+      | *[in]*  **v2**    vector2
+      | *[out]* **dest**  center point
+
+.. c:function:: float  glm_vec_distance(vec3 v1, vec3 v2)
+
+    distance between two vectors
+
+    Parameters:
+      | *[in]*  **mat**   vector1
+      | *[in]*  **row1**  vector2
+
+    Returns:
+      | distance
+
+.. c:function:: void  glm_vec_maxv(vec3 v1, vec3 v2, vec3 dest)
+
+    max values of vectors
+
+    Parameters:
+      | *[in]*  **v1**    vector1
+      | *[in]*  **v2**    vector2
+      | *[out]* **dest**  destination
+
+.. c:function:: void  glm_vec_minv(vec3 v1, vec3 v2, vec3 dest)
+
+    min values of vectors
+
+    Parameters:
+      | *[in]*  **v1**    vector1
+      | *[in]*  **v2**    vector2
+      | *[out]* **dest**  destination
+
+.. c:function:: void  glm_vec_ortho(vec3 v, vec3 dest)
+
+    possible orthogonal/perpendicular vector
+
+    Parameters:
+      | *[in]*  **mat**   vector
+      | *[out]* **dest**  orthogonal/perpendicular vector

docs/source/vec4-ext.rst

@@ -0,0 +1,98 @@
+.. default-domain:: C
+
+vec4 extra
+==========
+
+Header: cglm/vec4-ext.h
+
+There are some functions are in called in extra header. These are called extra
+because they are not used like other functions in vec4.h in the future some of
+these functions ma be moved to vec4 header.
+
+Table of contents (click to go):
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Functions:
+
+1. :c:func:`glm_vec4_mulv`
+#. :c:func:`glm_vec4_broadcast`
+#. :c:func:`glm_vec4_eq`
+#. :c:func:`glm_vec4_eq_eps`
+#. :c:func:`glm_vec4_eq_all`
+#. :c:func:`glm_vec4_eqv`
+#. :c:func:`glm_vec4_eqv_eps`
+#. :c:func:`glm_vec4_max`
+#. :c:func:`glm_vec4_min`
+
+Functions documentation
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. c:function:: void  glm_vec4_mulv(vec4 a, vec4 b, vec4 d)
+
+    multiplies individual items
+
+    Parameters:
+      | *[in]*  **a**  vec1
+      | *[in]*  **b**  vec2
+      | *[out]* **d**  destination
+
+.. c:function:: void  glm_vec4_broadcast(float val, vec4 d)
+
+    fill a vector with specified value
+
+    Parameters:
+      | *[in]*  **val**   value
+      | *[out]* **dest**  destination
+
+.. c:function:: bool  glm_vec4_eq(vec4 v, float val)
+
+    check if vector is equal to value (without epsilon)
+
+    Parameters:
+      | *[in]*  **v**    vector
+      | *[in]*  **val**  value
+
+.. c:function:: bool  glm_vec4_eq_eps(vec4 v, float val)
+
+    check if vector is equal to value (with epsilon)
+
+    Parameters:
+      | *[in]*  **v**    vector
+      | *[in]*  **val**  value
+
+.. c:function:: bool  glm_vec4_eq_all(vec4 v)
+
+    check if vectors members are equal (without epsilon)
+
+    Parameters:
+      | *[in]*  **v**   vector
+
+.. c:function:: bool  glm_vec4_eqv(vec4 v1, vec4 v2)
+
+    check if vector is equal to another (without epsilon) vector
+
+    Parameters:
+      | *[in]*  **vec**   vector 1
+      | *[in]*  **vec**   vector 2
+
+.. c:function:: bool  glm_vec4_eqv_eps(vec4 v1, vec4 v2)
+
+    check if vector is equal to another (with epsilon)
+
+    Parameters:
+      | *[in]*  **v1**    vector1
+      | *[in]*  **v2**    vector2
+
+.. c:function:: float  glm_vec4_max(vec4 v)
+
+    max value of vector
+
+    Parameters:
+      | *[in]*  **v**    vector
+
+.. c:function:: float glm_vec4_min(vec4 v)
+
+     min value of vector
+
+    Parameters:
+      | *[in]*  **v**  vector

docs/source/vec4.rst

@@ -0,0 +1,205 @@
+.. default-domain:: C
+
+vec4
+====
+
+Header: cglm/vec4.h
+
+Table of contents (click to go):
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Macros:
+
+1. glm_vec4_dup3(v, dest)
+#. glm_vec4_dup(v, dest)
+#. GLM_VEC4_ONE_INIT
+#. GLM_VEC4_BLACK_INIT
+#. GLM_VEC4_ZERO_INIT
+#. GLM_VEC4_ONE
+#. GLM_VEC4_BLACK
+#. GLM_VEC4_ZERO
+
+Functions:
+
+1. :c:func:`glm_vec4`
+#. :c:func:`glm_vec4_copy3`
+#. :c:func:`glm_vec4_copy`
+#. :c:func:`glm_vec4_dot`
+#. :c:func:`glm_vec4_norm2`
+#. :c:func:`glm_vec4_norm`
+#. :c:func:`glm_vec4_add`
+#. :c:func:`glm_vec4_sub`
+#. :c:func:`glm_vec4_scale`
+#. :c:func:`glm_vec4_scale_as`
+#. :c:func:`glm_vec4_flipsign`
+#. :c:func:`glm_vec4_inv`
+#. :c:func:`glm_vec4_inv_to`
+#. :c:func:`glm_vec4_normalize`
+#. :c:func:`glm_vec4_normalize_to`
+#. :c:func:`glm_vec4_distance`
+#. :c:func:`glm_vec4_maxv`
+#. :c:func:`glm_vec4_minv`
+
+Functions documentation
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. c:function:: void  glm_vec4(vec3 v3, float last, vec4 dest)
+
+    init vec4 using vec3, since you are initializing vec4 with vec3
+    you need to set last item. cglm could set it zero but making it parameter
+    gives more control
+
+    Parameters:
+      | *[in]*  **v3**    vector4
+      | *[in]*  **last**  last item of vec4
+      | *[out]* **dest**  destination
+
+.. c:function:: void glm_vec4_copy3(vec4 a, vec3 dest)
+
+    copy first 3 members of [a] to [dest]
+
+    Parameters:
+      | *[in]*  **a**     source
+      | *[out]* **dest**  destination
+
+.. c:function:: void  glm_vec4_copy(vec4 v, vec4 dest)
+
+    copy all members of [a] to [dest]
+
+    Parameters:
+      | *[in]*  **v**     source
+      | *[in]*  **dest**  destination
+
+.. c:function:: float  glm_vec4_dot(vec4 a, vec4 b)
+
+    dot product of vec4
+
+    Parameters:
+      | *[in]*  **a**  vector1
+      | *[in]*  **b**  vector2
+
+    Returns:
+      dot product
+
+.. c:function:: float  glm_vec4_norm2(vec4 v)
+
+    norm * norm (magnitude) of vector
+
+    we can use this func instead of calling norm * norm, because it would call
+    sqrtf fuction twice but with this func we can avoid func call, maybe this is
+    not good name for this func
+
+    Parameters:
+      | *[in]*  **v**   vector
+
+    Returns:
+      square of norm / magnitude
+
+.. c:function:: float  glm_vec4_norm(vec4 vec)
+
+    norm (magnitude) of vec4
+
+    Parameters:
+      | *[in]*  **vec**   vector
+
+.. c:function:: void  glm_vec4_add(vec4 v1, vec4 v2, vec4 dest)
+
+    add v2 vector to v1 vector store result in dest
+
+    Parameters:
+      | *[in]*  **v1**    vector1
+      | *[in]*  **v2**    vector2
+      | *[out]* **dest**  destination vector
+
+.. c:function:: void  glm_vec4_sub(vec4 v1, vec4 v2, vec4 dest)
+
+    subtract v2 vector from v1 vector store result in dest
+
+    Parameters:
+      | *[in]*  **v1**    vector1
+      | *[in]*  **v2**    vector2
+      | *[out]* **dest**  destination vector
+
+.. c:function:: void glm_vec4_scale(vec4 v, float s, vec4 dest)
+
+     multiply/scale vec4 vector with scalar: result = v * s
+
+    Parameters:
+      | *[in]*  **v**     vector
+      | *[in]*  **s**     scalar
+      | *[out]* **dest**  destination vector
+
+.. c:function:: void  glm_vec4_scale_as(vec4 v, float s, vec4 dest)
+
+    make vec4 vector scale as specified: result = unit(v) * s
+
+    Parameters:
+      | *[in]*  **v**     vector
+      | *[in]*  **s**     scalar
+      | *[out]* **dest**  destination vector
+
+.. c:function:: void  glm_vec4_flipsign(vec4 v)
+
+    flip sign of all vec4 members
+
+    Parameters:
+    | *[in, out]*  **v**    vector
+
+.. c:function:: void  glm_vec4_inv(vec4 v)
+
+    make vector as inverse/opposite of itself
+
+    Parameters:
+      | *[in, out]*  **v**    vector
+
+.. c:function:: void  glm_vec4_inv_to(vec4 v, vec4 dest)
+
+    inverse/opposite vector
+
+    Parameters:
+      | *[in]*  **v**     source
+      | *[out]* **dest**  destination
+
+.. c:function:: void  glm_vec4_normalize(vec4 v)
+
+    normalize vec4 and store result in same vec
+
+    Parameters:
+      | *[in, out]*  **v**    vector
+
+.. c:function:: void  glm_vec4_normalize_to(vec4 vec, vec4 dest)
+
+    normalize vec4 to dest
+
+    Parameters:
+      | *[in]*   **vec**   source
+      | *[out]*  **dest**  destination
+
+.. c:function:: float  glm_vec4_distance(vec4 v1, vec4 v2)
+
+    distance between two vectors
+
+    Parameters:
+      | *[in]*  **mat**   vector1
+      | *[in]*  **row1**  vector2
+
+    Returns:
+      | distance
+
+.. c:function:: void  glm_vec4_maxv(vec4 v1, vec4 v2, vec4 dest)
+
+    max values of vectors
+
+    Parameters:
+      | *[in]*  **v1**    vector1
+      | *[in]*  **v2**    vector2
+      | *[out]* **dest**  destination
+
+.. c:function:: void  glm_vec4_minv(vec4 v1, vec4 v2, vec4 dest)
+
+    min values of vectors
+
+    Parameters:
+      | *[in]*  **v1**    vector1
+      | *[in]*  **v2**    vector2
+      | *[out]* **dest**  destination

include/arch/simd/cglm-intrin.h

@@ -1,36 +0,0 @@
-/*
- * Copyright (c), Recep Aslantas.
- *
- * MIT License (MIT), http://opensource.org/licenses/MIT
- * Full license can be found in the LICENSE file
- */
-
-#ifndef cglm_intrin_h
-#define cglm_intrin_h
-
-#if defined( _WIN32 )
-#  if (defined(_M_AMD64) || defined(_M_X64)) || _M_IX86_FP == 2
-#    define __SSE2__
-#  elif _M_IX86_FP == 1
-#    define __SSE__
-#  endif
-#endif
-
-#if defined( __SSE__ ) || defined( __SSE2__ )
-
-#include <xmmintrin.h>
-#include <emmintrin.h>
-
-/* float */
-#define _mm_shuffle1_ps(a, z, y, x, w)                                        \
-  _mm_shuffle_ps(a, a, _MM_SHUFFLE(z, y, x, w))
-
-#define _mm_shuffle1_ps1(a, x)                                                \
-  _mm_shuffle_ps(a, a, _MM_SHUFFLE(x, x, x, x))
-
-#define _mm_shuffle2_ps(a, b, z0, y0, x0, w0, z1, y1, x1, w1)                 \
-  _mm_shuffle1_ps(_mm_shuffle_ps(a, b, _MM_SHUFFLE(z0, y0, x0, w0)),          \
-                  z1, y1, x1, w1)
-
-#endif
-#endif /* cglm_intrin_h */

include/cglm-cam.h

@@ -1,200 +0,0 @@
-/*
- * Copyright (c), Recep Aslantas.
- *
- * MIT License (MIT), http://opensource.org/licenses/MIT
- * Full license can be found in the LICENSE file
- */
-
-#ifndef cglm_vcam_h
-#define cglm_vcam_h
-
-#include "cglm-common.h"
-#include "cglm-platform.h"
-
-CGLM_INLINE
-void
-glm_frustum(float left,
-            float right,
-            float bottom,
-            float top,
-            float nearVal,
-            float farVal,
-            mat4 dest) {
-  float rl, tb, fn;
-
-  glm__memzero(float, dest, sizeof(mat4));
-
-  rl = 1.0f / (right - left);
-  tb = 1.0f / (top - bottom);
-  fn = 1.0f / (farVal - nearVal);
-
-  dest[0][0] = 2.0f * nearVal * rl;
-  dest[1][1] = 2.0f * nearVal * tb;
-  dest[2][0] = (right + left) * rl;
-  dest[2][1] = (top + bottom) * tb;
-  dest[2][2] = -(farVal + nearVal) * fn;
-  dest[2][3] = -1.0f;
-  dest[3][2] = -2.0f * farVal * nearVal * fn;
-}
-
-CGLM_INLINE
-void
-glm_ortho(float left,
-          float right,
-          float bottom,
-          float top,
-          float nearVal,
-          float farVal,
-          mat4 dest) {
-  float rl, tb, fn;
-
-  glm__memzero(float, dest, sizeof(mat4));
-
-  rl = 1.0f / (right - left);
-  tb = 1.0f / (top - bottom);
-  fn = 1.0f / (farVal - nearVal);
-
-  dest[0][0] = 2.0f * rl;
-  dest[1][1] = 2.0f * tb;
-  dest[2][2] =-2.0f * fn;
-  dest[3][0] =-(right + left) * rl;
-  dest[3][1] =-(top + bottom) * tb;
-  dest[3][2] =-(farVal + nearVal) * fn;
-  dest[3][3] = 1.0f;
-}
-
-CGLM_INLINE
-void
-glm_ortho_default(mat4 dest) {
-  int32_t rect[4];
-  float aspectRatio;
-
-  glm_platfom_get_viewport_rect(rect);
-  aspectRatio = (float)rect[2]/rect[3];
-
-  if (rect[2] >= rect[3]) {
-    glm_ortho(-1.0f * aspectRatio,
-               1.0f * aspectRatio,
-              -1.0f,
-               1.0f,
-              -100.0f,
-               100.0f,
-               dest);
-  } else {
-    glm_ortho(-1.0f,
-               1.0f,
-              -1.0f / aspectRatio,
-               1.0f / aspectRatio,
-              -100.0f,
-               100.0f,
-               dest);
-  }
-}
-
-CGLM_INLINE
-void
-glm_ortho_default_s(float size, mat4 dest) {
-  int32_t rect[4];
-  float aspectRatio;
-
-  glm_platfom_get_viewport_rect(rect);
-  aspectRatio = (float)rect[2]/rect[3];
-
-  if (rect[2] >= rect[3]) {
-    glm_ortho(-size * aspectRatio,
-               size * aspectRatio,
-              -size,
-               size,
-              -size - 100.0f,
-               size + 100.0f,
-               dest);
-  } else {
-    glm_ortho(-size,
-               size,
-              -size / aspectRatio,
-               size / aspectRatio,
-              -size - 100.0f,
-               size + 100.0f,
-               dest);
-  }
-}
-
-CGLM_INLINE
-void
-glm_perspective(float fovy,
-                float aspect,
-                float nearVal,
-                float farVal,
-                mat4 dest) {
-  float f, fn;
-
-  glm__memzero(float, dest, sizeof(mat4));
-
-  f  = cosf(fovy * 0.5f) / sinf(fovy * 0.5f);
-  fn = 1.0f / (nearVal - farVal);
-
-  dest[0][0] = f / aspect;
-  dest[1][1] = f;
-  dest[2][2] = (nearVal + farVal) * fn;
-  dest[2][3] =-1.0f;
-  dest[3][2] = 2 * nearVal * farVal * fn;
-}
-
-CGLM_INLINE
-void
-glm_perspective_default(mat4 dest) {
-  int32_t rect[4];
-  glm_platfom_get_viewport_rect(rect);
-  
-  glm_perspective((float)CGLM_PI_4,
-                  (float)rect[2]/rect[3],
-                  0.01f,
-                  100.0f,
-                  dest);
-}
-
-CGLM_INLINE
-void
-glm_perspective_resize(mat4 proj) {
-  int32_t rect[4];
-
-  if (proj[0][0] == 0)
-    return;
-
-  glm_platfom_get_viewport_rect(rect);
-  proj[0][0] = (float)proj[1][1] * rect[3] / rect[2];
-}
-
-CGLM_INLINE
-void
-glm_lookat(vec3 eye,
-           vec3 center,
-           vec3 up,
-           mat4 dest) {
-  vec3 f, u, s;
-
-  glm_vec_sub(center, eye, f);
-  glm_vec_normalize(f);
-
-  glm_vec_cross(f, up, s);
-  glm_vec_normalize(s);
-
-  glm_vec_cross(s, f, u);
-
-  dest[0][0] = s[0];
-  dest[0][1] = u[0];
-  dest[0][2] =-f[0];
-  dest[1][0] = s[1];
-  dest[1][1] = u[1];
-  dest[1][2] =-f[1];
-  dest[2][0] = s[2];
-  dest[2][1] = u[2];
-  dest[2][2] =-f[2];
-  dest[3][0] =-glm_vec_dot(s, eye);
-  dest[3][1] =-glm_vec_dot(u, eye);
-  dest[3][2] = glm_vec_dot(f, eye);
-  dest[0][3] = dest[1][3] = dest[2][3] = 0.0f;
-  dest[3][3] = 1.0f;
-}
-
-#endif /* cglm_vcam_h */

include/cglm-opengl.h

@@ -1,20 +0,0 @@
-/*
- * Copyright (c), Recep Aslantas.
- *
- * MIT License (MIT), http://opensource.org/licenses/MIT
- * Full license can be found in the LICENSE file
- */
-
-#ifndef cglm_mat_opengl_h
-#define cglm_mat_opengl_h
-
-#include "cglm-common.h"
-#include "cglm-platform.h"
-
-CGLM_INLINE
-void
-glm_uniform(int32_t location, mat4 m) {
-  glm_platform_uniform_mat4fv(location, m[0]);
-}
-
-#endif /* cglm_mat_opengl_h */

include/cglm-platform.h

@@ -1,45 +0,0 @@
-/*
- * Copyright (c), Recep Aslantas.
- *
- * MIT License (MIT), http://opensource.org/licenses/MIT
- * Full license can be found in the LICENSE file
- */
-
-#ifndef cglm_platform_h
-#define cglm_platform_h
-
-#include "cglm-common.h"
-
-#ifdef __APPLE__
-#  include <OpenGL/gl3.h>
-#else
-#  ifdef _WIN32
-#    define WIN32_LEAN_AND_MEAN
-#    include <windows.h>
-#  endif
-#  include <GL/gl.h>
-#endif
-
-#ifdef _WIN32
-extern
-void
-glUniformMatrix4fv(GLint location,
-                   GLsizei count,
-                   GLboolean transpose,
-                   const GLfloat *value);
-#endif
-
-CGLM_INLINE
-void
-glm_platform_uniform_mat4fv(int32_t location,
-                            const float *value) {
-  glUniformMatrix4fv(location, 1, GL_FALSE, value);
-}
-
-CGLM_INLINE
-void
-glm_platfom_get_viewport_rect(int32_t *rect) {
-  glGetIntegerv(GL_VIEWPORT, rect);
-}
-
-#endif /* cglm_platform_h */

include/cglm-quat.h

@@ -1,182 +0,0 @@
-/*
- * Copyright (c), Recep Aslantas.
- *
- * MIT License (MIT), http://opensource.org/licenses/MIT
- * Full license can be found in the LICENSE file
- */
-
-#ifndef cglm_quat_h
-#define cglm_quat_h
-
-#include "cglm-common.h"
-#include "cglm-vec.h"
-#include "arch/simd/cglm-intrin.h"
-#include "arch/simd/cglm-quat-simd.h"
-
-#define GLM_QUAT_IDENTITY_INIT  {0.0f, 0.0f, 0.0f, 1.0f}
-#define GLM_QUAT_IDENTITY       (versor){0.0f, 0.0f, 0.0f, 1.0f}
-
-CGLM_INLINE
-void
-glm_quat_identity(versor q) {
-  glm_vec4_dup(GLM_QUAT_IDENTITY, q);
-}
-
-CGLM_INLINE
-void
-glm_quat(versor q,
-         float  angle,
-         float  x,
-         float  y,
-         float  z) {
-  float a, c, s;
-
-  a = angle / 2.0f;
-  c = cosf(a);
-  s = sinf(a);
-
-  q[0] = c;
-  q[1] = s * x;
-  q[2] = s * y;
-  q[3] = s * z;
-}
-
-CGLM_INLINE
-void
-glm_quatv(versor q,
-          float  angle,
-          vec3   v) {
-  float a, c, s;
-
-  a = angle / 2.0f;
-  c = cosf(a);
-  s = sinf(a);
-
-  q[0] = c;
-  q[1] = s * v[0];
-  q[2] = s * v[1];
-  q[3] = s * v[2];
-}
-
-CGLM_INLINE
-float
-glm_quat_norm(versor q) {
-  return glm_vec4_norm(q);
-}
-
-CGLM_INLINE
-void
-glm_quat_normalize(versor q) {
-  float sum;
-
-  sum = q[0] * q[0] + q[1] * q[1]
-          + q[2] * q[2] + q[3] * q[3];
-
-  if (fabs(1.0f - sum) < 0.0001f)
-    return;
-
-  glm_vec4_scale(q, 1.0f / sqrtf(sum), q);
-}
-
-CGLM_INLINE
-float
-glm_quat_dot(versor q, versor r) {
-  return glm_vec4_dot(q, r);
-}
-
-CGLM_INLINE
-void
-glm_quat_mulv(versor q1, versor q2, versor dest) {
-  dest[0] = q2[0] * q1[0] - q2[1] * q1[1] - q2[2] * q1[2] - q2[3] * q1[3];
-  dest[1] = q2[0] * q1[1] + q2[1] * q1[0] - q2[2] * q1[3] + q2[3] * q1[2];
-  dest[2] = q2[0] * q1[2] + q2[1] * q1[3] + q2[2] * q1[0] - q2[3] * q1[1];
-  dest[3] = q2[0] * q1[3] - q2[1] * q1[2] + q2[2] * q1[1] + q2[3] * q1[0];
-
-  glm_quat_normalize(dest);
-}
-
-CGLM_INLINE
-void
-glm_quat_mat4(versor q, mat4 dest) {
-  float w, x, y, z;
-
-  w = q[0];
-  x = q[1];
-  y = q[2];
-  z = q[3];
-
-  dest[0][0] = 1.0f - 2.0f * (y * y + z * z);
-  dest[0][1] = 2.0f * (x * y + w * z);
-  dest[0][2] = 2.0f * (x * z - w * y);
-  dest[0][3] = 0.0f;
-  dest[1][0] = 2.0f * (x * y - w * z);
-  dest[1][1] = 1.0f - 2.0f * (x * x + z * z);
-  dest[1][2] = 2.0f * (y * z + w * x);
-  dest[1][3] = 0.0f;
-  dest[2][0] = 2.0f * (x * z + w * y);
-  dest[2][1] = 2.0f * (y * z - w * x);
-  dest[2][2] = 1.0f - 2.0f * (x * x + y * y);
-  dest[2][3] = 0.0f;
-  dest[3][0] = 0.0f;
-  dest[3][1] = 0.0f;
-  dest[3][2] = 0.0f;
-  dest[3][3] = 1.0f;
-}
-
-CGLM_INLINE
-void
-glm_quat_slerp(versor q,
-               versor r,
-               float  t,
-               versor dest) {
-  /* https://en.wikipedia.org/wiki/Slerp */
-#if defined( __SSE__ ) || defined( __SSE2__ )
-  glm_quat_slerp_sse2(q, r, t, dest);
-#else
-  float cosTheta, sinTheta, angle, a, b, c;
-
-  cosTheta = glm_quat_dot(q, r);
-  if (cosTheta < 0.0f) {
-    q[0] *= -1.0f;
-    q[1] *= -1.0f;
-    q[2] *= -1.0f;
-    q[3] *= -1.0f;
-
-    cosTheta = -cosTheta;
-  }
-
-  if (fabs(cosTheta) >= 1.0f) {
-    dest[0] = q[0];
-    dest[1] = q[1];
-    dest[2] = q[2];
-    dest[3] = q[3];
-    return;
-  }
-
-  sinTheta = sqrt(1.0f - cosTheta * cosTheta);
-
-  c = 1.0f - t;
-
-  /* LERP */
-  /* TODO: FLT_EPSILON vs 0.001? */
-  if (sinTheta < 0.001f) {
-    dest[0] = c * q[0] + t * r[0];
-    dest[1] = c * q[1] + t * r[1];
-    dest[2] = c * q[2] + t * r[2];
-    dest[3] = c * q[3] + t * r[3];
-    return;
-  }
-
-  /* SLERP */
-  angle = acosf(cosTheta);
-  a = sinf(c * angle);
-  b = sinf(t * angle);
-
-  dest[0] = (q[0] * a + r[0] * b) / sinTheta;
-  dest[1] = (q[1] * a + r[1] * b) / sinTheta;
-  dest[2] = (q[2] * a + r[2] * b) / sinTheta;
-  dest[3] = (q[3] * a + r[3] * b) / sinTheta;
-#endif
-}
-
-#endif /* cglm_quat_h */

include/cglm-util.h

@@ -1,48 +0,0 @@
-/*
- * Copyright (c), Recep Aslantas.
- *
- * MIT License (MIT), http://opensource.org/licenses/MIT
- * Full license can be found in the LICENSE file
- */
-
-#ifndef cglm_util_h
-#define cglm_util_h
-
-#include "cglm-common.h"
-
-/*!
- * @brief get sign of 32 bit integer as +1 or -1
- *
- * @param X integer value
- */
-CGLM_INLINE
-int
-glm_sign(int val) {
-  return ((val >> 31) - (-val >> 31));
-}
-
-CGLM_INLINE
-float
-glm_rad(float deg) {
-  return deg * CGLM_PI / 180.0f;
-}
-
-CGLM_INLINE
-float
-glm_deg(float rad) {
-  return rad * 180.0f / CGLM_PI;
-}
-
-CGLM_INLINE
-void
-glm_make_rad(float *deg) {
-  *deg = *deg * CGLM_PI / 180.0f;
-}
-
-CGLM_INLINE
-void
-glm_make_deg(float *rad) {
-  *rad = *rad * 180.0f / CGLM_PI;
-}
-
-#endif /* cglm_util_h */

include/cglm-vec-ext.h

@@ -1,158 +0,0 @@
-/*
- * Copyright (c), Recep Aslantas.
- *
- * MIT License (MIT), http://opensource.org/licenses/MIT
- * Full license can be found in the LICENSE file
- */
-
-/*!
- * @brief SIMD like functions
- */
-
-#ifndef cglm_vec_ext_h
-#define cglm_vec_ext_h
-
-#include "cglm-common.h"
-#include "arch/simd/cglm-intrin.h"
-#include <stdbool.h>
-
-/*!
- * @brief multiplies individual items, just for convenient like SIMD
- *
- * @param a vec1
- * @param b vec2
- * @param d vec3 = (v1[0] * v2[0],  v1[1] * v2[1], v1[2] * v2[2])
- */
-CGLM_INLINE
-void
-glm_vec_mulv(vec3 a, vec3 b, vec3 d) {
-  d[0] = a[0] * b[0];
-  d[1] = a[1] * b[1];
-  d[2] = a[2] * b[2];
-}
-
-/*!
- * @brief multiplies individual items, just for convenient like SIMD
- *
- * @param a v1
- * @param b v2
- * @param d v3 = (v1[0] * v2[0],  v1[1] * v2[1], v1[2] * v2[2], v1[3] * v2[3])
- */
-CGLM_INLINE
-void
-glm_vec4_mulv(vec4 a, vec4 b, vec4 d) {
-#if defined( __SSE__ ) || defined( __SSE2__ )
-  _mm_store_ps(d, _mm_mul_ps(_mm_load_ps(a), _mm_load_ps(b)));
-#else
-  d[0] = a[0] * b[0];
-  d[1] = a[1] * b[1];
-  d[2] = a[2] * b[2];
-  d[3] = a[3] * b[3];
-#endif
-}
-
-CGLM_INLINE
-void
-glm_vec_broadcast(float val, vec3 d) {
-  d[0] = d[1] = d[2] = val;
-}
-
-CGLM_INLINE
-void
-glm_vec4_broadcast(float val, vec3 d) {
-#if defined( __SSE__ ) || defined( __SSE2__ )
-  _mm_store_ps(d, _mm_set1_ps(val));
-#else
-  d[0] = d[1] = d[2] = d[3] = val;
-#endif
-}
-
-CGLM_INLINE
-bool
-glm_vec_eq(vec3 v, float val) {
-  return v[0] == val && v[0] == v[1] && v[0] == v[2];
-}
-
-CGLM_INLINE
-bool
-glm_vec_eq_all(vec3 v) {
-  return v[0] == v[1] && v[0] == v[2];
-}
-
-CGLM_INLINE
-bool
-glm_vec_eqv(vec3 v1, vec3 v2) {
-  return v1[0] == v2[0] && v1[1] == v2[1] && v1[2] == v2[2];
-}
-
-CGLM_INLINE
-bool
-glm_vec4_eq(vec4 v, float val) {
-  return v[0] == val && v[0] == v[1] && v[0] == v[2] && v[0] == v[3];
-}
-
-CGLM_INLINE
-bool
-glm_vec4_eq_all(vec4 v) {
-  return v[0] == v[1] && v[0] == v[2] && v[0] == v[3];
-}
-
-CGLM_INLINE
-bool
-glm_vec4_eqv(vec4 v1, vec4 v2) {
-  return v1[0] == v2[0] && v1[1] == v2[1] && v1[2] == v2[2] && v1[3] == v2[3];
-}
-
-CGLM_INLINE
-float
-glm_vec_max(vec3 v) {
-  float max;
-
-  max = v[0];
-  if (v[1] > max)
-    max = v[1];
-  if (v[2] > max)
-    max = v[2];
-
-  return max;
-}
-
-CGLM_INLINE
-float
-glm_vec_min(vec3 v) {
-  float min;
-
-  min = v[0];
-  if (v[1] < min)
-    min = v[1];
-  if (v[2] < min)
-    min = v[2];
-
-  return min;
-}
-
-CGLM_INLINE
-float
-glm_vec4_max(vec4 v) {
-  float max;
-
-  max = glm_vec_max(v);
-  if (v[3] > max)
-    max = v[3];
-
-  return max;
-}
-
-CGLM_INLINE
-float
-glm_vec4_min(vec4 v) {
-  float min;
-
-  min = glm_vec_max(v);
-  if (v[3] < min)
-    min = v[3];
-
-  return min;
-}
-
-#endif /* cglm_vec_ext_h */

include/cglm.h

@@ -1,22 +0,0 @@
-/*
- * Copyright (c), Recep Aslantas.
- *
- * MIT License (MIT), http://opensource.org/licenses/MIT
- * Full license can be found in the LICENSE file
- */
-
-#ifndef cglm_h
-#define cglm_h
-
-#include "cglm-common.h"
-#include "cglm-vec.h"
-#include "cglm-mat.h"
-#include "cglm-mat3.h"
-#include "cglm-affine.h"
-#include "cglm-cam.h"
-#include "cglm-quat.h"
-#include "cglm-euler.h"
-#include "cglm-util.h"
-#include "cglm-io.h"
-
-#endif /* cglm_h */

include/cglm/affine-mat.h

@@ -5,17 +5,42 @@
  * Full license can be found in the LICENSE file
  */
 
+/*
+ Functions:
+   CGLM_INLINE void glm_mul(mat4 m1, mat4 m2, mat4 dest);
+   CGLM_INLINE void glm_inv_tr(mat4 mat);
+ */
+
 #ifndef cglm_affine_mat_h
 #define cglm_affine_mat_h
 
-#include "cglm-common.h"
-#include "cglm-mat.h"
-#include "cglm-mat3.h"
-#include "arch/simd/cglm-affine-mat-sse2.h"
-#include "arch/simd/cglm-affine-mat-avx.h"
+#include "common.h"
+#include "mat4.h"
 
-#include <assert.h>
+#ifdef CGLM_SSE_FP
+#  include "simd/sse2/affine.h"
+#endif
 
+#ifdef CGLM_AVX_FP
+#  include "simd/avx/affine.h"
+#endif
+
+/*!
+ * @brief this is similar to glm_mat4_mul but specialized to affine transform
+ *
+ * Matrix format should be:
+ *   R  R  R  X
+ *   R  R  R  Y
+ *   R  R  R  Z
+ *   0  0  0  W
+ *
+ * this reduces some multiplications. It should be faster than mat4_mul.
+ * if you are not sure about matrix format then DON'T use this! use mat4_mul
+ *
+ * @param[in]   m1    affine matrix 1
+ * @param[in]   m2    affine matrix 2
+ * @param[out]  dest  result matrix
+ */
 CGLM_INLINE
 void
 glm_mul(mat4 m1, mat4 m2, mat4 dest) {
@@ -24,20 +49,15 @@ glm_mul(mat4 m1, mat4 m2, mat4 dest) {
 #elif defined( __SSE__ ) || defined( __SSE2__ )
   glm_mul_sse2(m1, m2, dest);
 #else
-  float a00, a01, a02, a03,    b00, b01, b02,
-        a10, a11, a12, a13,    b10, b11, b12,
-        a20, a21, a22, a23,    b20, b21, b22,
-        a30, a31, a32, a33,    b30, b31, b32, b33;
+  float a00 = m1[0][0], a01 = m1[0][1], a02 = m1[0][2], a03 = m1[0][3],
+        a10 = m1[1][0], a11 = m1[1][1], a12 = m1[1][2], a13 = m1[1][3],
+        a20 = m1[2][0], a21 = m1[2][1], a22 = m1[2][2], a23 = m1[2][3],
+        a30 = m1[3][0], a31 = m1[3][1], a32 = m1[3][2], a33 = m1[3][3],
 
-  a00 = m1[0][0], a01 = m1[0][1], a02 = m1[0][2], a03 = m1[0][3],
-  a10 = m1[1][0], a11 = m1[1][1], a12 = m1[1][2], a13 = m1[1][3],
-  a20 = m1[2][0], a21 = m1[2][1], a22 = m1[2][2], a23 = m1[2][3],
-  a30 = m1[3][0], a31 = m1[3][1], a32 = m1[3][2], a33 = m1[3][3];
-
-  b00 = m2[0][0], b01 = m2[0][1], b02 = m2[0][2],
-  b10 = m2[1][0], b11 = m2[1][1], b12 = m2[1][2],
-  b20 = m2[2][0], b21 = m2[2][1], b22 = m2[2][2],
-  b30 = m2[3][0], b31 = m2[3][1], b32 = m2[3][2], b33 = m2[3][3];
+        b00 = m2[0][0], b01 = m2[0][1], b02 = m2[0][2],
+        b10 = m2[1][0], b11 = m2[1][1], b12 = m2[1][2],
+        b20 = m2[2][0], b21 = m2[2][1], b22 = m2[2][2],
+        b30 = m2[3][0], b31 = m2[3][1], b32 = m2[3][2], b33 = m2[3][3];
 
   dest[0][0] = a00 * b00 + a10 * b01 + a20 * b02;
   dest[0][1] = a01 * b00 + a11 * b01 + a21 * b02;
@@ -87,7 +107,7 @@ glm_inv_tr(mat4 mat) {
   /* translate */
   glm_mat3_mulv(r, mat[3], t);
   glm_vec_flipsign(t);
-  glm_vec_dup(t, mat[3]);
+  glm_vec_copy(t, mat[3]);
 #endif
 }
 

include/cglm/affine.h

@@ -5,14 +5,48 @@
  * Full license can be found in the LICENSE file
  */
 
+/*
+ Functions:
+   CGLM_INLINE void glm_translate_to(mat4 m, vec3 v, mat4 dest);
+   CGLM_INLINE void glm_translate(mat4 m, vec3 v);
+   CGLM_INLINE void glm_translate_x(mat4 m, float to);
+   CGLM_INLINE void glm_translate_y(mat4 m, float to);
+   CGLM_INLINE void glm_translate_z(mat4 m, float to);
+   CGLM_INLINE void glm_translate_make(mat4 m, vec3 v);
+   CGLM_INLINE void glm_scale_to(mat4 m, vec3 v, mat4 dest);
+   CGLM_INLINE void glm_scale_make(mat4 m, vec3 v);
+   CGLM_INLINE void glm_scale(mat4 m, vec3 v);
+   CGLM_INLINE void glm_scale1(mat4 m, float s);
+   CGLM_INLINE void glm_scale_uni(mat4 m, float s);
+   CGLM_INLINE void glm_rotate_x(mat4 m, float angle, mat4 dest);
+   CGLM_INLINE void glm_rotate_y(mat4 m, float angle, mat4 dest);
+   CGLM_INLINE void glm_rotate_z(mat4 m, float angle, mat4 dest);
+   CGLM_INLINE void glm_rotate_ndc_make(mat4 m, float angle, vec3 axis_ndc);
+   CGLM_INLINE void glm_rotate_make(mat4 m, float angle, vec3 axis);
+   CGLM_INLINE void glm_rotate_ndc(mat4 m, float angle, vec3 axis);
+   CGLM_INLINE void glm_rotate(mat4 m, float angle, vec3 axis);
+   CGLM_INLINE void glm_decompose_scalev(mat4 m, vec3 s);
+   CGLM_INLINE bool glm_uniscaled(mat4 m);
+   CGLM_INLINE void glm_decompose_rs(mat4 m, mat4 r, vec3 s);
+   CGLM_INLINE void glm_decompose(mat4 m, vec4 t, mat4 r, vec3 s);
+ */
+
 #ifndef cglm_affine_h
 #define cglm_affine_h
 
-#include "cglm-common.h"
-#include "cglm-vec.h"
-#include "cglm-affine-mat.h"
-#include "cglm-util.h"
+#include "common.h"
+#include "vec4.h"
+#include "affine-mat.h"
+#include "util.h"
 
+/*!
+ * @brief translate existing transform matrix by v vector
+ *        and store result in dest
+ *
+ * @param[in]  m    affine transfrom
+ * @param[in]  v    translate vector [x, y, z]
+ * @param[out] dest translated matrix
+ */
 CGLM_INLINE
 void
 glm_translate_to(mat4 m, vec3 v, mat4 dest) {
@@ -47,6 +81,13 @@ glm_translate_to(mat4 m, vec3 v, mat4 dest) {
 #endif
 }
 
+/*!
+ * @brief translate existing transform matrix by v vector
+ *        and stores result in same matrix
+ *
+ * @param[in, out]  m  affine transfrom
+ * @param[in]       v  translate vector [x, y, z]
+ */
 CGLM_INLINE
 void
 glm_translate(mat4 m, vec3 v) {
@@ -73,56 +114,93 @@ glm_translate(mat4 m, vec3 v) {
 #endif
 }
 
+/*!
+ * @brief translate existing transform matrix by x factor
+ *
+ * @param[in, out]  m  affine transfrom
+ * @param[in]       x  x factor
+ */
 CGLM_INLINE
 void
-glm_translate_x(mat4 m, float to) {
+glm_translate_x(mat4 m, float x) {
 #if defined( __SSE__ ) || defined( __SSE2__ )
   _mm_store_ps(m[3],
                _mm_add_ps(_mm_mul_ps(_mm_load_ps(m[0]),
-                                     _mm_set1_ps(to)),
+                                     _mm_set1_ps(x)),
                           _mm_load_ps(m[3])))
   ;
 #else
   vec4 v1;
-  glm_vec4_scale(m[0], to, v1);
+  glm_vec4_scale(m[0], x, v1);
   glm_vec4_add(v1, m[3], m[3]);
 #endif
 }
 
+/*!
+ * @brief translate existing transform matrix by y factor
+ *
+ * @param[in, out]  m  affine transfrom
+ * @param[in]       y  y factor
+ */
 CGLM_INLINE
 void
-glm_translate_y(mat4 m, float to) {
+glm_translate_y(mat4 m, float y) {
 #if defined( __SSE__ ) || defined( __SSE2__ )
   _mm_store_ps(m[3],
                _mm_add_ps(_mm_mul_ps(_mm_load_ps(m[1]),
-                                     _mm_set1_ps(to)),
+                                     _mm_set1_ps(y)),
                           _mm_load_ps(m[3])))
   ;
 #else
   vec4 v1;
-  glm_vec4_scale(m[1], to, v1);
+  glm_vec4_scale(m[1], y, v1);
   glm_vec4_add(v1, m[3], m[3]);
 #endif
 }
 
+/*!
+ * @brief translate existing transform matrix by z factor
+ *
+ * @param[in, out]  m  affine transfrom
+ * @param[in]       z  z factor
+ */
 CGLM_INLINE
 void
-glm_translate_z(mat4 m, float to) {
+glm_translate_z(mat4 m, float z) {
 #if defined( __SSE__ ) || defined( __SSE2__ )
   _mm_store_ps(m[3],
                _mm_add_ps(_mm_mul_ps(_mm_load_ps(m[2]),
-                                     _mm_set1_ps(to)),
+                                     _mm_set1_ps(z)),
                           _mm_load_ps(m[3])))
   ;
 #else
   vec4 v1;
-  glm_vec4_scale(m[2], to, v1);
+  glm_vec4_scale(m[2], z, v1);
   glm_vec4_add(v1, m[3], m[3]);
 #endif
 }
 
-/* scale */
+/*!
+ * @brief creates NEW translate transform matrix by v vector
+ *
+ * @param[out]  m  affine transfrom
+ * @param[in]   v  translate vector [x, y, z]
+ */
+CGLM_INLINE
+void
+glm_translate_make(mat4 m, vec3 v) {
+  mat4 t = GLM_MAT4_IDENTITY_INIT;
+  glm_translate_to(t, v, m);
+}
 
+/*!
+ * @brief scale existing transform matrix by v vector
+ *        and store result in dest
+ *
+ * @param[in]  m    affine transfrom
+ * @param[in]  v    scale vector [x, y, z]
+ * @param[out] dest scaled matrix
+ */
 CGLM_INLINE
 void
 glm_scale_to(mat4 m, vec3 v, mat4 dest) {
@@ -130,15 +208,38 @@ glm_scale_to(mat4 m, vec3 v, mat4 dest) {
   glm_vec4_scale(m[1], v[1], dest[1]);
   glm_vec4_scale(m[2], v[2], dest[2]);
 
-  glm_vec4_dup(m[3], dest[3]);
+  glm_vec4_copy(m[3], dest[3]);
 }
 
+/*!
+ * @brief creates NEW scale matrix by v vector
+ *
+ * @param[out]  m  affine transfrom
+ * @param[in]   v  scale vector [x, y, z]
+ */
+CGLM_INLINE
+void
+glm_scale_make(mat4 m, vec3 v) {
+  mat4 t = GLM_MAT4_IDENTITY_INIT;
+  glm_scale_to(t, v, m);
+}
+
+/*!
+ * @brief scales existing transform matrix by v vector
+ *        and stores result in same matrix
+ *
+ * @param[in, out]  m  affine transfrom
+ * @param[in]       v  scale vector [x, y, z]
+ */
 CGLM_INLINE
 void
 glm_scale(mat4 m, vec3 v) {
   glm_scale_to(m, v, m);
 }
 
+/*!
+ * @brief DEPRECATED! Use glm_scale_uni
+ */
 CGLM_INLINE
 void
 glm_scale1(mat4 m, float s) {
@@ -146,15 +247,37 @@ glm_scale1(mat4 m, float s) {
   glm_scale_to(m, v, m);
 }
 
+/*!
+ * @brief applies uniform scale to existing transform matrix v = [s, s, s]
+ *        and stores result in same matrix
+ *
+ * @param[in, out]  m  affine transfrom
+ * @param[in]       s  scale factor
+ */
 CGLM_INLINE
 void
-glm_rotate_x(mat4 m, float rad, mat4 dest) {
+glm_scale_uni(mat4 m, float s) {
+  vec3 v = { s, s, s };
+  glm_scale_to(m, v, m);
+}
+
+/*!
+ * @brief rotate existing transform matrix around X axis by angle
+ *        and store result in dest
+ *
+ * @param[in]   m      affine transfrom
+ * @param[in]   angle  angle (radians)
+ * @param[out]  dest   rotated matrix
+ */
+CGLM_INLINE
+void
+glm_rotate_x(mat4 m, float angle, mat4 dest) {
   float cosVal;
   float sinVal;
   mat4  t = GLM_MAT4_IDENTITY_INIT;
 
-  cosVal = cosf(rad);
-  sinVal = sinf(rad);
+  cosVal = cosf(angle);
+  sinVal = sinf(angle);
 
   t[1][1] =  cosVal;
   t[1][2] =  sinVal;
@@ -164,15 +287,23 @@ glm_rotate_x(mat4 m, float rad, mat4 dest) {
   glm_mat4_mul(m, t, dest);
 }
 
+/*!
+ * @brief rotate existing transform matrix around Y axis by angle
+ *        and store result in dest
+ *
+ * @param[in]   m      affine transfrom
+ * @param[in]   angle  angle (radians)
+ * @param[out]  dest   rotated matrix
+ */
 CGLM_INLINE
 void
-glm_rotate_y(mat4 m, float rad, mat4 dest) {
+glm_rotate_y(mat4 m, float angle, mat4 dest) {
   float cosVal;
   float sinVal;
   mat4  t = GLM_MAT4_IDENTITY_INIT;
 
-  cosVal = cosf(rad);
-  sinVal = sinf(rad);
+  cosVal = cosf(angle);
+  sinVal = sinf(angle);
 
   t[0][0] =  cosVal;
   t[0][2] = -sinVal;
@@ -182,15 +313,23 @@ glm_rotate_y(mat4 m, float rad, mat4 dest) {
   glm_mat4_mul(m, t, dest);
 }
 
+/*!
+ * @brief rotate existing transform matrix around Z axis by angle
+ *        and store result in dest
+ *
+ * @param[in]   m      affine transfrom
+ * @param[in]   angle  angle (radians)
+ * @param[out]  dest   rotated matrix
+ */
 CGLM_INLINE
 void
-glm_rotate_z(mat4 m, float rad, mat4 dest) {
+glm_rotate_z(mat4 m, float angle, mat4 dest) {
   float cosVal;
   float sinVal;
   mat4  t = GLM_MAT4_IDENTITY_INIT;
 
-  cosVal = cosf(rad);
-  sinVal = sinf(rad);
+  cosVal = cosf(angle);
+  sinVal = sinf(angle);
 
   t[0][0] =  cosVal;
   t[0][1] =  sinVal;
@@ -200,6 +339,15 @@ glm_rotate_z(mat4 m, float rad, mat4 dest) {
   glm_mat4_mul(m, t, dest);
 }
 
+/*!
+ * @brief creates NEW rotation matrix by angle and axis
+ *
+ * this name may change in the future. axis must be is normalized
+ *
+ * @param[out] m        affine transfrom
+ * @param[in]  angle    angle (radians)
+ * @param[in]  axis_ndc normalized axis
+ */
 CGLM_INLINE
 void
 glm_rotate_ndc_make(mat4 m, float angle, vec3 axis_ndc) {
@@ -233,6 +381,15 @@ glm_rotate_ndc_make(mat4 m, float angle, vec3 axis_ndc) {
   m[3][3] = 1.0f;
 }
 
+/*!
+ * @brief creates NEW rotation matrix by angle and axis
+ *
+ * axis will be normalized so you don't need to normalize it
+ *
+ * @param[out] m     affine transfrom
+ * @param[in]  angle angle (radians)
+ * @param[in]  axis  axis
+ */
 CGLM_INLINE
 void
 glm_rotate_make(mat4 m, float angle, vec3 axis) {
@@ -242,6 +399,15 @@ glm_rotate_make(mat4 m, float angle, vec3 axis) {
   glm_rotate_ndc_make(m, angle, axis_ndc);
 }
 
+/*!
+ * @brief rotate existing transform matrix around Z axis by angle and axis
+ *
+ * this name may change in the future, axis must be normalized.
+ *
+ * @param[in, out]  m         affine transfrom
+ * @param[in]       angle     angle (radians)
+ * @param[in]       axis_ndc  normalized axis
+ */
 CGLM_INLINE
 void
 glm_rotate_ndc(mat4 m, float angle, vec3 axis_ndc) {
@@ -267,11 +433,18 @@ glm_rotate_ndc(mat4 m, float angle, vec3 axis_ndc) {
   glm_vec4_scale(m[2], rot[2][2], tmp[0]);
   glm_vec4_add(tmp[3], tmp[0],    tmp[3]);
 
-  glm_vec4_dup(tmp[1], m[0]);
-  glm_vec4_dup(tmp[2], m[1]);
-  glm_vec4_dup(tmp[3], m[2]);
+  glm_vec4_copy(tmp[1], m[0]);
+  glm_vec4_copy(tmp[2], m[1]);
+  glm_vec4_copy(tmp[3], m[2]);
 }
 
+/*!
+ * @brief rotate existing transform matrix around Z axis by angle and axis
+ *
+ * @param[in, out]  m      affine transfrom
+ * @param[in]       angle  angle (radians)
+ * @param[in]       axis   axis
+ */
 CGLM_INLINE
 void
 glm_rotate(mat4 m, float angle, vec3 axis) {
@@ -284,8 +457,8 @@ glm_rotate(mat4 m, float angle, vec3 axis) {
 /*!
  * @brief decompose scale vector
  *
- * @param[in]  m     affine transform
- * @param[out] s     scale vector (Sx, Sy, Sz)
+ * @param[in]  m  affine transform
+ * @param[out] s  scale vector (Sx, Sy, Sz)
  */
 CGLM_INLINE
 void
@@ -299,7 +472,7 @@ glm_decompose_scalev(mat4 m, vec3 s) {
  * @brief returns true if matrix is uniform scaled. This is helpful for 
  *        creating normal matrix.
  *
- * @param m[in] m
+ * @param[in] m m
  *
  * @return boolean
  */
@@ -314,10 +487,11 @@ glm_uniscaled(mat4 m) {
 
 /*!
  * @brief decompose rotation matrix (mat4) and scale vector [Sx, Sy, Sz]
+ *        DON'T pass projected matrix here
  *
  * @param[in]  m affine transform
  * @param[out] r rotation matrix
- * @param[out] r scale matrix
+ * @param[out] s scale matrix
  */
 CGLM_INLINE
 void
@@ -325,10 +499,10 @@ glm_decompose_rs(mat4 m, mat4 r, vec3 s) {
   vec4 t = {0.0f, 0.0f, 0.0f, 1.0f};
   vec3 v;
 
-  glm_vec4_dup(m[0], r[0]);
-  glm_vec4_dup(m[1], r[1]);
-  glm_vec4_dup(m[2], r[2]);
-  glm_vec4_dup(t,    r[3]);
+  glm_vec4_copy(m[0], r[0]);
+  glm_vec4_copy(m[1], r[1]);
+  glm_vec4_copy(m[2], r[2]);
+  glm_vec4_copy(t,    r[3]);
 
   s[0] = glm_vec_norm(m[0]);
   s[1] = glm_vec_norm(m[1]);
@@ -338,18 +512,21 @@ glm_decompose_rs(mat4 m, mat4 r, vec3 s) {
   glm_vec4_scale(r[1], 1.0f/s[1], r[1]);
   glm_vec4_scale(r[2], 1.0f/s[2], r[2]);
 
+  /* Note from Apple Open Source (asume that the matrix is orthonormal):
+     check for a coordinate system flip.  If the determinant
+     is -1, then negate the matrix and the scaling factors. */
   glm_vec_cross(m[0], m[1], v);
   if (glm_vec_dot(v, m[2]) < 0.0f) {
-    glm_vec4_scale(r[0], -1.0f, r[0]);
-    glm_vec4_scale(r[1], -1.0f, r[1]);
-    glm_vec4_scale(r[2], -1.0f, r[2]);
-
-    glm_vec_scale(s, -1.0f, s);
+    glm_vec4_flipsign(r[0]);
+    glm_vec4_flipsign(r[1]);
+    glm_vec4_flipsign(r[2]);
+    glm_vec_flipsign(s);
   }
 }
 
 /*!
- * @brief decompose affine transform
+ * @brief decompose affine transform, TODO: extract shear factors.
+ *        DON'T pass projected matrix here
  *
  * @param[in]  m affine transfrom
  * @param[out] t translation vector
@@ -359,7 +536,7 @@ glm_decompose_rs(mat4 m, mat4 r, vec3 s) {
 CGLM_INLINE
 void
 glm_decompose(mat4 m, vec4 t, mat4 r, vec3 s) {
-  glm_vec4_dup(m[3], t);
+  glm_vec4_copy(m[3], t);
   glm_decompose_rs(m, r, s);
 }
 

include/cglm/box.h

@@ -0,0 +1,156 @@
+/*
+ * Copyright (c), Recep Aslantas.
+ *
+ * MIT License (MIT), http://opensource.org/licenses/MIT
+ * Full license can be found in the LICENSE file
+ */
+
+#ifndef cglm_box_h
+#define cglm_box_h
+
+#include "common.h"
+#include "vec3.h"
+#include "vec4.h"
+
+/*!
+ * @brief apply transform to Axis-Aligned Bounding Box
+ *
+ * @param[in]  box  bounding box
+ * @param[in]  m    transform matrix
+ * @param[out] dest transformed bounding box
+ */
+CGLM_INLINE
+void
+glm_aabb_transform(vec3 box[2], mat4 m, vec3 dest[2]) {
+  vec3 v[2], xa, xb, ya, yb, za, zb, tmp;
+
+  glm_vec_scale(m[0], box[0][0], xa);
+  glm_vec_scale(m[0], box[1][0], xb);
+
+  glm_vec_scale(m[1], box[0][1], ya);
+  glm_vec_scale(m[1], box[1][1], yb);
+
+  glm_vec_scale(m[2], box[0][2], za);
+  glm_vec_scale(m[2], box[1][2], zb);
+
+  /* min(xa, xb) + min(ya, yb) + min(za, zb) + translation */
+  glm_vec_minv(xa, xb, v[0]);
+  glm_vec_minv(ya, yb, tmp);
+  glm_vec_add(v[0], tmp, v[0]);
+  glm_vec_minv(za, zb, tmp);
+  glm_vec_add(v[0], tmp, v[0]);
+  glm_vec_add(v[0], m[3], v[0]);
+
+  /* max(xa, xb) + max(ya, yb) + max(za, zb) + translation */
+  glm_vec_maxv(xa, xb, v[1]);
+  glm_vec_maxv(ya, yb, tmp);
+  glm_vec_add(v[1], tmp, v[1]);
+  glm_vec_maxv(za, zb, tmp);
+  glm_vec_add(v[1], tmp, v[1]);
+  glm_vec_add(v[1], m[3], v[1]);
+
+  glm_vec_copy(v[0], dest[0]);
+  glm_vec_copy(v[1], dest[1]);
+}
+
+/*!
+ * @brief merges two AABB bounding box and creates new one
+ *
+ * two box must be in same space, if one of box is in different space then
+ * you should consider to convert it's space by glm_box_space
+ *
+ * @param[in]  box1 bounding box 1
+ * @param[in]  box2 bounding box 2
+ * @param[out] dest merged bounding box
+ */
+CGLM_INLINE
+void
+glm_aabb_merge(vec3 box1[2], vec3 box2[2], vec3 dest[2]) {
+  dest[0][0] = glm_min(box1[0][0], box2[0][0]);
+  dest[0][1] = glm_min(box1[0][1], box2[0][1]);
+  dest[0][2] = glm_min(box1[0][2], box2[0][2]);
+
+  dest[1][0] = glm_max(box1[1][0], box2[1][0]);
+  dest[1][1] = glm_max(box1[1][1], box2[1][1]);
+  dest[1][2] = glm_max(box1[1][2], box2[1][2]);
+}
+
+/*!
+ * @brief crops a bounding box with another one.
+ *
+ * this could be useful for gettng a bbox which fits with view frustum and
+ * object bounding boxes. In this case you crop view frustum box with objects
+ * box
+ *
+ * @param[in]  box     bounding box 1
+ * @param[in]  cropBox crop box
+ * @param[out] dest    cropped bounding box
+ */
+CGLM_INLINE
+void
+glm_aabb_crop(vec3 box[2], vec3 cropBox[2], vec3 dest[2]) {
+  dest[0][0] = glm_max(box[0][0], cropBox[0][0]);
+  dest[0][1] = glm_max(box[0][1], cropBox[0][1]);
+  dest[0][2] = glm_max(box[0][2], cropBox[0][2]);
+
+  dest[1][0] = glm_min(box[1][0], cropBox[1][0]);
+  dest[1][1] = glm_min(box[1][1], cropBox[1][1]);
+  dest[1][2] = glm_min(box[1][2], cropBox[1][2]);
+}
+
+/*!
+ * @brief crops a bounding box with another one.
+ *
+ * this could be useful for gettng a bbox which fits with view frustum and
+ * object bounding boxes. In this case you crop view frustum box with objects
+ * box
+ *
+ * @param[in]  box      bounding box
+ * @param[in]  cropBox  crop box
+ * @param[in]  clampBox miniumum box
+ * @param[out] dest     cropped bounding box
+ */
+CGLM_INLINE
+void
+glm_aabb_crop_until(vec3 box[2],
+                    vec3 cropBox[2],
+                    vec3 clampBox[2],
+                    vec3 dest[2]) {
+  glm_aabb_crop(box, cropBox, dest);
+  glm_aabb_merge(clampBox, dest, dest);
+}
+
+/*!
+ * @brief check if AABB intersects with frustum planes
+ *
+ * this could be useful for frustum culling using AABB.
+ *
+ * OPTIMIZATION HINT:
+ *  if planes order is similar to LEFT, RIGHT, BOTTOM, TOP, NEAR, FAR
+ *  then this method should run even faster because it would only use two
+ *  planes if object is not inside the two planes
+ *  fortunately cglm extracts planes as this order! just pass what you got!
+ *
+ * @param[in]  box     bounding box
+ * @param[in]  planes  frustum planes
+ */
+CGLM_INLINE
+bool
+glm_aabb_frustum(vec3 box[2], vec4 planes[6]) {
+  float *p, dp;
+  int    i;
+
+  for (i = 0; i < 6; i++) {
+    p  = planes[i];
+    dp = p[0] * box[p[0] > 0.0f][0]
+       + p[1] * box[p[1] > 0.0f][1]
+       + p[2] * box[p[2] > 0.0f][2];
+
+    if (dp < -p[3])
+      return false;
+  }
+
+  return true;
+}
+
+#endif /* cglm_box_h */

include/cglm/call.h

@@ -12,14 +12,18 @@ extern "C" {
 #endif
 
 #include "cglm.h"
-#include "call/cglmc-vec.h"
-#include "call/cglmc-mat.h"
-#include "call/cglmc-mat3.h"
-#include "call/cglmc-affine.h"
-#include "call/cglmc-cam.h"
-#include "call/cglmc-quat.h"
-#include "call/cglmc-euler.h"
-#include "call/cglmc-io.h"
+#include "call/vec3.h"
+#include "call/vec4.h"
+#include "call/mat4.h"
+#include "call/mat3.h"
+#include "call/affine.h"
+#include "call/cam.h"
+#include "call/quat.h"
+#include "call/euler.h"
+#include "call/plane.h"
+#include "call/frustum.h"
+#include "call/box.h"
+#include "call/io.h"
 
 #ifdef __cplusplus
 }

include/cglm/call/box.h

@@ -0,0 +1,39 @@
+/*
+ * Copyright (c), Recep Aslantas.
+ *
+ * MIT License (MIT), http://opensource.org/licenses/MIT
+ * Full license can be found in the LICENSE file
+ */
+
+#ifndef cglmc_box_h
+#define cglmc_box_h
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#include "../cglm.h"
+
+CGLM_EXPORT
+void
+glmc_aabb_transform(vec3 box[2], mat4 m, vec3 dest[2]);
+
+CGLM_EXPORT
+void
+glmc_aabb_merge(vec3 box1[2], vec3 box2[2], vec3 dest[2]);
+
+CGLM_EXPORT
+void
+glmc_aabb_crop(vec3 box[2], vec3 cropBox[2], vec3 dest[2]);
+
+CGLM_EXPORT
+void
+glmc_aabb_crop_until(vec3 box[2],
+                     vec3 cropBox[2],
+                     vec3 clampBox[2],
+                     vec3 dest[2]);
+
+#ifdef __cplusplus
+}
+#endif
+#endif /* cglmc_box_h */
+

include/cglm/call/cam.h

@@ -43,10 +43,15 @@ glmc_perspective(float fovy,
 
 CGLM_EXPORT
 void
-glmc_lookat(vec3 eye,
-            vec3 center,
-            vec3 up,
-            mat4 dest);
+glmc_lookat(vec3 eye, vec3 center, vec3 up, mat4 dest);
+
+CGLM_EXPORT
+void
+glmc_look(vec3 eye, vec3 dir, vec3 up, mat4 dest);
+
+CGLM_EXPORT
+void
+glmc_look_anyup(vec3 eye, vec3 dir, mat4 dest);
 
 #ifdef __cplusplus
 }

include/cglm/call/euler.h

@@ -5,8 +5,8 @@
  * Full license can be found in the LICENSE file
  */
 
-#ifndef glmc_euler_h
-#define glmc_euler_h
+#ifndef cglmc_euler_h
+#define cglmc_euler_h
 #ifdef __cplusplus
 extern "C" {
 #endif
@@ -48,4 +48,4 @@ glmc_euler_by_order(vec3 angles, glm_euler_sq axis, mat4 dest);
 #ifdef __cplusplus
 }
 #endif
-#endif /* glmc_euler_h */
+#endif /* cglmc_euler_h */

include/cglm/call/frustum.h

@@ -0,0 +1,41 @@
+/*
+ * Copyright (c), Recep Aslantas.
+ *
+ * MIT License (MIT), http://opensource.org/licenses/MIT
+ * Full license can be found in the LICENSE file
+ */
+
+#ifndef cglmc_frustum_h
+#define cglmc_frustum_h
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#include "../cglm.h"
+
+CGLM_EXPORT
+void
+glmc_frustum_planes(mat4 m, vec4 dest[6]);
+
+CGLM_EXPORT
+void
+glmc_frustum_corners(mat4 invMat, vec4 dest[8]);
+
+CGLM_EXPORT
+void
+glmc_frustum_center(vec4 corners[8], vec4 dest);
+
+CGLM_EXPORT
+void
+glmc_frustum_box(vec4 corners[8], mat4 m, vec3 box[2]);
+
+CGLM_EXPORT
+void
+glmc_frustum_corners_at(vec4  corners[8],
+                        float splitDist,
+                        float farDist,
+                        vec4  planeCorners[4]);
+#ifdef __cplusplus
+}
+#endif
+#endif /* cglmc_frustum_h */

include/cglm/call/mat3.h

@@ -13,9 +13,16 @@ extern "C" {
 
 #include "../cglm.h"
 
+/* DEPRECATED! use _copy, _ucopy versions */
+#define glmc_mat3_dup(mat, dest)  glmc_mat3_copy(mat, dest)
+
 CGLM_EXPORT
 void
-glmc_mat3_dup(mat3 mat, mat3 dest);
+glmc_mat3_copy(mat3 mat, mat3 dest);
+
+CGLM_EXPORT
+void
+glmc_mat3_identity(mat3 mat);
 
 CGLM_EXPORT
 void

include/cglm/call/mat4.h

@@ -13,13 +13,21 @@ extern "C" {
 
 #include "../cglm.h"
 
-CGLM_EXPORT
-void
-glmc_mat4_udup(mat4 mat, mat4 dest);
+/* DEPRECATED! use _copy, _ucopy versions */
+#define glmc_mat4_udup(mat, dest) glmc_mat4_ucopy(mat, dest)
+#define glmc_mat4_dup(mat, dest)  glmc_mat4_copy(mat, dest)
 
 CGLM_EXPORT
 void
-glmc_mat4_dup(mat4 mat, mat4 dest);
+glmc_mat4_ucopy(mat4 mat, mat4 dest);
+
+CGLM_EXPORT
+void
+glmc_mat4_copy(mat4 mat, mat4 dest);
+
+CGLM_EXPORT
+void
+glmc_mat4_identity(mat4 mat);
 
 CGLM_EXPORT
 void

include/cglm/call/plane.h

@@ -0,0 +1,23 @@
+/*
+ * Copyright (c), Recep Aslantas.
+ *
+ * MIT License (MIT), http://opensource.org/licenses/MIT
+ * Full license can be found in the LICENSE file
+ */
+
+#ifndef cglmc_plane_h
+#define cglmc_plane_h
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#include "../cglm.h"
+
+CGLM_EXPORT
+void
+glmc_plane_normalize(vec4 plane);
+
+#ifdef __cplusplus
+}
+#endif
+#endif /* cglmc_plane_h */

include/cglm/call/vec3.h

@@ -5,34 +5,25 @@
  * Full license can be found in the LICENSE file
  */
 
-#ifndef cglm_vec_h
-#define cglm_vec_h
+#ifndef cglmc_vec3_h
+#define cglmc_vec3_h
 #ifdef __cplusplus
 extern "C" {
 #endif
 
 #include "../cglm.h"
 
-CGLM_EXPORT
-void
-glmc_vec_dup(vec3 a, vec3 dest);
+/* DEPRECATED! use _copy, _ucopy versions */
+#define glmc_vec_dup(v, dest) glmc_vec_copy(v, dest)
 
 CGLM_EXPORT
 void
-glmc_vec4_dup3(vec4 a, vec3 dest);
-
-CGLM_EXPORT
-void
-glmc_vec4_dup(vec4 v, vec4 dest);
+glmc_vec_copy(vec3 a, vec3 dest);
 
 CGLM_EXPORT
 float
 glmc_vec_dot(vec3 a, vec3 b);
 
-CGLM_EXPORT
-float
-glmc_vec4_dot(vec4 a, vec4 b);
-
 CGLM_EXPORT
 void
 glmc_vec_cross(vec3 a, vec3 b, vec3 d);
@@ -41,69 +32,49 @@ CGLM_EXPORT
 float
 glmc_vec_norm(vec3 vec);
 
-CGLM_EXPORT
-float
-glmc_vec4_norm(vec4 vec);
-
 CGLM_EXPORT
 float
 glmc_vec_norm2(vec3 vec);
 
-CGLM_EXPORT
-float
-glmc_vec4_norm2(vec4 vec);
-
 CGLM_EXPORT
 void
 glmc_vec_normalize_to(vec3 vec, vec3 dest);
 
-CGLM_EXPORT
-void
-glmc_vec4_normalize_to(vec4 vec, vec4 dest);
-
 CGLM_EXPORT
 void
 glmc_vec_normalize(vec3 v);
 
-CGLM_EXPORT
-void
-glmc_vec4_normalize(vec4 v);
-
 CGLM_EXPORT
 void
 glmc_vec_add(vec3 v1, vec3 v2, vec3 dest);
 
-CGLM_EXPORT
-void
-glmc_vec4_add(vec4 v1, vec4 v2, vec4 dest);
-
 CGLM_EXPORT
 void
 glmc_vec_sub(vec3 v1, vec3 v2, vec3 dest);
 
-CGLM_EXPORT
-void
-glmc_vec4_sub(vec4 v1, vec4 v2, vec4 dest);
-
 CGLM_EXPORT
 void
 glmc_vec_scale(vec3 v, float s, vec3 dest);
 
+CGLM_EXPORT
+void
+glmc_vec_scale_as(vec3 v, float s, vec3 dest);
+
 CGLM_EXPORT
 void
 glmc_vec_flipsign(vec3 v);
 
 CGLM_EXPORT
 void
-glmc_vec4_flipsign(vec4 v);
+glmc_vec_inv(vec3 v);
 
 CGLM_EXPORT
 void
-glmc_vec4_scale(vec4 v, float s, vec4 dest);
-
+glmc_vec_inv_to(vec3 v, vec3 dest);
+  
 CGLM_EXPORT
 float
-glmc_vec_angle(vec3 v1, vec3 v2)
+glmc_vec_angle(vec3 v1, vec3 v2);
 
 CGLM_EXPORT
 void
@@ -117,7 +88,23 @@ CGLM_EXPORT
 void
 glmc_vec_proj(vec3 a, vec3 b, vec3 dest);
 
+CGLM_EXPORT
+void
+glmc_vec_center(vec3 v1, vec3 v2, vec3 dest);
+
+CGLM_EXPORT
+float
+glmc_vec_distance(vec3 v1, vec3 v2);
+
+CGLM_EXPORT
+void
+glmc_vec_maxv(vec3 v1, vec3 v2, vec3 dest);
+
+CGLM_EXPORT
+void
+glmc_vec_minv(vec3 v1, vec3 v2, vec3 dest);
+
 #ifdef __cplusplus
 }
 #endif
-#endif /* cglm_vec_h */
+#endif /* cglmc_vec3_h */

include/cglm/call/vec4.h

@@ -0,0 +1,92 @@
+/*
+ * Copyright (c), Recep Aslantas.
+ *
+ * MIT License (MIT), http://opensource.org/licenses/MIT
+ * Full license can be found in the LICENSE file
+ */
+
+#ifndef cglmc_vec4_h
+#define cglmc_vec4_h
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#include "../cglm.h"
+
+/* DEPRECATED! use _copy, _ucopy versions */
+#define glmc_vec4_dup3(v, dest) glmc_vec4_copy3(v, dest)
+#define glmc_vec4_dup(v, dest)  glmc_vec4_copy(v, dest)
+
+CGLM_EXPORT
+void
+glmc_vec4_copy3(vec4 a, vec3 dest);
+
+CGLM_EXPORT
+void
+glmc_vec4_copy(vec4 v, vec4 dest);
+
+CGLM_EXPORT
+float
+glmc_vec4_dot(vec4 a, vec4 b);
+
+CGLM_EXPORT
+float
+glmc_vec4_norm(vec4 vec);
+
+CGLM_EXPORT
+float
+glmc_vec4_norm2(vec4 vec);
+
+CGLM_EXPORT
+void
+glmc_vec4_normalize_to(vec4 vec, vec4 dest);
+
+CGLM_EXPORT
+void
+glmc_vec4_normalize(vec4 v);
+
+CGLM_EXPORT
+void
+glmc_vec4_add(vec4 v1, vec4 v2, vec4 dest);
+
+CGLM_EXPORT
+void
+glmc_vec4_sub(vec4 v1, vec4 v2, vec4 dest);
+
+CGLM_EXPORT
+void
+glmc_vec4_scale(vec4 v, float s, vec4 dest);
+
+CGLM_EXPORT
+void
+glmc_vec4_scale_as(vec3 v, float s, vec3 dest);
+
+CGLM_EXPORT
+void
+glmc_vec4_flipsign(vec4 v);
+
+CGLM_EXPORT
+void
+glmc_vec4_inv(vec4 v);
+
+CGLM_EXPORT
+void
+glmc_vec4_inv_to(vec4 v, vec4 dest);
+
+CGLM_EXPORT
+float
+glmc_vec4_distance(vec4 v1, vec4 v2);
+
+CGLM_EXPORT
+void
+glmc_vec4_maxv(vec4 v1, vec4 v2, vec4 dest);
+
+CGLM_EXPORT
+void
+glmc_vec4_minv(vec4 v1, vec4 v2, vec4 dest);
+
+#ifdef __cplusplus
+}
+#endif
+#endif /* cglmc_vec4_h */
+

include/cglm/cam.h

@@ -0,0 +1,596 @@
+/*
+ * Copyright (c), Recep Aslantas.
+ *
+ * MIT License (MIT), http://opensource.org/licenses/MIT
+ * Full license can be found in the LICENSE file
+ */
+
+/*
+ Functions:
+   CGLM_INLINE void  glm_frustum(float left,
+                                 float right,
+                                 float bottom,
+                                 float top,
+                                 float nearVal,
+                                 float farVal,
+                                 mat4  dest)
+   CGLM_INLINE void  glm_ortho(float left,
+                               float right,
+                               float bottom,
+                               float top,
+                               float nearVal,
+                               float farVal,
+                               mat4  dest)
+   CGLM_INLINE void  glm_ortho_aabb(vec3 box[2], mat4 dest)
+   CGLM_INLINE void  glm_ortho_aabb_p(vec3 box[2], float padding, mat4 dest)
+   CGLM_INLINE void  glm_ortho_aabb_pz(vec3 box[2], float padding, mat4 dest)
+   CGLM_INLINE void  glm_ortho_default(float aspect, mat4  dest)
+   CGLM_INLINE void  glm_ortho_default_s(float aspect, float size, mat4  dest)
+   CGLM_INLINE void  glm_perspective(float fovy,
+                                     float aspect,
+                                     float nearVal,
+                                     float farVal,
+                                     mat4  dest)
+   CGLM_INLINE void  glm_perspective_default(float aspect, mat4  dest)
+   CGLM_INLINE void  glm_perspective_resize(float aspect, mat4  proj)
+   CGLM_INLINE void  glm_lookat(vec3 eye, vec3 center, vec3 up, mat4 dest)
+   CGLM_INLINE void  glm_look(vec3 eye, vec3 dir, vec3 up, mat4 dest)
+   CGLM_INLINE void  glm_look_anyup(vec3 eye, vec3 dir, mat4 dest)
+   CGLM_INLINE void  glm_persp_decomp(mat4   proj,
+                                      float *nearVal,
+                                      float *farVal,
+                                      float *top,
+                                      float *bottom,
+                                      float *left,
+                                      float *right)
+   CGLM_INLINE void  glm_persp_decompv(mat4 proj, float dest[6])
+   CGLM_INLINE void  glm_persp_decomp_x(mat4 proj, float *left, float *right)
+   CGLM_INLINE void  glm_persp_decomp_y(mat4 proj, float *top,  float *bottom)
+   CGLM_INLINE void  glm_persp_decomp_z(mat4 proj,
+                                        float *nearVal,
+                                        float *farVal)
+   CGLM_INLINE void  glm_persp_decomp_far(mat4 proj, float *farVal)
+   CGLM_INLINE void  glm_persp_decomp_near(mat4 proj, float *nearVal)
+   CGLM_INLINE float glm_persp_fovy(mat4 proj)
+   CGLM_INLINE float glm_persp_aspect(mat4 proj)
+   CGLM_INLINE void  glm_persp_sizes(mat4 proj, float fovy, vec4 dest)
+ */
+
+#ifndef cglm_vcam_h
+#define cglm_vcam_h
+
+#include "common.h"
+#include "plane.h"
+
+/*!
+ * @brief set up perspective peprojection matrix
+ *
+ * @param[in]  left    viewport.left
+ * @param[in]  right   viewport.right
+ * @param[in]  bottom  viewport.bottom
+ * @param[in]  top     viewport.top
+ * @param[in]  nearVal near clipping plane
+ * @param[in]  farVal  far clipping plane
+ * @param[out] dest    result matrix
+ */
+CGLM_INLINE
+void
+glm_frustum(float left,
+            float right,
+            float bottom,
+            float top,
+            float nearVal,
+            float farVal,
+            mat4  dest) {
+  float rl, tb, fn, nv;
+
+  glm__memzero(float, dest, sizeof(mat4));
+
+  rl = 1.0f / (right  - left);
+  tb = 1.0f / (top    - bottom);
+  fn =-1.0f / (farVal - nearVal);
+  nv = 2.0f * nearVal;
+
+  dest[0][0] = nv * rl;
+  dest[1][1] = nv * tb;
+  dest[2][0] = (right  + left)    * rl;
+  dest[2][1] = (top    + bottom)  * tb;
+  dest[2][2] = (farVal + nearVal) * fn;
+  dest[2][3] =-1.0f;
+  dest[3][2] = farVal * nv * fn;
+}
+
+/*!
+ * @brief set up orthographic projection matrix
+ *
+ * @param[in]  left    viewport.left
+ * @param[in]  right   viewport.right
+ * @param[in]  bottom  viewport.bottom
+ * @param[in]  top     viewport.top
+ * @param[in]  nearVal near clipping plane
+ * @param[in]  farVal  far clipping plane
+ * @param[out] dest    result matrix
+ */
+CGLM_INLINE
+void
+glm_ortho(float left,
+          float right,
+          float bottom,
+          float top,
+          float nearVal,
+          float farVal,
+          mat4  dest) {
+  float rl, tb, fn;
+
+  glm__memzero(float, dest, sizeof(mat4));
+
+  rl = 1.0f / (right  - left);
+  tb = 1.0f / (top    - bottom);
+  fn =-1.0f / (farVal - nearVal);
+
+  dest[0][0] = 2.0f * rl;
+  dest[1][1] = 2.0f * tb;
+  dest[2][2] = 2.0f * fn;
+  dest[3][0] =-(right  + left)    * rl;
+  dest[3][1] =-(top    + bottom)  * tb;
+  dest[3][2] = (farVal + nearVal) * fn;
+  dest[3][3] = 1.0f;
+}
+
+/*!
+ * @brief set up orthographic projection matrix using bounding box
+ *
+ * bounding box (AABB) must be in view space
+ *
+ * @param[in]  box   AABB
+ * @param[out] dest  result matrix
+ */
+CGLM_INLINE
+void
+glm_ortho_aabb(vec3 box[2], mat4 dest) {
+  glm_ortho(box[0][0],  box[1][0],
+            box[0][1],  box[1][1],
+           -box[1][2], -box[0][2],
+            dest);
+}
+
+/*!
+ * @brief set up orthographic projection matrix using bounding box
+ *
+ * bounding box (AABB) must be in view space
+ *
+ * @param[in]  box     AABB
+ * @param[in]  padding padding
+ * @param[out] dest    result matrix
+ */
+CGLM_INLINE
+void
+glm_ortho_aabb_p(vec3 box[2], float padding, mat4 dest) {
+  glm_ortho(box[0][0] - padding,    box[1][0] + padding,
+            box[0][1] - padding,    box[1][1] + padding,
+          -(box[1][2] + padding), -(box[0][2] - padding),
+            dest);
+}
+
+/*!
+ * @brief set up orthographic projection matrix using bounding box
+ *
+ * bounding box (AABB) must be in view space
+ *
+ * @param[in]  box     AABB
+ * @param[in]  padding padding for near and far
+ * @param[out] dest    result matrix
+ */
+CGLM_INLINE
+void
+glm_ortho_aabb_pz(vec3 box[2], float padding, mat4 dest) {
+  glm_ortho(box[0][0],              box[1][0],
+            box[0][1],              box[1][1],
+          -(box[1][2] + padding), -(box[0][2] - padding),
+            dest);
+}
+
+/*!
+ * @brief set up unit orthographic projection matrix
+ *
+ * @param[in]  aspect aspect ration ( width / height )
+ * @param[out] dest   result matrix
+ */
+CGLM_INLINE
+void
+glm_ortho_default(float aspect,
+                  mat4  dest) {
+  if (aspect >= 1.0f) {
+    glm_ortho(-1.0f * aspect,
+               1.0f * aspect,
+              -1.0f,
+               1.0f,
+              -100.0f,
+               100.0f,
+               dest);
+	  return;
+  }
+
+  glm_ortho(-1.0f,
+             1.0f,
+            -1.0f / aspect,
+             1.0f / aspect,
+            -100.0f,
+             100.0f,
+             dest);
+}
+
+/*!
+ * @brief set up orthographic projection matrix with given CUBE size
+ *
+ * @param[in]  aspect aspect ratio ( width / height )
+ * @param[in]  size   cube size
+ * @param[out] dest   result matrix
+ */
+CGLM_INLINE
+void
+glm_ortho_default_s(float aspect,
+                    float size,
+                    mat4  dest) {
+  if (aspect >= 1.0f) {
+    glm_ortho(-size * aspect,
+               size * aspect,
+              -size,
+               size,
+              -size - 100.0f,
+               size + 100.0f,
+               dest);
+	  return;
+  }
+
+  glm_ortho(-size,
+             size,
+            -size / aspect,
+             size / aspect,
+            -size - 100.0f,
+             size + 100.0f,
+             dest);
+}
+
+/*!
+ * @brief set up perspective projection matrix
+ *
+ * @param[in]  fovy    field of view angle
+ * @param[in]  aspect  aspect ratio ( width / height )
+ * @param[in]  nearVal near clipping plane
+ * @param[in]  farVal  far clipping planes
+ * @param[out] dest    result matrix
+ */
+CGLM_INLINE
+void
+glm_perspective(float fovy,
+                float aspect,
+                float nearVal,
+                float farVal,
+                mat4  dest) {
+  float f, fn;
+
+  glm__memzero(float, dest, sizeof(mat4));
+
+  f  = 1.0f / tanf(fovy * 0.5f);
+  fn = 1.0f / (nearVal - farVal);
+
+  dest[0][0] = f / aspect;
+  dest[1][1] = f;
+  dest[2][2] = (nearVal + farVal) * fn;
+  dest[2][3] =-1.0f;
+  dest[3][2] = 2.0f * nearVal * farVal * fn;
+}
+
+/*!
+ * @brief set up perspective projection matrix with default near/far
+ *        and angle values
+ *
+ * @param[in]  aspect aspect ratio ( width / height )
+ * @param[out] dest   result matrix
+ */
+CGLM_INLINE
+void
+glm_perspective_default(float aspect,
+                        mat4  dest) {
+  glm_perspective((float)CGLM_PI_4,
+                  aspect,
+                  0.01f,
+                  100.0f,
+                  dest);
+}
+
+/*!
+ * @brief resize perspective matrix by aspect ratio ( width / height )
+ *        this makes very easy to resize proj matrix when window /viewport
+ *        reized
+ *
+ * @param[in]      aspect aspect ratio ( width / height )
+ * @param[in, out] proj   perspective projection matrix
+ */
+CGLM_INLINE
+void
+glm_perspective_resize(float aspect,
+                       mat4  proj) {
+  if (proj[0][0] == 0.0f)
+    return;
+
+  proj[0][0] = proj[1][1] / aspect;
+}
+
+/*!
+ * @brief set up view matrix
+ *
+ * @param[in]  eye    eye vector
+ * @param[in]  center center vector
+ * @param[in]  up     up vector
+ * @param[out] dest   result matrix
+ */
+CGLM_INLINE
+void
+glm_lookat(vec3 eye,
+           vec3 center,
+           vec3 up,
+           mat4 dest) {
+  vec3 f, u, s;
+
+  glm_vec_sub(center, eye, f);
+  glm_vec_normalize(f);
+
+  glm_vec_cross(f, up, s);
+  glm_vec_normalize(s);
+
+  glm_vec_cross(s, f, u);
+
+  dest[0][0] = s[0];
+  dest[0][1] = u[0];
+  dest[0][2] =-f[0];
+  dest[1][0] = s[1];
+  dest[1][1] = u[1];
+  dest[1][2] =-f[1];
+  dest[2][0] = s[2];
+  dest[2][1] = u[2];
+  dest[2][2] =-f[2];
+  dest[3][0] =-glm_vec_dot(s, eye);
+  dest[3][1] =-glm_vec_dot(u, eye);
+  dest[3][2] = glm_vec_dot(f, eye);
+  dest[0][3] = dest[1][3] = dest[2][3] = 0.0f;
+  dest[3][3] = 1.0f;
+}
+
+/*!
+ * @brief set up view matrix
+ *
+ * convenient wrapper for lookat: if you only have direction not target self
+ * then this might be useful. Because you need to get target from direction.
+ *
+ * @param[in]  eye    eye vector
+ * @param[in]  dir    direction vector
+ * @param[in]  up     up vector
+ * @param[out] dest   result matrix
+ */
+CGLM_INLINE
+void
+glm_look(vec3 eye, vec3 dir, vec3 up, mat4 dest) {
+  vec3 target;
+  glm_vec_add(eye, dir, target);
+  glm_lookat(eye, target, up, dest);
+}
+
+/*!
+ * @brief set up view matrix
+ *
+ * convenient wrapper for look: if you only have direction and if you don't
+ * care what UP vector is then this might be useful to create view matrix
+ *
+ * @param[in]  eye    eye vector
+ * @param[in]  dir    direction vector
+ * @param[out] dest   result matrix
+ */
+CGLM_INLINE
+void
+glm_look_anyup(vec3 eye, vec3 dir, mat4 dest) {
+  vec3 up;
+  glm_vec_ortho(dir, up);
+  glm_look(eye, dir, up, dest);
+}
+
+/*!
+ * @brief decomposes frustum values of perspective projection.
+ *
+ * @param[in]  proj    perspective projection matrix
+ * @param[out] nearVal near
+ * @param[out] farVal  far
+ * @param[out] top     top
+ * @param[out] bottom  bottom
+ * @param[out] left    left
+ * @param[out] right   right
+ */
+CGLM_INLINE
+void
+glm_persp_decomp(mat4 proj,
+                 float * __restrict nearVal,
+                 float * __restrict farVal,
+                 float * __restrict top,
+                 float * __restrict bottom,
+                 float * __restrict left,
+                 float * __restrict right) {
+  float m00, m11, m20, m21, m22, m32, n, f;
+  float n_m11, n_m00;
+
+  m00 = proj[0][0];
+  m11 = proj[1][1];
+  m20 = proj[2][0];
+  m21 = proj[2][1];
+  m22 = proj[2][2];
+  m32 = proj[3][2];
+
+  n = m32 / (m22 - 1.0f);
+  f = m32 / (m22 + 1.0f);
+
+  n_m11 = n / m11;
+  n_m00 = n / m00;
+
+  *nearVal = n;
+  *farVal  = f;
+  *bottom  = n_m11 * (m21 - 1.0f);
+  *top     = n_m11 * (m21 + 1.0f);
+  *left    = n_m00 * (m20 - 1.0f);
+  *right   = n_m00 * (m20 + 1.0f);
+}
+
+/*!
+ * @brief decomposes frustum values of perspective projection.
+ *        this makes easy to get all values at once
+ *
+ * @param[in]  proj   perspective projection matrix
+ * @param[out] dest   array
+ */
+CGLM_INLINE
+void
+glm_persp_decompv(mat4 proj, float dest[6]) {
+  glm_persp_decomp(proj, &dest[0], &dest[1], &dest[2],
+                         &dest[3], &dest[4], &dest[5]);
+}
+
+/*!
+ * @brief decomposes left and right values of perspective projection.
+ *        x stands for x axis (left / right axis)
+ *
+ * @param[in]  proj  perspective projection matrix
+ * @param[out] left  left
+ * @param[out] right right
+ */
+CGLM_INLINE
+void
+glm_persp_decomp_x(mat4 proj,
+                   float * __restrict left,
+                   float * __restrict right) {
+  float nearVal, m20, m00;
+
+  m00 = proj[0][0];
+  m20 = proj[2][0];
+
+  nearVal = proj[3][2] / (proj[3][3] - 1.0f);
+  *left   = nearVal * (m20 - 1.0f) / m00;
+  *right  = nearVal * (m20 + 1.0f) / m00;
+}
+
+/*!
+ * @brief decomposes top and bottom values of perspective projection.
+ *        y stands for y axis (top / botom axis)
+ *
+ * @param[in]  proj   perspective projection matrix
+ * @param[out] top    top
+ * @param[out] bottom bottom
+ */
+CGLM_INLINE
+void
+glm_persp_decomp_y(mat4 proj,
+                   float * __restrict top,
+                   float * __restrict bottom) {
+  float nearVal, m21, m11;
+
+  m21 = proj[2][1];
+  m11 = proj[1][1];
+
+  nearVal = proj[3][2] / (proj[3][3] - 1.0f);
+  *bottom = nearVal * (m21 - 1) / m11;
+  *top    = nearVal * (m21 + 1) / m11;
+}
+
+/*!
+ * @brief decomposes near and far values of perspective projection.
+ *        z stands for z axis (near / far axis)
+ *
+ * @param[in]  proj    perspective projection matrix
+ * @param[out] nearVal near
+ * @param[out] farVal  far
+ */
+CGLM_INLINE
+void
+glm_persp_decomp_z(mat4 proj,
+                   float * __restrict nearVal,
+                   float * __restrict farVal) {
+  float m32, m22;
+
+  m32 = proj[3][2];
+  m22 = proj[2][2];
+
+  *nearVal = m32 / (m22 - 1.0f);
+  *farVal  = m32 / (m22 + 1.0f);
+}
+
+/*!
+ * @brief decomposes far value of perspective projection.
+ *
+ * @param[in]  proj   perspective projection matrix
+ * @param[out] farVal far
+ */
+CGLM_INLINE
+void
+glm_persp_decomp_far(mat4 proj, float * __restrict farVal) {
+  *farVal = proj[3][2] / (proj[2][2] + 1.0f);
+}
+
+/*!
+ * @brief decomposes near value of perspective projection.
+ *
+ * @param[in]  proj    perspective projection matrix
+ * @param[out] nearVal near
+ */
+CGLM_INLINE
+void
+glm_persp_decomp_near(mat4 proj, float * __restrict nearVal) {
+  *nearVal = proj[3][2] / (proj[2][2] - 1.0f);
+}
+
+/*!
+ * @brief returns field of view angle along the Y-axis (in radians)
+ *
+ * if you need to degrees, use glm_deg to convert it or use this:
+ * fovy_deg = glm_deg(glm_persp_fovy(projMatrix))
+ *
+ * @param[in] proj perspective projection matrix
+ */
+CGLM_INLINE
+float
+glm_persp_fovy(mat4 proj) {
+  return 2.0f * atanf(1.0f / proj[1][1]);
+}
+
+/*!
+ * @brief returns aspect ratio of perspective projection
+ *
+ * @param[in] proj perspective projection matrix
+ */
+CGLM_INLINE
+float
+glm_persp_aspect(mat4 proj) {
+  return proj[1][1] / proj[0][0];
+}
+
+/*!
+ * @brief returns sizes of near and far planes of perspective projection
+ *
+ * @param[in]  proj perspective projection matrix
+ * @param[in]  fovy fovy (see brief)
+ * @param[out] dest sizes order: [Wnear, Hnear, Wfar, Hfar]
+ */
+CGLM_INLINE
+void
+glm_persp_sizes(mat4 proj, float fovy, vec4 dest) {
+  float t, a, nearVal, farVal;
+
+  t = 2.0f * tanf(fovy * 0.5f);
+  a = glm_persp_aspect(proj);
+
+  glm_persp_decomp_z(proj, &nearVal, &farVal);
+
+  dest[1]  = t * nearVal;
+  dest[3]  = t * farVal;
+  dest[0]  = a * dest[1];
+  dest[2]  = a * dest[3];
+}
+
+#endif /* cglm_vcam_h */

include/cglm/cglm.h

@@ -0,0 +1,27 @@
+/*
+ * Copyright (c), Recep Aslantas.
+ *
+ * MIT License (MIT), http://opensource.org/licenses/MIT
+ * Full license can be found in the LICENSE file
+ */
+
+#ifndef cglm_h
+#define cglm_h
+
+#include "common.h"
+#include "vec3.h"
+#include "vec4.h"
+#include "mat4.h"
+#include "mat3.h"
+#include "affine.h"
+#include "cam.h"
+#include "frustum.h"
+#include "quat.h"
+#include "euler.h"
+#include "plane.h"
+#include "box.h"
+#include "color.h"
+#include "util.h"
+#include "io.h"
+
+#endif /* cglm_h */

include/cglm/color.h

@@ -0,0 +1,26 @@
+/*
+ * Copyright (c), Recep Aslantas.
+ *
+ * MIT License (MIT), http://opensource.org/licenses/MIT
+ * Full license can be found in the LICENSE file
+ */
+
+#ifndef cglm_color_h
+#define cglm_color_h
+
+#include "common.h"
+#include "vec3.h"
+
+/*!
+ * @brief averages the color channels into one value
+ *
+ * @param[in]  rgb RGB color
+ */
+CGLM_INLINE
+float
+glm_luminance(vec3 rgb) {
+  vec3 l = {0.212671f, 0.715160f, 0.072169f};
+  return glm_dot(rgb, l);
+}
+
+#endif /* cglm_color_h */

include/cglm/common.h

@@ -12,6 +12,7 @@
 
 #include <stdint.h>
 #include <math.h>
+#include <float.h>
 
 #if defined(_WIN32)
 #  ifdef CGLM_DLL
@@ -53,6 +54,7 @@
 
 #define glm__memzero(type, dest, size) glm__memset(type, dest, size, 0)
 
-#include "cglm-types.h"
+#include "types.h"
+#include "simd/intrin.h"
 
 #endif /* cglm_common_h */

include/cglm/euler.h

@@ -5,10 +5,28 @@
  * Full license can be found in the LICENSE file
  */
 
+/*
+ Types:
+   enum glm_euler_sq
+
+ Functions:
+   CGLM_INLINE glm_euler_sq glm_euler_order(int newOrder[3]);
+   CGLM_INLINE void glm_euler_angles(mat4 m, vec3 dest);
+   CGLM_INLINE void glm_euler(vec3 angles, mat4 dest);
+   CGLM_INLINE void glm_euler_zyx(vec3 angles, mat4 dest);
+   CGLM_INLINE void glm_euler_zxy(vec3 angles, mat4 dest);
+   CGLM_INLINE void glm_euler_xzy(vec3 angles, mat4 dest);
+   CGLM_INLINE void glm_euler_yzx(vec3 angles, mat4 dest);
+   CGLM_INLINE void glm_euler_yxz(vec3 angles, mat4 dest);
+   CGLM_INLINE void glm_euler_by_order(vec3         angles,
+                                       glm_euler_sq ord,
+                                       mat4         dest);
+ */
+
 #ifndef cglm_euler_h
 #define cglm_euler_h
 
-#include "cglm-common.h"
+#include "common.h"
 
 /*!
  * if you have axis order like vec3 orderVec = [0, 1, 2] or [0, 2, 1]...
@@ -30,15 +48,15 @@ typedef enum glm_euler_sq {
 
 CGLM_INLINE
 glm_euler_sq
-glm_euler_order(int newOrder[3]) {
-  return (glm_euler_sq)(newOrder[0] | newOrder[1] << 2 | newOrder[2] << 4);
+glm_euler_order(int ord[3]) {
+  return (glm_euler_sq)(ord[0] << 0 | ord[1] << 2 | ord[2] << 4);
 }
 
 /*!
- * @brief euler angles (in radian) using xyz sequence
+ * @brief extract euler angles (in radians) using xyz order
  *
- * @param[in]  m affine transform
- * @param[out] v angles vector [x, y, z]
+ * @param[in]  m    affine transform
+ * @param[out] dest angles vector [x, y, z]
  */
 CGLM_INLINE
 void
@@ -48,7 +66,7 @@ glm_euler_angles(mat4 m, vec3 dest) {
       vec3  a[2];
       float cy1, cy2;
       int   path;
-      
+
       a[0][1] = asinf(-m[0][2]);
       a[1][1] = CGLM_PI - a[0][1];
 
@@ -64,7 +82,7 @@ glm_euler_angles(mat4 m, vec3 dest) {
       path = (fabsf(a[0][0]) + fabsf(a[0][1]) + fabsf(a[0][2])) >=
                (fabsf(a[1][0]) + fabsf(a[1][1]) + fabsf(a[1][2]));
 
-      glm_vec_dup(a[path], dest);
+      glm_vec_copy(a[path], dest);
     } else {
       dest[0] = atan2f(m[1][0], m[2][0]);
       dest[1] = CGLM_PI_2;
@@ -78,7 +96,7 @@ glm_euler_angles(mat4 m, vec3 dest) {
 }
 
 /*!
- * @brief build rotation matrix from euler angles(ExEyEz/RzRyRx)
+ * @brief build rotation matrix from euler angles
  *
  * @param[in]  angles angles as vector [Ex, Ey, Ez]
  * @param[out] dest   rotation matrix
@@ -112,7 +130,10 @@ glm_euler(vec3 angles, mat4 dest) {
 }
 
 /*!
- * @brief build rotation matrix from euler angles (EzEyEx/RxRyRz)
+ * @brief build rotation matrix from euler angles
+ *
+ * @param[in]  angles angles as vector [Ez, Ey, Ex]
+ * @param[out] dest   rotation matrix
  */
 CGLM_INLINE
 void
@@ -143,6 +164,12 @@ glm_euler_zyx(vec3 angles,
   dest[3][3] = 1.0f;
 }
 
+/*!
+ * @brief build rotation matrix from euler angles
+ *
+ * @param[in]  angles angles as vector [Ez, Ex, Ey]
+ * @param[out] dest   rotation matrix
+ */
 CGLM_INLINE
 void
 glm_euler_zxy(vec3 angles,
@@ -172,6 +199,12 @@ glm_euler_zxy(vec3 angles,
   dest[3][3] = 1.0f;
 }
 
+/*!
+ * @brief build rotation matrix from euler angles
+ *
+ * @param[in]  angles angles as vector [Ex, Ez, Ey]
+ * @param[out] dest   rotation matrix
+ */
 CGLM_INLINE
 void
 glm_euler_xzy(vec3 angles,
@@ -201,6 +234,12 @@ glm_euler_xzy(vec3 angles,
   dest[3][3] = 1.0f;
 }
 
+/*!
+ * @brief build rotation matrix from euler angles
+ *
+ * @param[in]  angles angles as vector [Ey, Ez, Ex]
+ * @param[out] dest   rotation matrix
+ */
 CGLM_INLINE
 void
 glm_euler_yzx(vec3 angles,
@@ -230,6 +269,12 @@ glm_euler_yzx(vec3 angles,
   dest[3][3] = 1.0f;
 }
 
+/*!
+ * @brief build rotation matrix from euler angles
+ *
+ * @param[in]  angles angles as vector [Ey, Ex, Ez]
+ * @param[out] dest   rotation matrix
+ */
 CGLM_INLINE
 void
 glm_euler_yxz(vec3 angles,
@@ -259,9 +304,16 @@ glm_euler_yxz(vec3 angles,
   dest[3][3] = 1.0f;
 }
 
+/*!
+ * @brief build rotation matrix from euler angles
+ *
+ * @param[in]  angles angles as vector (ord parameter spceifies angles order)
+ * @param[in]  ord    euler order
+ * @param[out] dest   rotation matrix
+ */
 CGLM_INLINE
 void
-glm_euler_by_order(vec3 angles, glm_euler_sq axis, mat4 dest) {
+glm_euler_by_order(vec3 angles, glm_euler_sq ord, mat4 dest) {
   float cx, cy, cz,
         sx, sy, sz;
 
@@ -279,7 +331,7 @@ glm_euler_by_order(vec3 angles, glm_euler_sq axis, mat4 dest) {
   czsx = cz * sx; cxsz = cx * sz;
   sysz = sy * sz;
 
-  switch (axis) {
+  switch (ord) {
     case GLM_EULER_XYZ:
       dest[0][0] = cycz;
       dest[0][1] = cysz;

include/cglm/frustum.h

@@ -0,0 +1,252 @@
+/*
+ * Copyright (c), Recep Aslantas.
+ *
+ * MIT License (MIT), http://opensource.org/licenses/MIT
+ * Full license can be found in the LICENSE file
+ */
+
+#ifndef cglm_frustum_h
+#define cglm_frustum_h
+
+#include "common.h"
+#include "plane.h"
+
+#define GLM_LBN 0 /* left  bottom near */
+#define GLM_LTN 1 /* left  top    near */
+#define GLM_RTN 2 /* right top    near */
+#define GLM_RBN 3 /* right bottom near */
+
+#define GLM_LBF 4 /* left  bottom far  */
+#define GLM_LTF 5 /* left  top    far  */
+#define GLM_RTF 6 /* right top    far  */
+#define GLM_RBF 7 /* right bottom far  */
+
+#define GLM_LEFT   0
+#define GLM_RIGHT  1
+#define GLM_BOTTOM 2
+#define GLM_TOP    3
+#define GLM_NEAR   4
+#define GLM_FAR    5
+
+/* you can override clip space coords
+   but you have to provide all with same name
+   e.g.: define GLM_CSCOORD_LBN {0.0f, 0.0f, 1.0f, 1.0f} */
+#ifndef GLM_CUSTOM_CLIPSPACE
+
+/* near */
+#define GLM_CSCOORD_LBN {-1.0f, -1.0f, -1.0f, 1.0f}
+#define GLM_CSCOORD_LTN {-1.0f,  1.0f, -1.0f, 1.0f}
+#define GLM_CSCOORD_RTN { 1.0f,  1.0f, -1.0f, 1.0f}
+#define GLM_CSCOORD_RBN { 1.0f, -1.0f, -1.0f, 1.0f}
+
+/* far */
+#define GLM_CSCOORD_LBF {-1.0f, -1.0f,  1.0f, 1.0f}
+#define GLM_CSCOORD_LTF {-1.0f,  1.0f,  1.0f, 1.0f}
+#define GLM_CSCOORD_RTF { 1.0f,  1.0f,  1.0f, 1.0f}
+#define GLM_CSCOORD_RBF { 1.0f, -1.0f,  1.0f, 1.0f}
+
+#endif
+
+/*!
+ * @brief extracts view frustum planes
+ *
+ * planes' space:
+ *  1- if m = proj:     View Space
+ *  2- if m = viewProj: World Space
+ *  3- if m = MVP:      Object Space
+ *
+ * You probably want to extract planes in world space so use viewProj as m
+ * Computing viewProj:
+ *   glm_mat4_mul(proj, view, viewProj);
+ *
+ * Exracted planes order: [left, right, bottom, top, near, far]
+ *
+ * @param[in]  m    matrix (see brief)
+ * @param[out] dest exracted view frustum planes (see brief)
+ */
+CGLM_INLINE
+void
+glm_frustum_planes(mat4 m, vec4 dest[6]) {
+  mat4 t;
+
+  glm_mat4_transpose_to(m, t);
+
+  glm_vec4_add(t[3], t[0], dest[0]); /* left   */
+  glm_vec4_sub(t[3], t[0], dest[1]); /* right  */
+  glm_vec4_add(t[3], t[1], dest[2]); /* bottom */
+  glm_vec4_sub(t[3], t[1], dest[3]); /* top    */
+  glm_vec4_add(t[3], t[2], dest[4]); /* near   */
+  glm_vec4_sub(t[3], t[2], dest[5]); /* far    */
+
+  glm_plane_normalize(dest[0]);
+  glm_plane_normalize(dest[1]);
+  glm_plane_normalize(dest[2]);
+  glm_plane_normalize(dest[3]);
+  glm_plane_normalize(dest[4]);
+  glm_plane_normalize(dest[5]);
+}
+
+/*!
+ * @brief extracts view frustum corners using clip-space coordinates
+ *
+ * corners' space:
+ *  1- if m = invViewProj: World Space
+ *  2- if m = invMVP:      Object Space
+ *
+ * You probably want to extract corners in world space so use invViewProj
+ * Computing invViewProj:
+ *   glm_mat4_mul(proj, view, viewProj);
+ *   ...
+ *   glm_mat4_inv(viewProj, invViewProj);
+ *
+ * if you have a near coord at i index, you can get it's far coord by i + 4
+ *
+ * Find center coordinates:
+ *   for (j = 0; j < 4; j++) {
+ *     glm_vec_center(corners[i], corners[i + 4], centerCorners[i]);
+ *   }
+ *
+ * @param[in]  invMat matrix (see brief)
+ * @param[out] dest   exracted view frustum corners (see brief)
+ */
+CGLM_INLINE
+void
+glm_frustum_corners(mat4 invMat, vec4 dest[8]) {
+  vec4 c[8];
+
+  /* indexOf(nearCoord) = indexOf(farCoord) + 4 */
+  vec4 csCoords[8] = {
+    GLM_CSCOORD_LBN,
+    GLM_CSCOORD_LTN,
+    GLM_CSCOORD_RTN,
+    GLM_CSCOORD_RBN,
+
+    GLM_CSCOORD_LBF,
+    GLM_CSCOORD_LTF,
+    GLM_CSCOORD_RTF,
+    GLM_CSCOORD_RBF
+  };
+
+  glm_mat4_mulv(invMat, csCoords[0], c[0]);
+  glm_mat4_mulv(invMat, csCoords[1], c[1]);
+  glm_mat4_mulv(invMat, csCoords[2], c[2]);
+  glm_mat4_mulv(invMat, csCoords[3], c[3]);
+  glm_mat4_mulv(invMat, csCoords[4], c[4]);
+  glm_mat4_mulv(invMat, csCoords[5], c[5]);
+  glm_mat4_mulv(invMat, csCoords[6], c[6]);
+  glm_mat4_mulv(invMat, csCoords[7], c[7]);
+
+  glm_vec4_scale(c[0], 1.0f / c[0][3], dest[0]);
+  glm_vec4_scale(c[1], 1.0f / c[1][3], dest[1]);
+  glm_vec4_scale(c[2], 1.0f / c[2][3], dest[2]);
+  glm_vec4_scale(c[3], 1.0f / c[3][3], dest[3]);
+  glm_vec4_scale(c[4], 1.0f / c[4][3], dest[4]);
+  glm_vec4_scale(c[5], 1.0f / c[5][3], dest[5]);
+  glm_vec4_scale(c[6], 1.0f / c[6][3], dest[6]);
+  glm_vec4_scale(c[7], 1.0f / c[7][3], dest[7]);
+}
+
+/*!
+ * @brief finds center of view frustum
+ *
+ * @param[in]  corners view frustum corners
+ * @param[out] dest    view frustum center
+ */
+CGLM_INLINE
+void
+glm_frustum_center(vec4 corners[8], vec4 dest) {
+  vec4 center;
+
+  glm_vec4_copy(corners[0], center);
+
+  glm_vec4_add(corners[1], center, center);
+  glm_vec4_add(corners[2], center, center);
+  glm_vec4_add(corners[3], center, center);
+  glm_vec4_add(corners[4], center, center);
+  glm_vec4_add(corners[5], center, center);
+  glm_vec4_add(corners[6], center, center);
+  glm_vec4_add(corners[7], center, center);
+
+  glm_vec4_scale(center, 0.125f, dest);
+}
+
+/*!
+ * @brief finds bounding box of frustum relative to given matrix e.g. view mat
+ *
+ * @param[in]  corners view frustum corners
+ * @param[in]  m       matrix to convert existing conners
+ * @param[out] box     bounding box as array [min, max]
+ */
+CGLM_INLINE
+void
+glm_frustum_box(vec4 corners[8], mat4 m, vec3 box[2]) {
+  vec4 v;
+  vec3 min, max;
+  int  i;
+
+  glm_vec_broadcast(FLT_MAX, min);
+  glm_vec_broadcast(-FLT_MAX, max);
+
+  for (i = 0; i < 8; i++) {
+    glm_mat4_mulv(m, corners[i], v);
+
+    min[0] = glm_min(min[0], v[0]);
+    min[1] = glm_min(min[1], v[1]);
+    min[2] = glm_min(min[2], v[2]);
+
+    max[0] = glm_max(max[0], v[0]);
+    max[1] = glm_max(max[1], v[1]);
+    max[2] = glm_max(max[2], v[2]);
+  }
+
+  glm_vec_copy(min, box[0]);
+  glm_vec_copy(max, box[1]);
+}
+
+/*!
+ * @brief finds planes corners which is between near and far planes (parallel)
+ *
+ * this will be helpful if you want to split a frustum e.g. CSM/PSSM. This will
+ * find planes' corners but you will need to one more plane.
+ * Actually you have it, it is near, far or created previously with this func ;)
+ *
+ * @param[in]  corners view  frustum corners
+ * @param[in]  splitDist     split distance
+ * @param[in]  farDist       far distance (zFar)
+ * @param[out] planeCorners  plane corners [LB, LT, RT, RB]
+ */
+CGLM_INLINE
+void
+glm_frustum_corners_at(vec4  corners[8],
+                       float splitDist,
+                       float farDist,
+                       vec4  planeCorners[4]) {
+  vec4  corner;
+  float dist, sc;
+
+  /* because distance and scale is same for all */
+  dist = glm_vec_distance(corners[GLM_RTF], corners[GLM_RTN]);
+  sc   = dist * (splitDist / farDist);
+
+  /* left bottom */
+  glm_vec4_sub(corners[GLM_LBF], corners[GLM_LBN], corner);
+  glm_vec4_scale_as(corner, sc, corner);
+  glm_vec4_add(corners[GLM_LBN], corner, planeCorners[0]);
+
+  /* left top */
+  glm_vec4_sub(corners[GLM_LTF], corners[GLM_LTN], corner);
+  glm_vec4_scale_as(corner, sc, corner);
+  glm_vec4_add(corners[GLM_LTN], corner, planeCorners[1]);
+
+  /* right top */
+  glm_vec4_sub(corners[GLM_RTF], corners[GLM_RTN], corner);
+  glm_vec4_scale_as(corner, sc, corner);
+  glm_vec4_add(corners[GLM_RTN], corner, planeCorners[2]);
+
+  /* right bottom */
+  glm_vec4_sub(corners[GLM_RBF], corners[GLM_RBN], corner);
+  glm_vec4_scale_as(corner, sc, corner);
+  glm_vec4_add(corners[GLM_RBN], corner, planeCorners[3]);
+}
+
+#endif /* cglm_frustum_h */

include/cglm/io.h

@@ -5,10 +5,20 @@
  * Full license can be found in the LICENSE file
  */
 
+/*
+ Functions:
+   CGLM_INLINE void glm_mat4_print(mat4 matrix, FILE *ostream);
+   CGLM_INLINE void glm_mat3_print(mat3 matrix, FILE *ostream);
+   CGLM_INLINE void glm_vec4_print(vec4 vec, FILE *ostream);
+   CGLM_INLINE void glm_vec3_print(vec3 vec, FILE *ostream);
+   CGLM_INLINE void glm_ivec3_print(ivec3 vec, FILE *ostream);
+   CGLM_INLINE void glm_versor_print(versor vec, FILE *ostream);
+ */
+
 #ifndef cglm_io_h
 #define cglm_io_h
 
-#include "cglm-common.h"
+#include "common.h"
 
 #include <stdio.h>
 #include <stdlib.h>

include/cglm/mat3.h

@@ -5,18 +5,51 @@
  * Full license can be found in the LICENSE file
  */
 
+/*
+ Macros:
+   GLM_MAT3_IDENTITY_INIT
+   GLM_MAT3_ZERO_INIT
+   GLM_MAT3_IDENTITY
+   GLM_MAT3_ZERO
+   glm_mat3_dup(mat, dest)
+
+ Functions:
+   CGLM_INLINE void  glm_mat3_copy(mat3 mat, mat3 dest);
+   CGLM_INLINE void  glm_mat3_identity(mat3 mat);
+   CGLM_INLINE void  glm_mat3_mul(mat3 m1, mat3 m2, mat3 dest);
+   CGLM_INLINE void  glm_mat3_transpose_to(mat3 m, mat3 dest);
+   CGLM_INLINE void  glm_mat3_transpose(mat3 m);
+   CGLM_INLINE void  glm_mat3_mulv(mat3 m, vec3 v, vec3 dest);
+   CGLM_INLINE void  glm_mat3_scale(mat3 m, float s);
+   CGLM_INLINE float glm_mat3_det(mat3 mat);
+   CGLM_INLINE void  glm_mat3_inv(mat3 mat, mat3 dest);
+   CGLM_INLINE void  glm_mat3_swap_col(mat3 mat, int col1, int col2);
+   CGLM_INLINE void  glm_mat3_swap_row(mat3 mat, int row1, int row2);
+ */
+
 #ifndef cglm_mat3_h
 #define cglm_mat3_h
 
-#include "cglm-common.h"
-#include "arch/simd/cglm-mat3-simd-sse2.h"
+#include "common.h"
+
+#ifdef CGLM_SSE_FP
+#  include "simd/sse2/mat3.h"
+#endif
 
 #define GLM_MAT3_IDENTITY_INIT  {{1.0f, 0.0f, 0.0f},                          \
                                  {0.0f, 1.0f, 0.0f},                          \
                                  {0.0f, 0.0f, 1.0f}}
+#define GLM_MAT3_ZERO_INIT      {{0.0f, 0.0f, 0.0f},                          \
+                                 {0.0f, 0.0f, 0.0f},                          \
+                                 {0.0f, 0.0f, 0.0f}}
+
 
 /* for C only */
-#define GLM_MAT3_IDENTITY (mat3)GLM_MAT3_IDENTITY_INIT
+#define GLM_MAT3_IDENTITY ((mat3)GLM_MAT3_IDENTITY_INIT)
+#define GLM_MAT3_ZERO     ((mat3)GLM_MAT3_ZERO_INIT)
+
+/* DEPRECATED! use _copy, _ucopy versions */
+#define glm_mat3_dup(mat, dest) glm_mat3_copy(mat, dest)
 
 /*!
  * @brief copy all members of [mat] to [dest]
@@ -26,10 +59,31 @@
  */
 CGLM_INLINE
 void
-glm_mat3_dup(mat3 mat, mat3 dest) {
+glm_mat3_copy(mat3 mat, mat3 dest) {
   glm__memcpy(float, dest, mat, sizeof(mat3));
 }
 
+/*!
+ * @brief make given matrix identity. It is identical with below,
+ *        but it is more easy to do that with this func especially for members
+ *        e.g. glm_mat3_identity(aStruct->aMatrix);
+ *
+ * @code
+ * glm_mat3_copy(GLM_MAT3_IDENTITY, mat); // C only
+ *
+ * // or
+ * mat3 mat = GLM_MAT3_IDENTITY_INIT;
+ * @endcode
+ *
+ * @param[in, out]  mat  destination
+ */
+CGLM_INLINE
+void
+glm_mat3_identity(mat3 mat) {
+  mat3 t = GLM_MAT3_IDENTITY_INIT;
+  glm_mat3_copy(t, mat);
+}
+
 /*!
  * @brief multiply m1 and m2 to dest
  *
@@ -50,17 +104,13 @@ glm_mat3_mul(mat3 m1, mat3 m2, mat3 dest) {
 #if defined( __SSE__ ) || defined( __SSE2__ )
   glm_mat3_mul_sse2(m1, m2, dest);
 #else
-  float a00, a01, a02,    b00, b01, b02,
-        a10, a11, a12,    b10, b11, b12,
-        a20, a21, a22,    b20, b21, b22;
+  float a00 = m1[0][0], a01 = m1[0][1], a02 = m1[0][2],
+        a10 = m1[1][0], a11 = m1[1][1], a12 = m1[1][2],
+        a20 = m1[2][0], a21 = m1[2][1], a22 = m1[2][2],
 
-  a00 = m1[0][0], a01 = m1[0][1], a02 = m1[0][2],
-  a10 = m1[1][0], a11 = m1[1][1], a12 = m1[1][2],
-  a20 = m1[2][0], a21 = m1[2][1], a22 = m1[2][2],
-
-  b00 = m2[0][0], b01 = m2[0][1], b02 = m2[0][2],
-  b10 = m2[1][0], b11 = m2[1][1], b12 = m2[1][2],
-  b20 = m2[2][0], b21 = m2[2][1], b22 = m2[2][2],
+        b00 = m2[0][0], b01 = m2[0][1], b02 = m2[0][2],
+        b10 = m2[1][0], b11 = m2[1][1], b12 = m2[1][2],
+        b20 = m2[2][0], b21 = m2[2][1], b22 = m2[2][2];
 
   dest[0][0] = a00 * b00 + a10 * b01 + a20 * b02;
   dest[0][1] = a01 * b00 + a11 * b01 + a21 * b02;
@@ -79,8 +129,8 @@ glm_mat3_mul(mat3 m1, mat3 m2, mat3 dest) {
  *
  * source matrix will not be transposed unless dest is m
  *
- * @param m[in]     matrix
- * @param dest[out] result
+ * @param[in]  m     matrix
+ * @param[out] dest  result
  */
 CGLM_INLINE
 void
@@ -162,13 +212,9 @@ glm_mat3_scale(mat3 m, float s) {
 CGLM_INLINE
 float
 glm_mat3_det(mat3 mat) {
-  float a, b, c,
-        d, e, f,
-        g, h, i;
-
-  a = mat[0][0], b = mat[0][1], c = mat[0][2],
-  d = mat[1][0], e = mat[1][1], f = mat[1][2],
-  g = mat[2][0], h = mat[2][1], i = mat[2][2];
+  float a = mat[0][0], b = mat[0][1], c = mat[0][2],
+        d = mat[1][0], e = mat[1][1], f = mat[1][2],
+        g = mat[2][0], h = mat[2][1], i = mat[2][2];
 
   return a * (e * i - h * f) - d * (b * i - c * h) + g * (b * f - c * e);
 }
@@ -183,13 +229,9 @@ CGLM_INLINE
 void
 glm_mat3_inv(mat3 mat, mat3 dest) {
   float det;
-  float a, b, c,
-        d, e, f,
-        g, h, i;
-
-  a = mat[0][0], b = mat[0][1], c = mat[0][2],
-  d = mat[1][0], e = mat[1][1], f = mat[1][2],
-  g = mat[2][0], h = mat[2][1], i = mat[2][2];
+  float a = mat[0][0], b = mat[0][1], c = mat[0][2],
+        d = mat[1][0], e = mat[1][1], f = mat[1][2],
+        g = mat[2][0], h = mat[2][1], i = mat[2][2];
 
   dest[0][0] =   e * i - f * h;
   dest[0][1] = -(b * i - h * c);
@@ -217,17 +259,17 @@ CGLM_INLINE
 void
 glm_mat3_swap_col(mat3 mat, int col1, int col2) {
   vec3 tmp;
-  glm_vec_dup(mat[col1], tmp);
-  glm_vec_dup(mat[col2], mat[col1]);
-  glm_vec_dup(tmp, mat[col2]);
+  glm_vec_copy(mat[col1], tmp);
+  glm_vec_copy(mat[col2], mat[col1]);
+  glm_vec_copy(tmp, mat[col2]);
 }
 
 /*!
  * @brief swap two matrix rows
  *
  * @param[in,out] mat  matrix
- * @param[in]     col1 col1
- * @param[in]     col2 col2
+ * @param[in]     row1 row1
+ * @param[in]     row2 row2
  */
 CGLM_INLINE
 void

include/cglm/mat4.h

@@ -10,12 +10,53 @@
  * if available. You dont need to call/incude SIMD headers manually
  */
 
+/*
+ Macros:
+   GLM_MAT4_IDENTITY_INIT
+   GLM_MAT4_ZERO_INIT
+   GLM_MAT4_IDENTITY
+   GLM_MAT4_ZERO
+   glm_mat4_udup(mat, dest)
+   glm_mat4_dup(mat, dest)
+
+ Functions:
+   CGLM_INLINE void  glm_mat4_ucopy(mat4 mat, mat4 dest);
+   CGLM_INLINE void  glm_mat4_copy(mat4 mat, mat4 dest);
+   CGLM_INLINE void  glm_mat4_identity(mat4 mat);
+   CGLM_INLINE void  glm_mat4_pick3(mat4 mat, mat3 dest);
+   CGLM_INLINE void  glm_mat4_pick3t(mat4 mat, mat3 dest);
+   CGLM_INLINE void  glm_mat4_ins3(mat3 mat, mat4 dest);
+   CGLM_INLINE void  glm_mat4_mul(mat4 m1, mat4 m2, mat4 dest);
+   CGLM_INLINE void  glm_mat4_mulN(mat4 *matrices[], int len, mat4 dest);
+   CGLM_INLINE void  glm_mat4_mulv(mat4 m, vec4 v, vec4 dest);
+   CGLM_INLINE void  glm_mat4_mulv3(mat4 m, vec3 v, vec3 dest);
+   CGLM_INLINE void  glm_mat4_transpose_to(mat4 m, mat4 dest);
+   CGLM_INLINE void  glm_mat4_transpose(mat4 m);
+   CGLM_INLINE void  glm_mat4_scale_p(mat4 m, float s);
+   CGLM_INLINE void  glm_mat4_scale(mat4 m, float s);
+   CGLM_INLINE float glm_mat4_det(mat4 mat);
+   CGLM_INLINE void  glm_mat4_inv(mat4 mat, mat4 dest);
+   CGLM_INLINE void  glm_mat4_inv_fast(mat4 mat, mat4 dest);
+   CGLM_INLINE void  glm_mat4_swap_col(mat4 mat, int col1, int col2);
+   CGLM_INLINE void  glm_mat4_swap_row(mat4 mat, int row1, int row2);
+ */
+
 #ifndef cglm_mat_h
 #define cglm_mat_h
 
-#include "cglm-common.h"
-#include "arch/simd/cglm-mat-simd-sse2.h"
-#include "arch/simd/cglm-mat-simd-avx.h"
+#include "common.h"
+
+#ifdef CGLM_SSE_FP
+#  include "simd/sse2/mat4.h"
+#endif
+
+#ifdef CGLM_AVX_FP
+#  include "simd/avx/mat4.h"
+#endif
+
+#ifdef CGLM_NEON_FP
+#  include "simd/neon/mat4.h"
+#endif
 
 #include <assert.h>
 
@@ -24,8 +65,21 @@
                                  {0.0f, 0.0f, 1.0f, 0.0f},                    \
                                  {0.0f, 0.0f, 0.0f, 1.0f}}
 
+#define GLM_MAT4_ZERO_INIT      {{0.0f, 0.0f, 0.0f, 0.0f},                    \
+                                 {0.0f, 0.0f, 0.0f, 0.0f},                    \
+                                 {0.0f, 0.0f, 0.0f, 0.0f},                    \
+                                 {0.0f, 0.0f, 0.0f, 0.0f}}
+
 /* for C only */
-#define GLM_MAT4_IDENTITY (mat4)GLM_MAT4_IDENTITY_INIT
+#define GLM_MAT4_IDENTITY ((mat4)GLM_MAT4_IDENTITY_INIT)
+#define GLM_MAT4_ZERO     ((mat4)GLM_MAT4_ZERO_INIT)
+
+/* DEPRECATED! use _copy, _ucopy versions */
+#define glm_mat4_udup(mat, dest) glm_mat4_ucopy(mat, dest)
+#define glm_mat4_dup(mat, dest)  glm_mat4_copy(mat, dest)
+
+/* DEPRECATED! default is precise now. */
+#define glm_mat4_inv_precise(mat, dest) glm_mat4_inv(mat, dest)
 
 /*!
  * @brief copy all members of [mat] to [dest]
@@ -38,7 +92,7 @@
  */
 CGLM_INLINE
 void
-glm_mat4_udup(mat4 mat, mat4 dest) {
+glm_mat4_ucopy(mat4 mat, mat4 dest) {
   glm__memcpy(float, dest, mat, sizeof(mat4));
 }
 
@@ -50,7 +104,7 @@ glm_mat4_udup(mat4 mat, mat4 dest) {
  */
 CGLM_INLINE
 void
-glm_mat4_dup(mat4 mat, mat4 dest) {
+glm_mat4_copy(mat4 mat, mat4 dest) {
 #ifdef __AVX__
   _mm256_store_ps(dest[0], _mm256_load_ps(mat[0]));
   _mm256_store_ps(dest[2], _mm256_load_ps(mat[2]));
@@ -60,10 +114,31 @@ glm_mat4_dup(mat4 mat, mat4 dest) {
   _mm_store_ps(dest[2], _mm_load_ps(mat[2]));
   _mm_store_ps(dest[3], _mm_load_ps(mat[3]));
 #else
-  glm_mat4_udup(mat, dest);
+  glm_mat4_ucopy(mat, dest);
 #endif
 }
 
+/*!
+ * @brief make given matrix identity. It is identical with below, 
+ *        but it is more easy to do that with this func especially for members
+ *        e.g. glm_mat4_identity(aStruct->aMatrix);
+ *
+ * @code
+ * glm_mat4_copy(GLM_MAT4_IDENTITY, mat); // C only
+ *
+ * // or
+ * mat4 mat = GLM_MAT4_IDENTITY_INIT;
+ * @endcode
+ *
+ * @param[in, out]  mat  destination
+ */
+CGLM_INLINE
+void
+glm_mat4_identity(mat4 mat) {
+  mat4 t = GLM_MAT4_IDENTITY_INIT;
+  glm_mat4_copy(t, mat);
+}
+
 /*!
  * @brief copy upper-left of mat4 to mat3
  *
@@ -153,21 +228,18 @@ glm_mat4_mul(mat4 m1, mat4 m2, mat4 dest) {
   glm_mat4_mul_avx(m1, m2, dest);
 #elif defined( __SSE__ ) || defined( __SSE2__ )
   glm_mat4_mul_sse2(m1, m2, dest);
+#elif defined( __ARM_NEON_FP )
+  glm_mat4_mul_neon(m1, m2, dest);
 #else
-  float a00, a01, a02, a03,    b00, b01, b02, b03,
-        a10, a11, a12, a13,    b10, b11, b12, b13,
-        a20, a21, a22, a23,    b20, b21, b22, b23,
-        a30, a31, a32, a33,    b30, b31, b32, b33;
+  float a00 = m1[0][0], a01 = m1[0][1], a02 = m1[0][2], a03 = m1[0][3],
+        a10 = m1[1][0], a11 = m1[1][1], a12 = m1[1][2], a13 = m1[1][3],
+        a20 = m1[2][0], a21 = m1[2][1], a22 = m1[2][2], a23 = m1[2][3],
+        a30 = m1[3][0], a31 = m1[3][1], a32 = m1[3][2], a33 = m1[3][3],
 
-  a00 = m1[0][0], a01 = m1[0][1], a02 = m1[0][2], a03 = m1[0][3],
-  a10 = m1[1][0], a11 = m1[1][1], a12 = m1[1][2], a13 = m1[1][3],
-  a20 = m1[2][0], a21 = m1[2][1], a22 = m1[2][2], a23 = m1[2][3],
-  a30 = m1[3][0], a31 = m1[3][1], a32 = m1[3][2], a33 = m1[3][3];
-
-  b00 = m2[0][0], b01 = m2[0][1], b02 = m2[0][2], b03 = m2[0][3],
-  b10 = m2[1][0], b11 = m2[1][1], b12 = m2[1][2], b13 = m2[1][3],
-  b20 = m2[2][0], b21 = m2[2][1], b22 = m2[2][2], b23 = m2[2][3],
-  b30 = m2[3][0], b31 = m2[3][1], b32 = m2[3][2], b33 = m2[3][3];
+        b00 = m2[0][0], b01 = m2[0][1], b02 = m2[0][2], b03 = m2[0][3],
+        b10 = m2[1][0], b11 = m2[1][1], b12 = m2[1][2], b13 = m2[1][3],
+        b20 = m2[2][0], b21 = m2[2][1], b22 = m2[2][2], b23 = m2[2][3],
+        b30 = m2[3][0], b31 = m2[3][1], b32 = m2[3][2], b33 = m2[3][3];
 
   dest[0][0] = a00 * b00 + a10 * b01 + a20 * b02 + a30 * b03;
   dest[0][1] = a01 * b00 + a11 * b01 + a21 * b02 + a31 * b03;
@@ -242,7 +314,7 @@ glm_mat4_mulv(mat4 m, vec4 v, vec4 dest) {
   res[1] = m[0][1] * v[0] + m[1][1] * v[1] + m[2][1] * v[2] + m[3][1] * v[3];
   res[2] = m[0][2] * v[0] + m[1][2] * v[1] + m[2][2] * v[2] + m[3][2] * v[3];
   res[3] = m[0][3] * v[0] + m[1][3] * v[1] + m[2][3] * v[2] + m[3][3] * v[3];
-  glm_vec4_dup(res, dest);
+  glm_vec4_copy(res, dest);
 #endif
 }
 
@@ -260,7 +332,7 @@ glm_mat4_mulv3(mat4 m, vec3 v, vec3 dest) {
   res[0] = m[0][0] * v[0] + m[1][0] * v[1] + m[2][0] * v[2];
   res[1] = m[0][1] * v[0] + m[1][1] * v[1] + m[2][1] * v[2];
   res[2] = m[0][2] * v[0] + m[1][2] * v[1] + m[2][2] * v[2];
-  glm_vec_dup(res, dest);
+  glm_vec_copy(res, dest);
 }
 
 /*!
@@ -268,8 +340,8 @@ glm_mat4_mulv3(mat4 m, vec3 v, vec3 dest) {
  *
  * source matrix will not be transposed unless dest is m
  *
- * @param m[in]     matrix
- * @param dest[out] result
+ * @param[in]  m    matrix
+ * @param[out] dest result
  */
 CGLM_INLINE
 void
@@ -357,15 +429,10 @@ glm_mat4_det(mat4 mat) {
 #else
   /* [square] det(A) = det(At) */
   float t[6];
-  float a, b, c, d,
-        e, f, g, h,
-        i, j, k, l,
-        m, n, o, p;
-
-  a = mat[0][0], b = mat[0][1], c = mat[0][2], d = mat[0][3],
-  e = mat[1][0], f = mat[1][1], g = mat[1][2], h = mat[1][3],
-  i = mat[2][0], j = mat[2][1], k = mat[2][2], l = mat[2][3],
-  m = mat[3][0], n = mat[3][1], o = mat[3][2], p = mat[3][3];
+  float a = mat[0][0], b = mat[0][1], c = mat[0][2], d = mat[0][3],
+        e = mat[1][0], f = mat[1][1], g = mat[1][2], h = mat[1][3],
+        i = mat[2][0], j = mat[2][1], k = mat[2][2], l = mat[2][3],
+        m = mat[3][0], n = mat[3][1], o = mat[3][2], p = mat[3][3];
 
   t[0] = k * p - o * l;
   t[1] = j * p - n * l;
@@ -384,10 +451,6 @@ glm_mat4_det(mat4 mat) {
 /*!
  * @brief inverse mat4 and store in dest
  *
- * this func uses reciprocal approximation without extra corrections 
- * e.g Newton-Raphson. this should work faster than _precise, 
- * to get precise value use _precise version
- *
  * @param[in]  mat  matrix
  * @param[out] dest inverse matrix
  */
@@ -399,15 +462,10 @@ glm_mat4_inv(mat4 mat, mat4 dest) {
 #else
   float t[6];
   float det;
-  float a, b, c, d,
-        e, f, g, h,
-        i, j, k, l,
-        m, n, o, p;
-
-  a = mat[0][0], b = mat[0][1], c = mat[0][2], d = mat[0][3],
-  e = mat[1][0], f = mat[1][1], g = mat[1][2], h = mat[1][3],
-  i = mat[2][0], j = mat[2][1], k = mat[2][2], l = mat[2][3],
-  m = mat[3][0], n = mat[3][1], o = mat[3][2], p = mat[3][3];
+  float a = mat[0][0], b = mat[0][1], c = mat[0][2], d = mat[0][3],
+        e = mat[1][0], f = mat[1][1], g = mat[1][2], h = mat[1][3],
+        i = mat[2][0], j = mat[2][1], k = mat[2][2], l = mat[2][3],
+        m = mat[3][0], n = mat[3][1], o = mat[3][2], p = mat[3][3];
 
   t[0] = k * p - o * l; t[1] = j * p - n * l; t[2] = j * o - n * k;
   t[3] = i * p - m * l; t[4] = i * o - m * k; t[5] = i * n - m * j;
@@ -445,24 +503,25 @@ glm_mat4_inv(mat4 mat, mat4 dest) {
 #endif
 }
 
-
 /*!
- * @brief inverse mat4 precisely and store in dest
+ * @brief inverse mat4 and store in dest
  *
- * this do same thing as glm_mat4_inv did. the only diff is this func uses
- * division instead of reciprocal approximation. Due to division this might
- * work slower than glm_mat4_inv
+ * this func uses reciprocal approximation without extra corrections
+ * e.g Newton-Raphson. this should work faster than normal,
+ * to get more precise use glm_mat4_inv version.
+ *
+ * NOTE: You will lose precision, glm_mat4_inv is more accurate
  *
  * @param[in]  mat  matrix
  * @param[out] dest inverse matrix
  */
 CGLM_INLINE
 void
-glm_mat4_inv_precise(mat4 mat, mat4 dest) {
+glm_mat4_inv_fast(mat4 mat, mat4 dest) {
 #if defined( __SSE__ ) || defined( __SSE2__ )
-  glm_mat4_inv_precise_sse2(mat, dest);
+  glm_mat4_inv_fast_sse2(mat, dest);
 #else
-  glm_mat4_inv_precise(mat, dest);
+  glm_mat4_inv(mat, dest);
 #endif
 }
 
@@ -477,17 +536,17 @@ CGLM_INLINE
 void
 glm_mat4_swap_col(mat4 mat, int col1, int col2) {
   vec4 tmp;
-  glm_vec4_dup(mat[col1], tmp);
-  glm_vec4_dup(mat[col2], mat[col1]);
-  glm_vec4_dup(tmp, mat[col2]);
+  glm_vec4_copy(mat[col1], tmp);
+  glm_vec4_copy(mat[col2], mat[col1]);
+  glm_vec4_copy(tmp, mat[col2]);
 }
 
 /*!
  * @brief swap two matrix rows
  *
  * @param[in,out] mat  matrix
- * @param[in]     col1 col1
- * @param[in]     col2 col2
+ * @param[in]     row1 row1
+ * @param[in]     row2 row2
  */
 CGLM_INLINE
 void

include/cglm/plane.h

@@ -0,0 +1,38 @@
+/*
+ * Copyright (c), Recep Aslantas.
+ *
+ * MIT License (MIT), http://opensource.org/licenses/MIT
+ * Full license can be found in the LICENSE file
+ */
+
+#ifndef cglm_plane_h
+#define cglm_plane_h
+
+#include "common.h"
+#include "mat4.h"
+#include "vec4.h"
+#include "vec3.h"
+
+/*
+ Plane equation:  Ax + By + Cz + D = 0;
+
+ It stored in vec4 as [A, B, C, D]. (A, B, C) is normal and D is distance
+*/
+
+/*
+ Functions:
+   CGLM_INLINE void  glm_plane_normalize(vec4 plane);
+ */
+
+/*!
+ * @brief normalizes a plane
+ *
+ * @param[in, out] plane pnale to normalize
+ */
+CGLM_INLINE
+void
+glm_plane_normalize(vec4 plane) {
+  glm_vec4_scale(plane, 1.0f / glm_vec_norm(plane), plane);
+}
+
+#endif /* cglm_plane_h */

include/cglm/quat.h

@@ -0,0 +1,284 @@
+/*
+ * Copyright (c), Recep Aslantas.
+ *
+ * MIT License (MIT), http://opensource.org/licenses/MIT
+ * Full license can be found in the LICENSE file
+ */
+
+/*
+ Macros:
+   GLM_QUAT_IDENTITY_INIT
+   GLM_QUAT_IDENTITY
+
+ Functions:
+   CGLM_INLINE void  glm_quat_identity(versor q);
+   CGLM_INLINE void  glm_quat(versor q, float angle, float x, float y, float z);
+   CGLM_INLINE void  glm_quatv(versor q, float angle, vec3 v);
+   CGLM_INLINE float glm_quat_norm(versor q);
+   CGLM_INLINE void  glm_quat_normalize(versor q);
+   CGLM_INLINE float glm_quat_dot(versor q, versor r);
+   CGLM_INLINE void  glm_quat_mulv(versor q1, versor q2, versor dest);
+   CGLM_INLINE void  glm_quat_mat4(versor q, mat4 dest);
+   CGLM_INLINE void  glm_quat_slerp(versor q, versor r, float t, versor dest);
+ */
+
+#ifndef cglm_quat_h
+#define cglm_quat_h
+
+#include "common.h"
+#include "vec4.h"
+
+#ifdef CGLM_SSE_FP
+#  include "simd/sse2/quat.h"
+#endif
+
+/*
+ * IMPORTANT! cglm stores quat as [w, x, y, z]
+ *
+ * Possible changes (these may be changed in the future):
+ *  - versor is identity quat, we can define new type for quat.
+ *    it can't be quat or quaternion becuase someone can use that name for
+ *    variable name. maybe just vec4.
+ *  - it stores [w, x, y, z] but it may change to [x, y, z, w] if we get enough
+ *    feedback to change it.
+ *  - in general we use last param as dest, but this header used first param
+ *    as dest this may be changed but decided yet
+ */
+
+#define GLM_QUAT_IDENTITY_INIT  {1.0f, 0.0f, 0.0f, 0.0f}
+#define GLM_QUAT_IDENTITY       ((versor)GLM_QUAT_IDENTITY_INIT)
+
+/*!
+ * @brief makes given quat to identity
+ *
+ * @param[in, out]  q  quaternion
+ */
+CGLM_INLINE
+void
+glm_quat_identity(versor q) {
+  versor v = GLM_QUAT_IDENTITY_INIT;
+  glm_vec4_copy(v, q);
+}
+
+/*!
+ * @brief creates NEW quaternion with individual axis components
+ *
+ * @param[out]  q     quaternion
+ * @param[in]   angle angle (radians)
+ * @param[in]   x     axis.x
+ * @param[in]   y     axis.y
+ * @param[in]   z     axis.z
+ */
+CGLM_INLINE
+void
+glm_quat(versor q,
+         float  angle,
+         float  x,
+         float  y,
+         float  z) {
+  float a, c, s;
+
+  a = angle * 0.5f;
+  c = cosf(a);
+  s = sinf(a);
+
+  q[0] = c;
+  q[1] = s * x;
+  q[2] = s * y;
+  q[3] = s * z;
+}
+
+/*!
+ * @brief creates NEW quaternion with axis vector
+ *
+ * @param[out]  q     quaternion
+ * @param[in]   angle angle (radians)
+ * @param[in]   v     axis
+ */
+CGLM_INLINE
+void
+glm_quatv(versor q,
+          float  angle,
+          vec3   v) {
+  float a, c, s;
+
+  a = angle * 0.5f;
+  c = cosf(a);
+  s = sinf(a);
+
+  q[0] = c;
+  q[1] = s * v[0];
+  q[2] = s * v[1];
+  q[3] = s * v[2];
+}
+
+/*!
+ * @brief returns norm (magnitude) of quaternion
+ *
+ * @param[out]  q  quaternion
+ */
+CGLM_INLINE
+float
+glm_quat_norm(versor q) {
+  return glm_vec4_norm(q);
+}
+
+/*!
+ * @brief normalize quaternion
+ *
+ * @param[in, out]  q  quaternion
+ */
+CGLM_INLINE
+void
+glm_quat_normalize(versor q) {
+  float sum;
+
+  sum = q[0] * q[0] + q[1] * q[1]
+          + q[2] * q[2] + q[3] * q[3];
+
+  if (fabs(1.0f - sum) < 0.0001f)
+    return;
+
+  glm_vec4_scale(q, 1.0f / sqrtf(sum), q);
+}
+
+/*!
+ * @brief dot product of two quaternion
+ *
+ * @param[in]  q  quaternion 1
+ * @param[in]  r  quaternion 2
+ */
+CGLM_INLINE
+float
+glm_quat_dot(versor q, versor r) {
+  return glm_vec4_dot(q, r);
+}
+
+/*!
+ * @brief multiplies two quaternion and stores result in dest
+ *
+ * @param[in]   q1    quaternion 1
+ * @param[in]   q2    quaternion 2
+ * @param[out]  dest  result quaternion
+ */
+CGLM_INLINE
+void
+glm_quat_mulv(versor q1, versor q2, versor dest) {
+  dest[0] = q2[0] * q1[0] - q2[1] * q1[1] - q2[2] * q1[2] - q2[3] * q1[3];
+  dest[1] = q2[0] * q1[1] + q2[1] * q1[0] - q2[2] * q1[3] + q2[3] * q1[2];
+  dest[2] = q2[0] * q1[2] + q2[1] * q1[3] + q2[2] * q1[0] - q2[3] * q1[1];
+  dest[3] = q2[0] * q1[3] - q2[1] * q1[2] + q2[2] * q1[1] + q2[3] * q1[0];
+
+  glm_quat_normalize(dest);
+}
+
+/*!
+ * @brief convert quaternion to mat4
+ *
+ * @param[in]   q     quaternion
+ * @param[out]  dest  result matrix
+ */
+CGLM_INLINE
+void
+glm_quat_mat4(versor q, mat4 dest) {
+  float w, x, y, z;
+  float xx, yy, zz;
+  float xy, yz, xz;
+  float wx, wy, wz;
+
+  w = q[0];
+  x = q[1];
+  y = q[2];
+  z = q[3];
+
+  xx = 2.0f * x * x;   xy = 2.0f * x * y;   wx = 2.0f * w * x;
+  yy = 2.0f * y * y;   yz = 2.0f * y * z;   wy = 2.0f * w * y;
+  zz = 2.0f * z * z;   xz = 2.0f * x * z;   wz = 2.0f * w * z;
+
+  dest[0][0] = 1.0f - yy - zz;
+  dest[1][1] = 1.0f - xx - zz;
+  dest[2][2] = 1.0f - xx - yy;
+
+  dest[0][1] = xy + wz;
+  dest[1][2] = yz + wx;
+  dest[2][0] = xz + wy;
+
+  dest[1][0] = xy - wz;
+  dest[2][1] = yz - wx;
+  dest[0][2] = xz - wy;
+
+  dest[1][3] = 0.0f;
+  dest[0][3] = 0.0f;
+  dest[2][3] = 0.0f;
+  dest[3][0] = 0.0f;
+  dest[3][1] = 0.0f;
+  dest[3][2] = 0.0f;
+  dest[3][3] = 1.0f;
+}
+
+/*!
+ * @brief interpolates between two quaternions
+ *        using spherical linear interpolation (SLERP)
+ *
+ * @param[in]   q     from
+ * @param[in]   r     to
+ * @param[in]   t     amout
+ * @param[out]  dest  result quaternion
+ */
+CGLM_INLINE
+void
+glm_quat_slerp(versor q,
+               versor r,
+               float  t,
+               versor dest) {
+  /* https://en.wikipedia.org/wiki/Slerp */
+#if defined( __SSE__ ) || defined( __SSE2__ )
+  glm_quat_slerp_sse2(q, r, t, dest);
+#else
+  float cosTheta, sinTheta, angle, a, b, c;
+
+  cosTheta = glm_quat_dot(q, r);
+  if (cosTheta < 0.0f) {
+    q[0] *= -1.0f;
+    q[1] *= -1.0f;
+    q[2] *= -1.0f;
+    q[3] *= -1.0f;
+
+    cosTheta = -cosTheta;
+  }
+
+  if (fabs(cosTheta) >= 1.0f) {
+    dest[0] = q[0];
+    dest[1] = q[1];
+    dest[2] = q[2];
+    dest[3] = q[3];
+    return;
+  }
+
+  sinTheta = sqrt(1.0f - cosTheta * cosTheta);
+
+  c = 1.0f - t;
+
+  /* LERP */
+  /* TODO: FLT_EPSILON vs 0.001? */
+  if (sinTheta < 0.001f) {
+    dest[0] = c * q[0] + t * r[0];
+    dest[1] = c * q[1] + t * r[1];
+    dest[2] = c * q[2] + t * r[2];
+    dest[3] = c * q[3] + t * r[3];
+    return;
+  }
+
+  /* SLERP */
+  angle = acosf(cosTheta);
+  a = sinf(c * angle);
+  b = sinf(t * angle);
+
+  dest[0] = (q[0] * a + r[0] * b) / sinTheta;
+  dest[1] = (q[1] * a + r[1] * b) / sinTheta;
+  dest[2] = (q[2] * a + r[2] * b) / sinTheta;
+  dest[3] = (q[3] * a + r[3] * b) / sinTheta;
+#endif
+}
+
+#endif /* cglm_quat_h */

include/cglm/simd/avx/affine.h

@@ -9,8 +9,8 @@
 #define cglm_affine_mat_avx_h
 #ifdef __AVX__
 
-#include "../../cglm-common.h"
-#include "cglm-intrin.h"
+#include "../../common.h"
+#include "../intrin.h"
 
 #include <immintrin.h>
 

include/cglm/simd/avx/mat4.h

@@ -9,8 +9,8 @@
 #define cglm_mat_simd_avx_h
 #ifdef __AVX__
 
-#include "../../cglm-common.h"
-#include "cglm-intrin.h"
+#include "../../common.h"
+#include "../intrin.h"
 
 #include <immintrin.h>
 

include/cglm/simd/intrin.h

@@ -0,0 +1,52 @@
+/*
+ * Copyright (c), Recep Aslantas.
+ *
+ * MIT License (MIT), http://opensource.org/licenses/MIT
+ * Full license can be found in the LICENSE file
+ */
+
+#ifndef cglm_intrin_h
+#define cglm_intrin_h
+
+#if defined( _WIN32 )
+#  if (defined(_M_AMD64) || defined(_M_X64)) || _M_IX86_FP == 2
+#    define __SSE2__
+#  elif _M_IX86_FP == 1
+#    define __SSE__
+#  endif
+#endif
+
+#if defined( __SSE__ ) || defined( __SSE2__ )
+#  include <xmmintrin.h>
+#  include <emmintrin.h>
+
+/* float */
+#  define _mm_shuffle1_ps(a, z, y, x, w)                                       \
+     _mm_shuffle_ps(a, a, _MM_SHUFFLE(z, y, x, w))
+
+#  define _mm_shuffle1_ps1(a, x)                                               \
+     _mm_shuffle_ps(a, a, _MM_SHUFFLE(x, x, x, x))
+
+#  define _mm_shuffle2_ps(a, b, z0, y0, x0, w0, z1, y1, x1, w1)                \
+     _mm_shuffle1_ps(_mm_shuffle_ps(a, b, _MM_SHUFFLE(z0, y0, x0, w0)),        \
+                                    z1, y1, x1, w1)
+#endif
+
+/* x86, x64 */
+#if defined( __SSE__ ) || defined( __SSE2__ )
+#  define CGLM_SSE_FP 1
+#endif
+
+#ifdef __AVX__
+#  define CGLM_AVX_FP 1
+#endif
+
+/* ARM Neon */
+#if defined(__ARM_NEON) && defined(__ARM_NEON_FP)
+#  include <arm_neon.h>
+#  define CGLM_NEON_FP 1
+#else
+#  undef  CGLM_NEON_FP
+#endif
+
+#endif /* cglm_intrin_h */

include/cglm/simd/neon/mat4.h

@@ -0,0 +1,57 @@
+/*
+ * Copyright (c), Recep Aslantas.
+ *
+ * MIT License (MIT), http://opensource.org/licenses/MIT
+ * Full license can be found in the LICENSE file
+ */
+
+#ifndef cglm_mat4_neon_h
+#define cglm_mat4_neon_h
+#if defined(__ARM_NEON_FP)
+
+#include "../../common.h"
+#include "../intrin.h"
+
+CGLM_INLINE
+void
+glm_mat4_mul_neon(mat4 m1, mat4 m2, mat4 dest) {
+  /* D = R * L (Column-Major) */
+  float32x4_t l0, l1, l2, l3, r, d0, d1, d2, d3;
+
+  l0 = vld1q_f32(m2[0]);
+  l1 = vld1q_f32(m2[1]);
+  l2 = vld1q_f32(m2[2]);
+  l3 = vld1q_f32(m2[3]);
+
+  r  = vld1q_f32(m1[0]);
+  d0 = vmulq_lane_f32(r, vget_low_f32(l0), 0);
+  d1 = vmulq_lane_f32(r, vget_low_f32(l1), 0);
+  d2 = vmulq_lane_f32(r, vget_low_f32(l2), 0);
+  d3 = vmulq_lane_f32(r, vget_low_f32(l3), 0);
+
+  r  = vld1q_f32(m1[1]);
+  d0 = vmlaq_lane_f32(d0, r, vget_low_f32(l0), 1);
+  d1 = vmlaq_lane_f32(d1, r, vget_low_f32(l1), 1);
+  d2 = vmlaq_lane_f32(d2, r, vget_low_f32(l2), 1);
+  d3 = vmlaq_lane_f32(d3, r, vget_low_f32(l3), 1);
+
+  r  = vld1q_f32(m1[2]);
+  d0 = vmlaq_lane_f32(d0, r, vget_high_f32(l0), 0);
+  d1 = vmlaq_lane_f32(d1, r, vget_high_f32(l1), 0);
+  d2 = vmlaq_lane_f32(d2, r, vget_high_f32(l2), 0);
+  d3 = vmlaq_lane_f32(d3, r, vget_high_f32(l3), 0);
+
+  r  = vld1q_f32(m1[3]);
+  d0 = vmlaq_lane_f32(d0, r, vget_high_f32(l0), 1);
+  d1 = vmlaq_lane_f32(d1, r, vget_high_f32(l1), 1);
+  d2 = vmlaq_lane_f32(d2, r, vget_high_f32(l2), 1);
+  d3 = vmlaq_lane_f32(d3, r, vget_high_f32(l3), 1);
+
+  vst1q_f32(dest[0], d0);
+  vst1q_f32(dest[1], d1);
+  vst1q_f32(dest[2], d2);
+  vst1q_f32(dest[3], d3);
+}
+
+#endif
+#endif /* cglm_mat4_neon_h */

include/cglm/simd/sse2/affine.h

@@ -9,8 +9,8 @@
 #define cglm_affine_mat_sse2_h
 #if defined( __SSE__ ) || defined( __SSE2__ )
 
-#include "../../cglm-common.h"
-#include "cglm-intrin.h"
+#include "../../common.h"
+#include "../intrin.h"
 
 CGLM_INLINE
 void

include/cglm/simd/sse2/mat3.h

@@ -9,8 +9,8 @@
 #define cglm_mat3_sse_h
 #if defined( __SSE__ ) || defined( __SSE2__ )
 
-#include "../../cglm-common.h"
-#include "cglm-intrin.h"
+#include "../../common.h"
+#include "../intrin.h"
 
 CGLM_INLINE
 void

include/cglm/simd/sse2/mat4.h

@@ -9,8 +9,10 @@
 #define cglm_mat_sse_h
 #if defined( __SSE__ ) || defined( __SSE2__ )
 
-#include "../../cglm-common.h"
-#include "cglm-intrin.h"
+#include "../../common.h"
+#include "../intrin.h"
+
+#define glm_mat4_inv_precise_sse2(mat, dest) glm_mat4_inv_sse2(mat, dest)
 
 CGLM_INLINE
 void
@@ -157,7 +159,7 @@ glm_mat4_det_sse2(mat4 mat) {
 
 CGLM_INLINE
 void
-glm_mat4_inv_sse2(mat4 mat, mat4 dest) {
+glm_mat4_inv_fast_sse2(mat4 mat, mat4 dest) {
   __m128 r0, r1, r2, r3,
          v0, v1, v2, v3,
          t0, t1, t2, t3, t4, t5,
@@ -281,7 +283,7 @@ glm_mat4_inv_sse2(mat4 mat, mat4 dest) {
 
 CGLM_INLINE
 void
-glm_mat4_inv_precise_sse2(mat4 mat, mat4 dest) {
+glm_mat4_inv_sse2(mat4 mat, mat4 dest) {
   __m128 r0, r1, r2, r3,
          v0, v1, v2, v3,
          t0, t1, t2, t3, t4, t5,

include/cglm/simd/sse2/quat.h

@@ -7,9 +7,10 @@
 
 #ifndef cglm_quat_simd_h
 #define cglm_quat_simd_h
+#if defined( __SSE__ ) || defined( __SSE2__ )
 
-#include "../../cglm-common.h"
-#include "cglm-intrin.h"
+#include "../../common.h"
+#include "../intrin.h"
 
 CGLM_INLINE
 void
@@ -64,4 +65,5 @@ glm_quat_slerp_sse2(versor q,
                           _mm_set1_ps(sinTheta)));
 }
 
+#endif
 #endif /* cglm_quat_simd_h */

include/cglm/types.h

@@ -8,7 +8,7 @@
 #ifndef cglm_types_h
 #define cglm_types_h
 
-#if defined(_WIN32)
+#if defined(_MSC_VER)
 #  define CGLM_ALIGN(X) /* __declspec(align(X)) */
 #else
 #  define CGLM_ALIGN(X) __attribute((aligned(X)))

include/cglm/util.h

@@ -0,0 +1,118 @@
+/*
+ * Copyright (c), Recep Aslantas.
+ *
+ * MIT License (MIT), http://opensource.org/licenses/MIT
+ * Full license can be found in the LICENSE file
+ */
+
+/*
+ Functions:
+   CGLM_INLINE int   glm_sign(int val);
+   CGLM_INLINE float glm_rad(float deg);
+   CGLM_INLINE float glm_deg(float rad);
+   CGLM_INLINE void  glm_make_rad(float *deg);
+   CGLM_INLINE void  glm_make_deg(float *rad);
+   CGLM_INLINE float glm_pow2(float x);
+ */
+
+#ifndef cglm_util_h
+#define cglm_util_h
+
+#include "common.h"
+
+/*!
+ * @brief get sign of 32 bit integer as +1 or -1
+ *
+ * @param val integer value
+ */
+CGLM_INLINE
+int
+glm_sign(int val) {
+  return ((val >> 31) - (-val >> 31));
+}
+
+/*!
+ * @brief convert degree to radians
+ *
+ * @param[in] deg angle in degrees
+ */
+CGLM_INLINE
+float
+glm_rad(float deg) {
+  return deg * CGLM_PI / 180.0f;
+}
+
+/*!
+ * @brief convert radians to degree
+ *
+ * @param[in] rad angle in radians
+ */
+CGLM_INLINE
+float
+glm_deg(float rad) {
+  return rad * 180.0f / CGLM_PI;
+}
+
+/*!
+ * @brief convert exsisting degree to radians. this will override degrees value
+ *
+ * @param[in, out] deg pointer to angle in degrees
+ */
+CGLM_INLINE
+void
+glm_make_rad(float *deg) {
+  *deg = *deg * CGLM_PI / 180.0f;
+}
+
+/*!
+ * @brief convert exsisting radians to degree. this will override radians value
+ *
+ * @param[in, out] rad pointer to angle in radians
+ */
+CGLM_INLINE
+void
+glm_make_deg(float *rad) {
+  *rad = *rad * 180.0f / CGLM_PI;
+}
+
+/*!
+ * @brief multiplies given parameter with itself = x * x or powf(x, 2)
+ *
+ * @param[in] x x
+ */
+CGLM_INLINE
+float
+glm_pow2(float x) {
+
+  return x * x;
+}
+
+/*!
+ * @brief find minimum of given two values
+ *
+ * @param[in] a number 1
+ * @param[in] b number 2
+ */
+CGLM_INLINE
+float
+glm_min(float a, float b) {
+  if (a < b)
+    return a;
+  return b;
+}
+
+/*!
+ * @brief find maximum of given two values
+ *
+ * @param[in] a number 1
+ * @param[in] b number 2
+ */
+CGLM_INLINE
+float
+glm_max(float a, float b) {
+  if (a > b)
+    return a;
+  return b;
+}
+
+#endif /* cglm_util_h */

include/cglm/vec3-ext.h

@@ -0,0 +1,163 @@
+/*
+ * Copyright (c), Recep Aslantas.
+ *
+ * MIT License (MIT), http://opensource.org/licenses/MIT
+ * Full license can be found in the LICENSE file
+ */
+
+/*!
+ * @brief SIMD like functions
+ */
+
+/*
+ Functions:
+   CGLM_INLINE void  glm_vec_mulv(vec3 a, vec3 b, vec3 d);
+   CGLM_INLINE void  glm_vec_broadcast(float val, vec3 d);
+   CGLM_INLINE bool  glm_vec_eq(vec3 v, float val);
+   CGLM_INLINE bool  glm_vec_eq_eps(vec3 v, float val);
+   CGLM_INLINE bool  glm_vec_eq_all(vec3 v);
+   CGLM_INLINE bool  glm_vec_eqv(vec3 v1, vec3 v2);
+   CGLM_INLINE bool  glm_vec_eqv_eps(vec3 v1, vec3 v2);
+   CGLM_INLINE float glm_vec_max(vec3 v);
+   CGLM_INLINE float glm_vec_min(vec3 v);
+ */
+
+#ifndef cglm_vec3_ext_h
+#define cglm_vec3_ext_h
+
+#include "common.h"
+#include <stdbool.h>
+#include <math.h>
+#include <float.h>
+
+/*!
+ * @brief multiplies individual items, just for convenient like SIMD
+ *
+ * @param[in]  a vec1
+ * @param[in]  b vec2
+ * @param[out] d vec3 = (v1[0] * v2[0],  v1[1] * v2[1], v1[2] * v2[2])
+ */
+CGLM_INLINE
+void
+glm_vec_mulv(vec3 a, vec3 b, vec3 d) {
+  d[0] = a[0] * b[0];
+  d[1] = a[1] * b[1];
+  d[2] = a[2] * b[2];
+}
+
+/*!
+ * @brief fill a vector with specified value
+ *
+ * @param[in]  val value
+ * @param[out] d   dest
+ */
+CGLM_INLINE
+void
+glm_vec_broadcast(float val, vec3 d) {
+  d[0] = d[1] = d[2] = val;
+}
+
+/*!
+ * @brief check if vector is equal to value (without epsilon)
+ *
+ * @param[in] v   vector
+ * @param[in] val value
+ */
+CGLM_INLINE
+bool
+glm_vec_eq(vec3 v, float val) {
+  return v[0] == val && v[0] == v[1] && v[0] == v[2];
+}
+
+/*!
+ * @brief check if vector is equal to value (with epsilon)
+ *
+ * @param[in] v   vector
+ * @param[in] val value
+ */
+CGLM_INLINE
+bool
+glm_vec_eq_eps(vec3 v, float val) {
+  return fabsf(v[0] - val) <= FLT_EPSILON
+         && fabsf(v[1] - val) <= FLT_EPSILON
+         && fabsf(v[2] - val) <= FLT_EPSILON;
+}
+
+/*!
+ * @brief check if vectors members are equal (without epsilon)
+ *
+ * @param[in] v   vector
+ */
+CGLM_INLINE
+bool
+glm_vec_eq_all(vec3 v) {
+  return v[0] == v[1] && v[0] == v[2];
+}
+
+/*!
+ * @brief check if vector is equal to another (without epsilon)
+ *
+ * @param[in] v1 vector
+ * @param[in] v2 vector
+ */
+CGLM_INLINE
+bool
+glm_vec_eqv(vec3 v1, vec3 v2) {
+  return v1[0] == v2[0]
+        && v1[1] == v2[1]
+        && v1[2] == v2[2];
+}
+
+/*!
+ * @brief check if vector is equal to another (with epsilon)
+ *
+ * @param[in] v1 vector
+ * @param[in] v2 vector
+ */
+CGLM_INLINE
+bool
+glm_vec_eqv_eps(vec3 v1, vec3 v2) {
+  return fabsf(v1[0] - v2[0]) <= FLT_EPSILON
+         && fabsf(v1[1] - v2[1]) <= FLT_EPSILON
+         && fabsf(v1[2] - v2[2]) <= FLT_EPSILON;
+}
+
+/*!
+ * @brief max value of vector
+ *
+ * @param[in] v vector
+ */
+CGLM_INLINE
+float
+glm_vec_max(vec3 v) {
+  float max;
+
+  max = v[0];
+  if (v[1] > max)
+    max = v[1];
+  if (v[2] > max)
+    max = v[2];
+
+  return max;
+}
+
+/*!
+ * @brief min value of vector
+ *
+ * @param[in] v vector
+ */
+CGLM_INLINE
+float
+glm_vec_min(vec3 v) {
+  float min;
+
+  min = v[0];
+  if (v[1] < min)
+    min = v[1];
+  if (v[2] < min)
+    min = v[2];
+
+  return min;
+}
+
+#endif /* cglm_vec3_ext_h */

include/cglm/vec3.h

@@ -10,39 +10,82 @@
  * all functions without suffix are vec3 functions
  */
 
-#ifndef cglm_vec_h
-#define cglm_vec_h
+/*
+ Macros:
+   glm_vec_dup(v, dest)
+   GLM_VEC3_ONE_INIT
+   GLM_VEC3_ZERO_INIT
+   GLM_VEC3_ONE
+   GLM_VEC3_ZERO
+   GLM_YUP
+   GLM_ZUP
+   GLM_XUP
 
-#include "cglm-common.h"
-#include "cglm-vec-ext.h"
-#include "arch/simd/cglm-intrin.h"
+ Functions:
+   CGLM_INLINE void  glm_vec3(vec4 v4, vec3 dest);
+   CGLM_INLINE void  glm_vec_copy(vec3 a, vec3 dest);
+   CGLM_INLINE float glm_vec_dot(vec3 a, vec3 b);
+   CGLM_INLINE void  glm_vec_cross(vec3 a, vec3 b, vec3 d);
+   CGLM_INLINE float glm_vec_norm2(vec3 v);
+   CGLM_INLINE float glm_vec_norm(vec3 vec);
+   CGLM_INLINE void  glm_vec_add(vec3 v1, vec3 v2, vec3 dest);
+   CGLM_INLINE void  glm_vec_sub(vec3 v1, vec3 v2, vec3 dest);
+   CGLM_INLINE void  glm_vec_scale(vec3 v, float s, vec3 dest);
+   CGLM_INLINE void  glm_vec_scale_as(vec3 v, float s, vec3 dest);
+   CGLM_INLINE void  glm_vec_flipsign(vec3 v);
+   CGLM_INLINE void  glm_vec_inv(vec3 v);
+   CGLM_INLINE void  glm_vec_inv_to(vec3 v, vec3 dest);
+   CGLM_INLINE void  glm_vec_normalize(vec3 v);
+   CGLM_INLINE void  glm_vec_normalize_to(vec3 vec, vec3 dest);
+   CGLM_INLINE float glm_vec_distance(vec3 v1, vec3 v2);
+   CGLM_INLINE float glm_vec_angle(vec3 v1, vec3 v2);
+   CGLM_INLINE void  glm_vec_rotate(vec3 v, float angle, vec3 axis);
+   CGLM_INLINE void  glm_vec_rotate_m4(mat4 m, vec3 v, vec3 dest);
+   CGLM_INLINE void  glm_vec_proj(vec3 a, vec3 b, vec3 dest);
+   CGLM_INLINE void  glm_vec_center(vec3 v1, vec3 v2, vec3 dest);
+   CGLM_INLINE void  glm_vec_maxv(vec3 v1, vec3 v2, vec3 dest);
+   CGLM_INLINE void  glm_vec_minv(vec3 v1, vec3 v2, vec3 dest);
+   CGLM_INLINE void  glm_vec_ortho(vec3 v, vec3 dest);
+
+ Convenient:
+   CGLM_INLINE void  glm_cross(vec3 a, vec3 b, vec3 d);
+   CGLM_INLINE float glm_dot(vec3 a, vec3 b);
+   CGLM_INLINE void  glm_normalize(vec3 v);
+   CGLM_INLINE void  glm_normalize_to(vec3 v, vec3 dest);
+ */
+
+#ifndef cglm_vec3_h
+#define cglm_vec3_h
+
+#include "common.h"
+#include "vec3-ext.h"
+#include "util.h"
+
+/* DEPRECATED! use _copy, _ucopy versions */
+#define glm_vec_dup(v, dest) glm_vec_copy(v, dest)
+
+#define GLM_VEC3_ONE_INIT   {1.0f, 1.0f, 1.0f}
+#define GLM_VEC3_ZERO_INIT  {0.0f, 0.0f, 0.0f}
+
+#define GLM_VEC3_ONE  ((vec3)GLM_VEC3_ONE_INIT)
+#define GLM_VEC3_ZERO ((vec3)GLM_VEC3_ZERO_INIT)
+
+#define GLM_YUP  ((vec3){0.0f, 1.0f, 0.0f})
+#define GLM_ZUP  ((vec3){0.0f, 0.0f, 1.0f})
+#define GLM_XUP  ((vec3){1.0f, 0.0f, 0.0f})
 
 /*!
- * @brief copy all members of [a] to [dest]
+ * @brief init vec3 using vec4
  *
- * @param[in]  a    source
+ * @param[in]  v4   vector4
  * @param[out] dest destination
  */
 CGLM_INLINE
 void
-glm_vec_dup(vec3 a, vec3 dest) {
-  dest[0] = a[0];
-  dest[1] = a[1];
-  dest[2] = a[2];
-}
-
-/*!
- * @brief copy first 3 members of [a] to [dest]
- *
- * @param[in]  a    source
- * @param[out] dest destination
- */
-CGLM_INLINE
-void
-glm_vec4_dup3(vec4 a, vec3 dest) {
-  dest[0] = a[0];
-  dest[1] = a[1];
-  dest[2] = a[2];
+glm_vec3(vec4 v4, vec3 dest) {
+  dest[0] = v4[0];
+  dest[1] = v4[1];
+  dest[2] = v4[2];
 }
 
 /*!
@@ -53,22 +96,17 @@ glm_vec4_dup3(vec4 a, vec3 dest) {
  */
 CGLM_INLINE
 void
-glm_vec4_dup(vec4 v, vec4 dest) {
-#if defined( __SSE__ ) || defined( __SSE2__ )
-  _mm_store_ps(dest, _mm_load_ps(v));
-#else
-  dest[0] = v[0];
-  dest[1] = v[1];
-  dest[2] = v[2];
-  dest[3] = v[3];
-#endif
+glm_vec_copy(vec3 a, vec3 dest) {
+  dest[0] = a[0];
+  dest[1] = a[1];
+  dest[2] = a[2];
 }
 
 /*!
  * @brief vec3 dot product
  *
- * @param[in] a
- * @param[in] b
+ * @param[in] a vector1
+ * @param[in] b vector2
  *
  * @return dot product
  */
@@ -78,20 +116,6 @@ glm_vec_dot(vec3 a, vec3 b) {
   return a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
 }
 
-/*!
- * @brief vec4 dot product
- *
- * @param[in] a
- * @param[in] b
- *
- * @return dot product
- */
-CGLM_INLINE
-float
-glm_vec4_dot(vec4 a, vec4 b) {
-  return a[0] * b[0] + a[1] * b[1] + a[2] * b[2] + a[3] * b[3];
-}
-
 /*!
  * @brief vec3 cross product
  *
@@ -111,11 +135,11 @@ glm_vec_cross(vec3 a, vec3 b, vec3 d) {
 /*!
  * @brief norm * norm (magnitude) of vec
  *
- * we can use this func instead of calling norm * norm, because it would call 
- * sqrtf fuction twice but with this func we can avoid func call, maybe this is 
+ * we can use this func instead of calling norm * norm, because it would call
+ * sqrtf fuction twice but with this func we can avoid func call, maybe this is
  * not good name for this func
  *
- * @param[in] vec vec
+ * @param[in] v vector
  *
  * @return norm * norm
  */
@@ -128,7 +152,7 @@ glm_vec_norm2(vec3 v) {
 /*!
  * @brief norm (magnitude) of vec3
  *
- * @param[in] vec
+ * @param[in] vec vector
  *
  * @return norm
  */
@@ -138,41 +162,11 @@ glm_vec_norm(vec3 vec) {
   return sqrtf(glm_vec_norm2(vec));
 }
 
-/*!
- * @brief norm * norm (magnitude) of vec
- *
- * we can use this func instead of calling norm * norm, because it would call
- * sqrtf fuction twice but with this func we can avoid func call, maybe this is
- * not good name for this func
- *
- * @param[in] vec vec4
- *
- * @return norm * norm
- */
-CGLM_INLINE
-float
-glm_vec4_norm2(vec4 v) {
-  return v[0] * v[0] + v[1] * v[1] + v[2] * v[2] + v[3] * v[3];
-}
-
-/*!
- * @brief norm (magnitude) of vec4
- *
- * @param[in] vec
- *
- * @return norm
- */
-CGLM_INLINE
-float
-glm_vec4_norm(vec4 vec) {
-  return sqrtf(glm_vec4_norm2(vec));
-}
-
 /*!
  * @brief add v2 vector to v1 vector store result in dest
  *
- * @param[in]  v1
- * @param[in]  v2
+ * @param[in]  v1 vector1
+ * @param[in]  v2 vector2
  * @param[out] dest destination vector
  */
 CGLM_INLINE
@@ -183,33 +177,11 @@ glm_vec_add(vec3 v1, vec3 v2, vec3 dest) {
   dest[2] = v1[2] + v2[2];
 }
 
-/*!
- * @brief add v2 vector to v1 vector store result in dest
- *
- * @param[in]  v1
- * @param[in]  v2
- * @param[out] dest destination vector
- */
-CGLM_INLINE
-void
-glm_vec4_add(vec4 v1, vec4 v2, vec4 dest) {
-#if defined( __SSE__ ) || defined( __SSE2__ )
-  _mm_store_ps(dest,
-               _mm_add_ps(_mm_load_ps(v1),
-                          _mm_load_ps(v2)));
-#else
-  dest[0] = v1[0] + v2[0];
-  dest[1] = v1[1] + v2[1];
-  dest[2] = v1[2] + v2[2];
-  dest[3] = v1[3] + v2[3];
-#endif
-}
-
 /*!
  * @brief subtract v2 vector from v1 vector store result in dest
  *
- * @param[in]  v1
- * @param[in]  v2
+ * @param[in]  v1 vector1
+ * @param[in]  v2 vector2
  * @param[out] dest destination vector
  */
 CGLM_INLINE
@@ -221,29 +193,7 @@ glm_vec_sub(vec3 v1, vec3 v2, vec3 dest) {
 }
 
 /*!
- * @brief subtract v2 vector from v1 vector store result in dest
- *
- * @param[in]  v1
- * @param[in]  v2
- * @param[out] dest destination vector
- */
-CGLM_INLINE
-void
-glm_vec4_sub(vec4 v1, vec4 v2, vec4 dest) {
-#if defined( __SSE__ ) || defined( __SSE2__ )
-  _mm_store_ps(dest,
-               _mm_sub_ps(_mm_load_ps(v1),
-                          _mm_load_ps(v2)));
-#else
-  dest[0] = v1[0] - v2[0];
-  dest[1] = v1[1] - v2[1];
-  dest[2] = v1[2] - v2[2];
-  dest[3] = v1[3] - v2[3];
-#endif
-}
-
-/*!
- * @brief multiply vec3 vector with scalar
+ * @brief multiply/scale vec3 vector with scalar: result = v * s
  *
  * @param[in]  v    vector
  * @param[in]  s    scalar
@@ -258,7 +208,7 @@ glm_vec_scale(vec3 v, float s, vec3 dest) {
 }
 
 /*!
- * @brief flip sign of all vec3 members
+ * @brief make vec3 vector scale as specified: result = unit(v) * s
  *
  * @param[in]  v    vector
  * @param[in]  s    scalar
@@ -266,6 +216,25 @@ glm_vec_scale(vec3 v, float s, vec3 dest) {
  */
 CGLM_INLINE
 void
+glm_vec_scale_as(vec3 v, float s, vec3 dest) {
+  float norm;
+  norm = glm_vec_norm(v);
+
+  if (norm == 0) {
+    glm_vec_copy(v, dest);
+    return;
+  }
+
+  glm_vec_scale(v, s / norm, dest);
+}
+
+/*!
+ * @brief flip sign of all vec3 members
+ *
+ * @param[in, out]  v  vector
+ */
+CGLM_INLINE
+void
 glm_vec_flipsign(vec3 v) {
   v[0] = -v[0];
   v[1] = -v[1];
@@ -273,46 +242,27 @@ glm_vec_flipsign(vec3 v) {
 }
 
 /*!
- * @brief flip sign of all vec4 members
+ * @brief make vector as inverse/opposite of itself
  *
- * @param[in]  v    vector
- * @param[in]  s    scalar
- * @param[out] dest destination vector
+ * @param[in, out]  v  vector
  */
 CGLM_INLINE
 void
-glm_vec4_flipsign(vec4 v) {
-#if defined( __SSE__ ) || defined( __SSE2__ )
-  _mm_store_ps(v, _mm_xor_ps(_mm_load_ps(v),
-                             _mm_set1_ps(-0.0f)));
-#else
-  v[0] = -v[0];
-  v[1] = -v[1];
-  v[2] = -v[2];
-  v[3] = -v[3];
-#endif
+glm_vec_inv(vec3 v) {
+  glm_vec_flipsign(v);
 }
 
 /*!
- * @brief multiply vec4 vector with scalar
+ * @brief inverse/opposite vector
  *
- * @param[in]  v    vector
- * @param[in]  s    scalar
- * @param[out] dest destination vector
+ * @param[in]  v    source
+ * @param[out] dest destination
  */
 CGLM_INLINE
 void
-glm_vec4_scale(vec4 v, float s, vec4 dest) {
-#if defined( __SSE__ ) || defined( __SSE2__ )
-  _mm_store_ps(dest,
-               _mm_mul_ps(_mm_load_ps(v),
-                          _mm_set1_ps(s)));
-#else
-  dest[0] = v[0] * s;
-  dest[1] = v[1] * s;
-  dest[2] = v[2] * s;
-  dest[3] = v[3] * s;
-#endif
+glm_vec_inv_to(vec3 v, vec3 dest) {
+  glm_vec_copy(v, dest);
+  glm_vec_flipsign(dest);
 }
 
 /*!
@@ -335,26 +285,6 @@ glm_vec_normalize(vec3 v) {
   glm_vec_scale(v, 1.0f / norm, v);
 }
 
-/*!
- * @brief normalize vec4 and store result in same vec
- *
- * @param[in, out] v vector
- */
-CGLM_INLINE
-void
-glm_vec4_normalize(vec4 v) {
-  float norm;
-
-  norm = glm_vec4_norm(v);
-
-  if (norm == 0.0f) {
-    v[0] = v[1] = v[2] = v[3] = 0.0f;
-    return;
-  }
-
-  glm_vec4_scale(v, 1.0f / norm, v);
-}
-
 /*!
  * @brief normalize vec3 to dest
  *
@@ -376,37 +306,19 @@ glm_vec_normalize_to(vec3 vec, vec3 dest) {
   glm_vec_scale(vec, 1.0f / norm, dest);
 }
 
-/*!
- * @brief normalize vec4 to dest
- *
- * @param[in]  vec  source
- * @param[out] dest destination
- */
-CGLM_INLINE
-void
-glm_vec4_normalize_to(vec4 vec, vec4 dest) {
-  float norm;
-
-  norm = glm_vec4_norm(vec);
-
-  if (norm == 0.0f) {
-    dest[0] = dest[1] = dest[2] = dest[3] = 0.0f;
-    return;
-  }
-
-  glm_vec4_scale(vec, 1.0f / norm, dest);
-}
-
 /*!
  * @brief angle betwen two vector
  *
+ * @param[in] v1  vector1
+ * @param[in] v2  vector2
+ *
  * @return angle as radians
  */
 CGLM_INLINE
 float
 glm_vec_angle(vec3 v1, vec3 v2) {
   float norm;
-  
+
   /* maybe compiler generate approximation instruction (rcp) */
   norm = 1.0f / (glm_vec_norm(v1) * glm_vec_norm(v2));
   return acosf(glm_vec_dot(v1, v2) * norm);
@@ -475,14 +387,14 @@ glm_vec_rotate_m4(mat4 m, vec3 v, vec3 dest) {
   res[1] = x[1] * v[0] + y[1] * v[1] + z[1] * v[2];
   res[2] = x[2] * v[0] + y[2] * v[1] + z[2] * v[2];
 
-  glm_vec_dup(res, dest);
+  glm_vec_copy(res, dest);
 }
 
 /*!
  * @brief project a vector onto b vector
  *
- * @param[in]  a
- * @param[in]  b
+ * @param[in]  a vector1
+ * @param[in]  b vector2
  * @param[out] dest projected vector
  */
 CGLM_INLINE
@@ -493,4 +405,135 @@ glm_vec_proj(vec3 a, vec3 b, vec3 dest) {
                 dest);
 }
 
-#endif /* cglm_vec_h */
+/**
+ * @brief find center point of two vector
+ *
+ * @param[in]  v1 vector1
+ * @param[in]  v2 vector2
+ * @param[out] dest center point
+ */
+CGLM_INLINE
+void
+glm_vec_center(vec3 v1, vec3 v2, vec3 dest) {
+  glm_vec_add(v1, v2, dest);
+  glm_vec_scale(dest, 0.5f, dest);
+}
+
+/**
+ * @brief distance between two vectors
+ *
+ * @param[in] v1 vector1
+ * @param[in] v2 vector2
+ * @return returns distance
+ */
+CGLM_INLINE
+float
+glm_vec_distance(vec3 v1, vec3 v2) {
+  return sqrtf(glm_pow2(v2[0] - v1[0])
+             + glm_pow2(v2[1] - v1[1])
+             + glm_pow2(v2[2] - v1[2]));
+}
+
+/*!
+ * @brief max values of vectors
+ *
+ * @param[in]  v1   vector1
+ * @param[in]  v2   vector2
+ * @param[out] dest destination
+ */
+CGLM_INLINE
+void
+glm_vec_maxv(vec3 v1, vec3 v2, vec3 dest) {
+  dest[0] = glm_max(v1[0], v2[0]);
+  dest[1] = glm_max(v1[1], v2[1]);
+  dest[2] = glm_max(v1[2], v2[2]);
+}
+
+/*!
+ * @brief min values of vectors
+ *
+ * @param[in]  v1   vector1
+ * @param[in]  v2   vector2
+ * @param[out] dest destination
+ */
+CGLM_INLINE
+void
+glm_vec_minv(vec3 v1, vec3 v2, vec3 dest) {
+  dest[0] = glm_min(v1[0], v2[0]);
+  dest[1] = glm_min(v1[1], v2[1]);
+  dest[2] = glm_min(v1[2], v2[2]);
+}
+
+/*!
+ * @brief possible orthogonal/perpendicular vector
+ *
+ * @param[in]  v    vector
+ * @param[out] dest orthogonal/perpendicular vector
+ */
+CGLM_INLINE
+void
+glm_vec_ortho(vec3 v, vec3 dest) {
+  dest[0] = v[1] - v[2];
+  dest[1] = v[2] - v[0];
+  dest[2] = v[0] - v[1];
+}
+
+/*!
+ * @brief vec3 cross product
+ *
+ * this is just convenient wrapper
+ *
+ * @param[in]  a source 1
+ * @param[in]  b source 2
+ * @param[out] d destination
+ */
+CGLM_INLINE
+void
+glm_cross(vec3 a, vec3 b, vec3 d) {
+  glm_vec_cross(a, b, d);
+}
+
+/*!
+ * @brief vec3 dot product
+ *
+ * this is just convenient wrapper
+ *
+ * @param[in] a vector1
+ * @param[in] b vector2
+ *
+ * @return dot product
+ */
+CGLM_INLINE
+float
+glm_dot(vec3 a, vec3 b) {
+  return glm_vec_dot(a, b);
+}
+
+/*!
+ * @brief normalize vec3 and store result in same vec
+ *
+ * this is just convenient wrapper
+ *
+ * @param[in, out] v vector
+ */
+CGLM_INLINE
+void
+glm_normalize(vec3 v) {
+  glm_vec_normalize(v);
+}
+
+/*!
+ * @brief normalize vec3 to dest
+ *
+ * this is just convenient wrapper
+ *
+ * @param[in]  v    source
+ * @param[out] dest destination
+ */
+CGLM_INLINE
+void
+glm_normalize_to(vec3 v, vec3 dest) {
+  glm_vec_normalize_to(v, dest);
+}
+
+#endif /* cglm_vec3_h */

include/cglm/vec4-ext.h

@@ -0,0 +1,178 @@
+/*
+ * Copyright (c), Recep Aslantas.
+ *
+ * MIT License (MIT), http://opensource.org/licenses/MIT
+ * Full license can be found in the LICENSE file
+ */
+
+/*!
+ * @brief SIMD like functions
+ */
+
+/*
+ Functions:
+   CGLM_INLINE void  glm_vec4_mulv(vec4 a, vec4 b, vec4 d);
+   CGLM_INLINE void  glm_vec4_broadcast(float val, vec4 d);
+   CGLM_INLINE bool  glm_vec4_eq(vec4 v, float val);
+   CGLM_INLINE bool  glm_vec4_eq_eps(vec4 v, float val);
+   CGLM_INLINE bool  glm_vec4_eq_all(vec4 v);
+   CGLM_INLINE bool  glm_vec4_eqv(vec4 v1, vec4 v2);
+   CGLM_INLINE bool  glm_vec4_eqv_eps(vec4 v1, vec4 v2);
+   CGLM_INLINE float glm_vec4_max(vec4 v);
+   CGLM_INLINE float glm_vec4_min(vec4 v);
+ */
+
+#ifndef cglm_vec4_ext_h
+#define cglm_vec4_ext_h
+
+#include "common.h"
+#include "vec3-ext.h"
+#include <stdbool.h>
+#include <math.h>
+#include <float.h>
+
+/*!
+ * @brief multiplies individual items, just for convenient like SIMD
+ *
+ * @param a v1
+ * @param b v2
+ * @param d v3 = (v1[0] * v2[0],  v1[1] * v2[1], v1[2] * v2[2], v1[3] * v2[3])
+ */
+CGLM_INLINE
+void
+glm_vec4_mulv(vec4 a, vec4 b, vec4 d) {
+#if defined( __SSE__ ) || defined( __SSE2__ )
+  _mm_store_ps(d, _mm_mul_ps(_mm_load_ps(a), _mm_load_ps(b)));
+#else
+  d[0] = a[0] * b[0];
+  d[1] = a[1] * b[1];
+  d[2] = a[2] * b[2];
+  d[3] = a[3] * b[3];
+#endif
+}
+
+/*!
+ * @brief fill a vector with specified value
+ *
+ * @param val value
+ * @param d   dest
+ */
+CGLM_INLINE
+void
+glm_vec4_broadcast(float val, vec4 d) {
+#if defined( __SSE__ ) || defined( __SSE2__ )
+  _mm_store_ps(d, _mm_set1_ps(val));
+#else
+  d[0] = d[1] = d[2] = d[3] = val;
+#endif
+}
+
+/*!
+ * @brief check if vector is equal to value (without epsilon)
+ *
+ * @param v   vector
+ * @param val value
+ */
+CGLM_INLINE
+bool
+glm_vec4_eq(vec4 v, float val) {
+  return v[0] == val
+         && v[0] == v[1]
+         && v[0] == v[2]
+         && v[0] == v[3];
+}
+
+/*!
+ * @brief check if vector is equal to value (with epsilon)
+ *
+ * @param v   vector
+ * @param val value
+ */
+CGLM_INLINE
+bool
+glm_vec4_eq_eps(vec4 v, float val) {
+  return fabsf(v[0] - val) <= FLT_EPSILON
+         && fabsf(v[1] - val) <= FLT_EPSILON
+         && fabsf(v[2] - val) <= FLT_EPSILON
+         && fabsf(v[3] - val) <= FLT_EPSILON;
+}
+
+/*!
+ * @brief check if vectors members are equal (without epsilon)
+ *
+ * @param v   vector
+ */
+CGLM_INLINE
+bool
+glm_vec4_eq_all(vec4 v) {
+  return v[0] == v[1]
+         && v[0] == v[2]
+         && v[0] == v[3];
+}
+
+/*!
+ * @brief check if vector is equal to another (without epsilon)
+ *
+ * @param v1 vector
+ * @param v2 vector
+ */
+CGLM_INLINE
+bool
+glm_vec4_eqv(vec4 v1, vec4 v2) {
+  return v1[0] == v2[0]
+         && v1[1] == v2[1]
+         && v1[2] == v2[2]
+         && v1[3] == v2[3];
+}
+
+/*!
+ * @brief check if vector is equal to another (with epsilon)
+ *
+ * @param v1 vector
+ * @param v2 vector
+ */
+CGLM_INLINE
+bool
+glm_vec4_eqv_eps(vec4 v1, vec4 v2) {
+  return fabsf(v1[0] - v2[0]) <= FLT_EPSILON
+         && fabsf(v1[1] - v2[1]) <= FLT_EPSILON
+         && fabsf(v1[2] - v2[2]) <= FLT_EPSILON
+         && fabsf(v1[3] - v2[3]) <= FLT_EPSILON;
+}
+
+/*!
+ * @brief max value of vector
+ *
+ * @param v vector
+ */
+CGLM_INLINE
+float
+glm_vec4_max(vec4 v) {
+  float max;
+
+  max = glm_vec_max(v);
+  if (v[3] > max)
+    max = v[3];
+
+  return max;
+}
+
+/*!
+ * @brief min value of vector
+ *
+ * @param v vector
+ */
+CGLM_INLINE
+float
+glm_vec4_min(vec4 v) {
+  float min;
+
+  min = glm_vec_min(v);
+  if (v[3] < min)
+    min = v[3];
+
+  return min;
+}
+
+#endif /* cglm_vec4_ext_h */
+

include/cglm/vec4.h

@@ -0,0 +1,376 @@
+/*
+ * Copyright (c), Recep Aslantas.
+ *
+ * MIT License (MIT), http://opensource.org/licenses/MIT
+ * Full license can be found in the LICENSE file
+ */
+
+/*!
+ * vec3 functions dont have suffix e.g glm_vec_dot (not glm_vec3_dot)
+ * all functions without suffix are vec3 functions
+ */
+
+/*
+ Macros:
+   glm_vec4_dup3(v, dest)
+   glm_vec4_dup(v, dest)
+   GLM_VEC4_ONE_INIT
+   GLM_VEC4_BLACK_INIT
+   GLM_VEC4_ZERO_INIT
+   GLM_VEC4_ONE
+   GLM_VEC4_BLACK
+   GLM_VEC4_ZERO
+
+ Functions:
+   CGLM_INLINE void  glm_vec4(vec3 v3, float last, vec4 dest);
+   CGLM_INLINE void  glm_vec4_copy3(vec4 a, vec3 dest);
+   CGLM_INLINE void  glm_vec4_copy(vec4 v, vec4 dest);
+   CGLM_INLINE float glm_vec4_dot(vec4 a, vec4 b);
+   CGLM_INLINE float glm_vec4_norm2(vec4 v);
+   CGLM_INLINE float glm_vec4_norm(vec4 vec);
+   CGLM_INLINE void  glm_vec4_add(vec4 v1, vec4 v2, vec4 dest);
+   CGLM_INLINE void  glm_vec4_sub(vec4 v1, vec4 v2, vec4 dest);
+   CGLM_INLINE void  glm_vec4_scale(vec4 v, float s, vec4 dest);
+   CGLM_INLINE void  glm_vec4_scale_as(vec4 v, float s, vec4 dest);
+   CGLM_INLINE void  glm_vec4_flipsign(vec4 v);
+   CGLM_INLINE void  glm_vec4_inv(vec4 v);
+   CGLM_INLINE void  glm_vec4_inv_to(vec4 v, vec4 dest);
+   CGLM_INLINE void  glm_vec4_normalize(vec4 v);
+   CGLM_INLINE void  glm_vec4_normalize_to(vec4 vec, vec4 dest);
+   CGLM_INLINE float glm_vec4_distance(vec4 v1, vec4 v2);
+   CGLM_INLINE void  glm_vec4_maxv(vec4 v1, vec4 v2, vec4 dest);
+   CGLM_INLINE void  glm_vec4_minv(vec4 v1, vec4 v2, vec4 dest);
+ */
+
+#ifndef cglm_vec4_h
+#define cglm_vec4_h
+
+#include "common.h"
+#include "vec4-ext.h"
+#include "util.h"
+
+/* DEPRECATED! use _copy, _ucopy versions */
+#define glm_vec4_dup3(v, dest) glm_vec4_copy3(v, dest)
+#define glm_vec4_dup(v, dest)  glm_vec4_copy(v, dest)
+
+#define GLM_VEC4_ONE_INIT   {1.0f, 1.0f, 1.0f, 1.0f}
+#define GLM_VEC4_BLACK_INIT {0.0f, 0.0f, 0.0f, 1.0f}
+#define GLM_VEC4_ZERO_INIT  {0.0f, 0.0f, 0.0f, 0.0f}
+
+#define GLM_VEC4_ONE        ((vec4)GLM_VEC4_ONE_INIT)
+#define GLM_VEC4_BLACK      ((vec4)GLM_VEC4_BLACK_INIT)
+#define GLM_VEC4_ZERO       ((vec4)GLM_VEC4_ZERO_INIT)
+
+/*!
+ * @brief init vec4 using vec3
+ *
+ * @param[in]  v3   vector3
+ * @param[in]  last last item
+ * @param[out] dest destination
+ */
+CGLM_INLINE
+void
+glm_vec4(vec3 v3, float last, vec4 dest) {
+  dest[0] = v3[0];
+  dest[1] = v3[1];
+  dest[2] = v3[2];
+  dest[3] = last;
+}
+
+/*!
+ * @brief copy first 3 members of [a] to [dest]
+ *
+ * @param[in]  a    source
+ * @param[out] dest destination
+ */
+CGLM_INLINE
+void
+glm_vec4_copy3(vec4 a, vec3 dest) {
+  dest[0] = a[0];
+  dest[1] = a[1];
+  dest[2] = a[2];
+}
+
+/*!
+ * @brief copy all members of [a] to [dest]
+ *
+ * @param[in]  v    source
+ * @param[out] dest destination
+ */
+CGLM_INLINE
+void
+glm_vec4_copy(vec4 v, vec4 dest) {
+#if defined( __SSE__ ) || defined( __SSE2__ )
+  _mm_store_ps(dest, _mm_load_ps(v));
+#else
+  dest[0] = v[0];
+  dest[1] = v[1];
+  dest[2] = v[2];
+  dest[3] = v[3];
+#endif
+}
+
+/*!
+ * @brief vec4 dot product
+ *
+ * @param[in] a vector1
+ * @param[in] b vector2
+ *
+ * @return dot product
+ */
+CGLM_INLINE
+float
+glm_vec4_dot(vec4 a, vec4 b) {
+  return a[0] * b[0] + a[1] * b[1] + a[2] * b[2] + a[3] * b[3];
+}
+
+/*!
+ * @brief norm * norm (magnitude) of vec
+ *
+ * we can use this func instead of calling norm * norm, because it would call
+ * sqrtf fuction twice but with this func we can avoid func call, maybe this is
+ * not good name for this func
+ *
+ * @param[in] v vec4
+ *
+ * @return norm * norm
+ */
+CGLM_INLINE
+float
+glm_vec4_norm2(vec4 v) {
+  return v[0] * v[0] + v[1] * v[1] + v[2] * v[2] + v[3] * v[3];
+}
+
+/*!
+ * @brief norm (magnitude) of vec4
+ *
+ * @param[in] vec vector
+ *
+ * @return norm
+ */
+CGLM_INLINE
+float
+glm_vec4_norm(vec4 vec) {
+  return sqrtf(glm_vec4_norm2(vec));
+}
+
+/*!
+ * @brief add v2 vector to v1 vector store result in dest
+ *
+ * @param[in]  v1 vector1
+ * @param[in]  v2 vector2
+ * @param[out] dest destination vector
+ */
+CGLM_INLINE
+void
+glm_vec4_add(vec4 v1, vec4 v2, vec4 dest) {
+#if defined( __SSE__ ) || defined( __SSE2__ )
+  _mm_store_ps(dest,
+               _mm_add_ps(_mm_load_ps(v1),
+                          _mm_load_ps(v2)));
+#else
+  dest[0] = v1[0] + v2[0];
+  dest[1] = v1[1] + v2[1];
+  dest[2] = v1[2] + v2[2];
+  dest[3] = v1[3] + v2[3];
+#endif
+}
+
+/*!
+ * @brief subtract v2 vector from v1 vector store result in dest
+ *
+ * @param[in]  v1 vector1
+ * @param[in]  v2 vector2
+ * @param[out] dest destination vector
+ */
+CGLM_INLINE
+void
+glm_vec4_sub(vec4 v1, vec4 v2, vec4 dest) {
+#if defined( __SSE__ ) || defined( __SSE2__ )
+  _mm_store_ps(dest,
+               _mm_sub_ps(_mm_load_ps(v1),
+                          _mm_load_ps(v2)));
+#else
+  dest[0] = v1[0] - v2[0];
+  dest[1] = v1[1] - v2[1];
+  dest[2] = v1[2] - v2[2];
+  dest[3] = v1[3] - v2[3];
+#endif
+}
+
+/*!
+ * @brief multiply/scale vec4 vector with scalar: result = v * s
+ *
+ * @param[in]  v    vector
+ * @param[in]  s    scalar
+ * @param[out] dest destination vector
+ */
+CGLM_INLINE
+void
+glm_vec4_scale(vec4 v, float s, vec4 dest) {
+#if defined( __SSE__ ) || defined( __SSE2__ )
+  _mm_store_ps(dest,
+               _mm_mul_ps(_mm_load_ps(v),
+                          _mm_set1_ps(s)));
+#else
+  dest[0] = v[0] * s;
+  dest[1] = v[1] * s;
+  dest[2] = v[2] * s;
+  dest[3] = v[3] * s;
+#endif
+}
+
+/*!
+ * @brief make vec4 vector scale as specified: result = unit(v) * s
+ *
+ * @param[in]  v    vector
+ * @param[in]  s    scalar
+ * @param[out] dest destination vector
+ */
+CGLM_INLINE
+void
+glm_vec4_scale_as(vec4 v, float s, vec4 dest) {
+  float norm;
+  norm = glm_vec4_norm(v);
+
+  if (norm == 0) {
+    glm_vec4_copy(v, dest);
+    return;
+  }
+
+  glm_vec4_scale(v, s / norm, dest);
+}
+
+/*!
+ * @brief flip sign of all vec4 members
+ *
+ * @param[in, out]  v  vector
+ */
+CGLM_INLINE
+void
+glm_vec4_flipsign(vec4 v) {
+#if defined( __SSE__ ) || defined( __SSE2__ )
+  _mm_store_ps(v, _mm_xor_ps(_mm_load_ps(v),
+                             _mm_set1_ps(-0.0f)));
+#else
+  v[0] = -v[0];
+  v[1] = -v[1];
+  v[2] = -v[2];
+  v[3] = -v[3];
+#endif
+}
+
+/*!
+ * @brief make vector as inverse/opposite of itself
+ *
+ * @param[in, out]  v  vector
+ */
+CGLM_INLINE
+void
+glm_vec4_inv(vec4 v) {
+  glm_vec4_flipsign(v);
+}
+
+/*!
+ * @brief inverse/opposite vector
+ *
+ * @param[in]  v    source
+ * @param[out] dest destination
+ */
+CGLM_INLINE
+void
+glm_vec4_inv_to(vec4 v, vec4 dest) {
+  glm_vec4_copy(v, dest);
+  glm_vec4_flipsign(dest);
+}
+
+/*!
+ * @brief normalize vec4 and store result in same vec
+ *
+ * @param[in, out] v vector
+ */
+CGLM_INLINE
+void
+glm_vec4_normalize(vec4 v) {
+  float norm;
+
+  norm = glm_vec4_norm(v);
+
+  if (norm == 0.0f) {
+    v[0] = v[1] = v[2] = v[3] = 0.0f;
+    return;
+  }
+
+  glm_vec4_scale(v, 1.0f / norm, v);
+}
+
+/*!
+ * @brief normalize vec4 to dest
+ *
+ * @param[in]  vec  source
+ * @param[out] dest destination
+ */
+CGLM_INLINE
+void
+glm_vec4_normalize_to(vec4 vec, vec4 dest) {
+  float norm;
+
+  norm = glm_vec4_norm(vec);
+
+  if (norm == 0.0f) {
+    dest[0] = dest[1] = dest[2] = dest[3] = 0.0f;
+    return;
+  }
+
+  glm_vec4_scale(vec, 1.0f / norm, dest);
+}
+
+/**
+ * @brief distance between two vectors
+ *
+ * @param[in] v1 vector1
+ * @param[in] v2 vector2
+ * @return returns distance
+ */
+CGLM_INLINE
+float
+glm_vec4_distance(vec4 v1, vec4 v2) {
+  return sqrtf(glm_pow2(v2[0] - v1[0])
+             + glm_pow2(v2[1] - v1[1])
+             + glm_pow2(v2[2] - v1[2])
+             + glm_pow2(v2[3] - v1[3]));
+}
+
+/*!
+ * @brief max values of vectors
+ *
+ * @param[in]  v1   vector1
+ * @param[in]  v2   vector2
+ * @param[out] dest destination
+ */
+CGLM_INLINE
+void
+glm_vec4_maxv(vec4 v1, vec4 v2, vec4 dest) {
+  dest[0] = glm_max(v1[0], v2[0]);
+  dest[1] = glm_max(v1[1], v2[1]);
+  dest[2] = glm_max(v1[2], v2[2]);
+  dest[3] = glm_max(v1[3], v2[3]);
+}
+
+/*!
+ * @brief min values of vectors
+ *
+ * @param[in]  v1   vector1
+ * @param[in]  v2   vector2
+ * @param[out] dest destination
+ */
+CGLM_INLINE
+void
+glm_vec4_minv(vec4 v1, vec4 v2, vec4 dest) {
+  dest[0] = glm_min(v1[0], v2[0]);
+  dest[1] = glm_min(v1[1], v2[1]);
+  dest[2] = glm_min(v1[2], v2[2]);
+  dest[3] = glm_min(v1[3], v2[3]);
+}
+
+#endif /* cglm_vec4_h */

include/cglm/version.h

@@ -0,0 +1,15 @@
+/*
+ * Copyright (c), Recep Aslantas.
+ *
+ * MIT License (MIT), http://opensource.org/licenses/MIT
+ * Full license can be found in the LICENSE file
+ */
+
+#ifndef cglm_version_h
+#define cglm_version_h
+
+#define CGLM_VERSION_MAJOR 0
+#define CGLM_VERSION_MINOR 3
+#define CGLM_VERSION_PATCH 4
+
+#endif /* cglm_version_h */

makefile.am

@@ -13,49 +13,98 @@ AM_CFLAGS = -Wall \
             -O3 \
             -Wstrict-aliasing=2 \
             -fstrict-aliasing \
-            -Wpedantic
+            -pedantic
 
 lib_LTLIBRARIES = libcglm.la
 libcglm_la_LDFLAGS = -no-undefined -version-info 0:1:0
 
-nobase_include_HEADERS = include/cglm.h \
-                         include/cglm-call.h \
-                         include/cglm-cam.h \
-                         include/cglm-io.h \
-                         include/cglm-mat3.h \
-                         include/cglm-types.h \
-                         include/cglm-common.h \
-                         include/cglm-affine.h \
-                         include/cglm-vec.h \
-                         include/cglm-euler.h \
-                         include/cglm-util.h \
-                         include/cglm-quat.h \
-                         include/cglm-mat.h \
-                         include/cglm-affine-mat.h \
-                         include/cglm-platform.h \
-                         include/cglm-opengl.h \
-                         include/arch/simd/cglm-mat-simd-avx.h \
-                         include/arch/simd/cglm-affine-mat-avx.h \
-                         include/arch/simd/cglm-quat-simd.h \
-                         include/arch/simd/cglm-affine-mat-sse2.h \
-                         include/arch/simd/cglm-mat3-simd-sse2.h \
-                         include/arch/simd/cglm-mat-simd-sse2.h \
-                         include/arch/simd/cglm-intrin.h \
-                         include/call/cglmc-euler.h \
-                         include/call/cglmc-quat.h \
-                         include/call/cglmc-cam.h \
-                         include/call/cglmc-io.h \
-                         include/call/cglmc-affine.h \
-                         include/call/cglmc-vec.h \
-                         include/call/cglmc-mat3.h \
-                         include/call/cglmc-mat.h
+checkLDFLAGS = -L./.libs \
+               -L./test/lib/cmocka/build/src \
+               -lcmocka \
+               -lm \
+               -lcglm
+checkCFLAGS = -I./test/lib/cmocka/include \
+              -I./include
+
+check_PROGRAMS = test/tests
+TESTS = $(check_PROGRAMS)
+
+test_tests_LDFLAGS = $(checkLDFLAGS)
+test_tests_CFLAGS  = $(checkCFLAGS)
+
+cglmdir=$(includedir)/cglm
+cglm_HEADERS = include/cglm/version.h \
+                  include/cglm/cglm.h \
+                  include/cglm/call.h \
+                  include/cglm/cam.h \
+                  include/cglm/io.h \
+                  include/cglm/mat4.h \
+                  include/cglm/mat3.h \
+                  include/cglm/types.h \
+                  include/cglm/common.h \
+                  include/cglm/affine.h \
+                  include/cglm/vec3.h \
+                  include/cglm/vec3-ext.h \
+                  include/cglm/vec4.h \
+                  include/cglm/vec4-ext.h \
+                  include/cglm/euler.h \
+                  include/cglm/util.h \
+                  include/cglm/quat.h \
+                  include/cglm/affine-mat.h \
+                  include/cglm/plane.h \
+                  include/cglm/frustum.h \
+                  include/cglm/box.h \
+                  include/cglm/color.h
+
+cglm_calldir=$(includedir)/cglm/call
+cglm_call_HEADERS = include/cglm/call/mat4.h \
+                    include/cglm/call/mat3.h \
+                    include/cglm/call/vec3.h \
+                    include/cglm/call/vec4.h \
+                    include/cglm/call/affine.h \
+                    include/cglm/call/io.h \
+                    include/cglm/call/cam.h \
+                    include/cglm/call/quat.h \
+                    include/cglm/call/euler.h \
+                    include/cglm/call/plane.h \
+                    include/cglm/call/frustum.h \
+                    include/cglm/call/box.h
+
+cglm_simddir=$(includedir)/cglm/simd
+cglm_simd_HEADERS = include/cglm/simd/intrin.h
+
+cglm_simd_sse2dir=$(includedir)/cglm/simd/sse2
+cglm_simd_sse2_HEADERS = include/cglm/simd/sse2/affine.h \
+                         include/cglm/simd/sse2/mat4.h \
+                         include/cglm/simd/sse2/mat3.h \
+                         include/cglm/simd/sse2/quat.h
+
+cglm_simd_avxdir=$(includedir)/cglm/simd/avx
+cglm_simd_avx_HEADERS = include/cglm/simd/avx/mat4.h \
+                        include/cglm/simd/avx/affine.h
+
+cglm_simd_neondir=$(includedir)/cglm/simd/neon
+cglm_simd_neon_HEADERS = include/cglm/simd/neon/mat4.h
 
 libcglm_la_SOURCES=\
-    src/cglm-euler.c \
-    src/clgm-affine.c \
-    src/cglm-io.c \
-    src/cglm-quat.c \
-    src/cglm-cam.c \
-    src/cglm-vec.c \
-    src/cglm-mat3.c \
-    src/cglm-mat.c
+    src/euler.c \
+    src/affine.c \
+    src/io.c \
+    src/quat.c \
+    src/cam.c \
+    src/vec3.c \
+    src/vec4.c \
+    src/mat3.c \
+    src/mat4.c \
+    src/plane.c \
+    src/frustum.c \
+    src/box.c
+
+test_tests_SOURCES=\
+    test/src/test_common.c \
+    test/src/test_main.c \
+    test/src/test_mat4.c \
+    test/src/test_cam.c
+
+all-local:
+	sh ./post-build.sh

post-build.sh

@@ -0,0 +1,19 @@
+#! /bin/sh
+#
+# Copyright (c), Recep Aslantas.
+#
+# MIT License (MIT), http://opensource.org/licenses/MIT
+# Full license can be found in the LICENSE file
+#
+
+cd $(dirname "$0")
+
+mkdir -p .libs
+
+if [ "$(uname)" = "Darwin" ]; then
+  ln -sf $(pwd)/test/lib/cmocka/build/src/libcmocka.0.dylib \
+      .libs/libcmocka.0.dylib;
+else
+  ln -sf $(pwd)/test/lib/cmocka/build/src/libcmocka.so.0 \
+      .libs/libcmocka.so.0;
+fi

src/affine.c

@@ -5,7 +5,8 @@
  * Full license can be found in the LICENSE file
  */
 
-#include "../include/cglm.h"
+#include "../include/cglm/cglm.h"
+#include "../include/cglm/call.h"
 
 CGLM_EXPORT
 void

src/box.c

@@ -0,0 +1,36 @@
+/*
+ * Copyright (c), Recep Aslantas.
+ *
+ * MIT License (MIT), http://opensource.org/licenses/MIT
+ * Full license can be found in the LICENSE file
+ */
+
+#include "../include/cglm/cglm.h"
+#include "../include/cglm/call.h"
+
+CGLM_EXPORT
+void
+glmc_aabb_transform(vec3 box[2], mat4 m, vec3 dest[2]) {
+  glm_aabb_transform(box, m, dest);
+}
+
+CGLM_EXPORT
+void
+glmc_aabb_merge(vec3 box1[2], vec3 box2[2], vec3 dest[2]) {
+  glm_aabb_merge(box1, box2, dest);
+}
+
+CGLM_EXPORT
+void
+glmc_aabb_crop(vec3 box[2], vec3 cropBox[2], vec3 dest[2]) {
+  glm_aabb_crop(box, cropBox, dest);
+}
+
+CGLM_EXPORT
+void
+glmc_aabb_crop_until(vec3 box[2],
+                     vec3 cropBox[2],
+                     vec3 clampBox[2],
+                     vec3 dest[2]) {
+  glm_aabb_crop_until(box, cropBox, clampBox, dest);
+}

src/cam.c

@@ -5,7 +5,8 @@
  * Full license can be found in the LICENSE file
  */
 
-#include "../include/cglm.h"
+#include "../include/cglm/cglm.h"
+#include "../include/cglm/call.h"
 
 CGLM_EXPORT
 void
@@ -65,3 +66,15 @@ glmc_lookat(vec3 eye,
             mat4 dest) {
   glm_lookat(eye, center, up, dest);
 }
+
+CGLM_EXPORT
+void
+glmc_look(vec3 eye, vec3 dir, vec3 up, mat4 dest) {
+  glm_look(eye, dir, up, dest);
+}
+
+CGLM_EXPORT
+void
+glmc_look_anyup(vec3 eye, vec3 dir, mat4 dest) {
+  glm_look_anyup(eye, dir, dest);
+}

src/config.h

@@ -0,0 +1,22 @@
+/*
+* Copyright (c), Recep Aslantas.
+*
+* MIT License (MIT), http://opensource.org/licenses/MIT
+* Full license can be found in the LICENSE file
+*/
+
+#ifndef cglm__config__h_
+#define cglm__config__h_
+
+#if defined(_WIN32) || defined(WIN32)
+
+/* Exclude rarely-used stuff from Windows headers */
+#  define WIN32_LEAN_AND_MEAN 
+#  include <SDKDDKVer.h>
+
+/* Windows Header Files: */
+#  include <windows.h>
+
+#endif
+
+#endif /* cglm__config__h_ */

src/dllmain.c

@@ -0,0 +1,23 @@
+/*
+* Copyright (c), Recep Aslantas.
+*
+* MIT License (MIT), http://opensource.org/licenses/MIT
+* Full license can be found in the LICENSE file
+*/
+
+#include "config.h"
+
+BOOL
+APIENTRY
+DllMain(HMODULE hModule,
+	    DWORD   ul_reason_for_call,
+	    LPVOID  lpReserved) {
+	switch (ul_reason_for_call) {
+	case DLL_PROCESS_ATTACH:
+	case DLL_THREAD_ATTACH:
+	case DLL_THREAD_DETACH:
+	case DLL_PROCESS_DETACH:
+		break;
+	}
+	return TRUE;
+}

src/euler.c

@@ -5,7 +5,8 @@
  * Full license can be found in the LICENSE file
  */
 
-#include "../include/cglm.h"
+#include "../include/cglm/cglm.h"
+#include "../include/cglm/call.h"
 
 CGLM_EXPORT
 void

src/frustum.c

@@ -0,0 +1,42 @@
+/*
+ * Copyright (c), Recep Aslantas.
+ *
+ * MIT License (MIT), http://opensource.org/licenses/MIT
+ * Full license can be found in the LICENSE file
+ */
+
+#include "../include/cglm/cglm.h"
+#include "../include/cglm/call.h"
+
+CGLM_EXPORT
+void
+glmc_frustum_planes(mat4 m, vec4 dest[6]) {
+  glm_frustum_planes(m, dest);
+}
+
+CGLM_EXPORT
+void
+glmc_frustum_corners(mat4 invMat, vec4 dest[8]) {
+  glm_frustum_corners(invMat, dest);
+}
+
+CGLM_EXPORT
+void
+glmc_frustum_center(vec4 corners[8], vec4 dest) {
+  glm_frustum_center(corners, dest);
+}
+
+CGLM_EXPORT
+void
+glmc_frustum_box(vec4 corners[8], mat4 m, vec3 box[2]) {
+  glm_frustum_box(corners, m, box);
+}
+
+CGLM_EXPORT
+void
+glmc_frustum_corners_at(vec4  corners[8],
+                        float splitDist,
+                        float farDist,
+                        vec4  planeCorners[4]) {
+  glm_frustum_corners_at(corners, splitDist, farDist, planeCorners);
+}

src/io.c

@@ -5,7 +5,8 @@
  * Full license can be found in the LICENSE file
  */
 
-#include "../include/cglm.h"
+#include "../include/cglm/cglm.h"
+#include "../include/cglm/call.h"
 
 CGLM_EXPORT
 void

src/mat3.c

@@ -5,12 +5,19 @@
  * Full license can be found in the LICENSE file
  */
 
-#include "../include/cglm.h"
+#include "../include/cglm/cglm.h"
+#include "../include/cglm/call.h"
 
 CGLM_EXPORT
 void
-glmc_mat3_dup(mat3 mat, mat3 dest) {
-  glm_mat3_dup(mat, dest);
+glmc_mat3_copy(mat3 mat, mat3 dest) {
+  glm_mat3_copy(mat, dest);
+}
+
+CGLM_EXPORT
+void
+glmc_mat3_identity(mat3 mat) {
+  glm_mat3_identity(mat);
 }
 
 CGLM_EXPORT

src/mat4.c

@@ -5,18 +5,25 @@
  * Full license can be found in the LICENSE file
  */
 
-#include "../include/cglm.h"
+#include "../include/cglm/cglm.h"
+#include "../include/cglm/call.h"
 
 CGLM_EXPORT
 void
-glmc_mat4_udup(mat4 mat, mat4 dest) {
-  glm_mat4_dup(mat, dest);
+glmc_mat4_ucopy(mat4 mat, mat4 dest) {
+  glm_mat4_copy(mat, dest);
 }
 
 CGLM_EXPORT
 void
-glmc_mat4_dup(mat4 mat, mat4 dest) {
-  glm_mat4_dup(mat, dest);
+glmc_mat4_copy(mat4 mat, mat4 dest) {
+  glm_mat4_copy(mat, dest);
+}
+
+CGLM_EXPORT
+void
+glmc_mat4_identity(mat4 mat) {
+  glm_mat4_identity(mat);
 }
 
 CGLM_EXPORT

src/plane.c

@@ -0,0 +1,15 @@
+/*
+ * Copyright (c), Recep Aslantas.
+ *
+ * MIT License (MIT), http://opensource.org/licenses/MIT
+ * Full license can be found in the LICENSE file
+ */
+
+#include "../include/cglm/cglm.h"
+#include "../include/cglm/call.h"
+
+CGLM_EXPORT
+void
+glmc_plane_normalize(vec4 plane) {
+  glm_plane_normalize(plane);
+}