《OGRE 3D 渲染引擎原理与架构》4.1 Vector 与 Quaternion
v14.6.3 的向量是模板化的 Vector<dims,T>,Vector3 只是 Vector<3,Real> 的别名,旧的 OgreVector3.h 已退化为弃用桩。四元数 Quaternion 用角轴构造,FromAngleAxis 把公式 q=cos(A/2)+sin(A/2)*axis 落成代码。lab 用 C++ 复现点积叉积、角轴构造与向量旋转。
category
v14.6.3 的向量是模板化的 Vector<dims,T>,Vector3 只是 Vector<3,Real> 的别名,旧的 OgreVector3.h 已退化为弃用桩。四元数 Quaternion 用角轴构造,FromAngleAxis 把公式 q=cos(A/2)+sin(A/2)*axis 落成代码。lab 用 C++ 复现点积叉积、角轴构造与向量旋转。
插件注册的顺序是引擎可预测性的来源:loadPlugins 在构造期按序 install,窗口建好后 oneTimePostWindowInit 才统一 initialisePlugins,关停时按安装逆序 shutdown+uninstall。晚注册插件由 mIsInitialised 守卫补 initialise。lab 用 C++ 复现两个插件的完整时序。
插件以动态库形式存在,OgreDynLib 是加载动态库的封装:保存句柄,按符号名取地址。Root::loadPlugin 从库里找 dllStartPlugin 符号并调用,找不到则抛 ERR_ITEM_NOT_FOUND。符号解析失败、重复加载去重是这套机制的两个关键点。lab 用 C++ 符号表复现查找与缺失语义。
插件是 OGRE 扩展性的载体。Plugin 抽象类只有五个纯虚方法:getName、install、initialise、shutdown、uninstall,构成完整的生命周期。install 只做核心层可做的事,initialise 等窗口建好、渲染系统可用才做。lab 用 C++ 复现生命周期与「系统未初始化不 initialise」的分支。
Root 的清理是构造的镜像:shutdown 先停工作队列、关场景管理器、卸插件、清资源组,最后打印 OGRE Shutdown 横幅;析构再按创建倒序释放各管理器,先销毁依赖别人的,后销毁基础。清理顺序错误会踩到悬空引用。lab 用 C++ 复现 shutdown 五步与关键字齐全断言。
Root 构造完成只是初始化上半场,真正的启动三件事:选渲染后端、建场景管理器、跑渲染循环。renderOneFrame 的管线是 frameStarted → 更新所有渲染目标 → frameEnded,监听器可在帧开始否决整帧。本节用源码摘录讲清启动与帧管线,lab 用 C++ 复现渲染一帧的事件序列与否决语义。
Root 是 OGRE 的引擎单例,继承 Singleton<Root>,全进程只有一个实例。构造顺序有讲究:日志管理器最先,之后是动态库、归档、资源组,再到材质、网格、骨架管理器,最后加载插件。第二次构造会被断言拦截。lab 用 C++ 复现 Singleton 模板与创建顺序日志。
OGRE 用 CMake 构建,最低版本 3.13,project 声明版本 14.6.3 与代号 Tsathoggua。构建选项区分 WorkQueue 线程化、资源线程安全与资源管理器严格度。版本三元组在 CMake 与头文件里双向存在,靠宏压缩成 32 位整数互相衔接。lab 用 C++ 解析 project 行并断言版本字段。
v14.6.3 的源码包顶层是 OgreMain、Components、RenderSystems、PlugIns、Samples、Tools 六大目录。OgreMain 是唯一的核心库,219 个 .h 文件装下场景管理、资源系统、渲染抽象。CMakeLists.txt 用固定顺序 add_subdirectory 组装整棵树。本节梳理阅读地图,lab 用 C++ 复现目录清单并断言计数。
OGRE 是一个模块化的开源 C++ 纯渲染引擎,MIT 许可,2000 年起步延续至今。它只解决渲染这一件事:场景管理、渲染后端与资源系统,物理与游戏循环交给宿主引擎。本节从 v14.6.3 的许可证头、README 定位与版本宏讲起,lab 用 C++ 复现版本号压缩与启动横幅。
每台设备带三个信号:最近心跳、往返延迟、错误率。诊断函数按固定阈值给出健康档位;聚合只做计数。关键在于判定是逐设备的——一台离线只在 offline 上加一,不会把其他设备拖下水。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的多设备诊断。
一个预览会话可以挂多台设备。控制指令只有三种:播放、暂停、单步;单步只在暂停态有效——运行中单步没有语义,回执里直接拒绝。每条回执带递增序号,远端据此对齐请求与响应。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的真机预览控制。
远端与编辑器之间的消息是「长度前缀 + 正文」的帧:正文以竖线分隔类型、序号与载荷,载荷里的竖线原样保留。流式读取时帧可能被拆成多段到达,重组器按长度前缀切出完整帧;握手用 hello/ack 两步确认两端就绪。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的远程调试协议。
在代码里埋标记(开始加载、开始上传、结束),Profiler 把相邻标记的间隔当作一个阶段的耗时,并按耗时排序找出热点。标记本身只带名字与时间戳,无需知道任何渲染细节。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的事件标记剖析。
采样分配器的每一次 alloc/free,实时维护当前占用、历史峰值、按标签的分类占用,以及一份未释放清单。峰值与泄漏是两回事:峰值告诉你最坏时刻用多少,泄漏告诉你现在还欠谁。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的内存分配追踪。
帧时间线由带起止时间的区间组成,分 CPU 与 GPU 两类。嵌套区间先合并再求覆盖长度,避免父子重复计数;重叠时间是 CPU 覆盖与 GPU 覆盖的交集——它决定这一帧能不能并行喂饱两张卡。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的帧时间线分析。
调试面板要把一长串采样变成人能读的图形:最小值、最大值、均值、中位数给数值概览,等宽直方图给分布形状,环形缓冲给滚动窗口。三者都只依赖数字数组,脱离界面也能测。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的运行时数据可视化。
Watch 表达式是一串属性路径:a.b[0].c。求值器把它拆成记号逐个下钻,中途遇到空值就返回 undefined。对象检查器把任意值展开成有限深度的树,深度到顶就不再展开——调试器不能被一个巨大对象卡死。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的Watch 与对象检查。
调试器的核心不是界面,而是在哪一行停下来的判定:断点按文件加行号命中;步进三种模式各自给下一次到达设定停止条件——step in 任意新帧都停,step over 只在同层或更浅处停,step out 只在更浅处停。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的编辑器调试器。
重载期间最危险的是旧代码的异步结果回到新代码。版本栅栏给每次重载发一个递增 epoch,异步结果回来先验 epoch,对不上就丢弃;同时取消所有挂起的后台任务,避免它们在新域里继续跑。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的热重载一致性。