---
name: "TIFFReadEncodedTile"
section: "3t"
platform: "linux"
package: "libtiff3g-dev"
version: "3.5.5-6.woody5"
release: "Debian 3.0 (Woody)"
platforms: ["linux"]
url: "https://new.carta.tech/TIFFReadEncodedTile"
---

# TIFFReadEncodedTile(3t)

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

## NAME

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

## SYNOPSIS

**#include \<tiffio.h\>**\
 **int TIFFReadEncodedTile(TIFF\* tif, u\_long tile, u\_char\* buf, u\_long size)**

## DESCRIPTION

Read the specified tile of data and place up to *size* bytes of decompressed information in the (user supplied) data buffer.

## NOTES

The value of *tile* is a \`\`raw tile number.'' That is, the caller must take into account whether or not the data are organized in separate planes (*PlanarConfiguration*=2). *TIFFComputeTile* automatically does this when converting an (x,y,z,sample) coordinate quadruple to a tile number. To read a full tile of data the data buffer should be at least as large as the value returned by *TIFFTileSize*.

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

The actual number of bytes of data that were placed in *buf* is returned; *TIFFReadEncodedTile* returns -1 if an error was encountered.

## DIAGNOSTICS

All error messages are directed to the *TIFFError*(3T) routine.

## SEE ALSO

*libtiff*(3T), *TIFFOpen*(3T), *TIFFReadRawTile*(3T), *TIFFReadTile*(3T)