正交投影矩阵的标准形式按OpenGL约定为：left、right、bottom、top、near、far，其中近远平面实际z坐标为−near和−far，NDC深度范围为[−1,1]，需严格匹配右手系以保障深度测试正确。
正交投影矩阵的数学定义和参数顺序
手写正交投影矩阵的关键，是严格按 OpenGL 或 Vulkan 的约定来组织元素——不是所有教程都告诉你：默认 glOrtho 使用的是“右手坐标系 + NDC Z 范围 [-1, 1]”，而很多手写实现误用 [0, 1] 导致深度测试失效。
标准形式（OpenGL 风格）接收六个参数：left、right、bottom、top、near、far，其中 near 和 far 是摄像机空间中的 Z 值（不是距离），且要求 near ；若你传入 <code>near=0.1, far=100.0，Z 方向缩放因子就是 -2.0/(far - near)，负号用于翻转 Z 轴以匹配 NDC 的 [-1,1] 区间。
-
left和right决定 X 轴缩放与平移，公式为2.0/(right - left)和-(right + left)/(right - left) - 同理，
bottom/top控制 Y；但注意：Y 平移项符号与 X 一致，不是“反的”——别被某些图形教材的手绘图误导 - 如果目标是 Vulkan（NDC Z ∈ [0,1]），必须把第三行第四列改为
-near/(far - near)，且第三行第三列为1.0/(far - near)，不能直接复用 OpenGL 版本
用 C++ 手写 4×4 矩阵并填充元素
别依赖 std::array<float></float> 或自定义 Matrix4 类的 setter——直接初始化 float 数组最可控，也最容易对齐内存布局（列主序 vs 行主序）。
以下是最小可验证实现（OpenGL 风格，列主序，兼容 GLSL uniform mat4）：
立即学习“C++免费学习笔记（深入）”；
float ortho[16] = {
2.0f/(right - left), 0.0f, 0.0f, 0.0f,
0.0f, 2.0f/(top - bottom), 0.0f, 0.0f,
0.0f, 0.0f, -2.0f/(far - near), 0.0f,
-(right+left)/(right-left),
-(top+bottom)/(top-bottom),
-(far+near)/(far-near),
1.0f
};
注意：C++ 初始化列表按**列优先顺序**填入——第 0～3 个值是第一列（即变换后的 X 轴基向量），不是第一行。如果你用行主序存储（比如某些 math 库），必须转置索引或改用循环赋值。
- 检查
right != left、top != bottom、far != near，否则除零未定义行为 - 不要省略最后一列的
1.0f；漏掉它会导致 W 分量异常，顶点直接被裁剪掉 - 若用
glm::ortho对比结果，确保你没把near/far当成“距离”传反（例如误传far=0.1,near=100.0）
常见错误：Z-Fighting、模型消失、上下颠倒
这些问题几乎都源于三个地方：坐标系混淆、NDC 深度范围错配、视口 Y 轴方向没对齐。
典型现象和定位方法：
- 模型渲染出来是黑的或全白——检查是否忘了在顶点着色器里乘
projection * view * model，且projection确实传进了 uniform；用 RenderDoc 抓帧看 uniform buffer 值是否为 NaN 或全零 - Z-Fighting 严重——大概率用了 Vulkan 风格的 projection 却喂给了 OpenGL 上下文，或
near/far设置过近（如0.01和0.02），导致深度缓冲精度崩坏 - 画面上下颠倒——不是矩阵问题，而是你的 FBO 或窗口坐标系 Y 向上，但纹理采样时没调
glPixelStorei(GL_UNPACK_FLIP_Y_WEBGL, GL_TRUE)（WebGL）或没翻转图像数据；正交矩阵本身不负责这个 - 调用
glOrtho后啥也没画出来——确认你没在 projection 矩阵生效前就绑了 VAO，或者清屏颜色和绘制颜色一样（比如都用黑色）
需要适配不同 API 时怎么改
核心差异只有两处：Z 轴映射方式和矩阵内存布局。其他参数（left/right/top/bottom）完全一致。
- OpenGL（Z ∈ [-1,1]，列主序）：第三行第三列为
-2.0/(far - near)，第三行第四列为-(far + near)/(far - near) - Vulkan / Direct3D（Z ∈ [0,1]，通常列主序）：第三行第三列为
1.0/(far - near)，第三行第四列为-near/(far - near) - 如果你用行主序存储（如某些游戏引擎内部表示），就把上面所有索引从「列优先」换成「行优先」：例如原第 0、1、2、3 个元素变成第 0、4、8、12 个
- WebGPU 默认也是 Z ∈ [0,1]，但要求矩阵传入时显式声明为
layout(row_major)，否则 shader 会按列主序读——这点极易忽略
最稳妥的做法：在矩阵生成函数名里带上后缀，比如 make_ortho_opengl() 和 make_ortho_vulkan()，避免混用。Z 范围错一个数量级，调试起来比找内存越界还费时间。
