gizmo需联动视图/投影矩阵与鼠标射线反向相交:移动轴用带箭头线段+圆锥,碰撞检测基于射线-线段距离;旋转轴用环形路径圆,缩放轴用立方体手柄线段;所有几何体在世界空间定义,绘制前经view*projection变换,交互时鼠标转世界射线做精确碰撞检测。

怎么用 OpenGL + GLM 渲染一个可交互的 3D Gizmo 轴
直接说结论:Gizmo 不是“画个坐标系”就行,它必须和当前视图矩阵、投影矩阵、鼠标拾取深度、屏幕空间射线反向相交联动。否则拖拽时轴会漂移、旋转轴错位、缩放中心偏移。
核心思路是:把三个轴(X/Y/Z)各自建模为带方向的线段+锥体/圆柱体(移动)、带环形路径的圆(旋转)、带立方体手柄的线段(缩放),全部在世界空间定义,再用 view 和 projection 变换到裁剪空间做绘制;但交互时必须把鼠标位置反推成世界空间射线,与各轴的几何体做碰撞检测(如线段-射线、圆柱-射线、圆环-射线)。
常见错误现象:glBegin(GL_LINES) 硬画轴线 → 没有深度测试、不随视角缩放、无法拾取;只用 glm::rotate 旋转变换轴模型 → 忘了旋转后轴的“可拖拽区域”也得跟着变,导致视觉和逻辑不一致。
实操建议:
- 移动轴:每个轴用一条带箭头的线段(线段+小圆锥),碰撞检测用“射线-线段距离 worldPickRadius = 0.02f * (cameraDistance / 5.0f))
- 旋转环:用 32 段线段拼成 XY/YZ/ZX 平面内的圆环,法向量分别对应
glm::vec3(0,0,1)、glm::vec3(1,0,0)、glm::vec3(0,1,0);拾取时判断鼠标射线是否与环所在平面相交,再测交点到圆心距离是否在环宽范围内 - 缩放手柄:每个轴末端加一个带法向的小立方体(边长 ≈ 移动轴长度 × 0.3),用 AABB-射线求交,比球体更易精准点击
为什么 glm::unProject 不能直接用,要自己算射线
glm::unProject 默认假设 Z=0(近平面),但 Gizmo 操纵必须知道鼠标指向世界中“哪个深度”的点——你拖的是当前选中物体的局部原点?还是轴上某段?Z 值错了,射线就偏了整个轴。
正确做法是:先用 glReadPixels 读深度缓冲(GL_DEPTH_COMPONENT),转成 [0,1] 后传给 glm::unProject;或更稳定地手动构造射线:从摄像机位置出发,用 glm::inverse(view * projection) 把归一化设备坐标(NDC)转回世界方向向量。
关键参数差异:
- 若用
glReadPixels读深度,注意 Y 坐标要翻转(OpenGL 窗口 Y 向下,NDC Y 向上):depthY = viewport[3] - mouseY - 1 - 手动算射线时,NDC 坐标范围是
x ∈ [-1,1],y ∈ [-1,1],z ∈ [0,1];别误用z=0.5当默认值——那只是中平面,不是物体所在深度 - 射线起点必须是
cameraPos(即glm::inverse(view)[3]的前三分量),不是原点
怎么让 Gizmo 轴始终面向摄像机(Billboard)又保持轴对齐
纯 Billboard(所有轴都正对镜头)会让 X/Y/Z 失去方向感,用户分不清哪根是哪个。真需求是:轴线本身仍沿世界方向伸展,但箭头、环、手柄这些“交互区域”需要轻微朝向摄像机以提升点击率——也就是“轴对齐 Billboard”(Axis-Aligned Billboard)。
做法不是旋转整个 Gizmo,而是对每个轴的几何体单独处理:例如移动轴的箭头锥体,保持其轴线方向不变(仍沿世界 X),但把锥体顶点绕该轴旋转,使锥底圆面法向朝向摄像机水平投影方向(即忽略摄像机俯仰角,只校正左右偏转)。
性能影响很小,但兼容性要注意:
- 顶点着色器里做这个计算,别在 CPU 算好再传——每帧摄像机动,就得重算一次
- 旋转环不能全 Billboard,否则 XY 环会变成一条线;应只对环的“厚度方向”(即环平面法向)做朝向校正,环本身仍严格在对应世界平面内
- 缩放手柄的立方体建议不做 Billboard,保持轴对齐,否则点击反馈不直观
拾取失败的三个隐蔽原因
明明射线穿过了轴,glm::intersectRayTriangle 却返回 false?大概率栽在这三处:
- 深度测试开启但 Gizmo 绘制顺序不对:确保 Gizmo 在场景之后绘制,且调用
glDisable(GL_DEPTH_TEST)或设glDepthFunc(GL_ALWAYS)—— 否则轴被物体遮挡就拾取不到 - 射线方向没归一化:
glm::normalize(rayDir)必须做,否则和 AABB 相交计算结果溢出 - 坐标系混淆:Gizmo 所有轴定义在世界空间,但你的物体可能有父级变换;拾取时若把轴顶点先乘了物体 model 矩阵,再和从 camera 出发的射线求交,就完全错位了——Gizmo 永远只应在世界空间中定义和检测
最易被忽略的点:移动轴的“有效拖拽区”不是整条线段,而是线段上靠近箭头的一半(避免误触根部);旋转环的“有效区”是环宽度(比如 0.05 单位)而非环线本身粗细;这些都需要在碰撞逻辑里显式截断,不能依赖美术资源尺寸。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











