imoverlay

2차원 영상에 이진 마스크 새기기

구문

B = imoverlay(A,BW)

B = imoverlay(A,BW,color)

설명

B = imoverlay(A,BW)는 회색조 영상 또는 RGB 영상 A에서 입력 이진 마스크 BW가 true인 위치를 단색으로 채웁니다.

B = imoverlay(A,BW,color)는 imoverlay가 영상 채우기에 사용할 색을 지정합니다.

예제

회색조 영상에 이진 영상 새기기

회색조 영상을 작업 공간으로 읽어 들입니다.

A = imread('cameraman.tif');

이진 영상을 작업 공간으로 읽어 들입니다.

BW = imread('text.png');

이진 마스크에 사용할 색을 지정하여 회색조 영상에 이진 영상을 새깁니다.

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

결과를 표시합니다.

imshow(B)

RGB 영상에 이진 영상 새기기

RGB 영상을 작업 공간으로 읽어 들입니다.

RGB = imread('peppers.png');

이진 영상을 작업 공간으로 읽어 들입니다.

BW = imread('text.png');

RGB 영상이 이진 마스크와 동일한 크기가 되도록 자릅니다.

RGB_cropped = imcrop(RGB,[64,128,255,255]);

자른 RGB 영상에 사용할 색을 선택해서 이진 영상을 새깁니다.

B = imoverlay(RGB_cropped,BW,'red');

결과를 표시합니다.

figure
imshow(B)

입력 인수

A — 입력 영상

2차원 회색조 영상 | 2차원 RGB 영상

입력 영상으로, 2차원 회색조 영상 또는 2차원 RGB 영상으로 지정됩니다.

데이터형: single | double | int16 | uint8 | uint16 | logical

BW — 마스크 영상

2차원 이진 행렬 | 2차원 숫자형 행렬

마스크 영상으로, 영상 A의 처음 2개 차원과 크기가 동일한 2차원 이진 행렬 또는 2차원 숫자형 행렬로 지정됩니다. 숫자형 입력값의 경우 0이 아닌 픽셀은 1(true)로 간주됩니다.

데이터형: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | logical

color — 오버레이에 사용되는 색

"yellow" (디폴트 값) | RGB 3색 | 색 이름 | 짧은 색 이름

오버레이에 사용되는 색으로, RGB 3색, 색 이름 또는 짧은 색 이름으로 지정됩니다.

RGB 3색을 사용하여 어떤 색이든 지정할 수 있습니다. RGB 3색은 요소를 3개 가진 행 벡터로, 각 요소는 색을 구성하는 빨간색, 녹색, 파란색의 농도를 지정합니다. 농도의 범위는 [0, 1]이어야 합니다.

몇몇의 흔한 색은 string형 스칼라 또는 문자형 벡터인 이름으로 지정할 수 있습니다. 다음 표에는 명명된 색 옵션과 그에 해당하는 RGB 3색이 나와 있습니다.

색 이름	짧은 이름	RGB 3색	실제 표시 색
"red"	"r"	[1 0 0]
"green"	"g"	[0 1 0]
"blue"	"b"	[0 0 1]
"cyan"	"c"	[0 1 1]
"magenta"	"m"	[1 0 1]
"yellow"	"y"	[1 1 0]
"black"	"k"	[0 0 0]
"white"	"w"	[1 1 1]

다음 표에는 라이트 테마와 다크 테마의 플롯에 대한 디폴트 색 팔레트가 나와 있습니다.

팔레트	팔레트 색
"gem" — 라이트 테마 디폴트 값 R2025a 이전: 대부분의 플롯은 기본적으로 이러한 색을 사용합니다.
"glow" — 다크 테마 디폴트 값

orderedcolors 함수를 사용하여 이러한 팔레트의 RGB 3색을 구할 수 있습니다 (R2023b 이후). 예를 들어, "gem" 팔레트의 RGB 3색을 구합니다.

RGB = orderedcolors("gem");

예: "r"

예: "green"

예: [0 0.4470 0.7410]

출력 인수

B — 출력 영상

2차원 RGB 영상

출력 영상으로, 2차원 RGB 영상으로 반환됩니다.

데이터형: uint8

확장 기능

C/C++ 코드 생성

MATLAB® Coder™를 사용하여 C 코드나 C++ 코드를 생성할 수 있습니다.

사용법 관련 참고 및 제한 사항:

• imoverlay 함수는 C 및 C++ 코드 생성을 지원합니다(MATLAB^® Coder™가 필요함). 자세한 내용은 Code Generation for Image Processing 항목을 참조하십시오.

• 코드를 생성할 때 color를 string형 또는 문자형 벡터로 지정하는 경우 값은 컴파일타임 상수여야 합니다.

GPU 코드 생성

GPU Coder™를 사용하여 NVIDIA® GPU용 CUDA® 코드를 생성할 수 있습니다.

사용법 관련 참고 및 제한 사항:

• 코드를 생성할 때 color를 string형 또는 문자형 벡터로 지정하는 경우 값은 컴파일타임 상수여야 합니다.

버전 내역

R2016a에 개발됨

참고 항목

imblend | superpixels | boundarymask | labeloverlay