Solaris/manpages/man3/libtiff.3
branch217update
changeset 19096 d542fc2c823e
equal deleted inserted replaced
19095:e8e7aa8c74b9 19096:d542fc2c823e
       
     1 <!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
       
     2 <!--ArborText, Inc., 1988-1999, v.4002-->
       
     3 <!ENTITY synp-tt "SYNOPSIS">
       
     4 <!ENTITY cmd "libtiff">
       
     5 <!ENTITY % commonents SYSTEM "smancommon.ent">
       
     6 %commonents;
       
     7 <!ENTITY % gnomecommonents SYSTEM "gnomecommon.ent">
       
     8 %gnomecommonents;
       
     9 <!ENTITY % booktitles SYSTEM "booktitles.ent">
       
    10 %booktitles;
       
    11 <!ENTITY suncopy "Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved.">
       
    12 ]>
       
    13 <?Pub UDT _bookmark _target>
       
    14 <?Pub EntList brvbar bull cross dash diam diams frac12 frac13 frac14 hellip
       
    15  laquo lArr loz mdash nabla ndash para pound rArr raquo sect yen lt gt bsol>
       
    16 <?Pub Inc>
       
    17 <refentry id="libtiff-3">
       
    18 <!-- %Z%%M% %I% %E% SMI; -->
       
    19 <refmeta><refentrytitle>libtiff</refentrytitle><manvolnum>3</manvolnum>
       
    20 <refmiscinfo class="date">06 Apr 2004</refmiscinfo>
       
    21 <refmiscinfo class="sectdesc">&man3;</refmiscinfo>
       
    22 <refmiscinfo class="software">&release;</refmiscinfo>
       
    23 <refmiscinfo class="arch">generic</refmiscinfo>
       
    24 <refmiscinfo class="copyright">&suncopy;</refmiscinfo>
       
    25 </refmeta>
       
    26 <indexterm><primary>libtiff</primary></indexterm><indexterm><primary>introduction
       
    27 to <filename>libtiff</filename>, a library for reading and writing TIFF files
       
    28 </primary></indexterm>
       
    29 <refnamediv id="libtiff-3-name"><refname>libtiff</refname><refpurpose>introduction
       
    30 to <filename>libtiff</filename>, a library for reading and writing TIFF files
       
    31 </refpurpose></refnamediv>
       
    32 <refsect1 id="libtiff-3-synp"><title>&synp-tt;</title>
       
    33 <programlisting>#include &lt;tiffio.h>
       
    34 
       
    35 cc [ <replaceable>flag</replaceable> ...]  -I/usr/sfw/include	 <replaceable>
       
    36 file</replaceable>  [  <replaceable>library</replaceable>  ...	]
       
    37 	-L/usr/sfw/lib -R/usr/sfw/lib -ltiff</programlisting>
       
    38 </refsect1>
       
    39 <refsect1 id="libtiff-3-desc"><title>&desc-tt;</title>
       
    40 <para><filename>&cmd;</filename> is a library for reading and writing data
       
    41 files encoded with the Tag Image File format, Revision 4.0 or later. The TIFF
       
    42 file format is suitable for archiving multicolor and monochromatic image data.
       
    43 </para>
       
    44 </refsect1>
       
    45 <refsect1 id="libtiff-3-exde"><title>&exde-tt;</title>
       
    46 <para>The <filename>&cmd;</filename> library supports several compression
       
    47 algorithms, as indicated by the Compression field, including:</para>
       
    48 <itemizedlist>
       
    49 <listitem><para>No compression (1)</para></listitem>
       
    50 <listitem><para>CCITT 1D Huffman compression (2)</para></listitem>
       
    51 <listitem><para>CCITT Group 3 Facsimile compression (3)</para></listitem>
       
    52 <listitem><para>CCITT Group 4 Facsimile compression (4)</para></listitem>
       
    53 <listitem><para>Lempel-Ziv &amp; Welch compression (5)</para></listitem>
       
    54 <listitem><para>Baseline JPEG compression (7)</para></listitem>
       
    55 <listitem><para>Word-aligned 1D Huffman compression (32771)</para></listitem>
       
    56 <listitem><para>PackBits compression (32773)</para></listitem>
       
    57 </itemizedlist>
       
    58 <para>In addition, several nonstandard compression algorithms are supported:
       
    59 </para>
       
    60 <itemizedlist>
       
    61 <listitem><para>4-bit compression algorithm used by the ThunderScan program
       
    62 (32809) (decompression only)</para></listitem>
       
    63 <listitem><para>NeXT's 2-bit compression algorithm (32766) (decompression
       
    64 only)</para></listitem>
       
    65 <listitem><para>Experimental LZ-style algorithm known as Deflate (32946)</para>
       
    66 </listitem>
       
    67 <listitem><para>Experimental CIE LogLuv compression scheme designed for images
       
    68 with high dynamic range (32845 for LogL and 32845 for LogLuv)</para></listitem>
       
    69 </itemizedlist>
       
    70 <para>Directory information may be in either little- or big-endian byte order.
       
    71 Byte swapping is automatically done by the library.</para>
       
    72 <para>Data bit ordering may be either Most Significant Bit (MSB) to Least
       
    73 Significant Bit (LSB), or LSB to MSB.</para>
       
    74 <para>The library does not support files in which the BitsPerSample, Compression,
       
    75 MinSampleValue, or MaxSampleValue fields are defined differently on a per-sample
       
    76 basis. In Revision 6.0, the Compression tag is not defined on a per-sample
       
    77 basis, so this is immaterial.</para>
       
    78 <refsect2 id="libtiff-3-exde-data">
       
    79 <title>Data Types</title>
       
    80 <para>The <filename>&cmd;</filename> library makes extensive use of C typedefs
       
    81 to promote portability. Two sets of typedefs are used, one for communication
       
    82 with clients of the library and one for internal data structures and parsing
       
    83 of the TIFF format. The following typedefs are exposed to users either through
       
    84 function definitions or through parameters passed through the <literal>varargs
       
    85 </literal> interfaces.</para>
       
    86 <itemizedlist>
       
    87 <listitem><para><literal>typedef unsigned short uint16;</literal> &mdash;
       
    88 16-bit unsigned integer</para></listitem>
       
    89 <listitem><para><literal>typedef unsigned &lt;thing> uint32;</literal> &mdash;
       
    90 32-bit unsigned integer</para></listitem>
       
    91 <listitem><para><literal>typedef unsigned int ttag_t;</literal> &mdash; directory
       
    92 tag</para></listitem>
       
    93 <listitem><para><literal>typedef uint16 tdir_t;</literal> &mdash; directory
       
    94 index</para></listitem>
       
    95 <listitem><para><literal>typedef uint16 tsample_t;</literal> &mdash; sample
       
    96 number</para></listitem>
       
    97 <listitem><para><literal>typedef uint32 tstrip_t;</literal> &mdash; strip
       
    98 number</para></listitem>
       
    99 <listitem><para><literal>typedef uint32 ttile_t;</literal> &mdash; tile number
       
   100 </para></listitem>
       
   101 <listitem><para><literal>typedef int32 tsize_t;</literal> &mdash; i/o size
       
   102 in bytes</para></listitem>
       
   103 <listitem><para><literal>typedef void* tdata_t;</literal> &mdash; image data
       
   104 ref</para></listitem>
       
   105 <listitem><para><literal>typedef void* thandle_t;</literal> &mdash; client
       
   106 data handle</para></listitem>
       
   107 <listitem><para><literal>typedef int32 toff_t;</literal> &mdash; file offset
       
   108 </para></listitem>
       
   109 </itemizedlist>
       
   110 <para><literal>tstrip_t</literal>, <literal>ttile_t</literal>, and <literal>
       
   111 tsize_t</literal> are limited to 32-bit quantities because they are stored
       
   112 in 32-bit fields in the TIFF image. Similarly, <literal>tsample_t</literal>
       
   113 is limited by the 16-bit field used to store the <literal>SamplesPerPixel
       
   114 </literal> tag. <literal>tdir_t</literal> constrains the maximum number of
       
   115 IFDs that may appear in an image and may be an arbitrary size without penalty.
       
   116 </para>
       
   117 <para><literal>ttag_t</literal> must be <literal>int</literal>, <literal>
       
   118 unsigned int</literal>, <literal>pointer</literal>, or <literal>double</literal>
       
   119 because the library uses a <literal>varargs</literal> interface and ANSI C
       
   120 restricts the type of the parameter before an ellipsis to be a promoted type.
       
   121 </para>
       
   122 <para><literal>toff_t</literal> is defined as <literal>int32</literal> because
       
   123 TIFF file offsets are unsigned 32-bit quantities. A signed value is used because
       
   124 some interfaces return -1 on error.</para>
       
   125 <para>User-specified data references are passed as opaque handles and only
       
   126 cast at the lowest layers where their type is presumed.</para>
       
   127 </refsect2>
       
   128 <refsect2 id="libtiff-3-exde-routines">
       
   129 <title>Library Routines</title>
       
   130 <para>The following routines are part of the <filename>&cmd;</filename> library.
       
   131 Consult specific reference pages for details on their operation. The reference
       
   132 page names listed below are for systems where the full function names cannot
       
   133 be encoded in the file system. On most systems, the command <command>man <replaceable>
       
   134 function-name</replaceable></command> will work.</para>
       
   135 <variablelist termlength="xtrawide">
       
   136 <varlistentry><term><literal>_TIFFfree</literal></term><listitem><para>Release
       
   137 allocated memory. See <citerefentry><refentrytitle>TIFFmemory</refentrytitle>
       
   138 <manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   139 </listitem></varlistentry>
       
   140 <varlistentry><term><literal>_TIFFmalloc</literal></term><listitem><para>
       
   141 Dynamically allocate memory. See <citerefentry><refentrytitle>TIFFmemory</refentrytitle>
       
   142 <manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   143 </listitem></varlistentry>
       
   144 <varlistentry><term><literal>_TIFFmemcmp</literal></term><listitem><para>
       
   145 Compare allocated memory. See <citerefentry><refentrytitle>TIFFmemory</refentrytitle>
       
   146 <manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   147 </listitem></varlistentry>
       
   148 <varlistentry><term><literal>_TIFFmemcpy</literal></term><listitem><para>
       
   149 Copy allocated memory to another memory location. See <citerefentry><refentrytitle>
       
   150 TIFFmemory</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   151 </listitem></varlistentry>
       
   152 <varlistentry><term><literal>_TIFFmemset</literal></term><listitem><para>
       
   153 Set allocated memory to known value. See <citerefentry><refentrytitle>TIFFmemory
       
   154 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   155 </listitem></varlistentry>
       
   156 <varlistentry><term><literal>_TIFFrealloc</literal></term><listitem><para>
       
   157 Dynamically reallocate memory. See <citerefentry><refentrytitle>TIFFmemory
       
   158 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   159 </listitem></varlistentry>
       
   160 <varlistentry><term><literal>TIFFbuffer</literal></term><listitem><para>Specify
       
   161 i/o buffer for reading or writing. See <citerefentry><refentrytitle>TIFFbuffer
       
   162 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   163 </listitem></varlistentry>
       
   164 <varlistentry><term><literal>TIFFCheckTile</literal></term><listitem><para>
       
   165 Every <replaceable>x,y,z,sample</replaceable> is within image. See <citerefentry>
       
   166 <refentrytitle>TIFFtile</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.
       
   167 </para>
       
   168 </listitem></varlistentry>
       
   169 <varlistentry><term><literal>TIFFClientOpen</literal></term><listitem><para>
       
   170 Open a file for reading or writing. See <citerefentry><refentrytitle>TIFFOpen
       
   171 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   172 </listitem></varlistentry>
       
   173 <varlistentry><term><literal>TIFFClose</literal></term><listitem><para>Close
       
   174 an open file. See <citerefentry><refentrytitle>TIFFClose</refentrytitle><manvolnum>
       
   175 3tiff</manvolnum></citerefentry>.</para>
       
   176 </listitem></varlistentry>
       
   177 <varlistentry><term><literal>TIFFcodec</literal></term><listitem><para>Work
       
   178 with codecs. See <citerefentry><refentrytitle>TIFFcodec</refentrytitle><manvolnum>
       
   179 3tiff</manvolnum></citerefentry>.</para>
       
   180 </listitem></varlistentry>
       
   181 <varlistentry><term><literal>TIFFComputeStrip</literal></term><listitem><para>
       
   182 Return strip containing <replaceable>x,y,z,sample</replaceable>. See <citerefentry>
       
   183 <refentrytitle>TIFFstrip</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.
       
   184 </para>
       
   185 </listitem></varlistentry>
       
   186 <varlistentry><term><literal>TIFFComputeTile</literal></term><listitem><para>
       
   187 Return tile containing <replaceable>y,sample</replaceable>. See <citerefentry>
       
   188 <refentrytitle>TIFFtile</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.
       
   189 </para>
       
   190 </listitem></varlistentry>
       
   191 <varlistentry><term><literal>TIFFCurrentDirectory</literal></term><listitem>
       
   192 <para>Return index of current directory. See <citerefentry><refentrytitle>
       
   193 TIFFquery</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   194 </listitem></varlistentry>
       
   195 <varlistentry><term><literal>TIFFCurrentRow</literal></term><listitem><para>
       
   196 Return index of current scanline. See <citerefentry><refentrytitle>TIFFquery
       
   197 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   198 </listitem></varlistentry>
       
   199 <varlistentry><term><literal>TIFFCurrentStrip</literal></term><listitem><para>
       
   200 Return index of current strip. See <citerefentry><refentrytitle>TIFFquery
       
   201 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   202 </listitem></varlistentry>
       
   203 <varlistentry><term><literal>TIFFCurrentTile</literal></term><listitem><para>
       
   204 Return index of current tile. See <citerefentry><refentrytitle>TIFFquery</refentrytitle>
       
   205 <manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   206 </listitem></varlistentry>
       
   207 <varlistentry><term><literal>TIFFDefaultStripSize</literal></term><listitem>
       
   208 <para>Return size of a strip. See <citerefentry><refentrytitle>TIFFstrip</refentrytitle>
       
   209 <manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   210 </listitem></varlistentry>
       
   211 <varlistentry><term><literal>TIFFDefaultTileSize</literal></term><listitem>
       
   212 <para>Return size of a tile. See <citerefentry><refentrytitle>TIFFtile</refentrytitle>
       
   213 <manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   214 </listitem></varlistentry>
       
   215 <varlistentry><term><literal>TIFFError</literal></term><listitem><para>Library
       
   216 error handler. See <citerefentry><refentrytitle>TIFFError</refentrytitle>
       
   217 <manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   218 </listitem></varlistentry>
       
   219 <varlistentry><term><literal>TIFFFdOpen</literal></term><listitem><para>Open
       
   220 a file for reading or writing. See <citerefentry><refentrytitle>TIFFOpen</refentrytitle>
       
   221 <manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   222 </listitem></varlistentry>
       
   223 <varlistentry><term><literal>TIFFFileName</literal></term><listitem><para>
       
   224 Return name of open file. See <citerefentry><refentrytitle>TIFFquery</refentrytitle>
       
   225 <manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   226 </listitem></varlistentry>
       
   227 <varlistentry><term><literal>TIFFFileno</literal></term><listitem><para>Return
       
   228 open file descriptor. See <citerefentry><refentrytitle>TIFFquery</refentrytitle>
       
   229 <manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   230 </listitem></varlistentry>
       
   231 <varlistentry><term><literal>TIFFFindCODEC</literal></term><listitem><para>
       
   232 Find a codec. See <citerefentry><refentrytitle>TIFFcodec</refentrytitle><manvolnum>
       
   233 3tiff</manvolnum></citerefentry>.</para>
       
   234 </listitem></varlistentry>
       
   235 <varlistentry><term><literal>TIFFFlush</literal></term><listitem><para>Flush
       
   236 all pending writes. See <citerefentry><refentrytitle>TIFFFlush</refentrytitle>
       
   237 <manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   238 </listitem></varlistentry>
       
   239 <varlistentry><term><literal>TIFFFlushData</literal></term><listitem><para>
       
   240 Flush pending data writes. See <citerefentry><refentrytitle>TIFFFlush</refentrytitle>
       
   241 <manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   242 </listitem></varlistentry>
       
   243 <varlistentry><term><literal>TIFFGetBitRevTable</literal></term><listitem>
       
   244 <para>Return bit reversal table. See <citerefentry><refentrytitle>TIFFswab
       
   245 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   246 </listitem></varlistentry>
       
   247 <varlistentry><term><literal>TIFFGetField</literal></term><listitem><para>
       
   248 Return tag value in current directory. See <citerefentry><refentrytitle>TIFFGetField
       
   249 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   250 </listitem></varlistentry>
       
   251 <varlistentry><term><literal>TIFFGetFieldDefaulted</literal></term><listitem>
       
   252 <para>Return tag value in current directory. See <citerefentry><refentrytitle>
       
   253 TIFFGetField</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   254 </listitem></varlistentry>
       
   255 <varlistentry><term><literal>TIFFGetMode</literal></term><listitem><para>
       
   256 Return open file mode. See <citerefentry><refentrytitle>TIFFquery</refentrytitle>
       
   257 <manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   258 </listitem></varlistentry>
       
   259 <varlistentry><term><literal>TIFFGetVersion</literal></term><listitem><para>
       
   260 Return library version string. See <citerefentry><refentrytitle>TIFFquery
       
   261 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   262 </listitem></varlistentry>
       
   263 <varlistentry><term><literal>TIFFIsByteSwapped</literal></term><listitem>
       
   264 <para>Return true if image data is byte-swapped. See <citerefentry><refentrytitle>
       
   265 TIFFquery</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   266 </listitem></varlistentry>
       
   267 <varlistentry><term><literal>TIFFIsMSB2LSB</literal></term><listitem><para>
       
   268 Return true if image data is returned with bit 0 as the most significant bit.
       
   269 See <citerefentry><refentrytitle>TIFFquery</refentrytitle><manvolnum>3tiff
       
   270 </manvolnum></citerefentry>.</para>
       
   271 </listitem></varlistentry>
       
   272 <varlistentry><term><literal>TIFFIsTiled</literal></term><listitem><para>
       
   273 Return true if image data is tiled. See <citerefentry><refentrytitle>TIFFquery
       
   274 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   275 </listitem></varlistentry>
       
   276 <varlistentry><term><literal>TIFFIsUpSampled</literal></term><listitem><para>
       
   277 Return true if image data is up-sampled. See <citerefentry><refentrytitle>
       
   278 TIFFquery</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   279 </listitem></varlistentry>
       
   280 <varlistentry><term><literal>TIFFLastDirectory</literal></term><listitem>
       
   281 <para>Return a non-zero value if the current directory is the last directory
       
   282 in the file. See <citerefentry><refentrytitle>TIFFquery</refentrytitle><manvolnum>
       
   283 3tiff</manvolnum></citerefentry>.</para>
       
   284 </listitem></varlistentry>
       
   285 <varlistentry><term><literal>TIFFmemory</literal></term><listitem><para>Manage
       
   286 memory. See <citerefentry><refentrytitle>TIFFmemory</refentrytitle><manvolnum>
       
   287 3tiff</manvolnum></citerefentry>.</para>
       
   288 </listitem></varlistentry>
       
   289 <varlistentry><term><literal>TIFFNumberOfStrips</literal></term><listitem>
       
   290 <para>Return number of strips in an image. See <citerefentry><refentrytitle>
       
   291 TIFFstrip</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   292 </listitem></varlistentry>
       
   293 <varlistentry><term><literal>TIFFNumberOfTiles</literal></term><listitem>
       
   294 <para>Return number of tiles in an image. See <citerefentry><refentrytitle>
       
   295 TIFFtile</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   296 </listitem></varlistentry>
       
   297 <varlistentry><term><literal>TIFFOpen</literal></term><listitem><para>Open
       
   298 a file for reading or writing. See <citerefentry><refentrytitle>TIFFOpen</refentrytitle>
       
   299 <manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   300 </listitem></varlistentry>
       
   301 <varlistentry><term><literal>TIFFPrintDirectory</literal></term><listitem>
       
   302 <para>Print description of the current directory. See <citerefentry><refentrytitle>
       
   303 TIFFPrintDirectory</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.
       
   304 </para>
       
   305 </listitem></varlistentry>
       
   306 <varlistentry><term><literal>TIFFquery</literal></term><listitem><para>Return
       
   307 information about image. <?Pub Caret>See <citerefentry><refentrytitle>TIFFquery
       
   308 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   309 </listitem></varlistentry>
       
   310 <varlistentry><term><literal>TIFFRasterScanlineSize</literal></term><listitem>
       
   311 <para>Return size of a raster scanline. See <citerefentry><refentrytitle>
       
   312 TIFFsize</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   313 </listitem></varlistentry>
       
   314 <varlistentry><term><literal>TIFFReadBufferSetup</literal></term><listitem>
       
   315 <para>Specify i/o buffer for reading. See <citerefentry><refentrytitle>TIFFbuffer
       
   316 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   317 </listitem></varlistentry>
       
   318 <varlistentry><term><literal>TIFFReadDirectory</literal></term><listitem>
       
   319 <para>Read the next directory. See <citerefentry><refentrytitle>TIFFReadDirectory
       
   320 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   321 </listitem></varlistentry>
       
   322 <varlistentry><term><literal>TIFFReadEncodedStrip</literal></term><listitem>
       
   323 <para>Read and decode a strip of data. See <citerefentry><refentrytitle>TIFFReadEncodedStrip
       
   324 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   325 </listitem></varlistentry>
       
   326 <varlistentry><term><literal>TIFFReadEncodedTile</literal></term><listitem>
       
   327 <para>Read and decode a tile of data. See <citerefentry><refentrytitle>TIFFReadEncodedTile
       
   328 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   329 </listitem></varlistentry>
       
   330 <varlistentry><term><literal>TIFFReadRawStrip</literal></term><listitem><para>
       
   331 Read a raw strip of data. See <citerefentry><refentrytitle>TIFFReadRawStrip
       
   332 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   333 </listitem></varlistentry>
       
   334 <varlistentry><term><literal>TIFFReadRawTile</literal></term><listitem><para>
       
   335 Read a raw tile of data. See <citerefentry><refentrytitle>TIFFReadRawTile
       
   336 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   337 </listitem></varlistentry>
       
   338 <varlistentry><term><literal>TIFFReadRGBAImage</literal></term><listitem>
       
   339 <para>Read an image into a fixed format raster. See <citerefentry><refentrytitle>
       
   340 TIFFReadRGBAImage</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.
       
   341 </para>
       
   342 </listitem></varlistentry>
       
   343 <varlistentry><term><literal>TIFFReadRGBAStrip</literal></term><listitem>
       
   344 <para>Read an image strip into a fixed format raster. See <citerefentry><refentrytitle>
       
   345 TIFFReadRGBAStrip</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.
       
   346 </para>
       
   347 </listitem></varlistentry>
       
   348 <varlistentry><term><literal>TIFFReadRGBATile</literal></term><listitem><para>
       
   349 Read an image tile into a fixed format raster. See <citerefentry><refentrytitle>
       
   350 TIFFReadRGBATile</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.
       
   351 </para>
       
   352 </listitem></varlistentry>
       
   353 <varlistentry><term><literal>TIFFReadScanline</literal></term><listitem><para>
       
   354 Read and decode a row of data. See <citerefentry><refentrytitle>TIFFReadScanline
       
   355 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   356 </listitem></varlistentry>
       
   357 <varlistentry><term><literal>TIFFReadTile</literal></term><listitem><para>
       
   358 Read and decode a tile of data. See <citerefentry><refentrytitle>TIFFReadTile
       
   359 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   360 </listitem></varlistentry>
       
   361 <varlistentry><term><literal>TIFFRegisterCODEC</literal></term><listitem>
       
   362 <para>Register a codec. See <citerefentry><refentrytitle>TIFFcodec</refentrytitle>
       
   363 <manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   364 </listitem></varlistentry>
       
   365 <varlistentry><term><literal>TIFFReverseBits</literal></term><listitem><para>
       
   366 Reverse bits in an array of bytes. See <citerefentry><refentrytitle>TIFFswab
       
   367 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   368 </listitem></varlistentry>
       
   369 <varlistentry><term><literal>TIFFRGBAImage</literal></term><listitem><para>
       
   370 Read and decode an image into a raster. See <citerefentry><refentrytitle>
       
   371 TIFFRGBAImage</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.
       
   372 </para>
       
   373 </listitem></varlistentry>
       
   374 <varlistentry><term><literal>TIFFRGBAImageBegin</literal></term><listitem>
       
   375 <para>Set up decoder state for <literal>TIFFRGBAImageGet</literal>. See <citerefentry>
       
   376 <refentrytitle>TIFFRGBAImage</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.
       
   377 </para>
       
   378 </listitem></varlistentry>
       
   379 <varlistentry><term><literal>TIFFRGBAImageEnd</literal></term><listitem><para>
       
   380 Release <literal>TIFFRGBAImage</literal> decoder state. See <citerefentry>
       
   381 <refentrytitle>TIFFRGBAImage</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.
       
   382 </para>
       
   383 </listitem></varlistentry>
       
   384 <varlistentry><term><literal>TIFFRGBAImageGet</literal></term><listitem><para>
       
   385 Read and decode an image. See <citerefentry><refentrytitle>TIFFRGBAImage</refentrytitle>
       
   386 <manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   387 </listitem></varlistentry>
       
   388 <varlistentry><term><literal>TIFFRGBAImageOK</literal></term><listitem><para>
       
   389 Determine whether image is readable by <literal>TIFFRGBAImageGet</literal>.
       
   390 See <citerefentry><refentrytitle>TIFFRGBAImage</refentrytitle><manvolnum>
       
   391 3tiff</manvolnum></citerefentry>.</para>
       
   392 </listitem></varlistentry>
       
   393 <varlistentry><term><literal>TIFFScanlineSize</literal></term><listitem><para>
       
   394 Return size of a scanline. See <citerefentry><refentrytitle>TIFFsize</refentrytitle>
       
   395 <manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   396 </listitem></varlistentry>
       
   397 <varlistentry><term><literal>TIFFSetDirectory</literal></term><listitem><para>
       
   398 Set the current directory. See <citerefentry><refentrytitle>TIFFSetDirectory
       
   399 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   400 </listitem></varlistentry>
       
   401 <varlistentry><term><literal>TIFFSetSubDirectory</literal></term><listitem>
       
   402 <para>Set the current directory. See <citerefentry><refentrytitle>TIFFSetDirectory
       
   403 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   404 </listitem></varlistentry>
       
   405 <varlistentry><term><literal>TIFFSetErrorHandler</literal></term><listitem>
       
   406 <para>Set error handler function. See <citerefentry><refentrytitle>TIFFError
       
   407 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   408 </listitem></varlistentry>
       
   409 <varlistentry><term><literal>TIFFSetField</literal></term><listitem><para>
       
   410 Set tag value in the current directory. See <citerefentry><refentrytitle>
       
   411 TIFFSetField</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   412 </listitem></varlistentry>
       
   413 <varlistentry><term><literal>TIFFSetWarningHandler</literal></term><listitem>
       
   414 <para>Set warning handler function. See <citerefentry><refentrytitle>TIFFWarning
       
   415 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   416 </listitem></varlistentry>
       
   417 <varlistentry><term><literal>TIFFsize</literal></term><listitem><para>Return
       
   418 the size. See <citerefentry><refentrytitle>TIFFsize</refentrytitle><manvolnum>
       
   419 3tiff</manvolnum></citerefentry>.</para>
       
   420 </listitem></varlistentry>
       
   421 <varlistentry><term><literal>TIFFstrip</literal></term><listitem><para>Work
       
   422 with strips. See <citerefentry><refentrytitle>TIFFstrip</refentrytitle><manvolnum>
       
   423 3tiff</manvolnum></citerefentry>.</para>
       
   424 </listitem></varlistentry>
       
   425 <varlistentry><term><literal>TIFFStripSize</literal></term><listitem><para>
       
   426 Return size of a strip. See <citerefentry><refentrytitle>TIFFstrip</refentrytitle>
       
   427 <manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   428 </listitem></varlistentry>
       
   429 <varlistentry><term><literal>TIFFswab</literal></term><listitem><para>Swap
       
   430 bytes. See <citerefentry><refentrytitle>TIFFswab</refentrytitle><manvolnum>
       
   431 3tiff</manvolnum></citerefentry>.</para>
       
   432 </listitem></varlistentry>
       
   433 <varlistentry><term><literal>TIFFSwabShort</literal></term><listitem><para>
       
   434 Swap bytes of short. See <citerefentry><refentrytitle>TIFFswab</refentrytitle>
       
   435 <manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   436 </listitem></varlistentry>
       
   437 <varlistentry><term><literal>TIFFSwabLong</literal></term><listitem><para>
       
   438 Swap bytes of long. See <citerefentry><refentrytitle>TIFFswab</refentrytitle>
       
   439 <manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   440 </listitem></varlistentry>
       
   441 <varlistentry><term><literal>TIFFSwabArrayOfShort</literal></term><listitem>
       
   442 <para>Swap bytes of an array of shorts. See <citerefentry><refentrytitle>
       
   443 TIFFswab</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   444 </listitem></varlistentry>
       
   445 <varlistentry><term><literal>TIFFSwabArrayOfLong</literal></term><listitem>
       
   446 <para>Swap bytes of an array of longs. See <citerefentry><refentrytitle>TIFFswab
       
   447 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   448 </listitem></varlistentry>
       
   449 <varlistentry><term><literal>TIFFtile</literal></term><listitem><para>Return
       
   450 tile information. See <citerefentry><refentrytitle>TIFFtile</refentrytitle>
       
   451 <manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   452 </listitem></varlistentry>
       
   453 <varlistentry><term><literal>TIFFTileRowSize</literal></term><listitem><para>
       
   454 Return size of a row in a tile. See <citerefentry><refentrytitle>TIFFtile
       
   455 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   456 </listitem></varlistentry>
       
   457 <varlistentry><term><literal>TIFFTileSize</literal></term><listitem><para>
       
   458 Return size of a tile. See <citerefentry><refentrytitle>TIFFtile</refentrytitle>
       
   459 <manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   460 </listitem></varlistentry>
       
   461 <varlistentry><term><literal>TIFFUnregisterCODEC</literal></term><listitem>
       
   462 <para>Unregister a codec. See <citerefentry><refentrytitle>TIFFcodec</refentrytitle>
       
   463 <manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   464 </listitem></varlistentry>
       
   465 <varlistentry><term><literal>TIFFVGetField</literal></term><listitem><para>
       
   466 Return tag value in current directory. See <citerefentry><refentrytitle>TIFFGetField
       
   467 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   468 </listitem></varlistentry>
       
   469 <varlistentry><term><literal>TIFFVGetFieldDefaulted</literal></term><listitem>
       
   470 <para>Return tag value in current directory. See <citerefentry><refentrytitle>
       
   471 TIFFGetField</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   472 </listitem></varlistentry>
       
   473 <varlistentry><term><literal>TIFFVSetField</literal></term><listitem><para>
       
   474 Set tag value in current directory. See <citerefentry><refentrytitle>TIFFSetField
       
   475 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   476 </listitem></varlistentry>
       
   477 <varlistentry><term><literal>TIFFVStripSize</literal></term><listitem><para>
       
   478 Return size of a strip. See <citerefentry><refentrytitle>TIFFstrip</refentrytitle>
       
   479 <manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   480 </listitem></varlistentry>
       
   481 <varlistentry><term><literal>TIFFVTileSize</literal></term><listitem><para>
       
   482 Return size of a tile. See <citerefentry><refentrytitle>TIFFtile</refentrytitle>
       
   483 <manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   484 </listitem></varlistentry>
       
   485 <varlistentry><term><literal>TIFFWarning</literal></term><listitem><para>
       
   486 Library warning handler. See <citerefentry><refentrytitle>TIFFWarning</refentrytitle>
       
   487 <manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   488 </listitem></varlistentry>
       
   489 <varlistentry><term><literal>TIFFWriteBufferSetup</literal></term><listitem>
       
   490 <para>Specify i/o buffer for writing. See <citerefentry><refentrytitle>TIFFbuffer
       
   491 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   492 </listitem></varlistentry>
       
   493 <varlistentry><term><literal>TIFFWriteDirectory</literal></term><listitem>
       
   494 <para>Write the current directory. See <citerefentry><refentrytitle>TIFFWriteDirectory
       
   495 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   496 </listitem></varlistentry>
       
   497 <varlistentry><term><literal>TIFFWriteEncodedStrip</literal></term><listitem>
       
   498 <para>Compress and write a strip of data. See <citerefentry><refentrytitle>
       
   499 TIFFWriteEncodedStrip</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.
       
   500 </para>
       
   501 </listitem></varlistentry>
       
   502 <varlistentry><term><literal>TIFFWriteEncodedTile</literal></term><listitem>
       
   503 <para>Compress and write a tile of data. See <citerefentry><refentrytitle>
       
   504 TIFFWriteEncodedTile</refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.
       
   505 </para>
       
   506 </listitem></varlistentry>
       
   507 <varlistentry><term><literal>TIFFWriteRawStrip</literal></term><listitem>
       
   508 <para>Write a raw strip of data. See <citerefentry><refentrytitle>TIFFWriteRawStrip
       
   509 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   510 </listitem></varlistentry>
       
   511 <varlistentry><term><literal>TIFFWriteRawTile</literal></term><listitem><para>
       
   512 Write a raw tile of data. See <citerefentry><refentrytitle>TIFFWriteRawTile
       
   513 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   514 </listitem></varlistentry>
       
   515 <varlistentry><term><literal>TIFFWriteScanline</literal></term><listitem>
       
   516 <para>Write a scanline of data. See <citerefentry><refentrytitle>TIFFWriteScanline
       
   517 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   518 </listitem></varlistentry>
       
   519 <varlistentry><term><literal>TIFFWriteTile</literal></term><listitem><para>
       
   520 Compress and write a tile of data. See <citerefentry><refentrytitle>TIFFWriteTile
       
   521 </refentrytitle><manvolnum>3tiff</manvolnum></citerefentry>.</para>
       
   522 </listitem></varlistentry>
       
   523 </variablelist></refsect2>
       
   524 <refsect2 id="libtiff-3-exde-tags">
       
   525 <title>Tag Usage</title>
       
   526 <para>The table below lists the TIFF tags that are recognized and supported
       
   527 by the <filename>&cmd;</filename> library. If no use is indicated in the table,
       
   528 then the library reads and writes the tag, but does not use the tag internally.
       
   529 Note that some tags are meaningful only when a particular compression scheme
       
   530 is used. For example, <literal>Group3Options</literal> is only useful if Compression
       
   531 is set to <literal>CCITT Group 3</literal> encoding. Tags of this sort are
       
   532 considered codec-specific tags and the library does not recognize them except
       
   533 when the Compression tag has been previously set to the relevant compression
       
   534 scheme.</para>
       
   535 <informaltable frame="all">
       
   536 <tgroup cols="4" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="25*">
       
   537 <colspec colname="COLSPEC1" colwidth="25*"><colspec colname="COLSPEC2" colwidth="25*">
       
   538 <colspec colname="COLSPEC3" colwidth="25*">
       
   539 <thead>
       
   540 <row rowsep="1"><entry colsep="1" rowsep="1"><para>TAG NAME</para></entry>
       
   541 <entry colsep="1" rowsep="1"><para>VALUE</para></entry><entry colsep="1" rowsep="1"><para>
       
   542 R/W</para></entry><entry colsep="1" rowsep="1"><para>LIBRARY USE / NOTES</para></entry>
       
   543 </row>
       
   544 </thead>
       
   545 <tbody>
       
   546 <row><entry colsep="1" rowsep="1"><para><literal>Artist</literal></para></entry>
       
   547 <entry colsep="1" rowsep="1"><para>315</para></entry><entry colsep="1" rowsep="1"><para>
       
   548 R/W</para></entry><entry colsep="1" rowsep="1"><para></para></entry></row>
       
   549 <row><entry colsep="1" rowsep="1"><para><literal>BadFaxLines</literal></para></entry>
       
   550 <entry colsep="1" rowsep="1"><para>326</para></entry><entry colsep="1" rowsep="1"><para>
       
   551 R/W</para></entry><entry colsep="1" rowsep="1"><para></para></entry></row>
       
   552 <row><entry colsep="1" rowsep="1"><para><literal>BitsPerSample</literal></para></entry>
       
   553 <entry colsep="1" rowsep="1"><para>258</para></entry><entry colsep="1" rowsep="1"><para>
       
   554 R/W</para></entry><entry colsep="1" rowsep="1"><para>Lots.</para></entry>
       
   555 </row>
       
   556 <row><entry colsep="1" rowsep="1"><para><literal>CellLength</literal></para></entry>
       
   557 <entry colsep="1" rowsep="1"><para>265</para></entry><entry colsep="1" rowsep="1"><para></para></entry>
       
   558 <entry colsep="1" rowsep="1"><para>Parsed but ignored.</para></entry></row>
       
   559 <row><entry colsep="1" rowsep="1"><para><literal>CellWidth</literal></para></entry>
       
   560 <entry colsep="1" rowsep="1"><para>264</para></entry><entry colsep="1" rowsep="1"><para></para></entry>
       
   561 <entry colsep="1" rowsep="1"><para>Parsed but ignored.</para></entry></row>
       
   562 <row><entry colsep="1" rowsep="1"><para><literal>CleanFaxData</literal></para></entry>
       
   563 <entry colsep="1" rowsep="1"><para>327</para></entry><entry colsep="1" rowsep="1"><para>
       
   564 R/W</para></entry><entry colsep="1" rowsep="1"><para></para></entry></row>
       
   565 <row><entry colsep="1" rowsep="1"><para><literal>ColorMap</literal></para></entry>
       
   566 <entry colsep="1" rowsep="1"><para>320</para></entry><entry colsep="1" rowsep="1"><para>
       
   567 R/W</para></entry><entry colsep="1" rowsep="1"><para></para></entry></row>
       
   568 <row><entry colsep="1" rowsep="1"><para><literal>ColorResponseUnit</literal></para></entry>
       
   569 <entry colsep="1" rowsep="1"><para>300</para></entry><entry colsep="1" rowsep="1"><para></para></entry>
       
   570 <entry colsep="1" rowsep="1"><para>Parsed but ignored.</para></entry></row>
       
   571 <row><entry colsep="1" rowsep="1"><para><literal>Compression</literal></para></entry>
       
   572 <entry colsep="1" rowsep="1"><para>259</para></entry><entry colsep="1" rowsep="1"><para>
       
   573 R/W</para></entry><entry colsep="1" rowsep="1"><para>Choosing codec.</para></entry>
       
   574 </row>
       
   575 <row><entry colsep="1" rowsep="1"><para><literal>ConsecutiveBadFaxLines</literal></para></entry>
       
   576 <entry colsep="1" rowsep="1"><para>328</para></entry><entry colsep="1" rowsep="1"><para>
       
   577 R/W</para></entry><entry colsep="1" rowsep="1"><para></para></entry></row>
       
   578 <row><entry colsep="1" rowsep="1"><para><literal>DataType</literal></para></entry>
       
   579 <entry colsep="1" rowsep="1"><para>32996</para></entry><entry colsep="1" rowsep="1"><para>
       
   580 R</para></entry><entry colsep="1" rowsep="1"><para>Obsoleted by <literal>
       
   581 SampleFormat</literal> tag.</para></entry></row>
       
   582 <row><entry colsep="1" rowsep="1"><para><literal>DateTime</literal></para></entry>
       
   583 <entry colsep="1" rowsep="1"><para>306</para></entry><entry colsep="1" rowsep="1"><para>
       
   584 R/W</para></entry><entry colsep="1" rowsep="1"><para></para></entry></row>
       
   585 <row><entry colsep="1" rowsep="1"><para><literal>DocumentName</literal></para></entry>
       
   586 <entry colsep="1" rowsep="1"><para>269</para></entry><entry colsep="1" rowsep="1"><para>
       
   587 R/W</para></entry><entry colsep="1" rowsep="1"><para></para></entry></row>
       
   588 <row><entry colsep="1" rowsep="1"><para><literal>DotRange</literal></para></entry>
       
   589 <entry colsep="1" rowsep="1"><para>336</para></entry><entry colsep="1" rowsep="1"><para>
       
   590 R/W</para></entry><entry colsep="1" rowsep="1"><para></para></entry></row>
       
   591 <row><entry colsep="1" rowsep="1"><para><literal>ExtraSamples</literal></para></entry>
       
   592 <entry colsep="1" rowsep="1"><para>338</para></entry><entry colsep="1" rowsep="1"><para>
       
   593 R/W</para></entry><entry colsep="1" rowsep="1"><para>Lots.</para></entry>
       
   594 </row>
       
   595 <row><entry colsep="1" rowsep="1"><para><literal>FaxRecvParams</literal></para></entry>
       
   596 <entry colsep="1" rowsep="1"><para>34908</para></entry><entry colsep="1" rowsep="1"><para>
       
   597 R/W</para></entry><entry colsep="1" rowsep="1"><para></para></entry></row>
       
   598 <row><entry colsep="1" rowsep="1"><para><literal>FaxSubAddress</literal></para></entry>
       
   599 <entry colsep="1" rowsep="1"><para>34909</para></entry><entry colsep="1" rowsep="1"><para>
       
   600 R/W</para></entry><entry colsep="1" rowsep="1"><para></para></entry></row>
       
   601 <row><entry colsep="1" rowsep="1"><para><literal>FaxRecvTime</literal></para></entry>
       
   602 <entry colsep="1" rowsep="1"><para>34910</para></entry><entry colsep="1" rowsep="1"><para>
       
   603 R/W</para></entry><entry colsep="1" rowsep="1"><para></para></entry></row>
       
   604 <row><entry colsep="1" rowsep="1"><para><literal>FillOrder</literal></para></entry>
       
   605 <entry colsep="1" rowsep="1"><para>266</para></entry><entry colsep="1" rowsep="1"><para>
       
   606 R/W</para></entry><entry colsep="1" rowsep="1"><para>Control bit order.</para></entry>
       
   607 </row>
       
   608 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>FreeByteCounts
       
   609 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   610 289</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para></para></entry>
       
   611 <entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Parsed but ignored.
       
   612 </para></entry></row>
       
   613 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>FreeOffsets
       
   614 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   615 288</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para></para></entry>
       
   616 <entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Parsed but ignored.
       
   617 </para></entry></row>
       
   618 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>GrayResponseCurve
       
   619 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   620 291</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para></para></entry>
       
   621 <entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Parsed but ignored.
       
   622 </para></entry></row>
       
   623 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>GrayResponseUnit
       
   624 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   625 290</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para></para></entry>
       
   626 <entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Parsed but ignored.
       
   627 </para></entry></row>
       
   628 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>Group3Options
       
   629 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   630 292</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   631 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Used
       
   632 by Group 3 codec.</para></entry></row>
       
   633 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>Group4Options
       
   634 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   635 293</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   636 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   637 </row>
       
   638 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>HostComputer
       
   639 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   640 316</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   641 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   642 </row>
       
   643 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>ImageDepth
       
   644 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   645 32997</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>
       
   646 R/W</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Tile/strip
       
   647 calculations.</para></entry></row>
       
   648 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>ImageDescription
       
   649 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   650 270</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   651 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   652 </row>
       
   653 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>ImageLength
       
   654 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   655 257</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   656 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Lots.
       
   657 </para></entry></row>
       
   658 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>ImageWidth
       
   659 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   660 256</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   661 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Lots.
       
   662 </para></entry></row>
       
   663 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>InkNames
       
   664 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   665 333</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   666 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   667 </row>
       
   668 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>InkSet
       
   669 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   670 332</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   671 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   672 </row>
       
   673 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>JPEGTables
       
   674 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   675 347</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   676 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Used
       
   677 by JPEG codec.</para></entry></row>
       
   678 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>Make</literal></para></entry>
       
   679 <entry colname="COLSPEC1" colsep="1" rowsep="1"><para>271</para></entry><entry
       
   680 colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W</para></entry><entry colname="COLSPEC3"
       
   681 colsep="1" rowsep="1"><para></para></entry></row>
       
   682 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>Matteing
       
   683 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   684 32995</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>
       
   685 R</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Obsoleted
       
   686 by <literal>ExtraSamples</literal> tag.</para></entry></row>
       
   687 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>MaxSampleValue
       
   688 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   689 281</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   690 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   691 </row>
       
   692 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>MinSampleValue
       
   693 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   694 280</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   695 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   696 </row>
       
   697 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>Model
       
   698 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   699 272</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   700 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   701 </row>
       
   702 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>NewSubFileType
       
   703 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   704 254</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   705 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Called <literal>
       
   706 SubFileType</literal> in spec.</para></entry></row>
       
   707 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>NumberOfInks
       
   708 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   709 334</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   710 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   711 </row>
       
   712 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>Orientation
       
   713 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   714 274</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   715 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   716 </row>
       
   717 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>PageName
       
   718 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   719 285</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   720 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   721 </row>
       
   722 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>PageNumber
       
   723 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   724 297</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   725 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   726 </row>
       
   727 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>PhotometricInterpretation
       
   728 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   729 262</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   730 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Used
       
   731 by Group 3 and JPEG codecs.</para></entry></row>
       
   732 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>PlanarConfiguration
       
   733 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   734 284</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   735 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Data
       
   736 i/o.</para></entry></row>
       
   737 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>Predictor
       
   738 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   739 317</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   740 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Used
       
   741 by LZW and Deflate codecs.</para></entry></row>
       
   742 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>PrimaryChromacities
       
   743 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   744 319</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   745 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   746 </row>
       
   747 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>ReferenceBlackWhite
       
   748 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   749 532</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   750 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   751 </row>
       
   752 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>ResolutionUnit
       
   753 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   754 296</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   755 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Used
       
   756 by Group 3 codec.</para></entry></row>
       
   757 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>RowsPerStrip
       
   758 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   759 278</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   760 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Data
       
   761 i/o.</para></entry></row>
       
   762 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>SampleFormat
       
   763 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   764 339</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   765 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   766 </row>
       
   767 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>SamplesPerPixel
       
   768 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   769 277</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   770 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Lots.
       
   771 </para></entry></row>
       
   772 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>SMinSampleValue
       
   773 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   774 340</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   775 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   776 </row>
       
   777 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>SMaxSampleValue
       
   778 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   779 341</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   780 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   781 </row>
       
   782 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>Software
       
   783 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   784 305</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   785 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   786 </row>
       
   787 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>StoNits
       
   788 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   789 37439</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>
       
   790 R/W</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   791 </row>
       
   792 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>StripByteCounts
       
   793 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   794 279</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   795 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Data
       
   796 i/o.</para></entry></row>
       
   797 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>StripOffsets
       
   798 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   799 273</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   800 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Data
       
   801 i/o.</para></entry></row>
       
   802 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>SubFileType
       
   803 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   804 255</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   805 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Called <literal>
       
   806 OSubFileType</literal> in spec.</para></entry></row>
       
   807 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>TargetPrinter
       
   808 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   809 337</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   810 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   811 </row>
       
   812 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>Thresholding
       
   813 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   814 263</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   815 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   816 </row>
       
   817 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>TileByteCounts
       
   818 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   819 324</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   820 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Data
       
   821 i/o.</para></entry></row>
       
   822 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>TileDepth
       
   823 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   824 32998</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>
       
   825 R/W</para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Tile/strip
       
   826 calculations.</para></entry></row>
       
   827 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>TileLength
       
   828 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   829 323</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   830 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Data
       
   831 i/o.</para></entry></row>
       
   832 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>TileOffsets
       
   833 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   834 324</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   835 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Data
       
   836 i/o.</para></entry></row>
       
   837 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>TileWidth
       
   838 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   839 322</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   840 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Data
       
   841 i/o.</para></entry></row>
       
   842 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>TransferFunction
       
   843 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   844 301</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   845 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   846 </row>
       
   847 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>WhitePoint
       
   848 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   849 318</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   850 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   851 </row>
       
   852 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>XPosition
       
   853 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   854 286</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   855 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   856 </row>
       
   857 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>XResolution
       
   858 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   859 282</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   860 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   861 </row>
       
   862 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>YCbCrCoefficients
       
   863 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   864 529</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   865 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Used
       
   866 by TIFFRGBAImage support.</para></entry></row>
       
   867 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>YCbCrPositioning
       
   868 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   869 531</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   870 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Tile/strip
       
   871 size calulcations.</para></entry></row>
       
   872 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>YCbCrSubsampling
       
   873 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   874 530</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   875 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   876 </row>
       
   877 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>YPosition
       
   878 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   879 286</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   880 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para></para></entry>
       
   881 </row>
       
   882 <row><entry colname="COLSPEC0" colsep="1" rowsep="1"><para><literal>YResolution
       
   883 </literal></para></entry><entry colname="COLSPEC1" colsep="1" rowsep="1"><para>
       
   884 283</para></entry><entry colname="COLSPEC2" colsep="1" rowsep="1"><para>R/W
       
   885 </para></entry><entry colname="COLSPEC3" colsep="1" rowsep="1"><para>Used
       
   886 by Group 3 codec.</para></entry></row>
       
   887 </tbody>
       
   888 </tgroup>
       
   889 </informaltable>
       
   890 </refsect2>
       
   891 <refsect2 id="libtiff-3-exde-pseudo">
       
   892 <title>Pseudo Tags</title>
       
   893 <para>In addition to the normal TIFF tags, the <filename>&cmd;</filename>
       
   894 library supports a collection of tags whose values lie in a range outside
       
   895 the valid range of TIFF tags. These tags are termed pseudo-tags and are used
       
   896 to control various codec-specific functions within the library. The table
       
   897 below summarizes the defined pseudo-tags.</para>
       
   898 <informaltable frame="all">
       
   899 <tgroup cols="4" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="25*">
       
   900 <colspec colname="COLSPEC1" colwidth="25*"><colspec colname="COLSPEC2" colwidth="25*">
       
   901 <colspec colname="COLSPEC3" colwidth="25*">
       
   902 <thead>
       
   903 <row><entry colname="COLSPEC0"><para>TAG NAME</para></entry><entry colname="COLSPEC1"><para>
       
   904 CODEC</para></entry><entry colname="COLSPEC2"><para>R/W</para></entry><entry
       
   905 colname="COLSPEC3"><para>LIBRARY USE / NOTES</para></entry></row>
       
   906 </thead>
       
   907 <tbody>
       
   908 <row><entry colname="COLSPEC0"><para><literal>TIFFTAG_FAXMODE</literal></para></entry>
       
   909 <entry colname="COLSPEC1"><para>G3</para></entry><entry colname="COLSPEC2"><para>
       
   910 R/W</para></entry><entry colname="COLSPEC3"><para>General codec operation.
       
   911 </para></entry></row>
       
   912 <row><entry colname="COLSPEC0"><para><literal>TIFFTAG_FAXFILLFUNC</literal></para></entry>
       
   913 <entry colname="COLSPEC1"><para>G3/G4</para></entry><entry colname="COLSPEC2"><para>
       
   914 R/W</para></entry><entry colname="COLSPEC3"><para>Bitmap fill function.</para></entry>
       
   915 </row>
       
   916 <row><entry colname="COLSPEC0"><para><literal>TIFFTAG_JPEGQUALITY</literal></para></entry>
       
   917 <entry colname="COLSPEC1"><para>JPEG</para></entry><entry colname="COLSPEC2"><para>
       
   918 R/W</para></entry><entry colname="COLSPEC3"><para>Compression quality control.
       
   919 </para></entry></row>
       
   920 <row><entry colname="COLSPEC0"><para><literal>TIFFTAG_JPEGCOLORMODE</literal></para></entry>
       
   921 <entry colname="COLSPEC1"><para>JPEG</para></entry><entry colname="COLSPEC2"><para>
       
   922 R/W</para></entry><entry colname="COLSPEC3"><para>Control colorspace conversions.
       
   923 </para></entry></row>
       
   924 <row><entry colname="COLSPEC0"><para><literal>TIFFTAG_JPEGTABLESMODE</literal></para></entry>
       
   925 <entry colname="COLSPEC1"><para>JPEG</para></entry><entry colname="COLSPEC2"><para>
       
   926 R/W</para></entry><entry colname="COLSPEC3"><para>Control contents of <literal>
       
   927 JPEGTables</literal> tag.</para></entry></row>
       
   928 <row><entry colname="COLSPEC0"><para><literal>TIFFTAG_ZIPQUALITY</literal></para></entry>
       
   929 <entry colname="COLSPEC1"><para>Deflate</para></entry><entry colname="COLSPEC2"><para>
       
   930 R/W</para></entry><entry colname="COLSPEC3"><para>Compression quality level.
       
   931 </para></entry></row>
       
   932 <row><entry colname="COLSPEC0"><para><literal>TIFFTAG_PIXARLOGDATAFMT</literal></para></entry>
       
   933 <entry colname="COLSPEC1"><para>PixarLog</para></entry><entry colname="COLSPEC2"><para>
       
   934 R/W</para></entry><entry colname="COLSPEC3"><para>User data format.</para></entry>
       
   935 </row>
       
   936 <row><entry colname="COLSPEC0"><para><literal>TIFFTAG_PIXARLOGQUALITY</literal></para></entry>
       
   937 <entry colname="COLSPEC1"><para>PixarLog</para></entry><entry colname="COLSPEC2"><para>
       
   938 R/W</para></entry><entry colname="COLSPEC3"><para>Compression quality level.
       
   939 </para></entry></row>
       
   940 <row><entry colname="COLSPEC0"><para><literal>TIFFTAG_SGILOGDATAFMT</literal></para></entry>
       
   941 <entry colname="COLSPEC1"><para>SGILog</para></entry><entry colname="COLSPEC2"><para>
       
   942 R/W</para></entry><entry colname="COLSPEC3"><para>User data format.</para></entry>
       
   943 </row>
       
   944 </tbody>
       
   945 </tgroup>
       
   946 </informaltable>
       
   947 <refsect3 id="libtiff-3-exde-pseudo-faxmode">
       
   948 <title>TIFFTAG_FAXMODE</title>
       
   949 <para>Controls the operation of the Group 3 codec. Possible values (independent
       
   950 bits that can be combined by or'ing them together) are: </para>
       
   951 <variablelist>
       
   952 <varlistentry><term><literal>FAXMODE_BYTEALIGN</literal></term><listitem>
       
   953 <para>Align each encoded row to an 8-bit boundary.</para>
       
   954 </listitem></varlistentry>
       
   955 <varlistentry><term><literal>FAXMODE_CLASSIC</literal></term><listitem><para>
       
   956 Enable old-style format in which the RTC is written at the end of the last
       
   957 strip.</para>
       
   958 </listitem></varlistentry>
       
   959 <varlistentry><term><literal>FAXMODE_NOEOL</literal></term><listitem><para>
       
   960 Do not write EOL codes at the start of each row of data.</para>
       
   961 </listitem></varlistentry>
       
   962 <varlistentry><term><literal>FAXMODE_NORTC</literal>, also called <literal>
       
   963 FAXMODE_CLASSF</literal></term><listitem><para>Opposite of <literal>FAXMODE_CLASSIC
       
   964 </literal>.</para>
       
   965 </listitem></varlistentry>
       
   966 <varlistentry><term><literal>FAXMODE_WORDALIGN</literal></term><listitem>
       
   967 <para>Align each encoded row to a 16-bit boundary.</para>
       
   968 </listitem></varlistentry>
       
   969 </variablelist><para>The default value depends on the compression scheme.
       
   970 This pseudo-tag is used by the various G3 and G4 codecs to share code.</para>
       
   971 </refsect3>
       
   972 <refsect3 id="libtiff-3-exde-pseudo-faxfillfunc">
       
   973 <title>TIFFTAG_FAXFILLFUNC</title>
       
   974 <para>Controls the function used to convert arrays of black and white runs
       
   975 to packed bit arrays. This hook can be used to image decoded scanlines in
       
   976 multi-bit depth rasters (for example, for display in colormap mode) or for
       
   977 other purposes. The default value is a pointer to a builtin function that
       
   978 images packed bilevel data.</para>
       
   979 </refsect3>
       
   980 <refsect3 status="" id="libtiff-3-exde-pseudo-iptcnewsphoto">
       
   981 <title>TIFFTAG_IPTCNEWSPHOTO</title>
       
   982 <para>Contains image metadata per the IPTC newsphoto specification: Headline,
       
   983 captioning, credit, and so on. Used by most wire services.</para>
       
   984 </refsect3>
       
   985 <refsect3 id="libtiff-3-exde-pseudo-photoshop">
       
   986 <title>TIFFTAG_PHOTOSHOP</title>
       
   987 <para>Contains Photoshop captioning information and metadata. Photoshop uses
       
   988 in parallel and redundantly alongside <literal>IPTCNEWSPHOTO</literal> information.
       
   989 </para>
       
   990 </refsect3>
       
   991 <refsect3 id="libtiff-3-exde-pseudo-jpegquality">
       
   992 <title>TIFFTAG_JPEGQUALITY</title>
       
   993 <para>Controls the compression quality level used in the baseline algorithm.
       
   994 Note that quality levels are in the range 0-100 with a default value of 75.
       
   995 </para>
       
   996 </refsect3>
       
   997 <refsect3 id="libtiff-3-exde-pseudo-jpegcolormode">
       
   998 <title>TIFFTAG_JPEGCOLORMODE</title>
       
   999 <para>Controls whether or not conversion is done between RGB and YCbCr colorspaces.
       
  1000 Possible values are: <literal>JPEGCOLORMODE_RAW</literal> (do not convert),
       
  1001 and <literal>JPEGCOLORMODE_RGB</literal> (convert to/from RGB). The default
       
  1002 value is <literal>JPEGCOLORMODE_RAW</literal>.</para>
       
  1003 </refsect3>
       
  1004 <refsect3 id="libtiff-3-exde-pseudo-jpegtablesmode">
       
  1005 <title>TIFFTAG_JPEGTABLESMODE</title>
       
  1006 <para>Controls the information written in the <literal>JPEGTables</literal>
       
  1007 tag. Possible values (independent bits that can be combined by or'ing them
       
  1008 together) are: <literal>JPEGTABLESMODE_QUANT</literal> (include quantization
       
  1009 tables), and <literal>JPEGTABLESMODE_HUFF</literal> (include Huffman encoding
       
  1010 tables).</para>
       
  1011 </refsect3>
       
  1012 <refsect3 id="libtiff-3-exde-pseudo-zipquality">
       
  1013 <title>TIFFTAG_ZIPQUALITY</title>
       
  1014 <para>Controls the compression technique used by the Deflate codec. Quality
       
  1015 levels are in the range 1-9 with larger numbers yielding better compression
       
  1016 at the cost of more computation. The default quality level is 6 which yields
       
  1017 a good time-space tradeoff.</para>
       
  1018 </refsect3>
       
  1019 <refsect3 id="libtiff-3-exde-pseudo-pixarlogdatafmt">
       
  1020 <title>TIFFTAG_PIXARLOGDATAFMT</title>
       
  1021 <para>Controls the format of user data passed to the PixarLog codec when encoding
       
  1022 and passed from the PixarLog codec when decoding. Possible values are:</para>
       
  1023 <itemizedlist>
       
  1024 <listitem><para><literal>PIXARLOGDATAFMT_8BIT</literal> for 8-bit unsigned
       
  1025 pixels</para></listitem>
       
  1026 <listitem><para><literal>PIXARLOGDATAFMT_8BITABGR</literal> for 8-bit unsigned
       
  1027 ABGR-orderedpixels</para></listitem>
       
  1028 <listitem><para><literal>PIXARLOGDATAFMT_11BITLOG</literal> for 11-bit log-encoded
       
  1029 raw data</para></listitem>
       
  1030 <listitem><para><literal>PIXARLOGDATAFMT_12BITPICIO</literal> for 12-bit PICIO-compatible
       
  1031 data</para></listitem>
       
  1032 <listitem><para><literal>PIXARLOGDATAFMT_16BIT</literal> for 16-bit signed
       
  1033 samples</para></listitem>
       
  1034 <listitem><para><literal>PIXARLOGDATAFMT_FLOAT</literal> for 32-bit IEEE floating
       
  1035 point samples</para></listitem>
       
  1036 </itemizedlist>
       
  1037 </refsect3>
       
  1038 <refsect3 id="libtiff-3-exde-pseudo-pixarlogquality">
       
  1039 <title>TIFFTAG_PIXARLOGQUALITY</title>
       
  1040 <para>Controls the compression technique used by the PixarLog codec. This
       
  1041 value is treated identically to <literal>TIFFTAG_ZIPQUALITY</literal>.</para>
       
  1042 </refsect3>
       
  1043 <refsect3 id="libtiff-3-exde-pseudo-sgilogdatafmt">
       
  1044 <title>TIFFTAG_SGILOGDATAFMT</title>
       
  1045 <para>Controls the format of client data passed to the SGILog codec when encoding
       
  1046 and passed from the SGILog codec when decoding. Possible values are:</para>
       
  1047 <itemizedlist>
       
  1048 <listitem><para><literal>SGILOGDATAFMT_FLTXYZ</literal> for converting between
       
  1049 LogLuv and 32-bit IEEE floating valued XYZ pixels</para></listitem>
       
  1050 <listitem><para><literal>SGILOGDATAFMT_16BITLUV</literal> for 16-bit encoded
       
  1051 Luv pixels</para></listitem>
       
  1052 <listitem><para><literal>SGILOGDATAFMT_32BITRAW</literal> and <literal>SGILOGDATAFMT_24BITRAW
       
  1053 </literal> for no conversion of data</para></listitem>
       
  1054 <listitem><para><literal>SGILOGDATAFMT_8BITRGB</literal> for returning 8-bit
       
  1055 RGB data (valid only when decoding LogLuv-encoded data)</para></listitem>
       
  1056 <listitem><para><literal>SGILOGDATAFMT_FLTY</literal> for converting between
       
  1057 LogL and 32-bit IEEE floating valued Y pixels</para></listitem>
       
  1058 <listitem><para><literal>SGILOGDATAFMT_16BITL</literal> for 16-bit encoded
       
  1059 L pixels</para></listitem>
       
  1060 <listitem><para><literal>SGILOGDATAFMT_8BITGRY</literal> for returning 8-bit
       
  1061 greyscale data (valid only when decoding LogL-encoded data)</para></listitem>
       
  1062 </itemizedlist>
       
  1063 </refsect3>
       
  1064 </refsect2>
       
  1065 <refsect2 id="libtiff-3-exde-diags">
       
  1066 <title>Diagnostics</title>
       
  1067 <para>All error messages are directed through the <literal>TIFFError</literal>
       
  1068 routine. By default, messages are directed to <literal>stderr</literal> in
       
  1069 the form: <literal><replaceable>module</replaceable>: <replaceable>message
       
  1070 </replaceable>\\n</literal>. Warning messages are likewise directed through
       
  1071 the TIFFWarning routine.</para>
       
  1072 </refsect2>
       
  1073 </refsect1>
       
  1074 <refsect1 id="libtiff-3-attr"><title>&attr-tt;</title>
       
  1075 <para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry>
       
  1076 <refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>
       
  1077 for descriptions of the following attributes:</para>
       
  1078 <informaltable frame="all">
       
  1079 <tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">
       
  1080 <colspec colname="COLSPEC1" colwidth="1*">
       
  1081 <thead>
       
  1082 <row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"
       
  1083 valign="middle">ATTRIBUTE VALUE</entry></row>
       
  1084 </thead>
       
  1085 <tbody>
       
  1086 <row><entry><para>Availability</para></entry><entry><para>SUNWTiff</para></entry>
       
  1087 </row>
       
  1088 <row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry
       
  1089 colname="COLSPEC1"><para>Evolving</para></entry></row>
       
  1090 </tbody>
       
  1091 </tgroup>
       
  1092 </informaltable>
       
  1093 </refsect1>
       
  1094 <refsect1 id="libtiff-3-also"><title>&also-tt;</title>
       
  1095 <!--Reference to another man page-->
       
  1096 <!--Reference to a Help manual-->
       
  1097 <!--Reference to a book.-->
       
  1098 <para><citerefentry><refentrytitle>fax2tiff</refentrytitle><manvolnum>1</manvolnum>
       
  1099 </citerefentry>, <citerefentry><refentrytitle>gif2tiff</refentrytitle><manvolnum>
       
  1100 1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pal2rgb</refentrytitle>
       
  1101 <manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>ppm2tiff
       
  1102 </refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>
       
  1103 ras2tiff</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry>
       
  1104 <refentrytitle>rgb2ycbcr</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry>
       
  1105 <refentrytitle>sgi2tiff</refentrytitle><manvolnum>1</manvolnum></citerefentry>; <citerefentry>
       
  1106 <refentrytitle>tiff2bw</refentrytitle><manvolnum>1</manvolnum></citerefentry>; <citerefentry>
       
  1107 <refentrytitle>tiffcmp</refentrytitle><manvolnum>1</manvolnum></citerefentry>; <citerefentry>
       
  1108 <refentrytitle>tiffcp</refentrytitle><manvolnum>1</manvolnum></citerefentry>; <citerefentry>
       
  1109 <refentrytitle>tiffdither</refentrytitle><manvolnum>1</manvolnum></citerefentry>; <citerefentry>
       
  1110 <refentrytitle>tiffdump</refentrytitle><manvolnum>1</manvolnum></citerefentry>; <citerefentry>
       
  1111 <refentrytitle>tiffgt</refentrytitle><manvolnum>1</manvolnum></citerefentry>; <citerefentry>
       
  1112 <refentrytitle>tiffinfo</refentrytitle><manvolnum>1</manvolnum></citerefentry>; <citerefentry>
       
  1113 <refentrytitle>tiffmedian</refentrytitle><manvolnum>1</manvolnum></citerefentry>; <citerefentry>
       
  1114 <refentrytitle>tiffsplit</refentrytitle><manvolnum>1</manvolnum></citerefentry>; <citerefentry>
       
  1115 <refentrytitle>tiffsv</refentrytitle><manvolnum>1</manvolnum></citerefentry></para>
       
  1116 <para><citetitle>Tag Image File Format Specification</citetitle> Revision
       
  1117 6.0, an Aldus Technical Memorandum.</para>
       
  1118 <para><citetitle>The Spirit of TIFF Class F</citetitle> an appendix to the
       
  1119 TIFF 5.0 specification prepared by Cygnet Technologies.</para>
       
  1120 </refsect1>
       
  1121 <refsect1 id="libtiff-3-note"><title>&note-tt;</title>
       
  1122 <para>The <filename>&cmd;</filename> library does not support multisample
       
  1123 images where some samples have different bits/sample.</para>
       
  1124 <para>The library does not support random access to compressed data that is
       
  1125 organized with more than one row per tile or strip. The library discards unknown
       
  1126 tags. The library should do more validity checking of a directory's contents.
       
  1127 </para>
       
  1128 <para>This man page was originally written by Sam Leffler. Updated by Breda
       
  1129 McColgan, Sun Microsystems Inc., 2004.</para>
       
  1130 </refsect1>
       
  1131 </refentry>
       
  1132 <?Pub *0000069266>