PathEngine home previous: iMeshFederation::buildTileMeshFromLocalGroundTiles()next: iMeshFederation::coordinatesAreInsideRange()
Contents, API Reference, Interfaces, iMeshFederation, buildTileMeshFromLocalGroundTiles_IGround

iMeshFederation::buildTileMeshFromLocalGroundTiles_IGround()

Description

Generates an iMesh object for the specified tile in this federation, from local ground mesh tiles.

Syntax

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

Parameters

tileIndexThe index of the federation tile for which a mesh is being built.
tiling An iSourceTiling object defining the position and placement of 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

A set of named attributes to control how the geometry is processed.

Some 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 local ground tiles contain geometry within the represented region range for the federation tile being built then a newly created Interface iMesh object is constructed from this geometry to serve as the federation tile mesh for the federation tile with the specified index.
Otherwise, if there is no geometry in the relevant range, zero will be returned.

Remarks

The set of ground objects to load and pass into this method should be determined by calling iMeshFederation::getGroundTilesOverlapped(), with the same tiling object and federation tile index as used in this query.
The ground object pointers should appear in the same order as returned by that method, with zero pointers where ground tiles do not exist (because there is no geometry local to that tile).

No pointers to the ground objects passed into this method are retained after the query completes, and these ground objects can then be deleted safely by the calling application.

Note that the source ground tiles are in 'federation world coordinates', with the resulting mesh geometry being generated in local coordinates for the tile being generated.

See Also

iMeshFederation::buildTileMeshFromLocalGroundTiles()

C# Mapping

Mesh buildTileMeshFromLocalGroundTiles_IGround(int tileIndex, SourceTiling tiling, Ground[] groundTiles, string[] options);

Documentation for PathEngine release 6.04 - Copyright © 2002-2024 PathEnginenext: iMeshFederation::coordinatesAreInsideRange()