1TIFFSTRIP(3TIFF)                                              TIFFSTRIP(3TIFF)
2
3
4

NAME

6       TIFFDefaultStripSize,  TIFFStripSize, TIFFVStripSize, TIFFRawStripSize,
7       TIFFComputeStrip, TIFFNumberOfStrips - strip-related utility routines
8

SYNOPSIS

10       #include <tiffio.h>
11
12       uint32_t TIFFDefaultStripSize(TIFF *tif, uint32_t estimate)
13       tmsize_t TIFFStripSize(TIFF *tif)
14       tmsize_t TIFFVStripSize(TIFF *tif, uint32_t nrows)
15       tmsize_t TIFFRawStripSize(TIFF *tif, uint32_t strip)
16       tstrip_t TIFFComputeStrip(TIFF *tif, uint32_t row, tsample_t sample)
17       tstrip_t TIFFNumberOfStrips(TIFF *tif)
18

DESCRIPTION

20       TIFFDefaultStripSize returns the number of rows for a  reasonable-sized
21       strip  according to the current settings of the ImageWidth, BitsPerSam‐
22       ple, SamplesPerPixel, tags and any  compression-specific  requirements.
23       If the estimate parameter, if non-zero, then it is taken as an estimate
24       of the desired strip size and adjusted according  to  any  compression-
25       specific requirements. The value returned by this function is typically
26       used to define the RowsPerStrip tag. In lieu of  any  unusual  require‐
27       ments  TIFFDefaultStripSize  tries  to create strips that have approxi‐
28       mately 8 kilobytes of uncompressed data.
29
30       TIFFStripSize returns the equivalent size for a strip  of  data  as  it
31       would  be  returned in a call to TIFFReadEncodedStrip or as it would be
32       expected in a call to TIFFWriteEncodedStrip.
33
34       TIFFVStripSize returns the number of bytes in a strip with  nrows  rows
35       of data.
36
37       TIFFRawStripSize  returns  the number of bytes in a raw strip (i.e. not
38       decoded).
39
40       TIFFComputeStrip returns the strip that contains the specified  coordi‐
41       nates. A valid strip is always returned; out-of-range coordinate values
42       are clamped to the bounds of the image. The  row  parameter  is  always
43       used  in calculating a strip. The sample parameter is used only if data
44       are organized in separate planes (PlanarConfiguration=2).
45
46       TIFFNumberOfStrips returns the number of strips in the image.
47

DIAGNOSTICS

49       None.
50

SEE ALSO

52       TIFFReadEncodedStrip(3TIFF), TIFFReadRawStrip(3TIFF), TIFFWriteEncoded‐
53       Strip(3TIFF), TIFFWriteRawStrip(3TIFF), libtiff(3TIFF),
54
55       Libtiff library home page: http://www.simplesystems.org/libtiff/
56
57
58
59libtiff                        October 15, 1995               TIFFSTRIP(3TIFF)
Impressum