WebGL 透视消失点偏移实战:在屏幕角落渲染视角正确的 3D Gizmo(webgl-fundamentals)
WebGL 透视消失点偏移实战:在屏幕角落渲染视角正确的 3D Gizmo(webgl-fundamentals)
导读:本文基于 webgl-fundamentals 仓库中的 Q&A 文档(webgl-qna-how-can-i-move-the-perspective-vanishing-point-from-the-center-of-the-canvas-.md),讲解如何在 WebGL 中把“透视消失点”(投影中心 / 主点)从画布正中心移动到任意屏幕位置,从而在不改变相机朝向的前提下,把屏幕中心物体的旋转状态以迷你 Gizmo 的形式渲染到右下角。读完你将掌握两种经过仓库示例验证的解决方案:子视口(viewport)渲染与离轴视锥(off-center frustum)投影矩阵,并能理解“为什么直接平移投影矩阵会导致物体被旋转”。
问题场景:把屏幕中心的 3D Gizmo“搬到”右下角
原问题来自 Stack Overflow(CC BY-SA 4.0,提问者 whiterook6,问题编号 63509029),场景非常典型:场景中有一个绘制在原点 (0, 0, 0) 的 3D Gizmo(坐标轴指示器)。当相机正对着原点时,Gizmo 恰好显示在屏幕正中央。开发者希望:
- 把这个 Gizmo“抬起来”,以屏幕坐标渲染到右下角;
- 不旋转它——例如红色轴线仍然指向屏幕中心处正 X 轴的方向;
- 让 Gizmo 展示屏幕中心区域的旋转状态,同时不遮挡主视图、也不需要相机去“聚焦”某个特定点。
理想中的效果类似 3D 建模软件右下角的方位指示器(orientation gizmo / mini-map):主相机随便旋转,角落里的迷你指示器用同一个 view 矩阵呈现当前朝向,但被钉在屏幕的固定角落。问题的本质是:如何构造一个投影变换,让“消失点”离开画布中心、平移到屏幕上的指定位置,而相机方向保持不变。
直觉做法为什么失败:直接平移投影矩阵
提问者最初的尝试是直接对投影矩阵做平移:
this.gl.uniformMatrix4fv(this.modelMatrixUniform, false, modelMatrix);
this.gl.uniformMatrix4fv(this.viewMatrixUniform, false, viewMatrix);
const bottomRightMat = mat4.create();
mat4.translate(bottomRightMat, projectionMatrix, [5, -3, 0]);
this.gl.uniformMatrix4fv(this.projectionMatrixUniform, false, bottomRightMat);
this.gl.drawElements(this.gl.LINES, this.indexBuffer.getLength(), this.gl.UNSIGNED_SHORT, 0);
这个方案“能跑”,但暴露出两个致命问题:
- Gizmo 被旋转了。平移投影矩阵等效于改变相机相对于场景的位置与光轴指向,透视投影的视差效应会让物体看起来发生倾斜/旋转,与“保持方向不变”的目标相悖。红色轴线不再指向屏幕中心处正 X 轴的方向。
[5, -3, 0]是魔法数字。投影矩阵平移量处于裁剪空间(clip space)单位,其实际屏幕效果与 FOV、宽高比、near/far、物体深度以及相机位置强耦合。换个缩放级别或换相机位置,偏移量就不再正确,无法做到“以屏幕像素为单位、与缩放无关”的稳定偏移。
正确的思路是:不要平移投影矩阵,而是改变投影本身的几何定义——要么换一个子视口来画,要么构造一个左右/上下不对称的视锥。下文两种方案均来自原文档,且都有仓库内可运行的完整示例。
方案一:子视口(viewport)渲染迷你视图
第一种方法最直观:在渲染 Gizmo 时,临时把 viewport(视口) 切到屏幕右下角的小矩形区域,画完再切回来:
// size of area in bottom right
const miniWidth = 150;
const miniHeight = 100;
gl.viewport(
gl.canvas.width - miniWidth,
gl.canvas.height - miniHeight,
miniWidth, miniHeight);
// now draw. you'll need to zoom in, like set the camera closer
// or move the object closer or add a scale matrix after the projection
// matrix as in projection * scale * view * ...
注意 WebGL 的 gl.viewport 坐标原点位于绘制缓冲的左下角(y 轴向上),因此 (canvas.width - miniWidth, canvas.height - miniHeight) 对应的是右下角区域。使用该方法必须同步处理三件事:
- 投影矩阵的宽高比必须匹配新视口:
miniWidth / miniHeight与整屏的宽高比不同,直接复用主场景的透视矩阵会把 Gizmo 拉伸变形; - 补偿缩放:小视口意味着同样的物体被画得更小。文档给出的三条路径是——把相机拉近、把物体移近、或者在投影矩阵之后乘一个 2D 缩放矩阵(即
projection * scale * view * ...); - 记得恢复视口:绘制完 Gizmo 后要把
gl.viewport重置回整个画布,否则后续主场景的渲染会出错。
仓库中的完整示例 webgl-qna-how-can-i-move-the-perspective-vanishing-point-from-the-center-of-the-canvas--example-1.html 展示了完整实现。示例先在整屏绘制 5 个立方体(相机 eye=[0,0,10] 看向原点,FOV 90°),然后把视口切到右下角 100×75 的区域:
const iconAreaWidth = 100;
const iconAreaHeight = 75;
gl.viewport(
gl.canvas.width - iconAreaWidth, 0,
iconAreaWidth, iconAreaHeight);
const iconProjection = mat4.perspective(mat4.create(),
fov, iconAreaWidth / iconAreaHeight, zNear, zFar);
// compute the zoom size need to make things the same size
const scale = gl.canvas.clientHeight / iconAreaHeight;
mat4.scale(iconProjection, iconProjection, [scale, scale, 1]);
drawCube([ 0, 0, 0], iconProjection, view);
关键点逐条对应:
- 迷你投影的宽高比使用
iconAreaWidth / iconAreaHeight(即 100/75),与视口匹配; scale = canvas.clientHeight / iconAreaHeight把投影放大,使 Gizmo 在缩小后的视口中仍保持与主场景一致的像素尺寸(源码注释即说明“计算使物体大小一致所需的缩放”);- 缩放通过
mat4.scale直接作用在投影矩阵上(等价于文档所说的“在投影矩阵之后加一个 2D 缩放”); - Gizmo 复用主场景的
view矩阵(mat4.lookAt(eye, target, up)),因此它的朝向与主相机完全一致——这正是“不旋转”的关键。
从源码结构看,示例每帧先重置 gl.viewport(0, 0, canvas.width, canvas.height) 再绘制主场景,最后切到迷你视口绘制 Gizmo,天然满足了“画完恢复视口”的要求;且示例未启用深度测试(WebGL 默认关闭),后绘制的 Gizmo 会直接覆盖在其区域内。
方案二:离轴视锥投影矩阵 perspectiveWithCenter
第二种方案更“数学化”,也是文档给出的推荐做法:放弃对称的 mat4.perspective,改用 mat4.frustum 构造一个左右/上下不对称的视锥。对称的透视矩阵把投影中心固定在视口中心;而离轴视锥相当于把“传感器”平移到一侧——光轴方向(垂直于近平面、穿过近平面中心的直线)保持与原来平行,只是主点发生了偏移。这正是它能“平移消失点而不旋转物体”的根本原因。
原文档给出的完整函数实现如下:
function perspectiveWithCenter(
fieldOfView, width, height, near, far, centerX = 0, centerY = 0) {
const aspect = width / height;
// compute the top and bottom of the near plane of the view frustum
const top = Math.tan(fieldOfView * 0.5) * near;
const bottom = -top;
// compute the left and right of the near plane of the view frustum
const left = aspect * bottom;
const right = aspect * top;
// compute width and height of the near plane of the view frustum
const nearWidth = right - left;
const nearHeight = top - bottom;
// convert the offset from canvas units to near plane units
const offX = centerX * nearWidth / width;
const offY = centerY * nearHeight / height;
const m = mat4.create();
mat4.frustum(
m,
left + offX,
right + offX,
bottom + offY,
top + offY,
near,
far);
return m;
}
逐段解读其数学原理:
- 先按常规透视矩阵算出近平面(near plane)的几何范围:
top = tan(fov/2) * near、bottom = -top、left = aspect * bottom、right = aspect * top。这与仓库课程 webgl-3d-perspective.md 中讲解的透视矩阵推导一致——近平面矩形的高度由 FOV 与 near 决定,宽度再乘以宽高比。 nearWidth = right - left、nearHeight = top - bottom是近平面的宽与高。- 关键换算:
centerX/centerY是以画布像素为单位的期望偏移(centerX向右为正、centerY向上为正),必须按比例换算成近平面单位:offX = centerX * nearWidth / width。由于offX/(nearWidth/2) = 2*centerX/width,换算后的 NDC 偏移只取决于画布尺寸与期望位置,与 FOV、near/far、相机位置无关——这正好弥补了方案一里“魔法数字在不同缩放级别失效”的缺陷。 - 把
left/right/bottom/top整体平移offX/offY后交给mat4.frustum,得到的就是一个光轴方向不变、仅主点偏移的离轴透视投影。
从 mat4.frustum 的 NDC 映射(NDCx = -(right+left)/(right-left),对轴上点而言与深度无关)可以推导出:物体最终出现在屏幕位置 (width/2 - centerX, height/2 - centerY) 附近(以画布中心为原点、向右/上为正)。因此示例中把 Gizmo 送到右下角 50px 内缩处的调用方式是:
const gizmoCenterX = -gl.canvas.clientWidth / 2 + 50;
const gizmoCenterY = gl.canvas.clientHeight / 2 - 50;
const offsetProjection = perspectiveWithCenter(
fov, gl.canvas.clientWidth, gl.canvas.clientHeight, zNear, zFar,
gizmoCenterX, gizmoCenterY);
drawCube([ 0, 0, 0], offsetProjection, view);
代入推导公式:水平位置 width/2 - (-width/2 + 50) = width - 50(距右边缘 50px),垂直位置 height/2 - (height/2 - 50) = 50(距下边缘 50px),即稳定地钉在右下角。
仓库中的完整示例 webgl-qna-how-can-i-move-the-perspective-vanishing-point-from-the-center-of-the-canvas--example-2.html 与 example-1 场景相同:主场景的 5 个立方体用 perspectiveWithCenter(fov, clientWidth, clientHeight, zNear, zFar)(此时 centerX=centerY=0,等价于标准对称透视)绘制,Gizmo 则用带偏移的投影矩阵绘制,二者共用同一个 view 矩阵。示例同样包含每帧重置 viewport、按 twgl.resizeCanvasToDisplaySize 同步画布尺寸的完整渲染循环,可作为直接复用的模板。
两种方案对比与选型
| 维度 | 方案一:子视口渲染 | 方案二:离轴视锥矩阵 |
|---|---|---|
| 实现方式 | 临时切换 gl.viewport 到小矩形区域 |
用 mat4.frustum 构造不对称视锥 |
| 投影宽高比 | 必须单独按迷你视口宽高比重建投影 | 沿用整屏宽高比,与主场景一致 |
| 尺寸一致性 | 需额外乘缩放矩阵或调整相机距离 | 偏移换算与 FOV、缩放无关,天然稳定 |
| 方向保持 | 复用同一 view 矩阵,方向不变 | 光轴方向不变,方向不变 |
| 代价 | 需管理视口状态,注意绘制顺序与深度测试 | 需理解近平面换算的数学,代码稍长 |
| 适用场景 | 简单的角落缩略图、雷达图、小地图 | 需要像素级精确、缩放无关的偏移投影 |
从工程实践看,方案二(离轴视锥)更贴合原问题的两个诉求:一是屏幕像素单位的稳定偏移(不依赖魔法数字),二是任意相机位置/缩放级别下方向不变。若采用方案一,需要注意:Gizmo 只占据子矩形区域,若启用了深度测试,应先禁用深度测试或单独清空该区域的深度缓冲,避免被主场景遮挡——示例代码中通过“最后绘制 + 默认关闭深度测试”规避了该问题。
与仓库其他课程的联系
要彻底理解本文的投影数学,建议结合 webgl-fundamentals 仓库中的以下内容:
- webgl-3d-perspective.md:系统讲解透视投影矩阵的推导,包括“除 Z”的透视原理、
fieldOfView/zNear/zFar的语义,以及视锥(frustum)概念——perspectiveWithCenter正是把其中的对称视锥推广为离轴视锥; - webgl-3d-camera.md:view 矩阵(
mat4.lookAt)的构造,两个示例中 Gizmo 与主场景共用同一 view 矩阵正是“方向不变”的前提; - webgl-3d-orthographic.md:正交投影基础,理解像素坐标到裁剪空间的映射;
- frustum-diagram.html:可交互的视锥体图解,拖动滑块可直观感受
fieldOfView、zNear、zFar对视锥形状与裁剪范围的影响。
参考文件索引(仓库路径)
- 问题与答案原文:webgl/lessons/webgl-qna-how-can-i-move-the-perspective-vanishing-point-from-the-center-of-the-canvas-.md
- 方案一完整示例(子视口渲染):webgl/webgl-qna-how-can-i-move-the-perspective-vanishing-point-from-the-center-of-the-canvas--example-1.html
- 方案二完整示例(离轴视锥矩阵):webgl/webgl-qna-how-can-i-move-the-perspective-vanishing-point-from-the-center-of-the-canvas--example-2.html
- 背景课程:webgl/lessons/webgl-3d-perspective.md、webgl/lessons/webgl-3d-camera.md、webgl/lessons/webgl-3d-orthographic.md
附注:本文问题与引述部分遵循 CC BY-SA 4.0,原作者为 Stack Overflow 用户 whiterook6(问题 63509029);仓库中的中文翻译与示例代码由 webgl-fundamentals 项目维护。