TIFFComputeStrip

TIFFSTRIP(3T)                                                    TIFFSTRIP(3T)



NAME
       TIFFDefaultStripSize,  TIFFStripSize, TIFFVStripSize, TIFFComputeStrip,
       TIFFNumberOfStrips - strip-related utility routines

SYNOPSIS
       #include <tiffio.h>
       uint32 TIFFDefaultStripSize(TIFF* tif, uint32 estimate)
       tsize_t TIFFStripSize(TIFF* tif)
       tsize_t TIFFVStripSize(TIFF* tif, uint32 nrows)
       tstrip_t TIFFComputeStrip(TIFF* tif, uint32 row, tsample_t sample)
       tstrip_t TIFFNumberOfStrips(TIFF* tif)

DESCRIPTION
       TIFFDefaultStripSize returns the number of rows for a  reasonable-sized
       strip  according to the current settings of the ImageWidth, BitsPerSam-
       ple, SamplesPerPixel, tags and any  compression-specific  requirements.
       If the estimate parameter, if 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 typi-
       cally 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.

       TIFFVStripSize returns the number of bytes in a strip with  nrows  rows
       of data.

       TIFFComputeStrip  returns the strip that contains the specified coordi-
       nates.  A valid strip is always returned; out-of-range coordinate  val-
       ues  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.

DIAGNOSTICS
       None.

SEE ALSO
       libtiff(3T),       TIFFReadEncodedStrip(3T),      TIFFReadRawStrip(3T),
       TIFFWriteEncodedStrip(3T), TIFFWriteRawStrip(3T)



                               October 15, 1995                  TIFFSTRIP(3T)