《OGRE 3D 渲染引擎原理与架构》7.1 GL3Plus 渲染系统

GL3Plus 渲染系统把 OGRE 的 RenderOperation 翻译成 OpenGL 调用:getName 声明子系统身份,initConfigOptions 预置 Reversed Z-Buffer 等选项,_render 把 operationType 映射成 GL 图元,_createVao/_bindVao/_destroyVao 管理 VAO 句柄。源码在 RenderSystems/GL3Plus/src/OgreGL3PlusRenderSystem.cpp。lab 复现图元映射与 VAO 生命周期。

7.1 GL3Plus 渲染系统

OGRE 的 RenderSystem 是一层抽象接口,GL3PlusRenderSystem 是它在 OpenGL 3+ 上的实现:把高层 RenderOperation(顶点缓冲、索引缓冲、图元类型)翻译成 glBindVertexArray、glDrawArrays 这一串调用。这一节看它的身份声明、配置选项、图元映射和 VAO 生命周期。

它是 GL 子系统的核心实现类,位于 RenderSystems/GL3Plus,与 7.2 的 GL3PlusHardwareBuffer、7.3 的 GLSL 管线和 8.x 的 Vulkan 渲染系统互为姊妹实现。

身份与配置:getName / initConfigOptions

RenderSystemManager 靠 getName() 辨识子系统,GL3PlusRenderSystem 返回固定字符串:

// RenderSystems/GL3Plus/src/OgreGL3PlusRenderSystem.cpp:GL3PlusRenderSystem::getName(v14.6.3 源码摘录,已删减)
const String& GL3PlusRenderSystem::getName(void) const
{
    static String strName("OpenGL 3+ Rendering Subsystem");
    return strName;
}

initConfigOptions() 在父类基础选项之上追加 GL3Plus 特有的开关。三个选项都非 immutable(可在运行期改):

// RenderSystems/GL3Plus/src/OgreGL3PlusRenderSystem.cpp:GL3PlusRenderSystem::initConfigOptions(v14.6.3 源码摘录,已删减)
void GL3PlusRenderSystem::initConfigOptions()
{
    GLRenderSystemCommon::initConfigOptions();

    ConfigOption opt;
    opt.name = "Reversed Z-Buffer";
    opt.possibleValues = {"No", "Yes"};
    opt.currentValue = opt.possibleValues[0];
    opt.immutable = false;

    mOptions[opt.name] = opt;

    opt.name = "Separate Shader Objects";
    opt.possibleValues = {"No", "Yes"};
    opt.currentValue = opt.possibleValues[1];
    opt.immutable = false;

    mOptions[opt.name] = opt;

    opt.name = "Debug Layer";
    opt.possibleValues = {"Off", "On"};
    opt.currentValue = opt.possibleValues[0];
    opt.immutable = false;

    mOptions[opt.name] = opt;
}

Reversed Z-Buffer 默认关闭、Separate Shader Objects 默认开启、Debug Layer 默认关闭——这三个默认值直接决定了 GL3Plus 在运行期走哪条分支。lab 里我们只复现前两个选项的默认值。

_render:把 operationType 映射成 GL 图元

_render 是绘制入口。拿到 RenderOperation 后先绑定 VAO 与索引缓冲,再用一个 switch 把 OGRE 的抽象图元类型翻译成 GL 枚举:

// RenderSystems/GL3Plus/src/OgreGL3PlusRenderSystem.cpp:GL3PlusRenderSystem::_render(v14.6.3 源码摘录,已删减)
        // Determine the correct primitive type to render.
        GLint primType;
        switch (op.operationType)
        {
        case RenderOperation::OT_POINT_LIST:
            primType = GL_POINTS;
            break;
        case RenderOperation::OT_LINE_LIST:
            primType = GL_LINES;
            break;
        case RenderOperation::OT_LINE_LIST_ADJ:
            primType = GL_LINES_ADJACENCY;
            break;
        case RenderOperation::OT_LINE_STRIP:
            primType = GL_LINE_STRIP;
            break;
        case RenderOperation::OT_LINE_STRIP_ADJ:
            primType = GL_LINE_STRIP_ADJACENCY;
            break;
        default:
        case RenderOperation::OT_TRIANGLE_LIST:
            primType = GL_TRIANGLES;
            break;
        case RenderOperation::OT_TRIANGLE_LIST_ADJ:
            primType = GL_TRIANGLES_ADJACENCY;
            break;
        case RenderOperation::OT_TRIANGLE_STRIP:
            primType = GL_TRIANGLE_STRIP;
            break;
        case RenderOperation::OT_TRIANGLE_STRIP_ADJ:
            primType = GL_TRIANGLE_STRIP_ADJACENCY;
            break;
        case RenderOperation::OT_TRIANGLE_FAN:
            primType = GL_TRIANGLE_FAN;
            break;
        }

注意 default 落在 OT_TRIANGLE_LIST → GL_TRIANGLES:OGRE 枚举里带 _ADJ 后缀的邻接变体是 GL 3.2+ 才有的,普通三角形列表是兜底。lab 里我们用简化映射验证「点、线、三角带、三角扇」到 GL 常量的对应。

VAO 生命周期:_createVao / _bindVao / _destroyVao

顶点数组对象(VAO)是 GL 侧的一次性配置句柄。GL3Plus 用三个函数管理它的生老病死,并处理跨上下文延迟销毁——非当前上下文的 VAO 不能立刻 glDeleteVertexArrays,要先入延迟队列:

// RenderSystems/GL3Plus/src/OgreGL3PlusRenderSystem.cpp:GL3PlusRenderSystem::_createVao / _destroyVao / _bindVao(v14.6.3 源码摘录,已删减)
uint32 GL3PlusRenderSystem::_createVao()
{
    uint32 vao = 0;
    OGRE_CHECK_GL_ERROR(glGenVertexArrays(1, &vao));
    return vao;
}

void GL3PlusRenderSystem::_destroyVao(GLContext* context, uint32 vao)
{
    if(context != mCurrentContext)
        context->_getVaoDeferredForDestruction().push_back(vao);
    else
        _getStateCacheManager()->deleteGLVertexArray(vao);
}
//-----------------------------------------------------------------------
void GL3PlusRenderSystem::_bindVao(GLContext* context, uint32 vao)
{
    OgreAssert(context == mCurrentContext, "VAO used in wrong OpenGL context");
    _getStateCacheManager()->bindGLVertexArray(vao);
}

_bindVao 用 OgreAssert 强制「当前上下文校验」——VAO 在哪个上下文创建就必须在哪个上下文使用。_destroyVao 的延迟队列配合 7.2 会看到的 buffer graveyard 思路一致:OpenGL 对象不能跨线程/跨上下文随意销毁。

GL3Plus 顶点数组封装了什么

GL3Plus 的绑定包含 VAO、顶点流、索引缓冲与输入声明。VAO 的有效性依赖当前上下文和记录的绑定。实际绘制还取决于图元、索引类型与范围。

定位绘制问题时先检查上下文,再核查 VAO 是否因顶点声明或缓冲变化更新。最后从 draw 命令反查索引起点和数量。

一次 GL3Plus 索引提交

flowchart TD
  A["SceneManager 提交 RenderOperation"] --> B["选择当前上下文和 VAO"]
  B --> C{"VAO 与输入绑定一致?"}
  C -->|"否"| D["按声明重建或更新顶点输入"]
  C -->|"是"| E["绑定输入状态"]
  D --> E
  E --> F{"启用索引?"}
  F -->|"是"| G["按类型和起点提交索引范围"]
  F -->|"否"| H["提交顶点起点与数量"]

源码定位

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

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

下面用纯 C++ 复现 GL3PlusRenderSystem 的入口语义:子系统名、配置默认值、图元映射、VAO 句柄生命周期。它与 src/07-1-gl-render-system.cpp 逐字节一致:

// file: src/07-1-gl-render-system.cpp
// tier: L1
// verify: clang++ -std=c++20 -I. src/07-1-gl-render-system.cpp -o bin/07-1-gl-render-system && ./bin/07-1-gl-render-system
//
// 复现 GL3PlusRenderSystem 的关键入口(对应 OgreGL3PlusRenderSystem.h 120-207 与
// OgreGL3PlusRenderSystem.cpp 174-178、186-203、933-1005、1283-1310):
//   getName 返回 "OpenGL 3+ Rendering Subsystem";
//   initConfigOptions 预置 Reversed Z-Buffer / Separate Shader Objects;
//   _render 把 RenderOperation::operationType 映射成 GL 图元类型并绑定 VAO;
//   _createVao/_bindVao/_destroyVao 管理 VAO 句柄生命周期。
// 独立最小验证,非 OGRE 源码。
#include "verify.h"

#include <cstdint>
#include <string>
#include <unordered_map>
#include <vector>

namespace ogre_repro {

enum class OperationType : uint8_t {
  OT_POINT_LIST = 1,
  OT_LINE_LIST = 2,
  OT_LINE_STRIP = 3,
  OT_TRIANGLE_LIST = 4,
  OT_TRIANGLE_STRIP = 5,
  OT_TRIANGLE_FAN = 6
};

// GL 常量(glcorearb.h 中的实际值)
constexpr int32_t GL_POINTS = 0x0000;
constexpr int32_t GL_LINES = 0x0001;
constexpr int32_t GL_LINE_STRIP = 0x0003;
constexpr int32_t GL_TRIANGLES = 0x0004;
constexpr int32_t GL_TRIANGLE_STRIP = 0x0005;
constexpr int32_t GL_TRIANGLE_FAN = 0x0006;

struct Option {
  std::string name;
  std::string currentValue;
  bool immutable;
};

class GL3PlusRenderSystem {
 public:
  const std::string& getName() const {
    static std::string strName("OpenGL 3+ Rendering Subsystem");
    return strName;
  }

  void initConfigOptions() {
    Option opt;
    opt.name = "Reversed Z-Buffer";
    opt.currentValue = "No";
    opt.immutable = false;
    mOptions[opt.name] = opt;
    opt.name = "Separate Shader Objects";
    opt.currentValue = "Yes";
    opt.immutable = false;
    mOptions[opt.name] = opt;
  }

  // 对应 _render 的图元映射 switch
  int32_t toGLPrimitive(OperationType t) const {
    switch (t) {
      case OperationType::OT_POINT_LIST:
        return GL_POINTS;
      case OperationType::OT_LINE_LIST:
        return GL_LINES;
      case OperationType::OT_LINE_STRIP:
        return GL_LINE_STRIP;
      case OperationType::OT_TRIANGLE_STRIP:
        return GL_TRIANGLE_STRIP;
      case OperationType::OT_TRIANGLE_FAN:
        return GL_TRIANGLE_FAN;
      default:
        return GL_TRIANGLES;
    }
  }

  uint32_t createVao() { return ++mNextVao; }
  void bindVao(uint32_t vao) { mBoundVao = vao; }
  void destroyVao(uint32_t vao) { mFreedVaos.push_back(vao); }
  uint32_t getBoundVao() const { return mBoundVao; }

  std::unordered_map<std::string, Option> mOptions;
  uint32_t mNextVao = 0;
  uint32_t mBoundVao = 0;
  std::vector<uint32_t> mFreedVaos;
};

}  // namespace ogre_repro

int main() {
  using namespace ogre_repro;

  GL3PlusRenderSystem rs;
  CHECK(rs.getName() == "OpenGL 3+ Rendering Subsystem");

  rs.initConfigOptions();
  CHECK(rs.mOptions["Reversed Z-Buffer"].currentValue == "No");
  CHECK(rs.mOptions["Separate Shader Objects"].currentValue == "Yes");
  CHECK(!rs.mOptions["Reversed Z-Buffer"].immutable);

  // 图元映射
  CHECK(rs.toGLPrimitive(OperationType::OT_POINT_LIST) == GL_POINTS);
  CHECK(rs.toGLPrimitive(OperationType::OT_LINE_LIST) == GL_LINES);
  CHECK(rs.toGLPrimitive(OperationType::OT_LINE_STRIP) == GL_LINE_STRIP);
  CHECK(rs.toGLPrimitive(OperationType::OT_TRIANGLE_LIST) == GL_TRIANGLES);
  CHECK(rs.toGLPrimitive(OperationType::OT_TRIANGLE_STRIP) == GL_TRIANGLE_STRIP);
  CHECK(rs.toGLPrimitive(OperationType::OT_TRIANGLE_FAN) == GL_TRIANGLE_FAN);

  // VAO 生命周期
  uint32_t vao1 = rs.createVao();
  uint32_t vao2 = rs.createVao();
  CHECK_EQ(vao1, uint32_t(1));
  CHECK_EQ(vao2, uint32_t(2));
  rs.bindVao(vao1);
  CHECK_EQ(rs.getBoundVao(), vao1);
  rs.destroyVao(vao2);
  CHECK_EQ(rs.mFreedVaos.size(), size_t(1));
  CHECK_EQ(rs.mFreedVaos[0], vao2);

  return lab::report("07-1 GL3Plus 渲染系统");
}

本机实测(Apple clang 16,clang++ -std=c++20):编译通过(-Wall 零警告),断言 15/15 通过。

小结

  • GL3PlusRenderSystem::getName() 返回固定身份字符串,RenderSystemManager 靠它选择后端。
  • initConfigOptions() 追加 Reversed Z-Buffer(默认 No)、Separate Shader Objects(默认 Yes)、Debug Layer(默认 Off)三个运行期可改选项。
  • _render 的核心是把 RenderOperation::operationType switch 成 GL 图元枚举,三角形列表是默认兜底。
  • VAO 生命周期三函数:_createVao 生成句柄、_bindVao 强制当前上下文、_destroyVao 非当前上下文走延迟销毁队列。

阅读导航:上一节:6.3 CompositorChain 实现 · 下一节:7.2 GL 硬件缓冲与顶点数组 。

继续阅读

探索更多技术文章

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

全部文章 返回首页

「books」更多文章

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