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

# TIFFWriteEncodedTile(3tiff)

compress and write a tile of data to an open TIFF file

## NAME

TIFFWriteEncodedTile - compress and write a tile of data to an open TIFF file

## SYNOPSIS

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

- **tsize\_t TIFFWriteEncodedTile(TIFF \*tif, ttile\_t tile, tdata\_t buf, tsize\_t size)**

  ## DESCRIPTION

Compress *size* bytes of raw data from *buf* and **append** the result to the end of the specified tile. Note that 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.

## NOTES

The library writes encoded data using the native machine byte order. Correctly implemented TIFF readers are expected to do any necessary byte-swapping to correctly process image data with **BitsPerSample** greater than 8.

## RETURN VALUES

\-1 is returned if an error was encountered. Otherwise, the value of *size* is returned.

## DIAGNOSTICS

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

**%s: File not open for writing**:

The file was opened for reading, not writing.

**Can not write tiles to a stripped image**:

The image is assumed to be organized in strips because neither of the **TileWidth** or **TileLength** tags have been set with *TIFFSetField()*.

**%s: Must set "ImageWidth" before writing data**:

The image's width has not been set before the first write. See *TIFFSetField()* for information on how to do this.

**%s: Must set "PlanarConfiguration" before writing data**:

The organization of data has not be defined before the first write. See *TIFFSetField()* for information on how to do this.

**%s: No space for tile arrays"**:

There was not enough space for the arrays that hold tile offsets and byte counts.

## SEE ALSO

*TIFFOpen* (3tiff), *TIFFWriteTile* (3tiff), *TIFFWriteRawTile* (3tiff), *libtiff* (3tiff)

## AUTHOR

LibTIFF contributors

## COPYRIGHT

1988-2022, LibTIFF contributors