int tsmCopyTile ( TsmConnection in, TsmConnection out, int tx, int ty, int level )

Copy a single tile from one dataset to another

Documentation

Copy a single tile from one dataset to another.

This function will take an input connection and copy the specified tile (tx,tx,res) from this dataset to an output connection. The input connection should of course be a read connection (i.e. opened with a "r" or "rw" parameter to tsmConnect), and the output connction should be a write connection.

Of course, the connections need not be on the same medium. So for example you could copy tiles from local disk to local disk, but also from a DPSS to local disk, etc.

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 tile coordinate from the input pyramid. The best way to do this is to do a tsmCopyTspec or tsmCopyTspecField before calling this function.

Returns:
TRUE if all went peachy, FALSE if things went pear-shaped.
Parameters:
in - the input (read) connection to get the tile from
out - the output (write) connection to send the tile to
tx - the x-coordinate of the tile to read from and write to
ty - the y-coordinate of the tile to read from and write to
level - the level of the tile to read from and write to
Author:
Martin Reddy
Version:
4 March 1998
See Also:
tsmCopyLevelTiles, tsmCopyAllTiles, tsmCopyTspec, tsmCopyTspecField


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

Back to tsmApi Home Page