Main Content

nextDirectory

Make next IFD the current IFD

Description

example

nextDirectory(t) makes the next image file directory (IFD) of the TIFF file the current IFD.

The Tiff object functions operate on the current IFD. Use this function to navigate among IFDs in a TIFF file containing multiple images.

Examples

collapse all

Get information on the Photometric tag of the image in the current IFD, navigate to the next image in the file, and examine the same tag for the next image.

Create a Tiff object for the file example.tif.

t = Tiff('example.tif','r');

Display the current directory number and get the value of the Photometric tag from the current IFD. A value of 2 for the Photometric tag corresponds to the colorspace RGB in the TIFF specifications.

dirNum = currentDirectory(t) 
dirNum = 1
value = getTag(t,'Photometric')
value = 2

Navigate to the next IFD

nextDirectory(t);

Display the current directory number and get the value of the Photometric tag from this IFD. A value of 1 for the Photometric tag corresponds to the colorspace MinIsBlack in the TIFF specifications.

dirNum = currentDirectory(t)
dirNum = 2
value = getTag(t,'Photometric')
value = 1

Close the Tiff object.

close(t);

Input Arguments

collapse all

Tiff object representing a TIFF file. Use the Tiff function to create the object.

Algorithms

collapse all

References

This function corresponds to the TIFFReadDirectory function in the LibTIFF C API. To use this function, you must be familiar with the TIFF specification and technical notes. View this documentation at LibTIFF - TIFF Library and Utilities.

Introduced in R2009b