This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.


Burn binary mask into 2-D image


B = imoverlay(A,BW)
B = imoverlay(___,color)



B = imoverlay(A,BW) fills the grayscale or RGB input image, A, with a solid color where the input binary mask, BW, is true.

B = imoverlay(___,color) lets you specify the color that imoverlay uses to fill the image. color is a valid MATLAB® color specification.


collapse all

Read grayscale image into the workspace.

A = imread('cameraman.tif');

Read binary image into the workspace.

BW = imread('text.png');

Burn the binary image into the grayscale image, choosing the color to be used.

B = imoverlay(A,BW,'yellow');

Display the result.


Input Arguments

collapse all

Input image, specified as a real, nonsparse 2-D matrix.

Data Types: single | double | int16 | uint8 | uint16 | logical

Mask image, specified 2-D logical matrix the same size as A.

Data Types: single | double | int16 | uint8 | uint16 | logical

Color used for the overlay, specified as a MATLAB color specification. For example, if you want to specify the color red, you could use any of the following specifications: 'red','r', or [1 0 0].

Output Arguments

collapse all

Output image, returned as a 2-D matrix of class uint8.

Extended Capabilities

Introduced in R2016a