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

4.5                                               Sep 05, 2024                                  TIFFSTRIP(3tiff)