TIFFCreateDirectory

Synopsis

#include <tiffio.h>
int TIFFCreateDirectory(TIFF *tif)
int TIFFFreeDirectory(TIFF *tif)
int TIFFUnlinkDirectory(TIFF *tif, uint16_t dirn)

Description

The following routines create or release a directory.

TIFFCreateDirectory() setup for a directory in a open TIFF file. The newly created directory will not exist on the file till TIFFWriteDirectory(), TIFFCheckpointDirectory(), TIFFFlush() or TIFFClose() is called. TIFFWriteDirectory() also creates a new directory, frees the *tif structure and sets up a new one.

TIFFFreeDirectory() releases allocated storage associated with a directory, especially custom-fields. However, the main part of the directory is not touched. Routine TIFFCleanup() calls TIFFFreeDirectory() to release the directory part of the tif structure.

TIFFUnlinkDirectory() unlink the specified directory from the directory chain.

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!

Notes

Be aware:

Diagnostics

All error messages are directed to the TIFFError() routine. Likewise, warning messages are directed to the TIFFWarning() routine.

See also

libtiff (3tiff), TIFFCustomDirectory (3tiff), TIFFquery (3tiff), TIFFSetDirectory (3tiff), TIFFWriteDirectory (3tiff)