Main Content

本页翻译不是最新的。点击此处可查看最新英文版本。

imagesc

使用缩放颜色显示图像

说明

示例

imagesc(C) 将数组 C 中的数据显示为一个图像,该图像使用颜色图中的全部颜色。C 的每个元素指定图像的一个像素的颜色。生成的图像是一个 m×n 像素网格,其中 mn 分别是 C 中的行数和列数。这些元素的行索引和列索引确定了对应像素的中心。

示例

imagesc(x,y,C) 指定图像位置。使用 xy 可指定与 C(1,1)C(m,n) 对应的边角的位置。要同时指定两个边角,请将 xy 设置为二元素向量。要指定第一个边角并让 imagesc 确定另一个,请将 xy 设为标量值。图像将根据需要进行拉伸和定向。

imagesc('CData',C) 将图像添加到当前坐标区中而不替换现有绘图。此语法是 imagesc(C) 的低级版本。有关详细信息,请参阅高级与低级版本

imagesc('XData',x,'YData',y,'CData',C) 指定图像位置。此语法是 imagesc(x,y,C) 的低级版本。

imagesc(___,Name,Value) 使用一个或多个名称-值对组参量指定图像属性。您可以在上述语法中的任何输入参量组合后指定名称-值对组参量。如需图像属性和说明的列表,请参阅 Image 属性

示例

imagesc(___,clims) 指定映射到颜色图的第一个和最后一个元素的数据值。将 clims 指定为 [cmin cmax] 形式的二元素向量,其中小于或等于 cmin 的值映射到颜色图中的第一种颜色,大于或等于 cmax 的值映射到颜色图中的最后一种颜色。在名称-值对组参量后指定 clims

imagesc(ax,___) 将在由 ax 指定的坐标区中而不是当前坐标区 (gca) 中创建图像。指定坐标区作为第一个输入参量。

示例

im = imagesc(___) 返回创建的 Image 对象。使用 im 在创建图像后设置图像的属性。您可以使用上述语法中的任意输入参量组合指定此输出。

示例

全部折叠

创建矩阵 C。显示 C 中数据的图像。向图添加颜色栏以显示当前颜色图。默认情况下,imagesc 色阶颜色范围以便图像使用颜色图中的所有颜色,其中 C 中的最小值映射到颜色图中的第一种颜色,最大值映射到最后一种颜色。

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

Figure contains an axes object. The axes object contains an object of type image.

放置图像,使其位于 x 轴上的 5 和 8 之间及 y 轴上的 3 和 6 之间。

x = [5 8];
y = [3 6];
C = [0 2 4 6; 8 10 12 14; 16 18 20 22];
imagesc(x,y,C)

Figure contains an axes object. The axes object contains an object of type image.

请注意,对应于 C(1,1) 的像素在点 (5,3) 上居中显示。对应于 C(3,4) 的像素在点 (8,6) 上居中显示。imagesc 在这两个点之间确定图像其余部分的位置和方向。

C 创建为数据值的数组。创建 C 的图像并设置颜色范围,使 4 或更小的值映射到颜色图中的第一种颜色,18 或更大的值映射到颜色图中的最后一种颜色。显示颜色栏以说明数据值如何映射到颜色图。

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

Figure contains an axes object. The axes object contains an object of type image.

创建一个图像并返回图像对象 im。然后,通过设置图像对象的 AlphaData 属性使图像半透明。

C = [1 2 3; 4 5 6; 7 8 9];
im = imagesc(C);

Figure contains an axes object. The axes object contains an object of type image.

im.AlphaData = .5;

Figure contains an axes object. The axes object contains an object of type image.

创建一个曲面图。然后,在曲面下添加一个图像。imagesc 在 xy 平面中显示该图像。

Z = 10 + peaks;
surf(Z)
hold on
imagesc(Z)

Figure contains an axes object. The axes object contains 2 objects of type surface, image.

输入参数

全部折叠

图像颜色数据,指定为向量或矩阵。C 的每个元素定义图像一个像素的颜色。C 的元素映射到相关联的坐标区的颜色图中的颜色。C 中的最小值映射到颜色图中的第一种颜色,最大值映射到最后一种颜色。NaN 元素的行为未定义。

注意

如果您将 C 指定为 m×n×3 数组,则 imagesc 函数将图像解释为真彩色 (RGB) 图像。imagesc 不重新缩放真彩色图像的像素值。在调用 imagesc 之前,请使用 rescale 函数缩放真彩色像素值。

要改用 imagesc 函数的低级版本,请将 CData 属性设为名称-值对组。例如,imagesc('CData',C)

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical

沿着 x 轴放置,以下列形式之一指定:

  • 二元素向量 - 将第一个元素用作 C(1,1) 的中心位置,将第二个元素用作 C(m,n) 的中心位置,其中 [m,n] = size(C)。如果 C 为三维数组,则 mn 为前两个维度。C 的其余元素的中心均匀分布在这两点之间。

    每个像素的宽度由以下表达式确定:

    (x(2)-x(1))/(size(C,2)-1)

    如果 x(1) > x(2),则图像左右翻转。

  • 标量 - 会以此位置作为 C(1,1) 的中心,并使后面的每个元素相隔一个单位。

注意

  • 如果 x 有两个以上的元素,imagesc 将使用第一个和最后一个元素,而忽略其他元素。

  • 要改用低级版本的 imagesc 函数,请使用名称-值参量设置 XData 属性。例如,imagesc('XData',x,'YData',y,'CData',C)

  • 您无法在以交互方式将图像平移或缩放到图像的 x 轴或 y 坐标轴范围以外,除非设置的坐标轴范围界限已超出图像边界。如果这些轴范围超出边界,则无此类限制。如果其他对象(例如,线条)占用坐标区,并延伸到图像边界以外,您可以平移或缩放到其他对象的边界,但不能越过边界。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | datetime (自 R2023b 起) | duration (自 R2023b 起) | categorical (自 R2023b 起)

沿着 y 轴放置,以下列形式之一指定:

  • 二元素向量 - 将第一个元素用作 C(1,1) 的中心位置,将第二个元素用作 C(m,n) 的中心位置,其中 [m,n] = size(C)。如果 C 为三维数组,则 mn 为前两个维度。C 的其余元素的中心均匀分布在这两点之间。

    每个像素的高度由以下表达式确定:

    (y(2)-y(1))/(size(C,1)-1)

    如果 y(1) > y(2),则图像上下翻转。

  • 标量 - 会以此位置作为 C(1,1) 的中心,并使后面的每个元素相隔一个单位。

注意

  • 如果 y 有两个以上的元素,imagesc 将使用第一个和最后一个元素,而忽略其他元素。

  • 要改用低级版本的 imagesc 函数,请使用名称-值参量设置 YData 属性。例如,imagesc('XData',x,'YData',y,'CData',C)

  • 您无法在以交互方式将图像平移或缩放到图像的 x 轴或 y 轴范围以外,除非设置的坐标轴范围界限已超出图像边界。如果这些轴范围超出边界,则无此类限制。如果其他对象(例如,线条)占用坐标区,并延伸到图像边界以外,您可以平移或缩放到其他对象的边界,但不能越过边界。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | datetime (自 R2023b 起) | duration (自 R2023b 起) | categorical (自 R2023b 起)

颜色范围,指定为 [cmin cmax] 形式的二元素向量,其中 cmax 大于 cminC 中小于或等于 cmin 的值映射到颜色图中的第一种颜色。大于或等于 cmax 的值将映射到颜色图中的最后一种颜色。介于 cmincmax 之间的值以线性方式映射到颜色图。

如果您指定颜色范围,则 imagesc 函数将坐标区的 CLim 属性设置为指定的值。如果您不指定颜色范围,则 imagesc 将坐标区的 CLim 属性设置为 C 中的最小值和最大值。

Axes 对象。如果您不指定 Axes 对象,则 imagesc 使用当前坐标区。

名称-值参数

将可选的参量对组指定为 Name1=Value1,...,NameN=ValueN,其中 Name 是参量名称,Value 是对应的值。名称-值参量必须出现在其他参量之后,但参量对组的顺序无关紧要。

在 R2021a 之前,使用逗号分隔每个名称和值,并用引号将 Name 引起来。

示例: imagesc([1 2 3],'AlphaData',0.5) 会显示半透明图像。

此处所列的属性只是一部分图像属性。有关完整列表,请参阅 Image 属性

透明度数据,指定为以下格式之一:

  • 标量 - 在整个图像中使用一致的透明度。

  • 大小与 CData 相同的数组 - 对每个图像元素使用不同的透明度值。

AlphaDataMapping 属性控制 MATLAB® 如何解释 alpha 数据透明度值。

示例: 0.5

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical

AlphaData 值的解释,指定为下列值之一:

  • 'none' - 将值解释为透明度值。值 1 或更大的值表示完全不透明,值 0 或更小的值表示完全透明,介于 0 和 1 之间的值表示半透明。

  • 'scaled' - 将值映射到图窗的 alphamap 中。坐标区的最小和最大 alpha 范围确定分别映射到 alphamap 中第一个和最后一个元素的 alpha 数据值。例如,如果 alpha 范围是 [3 5],则小于或等于 3 的 alpha 数据值映射到 alphamap 中的第一个元素。大于或等于 5 的 alpha 数据值映射到颜色图中的最后一个元素。坐标区的 ALim 属性包含 alpha 范围。图窗的 Alphamap 属性包含 alphamap。

  • 'direct' - 将值解释为图窗的 alphamap 的索引。带小数部分的值向下舍取为最接近的整数:

    • 如果值为 doublesingle 类型,则小于或等于 1 的值将映射到 alphamap 中的第一个元素。等于或大于 alphamap 的长度的值映射到 alphamap 中的最后一个元素。

    • 如果值的类型为整数,则 0 或更小的值映射到 alphamap 中的第一个元素。等于或大于 alphamap 的长度的值映射到 alphamap 中的最后一个元素(或者最大可为该类型的范围限值)。整数类型有 uint8uint16uint32uint64int8int16int32int64

    • 如果值为 logical 类型,则值 0 将映射到 alphamap 中的第一个元素,值 1 将映射到 alphamap 中的第二个元素。

输出参量

全部折叠

Image 对象。使用 im 在创建图像后设置图像的属性。有关列表,请参阅 Image 属性

详细信息

全部折叠

高级与低级版本

imagesc 函数有两个版本:高级版本和低级版本。如果您使用的 imagesc'CData' 作为输入参量,则您使用的是低级版本。否则,您使用的是高级版本。

imagesc 的高级版本在绘图前调用 newplot 并设置以下坐标区属性:

  • Layer'top'。该图像显示在任何刻度线或网格线前面。

  • YDir'reverse'。沿 y 轴的值从上到下递增。要使值从上到下递减,请将 YDir 设置为 'normal'。此设置会反转 y 轴和图像。

  • View[0 90]

imagesc 函数的低级版本不调用 newplot 且不设置这些坐标区属性。

对这两个版本,imagesc 函数进行如下设置:

  • Image 对象的 CData 属性设置为 C 中的值。

  • Image 对象的 CDataMapping 属性设置为 'scaled'

  • Axes 对象的 CLim 属性设置为 C 中的最小值和最大值,除非您指定 clims 输入参量。

提示

  • 要将图像数据从不同标准格式(如 TIFF)的图形文件读取到 MATLAB 中,请使用 imread。要将 MATLAB 图像数据写入图形文件,请使用 imwriteimreadimwrite 函数支持各种图形文件格式和压缩方案。

  • 要查看或设置坐标区的颜色范围,您可以使用 clim 函数。

    在 R2022a 之前: 使用 caxis,它具有与 clim 相同的语法和参量。

扩展功能

版本历史记录

在 R2006a 之前推出

全部展开

另请参阅

函数

属性