buildMeshFromGroundTiles

previous: iPathEngine::buildMeshFromGroundTiles()

next: iPathEngine::buildRegularSourceTiling()

Contents, API Reference, Interfaces, iPathEngine, buildMeshFromGroundTiles_IGround

iPathEngine::buildMeshFromGroundTiles_IGround()

Description

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

Syntax

std::unique_ptr<iMesh> buildMeshFromGroundTiles_IGround(const iSourceTiling& tiling, const iGround* const * groundTiles_Buffer, uint32_t groundTiles_BufferEntries, const char *const* options)

Parameters

tiling

An iSourceTiling object defining the position and placement of the ground tiles.

groundTiles_Buffer, groundTiles_BufferEntries

(See Passing Arrays.) Pointers to iGround objects for local ground tiles, or null pointers for tiles which are empty.

options

Mesh loading options may be passed into this method, to affect the final 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() or iMeshFederation::buildTileMeshFromLocalGroundTiles_IGround() can be used instead, to build a PathEngine 'mesh federation' directly from the tiled ground pieces.

The set of iGround objects passed in should correspond with the set of tiles in the supplied tiling object, and these iGround objects should be supplied in the same order as tiles in that tiling.
(The parameter specifying the size of the array 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).

C# Mapping

Mesh buildMeshFromGroundTiles_IGround(SourceTiling tiling, Ground[] groundTiles, string[] options);

next: iPathEngine::buildRegularSourceTiling()