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/