FreeBSD manual

download PDF document: TIFFDefaultStripSize.3.pdf

TIFFSTRIP(3TIFF) TIFFSTRIP(3TIFF) NAME TIFFDefaultStripSize, TIFFStripSize, TIFFVStripSize, TIFFRawStripSize, TIFFComputeStrip, TIFFNumberOfStrips - strip-related utility routines SYNOPSIS #include <tiffio.h> uint32_t TIFFDefaultStripSize(TIFF *tif, uint32_t estimate) tmsize_t TIFFStripSize(TIFF *tif) tmsize_t TIFFVStripSize(TIFF *tif, uint32_t nrows) tmsize_t TIFFRawStripSize(TIFF *tif, uint32_t strip) tstrip_t TIFFComputeStrip(TIFF *tif, uint32_t 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, BitsPerSample, 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 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 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. DIAGNOSTICS None. SEE ALSO TIFFReadEncodedStrip(3TIFF), TIFFReadRawStrip(3TIFF), TIFFWriteEncodedStrip(3TIFF), TIFFWriteRawStrip(3TIFF), libtiff(3TIFF), Libtiff library home page: http://www.simplesystems.org/libtiff/ libtiff October 15, 1995 TIFFSTRIP(3TIFF)