imfill

Rellenar regiones y huecos en imágenes

Sintaxis

BW2 = imfill(BW,locations)

BW2 = imfill(BW,locations,conn)

BW2 = imfill(BW,"holes")

BW2 = imfill(BW,conn,"holes")

I2 = imfill(I)

I2 = imfill(I,conn)

BW2 = imfill(BW)

BW2 = imfill(BW,0,conn)

[BW2, locations_out] = imfill(BW)

Descripción

Imágenes binarias

BW2 = imfill(BW,locations) realiza una operación de relleno por difusión sobre los píxeles del fondo de la imagen binaria de entrada BW, comenzando por los puntos especificados en locations.

BW2 = imfill(BW,locations,conn) rellena el área que define locations, en la que conn especifica la conectividad.

BW2 = imfill(BW,"holes") rellena huecos de la imagen binaria de entrada BW. En esta sintaxis, un hueco es un conjunto de píxeles de fondo que no se puede alcanzar rellenando el fondo desde el borde de la imagen.

BW2 = imfill(BW,conn,"holes") rellena huecos de la imagen binaria BW, en la que conn especifica la conectividad.

Imágenes en escala de grises

I2 = imfill(I) rellena huecos de la imagen en escala de grises I. En esta sintaxis, un hueco se define como un área de píxeles oscuros rodeada por píxeles más claros.

I2 = imfill(I,conn) rellena huecos de la imagen en escala de grises I, en la que conn especifica la conectividad.

Comportamiento interactivo

BW2 = imfill(BW) muestra la imagen binaria BW en la pantalla y permite definir la región que se va a rellenar seleccionando interactivamente puntos con el ratón. Para utilizar esta sintaxis, BW debe ser una imagen 2D.

Presione Backspace o Delete para eliminar el último punto seleccionado. Pulse Mayús y haga clic con el botón secundario o doble clic para seleccionar un punto final y comenzar la operación de relleno. Presione Return para finalizar la selección sin agregar un punto.

BW2 = imfill(BW,0,conn) permite anular la conectividad por defecto mientras se especifican las ubicaciones interactivamente.

[BW2, locations_out] = imfill(BW) devuelve las ubicaciones de los puntos seleccionados interactivamente en locations_out. Para utilizar esta sintaxis, BW debe ser una imagen 2D.

Ejemplos

Rellenar imagen desde un punto de partida específico

Cree una imagen binaria de 8 por 8.

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]);

Realice una operación de relleno por difusión a partir de la ubicación BW1(3,3). Especifique el tercer argumento de entrada como 4 para rellenar la imagen utilizando la conectividad 4. La operación rellena el hueco de la región superior izquierda de la imagen.

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

BW2 = 8×8 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   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

Realice una operación de relleno por difusión desde el mismo píxel, esta vez utilizando la conectividad 8. El área rellenada ahora también incluye el hueco de la región inferior derecha de la imagen.

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

BW3 = 8×8 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

Rellenar huecos de una imagen binaria

Lea una imagen en el área de trabajo.

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

Convierta la imagen en una imagen binaria.

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

Rellene los huecos de la imagen binaria y muestre el resultado.

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

Rellenar huecos de una imagen en escala de grises

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

Argumentos de entrada

BW — Imagen binaria

Arreglo lógico

Imagen binaria, especificada como arreglo de cualquier dimensión.

Tipos de datos: logical

locations — Índices que identifican la ubicación de los píxeles

Matriz de p por ndims(BW) de enteros positivos | Vector columna de p elementos de enteros positivos

Índices que identifican las ubicaciones de los píxeles, especificados como una de estas opciones.

• Para especificar las ubicaciones de p utilizando sus índices de subíndice, especifique una matriz de p por ndims(BW) de enteros positivos. Aquí, ndims(BW) es el número de dimensiones de la imagen de entrada, y cada fila contiene los índices de subíndice para una ubicación.

• Para especificar las ubicaciones de p utilizando sus índices lineales, especifique un vector columna de p elementos de enteros positivos.

Ejemplo: [3 4] especifica una ubicación dentro de una imagen de entrada 2D con los índices de fila y columna (3, 4).

Ejemplo: [2 2 2; 4 5 6] especifica dos ubicaciones dentro de una imagen de entrada 3D con índices de subíndice (2, 2, 2) y (4, 5, 6).

Ejemplo: 2 especifica una única ubicación correspondiente al índice lineal 2.

Ejemplo: [2; 8; 16] especifica tres ubicaciones correspondientes a los índices lineales 2, 8 y 16.

Tipos de datos: double

conn — Conectividad de píxeles

4 | 8 | 6 | 18 | 26 | Matriz de 3 por 3 por ... por 3 con valores 0 y 1

Conectividad de píxeles, especificada como uno de los siguientes valores de la tabla. La conectividad por defecto es 4 para imágenes 2D y 6 para imágenes 3D.

Valor	Significado
Conectividades bidimensionales
4	Los píxeles se consideran conectados si comparten bordes. El entorno de un píxel son los píxeles adyacentes en las direcciones horizontal y vertical.	El píxel actual se muestra en gris.
8	Los píxeles se consideran conectados si comparten bordes o vértices. El entorno de un píxel son los píxeles adyacentes en las direcciones horizontal, vertical y diagonal.	El píxel actual se muestra en gris.
Conectividades tridimensionales
6	Los píxeles se consideran conectados si comparten caras. El entorno de un píxel son los píxeles adyacentes en: Alguna de estas direcciones: adentro, afuera, izquierda, derecha, arriba y abajo	El píxel actual se muestra en gris.
18	Los píxeles se consideran conectados si sus caras o bordes se tocan. El entorno de un píxel son los píxeles adyacentes en: Alguna de estas direcciones: adentro, afuera, izquierda, derecha, arriba y abajo Una combinación de dos direcciones, como derecha-abajo o adentro-arriba	El píxel actual es el centro del cubo.
26	Los píxeles se consideran conectados si sus caras, bordes o vértices se tocan. El entorno de un píxel son los píxeles adyacentes en: Alguna de estas direcciones: adentro, afuera, izquierda, derecha, arriba y abajo Una combinación de dos direcciones, como derecha-abajo o adentro-arriba Una combinación de tres direcciones, como adentro-derecha-arriba o adentro-izquierda-abajo	El píxel actual es el centro del cubo.

En el caso de dimensiones más grandes, imfill utiliza el valor por defecto conndef(ndims(BW),"minimal").

La conectividad también puede definirse de una forma más general para cualquier dimensión especificando una matriz de 3 por 3 por ... por 3 con valores 0 y 1. Los elementos con el valor 1 definen los entornos relativos al elemento central de conn. Tenga en cuenta que conn debe ser simétrica respecto de su elemento central. Para obtener más información, consulte Especificar conectividades personalizadas.

Tipos de datos: double | logical

I — Imagen en escala de grises

Arreglo numérico

Imagen en escala de grises, especificada como arreglo numérico de cualquier dimensión.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Argumentos de salida

BW2 — Imagen binaria rellena

Arreglo lógico

Imagen binaria rellena, devuelta como arreglo lógico.

locations_out — Índices lineales de las ubicaciones de los píxeles

Vector numérico | Matriz numérica

Índices lineales de las ubicaciones de los píxeles, devueltos como vector numérico o matriz numérica.

I2 — Imagen en escala de grises rellena

Arreglo numérico

Imagen en escala de grises rellena, devuelta como arreglo numérico.

Algoritmos

imfill utiliza un algoritmo basado en reconstrucción morfológica [1].

Referencias

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

Capacidades ampliadas

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

• imfill es compatible con la generación de código C (requiere MATLAB^® Coder™). Tenga en cuenta que, si selecciona la plataforma objetivo genérica MATLAB Host Computer, imfill genera código que utiliza una biblioteca compartida precompilada específica de la plataforma. El uso de una biblioteca compartida mantiene las optimizaciones de rendimiento, pero limita las plataformas objetivo para las que se puede generar código. Para obtener más información, consulte Types of Code Generation Support in Image Processing Toolbox.

• Los argumentos de entrada opcionales conn y "holes" deben ser constantes en tiempo de compilación.

• El argumento de entrada "holes" no es compatible si la imagen de entrada es una imagen binaria.

• imfill solo es compatible con entradas hasta 3D. (no admite N dimensiones).

• Las sintaxis interactivas para seleccionar puntos no son compatibles. Por ejemplo, la sintaxis imfill(BW,0,CONN) no es compatible.

• Con el argumento de entrada locations, una vez que se selecciona un formato en tiempo de compilación, este no se puede modificar durante el tiempo de ejecución. Sin embargo, el número de puntos localizados se puede modificar durante el tiempo de ejecución.

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con los entornos basados en hilos. Para obtener más información, consulte Ejecutar funciones de MATLAB en entornos basados en subprocesos.

Arreglos GPU

Acelere código mediante la ejecución en una unidad de procesamiento gráfico (GPU) mediante Parallel Computing Toolbox™.

Notas y limitaciones de uso:

• Las entradas deben ser 2D y únicamente son compatibles las conectividades 2D (4 y 8).

• Las sintaxis interactivas para seleccionar puntos no son compatibles. Por ejemplo, la sintaxis imfill(BW) no es compatible.

Para obtener más información, consulte Procesamiento de imágenes en una GPU.

Historial de versiones

Introducido antes de R2006a

R2022b: Compatibilidad con entornos basados en hilos

Ahora imfill es compatible con los entornos basados en hilos.

Consulte también

conndef | bwselect | imreconstruct | regionfill