opensolaris man page for tiffsetsubdirectory

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)