roifilt2

회색조 영상의 관심 영역(ROI) 필터링

구문

J = roifilt2(h,I,BW)

J = roifilt2(I,BW,fun)

설명

J = roifilt2(h,I,BW)는 2차원 선형 필터 h를 사용하여 2차원 회색조 영상 I에서 관심 영역(ROI)을 필터링합니다. 이진 마스크 BW는 I의 ROI를 정의합니다. roifilt2는 BW에서 1이 포함된 위치의 픽셀에 대해서는 필터링된 값을 갖고, BW에서 0이 포함된 위치의 픽셀에 대해서는 필터링되지 않은 값을 갖는 영상을 반환합니다. 이 유형의 필터링을 마스크 처리된 필터링이라고 합니다.

J = roifilt2(I,BW,fun)은 함수 fun을 사용하여 I의 ROI에서 데이터를 처리합니다.

예제

다각형 마스크를 사용하여 영상 필터링하기

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

I = imread("eight.tif");

마스크 다각형의 꼭짓점을 정의합니다.

c = [222 272 300 270 221 194];
r = [21 21 75 121 121 75];

이진 마스크 영상을 만듭니다.

BW = roipoly(I,c,r);

마스크 BW로 지정된 영상 I의 영역을 필터링합니다.

H = fspecial("unsharp");
J = roifilt2(H,I,BW);

원본 영상과 필터링된 영상을 표시합니다.

imshow(I)

imshow(J)

입력 인수

h — 선형 필터

2차원 숫자형 행렬

선형 필터로, 2차원 숫자형 행렬로 지정됩니다.

데이터형: double

I — 회색조 영상

2차원 숫자형 행렬

회색조 영상으로, 2차원 숫자형 행렬로 지정됩니다.

• 필터 h를 지정하면 I는 나열된 임의의 데이터형일 수 있습니다.

• 함수 핸들 fun을 지정하면 I는 fun에서 지원되는 임의의 데이터형일 수 있습니다.

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

BW — 마스크

2차원 논리형 행렬 | 2차원 숫자형 행렬

마스크로, I와 동일한 크기의 2차원 논리형 행렬 또는 2차원 숫자형 행렬로 지정됩니다. 숫자형 입력값의 경우 0이 아닌 픽셀은 1(true)로 간주됩니다.

fun — 함수 핸들

핸들

함수 핸들로, 핸들로 지정됩니다. 함수 핸들에 대한 자세한 내용은 함수 핸들 생성하기 항목을 참조하십시오.

출력 인수

J — 필터링된 영상

2차원 행렬

필터링된 영상으로, 2차원 행렬로 반환됩니다.

• 필터 h를 지정하면 J는 입력 영상 I와 데이터형이 동일합니다.

• 함수 핸들 fun을 지정하면 J의 데이터형은 fun에 의해 결정됩니다.

알고리즘

필터 h를 지정하면 roifilt2가 imfilter를 호출하여 필터를 구현합니다. roifilt2 함수는 원래 영상과 동일한 범위의 데이터를 반환하는 작업에 가장 적합합니다. 출력 영상이 마스크 처리되지 않은 영역의 일부 데이터를 입력 영상에서 직접 가져오기 때문입니다. 일부 필터링 작업은 정상 영상의 데이터 범위(즉, double형 영상의 경우 [0, 1], uint8형 영상의 경우 [0, 255], uint16형 영상의 경우 [0, 65535])를 벗어나는 값을 생성할 수 있습니다.

확장 기능

C/C++ 코드 생성

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

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

• roifilt2 함수는 C 코드 생성을 지원합니다(MATLAB^® Coder™가 필요함). 일반적인 MATLAB Host Computer 타깃 플랫폼을 선택할 경우 roifilt2 함수는 미리 컴파일된 플랫폼별 공유 라이브러리를 사용하는 코드를 생성합니다. 공유 라이브러리를 사용하면 성능 최적화가 유지되지만 코드를 생성할 수 있는 타깃 플랫폼이 제한됩니다. 자세한 내용은 Types of Code Generation Support in Image Processing Toolbox 항목을 참조하십시오.

• fun을 인수로 지정해서 coder 함수를 사용하여 코드를 생성하는 경우 fun을 상수 string형 또는 문자형 벡터로 지정하십시오. 예를 들어 adaptthresh 함수를 사용하려면 fun을 문자열 "adaptthresh"로 지정하고 coder.Constant 함수를 사용하여 이 문자열을 상수로 변환합니다.

  codegen roifilt2 -args {I,BW,coder.Constant("adaptthresh")}

  래퍼 함수에 대한 코드를 생성하는 경우 fun은 래퍼 함수 내의 함수 핸들일 수 있습니다. 예를 들어 다음 명령은 myFunction이라는 래퍼 함수에 대한 코드를 생성합니다.

  codegen myFunction -args {I,BW,coder.Constant("adaptthresh")}

  다음은 roifilt2 함수에 대한 호출을 포함하는 래퍼 함수 myFunction에 대한 샘플 정의입니다. 래퍼 함수 내에서 str2func 함수를 사용하여 fun을 상수 string형에서 함수 핸들로 변환합니다.

  function out = myFunction(I,BW,fun) %#codegen
        fun1 = str2func(fun); % This will become fun1 = @adaptthresh
        out = roifilt2(I,BW,fun1);
  end

GPU 코드 생성

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

C/C++ 코드 생성 섹션의 사용법 관련 참고 및 제한 사항을 참조하십시오. GPU 코드 생성에도 동일한 사용법 관련 참고 및 제한 사항이 적용됩니다.

버전 내역

R2006a 이전에 개발됨

R2023b: C 코드 생성 지원

이제 roifilt2 함수는 C 코드 생성을 지원합니다(MATLAB Coder가 필요함).

참고 항목

imfilter | filter2 | roipoly

도움말 항목

• Apply Custom Filter to Region of Interest in Image
• Sharpen Region of Interest in an Image