---

32.2 显示图像 ¶

图像处理的一个自然环节是图像的可视化。最基本的功能函数是 imshow，它用于显示第一个输入参数中给定的图像。

 

imshow (im) ¶

imshow (im, limits) ¶

imshow (im, map) ¶

imshow (rgb, …) ¶

imshow (filename) ¶

imshow (…, string_param1, value1, …) ¶

h = imshow (…) ¶

显示图像 im，其中 im 可以是一个二维矩阵（灰度图像）或三维矩阵（RGB 图像）。

如果 limits 是一个二元素向量 [low, high]，则图像将使用 low 到 high 之间的显示范围进行显示。如果为 limits 传入一个空矩阵，则显示范围将被计算为图像中最小值和最大值之间的范围。

如果 map 是一个有效的颜色图，则图像将以索引图像的形式显示，并使用所提供的颜色图。

如果给定的是文件名而不是图像数据，则会读取并显示该文件。

如果提供了参数 string_param1，则其值为 value1。string_param1 可以是以下任意一种：

"displayrange"

value1 是如上所述的显示范围。

"colormap"

value1 是用于显示索引图像的颜色图。

"xdata"

如果 value1 是一个二元素向量，则它必须包含形式为 [xfirst, xlast] 的水平图像范围，其中 xfirst 和 xlast 分别是角像素中心的横坐标。否则 value1 必须是一个向量，且只有第一个和最后一个元素会被分别用作 xfirst 和 xlast。

"ydata"

如果 value1 是一个二元素向量，则它必须包含形式为 [yfirst, ylast] 的垂直图像范围，其中 yfirst 和 ylast 分别是角像素中心的纵坐标。否则 value1 必须是一个向量，且只有第一个和最后一个元素会被分别用作 yfirst 和 ylast。

可选的返回值 h 是图像的图形句柄。

另请参阅： image，imagesc，colormap，gray2ind，rgb2ind。

 

image (img) ¶

image (x, y, img) ¶

image ("CData", img) ¶

image ("XData", x, "YData", y, "CData", img) ¶

image (…, prop, val) ¶

image (hax, …) ¶

h = image (…) ¶

将矩阵显示为图像。

img 可以是一个二维矩阵，其中每个元素都是当前颜色图中的索引。对于浮点数据，值 1 选择颜色图中的第一种颜色。对于整数数据，值 0 选择颜色图中的第一种颜色。

或者，img 可以是一个三维矩阵，其中第三个维度是 RGB 三元组，用于指定颜色。如果图像数据是浮点类型，则数据必须在 [0, 1] 范围内。如果图像数据是整数类型（uint8 或 uint16），则数据必须在 [0, INTMAX] 范围内。

x 和 y 是可选的 1 元素（[min]）或 2 元素向量（[min, max]），用于指定角像素中心的坐标。如果未指定，默认最小值为 1，最大值为 img 在相应维度上的长度。如果将范围指定为 [max, min]，则图像将沿该轴反转。为方便起见，x 和 y 可以指定为 N 元素向量，与 img 中数据的长度相匹配。但只有第一个和最后一个元素会被用于确定轴范围。

可以为图像对象指定多个属性/值对，但必须成对出现。

如果第一个参数 hax 是一个轴对象句柄，则在该轴中绘制图像，而不是在 gca 返回的当前轴中绘制。

可选的返回值 h 是图像的图形句柄。

实现说明：图像的原点 (0, 0) 位于左上角。对于普通图形，原点位于左下角。Octave 通过先正常绘制数据，然后将 ydir 属性设置为 "reverse" 来反转 y 轴的方向，以此处理这种翻转。这在同时叠加图像和普通图形时会产生影响。推荐的解决方案是先显示图像，然后使用例如 flipud (ydata) 的方式绘制翻转后的数据。

调用形式：image 函数可以以两种形式调用：高级形式和低级形式。当使用普通选项调用时，使用高级形式，它会先调用 newplot 来准备图形窗口和坐标轴。当 image 的输入全部是属性/值对时，则使用低级形式，它会创建一个新的图像对象实例并将其插入当前坐标轴中（就像 hold on 已生效一样）。

图形属性：属性的完整列表请参见 图像属性。

另请参阅： imshow，imagesc，colormap。

 

imagesc (img) ¶

imagesc (x, y, img) ¶

imagesc (…, climits) ¶

imagesc (…, "prop", val, …) ¶

imagesc ("prop1", val1, …) ¶

imagesc (hax, …) ¶

h = imagesc (…) ¶

将矩阵 img 的缩放版本显示为彩色图像。

颜色图会被缩放，使矩阵的各个值占据整个颜色图。如果给定了 climits = [lo, hi]，则该范围将被设置为当前坐标轴的 "clim"。

x 和 y 是可选的 2 元素向量，[min, max]，用于指定角像素中心的坐标。如果将范围指定为 [max, min]，则图像将沿该轴反转。为方便起见，x 和 y 可以指定为 N 元素向量，与 img 中数据的长度相匹配。但只有第一个和最后一个元素会被用于确定图像范围。

可选的返回值 h 是图像的图形句柄。

调用形式：imagesc 函数可以以两种形式调用：高级形式和低级形式。当使用普通选项调用时，使用高级形式，它会先调用 newplot 来准备图形窗口和坐标轴。当输入全部是属性/值对时，则使用低级形式，它会创建一个新的图像对象实例并将其插入当前坐标轴中。属性的完整列表请参见 图像属性。

另请参阅： image，imshow，clim。