---
name: "TIFFtile"
section: "3tiff"
platform: "linux"
package: "libtiff-dev"
version: "4.7.0-3+deb13u3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/TIFFtile/3tiff"
---

# TIFFtile(3tiff)

tile-related utility routines

## NAME

TIFFtile - tile-related utility routines

## SYNOPSIS

```
#include <tiffio.h>
```

- **void TIFFDefaultTileSize(TIFF \*tif, uint32\_t \*tw, uint32\_t \*th)**

  - **tsize\_t TIFFTileSize(TIFF \*tif)**

  - **uint64\_t TIFFTileSize64(TIFF \*tif)**

  - **tsize\_t TIFFTileRowSize(TIFF \*tif)**

  - **uint64\_t TIFFTileRowSize64(TIFF \*tif)**

  - **tsize\_t TIFFVTileSize(TIFF \*tif, uint32\_t nrows)**

  - **uint64\_t TIFFVTileSize64(TIFF \*tif, uint32\_t nrows)**

  - **ttile\_t TIFFComputeTile(TIFF \*tif, uint32\_t x, uint32\_t y, uint32\_t z, tsample\_t sample)**

  - **int TIFFCheckTile(TIFF \*tif, uint32\_t x, uint32\_t y, uint32\_t z, tsample\_t sample)**

  - **ttile\_t TIFFNumberOfTiles(TIFF \*tif)**

  ## DESCRIPTION

*TIFFDefaultTileSize()* returns the pixel width and height of a reasonable-sized tile; suitable for setting up the **TileWidth** and **TileLength** tags.  If the *tw* and *th* values passed in are non-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()*. *TIFFTileSize64()* returns a **uint64\_t** number. If an error occurs, 0 is returned.

*TIFFVTileSize()* returns the number of bytes in a row-aligned tile with *nrows* of data. *TIFFVTileSize64()* returns a **uint64\_t** number. If an error occurs, 0 is returned.

*TIFFTileRowSize()* returns the number of bytes of a row of data in a tile. *TIFFTileRowSize64()* returns a **uint64\_t** number. If an error occurs, 0 is returned.

*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 if data are organized in separate planes (**PlanarConfiguration** = 2).

*TIFFCheckTile()* returns a non-zero value if the supplied coordinates are within the bounds of the image and zero otherwise. 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). The *sample* parameter is checked against the value of the **SamplesPerPixel** parameter if the data are organized in separate planes.

*TIFFNumberOfTiles()* returns the number of tiles in the image.

## DIAGNOSTICS

None.

## SEE ALSO

*TIFFReadEncodedTile* (3tiff), *TIFFReadRawTile* (3tiff), *TIFFReadTile* (3tiff), *TIFFWriteEncodedTile* (3tiff), *TIFFWriteRawTile* (3tiff), *TIFFWriteTile* (3tiff), *libtiff* (3tiff)

## AUTHOR

LibTIFF contributors

## COPYRIGHT

1988-2022, LibTIFF contributors