Documentation

Copies one pyramid level of tiles.

This function will take an input connection and an output connection. It will then proceed to copy every tile from the specified level of input connection to the same level of the output connection. The two connections can be for different media, e.g. DPSS and localdisk. If an error occurs copying any single tile then the function will exit immediately with a FALSE return code.

A level refers to a single resolution layer of a dataset. That is, each dataset contains a number of different resolutions of the same data, where each lower resolution being half that of its parent. If you simply want to copy the entire multi-resolution dataset, then you can use the tsmCopyAllTiles function.

N.B. you should ensure that the output connection has a valid tspec associated with it before using this function, and that it specifies a dataset size that contains the specified level number. The best way to do this is to do a tsmCopyTspec or tsmCopyTspecField before calling this function.

You can set the TSM_PROGRESS_METER setting for the input connection using tsmSet in order to decide whether you want this function to display a progress meter as it goes along, or to be silent.