《OGRE 3D 渲染引擎原理与架构》1.1 实体与子实体

场景里一个可渲染的物体实例是 Entity:它持有一个 MeshPtr(mMesh)并由一组 SubEntity 指向子网格,每个 SubEntity 是 Renderable、可单独覆盖材质(setMaterialName)。lab 复现 Entity 的网格持有、子实体材质覆盖与回退语义。

1.1 实体与子实体

场景里放一个可渲染的模型,用的是 Entity。它不是几何数据本身——几何住在 Mesh 资源里,Entity 是「把一份网格实例化到场景」的轻量壳:它持有一份 MeshPtr,管理着一组 SubEntity,后者才是真正进入渲染队列的对象。这一节看这三个角色的分工。

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

卷一 7.x 讲 Mesh/SubMesh 的数据结构(顶点、索引、几何);卷二讲了 Renderable 契约如何被后端消费。这一节的 Entity 是两者之间的桥梁:它把 Mesh 的静态数据变成场景中可放置、可换材质的实例。

Entity:网格的实例壳

Entity 同时继承 MovableObject(场景图挂载点)与 Resource::Listener(监听网格重载):

// OgreMain/include/OgreEntity.h:Entity(v14.6.3 源码摘录,已删减)
    class _OgreExport Entity: public MovableObject, public Resource::Listener
    {
        // Allow EntityFactory full access
        friend class EntityFactory;
        friend class SubEntity;
    public:

        typedef std::set<Entity*> EntitySet;
        typedef std::vector<std::pair<unsigned short, bool>> SchemeHardwareAnimMap;
        typedef std::vector<SubEntity*> SubEntityList;
    private:

        /** Private constructor (instances cannot be created directly).
        */
        Entity();
        /** Private constructor - specify name (the usual constructor used).
        */
        Entity( const String& name, const MeshPtr& mesh);

        /** The Mesh that this Entity is based on.
        */
        MeshPtr mMesh;

        /** List of SubEntities (point to SubMeshes).
        */
        SubEntityList mSubEntityList;
成员含义
mMesh这份实体基于的 Mesh 资源
mSubEntityList指向各 SubMesh 的 SubEntity 列表

注意构造函数是私有的——Entity 不能直接 new,只能通过 SceneManager::createEntity 工厂创建。这与 SceneNode 一样:场景管理器是唯一的造物主,保证实例都登记在场景里。

SubEntity:可独立换材质的渲染单元

一个骑士网格往往有身体、手臂、头部三个子网格,每块默认材质不同。Entity 为每个 SubMesh 配一个 SubEntity——它是 Renderable,但最关键的能力是单独覆盖材质:

// OgreMain/include/OgreSubEntity.h:SubEntity(v14.6.3 源码摘录,已删减)
    class _OgreExport SubEntity: public Renderable, public SubEntityAlloc
// OgreMain/include/OgreSubEntity.h:SubEntity::setMaterialName(v14.6.3 源码摘录,已删减)
        void setMaterialName( const String& name, const String& groupName = ResourceGroupManager::AUTODETECT_RESOURCE_GROUP_NAME );
// OgreMain/include/OgreSubEntity.h:SubEntity::getParent(v14.6.3 源码摘录,已删减)
        Entity* getParent(void) const { return mParentEntity; }

材质覆盖的语义是「沿链回退」:SubEntity::getMaterialName() 先查自己有没有覆盖材质;没有,就用它对应的 SubMesh 默认材质。这样同一个 Mesh 资源可以被多个 Entity 实例以不同外观复用(一个绿色皮肤、一个金色皮肤),而几何完全共享。

从 SubMesh 到 SubEntity

Mesh 的每个 SubMesh 都有 indexData(三角形索引)和可选材质名;Entity 构造时遍历子网格,为每个 SubMesh 生成一个 SubEntity。渲染时每个 SubEntity 作为独立 Renderable 进队列——它们的 RenderOperation 引用同一个顶点/索引缓冲,但材质可能不同,所以会被分到不同的渲染组或批次。

源码定位

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

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

下面复现 Entity 的网格持有、子实体材质覆盖与回退。它与 src/01-1-entity-subentity.cpp 逐字节一致:

// file: src/01-1-entity-subentity.cpp
// tier: L1
// verify: clang++ -std=c++20 -I. src/01-1-entity-subentity.cpp -o bin/01-1-entity-subentity && ./bin/01-1-entity-subentity
//
// 复现 Entity/SubEntity 与材质绑定(对应 OgreEntity.h 79-、OgreSubEntity.h 62-):
//   Entity 持有一个 MeshPtr(mMesh),由多个 SubEntity 指向 SubMesh;
//   SubEntity 是 Renderable,可单独覆盖材质(setMaterialName);
//   材质覆盖沿 Entity → SubEntity 传递(getMaterial 查覆盖,无覆盖回退到 SubMesh 材质)。
// 独立最小验证,非 OGRE 源码。
#include "verify.h"

#include <memory>
#include <string>
#include <vector>

namespace ogre_repro {

// 对应 Mesh 的极简形式:名字 + 子网格列表
struct Mesh {
  std::string name;
  std::vector<std::string> subMaterialNames;  // 每子网格默认材质
};

// 对应 SubEntity(OgreSubEntity.h 62-,extends Renderable):一个子网格的渲染实例
class SubEntity {
 public:
  SubEntity(const std::string& defaultMat) : mDefaultMaterial(defaultMat) {}

  // 对应 SubEntity::setMaterialName(133-):覆盖材质,空串表示清除覆盖
  void setMaterialName(const std::string& name) { mMaterialOverride = name; }
  const std::string& getMaterialName() const {  // 对应 getMaterialName(125-)
    return mMaterialOverride.empty() ? mDefaultMaterial : mMaterialOverride;
  }
  bool hasMaterialOverride() const { return !mMaterialOverride.empty(); }

 private:
  std::string mDefaultMaterial;
  std::string mMaterialOverride;
};

// 对应 Entity(OgreEntity.h 79-,extends MovableObject, Resource::Listener)
class Entity {
 public:
  Entity(const std::string& name, std::shared_ptr<Mesh> mesh)
      : mName(name), mMesh(mesh) {
    for (const auto& m : mesh->subMaterialNames)
      mSubEntities.emplace_back(m);
  }
  const std::string& getName() const { return mName; }
  std::shared_ptr<Mesh> getMesh() const { return mMesh; }  // 对应 getMeshRef
  SubEntity* getSubEntity(size_t i) { return &mSubEntities[i]; }
  size_t getNumSubEntities() const { return mSubEntities.size(); }

 private:
  std::string mName;
  std::shared_ptr<Mesh> mMesh;  // 对应 mMesh(100-)
  std::vector<SubEntity> mSubEntities;  // 对应 mSubEntityList
};

}  // namespace ogre_repro

int main() {
  using namespace ogre_repro;

  // 一个 3 子网格的 Mesh(身体/手臂/头部各默认材质)
  auto mesh = std::make_shared<Mesh>();
  mesh->name = "knight.mesh";
  mesh->subMaterialNames = {"knight/body", "knight/arm", "knight/head"};

  Entity knight("Knight", mesh);
  CHECK(knight.getName() == "Knight");
  CHECK(knight.getMesh() == mesh);
  CHECK(knight.getNumSubEntities() == 3);

  // 子实体默认回退到子网格材质
  CHECK(knight.getSubEntity(0)->getMaterialName() == "knight/body");
  CHECK(knight.getSubEntity(2)->getMaterialName() == "knight/head");

  // 材质覆盖:只给头部换材质,其余不受影响
  knight.getSubEntity(2)->setMaterialName("knight/head_gold");
  CHECK(knight.getSubEntity(2)->getMaterialName() == "knight/head_gold");
  CHECK(knight.getSubEntity(2)->hasMaterialOverride());
  CHECK(knight.getSubEntity(0)->getMaterialName() == "knight/body");  // 未覆盖

  // 清除覆盖回退到默认
  knight.getSubEntity(2)->setMaterialName("");
  CHECK(knight.getSubEntity(2)->getMaterialName() == "knight/head");
  CHECK(!knight.getSubEntity(2)->hasMaterialOverride());

  return lab::report("01-1 实体与子实体");
}

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

小结

  • Entity 是 Mesh 的场景实例壳:持有 MeshPtr、由多个 SubEntity 组成,只能经 SceneManager 工厂创建。
  • SubEntity 是 Renderable,是真正进渲染队列的最小单元,指向一个 SubMesh。
  • 材质覆盖沿链回退:子实体自己的覆盖优先,否则用 SubMesh 默认材质——一份几何、多份外观。
  • 渲染时 SubEntity 独立成 Renderable,共享几何缓冲但可带不同材质。

阅读导航:上一节:15.3 最小跨后端渲染器 · 下一节:1.2 可渲染对象与渲染操作 。

继续阅读

探索更多技术文章

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

全部文章 返回首页

「books」更多文章

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