Misc. Reference Manual Pages TIFFtile(3tiff)
NAME
TIFFtile, TIFFTileSize, TIFFTileRowSize, TIFFVTileSize,TIFFDefaultTileSize, TIFFComputeTile, TIFFCheckTile,
TIFFNumberOfTiles - tile-related utility routines
SYNOPSIS
#include
void TIFFDefaultTileSize(TIFF* tif, uint32* tw, uint32* th)tsize_t TIFFTileSize(TIFF* tif)
tsize_t TIFFTileRowSize(TIFF* tif)
tsize_t TIFFVTileSize(TIFF* tif, uint32 nrows)
ttile_t TIFFComputeTile(TIFF* tif, uint32 x, uint32 y, uint32 z, tsample_t sample)
int TIFFCheckTile(TIFF* tif, uint32 x, uint32 y, uint32 z, tsample_t sample)
ttile_t TIFFNumberOfTiles(TIFF* tif)
TIFFDefaultTileSize returns the pixel width and height of areasonable-sized tile, suitable for setting up the TileWidth
and TileLength tags. If the tw and th values passed in arenon-zero, then they are adjusted to reflect any
compression-specific requirements. The returned width and
height are constrained to be a multiple of 16 pixels, to conform with the TIFF specification. TIFFTileSize returns the equivalent size for a tile of data as it would be returned in a call to TIFFReadTile or as it would be expected in a call to TIFFWriteTile.TIFFVTileSize returns the number of bytes in a row-aligned
tile with nrows of data. TIFFTileRowSize returns the number of bytes of a row of data in a tile.TIFFComputeTile returns the tile that contains the specified
coordinates. A valid tile is always returned. Out-of-range
coordinate values are clamped to the bounds of the image. The x and y parameters are always used in calculating a tile. The z parameter is used if the image is deeper than 1 slice (ImageDepth>1). The sample parameter is used only ifdata is organized in separate planes (PlanarConfigura-
tion=2).TIFFCheckTile returns a non-zero value if the supplied coor-
dinates are within the bounds of the image, and zero other-
wise. The x parameter is checked against the value of the ImageWidth tag. The y parameter is checked against the value of the ImageLength tag. The z parameter is checked against the value of the ImageDepth tag (if defined). Thesample parameter is checked against the value of the Sam-
plesPerPixel parameter if the data is organized in separate SunOS 5.10 Last change: 02 Apr 2004 1 Misc. Reference Manual Pages TIFFtile(3tiff) planes. TIFFNumberOfTiles returns the number of tiles in the image.See attributes(5) for descriptions of the following attri-
butes:____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | image/library/libtiff ||_____________________________|_____________________________|
| Interface stability | Uncommitted ||_____________________________|_____________________________|
libtiff(3), TIFFReadEncodedTile(3tiff), TIFFReadRawTile(3tiff), TIFFReadTile(3tiff), TIFFWriteEncodedTile(3tiff), TIFFWriteRawTile(3tiff), TIFFWriteTile(3tiff) This man page was originally written by Sam Leffler. Updated by Breda McColgan, Sun Microsystems Inc., 2004. SunOS 5.10 Last change: 02 Apr 2004 2