Reading Images: h5readImageΒΆ

h5readImage reads an HDF5 image and renders it as Graphics Interchange Format (GIF) image on an Excel worksheet.

../_images/h5readImage.png

An Excel h5readImage screenshot.

Excel UDF Syntax

h5readImage(filename, imagename)

h5readImage(filename, imagename [, palettename])

Mandatory Arguments

Argument Description
filename A text string specifying the name of an HDF5 file
imagename A text string (path) specifying the location of an HDF5 image

Optional Arguments

Argument Description
palettename A text string (path) specifying the location of an HDF5 palette

Return Value

On success, h5readImage renders a GIF image on an Excel worksheet.

On error, an error message (string) is returned.

Examples

Read the hdflogo image.

h5readImage("HDF5.h5", "/hdflogo")

Error Conditions

The following conditions will create an error:

  1. An invalid file name
    • An empty string or a string that contains characters not supported by the operating system
    • It refers to a file system location for which the user has insufficient access privileges
  2. An invalid image name
    • An empty string
    • No HDF5 object exists at the specified location
    • The HDF5 object at the specified location is not an HDF5 image
  3. An invalid palette name
    • An empty string
    • No HDF5 object exists at the specified location
    • The HDF5 object at the specified location is not an HDF5 palette

See Also

h5readArray, h5readAttribute, h5readTable