Navigation

Operators and Keywords

Function List:

C++ API

: info = imfinfo (filename)
: info = imfinfo (url)
: info = imfinfo (…, ext)

Read image information from a file.

imfinfo returns a structure containing information about the image stored in the file filename. If there is no file filename, and ext was specified, it will look for a file named filename and extension ext, i.e., a file named filename.ext.

The output structure info contains the following fields:

Filename

The full name of the image file.

FileModDate

Date of last modification to the file.

FileSize

Number of bytes of the image on disk

Format

Image format (e.g., "jpeg").

Height

Image height in pixels.

Width

Image Width in pixels.

BitDepth

Number of bits per channel per pixel.

ColorType

Image type. Value is "grayscale", "indexed", "truecolor", "CMYK", or "undefined".

XResolution

X resolution of the image.

YResolution

Y resolution of the image.

ResolutionUnit

Units of image resolution. Value is "Inch", "Centimeter", or "undefined".

DelayTime

Time in 1/100ths of a second (0 to 65535) which must expire before displaying the next image in an animated sequence.

LoopCount

Number of iterations to loop an animation.

ByteOrder

Endian option for formats that support it. Value is "little-endian", "big-endian", or "undefined".

Gamma

Gamma level of the image. The same color image displayed on two different workstations may look different due to differences in the display monitor.

Quality

JPEG/MIFF/PNG compression level. Value is an integer in the range [0 100].

DisposalMethod

Only valid for GIF images, control how successive frames are rendered (how the preceding frame is disposed of) when creating a GIF animation. Values can be "doNotSpecify", "leaveInPlace", "restoreBG", or "restorePrevious". For non-GIF files, value is an empty string.

Chromaticities

Value is a 1x8 Matrix with the x,y chromaticity values for white, red, green, and blue points, in that order.

Comment

Image comment.

Compression

Compression type. Value can be "none", "bzip", "fax3", "fax4", "jpeg", "lzw", "rle", "deflate", "lzma", "jpeg2000", "jbig2", "jbig2", or "undefined".

Colormap

Colormap for each image.

Orientation

The orientation of the image with respect to the rows and columns. Value is an integer between 1 and 8 as defined in the TIFF 6 specifications, and for MATLAB compatibility.

Software

Name and version of the software or firmware of the camera or image input device used to generate the image.

Make

The manufacturer of the recording equipment. This is the manufacture of the DSC, scanner, video digitizer or other equipment that generated the image.

Model

The model name or model number of the recording equipment as mentioned on the field "Make".

DateTime

The date and time of image creation as defined by the Exif standard, i.e., it is the date and time the file was changed.

ImageDescription

The title of the image as defined by the Exif standard.

Artist

Name of the camera owner, photographer or image creator.

Copyright

Copyright notice of the person or organization claiming rights to the image.

DigitalCamera

A struct with information retrieved from the Exif tag.

GPSInfo

A struct with geotagging information retrieved from the Exif tag.

See also: imread, imwrite, imshow, imformats.

Package: octave