plucky (3) TIFFSetDirectory.3tiff.gz

Provided by: libtiff-dev_4.5.1+git230720-4ubuntu4_amd64 bug

NAME

       TIFFSetDirectory - set the current directory for an open TIFF file

SYNOPSIS

          #include <tiffio.h>

       int TIFFSetDirectory(TIFF *tif, tdir_t dirnum)

       int TIFFSetSubDirectory(TIFF *tif, uint64_t 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.   TIFFSetDirectory() only works with main-IFD chains because allways starts with the first main-IFD
       and thus is able to reset the SubIFD reading chain to the main-IFD chain.

       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.  (see
       MultiPage SubIFD)

       Directory  query  functions  TIFFCurrentDirectory(),  TIFFCurrentDirOffset(),   TIFFLastDirectory()   and
       TIFFNumberOfDirectories()  retrieve  information  about  directories  in an open TIFF file. Be aware that
       until a directory is not written to file AND read back, the query functions won't  retrieve  the  correct
       information!

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 TIFFErrorExtR() 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

       TIFFquery  (3tiff),  TIFFOpen  (3tiff),   TIFFCreateDirectory   (3tiff),   TIFFCustomDirectory   (3tiff),
       TIFFWriteDirectory (3tiff), TIFFReadDirectory (3tiff), Multi Page / Multi Image TIFF, libtiff (3tiff)

AUTHOR

       LibTIFF contributors

       1988-2024, LibTIFF contributors