《OGRE 3D 渲染引擎原理与架构》7.1 Mesh 与 SubMesh

Mesh 是网格资源的容器,一个 Mesh 由一到多个 SubMesh 组成,每个 SubMesh 绑定一种材质、可有专属顶点数据或共享 Mesh 级顶点。useSharedVertices 的语义是 vertexData==nullptr 即共享。Mesh 同时持有包围盒用于剔除。lab 用 C++ 复现 SubMesh 列表、名字索引与共享顶点语义。

7.1 Mesh 与 SubMesh

网格(Mesh)是 OGRE 里「一个可渲染的几何体」的资源形态。它由**一个或更多子网格(SubMesh)**组成。一个角色模型常常是「身体 + 头 + 武器」多个 SubMesh 拼起来的,每个 SubMesh 绑一种材质、可有自己的顶点数据。

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

cg 三卷讲网格的数学与几何表示(顶点、法线、拓扑);helio 卷二的网格数据流讲从资产到引擎的管线。本系列 7.1~7.3 讲 OGRE 源码里网格数据怎么组织成 C++ 对象:Mesh/SubMesh 容器、顶点声明与绑定、索引范围。

Mesh:资源的子类,子网格的容器

OgreMesh.h 里 Mesh 继承两条线:Resource(6.1 的资源生命周期)与 AnimationContainer(携带骨架动画)。它本身是 SubMesh 列表的持有者:

// OgreMain/include/OgreMesh.h:Mesh 类声明(v14.6.3 源码摘录,已删减)
    class _OgreExport Mesh: public Resource, public AnimationContainer
    {
        ...
        /** A list of submeshes which make up this mesh.
            Each mesh is made up of 1 or more submeshes, which
            are each based on a single material and can have their
            own vertex data (they may not - they can share vertex data
            from the Mesh, depending on preference).
        */
        SubMeshList mSubMeshList;
        ...
        AxisAlignedBox mAABB;

关键成员就三个:mSubMeshList(子网格列表)、mSubMeshNameMap(名字→子网格下标,O(1) 定位)、mAABB(包围盒,用于剔除)。创建子网格与查询的公开接口:

// OgreMain/include/OgreMesh.h:createSubMesh/getSubMesh(v14.6.3 源码摘录,已删减)
        SubMesh* createSubMesh(void);
        SubMesh* createSubMesh(const String& name);
        ...
        SubMesh* getSubMesh(size_t index) const {
            return mSubMeshList[index];
        }
        SubMesh* getSubMesh(const String& name) const;

包围盒 mAABB 由 _setBounds(序列化读入时)或 _calcBoundsFromVertexBuffer(从顶点算)填充,渲染系统的剔除靠它,7.2 的顶点数据只是几何本体。

SubMesh:材质 + 顶点/索引数据

每个 SubMesh 是一个 SubMeshAlloc 对象,持有顶点数据、索引数据与材质名:

// OgreMain/include/OgreSubMesh.h:SubMesh 成员(v14.6.3 教学示意,参照上游同名实现,已删减)
        /** Dedicated vertex data (only valid if useSharedVertices = false).
            This data is completely owned by this submesh.
        */
        VertexData *vertexData;
        /// replace the vertex data with a new one
        void resetVertexData(VertexData* data = nullptr)
        {
            delete vertexData;
            vertexData = data;
            useSharedVertices = data == nullptr;
        }
        /// Face index data
        IndexData *indexData;
        ...
        bool useSharedVertices;
        void setMaterialName(const String& matName, ...);
        const String& getMaterialName(void) const;

最值得记的一句话是 resetVertexData 里的 useSharedVertices = data == nullptr——「共享顶点」不是显式开关,而是「SubMesh 没有专属顶点数据」的自然推论。两种情况:

  • 共享(useSharedVertices == true):SubMesh 的 vertexData 为 nullptr,几何顶点来自 Mesh 级共享顶点。适合一个模型里顶点完全共用、只是材质/索引分开的部分;
  • 专属(useSharedVertices == false):SubMesh 有自己完整的 vertexData。适合拓扑差异大的部分。

材质绑定是一句 setMaterialName,材质对象本身由 MaterialManager 按名解析(第 8 章),SubMesh 只存名字。

为什么一个 Mesh 拆成多个 SubMesh

因为渲染是按「材质 × 顶点格式」分组的。一个 SubMesh 一个材质,渲染器就能把同材质的 SubMesh 合批;一个 SubMesh 一套顶点格式,顶点声明就能整组提交。若把整把武器塞进一个 SubMesh,要么材质混着画、要么顶点格式不统一。所以「容器拆分 = 渲染分组」的对应关系,是理解 Mesh 结构的钥匙。

共享顶点与子网格索引

共享顶点数据归 Mesh。SubMesh 的 useSharedVertices 决定绘制引用父资源的顶点数据还是自己的 VertexData。即便两段几何共享顶点,IndexData、材质和提交范围仍可分别变化。

诊断时打印每个 SubMesh 的 useSharedVertices、indexStart、indexCount 与引用的顶点缓冲。由这些字段还原 draw 的输入,再到卷二第 2 章检查实际寻址。

网格中独立与共享的数据

flowchart LR
  M["Mesh"] --> V["共享 VertexData"]
  M --> A["SubMesh A"]
  M --> B["SubMesh B"]
  A -->|"使用共享顶点"| V
  B -->|"使用独立顶点"| VB["本段 VertexData"]
  A --> IA["本段 IndexData 和材质"]
  B --> IB["本段 IndexData 和材质"]
  IA -.-> RA["Renderable A 的绘制范围"]
  IB -.-> RB["Renderable B 的绘制范围"]

源码定位

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

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

下面复现 SubMesh 列表、名字索引与共享顶点语义。它与 src/07-1-mesh-submesh.cpp 逐字节一致:

// file: src/07-1-mesh-submesh.cpp
// tier: L1
// verify: clang++ -std=c++20 -I. src/07-1-mesh-submesh.cpp -o bin/07-1-mesh-submesh && ./bin/07-1-mesh-submesh
//
// 复现 OgreMesh 与 OgreSubMesh 的组织:Mesh 持有 SubMesh 列表,
//   createSubMesh 追加子网格,SubMesh 可共享顶点(useSharedVertices)。
// 独立最小验证,非 OGRE 源码。
#include "verify.h"

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

namespace ogre_repro {

// 对应 VertexData 的简化:只保留顶点范围
struct VertexData {
  unsigned int vertexStart = 0;
  unsigned int vertexCount = 0;
};

// 对应 IndexData 的简化:只保留索引范围
struct IndexData {
  unsigned int indexStart = 0;
  unsigned int indexCount = 0;
};

// 对应 OgreSubMesh:顶点/索引数据 + 材质 + 共享标记
class SubMesh {
 public:
  VertexData* vertexData = nullptr;
  IndexData* indexData = nullptr;
  bool useSharedVertices = true;  // 无专属顶点数据则共享 Mesh 级
  std::string mMaterialName;
  std::string mName;

  SubMesh() {
    vertexData = nullptr;  // 默认共享顶点(OGRE:useSharedVertices=data==nullptr)
    indexData = new IndexData;
  }
  ~SubMesh() { delete indexData; }

  void setMaterialName(const std::string& matName) { mMaterialName = matName; }
  const std::string& getMaterialName() const { return mMaterialName; }
};

// 对应 OgreMesh:SubMesh 列表 + 名字索引 + 包围盒
class Mesh {
 public:
  std::vector<SubMesh*> mSubMeshList;
  std::unordered_map<std::string, unsigned short> mSubMeshNameMap;
  double minX = 0, minY = 0, minZ = 0, maxX = 0, maxY = 0, maxZ = 0;

  ~Mesh() {
    for (auto s : mSubMeshList) delete s;
  }

  // 对应 Mesh::createSubMesh()
  SubMesh* createSubMesh() {
    SubMesh* sm = new SubMesh;
    mSubMeshList.push_back(sm);
    return sm;
  }

  // 对应 Mesh::createSubMesh(name)
  SubMesh* createSubMesh(const std::string& name) {
    SubMesh* sm = createSubMesh();
    sm->mName = name;
    mSubMeshNameMap[name] = static_cast<unsigned short>(mSubMeshList.size() - 1);
    return sm;
  }

  SubMesh* getSubMesh(size_t index) const { return mSubMeshList[index]; }
  size_t getNumSubMeshes() const { return mSubMeshList.size(); }

  // 对应 Mesh::_setBounds:记录包围盒
  void setBounds(double mnx, double mny, double mnz,
                 double mxx, double mxy, double mxz) {
    minX = mnx; minY = mny; minZ = mnz;
    maxX = mxx; maxY = mxy; maxZ = mxz;
  }
};

}  // namespace ogre_repro

int main() {
  using namespace ogre_repro;

  Mesh mesh;

  // 三个子网格,两个有名字
  SubMesh* body = mesh.createSubMesh("Body");
  SubMesh* head = mesh.createSubMesh("Head");
  SubMesh* unnamed = mesh.createSubMesh();

  CHECK_EQ(mesh.getNumSubMeshes(), 3u);
  CHECK(mesh.getSubMesh(0) == body);
  CHECK(mesh.getSubMesh(1) == head);
  CHECK(mesh.getSubMesh(2) == unnamed);

  // 名字索引:getSubMesh(name) 定位(对应 mSubMeshNameMap)
  CHECK(body->mName == "Body");
  CHECK(head->mName == "Head");

  // 默认共享顶点:无专属 vertexData 时 useSharedVertices 为真(OGRE 语义)
  CHECK(body->useSharedVertices);
  CHECK(body->vertexData == nullptr);

  // 子网格各自独立:给专属数据后不再共享
  body->vertexData = new VertexData;
  body->vertexData->vertexCount = 100;
  body->useSharedVertices = false;
  CHECK(!body->useSharedVertices);
  CHECK(body->vertexData->vertexCount == 100u);

  // 索引数据存在(IndexData 自带)
  body->indexData->indexCount = 300;
  CHECK(body->indexData->indexCount == 300u);

  // 材质名绑定(对应 setMaterialName)
  body->setMaterialName("Materials/Skin");
  CHECK(body->getMaterialName() == "Materials/Skin");

  // 包围盒记录(对应 _setBounds)
  mesh.setBounds(-1, -1, -1, 1, 1, 1);
  CHECK(mesh.minX == -1.0 && mesh.maxX == 1.0);
  CHECK(mesh.minZ == -1.0 && mesh.maxZ == 1.0);

  delete body->vertexData;  // 手动持有的专属数据

  return lab::report("07-1 网格几何:Mesh 与 SubMesh");
}

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

小结

  • Mesh 继承 Resource 与 AnimationContainer,是 SubMesh 列表 + 名字索引 + 包围盒的容器。
  • SubMesh 绑定一种材质,可共享 Mesh 级顶点或持有专属顶点数据。
  • useSharedVertices = (vertexData == nullptr):共享不是开关,是「无专属数据」的推论。
  • 容器拆分对应渲染分组:一 SubMesh 一材质一顶点格式,便于合批与整组提交。

阅读导航:上一节:6.3 ResourceGroupManager 与资源组 · 下一节:7.2 VertexData 与顶点声明 。

继续阅读

探索更多技术文章

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

全部文章 返回首页

「books」更多文章

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