diff -r 000000000000 -r 1918ee327afb src/3rdparty/libtiff/html/man/TIFFSetDirectory.3tiff.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/3rdparty/libtiff/html/man/TIFFSetDirectory.3tiff.html Mon Jan 11 14:00:40 2010 +0000 @@ -0,0 +1,122 @@ + + + + + + +TIFFSetDirectory + + + +

TIFFSetDirectory

+NAME
+SYNOPSIS
+DESCRIPTION
+RETURN VALUES
+DIAGNOSTICS
+SEE ALSO
+ +
+ +

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(3TIFF) 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

+ + + + + +
+

TIFFCurrentDirectory(3TIFF), +TIFFOpen(3TIFF), TIFFReadDirectory(3TIFF), +TIFFWriteDirectory(3TIFF), libtiff(3TIFF)

+ +

Libtiff library home page: +http://www.remotesensing.org/libtiff/

+
+
+ +