TIFFFieldPassCount.3tiff - Man Page

get whether to pass a count to TIFFGetField/TIFFSetField

Synopsis

#include <tiffio.h>

int TIFFFieldPassCount(const TIFFField *fip)

Description

TIFFFieldPassCount() returns true (nonzero) if TIFFGetField() and TIFFSetField() expect a count value to be passed before the actual data pointer.

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

When a count is required, it will be of type uint32_t if TIFFFieldReadCount() reports TIFF_VARIABLE2, and of type uint16_t otherwise.  Use TIFFFieldWriteCount() for TIFFSetField(), respectively. (This distinction is critical for use of TIFFGetField(), but normally not so for use of TIFFSetField().)

An alternative function for the count value determination is TIFFFieldSetGetCountSize().

Return Values

TIFFFieldPassCount() returns an integer that is always 1 (true) or 0 (false).

See Also

TIFFFieldDataType (3tiff), TIFFFieldName (3tiff), TIFFFieldQuery (3tiff), TIFFFieldReadCount (3tiff), TIFFFieldTag (3tiff), TIFFFieldWriteCount (3tiff), libtiff

Author

LibTIFF contributors

Info

Sep 08, 2023 4.6 LibTIFF