TIFFSTRIP(3tiff) LibTIFF TIFFSTRIP(3tiff)
NAME
TIFFstrip - strip-related utility routines
SYNOPSIS
#include <tiffio.h>
uint32_t TIFFDefaultStripSize(TIFF *tif, uint32_t estimate)
tmsize_t TIFFStripSize(TIFF *tif)
uint64_t TIFFStripSize64(TIFF *tif)
tmsize_t TIFFVStripSize(TIFF *tif, uint32_t nrows)
uint64_t TIFFVStripSize64(TIFF *tif, uint32_t nrows)
tmsize_t TIFFRawStripSize(TIFF *tif, uint32_t strip)
uint64_t TIFFRawStripSize64(TIFF *tif, uint32_t strip)
tstrip_t TIFFComputeStrip(TIFF *tif, uint32_t row, tsample_t sample)
tstrip_t TIFFNumberOfStrips(TIFF *tif)
int TIFFSetupStrips(TIFF *tif)
DESCRIPTION
TIFFDefaultStripSize() returns the number of rows for a
reasonable-sized strip according to the current settings of the
ImageWidth, BitsPerSample and SamplesPerPixel, tags and any
compression-specific requirements. If the estimate parameter, sf
non-zero, then it is taken as an estimate of the desired strip size and
adjusted according to any compression-specific requirements. The value
returned by this function is typically used to define the RowsPerStrip
tag. In lieu of any unusual requirements TIFFDefaultStripSize tries to
create strips that have approximately 8 kilobytes of uncompressed data.
TIFFStripSize() returns the equivalent size for a strip of data as it
would be returned in a call to TIFFReadEncodedStrip() or as it would be
expected in a call to TIFFWriteEncodedStrip(). If an error occurs, 0
is returned.
TIFFStripSize64() returns the equivalent size for a strip of data as
uint64_t. If an error occurs, 0 is returned.
TIFFVStripSize() returns the number of bytes in a strip with nrows rows
of data. If an error occurs, 0 is returned.
TIFFVStripSize64() returns the number of bytes in a strip with nrows
rows of data as uint64_t. If an error occurs, 0 is returned.
TIFFRawStripSize() returns the number of bytes in a raw strip (i.e. not
decoded). If an error occurs, 0xFFFFFFFF (=(tmsize_t(-1)) is returned.
TIFFRawStripSize64() returns the number of bytes in a raw strip as
uint64_t. If an error occurs, 0xFFFFFFFF (=(uint64_t(-1)) is returned.
TIFFComputeStrip() returns the strip that contains the specified
coordinates. A valid strip is always returned; out-of-range coordinate
values are clamped to the bounds of the image. The row parameter is
always used in calculating a strip. The sample parameter is used only
if data are organized in separate planes (PlanarConfiguration = 2).
TIFFNumberOfStrips() returns the number of strips in the image.
TIFFSetupStrips() setup or reset strip parameters and strip array
memory.
DIAGNOSTICS
None.
SEE ALSO
TIFFReadEncodedStrip(3), TIFFReadRawStrip(3),
TIFFWriteEncodedStrip(3), TIFFWriteRawStrip(3), libtiff(3)
AUTHOR
LibTIFF contributors
COPYRIGHT
1988-2022, LibTIFF contributors
4.6 October 9, 2023 TIFFSTRIP(3tiff)
tiff 4.6.0 - Generated Thu Oct 12 05:49:32 CDT 2023