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 的绘制范围"]
源码定位
OgreMain/include/OgreMesh.h:Mesh(mSubMeshList/mSubMeshNameMap/mAABB、createSubMesh/getSubMesh)OgreMain/src/OgreMesh.cpp:Mesh::createSubMesh与_setBounds实现OgreMain/include/OgreSubMesh.h:SubMesh(vertexData/indexData/useSharedVertices/setMaterialName)
上游引用固定到 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 与顶点声明 。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。