MATLAB Function Reference    

Scale data and display an image object



The imagesc function scales image data to the full range of the current colormap and displays the image. (See Examples for an illustration.)

imagesc(C) displays C as an image. Each element of C corresponds to a rectangular area in the image. The values of the elements of C are indices into the current colormap that determine the color of each patch.

imagesc(x,y,C) displays C as an image and specifies the bounds of the x- and y-axis with vectors x and y.

imagesc(...,clims) normalizes the values in C to the range specified by clims and displays C as an image. clims is a two-element vector that limits the range of data values in C. These values map to the full range of values in the current colormap.

h = imagesc(...) returns the handle for an image graphics object.


x and y do not affect the elements in C; they only affect the annotation of the axes. If length(x) > 2 or length(y) > 2, imagesc ignores all except the first and last elements of the respective vector.

imagesc creates an image with CDataMapping set to scaled, and sets the axes CLim property to the value passed in clims.


If the size of the current colormap is 81-by-3, the statements

map the data values in C to the colormap as shown in this illustration.

In this example, the left image maps to the gray colormap using the statements

The right image has values between 10 and 60 scaled to the full range of the gray colormap using the statements

See Also


Bit-Mapped Images for related functions

  Image Properties imfinfo