Note: This page has been translated by MathWorks. Click here to see

To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

Display image with scaled colors

`imagesc(C)`

`imagesc(x,y,C)`

`imagesc('CData',C)`

`imagesc('XData',x,'YData',y,'CData',C)`

`imagesc(___,Name,Value)`

`imagesc(___,clims)`

`imagesc(ax,___)`

`im = imagesc(___)`

`imagesc(`

displays the data in array
`C`

)`C`

as an image that uses the full range of colors in the
colormap. Each element of `C`

specifies the color for one
pixel of the image. The resulting image is an
`m`

-by-`n`

grid of pixels where
`m`

is the number of rows and `n`

is the
number of columns in `C`

. The row and column indices of the
elements determine the centers of the corresponding pixels.

`imagesc(`

specifies
the image location. Use `x`

,`y`

,`C`

)`x`

and `y`

to
specify the locations of the corners corresponding to `C(1,1)`

and `C(m,n)`

.
To specify both corners, set `x`

and `y`

as
two-element vectors. To specify the first corner and let `imagesc`

determine
the other, set `x`

and `y`

as scalar
values. The image is stretched and oriented as applicable.

`imagesc('CData',`

adds the image to
the current axes without replacing existing plots. This syntax is the low-level
version of `C`

)`imagesc(C)`

. For more information, see High-Level Versus Low-Level Version.

`imagesc(___,`

specifies image properties using one or more name-value pair arguments. You can
specify name-value pair arguments after any of the input argument combinations
in the previous syntaxes. For a list of image properties and descriptions, see
Image Properties.`Name,Value`

)

`imagesc(___,`

specifies the data values that map to the first and last elements of the
colormap. Specify `clims`

)`clims`

as a two-element vector of the form
`[cmin cmax]`

, where values less than or equal to
`cmin`

map to the first color in the colormap and values
greater than or equal to `cmax`

map to the last color in the
colormap. Specify `clims`

after name-value pair
arguments.

`imagesc(`

creates the image in the
axes specified by `ax`

,___)`ax`

instead of in the current axes
(`gca`

). Specify the axes as the first input
argument.

To read image data into MATLAB from graphics files in various standard formats, such as TIFF, use

`imread`

. To write MATLAB image data to graphics files, use`imwrite`

. The`imread`

and`imwrite`

functions support various graphics file formats and compression schemes.To view or set the color limits of the axes, you can use the

`caxis`

function.