src/tiff/html/man/TIFFstrip.3tiff.html

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