Troubleshooting

It is possible that sometimes you may get crashes or wrong results. Follow these topics

Memory Allocation:

Again, cglm doesn’t alloc any memory on heap. cglm functions works like memcpy; it copies data from src, makes calculations then copy the result to dest.

You are responsible for allocation of src and dest parameters.

Alignment:

vec4 and mat4 types requires 16 byte alignment. These types are marked with align attribute to let compiler know about this requirement.

But since MSVC (Windows) throws the error:

“formal parameter with requested alignment of 16 won’t be aligned”

The alignment attribute has been commented for MSVC

#if defined(_MSC_VER)
#  define CGLM_ALIGN(X) /* __declspec(align(X)) */
#else
#  define CGLM_ALIGN(X) __attribute((aligned(X)))
#endif.

So MSVC may not know about alignment requirements when creating variables. The interesting thing is that, if I remember correctly Visual Studio 2017 doesn’t throw the above error. So we may uncomment that line for Visual Studio 2017, you may do it yourself.

This MSVC issue is still in TODOs.

UPDATE: By starting v0.4.5 cglm provides an option to disable alignment requirement. Also alignment is disabled for older msvc verisons as default. Now alignment is only required in Visual Studio 2017 version 15.6+ if CGLM_ALL_UNALIGNED macro is not defined.

Crashes, Invalid Memory Access:

Probably you are trying to write to invalid memory location.

You may used wrong function for what you want to do.

For instance you may called glm_vec4_ functions for vec3 data type. It will try to write 32 byte but since vec3 is 24 byte it should throw memory access error or exit the app without saying anything.

Wrong Results:

Again, you may used wrong function.

For instance if you use glm_normalize() or glm_vec3_normalize() for vec4, it will assume that passed param is vec3 and will normalize it for vec3. Since you need to vec4 to be normalized in your case, you will get wrong results.

Accessing vec4 type with vec3 functions is valid, you will not get any error, exception or crash. You only get wrong results if you don’t know what you are doing!

So be carefull, when your IDE (Xcode, Visual Studio …) tried to autocomplete function names, READ IT :)

Also implementation may be wrong please let us know by creating an issue on Github.

Other Issues?

Please let us know by creating an issue on Github.