本文揭示 Go-GL 库中 mgl32.Project 函数的核心缺陷：未执行关键的透视除法（perspective divide），导致三维点投影到屏幕空间时坐标严重失真，尤其在非原点位置表现异常。
本文揭示 go-gl 库中 `mgl32.project` 函数的核心缺陷：未执行关键的透视除法（perspective divide），导致三维点投影到屏幕空间时坐标严重失真，尤其在非原点位置表现异常。
mgl32.Project 是 Go-GL 数学库中用于将世界坐标系中的三维点（Vec3）转换为屏幕像素坐标的常用函数，其签名如下：
func Project(obj Vec3, modelview, projection Mat4, x, y, width, height float32) [3]float32
该函数本应模拟 OpenGL 的标准投影管线：将输入点通过模型-视图-投影（MVP）变换得到齐次裁剪坐标（vec4），再执行 透视除法（即除以 w 分量），最后映射到窗口坐标系（NDC → 屏幕）。然而，源码分析 显示，当前实现跳过了最关键的一步：
// ❌ 错误实现（缺少透视除法） obj4 := obj.Vec4(1) vpp := projection.Mul4(modelview).Mul4x1(obj4) // 得到齐次坐标 (x,y,z,w)，但未除 w！ // 直接用未归一化的 x/y 计算屏幕坐标 → 结果错误 win[0] = float32(initialX) + (float32(width)*(vpp[0]+1))/2 win[1] = float32(initialY) + (float32(height)*(vpp[1]+1))/2 win[2] = (vpp[2] + 1) / 2 // z 也未除 w，但影响较小
由于 vpp[0] 和 vpp[1] 仍处于齐次空间（例如 vpp = [4021.32, 300, ..., 10.0]），直接代入 NDC 映射公式会导致数值爆炸——这正是你观察到 X=4021.32（远超 800 像素宽）的根本原因。
✅ 正确做法是：在 MVP 变换后显式执行透视除法：
obj4 := obj.Vec4(1)
vpp := projection.Mul4(modelview).Mul4x1(obj4)
// ✅ 补上透视除法：归一化到 [-1,1] NDC 空间
if vpp[3] != 0 {
vpp[0] /= vpp[3]
vpp[1] /= vpp[3]
vpp[2] /= vpp[3]
}
// 再进行 NDC → 屏幕坐标映射
win[0] = float32(initialX) + (float32(width)*(vpp[0]+1))/2
win[1] = float32(initialY) + (float32(height)*(vpp[1]+1))/2
win[2] = (vpp[2] + 1) / 2? 验证示例（修正后）：
对 test := mgl32.Vec3{5, 0, 0} 执行完整流程后，screenTest[0] 将落在合理范围（如 ≈ 625），与实际渲染的立方体可见区域一致。
⚠️ 注意事项：
- 该 bug 在 mgl32.Project 的所有版本（截至 mathgl v1.0.0）中均存在，不可直接用于生产环境；
- 若需即时修复，建议自行封装安全版 SafeProject 函数（含透视除法）；
- 替代方案：使用 gluProject 兼容实现，或借助 golang.org/x/image/math/f64 手动构建 MVP 流程；
- 检查 vpp[3] == 0 避免除零 panic，尤其当点位于摄像机平面后方时。
总结：图形管线中“透视除法”绝非可选步骤——它是连接齐次坐标与标准化设备坐标（NDC）的桥梁。忽略它，再精确的 MVP 矩阵也无法产出正确的屏幕位置。开发者在调用底层投影工具时，务必核查其是否严格遵循 OpenGL 规范，必要时以手动实现兜底。
