《OGRE 3D 渲染引擎原理与架构》3.3 编解码器
编解码器用静态注册表管理:Codec 抽象定义 encode/decode 与 magicNumberToFileExt,registerCodec 按类型挂进 msMapCodecs,getCodec 先小写化扩展名再查,getCodec(magic) 遍历注册表用魔数反查文件扩展名。lab 复现 Png/Jpeg 两个解码器的注册、大小写查找与魔数识别。
category
编解码器用静态注册表管理:Codec 抽象定义 encode/decode 与 magicNumberToFileExt,registerCodec 按类型挂进 msMapCodecs,getCodec 先小写化扩展名再查,getCodec(magic) 遍历注册表用魔数反查文件扩展名。lab 复现 Png/Jpeg 两个解码器的注册、大小写查找与魔数识别。
自定义存档扩展文件访问层:Archive 纯虚接口(open/list/find/exists/getModifiedTime)把「容器里的文件」抽象出来,FileInfo 携带文件元数据,ArchiveFactory::createInstance 按类型造实例,ArchiveManager::addArchiveFactory/load 注册与分发。lab 复现内存存档的通配查询与工厂加载。
自定义资源类型的核心是 Resource 加载状态机与 ResourceManager 句柄分配:LoadingState 六态(UNLOADED/PREPARING/PREPARED/LOADING/LOADED/UNLOADING),prepare/load 沿状态推进,createImpl 纯虚造实例,createResource 取句柄并登记去重。lab 复现状态机与句柄分配语义。
MovableObjectFactory 是注册进 Root 的造物工厂:getType 提供类型名,createInstanceImpl 纯虚钩子供子类实现,destroyInstance 默认 delete;requestTypeFlags 为真时由 Root 分配唯一类型掩码用于场景查询过滤。lab 复现工厂创建/销毁与类型标志分配。
Renderable 是渲染队列里真正可画的单元:派生类必须实现 getMaterial/getRenderOperation/getWorldTransforms 三个纯虚方法,preRender/postRender 提供临渲染钩子,DEFAULT_PRIORITY=100 参与队列排序。lab 复现一个最小 Renderable 子类与把 Renderable 塞进队列的过程。
自定义场景内容第一步是继承 MovableObject:它同时提供挂节点、渲染距离、可见性、类型名与包围盒等基础设施,派生类必须实现 getMovableType/getBoundingBox/getBoundingRadius/_updateRenderQueue 四个契约。lab 复现一个最小 MovableObject 子类的生命周期。
写一个自定义插件就是实现四个钩子:install 创建工厂对象、initialise 注册进 Root、shutdown 反注册、uninstall 销毁;Root::installPlugin 用 mIsInitialised 决定是否立即调 initialise,loadPlugin 约定取 dllStartPlugin 符号。lab 复现 OctreePlugin 式骨架的注册与生命周期。
DynLib 封装动态库的跨平台加载:三个 DYNLIB 宏把 dlopen/LoadLibrary 收敛成统一接口,load() 先按平台补全后缀(.dll/.so.X.Y/.dylib/.js)再加载,getSymbol 用 dlsym/GetProcAddress 取函数地址。lab 复现后缀补全决策与加载/取符号/卸载。
插件接口是 OGRE 一切扩展的入口:Plugin 定义五个纯虚方法 getName/install/initialise/shutdown/uninstall,形成「安装/系统初始化」与「系统关停/卸载」两对钩子;Root::installPlugin 注册,loadPlugin 从 DLL 触发 dllStartPlugin。lab 复现插件生命周期调用顺序。
全 45 篇的章节索引:从实体网格渲染与相机视口出发,经过可见性剔除、光照阴影、粒子地形分页,覆盖骨骼与顶点动画、天空雾效、布告板、Overlay 与 RTSS 实时着色器,最后以完整场景渲染装配收束。
卷三《场景内容与特效》全 45 篇的目录与学习路径:从实体网格渲染、相机视口、可见性剔除到光照阴影、粒子地形分页,再覆盖骨骼/顶点动画、天空雾效、布告板、Overlay 与 RTSS,最后以完整场景渲染装配收束。
完整一帧渲染由 Root::renderOneFrame 驱动:_fireFrameStarted -> _updateAllRenderTargets -> _fireFrameEnded,任一返回 false 即中止;FrameListener 的注册/移除经延迟同步集合生效,frameStarted/frameRenderingQueued/frameEnded 是三个回调点。源码在 OgreMain/src/OgreRoot.cpp 与 OgreMain/include/OgreFrameListener.h。lab 复现帧循环状态机与监听器同步。
相机视口装配把 RenderTarget、Camera、Viewport 连成三元组:Viewport 构造时把相对矩形缩放成实际像素矩形,_updateDimensions 在 autoAspectRatio 为真时同步相机 aspect;aspect 进入视锥投影,固定垂直 FOV 按 aspect 缩放水平视场。源码在 OgreMain/ 的 OgreViewport.cpp 与 OgreFrustum.cpp。lab 复现尺寸换算、aspect 同步与投影缩放。
场景装配从 Root::createSceneManager 开始:SceneManagerEnumerator 按类型名登记工厂(默认 DefaultSceneManager),createSceneManager 查重名实例、按类型找工厂、空名自动编号;SceneManager 再按名登记场景节点与相机。源码在 OgreMain/ 的 OgreRoot.cpp、OgreSceneManagerEnumerator.cpp 与 OgreSceneManager.cpp。lab 复现工厂登记、实例创建与命名冲突。
RTSS 与场景集成的关键在 scheme:Material::getBestTechnique 按活动 scheme 取技术,缺失时回落默认 scheme;createShaderBasedTechnique 为目标 scheme 生成可编程技术并登记映射,同 dstScheme 冲突拒绝。源码在 OgreMain/src/OgreMaterial.cpp 与 Components/RTShaderSystem/src/OgreShaderGenerator.cpp。lab 复现 scheme 选择、回落与技术替换。
子渲染状态(SubRenderState)把一段着色器功能(变换、颜色、光照、纹理、雾)建模成可排序单元:getType 返回唯一类型名,getExecutionOrder 对齐 FFPShaderStage 阶段常量;RenderState::addTemplateSubRenderState 收集模板子状态,同类型覆盖、其余按执行顺序排序。源码在 Components/RTShaderSystem/ 的 OgreShaderSubRenderState.h、OgreShaderFFPRenderState.h 与 OgreShaderRenderState.cpp。lab 复现阶段枚举、排序与同类型覆盖。
RTSS(实时着色器系统)从既有固定管线材质自动生成着色器:ShaderGenerator 单例登记子渲染状态工厂(addSubRenderStateFactory),并把源 technique scheme 映射到目标 scheme(createShaderBasedTechnique / hasShaderBasedTechnique)。源码在 Components/RTShaderSystem/ 的 OgreShaderGenerator.h/.cpp。lab 复现工厂注册与 scheme 映射。
覆盖层在场景之后进入渲染队列:Overlay::_findVisibleObjects 把队列默认组切成 RENDER_QUEUE_OVERLAY、优先级设为 mZOrder*100-1,再对每个 2D 元素 _update 与 _updateRenderQueue;元素按 getSquaredViewDepth=10000-zOrder 排序。源码在 Components/Overlay/src/OgreOverlay.cpp 与 OgreOverlayElement.cpp。lab 复现元素树递归更新、元素到渲染操作、Z 序排序。
OverlayElement 是覆盖层里的可绘制单元:setPosition/setDimensions 按当前度量模式写入相对或像素坐标,_update 把像素/虚拟像素换算成 0..1 相对坐标;Panel 是透明分组或四边形,TextArea 逐字生成带字符颜色的顶点。源码在 Components/Overlay/ 的 OgreOverlayElement.h/.cpp 与 OgrePanelOverlayElement.h。lab 复现度量模式换算、Panel 尺寸位置与 TextArea 文本颜色。
Overlay 是渲染在场景之上的图层(HUD、菜单),OverlayManager 是它的登记中心与元素工厂注册表:create 按名把 Overlay 记入 mOverlayMap,addOverlayElementFactory 把类型工厂记入 mFactories,createOverlayElement 经工厂创建并登记元素。源码在 Components/Overlay/ 的 OgreOverlayManager.h/.cpp。lab 复现 overlay 登记、工厂注册与按类型创建。