imagesc

Display image from array with scaled colors.

Syntax

• imagesc()

• imagesc(C)

• image(X, Y, C)

• imagesc('CData', C)

• imagesc('XData', X, 'YData', Y,'CData', C)

• imagesc(..., propertyName, propertyValue)

• imagesc(parent, ...)

• go = imagesc(...)

Input argument

• X - x-coordinates: vector or matrix.

• Y - y-coordinates: vector or matrix.

• C - Color array: m-by-n-by-3 array of RGB triplets.

• parent - a scalar graphics object value: parent container, specified as a axes.

• propertyName - a scalar string or row vector character.

• propertyValue - a value.

Output argument

• go - a graphics object: image type.

Description

imagessc displays C data as an image. This image is colormapped using the colormap for the current figure.

Properties:

AlphaData Transparency data: scalar, array the same size as CData, or 1 (default).

AlphaDataMapping

CData Image color data: vector or matrix, 3-D array of RGB triplets.

CDataMapping Color data mapping method: 'direct' or 'scaled' (default).

Children [].

Parent Parent: axes object.

Tag Object identifier: string scalar, character vector, '' (default).

Type Type of graphics object: 'surface'.

UserData: User data: array or [] (default).

Visible State of visibility: 'off' or 'on' (default).

XData Placement along x-axis: two-element vector, scalar, [1 size(CData, 1)] (default).

YData Placement along y-axis: two-element vector, scalar, [1 size(CData, 2)] (default).

CreateFcnCallback (function handle, string or cell) called when object is created. Set this property on an existing component has no effect.

DeleteFcnCallback (function handle, string or cell) called when object is deleted.

BeingDeleted Flag indicating that the object is being deleted.

Examples

f1 = figure();
C = [0 2 4 6; 8 10 12 14; 16 18 20 22];
imagesc(C)

f2 = figure();
C = [0 2 4 6; 8 10 12 14; 16 18 20 22];
imagesc(C)
colormap(gray)

See also

image, colormap.

History

Version	Description
1.0.0	initial version
1.7.0	CreateFcn, DeleteFcn callback added.
--	BeingDeleted property added.

Author

Allan CORNET