int tsmReadTile ( TsmConnection connect, int tx, int ty, int lev, uchar *buffer )

Gets a single tile from a dataset

Documentation

Gets a single tile from a dataset.

The tsmReadTile function retrieves a single tile from the dataset with a tile index ( tx, ty, level ). The buffer memory is assumed to be sufficiently large to hold the entire tile. N.B. This function is NOT recommended when accessing mulitple tiles from a DPSS because it has all the overhead of building and transmitting a request list for each tile. Instead, use the request list mechanism.

You can set the TSM_DONT_READ_TILES setting to TRUE using tsmSet and this function will perform no disk or network access. This may be useful for assessing your application's computational overhead.

Returns:
TRUE if successful, FALSE if error occurred.
Parameters:
connect - the dataset connection to read from.
tx - the x-coordinate of the tile to retrieve.
ty - the y-ccordinate of the tile to retrieve.
level - the level of the pyramid to retrieve from.
buffer - a buffer to write the tile data into.
Author:
Martin Reddy
Version:
13 January 1998
See Also:
tsmWriteTile, tsmConnect, tsmSet, tsmMakeTileBuffer


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

Back to tsmApi Home Page