diff options
Diffstat (limited to 'doc/static/man/libtiff.3tiff.html')
-rw-r--r-- | doc/static/man/libtiff.3tiff.html | 3099 |
1 files changed, 0 insertions, 3099 deletions
diff --git a/doc/static/man/libtiff.3tiff.html b/doc/static/man/libtiff.3tiff.html deleted file mode 100644 index a196857f..00000000 --- a/doc/static/man/libtiff.3tiff.html +++ /dev/null @@ -1,3099 +0,0 @@ -<!-- Creator : groff version 1.22.4 --> -<!-- CreationDate: Sat Jun 4 16:23:25 2022 --> -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> -<html> -<head> -<meta name="generator" content="groff -Thtml, see www.gnu.org"> -<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"> -<meta name="Content-Style" content="text/css"> -<style type="text/css"> - p { margin-top: 0; margin-bottom: 0; vertical-align: top } - pre { margin-top: 0; margin-bottom: 0; vertical-align: top } - table { margin-top: 0; margin-bottom: 0; vertical-align: top } - h1 { text-align: center } -</style> -<title>INTRO</title> - -</head> -<body> - -<h1 align="center">INTRO</h1> - -<a href="#NAME">NAME</a><br> -<a href="#SYNOPSIS">SYNOPSIS</a><br> -<a href="#DESCRIPTION">DESCRIPTION</a><br> -<a href="#DATA TYPES">DATA TYPES</a><br> -<a href="#LIST OF ROUTINES">LIST OF ROUTINES</a><br> -<a href="#TAG USAGE">TAG USAGE</a><br> -<a href="#PSEUDO TAGS">PSEUDO TAGS</a><br> -<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> -<a href="#SEE ALSO">SEE ALSO</a><br> -<a href="#BUGS">BUGS</a><br> - -<hr> - - -<h2>NAME -<a name="NAME"></a> -</h2> - - -<p style="margin-left:11%; margin-top: 1em">libtiff − -introduction to <i>libtiff</i>, a library for reading and -writing <small>TIFF</small> files</p> - -<h2>SYNOPSIS -<a name="SYNOPSIS"></a> -</h2> - - -<p style="margin-left:11%; margin-top: 1em"><b>#include -<tiffio.h></b></p> - -<p style="margin-left:11%; margin-top: 1em">cc file.c -<b>-ltiff</b></p> - -<h2>DESCRIPTION -<a name="DESCRIPTION"></a> -</h2> - - - -<p style="margin-left:11%; margin-top: 1em"><b><i>libtiff</i></b> -is a library for reading and writing data files encoded with -the <i>Tag Image File</i> format, Revision 6.0 (or revision -5.0 or revision 4.0). This file format is suitable for -archiving multi-color and monochromatic image data.</p> - -<p style="margin-left:11%; margin-top: 1em">The library -supports several compression algorithms, as indicated by the -<i>Compression</i> field, including: no compression (1), -<small>CCITT</small> 1D Huffman compression (2), -<small>CCITT</small> Group 3 Facsimile compression (3), -<small>CCITT</small> Group 4 Facsimile compression (4), -Lempel-Ziv & Welch compression (5), baseline JPEG -compression (7), word-aligned 1D Huffman compression -(32771), and PackBits compression (32773). In addition, -several nonstandard compression algorithms are supported: -the 4-bit compression algorithm used by the -<i>ThunderScan</i> program (32809) (decompression only), -NeXT’s 2-bit compression algorithm (32766) -(decompression only), an experimental LZ-style algorithm -known as Deflate (32946), and an experimental CIE LogLuv -compression scheme designed for images with high dynamic -range (32845 for LogL and 32845 for LogLuv). Directory -information may be in either little- or big-endian byte -order−byte swapping is automatically done by the -library. Data bit ordering may be either Most Significant -Bit ( <small>MSB) to Least Significant Bit ( <small>LSB) -or</small> LSB</small> to <small>MSB.</small> Finally, the -library does not support files in which the -<i>BitsPerSample</i>, <i>Compression</i>, -<i>MinSampleValue</i>, or <i>MaxSampleValue</i> fields are -defined differently on a per-sample basis (in Rev. 6.0 the -<i>Compression</i> tag is not defined on a per-sample basis, -so this is immaterial).</p> - -<h2>DATA TYPES -<a name="DATA TYPES"></a> -</h2> - - -<p style="margin-left:11%; margin-top: 1em">The library -makes extensive use of C typedefs to promote portability. -Two sets of typedefs are used, one for communication with -clients of the library and one for internal data structures -and parsing of the <small>TIFF</small> format. The following -typedefs are exposed to users either through function -definitions or through parameters passed through the varargs -interfaces.</p> - -<table width="100%" border="0" rules="none" frame="void" - cellspacing="0" cellpadding="0"> -<tr valign="top" align="left"> -<td width="18%"></td> -<td width="40%"> - - -<p>typedef unsigned short uint16_t;</p></td> -<td width="42%"> - - -<p>16-bit unsigned integer</p></td></tr> -<tr valign="top" align="left"> -<td width="18%"></td> -<td width="40%"> - - -<p>typedef unsigned <<i>thing</i>> uint32_t;</p></td> -<td width="42%"> - - -<p>32-bit unsigned integer</p></td></tr> -<tr valign="top" align="left"> -<td width="18%"></td> -<td width="40%"> - - -<p>typedef unsigned int ttag_t;</p></td> -<td width="42%"> - - -<p>directory tag</p></td></tr> -<tr valign="top" align="left"> -<td width="18%"></td> -<td width="40%"> - - -<p>typedef uint16_t tdir_t;</p></td> -<td width="42%"> - - -<p>directory index</p></td></tr> -<tr valign="top" align="left"> -<td width="18%"></td> -<td width="40%"> - - -<p>typedef uint16_t tsample_t;</p></td> -<td width="42%"> - - -<p>sample number</p></td></tr> -<tr valign="top" align="left"> -<td width="18%"></td> -<td width="40%"> - - -<p>typedef uint32_t tstrip_t;</p></td> -<td width="42%"> - - -<p>strip number</p></td></tr> -<tr valign="top" align="left"> -<td width="18%"></td> -<td width="40%"> - - -<p>typedef uint32_t ttile_t;</p></td> -<td width="42%"> - - -<p>tile number</p></td></tr> -<tr valign="top" align="left"> -<td width="18%"></td> -<td width="40%"> - - -<p>typedef int32_t tsize_t;</p></td> -<td width="42%"> - - -<p>i/o size in bytes</p></td></tr> -<tr valign="top" align="left"> -<td width="18%"></td> -<td width="40%"> - - -<p>typedef void* tdata_t;</p></td> -<td width="42%"> - - -<p>image data ref</p></td></tr> -<tr valign="top" align="left"> -<td width="18%"></td> -<td width="40%"> - - -<p>typedef void* thandle_t;</p></td> -<td width="42%"> - - -<p>client data handle</p></td></tr> -<tr valign="top" align="left"> -<td width="18%"></td> -<td width="40%"> - - -<p>typedef int32_t toff_t;</p></td> -<td width="42%"> - - -<p>file offset</p></td></tr> -</table> - -<p style="margin-left:11%;">Note that <i>tstrip_t</i>, -<i>ttile_t</i>, and <i>tsize_t</i> are constrained to be no -more than 32-bit quantities by 32-bit fields they are stored -in in the <small>TIFF</small> image. Likewise -<i>tsample_t</i> is limited by the 16-bit field used to -store the <i>SamplesPerPixel</i> tag. <i>tdir_t</i> -constrains the maximum number of <small>IFDs</small> that -may appear in an image and may be an arbitrary size (w/o -penalty). <i>ttag_t</i> must be either int, unsigned int, -pointer, or double because the library uses a varargs -interface and <small>ANSI C</small> restricts the type of -the parameter before an ellipsis to be a promoted type. -<i>toff_t</i> is defined as int32_t because TIFF file -offsets are (unsigned) 32-bit quantities. A signed value is -used because some interfaces return −1 on error. -Finally, note that user-specified data references are passed -as opaque handles and only cast at the lowest layers where -their type is presumed.</p> - -<h2>LIST OF ROUTINES -<a name="LIST OF ROUTINES"></a> -</h2> - - -<p style="margin-left:11%; margin-top: 1em">The following -routines are part of the library. Consult specific manual -pages for details on their operation; on most systems doing -‘‘man function-name’’ will work.</p> - -<table width="100%" border="0" rules="none" frame="void" - cellspacing="0" cellpadding="0"> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p><i>Name</i></p></td> -<td width="62%"> - - -<p><i>Description</i></p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFCheckpointDirectory</p></td> -<td width="62%"> - - -<p>writes the current state of the directory</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFCheckTile</p></td> -<td width="62%"> - - -<p>very x,y,z,sample is within image</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFCIELabToRGBInit</p></td> -<td width="62%"> - - -<p>initialize CIE L*a*b* 1976 to RGB conversion state</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFCIELabToXYZ</p></td> -<td width="62%"> - - -<p>perform CIE L*a*b* 1976 to CIE XYZ conversion</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFClientOpen</p></td> -<td width="62%"> - - -<p>open a file for reading or writing</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFClose</p></td> -<td width="62%"> - - -<p>close an open file</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFComputeStrip</p></td> -<td width="62%"> - - -<p>return strip containing y,sample</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFComputeTile</p></td> -<td width="62%"> - - -<p>return tile containing x,y,z,sample</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFCurrentDirectory</p></td> -<td width="62%"> - - -<p>return index of current directory</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFCurrentRow</p></td> -<td width="62%"> - - -<p>return index of current scanline</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFCurrentStrip</p></td> -<td width="62%"> - - -<p>return index of current strip</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFCurrentTile</p></td> -<td width="62%"> - - -<p>return index of current tile</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFDataWidth</p></td> -<td width="62%"> - - -<p>return the size of TIFF data types</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFError</p></td> -<td width="62%"> - - -<p>library error handler</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFFdOpen</p></td> -<td width="62%"> - - -<p>open a file for reading or writing</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFFieldDataType</p></td> -<td width="62%"> - - -<p>get data type from field information</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFFieldName</p></td> -<td width="62%"> - - -<p>get field name from field information</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFFieldPassCount</p></td> -<td width="62%"> - - -<p>get whether to pass a value count to Get/SetField</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFFieldReadCount</p></td> -<td width="62%"> - - -<p>get number of values to be read from field</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFFieldTag</p></td> -<td width="62%"> - - -<p>get tag value from field information</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFFieldWithName</p></td> -<td width="62%"> - - -<p>get field information given field name</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFFieldWithTag</p></td> -<td width="62%"> - - -<p>get field information given tag</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFFieldWriteCount</p></td> -<td width="62%"> - - -<p>get number of values to be written to field</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFFileName</p></td> -<td width="62%"> - - -<p>return name of open file</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFFileno</p></td> -<td width="62%"> - - -<p>return open file descriptor</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFFindCODEC</p></td> -<td width="62%"> - - -<p>find standard codec for the specific scheme</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFFindField</p></td> -<td width="62%"> - - -<p>get field information given tag and data type</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFFlush</p></td> -<td width="62%"> - - -<p>flush all pending writes</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFFlushData</p></td> -<td width="62%"> - - -<p>flush pending data writes</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFGetBitRevTable</p></td> -<td width="62%"> - - -<p>return bit reversal table</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFGetField</p></td> -<td width="62%"> - - -<p>return tag value in current directory</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFGetFieldDefaulted</p></td> -<td width="62%"> - - -<p>return tag value in current directory</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFGetMode</p></td> -<td width="62%"> - - -<p>return open file mode</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFGetVersion</p></td> -<td width="62%"> - - -<p>return library version string</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFIsCODECConfigured</p></td> -<td width="62%"> - - -<p>check, whether we have working codec</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFIsMSB2LSB</p></td> -<td width="62%"> - - -<p>return true if image data is being returned</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"></td> -<td width="62%"> - - -<p>with bit 0 as the most significant bit</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFIsTiled</p></td> -<td width="62%"> - - -<p>return true if image data is tiled</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFIsByteSwapped</p></td> -<td width="62%"> - - -<p>return true if image data is byte-swapped</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFNumberOfStrips</p></td> -<td width="62%"> - - -<p>return number of strips in an image</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFNumberOfTiles</p></td> -<td width="62%"> - - -<p>return number of tiles in an image</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFOpen</p></td> -<td width="62%"> - - -<p>open a file for reading or writing</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFPrintDirectory</p></td> -<td width="62%"> - - -<p>print description of the current directory</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFReadBufferSetup</p></td> -<td width="62%"> - - -<p>specify i/o buffer for reading</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFReadDirectory</p></td> -<td width="62%"> - - -<p>read the next directory</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFReadEncodedStrip</p></td> -<td width="62%"> - - -<p>read and decode a strip of data</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFReadEncodedTile</p></td> -<td width="62%"> - - -<p>read and decode a tile of data</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFReadRawStrip</p></td> -<td width="62%"> - - -<p>read a raw strip of data</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFReadRawTile</p></td> -<td width="62%"> - - -<p>read a raw tile of data</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFReadRGBAImage</p></td> -<td width="62%"> - - -<p>read an image into a fixed format raster</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFReadScanline</p></td> -<td width="62%"> - - -<p>read and decode a row of data</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFReadTile</p></td> -<td width="62%"> - - -<p>read and decode a tile of data</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFRegisterCODEC</p></td> -<td width="62%"> - - -<p>override standard codec for the specific scheme</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFReverseBits</p></td> -<td width="62%"> - - -<p>reverse bits in an array of bytes</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFRGBAImageBegin</p></td> -<td width="62%"> - - -<p>setup decoder state for TIFFRGBAImageGet</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFRGBAImageEnd</p></td> -<td width="62%"> - - -<p>release TIFFRGBAImage decoder state</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFRGBAImageGet</p></td> -<td width="62%"> - - -<p>read and decode an image</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFRGBAImageOK</p></td> -<td width="62%"> - - -<p>is image readable by TIFFRGBAImageGet</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFScanlineSize</p></td> -<td width="62%"> - - -<p>return size of a scanline</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFSetDirectory</p></td> -<td width="62%"> - - -<p>set the current directory</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFSetSubDirectory</p></td> -<td width="62%"> - - -<p>set the current directory</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFSetErrorHandler</p></td> -<td width="62%"> - - -<p>set error handler function</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFSetField</p></td> -<td width="62%"> - - -<p>set a tag’s value in the current directory</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFSetWarningHandler</p></td> -<td width="62%"> - - -<p>set warning handler function</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFStripSize</p></td> -<td width="62%"> - - -<p>returns size of a strip</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFRawStripSize</p></td> -<td width="62%"> - - -<p>returns the number of bytes in a raw strip</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFSwabShort</p></td> -<td width="62%"> - - -<p>swap bytes of short</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFSwabLong</p></td> -<td width="62%"> - - -<p>swap bytes of long</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFSwabArrayOfShort</p></td> -<td width="62%"> - - -<p>swap bytes of an array of shorts</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFSwabArrayOfLong</p></td> -<td width="62%"> - - -<p>swap bytes of an array of longs</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFTileRowSize</p></td> -<td width="62%"> - - -<p>return size of a row in a tile</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFTileSize</p></td> -<td width="62%"> - - -<p>return size of a tile</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFUnRegisterCODEC</p></td> -<td width="62%"> - - -<p>unregisters the codec</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFVGetField</p></td> -<td width="62%"> - - -<p>return tag value in current directory</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFVGetFieldDefaulted</p></td> -<td width="62%"> - - -<p>return tag value in current directory</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFVSetField</p></td> -<td width="62%"> - - -<p>set a tag’s value in the current directory</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFVStripSize</p></td> -<td width="62%"> - - -<p>returns the number of bytes in a strip</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFWarning</p></td> -<td width="62%"> - - -<p>library warning handler</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFWriteDirectory</p></td> -<td width="62%"> - - -<p>write the current directory</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFWriteEncodedStrip</p></td> -<td width="62%"> - - -<p>compress and write a strip of data</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFWriteEncodedTile</p></td> -<td width="62%"> - - -<p>compress and write a tile of data</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFWriteRawStrip</p></td> -<td width="62%"> - - -<p>write a raw strip of data</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFWriteRawTile</p></td> -<td width="62%"> - - -<p>write a raw tile of data</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFWriteScanline</p></td> -<td width="62%"> - - -<p>write a scanline of data</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFWriteTile</p></td> -<td width="62%"> - - -<p>compress and write a tile of data</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFXYZToRGB</p></td> -<td width="62%"> - - -<p>perform CIE XYZ to RGB conversion</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFYCbCrToRGBInit</p></td> -<td width="62%"> - - -<p>initialize YCbCr to RGB conversion state</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>TIFFYCbCrtoRGB</p></td> -<td width="62%"> - - -<p>perform YCbCr to RGB conversion</p></td></tr> -</table> - -<p style="margin-left:11%; margin-top: 1em">Auxiliary -functions:</p> - -<table width="100%" border="0" rules="none" frame="void" - cellspacing="0" cellpadding="0"> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>_TIFFfree</p></td> -<td width="62%"> - - -<p>free memory buffer</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>_TIFFmalloc</p></td> -<td width="62%"> - - -<p>dynamically allocate memory buffer</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>_TIFFmemcmp</p></td> -<td width="62%"> - - -<p>compare contents of the memory buffers</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>_TIFFmemcpy</p></td> -<td width="62%"> - - -<p>copy contents of the one buffer to another</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>_TIFFmemset</p></td> -<td width="62%"> - - -<p>fill memory buffer with a constant byte</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="27%"> - - -<p>_TIFFrealloc</p></td> -<td width="62%"> - - -<p>dynamically reallocate memory buffer</p></td></tr> -</table> - -<h2>TAG USAGE -<a name="TAG USAGE"></a> -</h2> - - -<p style="margin-left:11%; margin-top: 1em">The table below -lists the <small>TIFF</small> tags that are recognized and -handled by the library. If no use is indicated in the table, -then the library reads and writes the tag, but does not use -it internally. Note that some tags are meaningful only when -a particular compression scheme is being used; e.g. -<i>Group3Options</i> is only useful if <i>Compression</i> is -set to <small>CCITT</small> Group 3 encoding. Tags of this -sort are considered <i>codec-specific</i> tags and the -library does not recognize them except when the -<i>Compression</i> tag has been previously set to the -relevant compression scheme.</p> - -<table width="100%" border="0" rules="none" frame="void" - cellspacing="0" cellpadding="0"> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p><i>Tag Name</i></p></td> -<td width="11%"></td> -<td width="7%"> - - -<p><i>Value</i></p></td> -<td width="45%"> - - -<p><i>R/W</i></p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p><i>Library Use/Notes</i></p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>Artist</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>315</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>BadFaxLines</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>326</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>BitsPerSample</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>258</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>lots</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>CellLength</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>265</p></td> -<td width="45%"> -</td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>parsed but ignored</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>CellWidth</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>264</p></td> -<td width="45%"> -</td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>parsed but ignored</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>CleanFaxData</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>327</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>ColorMap</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>320</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>ColorResponseUnit</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>300</p></td> -<td width="45%"> -</td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>parsed but ignored</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>Compression</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>259</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>choosing codec</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>ConsecutiveBadFaxLines</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>328</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -</table> - -<p style="margin-left:11%;">Copyright 33432 R/W</p> - -<table width="100%" border="0" rules="none" frame="void" - cellspacing="0" cellpadding="0"> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>DataType</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>32996</p></td> -<td width="45%"> - - -<p>R</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>obsoleted by SampleFormat tag</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>DateTime</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>306</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>DocumentName</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>269</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>DotRange</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>336</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>ExtraSamples</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>338</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>lots</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>FaxRecvParams</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>34908</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>FaxSubAddress</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>34909</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>FaxRecvTime</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>34910</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>FillOrder</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>266</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>control bit order</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>FreeByteCounts</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>289</p></td> -<td width="45%"> -</td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>parsed but ignored</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>FreeOffsets</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>288</p></td> -<td width="45%"> -</td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>parsed but ignored</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>GrayResponseCurve</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>291</p></td> -<td width="45%"> -</td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>parsed but ignored</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>GrayResponseUnit</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>290</p></td> -<td width="45%"> -</td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>parsed but ignored</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>Group3Options</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>292</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>used by Group 3 codec</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>Group4Options</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>293</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>HostComputer</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>316</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>ImageDepth</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>32997</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>tile/strip calculations</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>ImageDescription</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>270</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>ImageLength</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>257</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>lots</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>ImageWidth</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>256</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>lots</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>InkNames</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>333</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>InkSet</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>332</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>JPEGTables</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>347</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>used by JPEG codec</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>Make</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>271</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>Matteing</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>32995</p></td> -<td width="45%"> - - -<p>R</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>obsoleted by ExtraSamples tag</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>MaxSampleValue</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>281</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>MinSampleValue</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>280</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>Model</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>272</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>NewSubFileType</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>254</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>called SubFileType in spec</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>NumberOfInks</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>334</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>Orientation</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>274</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>PageName</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>285</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>PageNumber</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>297</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>PhotometricInterpretation</p></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>262</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>R/Wused by Group 3 and JPEG codecs</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>PlanarConfiguration</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>284</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>data i/o</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>Predictor</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>317</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>used by LZW and Deflate codecs</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>PrimaryChromacities</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>319</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>ReferenceBlackWhite</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>532</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>ResolutionUnit</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>296</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>used by Group 3 codec</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>RowsPerStrip</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>278</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>data i/o</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>SampleFormat</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>339</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>SamplesPerPixel</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>277</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>lots</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>SMinSampleValue</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>340</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>SMaxSampleValue</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>341</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>Software</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>305</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>StoNits</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>37439</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>StripByteCounts</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>279</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>data i/o</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>StripOffsets</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>273</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>data i/o</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>SubFileType</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>255</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>called OSubFileType in spec</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>TargetPrinter</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>337</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>Thresholding</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>263</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> -</td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>TileByteCounts</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>324</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>data i/o</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>TileDepth</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>32998</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>tile/strip calculations</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>TileLength</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>323</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>data i/o</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>TileOffsets</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>324</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>data i/o</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>TileWidth</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>322</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>data i/o</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>TransferFunction</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>301</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>WhitePoint</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>318</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>XPosition</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>286</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>XResolution</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>282</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>YCbCrCoefficients</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>529</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>used by TIFFRGBAImage support</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>YCbCrPositioning</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>531</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>tile/strip size calculations</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>YCbCrSubsampling</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>530</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>YPosition</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>286</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>YResolution</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>283</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>used by Group 3 codec</p></td></tr> -</table> - -<h2>PSEUDO TAGS -<a name="PSEUDO TAGS"></a> -</h2> - - -<p style="margin-left:11%; margin-top: 1em">In addition to -the normal <small>TIFF</small> tags the library supports a -collection of tags whose values lie in a range outside the -valid range of <small>TIFF</small> tags. These tags are -termed <i>pseudo-tags</i> and are used to control various -codec-specific functions within the library. The table below -summarizes the defined pseudo-tags.</p> - -<table width="100%" border="0" rules="none" frame="void" - cellspacing="0" cellpadding="0"> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p><i>Tag Name</i></p></td> -<td width="11%"></td> -<td width="7%"> - - -<p><i>Codec</i></p></td> -<td width="45%"> - - -<p><i>R/W</i></p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p><i>Library Use/Notes</i></p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>TIFFTAG_FAXMODE</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>G3</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>general codec operation</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>TIFFTAG_FAXFILLFUNC</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>G3/G4</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>bitmap fill function</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>TIFFTAG_JPEGQUALITY</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>JPEG</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>compression quality control</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>TIFFTAG_JPEGCOLORMODE</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>JPEG</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>control colorspace conversions</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>TIFFTAG_JPEGTABLESMODE</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>JPEG</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>control contents of <i>JPEGTables</i> tag</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>TIFFTAG_ZIPQUALITY</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>Deflate</p></td> -<td width="45%"> - - -<p>R/Wcompression quality level</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>TIFFTAG_PIXARLOGDATAFMT</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>PixarLog</p></td> -<td width="45%"> - - -<p>R/Wuser data format</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>TIFFTAG_PIXARLOGQUALITY</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>PixarLog</p></td> -<td width="45%"> - - -<p>R/Wcompression quality level</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"> - - -<p>TIFFTAG_SGILOGDATAFMT</p></td> -<td width="11%"></td> -<td width="7%"> - - -<p>SGILog</p></td> -<td width="45%"> - - -<p>R/W</p></td></tr> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="26%"></td> -<td width="11%"></td> -<td width="7%"></td> -<td width="45%"> - - -<p>user data format</p></td></tr> -</table> - -<p style="margin-left:11%;"><b>TIFFTAG_FAXMODE</b></p> - -<p style="margin-left:22%;">Control the operation of the -Group 3 codec. Possible values (independent bits that can be -combined by or’ing them together) are: FAXMODE_CLASSIC -(enable old-style format in which the <small>RTC</small> is -written at the end of the last strip), FAXMODE_NORTC -(opposite of FAXMODE_CLASSIC; also called FAXMODE_CLASSF), -FAXMODE_NOEOL (do not write <small>EOL</small> codes at the -start of each row of data), FAXMODE_BYTEALIGN (align each -encoded row to an 8-bit boundary), FAXMODE_WORDALIGN (align -each encoded row to an 16-bit boundary), The default value -is dependent on the compression scheme; this pseudo-tag is -used by the various G3 and G4 codecs to share code.</p> - -<p style="margin-left:11%;"><b>TIFFTAG_FAXFILLFUNC</b></p> - -<p style="margin-left:22%;">Control the function used to -convert arrays of black and white runs to packed bit arrays. -This hook can be used to image decoded scanlines in -multi-bit depth rasters (e.g. for display in colormap mode) -or for other purposes. The default value is a pointer to a -builtin function that images packed bilevel data.</p> - - -<p style="margin-left:11%;"><b>TIFFTAG_IPTCNEWSPHOTO</b></p> - -<p style="margin-left:22%;">Tag contains image metadata per -the IPTC newsphoto spec: Headline, captioning, credit, -etc... Used by most wire services.</p> - -<p style="margin-left:11%;"><b>TIFFTAG_PHOTOSHOP</b></p> - -<p style="margin-left:22%;">Tag contains Photoshop -captioning information and metadata. Photoshop uses in -parallel and redundantly alongside IPTCNEWSPHOTO -information.</p> - -<p style="margin-left:11%;"><b>TIFFTAG_JPEGQUALITY</b></p> - -<p style="margin-left:22%;">Control the compression quality -level used in the baseline algorithm. Note that quality -levels are in the range 0-100 with a default value of -75.</p> - - -<p style="margin-left:11%;"><b>TIFFTAG_JPEGCOLORMODE</b></p> - -<p style="margin-left:22%;">Control whether or not -conversion is done between RGB and YCbCr colorspaces. -Possible values are: JPEGCOLORMODE_RAW (do not convert), and -JPEGCOLORMODE_RGB (convert to/from RGB) The default value is -JPEGCOLORMODE_RAW.</p> - - -<p style="margin-left:11%;"><b>TIFFTAG_JPEGTABLESMODE</b></p> - -<p style="margin-left:22%;">Control the information written -in the <i>JPEGTables</i> tag. Possible values (independent -bits that can be combined by or’ing them together) -are: JPEGTABLESMODE_QUANT (include quantization tables), and -JPEGTABLESMODE_HUFF (include Huffman encoding tables). The -default value is -JPEGTABLESMODE_QUANT|JPEGTABLESMODE_HUFF.</p> - -<p style="margin-left:11%;"><b>TIFFTAG_ZIPQUALITY</b></p> - -<p style="margin-left:22%;">Control the compression -technique used by the Deflate codec. Quality levels are in -the range 1-9 with larger numbers yielding better -compression at the cost of more computation. The default -quality level is 6 which yields a good time-space -tradeoff.</p> - - -<p style="margin-left:11%;"><b>TIFFTAG_PIXARLOGDATAFMT</b></p> - -<p style="margin-left:22%;">Control the format of user data -passed <i>in</i> to the PixarLog codec when encoding and -passed <i>out</i> from when decoding. Possible values are: -PIXARLOGDATAFMT_8BIT for 8-bit unsigned pixels, -PIXARLOGDATAFMT_8BITABGR for 8-bit unsigned ABGR-ordered -pixels, PIXARLOGDATAFMT_11BITLOG for 11-bit log-encoded raw -data, PIXARLOGDATAFMT_12BITPICIO for 12-bit PICIO-compatible -data, PIXARLOGDATAFMT_16BIT for 16-bit signed samples, and -PIXARLOGDATAFMT_FLOAT for 32-bit IEEE floating point -samples.</p> - - -<p style="margin-left:11%;"><b>TIFFTAG_PIXARLOGQUALITY</b></p> - -<p style="margin-left:22%;">Control the compression -technique used by the PixarLog codec. This value is treated -identically to TIFFTAG_ZIPQUALITY; see the above -description.</p> - - -<p style="margin-left:11%;"><b>TIFFTAG_SGILOGDATAFMT</b></p> - -<p style="margin-left:22%;">Control the format of client -data passed <i>in</i> to the SGILog codec when encoding and -passed <i>out</i> from when decoding. Possible values are: -SGILOGDATAFMT_FLTXYZ for converting between LogLuv and -32-bit IEEE floating valued XYZ pixels, -SGILOGDATAFMT_16BITLUV for 16-bit encoded Luv pixels, -SGILOGDATAFMT_32BITRAW and SGILOGDATAFMT_24BITRAW for no -conversion of data, SGILOGDATAFMT_8BITRGB for returning -8-bit RGB data (valid only when decoding LogLuv-encoded -data), SGILOGDATAFMT_FLTY for converting between LogL and -32-bit IEEE floating valued Y pixels, SGILOGDATAFMT_16BITL -for 16-bit encoded L pixels, and SGILOGDATAFMT_8BITGRY for -returning 8-bit greyscale data (valid only when decoding -LogL-encoded data).</p> - -<h2>DIAGNOSTICS -<a name="DIAGNOSTICS"></a> -</h2> - - -<p style="margin-left:11%; margin-top: 1em">All error -messages are directed through the <i>TIFFError</i> routine. -By default messages are directed to <b>stderr</b> in the -form: <i>module: message\n.</i> Warning messages are -likewise directed through the <i>TIFFWarning</i> -routine.</p> - -<h2>SEE ALSO -<a name="SEE ALSO"></a> -</h2> - - - -<p style="margin-left:11%; margin-top: 1em"><b>fax2tiff</b>(1), -<b>gif2tiff</b>(1), <b>pal2rgb</b>(1), <b>ppm2tiff</b>(1), -<b>rgb2ycbcr</b>(1), <b>ras2tiff</b>(1), <b>raw2tiff</b>(1), -<b>sgi2tiff</b>(1), <b>tiff2bw</b>(1), <b>tiffdither</b>(1), -<b>tiffdump</b>(1), <b>tiffcp</b>(1), <b>tiffcmp</b>(1), -<b>tiffgt</b>(1), <b>tiffinfo</b>(1), <b>tiffmedian</b>(1), -<b>tiffsplit</b>(1), <b>tiffsv</b>(1).</p> - -<p style="margin-left:11%; margin-top: 1em"><b>Tag Image -File Format Specification — Revision 6.0</b>, an Aldus -Technical Memorandum.</p> - -<p style="margin-left:11%; margin-top: 1em"><b>The Spirit -of TIFF Class F</b>, an appendix to the TIFF 5.0 -specification prepared by Cygnet Technologies.</p> - -<p style="margin-left:11%; margin-top: 1em">Libtiff library -home page: <b>http://www.simplesystems.org/libtiff/</b></p> - -<h2>BUGS -<a name="BUGS"></a> -</h2> - - -<p style="margin-left:11%; margin-top: 1em">The library -does not support multi-sample images where some samples have -different bits/sample.</p> - -<p style="margin-left:11%; margin-top: 1em">The library -does not support random access to compressed data that is -organized with more than one row per tile or strip.</p> -<hr> -</body> -</html> |