ETM 数据分析

来源：互联网发布：mac的手绘软件编辑：程序博客网时间：2024/05/17 03:52
class TerrainImpl                       //地图 
{
    Ogre::SceneManager* mSceneMgr;     //new ET::TerrainManager(mSceneMgr); 
    Ogre::SceneNode* mTerrainNode;     //Tile的父节点  节点名默认为"ETTerrain/Terrain"  createTiles() 
    bool mTerrainLoaded;               //TerrainImpl::createTerrain()成功后 = true 
    IndexHandler* mIndexHandler;       //传给格子   createTerrain()中 mIndexHandler = new IndexHandler(mOpt.tileSize, mOpt.maxMipMapLevel); 
    TerrainInfo mInfo;                 //一个地图只存在一个地形，因为在createTerrain()中会调用destroyTerrain()  mTerrainMgr->createTerrain(terrainInfo); 
    Options mOpt;                      //格子配置项 
    std::string mInstanceName;         //不指定则为 "ETTerrain" 
    int mViewportHeight;               //初始化=0，其他地方没用到 
    Ogre::MaterialPtr mMaterial;       //mTerrainMgr->setMaterial(material); 
    
    typedef std::vector<Tile*> TileCol;
    typedef std::vector<TileCol> TileGrid;
    /** Our terrain tile grid.*/
    TileGrid mTiles;                    //格子Tile组成的网-->地形TerrainInfo   mTerrainMgr->createTerrain(terrainInfo); 
    
    bool maxLODAtBorders;           //初始化false 其他地方没用到 
};
/**
   * This class stores all basic information about the terrain, i. e. its heightmap,
   * its extents and the scaling.
   */
class _ETManagerExport TerrainInfo //地形:长、宽、高、位置、放大缩小率 
{
    /** extents of the heightmap */
    size_t mWidth, mHeight;
    /** the heightmap */
    std::vector<float> mHeightmap; // why does this NOT generate warnings?! it did with Brush //高由一格高度图描述  setHeightmap 
    
    /** offset at which the (0, 0) point of the terrain is placed in Ogre */
    Ogre::Vector3 mOffset;                     //初始化Vector3::ZERO   setExtents 
    /** scale of a terrain vertex */
    Ogre::Vector3 mScale;                      //初始化Vector3::UNIT_SCALE   setExtents 
};
/** A tile is the unit of terrain used for rendering. */
/**对于同一个TerrainInfo下的所有Tile，
他们的mSceneMgr, mTerrainMgr, mIndexHandler, mInfo, mOpt 相同
*/
class Tile : public Ogre::Renderable, public Ogre::MovableObject     //一个格子就是一个Tile，每个Tile对应一个SceneNode，一个TerrainInfo下的所有Tile共用一个父SceneNode 
{
   Ogre::SceneManager* mSceneMgr;   //场景 
   TerrainImpl* mTerrainMgr;        //格子所在的地图 
   IndexHandler* mIndexHandler;     //LOD 
   TerrainInfo& mInfo;              //格子所在的地形 
   Options mOpt;                    //配置选项：格子大小、MipMap、Vertex、Morph 
   /** Info about this tile in regards to all tiles */
   size_t mTileX, mTileZ;           //i*(mOpt.tileSize-1)  第i行 
   size_t mStartX, mStartZ;         //j*(mOpt.tileSize-1)  第j列 
   /** Current LOD */
   unsigned int mLOD;              //初始化=0 
   /** LOD change distances */
   std::vector<Ogre::Real> mLODChangeMinDistSqr;  //初始化= opts.maxMipMapLevel 
   Ogre::AxisAlignedBox mBounds;
   Ogre::Real mBoundingRadius;
   Ogre::Vector3 mCenter;
   mutable bool mLightListDirty;    //初始化=true 
   mutable Ogre::LightList mLightList;
   /** The tile's vertices */
   Ogre::VertexData* mTerrain;     //初始化=0 
   Ogre::HardwareVertexBufferSharedPtr mMainBuffer;
   std::vector<Ogre::HardwareVertexBufferSharedPtr> mDeltaBuffers;
   Ogre::Real mLODMorphFactor;
   unsigned int mLastNextLevel;    //初始化=0 
};
/** Manages the vertex LOD index buffers shared among the tiles */
class IndexHandler
{
    typedef std::map<unsigned int, Ogre::IndexData*> IndexMap;
    typedef std::vector<IndexMap> LODArray;
    LODArray mIndexes;
    size_t mTileSize;
};
struct Options
{
    size_t tileSize;
    
    unsigned int maxMipMapLevel; //MipMap等级 
    unsigned int maxPixelError;
    float factorC;
    
    bool vertexNormals;
    bool vertexTangents;
    
    bool useLODMorph;   //morph(变形) 
    float lodMorphStart;
    std::string lodMorphParam;
};
struct SplattingImpl  //表皮 
{ 
    String baseName;
    String group;         //资源组 
    uint width, height;   //表皮宽、长 
    uint channels;
    uint numTextures;     //初始化=0 
    uint numMaps;         //初始化=0 
    
    typedef vector<Impl::CoverageMap*> MapList;
    MapList maps;         //setNumMaps 
};