《OGRE 3D 渲染引擎原理与架构》15.1 最小的 Root 启动
最小的 OGRE 程序从 Root 开始:Root 构造时自动创建 LogManager 与默认日志,把版本号拼成字符串;initialise 要求先选渲染系统,通过 OgreAssert(mActiveRenderer) 断言并置 mIsInitialised。createSceneManager 转发到工厂注册表创建场景管理器。lab 用 C++ 复现这组启动序。
category
最小的 OGRE 程序从 Root 开始:Root 构造时自动创建 LogManager 与默认日志,把版本号拼成字符串;initialise 要求先选渲染系统,通过 OgreAssert(mActiveRenderer) 断言并置 mIsInitialised。createSceneManager 转发到工厂注册表创建场景管理器。lab 用 C++ 复现这组启动序。
LogManager 是全局日志仓库:它继承 Singleton 与 LogAlloc,用 std::map 管理多个 Log,第一个创建的日志自动成为默认日志,logMessage 转发到默认日志。createLog 可指定 suppressFileOutput 纯逻辑日志,供 LogListener 转发。lab 用 C++ 复现单例注册表与默认日志转发。
OGRE 从不靠返回值报错:Exception 继承 std::exception 携带错误码、描述、来源函数与文件行号;ExceptionCodes 枚举一套错误码,ExceptionFactory 用 switch 把码映射到派生异常。OGRE_EXCEPT 宏自动填入 __FILE__/__LINE__。lab 用 C++ 复现错误码到具体异常的分发。
OGRE 的日志以 Log 类为核心:LogMessageLevel 四级(TRIVIAL/NORMAL/WARNING/CRITICAL),logMessage 按 lml >= mLogLevel 过滤,警告级走 cerr、其余走 cout,并落盘加 flush。LogListener 可在落盘前用 skipThisMessage 拦截。lab 用 C++ 复现级别过滤与输出分流。
OGRE 把内存按使用类别分类:OGRE_ALLOC_T/OGRE_FREE 带 category 参数,STL 容器用带 category 的分配器(STLAllocator<T, DefaultAllocPolicy, Category>)。每种类别独立统计,便于定位内存归属与泄漏。lab 用 C++ 复现分类统计与带 category 的 std::vector 分配器。
OGRE 的 SharedPtr 在 v14 里是 std::shared_ptr 的子类,仅作向后兼容:旧的 bind/useCount/getPointer/isNull/setNull 映射到 reset/use_count/get/operator bool。它可隐式转成 std::shared_ptr,static_pointer_cast/dynamic_pointer_cast 直接沿用标准库。lab 用 C++ 复现这个包装子类与旧 API 映射。
AlignedMemory 是对齐内存分配器:allocate 多分配 alignment 字节,把指针补齐到对齐边界,偏移量存进 result[-1];deallocate 用 result[-1] 找回原指针释放。AlignedAllocator 是其 STL 兼容包装,供 SIMD 友好的容器使用。lab 用 C++ 复现这套偏移头技巧并验证各对齐粒度。
renderOneFrame 是渲染循环的核心:_fireFrameStarted → _updateAllRenderTargets → _fireFrameEnded,任一环节返回 false 即退出。FrameEvent 的 timeSinceLastFrame 由调用方传入,timeSinceLastEvent 在每次派发前用计时器重算。lab 用 C++ 复现一帧的事件序列与提前退出。
全 45 篇的章节索引:从 RenderSystem 抽象出发,依次处理硬件缓冲与顶点声明、GPU 程序与参数、Pass 状态合并、RenderQueue 排序、Compositor 后处理,再逐一走进 GL3Plus/Vulkan/Metal/D3D11 后端,覆盖纹理采样、帧缓冲交换链、渲染到纹理、深度模板、多线程,最后装配成跨后端渲染器。
卷二《渲染系统与后端》全 45 篇的目录与学习路径:从 RenderSystem 抽象、硬件缓冲、GPU 程序到 RenderQueue、Compositor 后处理,再逐一走进 GL3Plus/Vulkan/Metal/D3D11 后端,最后以跨后端渲染器装配收束。
把卷二收束成一段装配流程:Root::initialise 初始化 active 后端,createRenderWindow 委托 _createRenderWindow 并做一次性后初始化,createSceneManager 把后端交给场景管理器,renderOneFrame 走 frameStarted→更新目标→frameEnded。lab 复现完整装配与一帧循环。
跨后端抽象的秘密在 Root 持有的 RenderSystemList 与抽象基类:插件 install() 注册后端,loadPlugin 拉起 dllStartPlugin,场景只持有抽象 RenderSystem 指针,setRenderSystem 换 active 后同一场景零改动。lab 复现换后端的行为差异。
Root 用 RenderSystemList 保存所有已加载的渲染后端:插件 install() 时 addRenderSystem 登记,getAvailableRenderers 返回候选列表,getRenderSystemByName 按名查找,setRenderSystem 切换 active 并 shutdown 旧后端。lab 复现登记、查找与切换。
ResourceBackgroundQueue 是资源操作的线程封装:每个方法把工作包成 std::packaged_task 交给共享 WorkQueue,返回 std::future<void>。OGRE_THREAD_SUPPORT 不等于 1 时 load 在后台 prepare、主线程 load,监听回调在主线程泵里触发。lab 复现分阶段与 future 就绪。
WorkQueue 抽象把后台任务统一管起来:Request/Response 作为遗留兼容结构保留,新 API 用 addTask/std::function 直接投递;DefaultWorkQueueBase 用双队列(后台 + 主线程)加请求门控,worker 线程数默认 1,主线程预算 10ms。lab 复现 FIFO 与门控。
Root 的 addFrameListener/removeFrameListener 不直接改活动集,而是写 mAdded/mRemoved 待办集,派发前 _syncAddedRemovedFrameListeners 先删后加。活动集是 std::set<FrameListener*>,按指针升序派发;任一回调返回 false 立即短路,派发中被标记移除的监听器本轮跳过。lab 用 C++ 复现这套 pending 注册与派发。
一帧里所有渲染目标按优先级调度:RenderSystem::_updateAllRenderTargets 只更新 active 且 autoUpdated 的目标,update(swap) 先重画再按需换缓冲;Root::_updateAllRenderTargets 先全部 update(false) 再统一 swap。lab 复现优先级顺序与过滤。
深度缓冲由 RenderSystem 池化管理:setDepthBufferFor 用 poolNum+FSAA(+尺寸) 组合哈希定位 DepthBufferMap 桶,桶内找第一张兼容缓冲复用,找不到才新建入池。POOL_NO_DEPTH 直接跳过。lab 复现共享、分桶与能力开关对复用的影响。
StencilState 结构把模板测试的全部参数聚合成一个对象:比较函数、三种操作、参考值与三个掩码、enabled 与双面标记。CompareFunction 枚举来自 OgreCommon.h。setStencilBufferParams 先改缓存,仅当 enabled 才调用 setStencilState 下发。lab 复现门控语义。
DepthBuffer 抽象类承载深度/模板缓冲,成员只有池 ID、宽高、FSAA 与手动标记。isCompatible 用「宽高不小于目标且 FSAA 相同」判定可否附着;附着/摘除通过 mAttachedRenderTargets 集合双向通知。lab 复现兼容判定与附着集合维护。