TIFFWriteTile(3tiff)

TIFFWriteTile3tiff

Encode and write a tile of data to an open tiff file

Usage

#include <tiffio.h>

TIFFWriteTile - encode and write a tile of data to an open TIFF file

tsize_t TIFFWriteTile(TIFF *tif, tdata_t buf, uint32_t x, uint32_t y, uint32_t z, tsample_t sample)

Overview

Write the data for the tile containing the specified coordinates. The data in buf are (potentially) compressed, and written to the indicated file, normally being appended to the end of the file. The buffer must be contain 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 TIFFWriteTile(). 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).

Return values

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

Diagnostics

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

Releases

11 releases since Debian 3.1 (Sarge); the text changed 6 times.

  1. 3.1
  2. 4.0–6.0
  3. 7–8
  4. 9
  5. 10–11
  6. 12
  7. 13

Author

LibTIFF contributors

From libtiff-dev 4.7.0-3+deb13u3 in Debian 13 (Trixie). Parsed by carta from the page's man source.