TIFFSetDirectory(3TMISC. REFERENCE MANUAL PAGTIFFSetDirectory(3T)

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

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

DESCRIPTION
     Set the specified directory to be the current directory  and
     read  the  directory's contents with TIFFReadDirectory.  The
     parameter  dirnum  specifies  the  subfile/directory  as  an
     integer number, with the first directory numbered zero.

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

DIAGNOSTICS
     All error messages are directed to  the  TIFFError(3T)  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 encountered
     while  reading  the  ``link  value'' that points to the next
     directory in a file.

SEE ALSO
     intro(3T),      TIFFCurrentDirectory(3T),      TIFFOpen(3T),
     TIFFReadDirectory(3T), TIFFWriteDirectory(3T)

Sun Release 4.1  Last change: December 16, 1991                 1