TIFFstrip — LibTIFF 4.6.0 documentation

# TIFFstrip

## 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 (3tiff), TIFFReadRawStrip (3tiff), TIFFWriteEncodedStrip (3tiff), TIFFWriteRawStrip (3tiff), libtiff (3tiff)