translatePosition

previous: iMeshFederation::tileForQuery()

Contents, API Reference, Interfaces, iMeshFederation, translatePosition

iMeshFederation::translatePosition()

Description

Translates positions between the overlapping sections of adjacent meshes in this federation.

Syntax

cPosition translatePosition(tSigned32 fromTileIndex, const iMesh* fromMesh, tSigned32 toTileIndex, const iMesh* toMesh, const cPosition& fromPosition) const;

Parameters

	fromTileIndex		The index of the mesh within this federation for the source point.
	fromMesh		An iMesh built for the tile at fromTileIndex.
	toTileIndex		The index of the mesh within this federation to translate the position to. This mesh must be adjacent to the source mesh.
	toMesh		An iMesh built for the tile at toTileIndex.
	fromPosition		The position to translate. In addition to being a valid position on the source mesh, this position must also be within the 'represented region' for that mesh.

Return Value

A position equivalent to fromPosition, but on the target mesh.
If the to and from meshes have been built correctly to correspond with the specified tiles in this federation, and if the source position is within the 'represented region' for the source mesh, then this translation should not fail, and a valid position on the target mesh will be returned. Otherwise, the translation may fail, in which case an explicitly invalid position will be returned.

next: Interface iSourceTiling