DOCUMENTATION CENTER SEARCH

Mathematica > Data Manipulation > Image Processing & Analysis > Image Representation >

ImageData

ImageData[image]
gives the array of pixel values in image.

ImageData[image, "type"]
gives the array of pixel values converted to the specified type.

MORE INFORMATION

ImageData[image] by default gives a 2D array whose elements are lists of values for each channel.

The array generated by ImageData[image] is arranged in the same way that the image is displayed, with the first row corresponding to the top row of pixels in the image.

For binary images, ImageData[image] returns integer values 0 or 1. For all other images, ImageData[image] returns real values, normally between 0 and 1.

Possible types specified by ImageData[image, "type"] are:

	"Bit"	integer 0 or 1
	"Byte"	integer 0 through 255
	"Bit16"	integer 0 through 65535
	"Real"	machine real

For images of type "Byte" or "Bit16", ImageData[image] always normalizes values to lie between 0 and 1. For images of type "Real", ImageData[image] returns whatever real values are used in the image.

ImageData has the option Interleaving.

With the default setting Interleaving->True, ImageData returns a 2D array of lists of channel values.

With Interleaving->False, ImageData returns a list of 2D arrays of values for each channel.

Interleaving->Automatic returns in the native form used to store the image.

Basic Examples (2)

Channel data for the first five pixels of the first row:

Click for copyable input

Construct a byte-valued image:

Extract normalized raster data:

Extract raw bytes:

Image ImageDimensions ImageChannels ImageType ImageQ Transpose

Image Processing

Demonstrations with ImageData (Wolfram Demonstrations Project)

New in 7

Ask a question about this page | Suggest an improvement | Leave a message for the team