一个高度优化的 2D|3D 数学库。也被称为适用于 C 的 OpenGL 数学库 (glm)。cglm 提供了快速且符合人体工程学的数学函数，以简化图形编程。它对社区友好 – 欢迎报告您遇到的任何错误和问题。
如果您正在使用 C++，您可能需要查看 GLM
- 无内存分配
- 仅头文件
- SIMD 优化
- API 不可知
所有函数及其参数都记录在它们各自头文件中的声明上方。
或者，您可以在此处阅读完整的文档。
cglm 可以完全作为仅头文件库使用，只需包含 cglm/cglm.h 即可。如果您希望链接它，可以使用受支持的构建系统之一来构建它。有关在各个平台上构建的详细信息和构建系统以及构建文档的说明，请参见 BUILDING.md。
包含 cglm/cglm.h 头文件，并使用带有 glm_ 前缀的函数。
#include "cglm/cglm.h"
// ...
vec2 vector;
glm_vec2_zero(vector);
包含 cglm/struct.h 并使用 glms_。
#include "cglm/struct.h"
// ...
vec2s vector = glms_vec2_zero();
包含 cglm/call.h 并使用 glmc_。
#include "cglm/call.h"
// ...
vec2 vector;
glmc_vec2_zero(vector);
虽然 cglm 默认情况下会对其必要的内容进行对齐，但可以通过定义 CGLM_ALL_UNALIGNED 来禁用此功能。如果您面向任何具有 SIMD 支持的机器，请确保传递给 cglm 函数的所有 vec4、mat4 和 mat2 参数都已对齐，以防止意外崩溃，或者在存在未对齐版本的情况下使用它们。
结构体 API 的工作方式如下（请注意类型上的 s 后缀，函数上的 glms_ 前缀和常量上的 GLMS_）
#include <cglm/struct.h>
mat4s mat = GLMS_MAT4_IDENTITY_INIT;
mat4s inv = glms_mat4_inv(mat);
结构体函数通常按值复制参数并返回结果，而不是接受指针并写入输出参数。这意味着如果喜欢，您的变量通常可以是 const。
使用的类型实际上是联合体，允许以多种方式访问相同的数据。其中一种涉及自 C11 起可用的匿名结构。MSVC 在早期版本中开箱即用地支持它们，GCC/Clang 如果您启用 -fms-extensions 也支持。要显式启用匿名结构，请 #define CGLM_USE_ANONYMOUS_STRUCT 1，或 0 禁用它们。为了向后兼容，您也可以 #define CGLM_NO_ANONYMOUS_STRUCT 来禁用它们。如果您未明确指定，cglm 将根据您的编译器和 C 版本尝试最佳猜测。
_dup（复制）函数已重命名为_copy。例如：glm_vec_dup->glm_vec3_copy。- OpenGL 相关函数已被删除，以使 cglm API 独立。
- [错误修复] 欧拉角之前以相反的顺序（外旋）实现。这已修复为内旋。
- [重大变更] 从 v0.4.0 开始，四元数存储为 [x, y, z, w]。之前是 [w, x, y, z]。
- [API 重命名] 从 v0.4.5 开始，
glm_simd_函数已重命名为glmm_。 - [新选项] 从 v0.4.5 开始，可以禁用对齐要求。请阅读文档以了解更多信息。
- [重大变更] 从 v0.5.0 开始，vec3 函数占用 glm_vec3_ 命名空间。这在早期版本中曾经是 glm_vec_ 。
- [重大变更] 从 v0.5.1 开始，
vec3和mat3类型默认情况下未对齐。 - [重大变更] 从 v0.7.3 开始，内联打印函数在发布模式下默认禁用，以消除打印成本（请参阅文档的“选项”章节）。
可以禁用彩色输出（请参阅文档）。 - [重大变更] 从 v0.8.3 开始，支持备用裁剪空间配置。提供了
CGLM_FORCE_DEPTH_ZERO_TO_ONE和CGLM_FORCE_LEFT_HANDED标志来控制裁剪深度和惯用性。这使得将 cglm 纳入使用 Vulkan 或 Metal 等图形 API 的项目变得更加容易。请参阅 https://cglm.readthedocs.io/en/latest/opt.html#clipspace-option-s
- 标量和 simd (sse, avx, neon...) 优化
- 通用矩阵运算 (mat4, mat3)
- 链式矩阵乘法（仅限方阵）
- 通用向量运算（叉积、点积、旋转、投影、角度...）
- 仿射变换
- 矩阵分解（提取旋转、缩放因子）
- 优化的仿射变换矩阵（乘法、刚体逆变换）
- 相机 (lookat)
- 投影 (正交投影、透视投影)
- 四元数
- 欧拉角 / 偏航-俯仰-横滚 到矩阵
- 提取欧拉角
- 视锥体（提取视锥体平面，角点...）
- 边界框（视锥体中的 AABB（裁剪）、裁剪、合并...）
- 边界球
- 投影、反投影
- 缓动函数
- 曲线
- 曲线插值助手 (SMC, deCasteljau...)
- 从 cglm 类型到 Apple 的 simd 库的转换助手，以便将 cglm 类型传递给 Metal GL，而无需在两端打包它们
- 射线相交助手
|
与其他图形库（尤其是 OpenGL）一样，cglm 使用列优先布局将矩阵保存在内存中。
虽然我们将来可能会支持行优先矩阵，但目前如果您需要矩阵采用行优先布局，则必须转置它们。 |
 |
cglm 包含通用的 mat4 乘积和逆函数，但也为仿射变换提供了优化版本。如果要乘以两个仿射变换矩阵，可以使用 glm_mul 而不是 glm_mat4_mul 和 glm_inv_tr (ROT + TR) 而不是 glm_mat4_inv。
/* multiplication */
mat4 modelMat;
glm_mul(T, R, modelMat);
/* othonormal rot + tr matrix inverse (rigid-body) */
glm_inv_tr(modelMat);
这个项目的存在归功于所有贡献者。[贡献] 
感谢我们所有的赞助者！🙏 [成为赞助者]
通过成为赞助商来支持这个项目。您的徽标将在此处显示，并链接到您的网站。[成为赞助商]
