hpux man page for tiffsetsubdirectory

TIFFSetDirectory(3tiff) 				 Introduction to Library Functions				   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)

DESCRIPTION

       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.

EXTENDED DESCRIPTION

   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.

RETURN VALUES

       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.

ATTRIBUTES

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

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

SEE ALSO

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

NOTES

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

SunOS 5.10							    05 Apr 2004 					   TIFFSetDirectory(3tiff)