TIFFReadDirectory(3T)     UNIX System V(May 2, 1990)      TIFFReadDirectory(3T)


NAME
      TIFFReadDirectory - get the contents of the next directory in an open
      TIFF file

SYNOPSIS
      #include <tiffio.h>
      int TIFFReadDirectory(TIFF* tif)

DESCRIPTION
      Read the next directory in the specified file and make it the current
      directory.  If the current directory has been modified and the file is
      opened for writing, the current directory is first written out.
      TIFFReadDirectory() returns 1 if the next directory was successfully
      read.  Otherwise 0 is returned if an error was encountered, or if there
      are no more directories to be read.  Applications only need to call
      TIFFReadDirectory() to read multiple subfiles in a single TIFF file.
      Normally the first directory in a file is automatically when TIFFOpen()
      is called.

DIAGNOSTICS
      All error messages are directed to the TIFFError(3T) routine.  All
      warning messages are directed to the TIFFWarning(3T) routine.

      Seek error accessing TIFF directory.  An error occurred while positioning
      to the location of the directory.

      Wrong data type %d for field "%s".  The tag entry in the directory had an
      incorrect data type.  For example, an ImageDescription tag with a SHORT
      data type.

      TIFF directory is missing required "%s" field.  The specified tag is
      required to be present by the TIFF 5.0 specification, but is missing.
      The directory is (usually) unusable.

      %s: Rational with zero denominator.  A directory tag has a RATIONAL value
      whose denominator is zero.

      Incorrect count %d for field "%s".  The specified tag's count field is
      bad.  For example, a count other than 1 for a SubFileType tag.

      Cannot handle different per-sample values for field "%s".  The image has
      different BitsPerSample values for each of its samples.

      Count mismatch for field "%s"; expecting %d, got %d.  The count field in
      a StripByteCounts or StripOffsets tag does not agree with the expected
      number of strips calculated by the library (from other tags).  This
      should never happen, so if it does, the library refuses to read the
      directory.

      Invalid TIFF directory; tags are not sorted in ascending order.  The
      directory tags are not properly sorted as specified in the TIFF 5.0
      specification.  This error is not fatal.


10/89                                                                    Page 1

TIFFReadDirectory(3T)     UNIX System V(May 2, 1990)      TIFFReadDirectory(3T)


      ignoring unknown field with tag %d (0x%x) An unknown tag was encountered
      in the directory; the library ignores all such tags.

      TIFF directory is missing required "StripByteCounts" field, calculating
      from imagelength.  The image violates the specification by not having a
      necessary field.  The library will calculate the value from the file size
      if the image has a single strip.

SEE ALSO
      intro(3T), TIFFOpen(3T), TIFFWriteDirectory(3T), TIFFSetDirectory(3T)












































Page 2                                                                    10/89