FreeBSD manual
download PDF document: TIFFFieldPassCount.3.pdf
TIFFFIELDPASSCOUNT(3tiff) LibTIFF TIFFFIELDPASSCOUNT(3tiff)
NAME
TIFFFieldPassCount - 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
COPYRIGHT
1988-2022, LibTIFF contributors
4.6 September 8, 2023 TIFFFIELDPASSCOUNT(3tiff)