《OGRE 3D 渲染引擎原理与架构》1.1 历史与定位:渲染引擎而非游戏引擎

OGRE 是一个模块化的开源 C++ 纯渲染引擎,MIT 许可,2000 年起步延续至今。它只解决渲染这一件事:场景管理、渲染后端与资源系统,物理与游戏循环交给宿主引擎。本节从 v14.6.3 的许可证头、README 定位与版本宏讲起,lab 用 C++ 复现版本号压缩与启动横幅。

1.1 历史与定位:渲染引擎而非游戏引擎

OGRE 全称 Object-Oriented Graphics Rendering Engine,是一个用 C++ 编写的开源渲染引擎。它从 2000 年前后起步,由 Steve Streeting 等人在 Torus Knot Software 时期维护,版权头至今保留着「Copyright (c) 2000-2014 Torus Knot Software Ltd」。2026 年我们审视它时,主线版本是 14.6.3,代号 Tsathoggua。

要理解 OGRE,先要接受一个关键定位:它是渲染引擎,不是游戏引擎。它提供渲染帧循环和材质等资源脚本。通用游戏逻辑、物理及编辑器由宿主或可选组件提供;它只负责把 3D 场景画出来。物理集成要靠 Bullet 等第三方组件(Components/Bullet),UI 要靠 Dear ImGui 集成,游戏逻辑完全由宿主程序自己写。本系列解析的就是这个「只解决渲染」的引擎,从它的场景管理、渲染后端到资源系统。

版本代号本身也值得注意:OGRE 主线与 Ogre-Next 是两条独立分支。Ogre-Next 引入了 HLMS(高级材质系统),而主线 14.x 没有 HLMS,材质仍是 Material/Technique/Pass 三级结构。本系列摘录一律以 v14.6.3 主线为准并标注版本,防止与 Next 分支混淆。

本章与站内既有内容的分工

主题站内既有内容本节做什么
引擎从零实现《游戏引擎实现原理》helio 用 TypeScript 从零写引擎内核;本节改为解析真实 OGRE 源码
渲染管线原理《渲染引擎》helio 从概念上讲帧管线;OGRE 把同样概念落成 RenderSystem/RenderQueue 这些 C++ 类
源码解析写法《Go 运行时原理》go-runtime 解析语言运行时;本系列把同一写法用到 C++ 渲染引擎
图形学原理《计算机图形学》cg 三卷推导图形学公式;本节只讲 OGRE 里这些机制写成什么样,不重推公式

一句话:别人讲「渲染管线的原理」和「从零实现一个引擎」,本系列讲「OGRE 这个真实引擎的源码里,每一层架构是怎么写的、为什么这么写」,且每个机制配一个可编译的 C++ 最小验证。

许可证与定位:从源码本身读起

OGRE 的每一个源文件头部都带着许可证。下面是 OgrePrerequisites.h 的完整文件头,它是 219 个 .h 文件里最常被 include 的一个,也是我们验证「真实源码」的起点:

// OgreMain/include/OgrePrerequisites.h:文件头(v14.6.3 源码摘录,已删减)
/*-------------------------------------------------------------------------
This source file is a part of OGRE
(Object-oriented Graphics Rendering Engine)

For the latest info, see http://www.ogre3d.org/

Copyright (c) 2000-2014 Torus Knot Software Ltd
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
-------------------------------------------------------------------------*/

MIT 许可证意味着你可以自由使用、修改、再分发。这也解释了为什么大量开源项目选择它:Gazebo 机器人仿真、ROS 的 rviz、OpenCV 的 OVIS 模块都基于 OGRE,商业游戏则有 Hob、Torchlight II 等。README 对自身的定位一句话说清:

OGRE (Object-Oriented Graphics Rendering Engine) is a proven, modular C++ renderer for custom engine development. It empowers engine programmers and industrial simulation developers to build high-performance 3D applications in C++ and Python efficiently.

翻译过来:「久经考验、模块化的 C++ 渲染器,供自定义引擎开发使用」。注意定语——renderer for custom engine development,它不是给最终用户玩的游戏,而是给引擎程序员当底座的。

版本号:一个宏怎么表达「14.6.3」

OGRE 的版本号不是字符串比较,而是把主版本、次版本、补丁号压缩进一个整数。OgrePrerequisites.h 里这样定义:

// OgreMain/include/OgrePrerequisites.h:OGRE_VERSION(v14.6.3 源码摘录,已删减)
    #define OGRE_VERSION    ((OGRE_VERSION_MAJOR << 16) | (OGRE_VERSION_MINOR << 8) | OGRE_VERSION_PATCH)

    #define OGRE_MIN_VERSION(MAJOR, MINOR, PATCH) OGRE_VERSION >= ((MAJOR << 16) | (MINOR << 8) | PATCH)

主版本占 16 位、次版本占 8 位、补丁占 8 位,合起来一个 32 位整数。14.6.3 就是 (14<<16)|(6<<8)|3 = 919043。OGRE_MIN_VERSION(14, 6, 0) 这类宏用于在源码里做编译期版本门槛判断。CMakeLists.txt 里则同时声明了字符串版本与代号:

# CMakeLists.txt:v14.6.3(源码摘录)
project(OGRE VERSION 14.6.3)
set(OGRE_VERSION_SUFFIX "")
set(OGRE_VERSION_NAME "Tsathoggua")
set(OGRE_SOVERSION ${OGRE_VERSION_MAJOR}.${OGRE_VERSION_MINOR})

OGRE_SOVERSION 取主次版本组成 14.6,用于动态库的 soname。这套「宏压缩整数 + CMake 声明字符串」的双轨制,是全书反复出现的版本管理手法。

启动横幅:引擎睁眼的第一句话

程序真正跑起来时,OGRE 在日志里打印两行横幅,位置在 Root::log 前后。这两行是我们之后验证「一个 OGRE 程序活起来了」的信号:

// OgreMain/src/OgreRoot.cpp:Root 启动横幅(v14.6.3 源码摘录,已删减)
        LogManager::getSingleton().logMessage("*-*-* OGRE Initialising");
        LogManager::getSingleton().logMessage("*-*-* Version " + mVersion);

mVersion 由 Root 构造函数用编译期版本宏拼接。引擎关闭时对应的横幅是 *-*-* OGRE Shutdown。对于本书的定位,这两行横幅也承担着一个诚实性任务:任何自称「OGRE 输出」的程序,都可以用这两行是否与真实源码一致来验证。

源码定位

上游引用固定到 OGRE v14.6.3 源码 。

可运行产物:C++ 最小验证

下面复现两个机制:OGRE_VERSION 宏的压缩计算,以及启动横幅的字符串生成。它与 src/01-1-version-banner.cpp 逐字节一致:

// file: src/01-1-version-banner.cpp
// tier: L1
// verify: clang++ -std=c++20 -I. src/01-1-version-banner.cpp -o bin/01-1-version-banner && ./bin/01-1-version-banner
//
// 复现 OgrePrerequisites.h 的 OGRE_VERSION 宏(v14.6.3)与 OgreRoot 启动横幅。
// 独立最小验证,非 OGRE 源码。
#include "verify.h"

#include <cstdio>
#include <string>

// 对应 OgrePrerequisites.h:OGRE_VERSION ((MAJOR << 16) | (MINOR << 8) | PATCH)
namespace ogre_repro {
constexpr int kVersionMajor = 14;
constexpr int kVersionMinor = 6;
constexpr int kVersionPatch = 3;

constexpr int versionNumber() {
  return (kVersionMajor << 16) | (kVersionMinor << 8) | kVersionPatch;
}

constexpr bool minVersion(int major, int minor, int patch) {
  return versionNumber() >= ((major << 16) | (minor << 8) | patch);
}

std::string banner() {
  // 对应 OgreRoot.cpp:logMessage("*-*-* OGRE Initialising") 与
  // logMessage("*-*-* Version " + mVersion)
  return "*-*-* OGRE Initialising\n*-*-* Version " +
         std::to_string(kVersionMajor) + "." + std::to_string(kVersionMinor) +
         "." + std::to_string(kVersionPatch);
}
}  // namespace ogre_repro

int main() {
  using namespace ogre_repro;

  // 14.6.3 → (14<<16)|(6<<8)|3
  CHECK_EQ(versionNumber(), (14 << 16) | (6 << 8) | 3);
  CHECK_EQ(versionNumber(), 14 * 65536 + 6 * 256 + 3);

  CHECK(minVersion(14, 6, 0));
  CHECK(minVersion(13, 6, 5));   // 旧主线仍高于 13.6.5
  CHECK(!minVersion(14, 7, 0));  // 更高版本则未达到

  const std::string b = banner();
  CHECK(b.find("*-*-* OGRE Initialising") != std::string::npos);
  CHECK(b.find("Version 14.6.3") != std::string::npos);

  std::printf("%s\n", b.c_str());
  return lab::report("01-1 历史与定位:版本横幅");
}

本机实测(Apple clang 16,clang++ -std=c++20):编译通过,断言 7/7 通过,输出启动横幅两行。

小结

  • OGRE 是 MIT 许可的模块化 C++ 渲染引擎,定位是给自定义引擎当底座。
  • 主线 v14.6.3 与 Ogre-Next 分支并存,本系列摘录一律以主线为准并标注版本。
  • 版本号用 32 位宏压缩:(MAJOR<<16)|(MINOR<<8)|PATCH。
  • 启动横幅 *-*-* OGRE Initialising 是验证程序「活起来」的信号。

阅读导航:上一节:卷一目录 · 下一节:1.2 v14.6.3 源码目录地图 。

继续阅读

探索更多技术文章

浏览归档,发现更多关于系统设计、工具链和工程实践的内容。

全部文章 返回首页

「books」更多文章

  1. 《大规模分布式计算深入解析》15.3 落地:从 Neo4j 到自研图引擎
  2. 《大规模分布式计算深入解析·图计算与图数据库内核》 · 目录与学习路径(45 篇)
  3. 《大规模分布式计算深入解析》15.2 十一卷主线:从切分到图