Ogre学习笔记（5）：TerrainSceneManager

本文详细介绍了TerrainSceneManager类的功能及其实现过程，包括如何通过配置文件加载地形、地形材料设置、地形页面创建以及RayQuery的具体实现。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

TerrainSceneManager是一个OctreeSceneManager的派生类，并且是在同一个Plugin工程中。

通过调用void TerrainSceneManager::setWorldGeometry( const String& filename )来加载一个地形，参数为一个配置文件的文件名。配置文件中主要有：
WorldTexture=terrain_texture.jpg

PageSource=Heightmap

Heightmap.image=terrain.png等等。

第一步为加载config文件：

void TerrainSceneManager::loadConfig(DataStreamPtr& stream)

àTerrainSceneManager::selectPageSource()【此函数先是根据typeName找到对应的PageSource，然后赋值给mActivePageSource，然后调用mActivePageSource->initialize()】；

à目前此class只支持HeightmapTerrainPageSource类：HeightmapTerrainPageSource::initialise（）；

àHeightmapTerrainPageSource::loadHeightmap()【将height map读入到mRawData或者mImage中，视mIsRaw而定】

第二步：void TerrainSceneManager::initLevelIndexes()；

第三步：resize( AxisAlignedBox( 0, 0, 0, max_x, max_y, max_z ) );

第四步：void TerrainSceneManager::setupTerrainMaterial(void);

第五步：void TerrainSceneManager::setupTerrainPages(void)

先是创建了一个名为“Terrain”的root节点的子节点；然后初始化了TerrainPage2D mTerrainPages；最后void HeightmapTerrainPageSource::requestPage(ushort x, ushort y)【0，0】；

RequestPage函数目前只支持1个page，它先将图象数据进行浮点数缩放，然后调用“TerrainPageSource::firePageConstructed（）”通知Listener；然后调用“TerrainPage* TerrainPageSource::buildPage(Real* heightData, const MaterialPtr& pMaterial)”创建一个新的TerrainPage对象，并创建渲染需要的数据，然后调用void TerrainSceneManager::attachPage(ushort pageX, ushort pageZ, TerrainPage* page)加入到mTerrainPages中，然后调用“mTerrainRoot->addChild(page->pageSceneNode);”加入到SceneGraph中。

其中TerrainPageSource::buildPage（）是一个比较核心的函数。它首先new了一个TerrainPage对象，然后创建了一个scenenode：“page->pageSceneNode = mSceneManager->createSceneNode(name);”，然后每次循环创建一个子SceneNode，并且new一个TerrainRenderable，attach到这个子节点中。通过“TerrainRenderable::initialise（）”来创建vb等。根据这段代码分析，TerrainPage的对象图：