IMAGESC Image Display Function

Section: Handle-Based Graphics

Usage

The imagesc command has the following general syntax 
  handle = imagesc(x,y,C,clim)

where x is a two vector containing the x coordinates of the first and last pixels along a column, and y is a two vector containing the y coordinates of the first and last pixels along a row. The matrix C constitutes the image data. It must either be a scalar matrix, in which case the image is colormapped using the colormap for the current figure. If the matrix is M x N x 3, then C is intepreted as RGB data, and the image is not colormapped. The clim argument is a pairs [low high] that specifies scaling. You can also omit the x and y, 

  handle = imagesc(C, clim)

in which case they default to x = [1,size(C,2)] and y = [1,size(C,1)]. Finally, you can use the image function with only formal arguments 

  handle = imagesc(properties...)

Example

In this example, we create an image that is 512 x 512 pixels square, and set the background to a noise pattern. We set the central 128 x 256 pixels to be white. 
--> x = rand(512);
--> x((-64:63)+256,(-128:127)+256) = 1.0;
--> figure

ans = 
 1 

--> imagesc(x,[0 .5])
Warning: Newly defined variable nargin shadows a function of the same name.  Use clear nargin to recover access to the function
--> colormap(gray)