imfill

BW1 = logical([1 0 0 0 0 0 0 0
               1 1 1 1 1 0 0 0
               1 0 0 0 1 0 1 0
               1 0 0 0 1 1 1 0
               1 1 1 1 0 1 1 1
               1 0 0 1 1 0 1 0
               1 0 0 0 1 0 1 0
               1 0 0 0 1 1 1 0]);

BW2 = imfill(BW1,[3 3],8)

BW2 = 8x8 logical array

   1   0   0   0   0   0   0   0
   1   1   1   1   1   0   0   0
   1   1   1   1   1   0   1   0
   1   1   1   1   1   1   1   0
   1   1   1   1   1   1   1   1
   1   0   0   1   1   1   1   0
   1   0   0   0   1   1   1   0
   1   0   0   0   1   1   1   0

填充二值图像中的孔

打开实时脚本

将图像读入工作区。

I = imread('coins.png');
figure
imshow(I)
title('Original Image')

Figure contains an axes object. The axes object with title Original Image contains an object of type image.

将图像转换为二值图像。

BW = imbinarize(I);
figure
imshow(BW)
title('Original Image Converted to Binary Image')

Figure contains an axes object. The axes object with title Original Image Converted to Binary Image contains an object of type image.

填充二值图像中的孔并显示结果。

BW2 = imfill(BW,'holes');
figure
imshow(BW2)
title('Filled Image')

Figure contains an axes object. The axes object with title Filled Image contains an object of type image.

填充灰度图像中的孔

打开实时脚本

I = imread('tire.tif');
I2 = imfill(I);
figure, imshow(I), figure, imshow(I2)

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

输入参数

全部折叠

`BW` — 二值图像
逻辑数组

二值图像，指定为任意维度的逻辑数组。

示例： BW = imread('text.png');

数据类型： logical

`locations` — 标识像素位置的线性索引
正整数组成的数值向量 | 正整数组成的二维数值矩阵

标识像素位置的线性索引，指定为正整数组成的数值向量或二维数值矩阵。如果 locations 是 p×1 向量，则它包含起始位置的线性索引。如果 locations 是 p×ndims(BW) 矩阵，则每行包含一个起始位置的数组索引。

示例： [3 3]

数据类型： double

`I` — 灰度图像
数值数组

灰度图像，指定为任意维度的数值数组。

示例： I = imread('cameraman.tif');

`conn` — 像素连通性
`4` | `8` | `6` | `18` | `26` | 由 `0` 和 `1` 组成的 3×3×...×3 矩阵

像素连通性，指定为下表中的值之一。对于二维图像，默认连通性是 4，对于三维图像，默认连通性是 6。

值	意义
二维连通
`4`	如果像素的边缘相互接触，则这些像素具有连通性。像素的邻域是水平或垂直方向上的相邻像素。	当前像素以灰色显示。
`8`	如果像素的边缘或角相互接触，则这些像素具有连通性。像素的邻域是水平、垂直或对角线方向上的相邻像素。	当前像素以灰色显示。
三维连通
`6`	如果像素的面接触，则这些像素具有连通性。像素的邻域是符合以下条件的相邻像素：在所列方向之一上连通：内、外、左、右、上、下	当前像素以灰色显示。
`18`	如果像素的面或边缘接触，则这些像素具有连通性。像素的邻域是符合以下条件的相邻像素：在所列方向之一上连通：内、外、左、右、上、下在两个方向的组合上连通，如右下或内上	当前像素是立方体的中心。
`26`	如果像素的面、边缘或角接触，则这些像素具有连通性。像素的邻域是符合以下条件的相邻像素：在所列方向之一上连通：内、外、左、右、上、下在两个方向的组合上连通，如右下或内上在三个方向的组合上连通，如内右上或内左下	当前像素是立方体的中心。

对于更高的维度，imfill 使用默认值 conndef(ndims(BW),'minimal')。

也可以通过指定由 0 和 1 组成的 3×3×...×3 矩阵，以更通用的方式来定义任意维度的连通性。值为 1 的元素定义相对于 conn 的中心元素的邻域位置。请注意，conn 必须关于其中心元素对称。有关详细信息，请参阅指定自定义连通性。

数据类型： double | logical

输出参数

全部折叠

`BW2` — 填充的二值图像
逻辑数组

填充的二值图像，以逻辑数组形式返回。

`locations_out` — 像素位置的线性索引
数值向量 | 数值矩阵

像素位置的线性索引，以数值向量或矩阵形式返回。

`I2` — 填充的灰度图像
数值数组

填充的灰度图像，以数值数组形式返回。

算法

imfill 使用基于形态学重新构造的算法 [1]。

参考

[1] Soille, P., Morphological Image Analysis: Principles and Applications, Springer-Verlag, 1999, pp. 173–174.

扩展功能

C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

用法说明和限制：

imfill 支持 C 代码生成（需要 MATLAB^® Coder™）。请注意，如果您选择通用的 MATLAB Host Computer 目标平台，imfill 生成的代码将使用平台特定的预编译共享库。使用共享库可保留性能上的优化，但适用范围仅限于生成的代码所适用的目标平台。有关详细信息，请参阅Image Processing Toolbox 中代码生成支持的类型。
可选输入参数 conn 和 'holes' 必须为编译时常量。
如果输入是二值图像，则不支持输入参数 'holes'。
imfill 最多仅支持三维输入。（不支持 N 维。）
不支持使用交互式语法选择点。例如，不支持语法 imfill(BW,0,CONN)。
使用 locations 输入参数时，一旦在编译时选择了格式，就无法在运行时更改格式。然而，位置中的点数在运行时可以改变。

基于线程的环境
使用 MATLAB® `backgroundPool` 在后台运行代码或使用 Parallel Computing Toolbox™ `ThreadPool` 加快代码运行速度。

此函数完全支持基于线程的环境。有关详细信息，请参阅在基于线程的环境中运行 MATLAB 函数。

GPU 数组
通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

用法说明和限制：

输入必须为二维，仅支持二维连通性（4 和 8）。
不支持使用交互式语法选择点。例如，不支持语法 imfill(BW)。

有关详细信息，请参阅GPU 上的图像处理。

版本历史记录

在 R2006a 之前推出

全部展开

R2022b: 支持基于线程的环境

imfill 现在支持基于线程的环境。

另请参阅

conndef | bwselect | imreconstruct | regionfill

imfill

语法

说明

示例

从指定的起点填充图像

填充二值图像中的孔

填充灰度图像中的孔

输入参数

BW — 二值图像 逻辑数组

locations — 标识像素位置的线性索引 正整数组成的数值向量 | 正整数组成的二维数值矩阵

I — 灰度图像 数值数组

conn — 像素连通性 4 | 8 | 6 | 18 | 26 | 由 0 和 1 组成的 3×3×...×3 矩阵

输出参数

BW2 — 填充的二值图像 逻辑数组

locations_out — 像素位置的线性索引 数值向量 | 数值矩阵

I2 — 填充的灰度图像 数值数组

算法

参考