Documentation

Write a single tile to a dataset.

Writes the given tile buffer to the dataset for the specified connection. There are a number of connection settings that can be defined via the tsmSet function in order to control the characteristics of this function. They include the TSM_WRITE_TIFFS, and TSM_JPEG_QUALITY settings (see tsmSet for more information).

N.B. when writing tiles to a TIFF file on local disk, the order in which you write the data is important. The tiles should be written in row-major, left-to-right order, e.g. p0p0, p1p0, p2p0,... p0p1, p1p1, p2p1... etc. The TIFF file will be created automatically when then first tile is output, and it will be closed automatically when then last tile is written. If you wish to write a number of levels of tiles, then you should write out all of the tile for a particular level at the same time (consecutively).

If you have started logging using the tsmBeginLogging call, then this function will automatically generate a TV_TILE_WRITE event to the log file for the requested tile.