imageinfo (Image Processing Toolbox User's Guide)

Image Processing Toolbox User's Guide

Create Image Information tool

Syntax

imageinfo
imageinfo(h)
imageinfo(filename)
imageinfo(info)
imageinfo(himage,filename)
imageinfo(himage,info)
hfig = imageinfo(...)

Description

imageinfo creates an Image Information tool associated with the image in the current figure. The tool displays in a separate figure information about the basic attributes of the target image. imageinfo gets the image attributes by querying the image object's CData.

The following table lists the basic image information included in the Image Information tool display. Note that the tool contains either four or six fields, depending on the type of image.

Attribute Name
Value

Width (columns)
Number of columns in the image

Height (rows)
Number of rows in the image

Class
Data type used by the image, such as uint8.

Note: For single or int16 images, imageinfo returns a class value of double, because image objects convert CData of these classes to double.

Image type
One of the image types identified by the Image Processing Toolbox: 'intensity', 'truecolor', 'binary', or 'indexed'.

Minimum intensity
For intensity images, this value represents the lowest intensity value of any pixel.
For indexed images, this value represents the lowest index value into a color map.
Not included for 'binary' or 'truecolor' images.

Maximum intensity
For intensity images, this value represents the highest intensity value of any pixel.
For indexed images, this value represents the highest index value into a color map.
Not included for 'binary' or 'truecolor' images.

Attribute Name	Value
Width (columns)	Number of columns in the image
Height (rows)	Number of rows in the image
Class	Data type used by the image, such as `uint8`. Note: For `single` or `int16` images, `imageinfo` returns a class value `of double`, `b`ecause image objects convert CData of these classes to `double`.
Image type	One of the image types identified by the Image Processing Toolbox: '`intensity`', '`truecolor'`, '`binary'`, or '`indexed'`.
Minimum intensity	For intensity images, this value represents the lowest intensity value of any pixel. For indexed images, this value represents the lowest index value into a color map. Not included for `'binary'` or `'truecolor'` images.
Maximum intensity	For intensity images, this value represents the highest intensity value of any pixel. For indexed images, this value represents the highest index value into a color map. Not included for `'binary'` or `'truecolor'` images.

imageinfo(h) creates an Image Information tool associated with h, where h is a handle to a figure, axes, or image object.

imageinfo(filename) creates an Image Information tool containing image metadata from the graphics file filename. The image does not have to be displayed in a figure window. filename can be any file type that has been registered with an information function in the file formats registry, imformats, so its information can be read by imfinfo. filename can also be a DICOM file with information readable by dicominfo.

imageinfo(info) creates an Image Information tool containing the image metadata in the structure info. info is a structure returned by the functions imfinfo or dicominfo, or info can be a user-created structure.

imageinfo(himage,filename) creates an Image Information tool containing information about the basic attributes of the image specified by the handle himage and the image metadata from the graphics file filename.

imageinfo(himage,info) creates an Image Information tool containing information about the basic attributes of the image specified by the handle himage and the image metadata in the structure info.

hfig=imageinfo(...) returns a handle to the Image Information tool figure.

Example

imageinfo('peppers.png')

h = imshow('bag.png');
info = imfinfo('bag.png');
imageinfo(h,info);

imshow('trees.tif');
imageinfo;

See Also

dicominfo, imattributes, imfinfo, imformats, imtool

imadjust imagemodel