TIFFComputeStrip

TIFFSTRIP(3T)							TIFFSTRIP(3T)



NAME
       TIFFDefaultStripSize, TIFFStripSize, TIFFVStripSize, TIFFRawStripSize,
       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)
       tsize_t TIFFRawStripSize(TIFF* tif, tstrip_t strip)
       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 esti-
       mate of the desired strip size and adjusted according to any  compres-
       sion-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.

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

       TIFFRawStripSize	 returns the number of bytes in a raw strip (i.e. not
       decoded).

       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)