Documentation

Gets a single tile from a dataset.

This function performs the same action as tsmReadTile, except that it allocates the memory for the tile buffer inside the function. You must therefore pass a pointer to the tile buffer pointer, so that the allocated memory address can be filled in for you. You free the memory that has been returned using the tsmFreeTileBuffer function as usual.

Using this function allows for future internal extensions to tsmApi that can efficiently cache a number of tile buffers for you to use in a threaded application.

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.