The HDF_DF24_NIMAGES function returns the number of 24-bit images in an HDF file.

Examples

---

; Open HDF file:

h = HDF_OPEN('myhdf.hdf')

; Return the number of 24-bit images in the file:

number = HDF_DF24_NIMAGES('myhdf.hdf')

; Print information about the returned value. If there were five

; images in the file, IDL would print NUMBER LONG = 5

HELP, number

; Close the HDF file:

HDF_CLOSE, h

Syntax

---

Result = HDF_DF24_NIMAGES(Filename)

Return Value

---

Returns the number of images in the file or -1 if the specified file is invalid or damaged

Arguments

---

Filename

A string containing the name of the file to be searched.

Keywords

---

None

Version History

---

4.0	Introduced

See Also

---

HDF_DF24_GETIMAGE, HDF_DF24_GETINFO, HDF_DF24_READREF, HDF_DF24_RESTART, HDF_DFR8_NIMAGES