TIFFstrip.3tiff.html 4.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129
  1. <!-- Creator : groff version 1.18.1 -->
  2. <!-- CreationDate: Sat Feb 24 18:37:17 2007 -->
  3. <html>
  4. <head>
  5. <meta name="generator" content="groff -Thtml, see www.gnu.org">
  6. <meta name="Content-Style" content="text/css">
  7. <title>TIFFSTRIP</title>
  8. </head>
  9. <body>
  10. <h1 align=center>TIFFSTRIP</h1>
  11. <a href="#NAME">NAME</a><br>
  12. <a href="#SYNOPSIS">SYNOPSIS</a><br>
  13. <a href="#DESCRIPTION">DESCRIPTION</a><br>
  14. <a href="#DIAGNOSTICS">DIAGNOSTICS</a><br>
  15. <a href="#SEE ALSO">SEE ALSO</a><br>
  16. <hr>
  17. <a name="NAME"></a>
  18. <h2>NAME</h2>
  19. <!-- INDENTATION -->
  20. <table width="100%" border=0 rules="none" frame="void"
  21. cols="2" cellspacing="0" cellpadding="0">
  22. <tr valign="top" align="left">
  23. <td width="8%"></td>
  24. <td width="91%">
  25. <p>TIFFDefaultStripSize, TIFFStripSize, TIFFVStripSize,
  26. TIFFRawStripSize, TIFFComputeStrip, TIFFNumberOfStrips
  27. &minus; strip-related utility routines</p>
  28. </td>
  29. </table>
  30. <a name="SYNOPSIS"></a>
  31. <h2>SYNOPSIS</h2>
  32. <!-- INDENTATION -->
  33. <table width="100%" border=0 rules="none" frame="void"
  34. cols="2" cellspacing="0" cellpadding="0">
  35. <tr valign="top" align="left">
  36. <td width="8%"></td>
  37. <td width="91%">
  38. <p><b>#include &lt;tiffio.h&gt;</b></p>
  39. <!-- INDENTATION -->
  40. <p><b>uint32 TIFFDefaultStripSize(TIFF *</b><i>tif</i><b>,
  41. uint32</b> <i>estimate</i><b>)<br>
  42. tsize_t TIFFStripSize(TIFF *</b><i>tif</i><b>)<br>
  43. tsize_t TIFFVStripSize(TIFF *</b><i>tif</i><b>, uint32</b>
  44. <i>nrows</i><b>)<br>
  45. tsize_t TIFFRawStripSize(TIFF *</b><i>tif</i><b>,
  46. tstrip_t</b> <i>strip</i><b>)<br>
  47. tstrip_t TIFFComputeStrip(TIFF *</b><i>tif</i><b>,
  48. uint32</b> <i>row</i><b>, tsample_t</b>
  49. <i>sample</i><b>)<br>
  50. tstrip_t TIFFNumberOfStrips(TIFF *</b><i>tif</i><b>)</b></p>
  51. </td>
  52. </table>
  53. <a name="DESCRIPTION"></a>
  54. <h2>DESCRIPTION</h2>
  55. <!-- INDENTATION -->
  56. <table width="100%" border=0 rules="none" frame="void"
  57. cols="2" cellspacing="0" cellpadding="0">
  58. <tr valign="top" align="left">
  59. <td width="8%"></td>
  60. <td width="91%">
  61. <p><i>TIFFDefaultStripSize</i> returns the number of rows
  62. for a reasonable-sized strip according to the current
  63. settings of the <i>ImageWidth</i>, <i>BitsPerSample</i>,
  64. <i>SamplesPerPixel</i>, tags and any compression-specific
  65. requirements. If the <i>estimate</i> parameter, if non-zero,
  66. then it is taken as an estimate of the desired strip size
  67. and adjusted according to any compression-specific
  68. requirements. The value returned by this function is
  69. typically used to define the <i>RowsPerStrip</i> tag. In
  70. lieu of any unusual requirements <i>TIFFDefaultStripSize</i>
  71. tries to create strips that have approximately 8 kilobytes
  72. of uncompressed data.</p>
  73. <!-- INDENTATION -->
  74. <p><i>TIFFStripSize</i> returns the equivalent size for a
  75. strip of data as it would be returned in a call to
  76. <i>TIFFReadEncodedStrip</i> or as it would be expected in a
  77. call to <i>TIFFWriteEncodedStrip</i>.</p>
  78. <!-- INDENTATION -->
  79. <p><i>TIFFVStripSize</i> returns the number of bytes in a
  80. strip with <i>nrows</i> rows of data.</p>
  81. <!-- INDENTATION -->
  82. <p><i>TIFFRawStripSize</i> returns the number of bytes in a
  83. raw strip (i.e. not decoded).</p>
  84. <!-- INDENTATION -->
  85. <p><i>TIFFComputeStrip</i> returns the strip that contains
  86. the specified coordinates. A valid strip is always returned;
  87. out-of-range coordinate values are clamped to the bounds of
  88. the image. The <i>row</i> parameter is always used in
  89. calculating a strip. The <i>sample</i> parameter is used
  90. only if data are organized in separate planes
  91. (<i>PlanarConfiguration</i>=2).</p>
  92. <!-- INDENTATION -->
  93. <p><i>TIFFNumberOfStrips</i> returns the number of strips in
  94. the image.</p>
  95. </td>
  96. </table>
  97. <a name="DIAGNOSTICS"></a>
  98. <h2>DIAGNOSTICS</h2>
  99. <!-- INDENTATION -->
  100. <table width="100%" border=0 rules="none" frame="void"
  101. cols="2" cellspacing="0" cellpadding="0">
  102. <tr valign="top" align="left">
  103. <td width="8%"></td>
  104. <td width="91%">
  105. <p>None.</p>
  106. </td>
  107. </table>
  108. <a name="SEE ALSO"></a>
  109. <h2>SEE ALSO</h2>
  110. <!-- INDENTATION -->
  111. <table width="100%" border=0 rules="none" frame="void"
  112. cols="2" cellspacing="0" cellpadding="0">
  113. <tr valign="top" align="left">
  114. <td width="8%"></td>
  115. <td width="91%">
  116. <p><b>TIFFReadEncodedStrip</b>(3TIFF),
  117. <b>TIFFReadRawStrip</b>(3TIFF),
  118. <b>TIFFWriteEncodedStrip</b>(3TIFF),
  119. <b>TIFFWriteRawStrip</b>(3TIFF), <b>libtiff</b>(3TIFF),</p>
  120. <!-- INDENTATION -->
  121. <p>Libtiff library home page:
  122. <b>http://www.remotesensing.org/libtiff/</b></p>
  123. </td>
  124. </table>
  125. <hr>
  126. </body>
  127. </html>