本文详解 LWJGL 3 中 Matrix4f.perspective() 的常见误用——尤其是宽高比（aspect ratio）计算错误与参数遗漏问题，并提供可直接复用的修复方案，确保投影变形（如矩形变正方形）按预期生效。
本文详解 lwjgl 3 中 `matrix4f.perspective()` 的常见误用——尤其是宽高比（aspect ratio）计算错误与参数遗漏问题，并提供可直接复用的修复方案，确保投影变形（如矩形变正方形）按预期生效。
在使用 LWJGL 3 进行 OpenGL 渲染时，即使成功传入投影矩阵（projectionMatrix），若其内容未正确反映视口实际宽高比，就会导致几何体形变异常——例如本例中：四边形始终显示为拉伸的矩形而非预期的正方形，尽管 FOV 变化能影响缩放（说明矩阵被传递并生效），但纵横比失真暴露了根本性配置错误。
? 根本原因：宽高比计算失效 + 参数未使用
问题代码中存在两个关键缺陷：
float aspectRatio = 640 / 480; // ❌ 错误：整数除法 → 结果恒为 1
projectionMatrix.perspective(
(float) Math.toRadians(FOV),
1, // ❌ 错误：硬编码为 1，完全忽略 aspectRatio 变量
Z_NEAR, Z_FAR
);
-
640 / 480是 整数除法（Java 中两整数相除结果仍为整数），结果为1，赋值给float后仍是1.0f； - 后续调用
perspective(..., 1, ...)直接传入字面量1，导致宽高比恒为 1:1，无论窗口实际尺寸如何——这正是 Quad 始终呈矩形（非正方形）却随 FOV 缩放的原因：它被强制“压扁”在单位正方形裁剪空间中。
✅ 正确实现：动态计算 + 正确传参
应改为显式浮点运算，并真正使用计算出的宽高比：
// ✅ 正确：确保浮点除法，并传入计算结果
int width = 640; // 实际窗口宽度（建议从 Window 对象动态获取）
int height = 480; // 实际窗口高度
float aspectRatio = (float) width / height; // 或写为 640f / 480f
projectionMatrix = new Matrix4f();
projectionMatrix.perspective(
(float) Math.toRadians(FOV), // 视场角（弧度）
aspectRatio, // ✅ 关键：此处必须传入计算好的 aspectRatio
Z_NEAR,
Z_FAR
);
? 最佳实践建议：不要硬编码
640/480。应在init()或窗口大小变更回调中，通过window.getWidth()/window.getHeight()动态获取当前分辨率，避免因窗口缩放或全屏导致宽高比失效。
? 补充验证：顶点坐标与裁剪空间关系
本例中 Quad 顶点定义为：
float[] vertices = {
-0.5f, 0.5f, -5.0f, // 左上
-0.5f, -0.5f, -5.0f, // 左下
0.5f, -0.5f, -5.0f, // 右下
0.5f, 0.5f, -5.0f // 右上
};
该 Quad 在世界空间中是边长为 1.0 的正方形（X∈[-0.5,0.5], Y∈[-0.5,0.5]），位于 Z=-5 处。当 aspectRatio=1（即 1:1 投影），其在 NDC（标准化设备坐标）中将严格映射到 [-1,1]×[-1,1] 区域，视觉上为正方形；但若 aspectRatio≠1（如 4:3），X 轴会被压缩或拉伸以匹配屏幕比例——这才是符合透视原理的正确行为。
⚠️ 注意事项总结
-
永远检查宽高比计算类型：
int/int → int，务必转为浮点（640f/480f或(float)640/480）； -
确认
perspective()第二个参数是变量，不是常量； -
Shader 中需声明并使用
projectionMatrix（确保顶点着色器含gl_Position = projectionMatrix * vec4(position, 1.0);）； -
启用深度测试（
GL11.glEnable(GL11.GL_DEPTH_TEST)）可避免渲染顺序干扰观察； - 若使用 GLFW 窗口，推荐监听
glfwSetFramebufferSizeCallback动态更新投影矩阵，适配窗口缩放。
修复后，Quad 将严格遵循窗口实际比例呈现：4:3 窗口下保持正方形外观，16:9 下则自然适应宽屏拉伸——这才是透视投影的正确表现。
