简介一份基于Qt与OpenGL的3D图形绘制与旋转示例工程面向学习Qt三维编程与OpenGL基础渲染的中级开发者适合在理解平面图形着色旋转后进一步探索三维场景。核心演示四棱锥的构建由5个面4个三角形侧面加1个四边形底面组成封闭立体通过着色与旋转交互展示三维顶点坐标的求取与变换。资源共16个文件压缩包仅451KB内容涵盖cpp源文件、h头文件、ui界面设计、pro工程配置与makefile同时提供编译生成的exe可执行文件、release/debug目录及过程记录文本源码与产物对应清晰便于运行验证与逐行研读。项目结构完整可直接运行观察四棱锥的实时渲染效果。已有2421人学习下载适合初学OpenGL或Qt图形编程、希望动手实践3D绘制的读者。借助该工程可掌握立体模型的顶点坐标计算、逐面绘制方法、着色与旋转操作等关键技术理解Qt与OpenGL结合时的程序框架和工程组织方式为后续复杂三维可视化开发积累经验。1. 为什么还在用 Qt 写 OpenGL这份源码把旋转矩阵讲透了前阵子拿到一个 Qt 源码工程需求描述只有一句“3D 图形绘制并旋转”。打开工程跑起来画面确实在转可一旦拖动窗口边缘立方体立刻被拉成长方体把绕 X 轴和绕 Y 轴的旋转叠在一起角度稍微大一点模型就像喝醉了似的飘。后来我把整个工程拆开重写才发现这类资源真正值钱的部分不在“画三角形”而在矩阵怎么组织、缓冲怎么绑定、着色器怎么排查。这份 Qt OpenGL 3D 图形的绘制和旋转资源解决的正是从零搭起一套可旋转三维模型的完整链路适合两类人用 Qt 写桌面工具、需要嵌一块可交互 3D 视图的开发者以及刚学完图形学理论、想把顶点缓冲和矩阵变换落到一行行真实代码上的学生。理论先讲清楚再动手复现这是下面所有章节的顺序。2. 搭建最小 Qt OpenGL 工程着色器管线与三个必须设置的参数2.1 用 QOpenGLWidget 而不是 QGLWidgetQt 6 的模块变更与选型理由看过老教程的人可能一上来就写#include QGLWidget在 Qt 6 里这行直接编译失败。Qt 6 把遗留的 Qt OpenGL 模块删掉了取而代之的是QOpenGLWidget与QOpenGLFunctions的组合。前者负责把 OpenGL 渲染结果嵌进 Qt 的窗口系统后者封装了核心函数指针省去了手动调用glGetProcAddress的麻烦。选型上还有一个更具体的理由QOpenGLWidget在内部已经处理了窗口系统下 OpenGL 上下文context的创建、销毁和渲染缓冲区的切换开发者只需要覆写三个虚函数initializeGL()GL 上下文准备好之后调用一次适合创建着色器程序、顶点缓冲这类 GPU 资源resizeGL(int w, int h)窗口尺寸变化时调用必须在这里更新投影矩阵的宽高比paintGL()每一帧调用负责清屏、绑定资源、发绘制命令。这个生命周期模型决定了资源的创建位置永远不要在构造函数里做任何 OpenGL 调用因为此时 context 还不存在。我一般把GLWidget写成QOpenGLWidget和QOpenGLFunctions的双继承既拿到了 Qt 部件能力也直接拥有了glClearColor、glDrawElements这些函数不用再包一层成员对象。2.2 CMake 工程骨架窗口创建前把 SurfaceFormat 设好工程骨架我用 CMakeQt 6 里官方推荐的做法是qt_add_executable配合显式链接Qt6::OpenGL。下面是一个可以直接编译运行的最小工程配置cmake_minimum_required(VERSION 3.16) project(qt_opengl_3d_demo LANGUAGES CXX) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) set(CMAKE_AUTOMOC ON) find_package(Qt6 REQUIRED COMPONENTS Widgets OpenGL) qt_standard_project_setup() qt_add_executable(qt_opengl_3d_demo main.cpp glwidget.cpp glwidget.h ) target_link_libraries(qt_opengl_3d_demo PRIVATE Qt6::Widgets Qt6::OpenGL )find_package里的COMPONENTS Widgets OpenGL缺一不可。OpenGL是 Qt6 的独立模块不写它后面#include QOpenGLFunctions就找不到头文件。qt_standard_project_setup()是 Qt 6.3 之后提供的约定配置它会处理AUTOMOC和资源文件的默认搜索路径如果你是更早的 Qt 版本去掉这行、保留set(CMAKE_AUTOMOC ON)即可。主函数里有一个容易被忽略的关键参数块必须在创建窗口之前设置#include QApplication #include QSurfaceFormat #include glwidget.h int main(int argc, char *argv[]) { QApplication app(argc, argv); QSurfaceFormat fmt; fmt.setDepthBufferSize(24); fmt.setSamples(4); fmt.setVersion(3, 3); fmt.setProfile(QSurfaceFormat::CoreProfile); QSurfaceFormat::setDefaultFormat(fmt); GLWidget w; w.resize(800, 600); w.show(); return app.exec(); }setVersion(3, 3)和setProfile(QSurfaceFormat::CoreProfile)这两行是在声明我需要一个 OpenGL 3.3 核心模式的 context。3.3 是桌面环境兼容性很好的一个版本着色器可以用#version 330 core既不需要 4.x 的新特性也不会掉进旧版glBegin/glEnd立即模式的坑。setDepthBufferSize(24)给深度缓冲留 24 位绘制立方体时如果这里不设置glEnable(GL_DEPTH_TEST)实际可用的深度精度可能只有 16 位远处物体叠加时会出现闪烁。setSamples(4)是多重采样抗锯齿开 4 倍能让模型边缘平滑不少如果你的机器驱动对多重采样支持不佳把这一行注释掉即可不影响功能。QSurfaceFormat::setDefaultFormat必须在任何QOpenGLWidget构造之前调用这是很多新人第一次黑屏的根源。2.3 着色器代码与链接检查先把黑匣子打开着色器是 OpenGL 里最需要“先查日志再谈效果”的一环。工程里我习惯把顶点和片元着色器源码直接放在 C 字符串里方便单文件维护static const char *vertexShaderSource R( #version 330 core layout (location 0) in vec3 aPos; layout (location 1) in vec3 aColor; uniform mat4 uMatrix; out vec3 vColor; void main() { gl_Position uMatrix * vec4(aPos, 1.0); vColor aColor; } ); static const char *fragmentShaderSource R( #version 330 core in vec3 vColor; out vec4 fragColor; void main() { fragColor vec4(vColor, 1.0); } );这里我把layout (location 0)和location 1写死对应后面glVertexAttribPointer的两个属性。如果不在着色器里声明 location编译器可能自动分配编号和 C 侧setAttributeBuffer(0)对不上出来的画面就是乱的。初始化阶段编译链接并强制检查返回值void GLWidget::initializeGL() { initializeOpenGLFunctions(); glClearColor(0.15f, 0.15f, 0.2f, 1.0f); glEnable(GL_DEPTH_TEST); m_program new QOpenGLShaderProgram(this); if (!m_program-addShaderFromSourceCode(QOpenGLShader::Vertex, vertexShaderSource)) { qWarning() vertex shader error: m_program-log(); return; } if (!m_program-addShaderFromSourceCode(QOpenGLShader::Fragment, fragmentShaderSource)) { qWarning() fragment shader error: m_program-log(); return; } if (!m_program-link()) { qWarning() link error: m_program-log(); return; } // 后续创建 VBO / VAO }initializeOpenGLFunctions()必须在第一次调用任何gl*函数之前执行否则glClearColor可能直接段错误。glClearColor四个参数是 0 到 1 的浮点 RGBA很多人按 0 到 255 写法传(255, 0, 0)结果清屏出来是白色这是最常见的第一坑。glEnable(GL_DEPTH_TEST)打开深度测试绘制前后重叠的立方体面时必须开启否则后绘制的面会盖住先绘制的面。QOpenGLShaderProgram::log()是把编译错误打印出来的唯一窗口——它经常提示“in valid syntax”这类信息看到 log 里有内容就先处理别继续往下写。3. 顶点数据与缓冲布局把立方体送进 GPU 的四步绑定顺序3.1 立方体顶点与索引用颜色区分面更好验证旋转旋转效果需要“能看到方向感”的模型纯色球体转没转都看不出来。资源里用的方案是给每个顶点带颜色属性六个面六种颜色旋转时颜色变化能直观暴露矩阵问题。顶点结构体定义如下#include QVector3D #include cstddef // offsetof struct Vertex { QVector3D pos; QVector3D color; }; static const Vertex cubeVertices[] { // 前面红 { {-0.5f, -0.5f, 0.5f}, {1.0f, 0.0f, 0.0f} }, { { 0.5f, -0.5f, 0.5f}, {1.0f, 0.0f, 0.0f} }, { { 0.5f, 0.5f, 0.5f}, {1.0f, 0.0f, 0.0f} }, { {-0.5f, 0.5f, 0.5f}, {1.0f, 0.0f, 0.0f} }, // 后面绿 { {-0.5f, -0.5f, -0.5f}, {0.0f, 1.0f, 0.0f} }, { { 0.5f, -0.5f, -0.5f}, {0.0f, 1.0f, 0.0f} }, { { 0.5f, 0.5f, -0.5f}, {0.0f, 1.0f, 0.0f} }, { {-0.5f, 0.5f, -0.5f}, {0.0f, 1.0f, 0.0f} }, // 其余四个面按需求补齐共 24 个顶点 }; static const GLuint cubeIndices[] { 0, 1, 2, 2, 3, 0, // 前面 4, 5, 6, 6, 7, 4, // 后面 // 左右上下共 24 个索引总计 36 个索引 };这里选择了 24 个顶点加 36 个索引的结构而不是 36 个独立顶点。原因有两个第一面与面之间共用的顶点比如前面和上面共用一条棱上的点只需要存一份内存GPU 缓存命中率更高第二索引复用让后面要讲的glDrawElements有了用武之地调用参数里能清晰看到“画 36 个索引”这层逻辑。每个顶点 24 字节两个QVector3D整个立方体顶点数据不到 600 字节在这类 Demo 里内存完全不是瓶颈重点是为了演示标准做法。3.2 VAO 绑定顺序先绑 VAO再绑 VBO否则索引缓冲会“丢”VAO顶点数组对象的作用是把“顶点属性怎么解释”和“索引缓冲绑的是谁”打包成一个状态。最容易翻车的点是绑定顺序一定要先m_vao.bind()再绑定 VBO 和 EBO这样后续所有属性设置和索引缓冲绑定都被记录进当前 VAO。void GLWidget::initializeGL() { // ... 着色器创建与链接省略 ... m_vao.create(); m_vbo.create(); m_ebo.create(); m_vao.bind(); m_vbo.bind(); m_vbo.allocate(cubeVertices, sizeof(cubeVertices)); // location 0: 顶点坐标 m_program-setAttributeBuffer(0, GL_FLOAT, 0, 3, sizeof(Vertex)); m_program-enableAttributeArray(0); // location 1: 顶点颜色偏移到结构体的 color 字段 m_program-setAttributeBuffer(1, GL_FLOAT, offsetof(Vertex, color), 3, sizeof(Vertex)); m_program-enableAttributeArray(1); m_ebo.bind(); m_ebo.allocate(cubeIndices, sizeof(cubeIndices)); m_vao.release(); }逐个参数说清楚setAttributeBuffer的五个参数第一个参数是着色器里的 location 编号第二个GL_FLOAT表示属性类型是 32 位浮点第三个参数是字节偏移量0表示从顶点起点开始读颜色属性的偏移必须是offsetof(Vertex, color)也就是 12 字节——如果这里手写12也能跑但一旦结构体调整就会出错用offsetof更稳第四个参数3是分量个数坐标和颜色都是三维第五个sizeof(Vertex)是 stride即相邻两个顶点之间间隔多少字节整个结构体 24 字节。如果 stride 写错画出来的顶点会错乱成“麻花”形状。m_vao.release()是为了防止后续其他 OpenGL 代码意外修改这个 VAO 的状态。在paintGL里每次绘制前重新 bind 一次即可这是一个低成本的后悔药。还有一个细节m_ebo.bind()必须在m_vao.bind()之后这样 EBO 会记录进 VAO。反过来先绑 EBO 再绑 VAO某些驱动下glDrawElements会找不到索引缓冲直接报 GL_INVALID_OPERATION。3.3 绘制调用glDrawElements 的最后一个参数必须为空绘制放在paintGL里职责是清屏、绑定程序、上传矩阵、绑定 VAO、发命令void GLWidget::paintGL() { glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT); m_program-bind(); m_program-setUniformValue(uMatrix, m_matrix); m_vao.bind(); glDrawElements(GL_TRIANGLES, 36, GL_UNSIGNED_INT, nullptr); m_vao.release(); }glClear的参数包含了颜色缓冲和深度缓冲两个 bit少了GL_DEPTH_BUFFER_BIT的话上一帧的深度信息会残留旋转时模型的某些部分会消失。setUniformValue(uMatrix, m_matrix)是 Qt 的封装它把QMatrix4x4直接转成着色器里的mat4。glDrawElements第一个参数是图元类型GL_TRIANGLES表示每 3 个索引拼一个三角形第二个参数 36 是索引数量第三个参数是索引数据类型第四个参数必须传nullptr因为在 EBO 已经绑定进 VAO 的情况下这个值代表索引缓冲内的偏移量传0或nullptr都是从索引 0 开始读。如果把它误传成一个非空指针OpenGL 会把它当成一个无效地址去读内存直接导致程序崩溃这个坑在论坛里几乎每周都有人踩。4. 旋转与四元数避免万向锁的连续旋转实现4.1 投影矩阵与视图矩阵把旋转放到正确的坐标系里旋转不是只乘一个旋转矩阵就完事。一个顶点从模型局部坐标到屏幕坐标至少要经过模型矩阵旋转、缩放、平移、视图矩阵把相机摆到目标位置、投影矩阵透视裁剪三步。最常见的画面异常——旋转后图形被拉长——就是投影矩阵没有随窗口宽高比更新导致的这个问题放到第 5 章细说。这里先把组合方式固定下来void GLWidget::resizeGL(int w, int h) { if (h 0) { h 1; } m_projection.setToIdentity(); m_projection.perspective(45.0f, float(w) / float(h), 0.1f, 100.0f); } void GLWidget::paintGL() { // ... QMatrix4x4 view; view.lookAt(QVector3D(0.0f, 1.5f, 4.0f), QVector3D(0.0f, 0.0f, 0.0f), QVector3D(0.0f, 1.0f, 0.0f)); m_matrix m_projection * view * m_modelMatrix; // ... }perspective的四个参数第一个是垂直视场角45 度是人眼比较舒服的取值第二个float(w) / float(h)是宽高比窗口 800×600 时约为 1.33这里必须转成浮点再除整数除法会直接得到 1第三个 0.1 和第四个 100.0 是近裁剪面和远裁剪面单位是视图坐标系下的距离。相机的lookAt三个参数分别是眼睛位置、观察目标点、向上的方向向量。眼睛放在(0, 1.5, 4)视线指向原点这样模型是俯视偏侧面的角度旋转时立体感比正前方更明显。矩阵乘法的顺序是投影矩阵乘视图矩阵再乘模型矩阵这个顺序不能换顶点先做模型变换再做视图变换最后做投影变换。写反了就出现“模型绕相机转”而不是“模型原地转”的诡异效果。4.2 QQuaternion 做增量旋转左乘右乘决定绕谁转连续旋转如果用欧拉角也就是绕 X 轴、Y 轴、Z 轴分别记录角度很快就会碰到万向锁问题当绕 X 轴旋转 90 度后Y 轴和 Z 轴在视觉上重合继续调整会出现“卡死”或者“反转”。工程里的旋转变量直接用QQuaternion它没有角度顺序问题组合旋转时只需要关心四元数乘法顺序。QQuaternion m_rotation; // 初始为单位四元数表示不旋转 void GLWidget::updateRotation(float angleDegrees) { QQuaternion delta QQuaternion::fromAxisAndAngle(QVector3D(0.0f, 1.0f, 0.0f), angleDegrees); m_rotation delta * m_rotation; // 在局部坐标系下绕 Y 轴转 } QMatrix4x4 modelMatrix QMatrix4x4(m_rotation.toRotationMatrix());fromAxisAndAngle的第一个参数是旋转轴这里用(0.0f, 1.0f, 0.0f)表示绕竖直轴转第二个参数是这次转多少度。乘法顺序的解释要非常小心delta * m_rotation表示“在物体的局部坐标系里施加 delta 旋转”因为四元数乘法从右往左应用最右边的m_rotation先作用delta 后作用。反过来m_rotation * delta表示“在世界坐标系里绕固定轴转”。单轴旋转时两者效果一样但一旦同时叠加绕 X 轴和绕 Y 轴顺序错一个就会看到旋转轴漂移模型像被推倒一样乱翻。这是四元数用法里最微妙的一个点也是我建议所有人在自己的工程里做一次对比实验的验证项。QQuaternion转成矩阵用toRotationMatrix()然后包给QMatrix4x4再参与前面m_projection * view * m_modelMatrix的乘法。Qt 的重载让这步非常简洁不需要手写四元数转矩阵的公式也避开了很多人在这里因公式抄错导致的旋转错乱。4.3 用 QElapsedTimer 控制旋转速度别按帧固定角度很多简单 Demo 直接在paintGL里写m_rotationAngle 1.0f这样每帧旋转 1 度。看起来没问题但帧率不稳定时60FPS 的机器转得慢30FPS 的机器转得快不同机器上旋转速度差一倍。正确做法是用经过的时间乘角速度void GLWidget::GLWidget(QWidget *parent) : QOpenGLWidget(parent) { m_lastTime 0; m_timerId startTimer(16); // 请求约 60FPS } void GLWidget::timerEvent(QTimerEvent *event) { if (event-timerId() ! m_timerId) { return; } if (m_lastTime 0) { m_lastTime m_elapsedTimer.elapsed(); return; } qint64 now m_elapsedTimer.elapsed(); float deltaSeconds (now - m_lastTime) / 1000.0f; m_lastTime now; float degreesPerSecond 30.0f; float angleDelta degreesPerSecond * deltaSeconds; updateRotation(angleDelta); update(); // 请求 Qt 在下一帧重绘 }startTimer(16)不是硬性保证 60 帧它只是告诉 Qt 事件循环“大约 16 毫秒后发一个定时器事件”。Windows 上定时器粒度接近 15.6 毫秒Linux 上要好一些所以代码里必须用m_elapsedTimer.elapsed()计算真实流逝时间再用它算旋转角度这样无论定时器漂移多少旋转速度都恒定在每秒 30 度。update()不会立即重绘它只是把窗口标记为“需要更新”Qt 会在下一轮事件循环里调用paintGL这样避免了在paintGL里递归调用update导致的事件风暴。5. Qt OpenGL 常见问题排查五个反复踩到的坑5.1 图形被拉伸变形投影矩阵没有跟随宽高比走现象模型转起来后正方形面变成明显的长方形窗口越窄越长。原因resizeGL里没有重新计算投影矩阵或者计算时用了整数除法。透视投影的视锥体必须把宽高比传进去否则 OpenGL 会按窗口的像素比例拉伸所有顶点。解决在resizeGL里重建投影矩阵并保护h 0的边界情况void GLWidget::resizeGL(int w, int h) { if (h 0) h 1; m_projection.setToIdentity(); m_projection.perspective(45.0f, float(w) / float(h), 0.1f, 100.0f); update(); }同时检查 CMake 里是否启用了高 DPI 缩放QApplication::setHighDpiScaleFactorRoundingPolicy在某些平台上会让逻辑尺寸和物理尺寸不一致resizeGL拿到的宽高可能不是像素宽高必要时在resizeGL里打印w和h对比窗口实际大小来判断。5.2 画面花屏或顶点错乱VAO 和 VBO 的绑定顺序反了现象立方体有的面颜色错乱或者整个模型变成一堆乱飞的三角形偶尔伴随GL_INVALID_OPERATION报错。原因先在m_vao.bind()之前调用了m_vbo.bind()和glVertexAttribPointer导致属性配置没有记录到 VAO 里绘制时 VAO 是空的或者m_ebo没有在m_vao.bind()之后绑定索引缓冲丢失。解决严格按照这个顺序写m_vao.create()-m_vao.bind()-m_vbo.bind()-m_vbo.allocate()-setAttributeBuffer-enableAttributeArray-m_ebo.bind()-m_ebo.allocate()-m_vao.release()。这段代码只做一次资源初始化不要在paintGL里重复执行。5.3 切窗口黑屏GL 上下文销毁后 GPU 资源全部失效现象窗口最小化后恢复或从全屏切换回来画面变成黑屏继续操作偶尔段错误。原因QOpenGLWidget在切换过程中可能销毁并重建 OpenGL 上下文。之前创建的 VAO、VBO、着色器程序这些 GPU 资源随旧 context 一起失效但 C 对象仍然存在下一次paintGL再bind()时实际绑定的是一个无效对象。解决把 GPU 资源创建全部放进initializeGL()因为 Qt 的机制是当 context 重建后initializeGL会再次被调用。在函数开头需要先释放旧资源void GLWidget::initializeGL() { if (m_program) { m_program-removeAllShaders(); delete m_program; m_program nullptr; } if (m_vao.isCreated()) { m_vao.destroy(); } // ... 重新创建所有缓冲和着色器 }把m_program、m_vao等都声明为成员变量并在initializeGL里做幂等重建是规避这个问题的通用写法。5.4 颜色或坐标数据对不上attribute location 与 setAttributeBuffer 不匹配现象渲染结果里颜色全是同一个值或者顶点位置错乱像被揉过的纸团。原因着色器里没有写layout (location N)编译器自动分配的编号可能不是 0 和 1与 C 侧的编号对不上。另一个常见原因是setAttributeBuffer的偏移和 stride 写错比如把offsetof(Vertex, color)手写成12结构体一改就错。解决着色器必须显式声明 location如上文的layout (location 0) in vec3 aPos;。如果是从现有资源改造可以在link()之后调用m_program-attributeLocation(aPos)来获得真实编号再传进setAttributeBuffer这样即使着色器没有手写 location 也能匹配。偏移量一律用offsetof不要用魔法数字。5.5 旋转乱飘矩阵乘法顺序写反现象模型在旋转时明显不在原地而是绕着相机转或者同时绕多轴旋转时轴的方向一直在变。原因m_matrix m_projection * view * m_modelMatrix写成了m_modelMatrix * view * m_projection顶点先做了投影变换再移出裁剪空间结果完全不可控。四元数旋转的乘法顺序也可能写反m_rotation m_rotation * delta变成了世界系增量。解决统一采用“投影 * 视图 * 模型”的顺序并在代码注释里写明每个矩阵的坐标系。四元数增量旋转默认用delta * m_rotation如果你确实需要世界系旋转再加注释说明。验证方法是把一个顶点手算进矩阵在纸上推导一遍它应该落在屏幕哪个位置再和实际渲染对比。6. 用帧率与截屏验证旋转效果交给时间戳而不是眼睛旋转是否流畅、是否匀速人眼只能看个大概。要量化验证资源里这套实现是否正确我通常做两个检查第一是统计实际帧率确认定时器和paintGL没有产生事件堆积第二是在固定旋转角度抓取截屏用像素比对判断矩阵是否稳定。帧率统计放在paintGL里每半秒更新一次平均值void GLWidget::paintGL() { static int frameCount 0; static QElapsedTimer fpsTimer; static float fps 0.0f; frameCount; if (fpsTimer.elapsed() 500) { fps frameCount * 1000.0f / fpsTimer.restart(); frameCount 0; qDebug() FPS: fps; } glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT); // ... 正常绘制 ... }fpsTimer.restart()返回距离上次调用经过的毫秒数同时把计时器归零。这里frameCount * 1000.0f / fpsTimer.restart()的单位是“帧/秒”如果打印结果长期低于 55优先检查paintGL里是否做了耗时的 CPU 计算或者把抗锯齿倍数从 4 降到 2。事件循环里如果定时器触发的频率过高比如把startTimer(16)改成startTimer(0)Qt 会疯狂派发定时器事件paintGL被反复调用帧率反而下降这个现象我也踩过。截屏验证的做法是让程序运行到某个特定角度时暂停然后抓一张图void GLWidget::captureFrame(const QString filePath) { QImage img this-grab().toImage(); img.save(filePath); }grab()是QWidget提供的方法它会读取 OpenGL 渲染结果并转成QImage。我在验证资源里矩阵顺序时会让模型先绕 Y 轴转 90 度再截屏然后和手工QMatrix4x4::rotate(90, 0, 1, 0)计算的预期坐标对比理论上原本正对着屏幕的红色面应该转到右侧如果截屏里前面仍然是红色说明旋转根本没生效多半是 uniform 矩阵没有传进着色器。之后再把绕 X 轴和绕 Y 轴各 45 度叠加观察四元数版本的旋转是否平滑过渡欧拉角版本在这个角度附近是否出现“卡顿”感。从那次在演示现场因为旋转轴漂移翻车之后我每次拆这类 Qt OpenGL 工程都强制先跑一遍最小立方体用例确认投影宽高比、attribute 布局、矩阵乘法顺序这三条链路没问题再往里面堆业务逻辑。时间戳校验帧率、固定角度截屏已经成了我的肌肉记忆希望能帮到你少走一段弯路。本文还有配套的精品资源点击获取
