regionfill

Fill in specified regions in image using inward interpolation

Syntax

J = regionfill(I,mask)

J = regionfill(I,x,y)

Description

J = regionfill(I,mask) fills the regions in image I specified by mask. Non-zero pixels in mask designate the pixels of image I to fill. You can use regionfill to remove objects in an image or to replace invalid pixel values using their neighbors.

J = regionfill(I,x,y) fills the region in image I corresponding to the polygon with vertices specified by x and y.

Examples

Fill Region in Grayscale Image

Read and display a grayscale image.

I = imread('eight.tif');
imshow(I)

Specify the x- and y-coordinates of a polygon that completely surrounds one of the coins in the image.

x = [222 272 300 270 221 194];
y = [21 21 75 121 121 75];

Fill the polygon by using the regionfill function.

J = regionfill(I,x,y);

Display the filled image.

imshow(J)
title('Filled Image with One Fewer Coin')

Fill Regions Using Mask Image

Read and display a grayscale image.

I = imread('eight.tif');
imshow(I)

Specify the vertices of a polygon ROI that completely surrounds two of the coins by using the drawpolygon function. Specify the 'Position' name-value pair argument as the x-coordinates and y-coordinates of the polygon vertices. If you want to draw the polygon interactively, then omit the 'Position' name-value pair argument.

x = [68 296 296 113 68];
y = [12 12 120 120 66];
roi = drawpolygon(gca,'Position',[x;y]');

Create a mask image in which the ROI is true and the background is false. Display the mask.

mask = createMask(roi);
imshow(mask)

Fill the regions in the input image using the mask image. Display the filled image.

J = regionfill(I,mask);
imshow(J)

Input Arguments

I — Grayscale image

2-D numeric matrix

Grayscale image, specified as a 2-D numeric matrix of size greater than or equal to 3-by-3.

Example: I = imread('eight.tif');

Data Types: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32

mask — Mask binary image

logical array

Mask binary image, specified as a logical array of the same size as I.

Data Types: logical

x — X-coordinates of polygon vertices

numeric vector

X-coordinates of polygon vertices, specified as a numeric vector. The length of x must be the same length as y.

Example: x = [222 272 300 270 221 194];

Data Types: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32

y — Y-coordinates of polygon vertices

numeric vector

Y-coordinates of polygon vertices, specified as a numeric vector. The length of x must be the same length as y.

Example: y = [21 21 75 121 121 75];

Data Types: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32

Output Arguments

J — Filled grayscale image

2-D numeric array

Filled grayscale image, returned as a 2-D numeric array. J has the same size and class as I.

Tips

• To interactively create the ROI mask mask, you can use the roipoly function or the drawpolygon function followed by createMask.

Algorithms

regionfill smoothly interpolates inward from the pixel values on the outer boundary of the regions. regionfill computes the discrete Laplacian over the regions and solves the Dirichlet boundary value problem.