PagedGeometry版本：1.1
ONE.靜態樹a).創建PagedGeometry對象，用于管理草體的細節
PagedGeometry *trees = new PagedGeometry();
1
trees->setCamera(camera); //Set the camera so PagedGeometry knows how to calculate LODs
2 trees->setPageSize(80); //Set the size of each page of geometry
3 trees->setInfinite(); //Use infinite paging mode
4 trees->addDetailLevel<BatchPage>(150, 50); //Use batches up to 150 units away, and fade for 30 more units
5 trees->addDetailLevel<ImpostorPage>(500, 50); //Use impostors up to 400 units, and for for 50 more units b).創建草體加載器，用于加載加載草體，鋪草
TreeLoader3D *treeLoader = new TreeLoader3D(trees, TBounds(0, 0, 1500,1500));
1 trees->setPageLoader(treeLoader); //Assign the "treeLoader" to be used to load geometry for the PagedGeometry instance
2
3 //Load a tree entity
4 Entity *myEntity = sceneMgr->createEntity("Tree", "tree2.mesh");
5
6 //Setup the height function (so the Y values of trees can be calculated when they are placed on the terrain)
7 HeightFunction::initialize(sceneMgr);
8
9 //Randomly place 20,000 copies of the tree on the terrain
10 Vector3 position;
11 Radian yaw;
12 Real scale;
13 for (int i = 0; i < 20000; i++)
{
14
yaw = Degree(Math::RangeRandom(0, 360));
15
16 position.x = Math::RangeRandom(0, 1500);
17 position.z = Math::RangeRandom(0, 1500);
18 position.y = HeightFunction::getTerrainHeight(position.x, position.z);
19
20 scale = Math::RangeRandom(0.5f, 0.6f);
21
22 treeLoader->addTree(myEntity, position, yaw, scale);
23
}c).幀循環中進行更新
trees->update();
其內部有3個動作：
1.更新loader
2.更新內部對象：GeometryPageManager
3. Update misc. subsystems
StaticBillboardSet::updateAll(_convertToLocal(getCamera()->getDerivedDirection()));
d).退出時清理內存
1 //[NOTE] Always remember to delete any PageLoader(s) and PagedGeometry instances in order to avoid memory leaks.
2
3 //Delete the TreeLoader3D instance
4 delete trees->getPageLoader();
5
6 //Delete the PagedGeometry instance
7 delete trees;
8
9 //Also delete the tree entity
10 sceneMgr->destroyEntity("Tree");
TWO.動態草體動態草和靜態樹的創建如出一轍，只是將植物加載器換從“TreeLoader3D”換成了“GrassLoader”而已，順利成章的，如果要家長其他不同類的植物，只需使用一個該植物的“XXXLoader”即可。其實整個PagedGeometry中的加載器只有三個，
PageLoader派生了3個加載器：
- Forests::GrassLoader
- Forests::TreeLoader2D
- Forests::TreeLoader3D
GrassLoader創建如下：
1 grassLoader = new GrassLoader(grass);
2 grass->setPageLoader(grassLoader); //Assign the "treeLoader" to be used to load geometry for the PagedGeometry instance
3
4 //Supply a height function to GrassLoader so it can calculate grass Y values
5 HeightFunction::initialize(sceneMgr);
6 grassLoader->setHeightFunction(&HeightFunction::getTerrainHeight);GrassLoader借助一個GrassLayer對象來“植樹”：
1
//Add some grass to the scene with GrassLoader::addLayer()
2 GrassLayer *l = grassLoader->addLayer("grass");
3
4 //Configure the grass layer properties (size, density, animation properties, fade settings, etc.)
5 l->setMinimumSize(2.0f, 2.0f);
6 l->setMaximumSize(2.5f, 2.5f);
7 l->setAnimationEnabled(true); //Enable animations
8 l->setSwayDistribution(10.0f); //Sway fairly unsynchronized
9 l->setSwayLength(0.5f); //Sway back and forth 0.5 units in length
10 l->setSwaySpeed(0.5f); //Sway 1/2 a cycle every second
11 l->setDensity(1.5f); //Relatively dense grass
12 l->setFadeTechnique(FADETECH_GROW); //Distant grass should slowly raise out of the ground when coming in range
13 l->setRenderTechnique(GRASSTECH_QUAD); //Draw grass as scattered quads
14
15 //This sets a color map to be used when determining the color of each grass quad. setMapBounds()
16 //is used to set the area which is affected by the color map. Here, "terrain_texture.jpg" is used
17 //to color the grass to match the terrain under it.
18 l->setColorMap("terrain_texture.jpg");
19 l->setMapBounds(TBounds(0, 0, 1500, 1500)); //(0,0)-(1500,1500) is the full boundaries of the terraina).源碼中隊GrassLayer的說明
A data structure giving you full control over grass properties.Grass is added to the scene through GrassLoader::addLayer(). Through this class you can configure your grass layer any way you like - size, density, render technique,animation, etc. Simply call the appropriate "set" member function to set the desired property.Remember that you cannot create or delete layers directly. Layers can only be created with GrassLoader::addLayer(), and may not be deleted manually (they will be deleted when the associated GrassLoader is deleted).
- GrassLayer只能通過GrassLoader::addLayer()來創建
- GrassLoader不能直接創建或刪除
- GrassLoader不能進行手動刪除
addlayer傳給GrassLayer的參數是一個字符串，這個字符串是一個material的名字，以便渲染手動創建的草體mesh時使用。
1GrassLayer *GrassLoader::addLayer(const String &material)
2{
3 GrassLayer *layer = new GrassLayer(geom, this);
4 layer->setMaterialName(material);
5 layerList.push_back(layer);
6
7 return layer;
8}
b).草實體的創建
草體是在GrassLoader::loadPage中創建的
mesh = generateGrass_QUAD(page, layer, position, grassCount);
而loadPage是在幀循環調用“GeometryPageManager::update”時調用的，通過GeometryPageManager::update的“cacheInterval”技術實現渲染前調用一次，好比在幀循環中設置一個標志位，如果發現草實體沒有創建，則創建之。這里的generateGrass_QUAD實現了一個手動創建mesh的方法。
THREE.靜態樹和動態草一起創建2個PagedGeometry對象，分別互不干涉的各管各即可。當然需要在幀循環中分別更新了。
FOUR.2D樹和3D樹的區別
If the inability to supply a vertical coordinate to addTree() is too limiting, or you are unable to implement
a fast enough height function, please refer to TreeLoader3D. TreeLoader3D allows you to provide full 3D x/y/z
coordinates, although 40% more memory is required per tree.
更多說明見<pagedGeometry-1.1.0\include\TreeLoader2D.h>
- 2D樹非常省內存
- 2D樹對放置的3D坐標有限制
- 3D樹可以設置完全的3D坐標
- 3D樹的每一顆樹都比2D樹多占用40%的內存