ETM 数据分析

 

1. class TerrainImpl                       //地图
2. {
3.     Ogre::SceneManager* mSceneMgr;     //new ET::TerrainManager(mSceneMgr);
4.     Ogre::SceneNode* mTerrainNode;     //Tile的父节点  节点名默认为"ETTerrain/Terrain"  createTiles()
5.     bool mTerrainLoaded;               //TerrainImpl::createTerrain()成功后 = true
6.     IndexHandler* mIndexHandler;       //传给格子   createTerrain()中 mIndexHandler = new IndexHandler(mOpt.tileSize, mOpt.maxMipMapLevel);
7.     TerrainInfo mInfo;                 //一个地图只存在一个地形，因为在createTerrain()中会调用destroyTerrain()  mTerrainMgr->createTerrain(terrainInfo);
8.     Options mOpt;                      //格子配置项
9.     std::string mInstanceName;         //不指定则为 "ETTerrain"
10.     int mViewportHeight;               //初始化=0，其他地方没用到
11.     Ogre::MaterialPtr mMaterial;       //mTerrainMgr->setMaterial(material);
12.     
13.     typedef std::vector<Tile*> TileCol;
14.     typedef std::vector<TileCol> TileGrid;
15.     /** Our terrain tile grid.*/
16.     TileGrid mTiles;                    //格子Tile组成的网-->地形TerrainInfo   mTerrainMgr->createTerrain(terrainInfo);
17.     
18.     bool maxLODAtBorders;           //初始化false 其他地方没用到
19. };
21. /**
22.    * This class stores all basic information about the terrain, i. e. its heightmap,
23.    * its extents and the scaling.
24.    */
25. class _ETManagerExport TerrainInfo //地形:长、宽、高、位置、放大缩小率
26. {
27.     /** extents of the heightmap */
28.     size_t mWidth, mHeight;
29.     /** the heightmap */
30.     std::vector<float> mHeightmap; // why does this NOT generate warnings?! it did with Brush //高由一格高度图描述  setHeightmap
31.     
32.     /** offset at which the (0, 0) point of the terrain is placed in Ogre */
33.     Ogre::Vector3 mOffset;                     //初始化Vector3::ZERO   setExtents
34.     /** scale of a terrain vertex */
35.     Ogre::Vector3 mScale;                      //初始化Vector3::UNIT_SCALE   setExtents
36. };
38. /** A tile is the unit of terrain used for rendering. */
39. /**对于同一个TerrainInfo下的所有Tile，
40. 他们的mSceneMgr, mTerrainMgr, mIndexHandler, mInfo, mOpt 相同
41. */
42. class Tile : public Ogre::Renderable, public Ogre::MovableObject     //一个格子就是一个Tile，每个Tile对应一个SceneNode，一个TerrainInfo下的所有Tile共用一个父SceneNode
43. {
44.    Ogre::SceneManager* mSceneMgr;   //场景
45.    TerrainImpl* mTerrainMgr;        //格子所在的地图
46.    IndexHandler* mIndexHandler;     //LOD
47.    TerrainInfo& mInfo;              //格子所在的地形
48.    Options mOpt;                    //配置选项：格子大小、MipMap、Vertex、Morph
50.    /** Info about this tile in regards to all tiles */
51.    size_t mTileX, mTileZ;           //i*(mOpt.tileSize-1)  第i行
52.    size_t mStartX, mStartZ;         //j*(mOpt.tileSize-1)  第j列
54.    /** Current LOD */
55.    unsigned int mLOD;              //初始化=0
56.    /** LOD change distances */
57.    std::vector<Ogre::Real> mLODChangeMinDistSqr;  //初始化= opts.maxMipMapLevel
59.    Ogre::AxisAlignedBox mBounds;
60.    Ogre::Real mBoundingRadius;
61.    Ogre::Vector3 mCenter;
63.    mutable bool mLightListDirty;    //初始化=true
64.    mutable Ogre::LightList mLightList;
66.    /** The tile's vertices */
67.    Ogre::VertexData* mTerrain;     //初始化=0
68.    Ogre::HardwareVertexBufferSharedPtr mMainBuffer;
69.    std::vector<Ogre::HardwareVertexBufferSharedPtr> mDeltaBuffers;
70.    Ogre::Real mLODMorphFactor;
71.    unsigned int mLastNextLevel;    //初始化=0
72. };
74. /** Manages the vertex LOD index buffers shared among the tiles */
75. class IndexHandler
76. {
77.     typedef std::map<unsigned int, Ogre::IndexData*> IndexMap;
78.     typedef std::vector<IndexMap> LODArray;
79.     LODArray mIndexes;
80.     size_t mTileSize;
81. };
83. struct Options
84. {
85.     size_t tileSize;
86.     
87.     unsigned int maxMipMapLevel; //MipMap等级
88.     unsigned int maxPixelError;
89.     float factorC;
90.     
91.     bool vertexNormals;
92.     bool vertexTangents;
93.     
94.     bool useLODMorph;   //morph(变形)
95.     float lodMorphStart;
96.     std::string lodMorphParam;
97. };
99. struct SplattingImpl  //表皮
100. { 
101.     String baseName;
102.     String group;         //资源组
103.     uint width, height;   //表皮宽、长
104.     uint channels;
105.     uint numTextures;     //初始化=0
106.     uint numMaps;         //初始化=0
107.     
108.     typedef vector<Impl::CoverageMap*> MapList;
109.     MapList maps;         //setNumMaps
110. };