tiffsetdirectory(3t) [redhat man page]

TIFFSetDirectory(3T)													      TIFFSetDirectory(3T)

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 sub-
       file/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(3T) routine.

       %s: Error fetching directory count.  An error was encountered 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

       libtiff(3T), TIFFCurrentDirectory(3T), TIFFOpen(3T), TIFFReadDirectory(3T), TIFFWriteDirectory(3T)

								 October 15, 1995					      TIFFSetDirectory(3T)

TIFFSetDirectory(3tiff) 												   TIFFSetDirectory(3tiff)

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)

       TIFFSetDirectory  changes the current directory and reads the directory 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 that the directory is specified as a file  offset  instead  of  an  index.  This	is
       required for accessing subdirectories linked through a SubIFD tag.

   Diagnostics
       All error messages are directed to the TIFFError(3tiff) routine.

       %s: Error fetching direcAnrerrornwas encountered while reading the "directory count" field.

       %s: Error fetching direcAnrerrorkwas encountered while reading the "link value" that points to the next directory in a file.

       On  successful  completion,  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 contents.

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWTiff			   |
       +-----------------------------+-----------------------------+
       |Interface stability	     |Uncommitted		   |
       +-----------------------------+-----------------------------+

       libtiff(3), TIFFCurrentDirectory(3tiff), TIFFOpen(3tiff), TIFFReadDirectory(3tiff), TIFFWriteDirectory(3tiff)

       This man page was originally written by Sam Leffler. Updated by Breda McColgan, Sun Microsystems Inc., 2004.

								    05 Apr 2004 					   TIFFSetDirectory(3tiff)