TIFFSetDirectory(y)                         TIFFSetDirectory(y)



NAME
       TIFFSetDirectory,  TIFFSetSubDirectory  -  set the current
       directory for an open TIFF file

SYNOPSIS
       #include <tiffio.h>
       int TIFFSetDirectory(TIFF* tif, tdir_t dirnum)
       int TIFFSetSubDirectory(TIFF* tif, uint32 diroff)

DESCRIPTION
       TIFFSetDirectory changes the current directory  and  reads
       its contents with TIFFReadDirectory.  The parameter dirnum
       specifies the subfile/directory as an integer number, with
       the first directory numbered zero.

       TIFFSetSubDirectory acts like TIFFSetDirectory, except the
       directory is specified as a  file  offset  instead  of  an
       index;  this  is  required  for  accessing  subdirectories
       linked through a SubIFD tag.

RETURN VALUES
       On successful return  1  is  returned.   Otherwise,  0  is
       returned  if  dirnum  or  diroff  specifies a non-existent
       directory, or if an error was  encountered  while  reading
       the directory's contents.

DIAGNOSTICS
       All  error messages are directed to the TIFFError(r) rou-
       tine.

       %s: Error fetching directory count.  An error was  encoun-
       tered while reading the ``directory count'' field.

       %s:  Error  fetching directory link.  An error was encoun-
       tered while reading the ``link value'' that points to  the
       next directory in a file.

SEE ALSO
       libtiff(f), TIFFCurrentDirectory(y), TIFFOpen(n), TIFF-
       ReadDirectory(y), TIFFWriteDirectory(y)



                         October 15, 1995    TIFFSetDirectory(y)