int tsmGetNextTile ( TsmHandle *tsmh, TsmTileHeader *tileHeader, unsigned char *tileBuffer, ... )

Retrieve the tile header and data for the next tile in the queue

Documentation

Retrieve the tile header and data for the next tile in the queue.

N.B. this function is part of the old style server-centric interface to tsmApi. You should really start using the new leaner, cleaner, and sexier connection-based interface (see tsmConnect). This function is now just an emulation layer on top of the relevant connection-based function(s): tsmReadNextTile.

Once you have requested a number of tiles using tsmReqTiles, then you can use tsmGetNextTile to retrieve the tiles as they become available. This approach is primarily for accessing tiles from the DPSS, but works for any protocol.

The tile header contains various pieces of information about a tile such as its coordinates, level, etc. These can be accessed through API calls - see tsmMakeTileHeader for further details.

Returns:
TRUE if data retrieved okay, FALSE if an error occurred
Parameters:
tsmh - the open TSM session handle
tileHeader - a TSM tile header to be updated
tileBuffer - a buffer to write the tile data to
Author:
Martin Reddy
Version:
4 March 1998
See Also:
tsmReqTile, tsmMakeTileHeader


TSMAPI_RELEASE 2.1 - Release Date: 2001/01/10 19:01:12

Back to tsmApi Home Page