int tsmCopyAllTiles ( TsmConnection in, TsmConnection out )

Copies an entire pyramid of tiles

Documentation

Copies an entire pyramid of tiles.

This function will take an input connection and an output connection. It will then proceed to copy every tile from the input connection to 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.

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 can handle the full collection of tiles from the input pyramid. 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 using tsmSet in order to decide whether you want this function to display a progress meter as it goes along, or to be silent.

Returns:
TRUE if copy completed successfully, FALSE if failed.
Parameters:
in - the input (read) connection to get the tiles from
out - the output (write) connection to send the tiles to
Author:
Martin Reddy
Version:
4 March 1998
See Also:
tsmCopyTile, tsmCopyTspec, tsmCopyTspecField


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

Back to tsmApi Home Page