buildMeshFromGroundTiles

previous: iPathEngine::buildMeshFromContent()

next: iPathEngine::buildRegularSourceTiling()

Contents, API Reference, Interfaces, iPathEngine, buildMeshFromGroundTiles

iPathEngine::buildMeshFromGroundTiles()

Description

Constructs a single iMesh object by connecting multiple tiled ground pieces together at tile borders.

Syntax

iMesh* buildMeshFromGroundTiles(const iSourceTiling* tiling, const iMesh* const* meshPointers, tSigned32 numberOfMeshes, const char *const* options);

Parameters

	tiling		An iSourceTiling object defining the position and placement of the ground tiles.
	meshPointers		An array of pointers to mesh objects.
	numberOfMeshes		The size of the array pointed to by meshPointers.
	options		Mesh loading options may be passed into this method, to affect the final ground mesh ground mesh construction phase. Refer to Handling Attributes for information about passing sets of named attributes.

Return Value

If the ground tiles passed in are non empty then a newly created Interface iMesh object is returned, created by connecting the ground tiles together at tile borders.
If the ground tiles are empty then a zero pointer will be returned.

Remarks

This method supports tiled content processing, in the case where a single world mesh result is desired.
When using PathEngine's 'mesh federations' feature, iMeshFederation::buildTileMeshFromLocalGroundTiles() can be used instead, to build a PathEngine 'mesh federation' directly from the tiled ground pieces.

The set of meshes passed in should correspond with the set of tiles in the supplied tiling object, and these meshes should be supplied in the same order as tiles in that tiling.
(The number of meshes parameter is essentially a check value, as this must be equivalent to the tiling size.)
Zero pointers should be passed in for any tiles which are empty (i.e. for which there is no world geometry overlapping the tile region).

The created Interface iMesh can be explicitly deleted when no longer required, but will also be deleted if iPathEngine::deleteAllObjects() is called - in either case the pointer can no longer be used. Any meshes not deleted will be cleaned up automatically when PathEngine is shut down.

next: iPathEngine::buildRegularSourceTiling()