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 引用同一个顶点/索引缓冲,但材质可能不同,所以会被分到不同的渲染组或批次。
源码定位
OgreMain/include/OgreEntity.h:Entity类(79-)、mMesh/mSubEntityList成员、setMaterialName(411-)OgreMain/include/OgreSubEntity.h:SubEntity(62-)、setMaterialName(133-)、getParent(189-)OgreMain/include/OgreRenderable.h:Renderable契约(63-)
上游引用固定到 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 可渲染对象与渲染操作 。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。