Go-GL 的 mgl32.Project 函数因缺失透视除法（perspective divide）导致屏幕坐标严重失真，尤其在非原点位置计算时 X/Y 值远超窗口范围，本文揭示其源码缺陷并提供可靠替代实现。
go-gl 的 `mgl32.project` 函数因缺失透视除法（perspective divide）导致屏幕坐标严重失真，尤其在非原点位置计算时 x/y 值远超窗口范围，本文揭示其源码缺陷并提供可靠替代实现。
mgl32.Project 是 Go-GL 生态中常用的三维世界坐标到二维屏幕坐标的投影工具，其签名如下：
func Project(obj Vec3, modelview, projection Mat4, initialX, initialY, width, height float32) [3]float32
但根据对 mathgl 源码的深入分析（project.go#L61），该函数存在一个关键性缺陷：未执行 OpenGL 标准流程中的透视除法（即齐次坐标 w 分量归一化）。
标准 OpenGL 投影流程为：
- 将顶点 obj 扩展为齐次坐标 obj4 = (x, y, z, 1)；
- 乘以 projection × modelview 得到裁剪空间坐标 vpp = (x', y', z', w')；
- 执行透视除法：(x'/w', y'/w', z'/w') → 归一化设备坐标（NDC），范围 [-1, 1]；
- 映射至窗口坐标：x_screen = initialX + width × (x_ndc + 1)/2，同理 Y/Z。
而 mgl32.Project 直接对 vpp 的 x', y', z' 进行线性映射，跳过了第 3 步。这导致当 w' ≠ 1（即非近平面或原点附近点）时，坐标严重失真——正如问题中 (5,0,0) 投影得到 x ≈ 4021（远超 800 像素宽度），正是因 w' ≈ 0.99 量级，未经除法放大了数十倍。
✅ 正确实现应显式完成透视除法。以下是可直接替换使用的安全版本：
import "github.com/go-gl/mathgl/mgl32"
func ProjectFixed(obj mgl32.Vec3, modelview, projection mgl32.Mat4,
initialX, initialY, width, height float32) [3]float32 {
obj4 := obj.Vec4(1.0)
// Step 1: Transform to clip space
vpp := projection.Mul4(modelview).Mul4x1(obj4)
// Step 2: Perspective divide — CRITICAL missing step!
w := vpp[3]
if w == 0 {
panic("ProjectFixed: division by zero in perspective divide")
}
ndcX := vpp[0] / w
ndcY := vpp[1] / w
ndcZ := vpp[2] / w
// Step 3: Map NDC [-1,1] to window coordinates
winX := initialX + width*(ndcX+1.0)/2.0
winY := initialY + height*(ndcY+1.0)/2.0
winZ := (ndcZ + 1.0) / 2.0 // depth in [0,1]
return [3]float32{winX, winY, winZ}
}? 使用示例（替换原 mgl32.Project 调用）：
screenOrigin := ProjectFixed(origin, modelView, projection, 0, 0, 800, 600) screenTest := ProjectFixed(test, modelView, projection, 0, 0, 800, 600) // 输出预期结果：Origin ≈ (400, 300, ...)，Test ≈ (620–630, 300, ...)，符合视觉验证
⚠️ 注意事项：
- 该 bug 影响所有 mgl32.Project 调用，尤其在相机远离原点、物体位于视锥体中后部时更显著；
- w ≈ 0 时（如极远点）会导致数值不稳定，生产环境建议添加容错判断（如 abs(w) < 1e-6 则返回无效坐标）；
- 若项目已深度依赖 mgl32.Project，可提交 PR 修复上游库，或使用 go mod replace 替换为修正版分支；
- 验证时建议同时渲染参考几何体（如带标签的立方体）与投影点，双重确认坐标一致性。
总结：图形管线中“透视除法”绝非可选步骤——它是连接齐次裁剪空间与标准化设备坐标的桥梁。忽视它，再精确的 MVP 矩阵也无法产出正确屏幕坐标。务必在自定义投影逻辑中显式检查并执行 w 归一化，这是保证 3D→2D 转换鲁棒性的基石。
