[OpenCV] C#에서 OpenCVSharp4 환경 구성 및 사용 방법 (예제 포함)

OpenCVSharp이란?

OpenCvSharp 로고. 출처: GitHub

OpenCV는 Computer Vision 라이브러리를 무료로 사용할 수 있는 라이브러리입니다. 이 OpenCV는 C/C++ 언어로 개발되어 C++ 라이브러리는 기본으로 제공하지만, C#은 제공하지 않더군요. 그래서 찾아보니 C#에서는 OpenCV를 사용하기 위해서는 C# Wrapping Library를 사용한다고 합니다. 그중 인지도가 높은 라이브러리는 Emgu CV와 OpenCVSharp이 되겠습니다.

Emgu CV와 OpenCVSharp의 가장 큰 차이점으로, OpenCVSharp의 구문이 OpenCV C++ 함수 및 메소드와 더 가깝다는 점이 있더군요. 어떤 것을 선택하든 상관은 없지만, 개인적으론 C++ 사용 방법과 비슷한 OpenCVSharp이 더 낫다고 생각합니다.

참고 링크: https://stackoverflow.com/questions/37567494/what-is-the-difference-between-opencv-net-opencvsharp-and-emgucv

What is the difference between OpenCV.NET, OpenCVSharp and EmguCV?

본문의 예제 코드는 하단에 첨부되어 있습니다.

OpenCVSharp 환경 구성하기

그럼 본격적으로 OpenCVSharp을 C# 프로젝트에 구성해 보겠습니다. C# Windows Forms 앱을 선택하고 프로젝트 이름은 ExamOpenCVSharp으로 생성하겠습니다.

C# Windows Forms 앱 프로젝트 생성

Visual Studio 상단의 도구 메뉴에서 NuGet 패키지 관리자의 솔루션용 NuGet 패키지 관리 메뉴를 클릭합니다.

솔루션용 NuGet 패키지 관리 메뉴 클릭

아래 그림처럼, NuGet-솔루션 창에서 찾아보기 탭을 클릭하고 OpenCVSharp을 검색합니다.

OpenCVSharp 검색 결과

OpenCvSharp4 v4.5.2를 선택하고, 아래와 같이 프로젝트를 체크한 후 설치 버튼을 클릭합니다.

프로젝트에 설치하기

특별한 문제가 없다면 아래와 같이 완료 화면이 표시됩니다.

NuGet 설치 완료 화면

그리고 프로젝트의 참조 부분에 여러 dll이 추가된 것도 확인할 수 있습니다.

프로젝트에 추가된 dll 목록

주의

 

 

여기까지만 설정하고 OpenCV 코드를 사용하면 예외에서 "'OpenCvSharp.Internal.NativeMethods'의 형식 이니셜라이저에서 예외를 Throw했습니다."라는 메시지가 처리됩니다. 아래의 추가 절차를 진행해 주세요.

예외 메시지

아래의 OpenCVSharp GitHub 페이지에 접속합니다.

https://github.com/shimat/opencvsharp

shimat/opencvsharp

그리고 우측 중앙의 Releases를 클릭합니다.

OpenCVSharp 메인 화면

NuGet에서 설치한 버전과 동일한 버전인 4.5.2.20210404 태그에서 OpenCvSharp-4.5.2-2021-0405.zip 파일을 클릭하여 다운로드합니다.

OpenCvSharp 파일 다운로드 화면

다운로드한 파일의 압축을 해제하면 아래와 같은 파일들이 있습니다.

압축 해제한 모습

여기서 NativeLib 폴더 > win 폴더 > x86 또는 x64의 OpenCvSharpExtern.dll 파일을 복사합니다.

OpenCvSharpExtern.dll 파일 복사하기

그리고 ExamOpenCVSharp 프로젝트 폴더에 붙여 넣습니다.

ExamOpenCVSharp 프로젝트에 붙여 넣기

이제 다시 Visual Studio로 돌아와서, ExamOpenCVSharp 프로젝트 선택 후 기존 항목 추가 메뉴를 클릭합니다.

ExamOpenCVSharp 프로젝트에서 파일 추가 메뉴 클릭

파일 선택 화면 창이 표시되면 우측 하단의 필터를 모든 파일로 선택하고, OpenCvSharpExtern.dll 파일을 추가합니다.

OpenCvSharpExtern.dll 파일 추가 화면

파일 추가 후 dll을 선택하고, 출력 디렉터리에 복사 옵션을 항상 복사로 설정합니다.

출력 디렉터리에 복사 옵션 선택 화면

C# OpenCVSharp으로 Picture Box에 이미지 불러오기

이제 환경 구성을 모두 마쳤습니다. 본격적으로 코드 사용 방법을 살펴보겠습니다. 폼의 UI는 아래와 같이 버튼과 PictureBox만 추가합니다.

UI 레이아웃

코드는 다음과 같습니다.

using OpenCvSharp;

private void buttonLoad_Click(object sender, EventArgs e)
{
	try
	{
		OpenFileDialog dlg = new OpenFileDialog();
		if (dlg.ShowDialog() == DialogResult.OK)
		{
			Mat image = Cv2.ImRead(dlg.FileName);

			pictureBoxImage.Image = OpenCvSharp.Extensions.BitmapConverter.ToBitmap(image);
		}
	}
	catch(Exception exc)
	{
		MessageBox.Show(exc.Message);
	}
}

동작 결과

아주 간단하죠? 설명할 내용도 딱히 없습니다. 본문에서 아주 중요한 부분은 프로젝트에 OpenCvSharpExtern.dll을 따로 추가한 것입니다. 이 dll이 없으면 계속해서 예외 메시지가 발생하니 꼭 알고 사용하시기 바랍니다.

아래 예제 코드는 용량 문제로 NuGet Package와 OpenCvSharpExtern.dll은 제외하고 첨부했습니다.

ExamOpenCVSharp.zip

0.01MB