博客 阅读约 7 分钟

为什么 OGRE 3D 至今仍是面向对象 C++ 架构的典范

分享本文
为什么 OGRE 3D 至今仍是面向对象 C++ 架构的典范

在游戏开发和高性能图形领域,开发者经常争论经典的面向对象编程(OOP)是否仍然能与纯数据导向设计(DOD)抗衡。虽然缓存局部性和连续内存缓冲对现代 GPU 管线至关重要,但面向对象图形渲染引擎(OGRE 3D)依然是 OOP 正确实践的杰出范例。

1. 真正的抽象:隐藏底层图形 API

OOP 的核心目标之一是抽象——在隐藏复杂实现细节的同时,提供干净的高层心智模型。

OGRE 通过将场景管理与驱动级渲染解耦来抽象底层图形 API。使用 CppDepend,我们可以检查具体驱动(如 RenderSystem_GL 或 RenderSystem_Direct3D11)如何与 OgreMain 抽象层交互:

Code Quest 查询列出 RenderSystem_GL 使用的 31 个 OgreMain 抽象类型

架构启示

通过让具体后端派生自 RenderSystem、Texture 和 HardwareVertexBuffer 等关键抽象契约,OGRE 确保添加新的渲染 API(例如 Vulkan 或 WebAssembly/WebGL)时,应用逻辑或场景图遍历无需任何结构性改动。

2. 没有继承滥用的多态

C++ 框架的一个常见陷阱是过度继承——创建又深又脆弱的类层次结构,或滥用多重继承。OGRE 通过优先采用组合优于继承并保持层次结构浅层化,维持了卓越的凝聚力。

我们可以运行一条 Code Quest 查询来检查核心库中的继承深度:

from t in Types
where t.BaseClasses.Count() > 1
select new { t, NbBaseClasses = t.BaseClasses.Count(), t.DepthOfInheritance }
Code Quest 查询 OgreMain 类型的基类数量与继承深度

数据揭示了什么

  • 浅层继承树:OgreMain 中的大多数类的继承树深度(DIT)不超过 3。
  • 受控的多重继承:只有极少数类型派生自多个基类。OGRE 中的多重继承主要限于 mixin 接口(例如同时派生自领域接口和监听器或工厂基类)。

3. 使用工厂与单例模式实现干净的实例化

在大型 C++ 应用中,不受控制的对象实例化会造成紧密耦合。OGRE 通过两种基本的创建型模式解决这一问题:

用于对象创建的工厂模式

OGRE 不允许客户端代码直接用 new 实例化具体对象,而是将创建委托给专门的工厂类(如 EntityFactory、SceneManagerFactory)。

from m in Methods
where m.DepthOfCreateA("Ogre.Entity") == 1
select m
Code Quest 查询显示只有 EntityFactory 直接创建 Ogre.Entity 实例

结果:只有 EntityFactory 直接实例化 Entity 对象,确保内存管理和对象生命周期钩子完全封装。

用于系统状态的单例管理器

OGRE 使用派生自线程安全模板(Ogre::Singleton<T>)的单例来集中管理子系统:

Code Quest 查询列出派生自 Ogre.Singleton&lt;T&gt; 的 57 个类型

MeshManager、TextureManager 和 MaterialManager 等子系统都继承自这个统一模板,为开发者提供可预测、线程安全的引擎资源访问。

4. 外观模式:通过 Ogre::Root 简化引擎子系统

管理数十个专门的管理器、加载器和渲染目标会让客户端应用不堪重负。OGRE 在其入口类 Ogre::Root 中使用了外观模式(Facade Pattern)。

借助 CppDepend 的传出耦合(Efferent Coupling,EC)指标——用于衡量一个类所依赖的类型数量——我们发现 Ogre::Root 具有很高的耦合度(EC > 100)。

Code Quest 查询显示 Ogre::Root 使用了 110 个类型(传出耦合超过 100)

虽然高耦合对普通类来说通常是一种代码异味,但对外观(Facade)而言,这是深思熟虑的设计选择。Root 在统一、易用的 API 背后编排初始化、帧监听器、渲染循环和管理器生命周期。

5. 抽象度与不稳定度图

Robert C. Martin 写过一篇有趣的文章,介绍了一组可用于从子系统相互依赖的角度衡量面向对象设计质量的指标。

他在文章中对模块间相互依赖的描述如下:

是什么让设计变得僵化、脆弱、难以复用?是设计中各子系统之间的相互依赖。如果一个设计无法轻易改变,它就是僵化的。这种僵化源于:对高度相互依赖的软件进行单一修改,会在依赖模块中引发一连串的变更级联。当设计者或维护者无法预测这一变更级联的范围时,变更的影响就无法估量,变更的成本也因此无法估算。面对这种不可预测性,管理者不愿批准变更。于是设计就变得僵化。

为了对抗僵化,他引入了传入耦合、传出耦合、抽象度和不稳定度等指标。

传入耦合(Afferent Coupling):项目外部依赖于此项目内部类型的类型数量。

传出耦合(Efferent Coupling):此项目的类型所使用的项目外部类型数量。

传出耦合和传入耦合也可以应用于命名空间和类型。例如,某个特定类型的传出耦合是它直接依赖的类型数量。TypeCe 很高的类型依赖了太多其他类型。它们很复杂,通常承担着不止一项职责。

抽象度

内部抽象类型(即抽象类和接口)数量与内部类型总数之比。该指标的取值范围为 0 到 1,A=0 表示完全具体的项目,A=1 表示完全抽象的项目。

A = Na / Nc

其中:

  • A = 模块的抽象度。零代表完全具体的模块,一代表完全抽象的模块。
  • Na = 模块中抽象类的数量。
  • Nc = 模块中具体类的数量。

不稳定度

传出耦合(Ce)与总耦合之比。该指标反映项目抵御变更的能力。取值范围为 0 到 1,I=0 表示完全稳定的项目,I=1 表示完全不稳定的项目。

I = Ce / (Ce + Ca)
  • I 表示与项目相关的不稳定程度。
  • Ca 表示传入耦合,即传入的依赖。
  • Ce 表示传出耦合,即传出的依赖。

抽象度与不稳定度图和痛苦区

下面是 Ogre 项目的抽象度与不稳定度图。

OGRE 项目的抽象度与不稳定度图,包含主序列线和痛苦区

这张图背后的思想是:一个代码元素在程序中被使用得越广泛,它就应该越抽象。换句话说,避免过度依赖具体实现;应当依赖抽象。这里所说的"被广泛使用的代码元素"是指被程序中其他项目大量使用的项目(这一思想同样适用于包和类型)。

让具体类型在整个代码库中被广泛使用并不是好主意。这会在程序中形成痛苦区(Zone of Pain)——在这些区域,修改实现可能会影响程序的一大部分。而众所周知,实现的变更频率高于抽象。

上图中的主序列线(虚线)展示了抽象度和不稳定度应如何平衡。稳定的组件会位于左侧。观察主序列可以发现,这样的组件应当非常抽象,才能靠近理想线——反之,如果其抽象程度较低,它就会落在被称为"痛苦区"的区域。

使用 OOP 方法时如何对抗僵化?

正如 Robert C. Martin 在文章中所写,我们必须使用抽象类和接口,让项目更灵活,并降低代码元素之间的高耦合。

OOP 中的耦合可能由以下因素引入:

  • 继承:在采用 OOP 范式时经常被过度使用,不幸的是,在很多情况下它会让代码更加僵化。一些设计模式有助于化解继承带来的僵化,例如 Adapter 模式,它可以将继承引入的僵化降到最低。
  • 直接使用具体实现:在这种情况下代码也会变得僵化,因为当我们出于某种原因需要改用另一个库或框架时,代码很难修改。与继承一样,也有一些设计模式可以最小化这种僵化,例如 Bridge 或 Proxy。

使用 OOP 方法时,建议掌握 GoF 结构型模式;它们有助于减少耦合带来的僵化。

指标热图分析:OgreMain 中的方法级风险集中

树图(treemap)可视化了 OgreMain 组件内部的代码库层次结构,其中矩形大小代表代码规模(例如代码行数),颜色编码突出指标的严重程度(从代表低风险的蓝/绿色到代表高风险的红色,例如过高的圈复杂度或高额技术债务)。

CppDepend 的 OgreMain 指标树图:风险集中在 translate、parse、log、visit 等少数红色方法上

这一可视化的关键启示是:高风险指标只孤立地出现在方法级别,而不是表明整个类或命名空间存在系统性的架构腐化:

  • 方法级热点:树图中散布的醒目红色矩形对应着特定的独立例程——如 translate、parse、log 和 visit。这些函数是复杂度热点,很可能包含密集的控制流(例如大型 switch 块或嵌套条件循环)。
  • 健康的类与结构容器:在这些方法热点周围,父容器(类和命名空间)仍然以绿色和黄色为主。这表明 OgreMain 的整体类组织和模块边界在结构上是健康的,质量瓶颈集中在孤立的成员函数内部。
  • 有针对性的重构策略:由于红色严重度标记严格局限于 parse 和 translate 等方法,修复工作不需要重新设计类层次结构或接口。重构可以直接瞄准将这些特定函数分解为更小的、单一职责的辅助例程。

汇总指标:OGRE 为何经久不衰

使用 CppDepend 分析 OgreMain 时,高层结构指标印证了开发者们二十多年来的赞誉:

  • 高内聚:核心场景组件的低 LCOM(方法内聚缺乏度)得分表明类聚焦于单一职责。
  • 低圈复杂度:方法短小、聚焦、易于测试,避免了庞大的单体分发循环。
  • 干净的模块边界:命名空间之间的头文件循环依赖极少。

结论

OGRE 证明,只要严格执行架构原则,C++ 中的面向对象编程并非天生缓慢或过于复杂。借助 CppDepend 这样的现代静态分析工具,团队可以研究 OGRE 这样的引擎,强制推行干净的接口,防止架构腐化,构建经久耐用的 C++ 软件。

分享本文