BUILT-IN MATHEMATICA SYMBOL

# ImageData

ImageData[image]
gives the array of pixel values in an Image or Image3D object image.

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

## Details and OptionsDetails and Options

• ImageData[image] by default gives a 2D or 3D array whose elements are lists of values for each channel. For a single-channel image, only a value and not a list of values is returned.
• In 2D, 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.
• In 3D, the array generated by ImageData[image] is arranged such that the first part corresponds to the top slice, with rows running from back to front, and columns running from left to right.
• 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 "Real32" single-precision real (32-bit) "Real" double-precision real (64-bit)
• ImageData[image, Automatic] is equivalent to ImageData[image, ImageType[image]].
• For images of type or , ImageData[image] always normalizes values to lie between 0 and 1. For images of type , ImageData[image] returns whatever real values are used in the image.
• ImageData has the option Interleaving.
• With the default setting , ImageData returns a 2D or 3D array of lists of channel values.
• With , ImageData returns a list of 2D or 3D arrays of values for each channel.
• returns in the native form used to store the image.
• ImageData accepts a DataReversed option. With , the order of the rows is reversed.

## ExamplesExamplesopen allclose all

### Basic Examples (2)Basic Examples (2)

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

 Out[1]=

Construct a byte-valued image:

 Out[1]=

Extract normalized raster data:

 Out[2]=

Extract raw bytes:

 Out[3]=