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

# TIFFReadTile(3tiff)

read and decode a tile of data from an open TIFF file

## NAME

TIFFReadTile - read and decode a tile of data from an open TIFF file

## SYNOPSIS

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

- **tsize\_t TIFFReadTile(TIFF \*tif, tdata\_t buf, uint32\_t x, uint32\_t y, uint32\_t z, tsample\_t sample)**

  ## DESCRIPTION

Return the data for the tile *containing* the specified coordinates. The data placed in *buf* are returned decompressed and, typically, in the native byte- and bit-ordering, but are otherwise packed (see further below). The buffer must be large enough to hold an entire tile of data. Applications should call the routine *TIFFTileSize()* to find out the size (in bytes) of a tile buffer. The *x* and *y* parameters are always used by *TIFFReadTile()*.  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).

## NOTES

The library attempts to hide bit- and byte-ordering differences between the image and the native machine by converting data to the native machine order.  Bit reversal is done if the **FillOrder** tag is opposite to the native machine bit order. 16- and 32-bit samples are automatically byte-swapped if the file was written with a byte order opposite to the native machine byte order.

## RETURN VALUES

*TIFFReadTile()* returns -1 if it detects an error; otherwise the number of bytes in the decoded tile is returned.

## DIAGNOSTICS

All error messages are directed to the *TIFFErrorExtR()* routine.

## SEE ALSO

*TIFFtile* (3tiff), *TIFFOpen* (3tiff), *TIFFReadEncodedTile* (3tiff), *TIFFReadRawTile* (3tiff), *libtiff* (3tiff)

## AUTHOR

LibTIFF contributors

## COPYRIGHT

1988-2022, LibTIFF contributors