TIFFFieldReadCount(3tiff)

TIFFFieldReadCount3tiff

Get number of values to be read from field

Usage

#include <tiffio.h>
int TIFFFieldReadCount(const TIFFField *fip)

Overview

TIFFFieldReadCount() returns the number of values available to be read from the specified TIFF field; that is, the number of arguments that should be supplied to TIFFGetField(). For most field types this is a small positive integer, typically 1 or 2, but there are some special values:

•

TIFF_VARIABLE = -1 indicates that a variable number of values is possible; then, a uint16_t count argument and a pointer data argument must be supplied to TIFFGetField().

•

TIFF_VARIABLE2 = -3 is the same as TIFF_VARIABLE except that the count argument must have type uint32_t.

•

TIFF_SPP = -2 indicates that the number of arguments is equal to the image's number of samples per pixel.

fip is a field information pointer previously returned by TIFFFindField(), TIFFFieldWithTag(), or TIFFFieldWithName().

Return values

TIFFFieldReadCount() returns an integer.

Releases

6 releases since Debian 8 (Jessie); the text changed 4 times.

  1. 8
  2. 9
  3. 10–11
  4. 12
  5. 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.