nextDirectory

Make next IFD the current IFD

Syntax

nextDirectory(t)

Description

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

Navigate to Next Image in TIFF File

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

t — Tiff object

Tiff object

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

Algorithms

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.

Version History

Introduced in R2009b