Documentation

Start a new tile request list.

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): tsmTileReqBegin.

In order to support the asynchronous receipt of terrain tile data over a network, we use a model whereby we built a request list of tile data, send that list, and then use the new tile data as it is received from the server. This model can of course be easily applied to local disk access also.

We build the request list by making a call to tsmStartReqTiles, then making multiple calls to tsmReqTiles to specify all of the tiles that we want to receive, then we call tsmStopReqTiles.

Once we have called tsmStopReqTiles then we can start reading in the tiles as they are received (trivial from local disk!) by calling a function such as tsmGetNextTile.