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

AUTHOR

       LibTIFF contributors

COPYRIGHT

       1988-2024, LibTIFF contributors