Swift로 OpenCV 3.1 사용하여 iOS 앱 만들기

Swift로 OpenCV 3.1 사용하여 iOS 앱 만들기

iOS 9.0 이상에서 Swift로 OpenCV 3.1 버전을 사용하여 앱을 만들 수 있는 간단한 예제이다. http://opencv.org/ 에서 iOS로 빌드된 OpenCV 3.1 Framework을 다운로드 받아 사용하면 애물레이터에서는 문제가 없지만, 단말 환경에 맞춰 빌드를 하면 png 모듈에서 링크 오류가 발생한다. 따라서 이 문제를 해결한 OpenCV 3.1 패치버전의 iOS Framework을 빌드하거나 다운로드 받아 사용해야 한다. OpenCV 빌드 및 설치 관련 내용은 macOS Xcode에서 OpenCV 사용하기 포스팅을 참고하면 된다.

이 포스팅은  https://www.youtube.com/watch?v=ywUBHqxwM5Q을 참고하여 작성했다.

1. 개발 환경

이 포스팅에서 소개할 Xcode 프로젝트 개발환경은 다음과 같다. 

2. OpenCV 프로젝트 생성

2.1 HelloOpenCV 프로젝트 생성

Xcode을 실행 후에 아래 화면과 같이 'Create a new Xcode project'을 선택한다.

iOS을 선택하고, Single View Application을 선택 후에 'Next' 버튼을 선택한다.
프로젝트 이름을 'HelloOpenCV' 로 입력하고, Language는 'Swift'을 선택 후 Devices 항목은 가지고 있는 단말에 맞춰 선택하면 된다. 예제에서는 iPhone을 선택했다.
그 이후에 프로젝트가 생성될 위치를 선택하면 간단하게 Xcode 프로젝트는 생성된다.

2.2 iOS용 OpevCV Framework 연결

프로젝트가 생성되면 아래 화면과 같이 'Framework' 그룹을 만든다. 이 그룹은 OpenCV를 비롯하여 다른 iOS Framework 등을 사용할 때 한 곳에 관리하면 좋다.



그룹이 생성되면 아래 화면과 같이 빌드 또는 다운로드 한 iOS OpenCV Framework을 Finder에서 찾아 마우스로 끌어다 놓기를 하면 된다. 이 때 OpenCV Framework을 복사할 것인지? 아니면 참조만 할 것인지 여부를 물어보는데, 이 예제에서는 OpenCV Framework은 이 프로젝트의 디렉터리로 복사가 될 수 있도록 옵션을 선택했다.
 


정상적으로 OpenCV Framework이 추가가 되면 다음 화면과 같이 헤더파일들을 확인할 수 있다.

2.3 OpenCV Wrapper 클래스와 Bridging Header 만들기

이 프로젝트는 Swift 언어로 iOS 앱을 만든다. Swift에서는 C++ 라이브러리에 직접 접근을 할 수 없기 때문에 아래 그림과 같이 Bridging Header와 Wrapper Class을 Objective C로 만든 인터페이스를 만들어야 한다. 여기서 주의해야 할 점은 Bridging Header와 Wrapper Class의 Header 파일은 Swift 언어에서 참조하기 때문에 절대 C++의 Header 파일을 참조하면 절대 안된다.


OpenCVWrapper 클래스와 Bridging 헤더파일을 생성해보다.
우선 프로젝트에서 'OpenCVWrapper' 그룹을 만들고, 'OpenCVWrapper'에서 오른쪽 마우스버튼을 누른 후 'New Files...' 메뉴를 선택한다.

그리고 파일 템플릿을 'Cocoa Touch Class'을 선택 후 'Next' 버튼을 누른다.
Class 이름은 'OpenCVWrapper'로 설정하고, NSObject로부터 상속받도록 설정 후 Language는 Objective-C로 설정한다.
이 때 Objective-C Bridging header 생성 여부를 물어 보는데, 'Create Bridging Header' 버튼을 눌러 생성한다. 
모든 단계가 끝나면  OpenCVWrapper.h, OpenCVWrapper.m, HelloOpenCV-Bridging-Header.h 파일이 생성된다. OpenCV 3.1 Framework은 C++로 구현되어 있기 때문에 OpenCVWrapper.m 파일의 확장자를 OpenCVWrapper.mm으로 수정하고, 아래와 같이 Bridging Header에 내용을 추가하면 OpenCV을 사용하는 기본 환경 설정은 끝난다.

[HelloOpenCV-Bridging-Header.h]
//
//  Use this file to import your target's public headers that you would like to expose to Swift.
//
#include "OpenCVWrapper.h" 



3. iOS에서 OpenCV 사용하기

이번 예제에서는 화면에 두 개의 ImageView 컨트롤을 만든 후 한 개에 사진 등 이미지를 설정하면, 다른 ImageView에 그레이 색상으로 변환하여 표시한다. OpenCVWrapper에 makeGrayImage 함수를 추가하고, 이 구현 코드에서는 OpenCV의 Mat을 이용하여 색상을 흑백으로 그레이 색상으로 변환시킨다.

[OpenCVWrapper.h]
#import <Foundation/Foundation.h>
#import <UIKit/UIKit.h>


@interface OpenCVWrapper : NSObject


+(UIImage *) makeGrayImage:(UIImage *) image;


@end

[OpenCVWrapper.mm]

#import "OpenCVWrapper.h"
#import <opencv2/opencv.hpp>
#import <opencv2/imgcodecs/ios.h>

@implementation OpenCVWrapper

+(UIImage *) makeGrayImage:(UIImage *) image {
    // Transform UIImage to cv::Mat
    cv::Mat imageMat;
   
    UIImageToMat(image, imageMat);
   
    // If the image was alread grayscale, return it
    if (imageMat.channels() == 1)
        return image;
   
    // Transform the cv::mat color image to gray
    cv::Mat grayMat;
    cv::cvtColor(imageMat, grayMat, CV_BGR2GRAY);
   
    // Transform grayMat to UIImage and return
    return MatToUIImage(grayMat);
}

@end


이 예제는 간단하게 이미지를 보여주기 위하여 프로젝트에 이미지를 추가했다. 아래 그림과 같이 'Assets.xcassets' 항목을 선택 후 사진을 끌어다 놓으면 된다. 추가된 그림의 이름은 'sample'로 설정되는데, 추가하는 파일이름으로 설정되므로 그림의 파일 이름을 기억해 둔다.


이제 UI를 간단하게 만들것이다. iOS에서 UI는 Main.storyboard을 선택해서 컨트롤들을 추가하면 되는데, 이 예제는 아래 화면과 같이 위와 아래에 두 개의 ImageView 컨트롤을 사용한다.

위쪽의 ImageView 컨트롤은 이전에 추가한 sample 이미지를 선택한다. 'Content Mode'는 이미지의 가로와 세로 비율을 맞출 수 있도록 Aspect Fit로 설정하고, 배경색을 선택한다.

아래쪽 ImageView 컨트롤은 OpenCV을 이용하여 위쪽 ImageView 컨트롤에 있는 이미지를 읽어 들어 그레이 이미지로 변환하여 표시한다.


그리고 아래 화면에서 오른쪽 상단에 'Show the Assistance editor' 버튼을 누르면 하단에 ViewController.swift 소스 코드가 보여지고, 두 개의 ImageView 컨트롤이 각각 sourceView와 targetView 변수로 매핑할 수 있다.


매핑 방법은 'Control' 키를 누른 상태에서 마우스로 위쪽 ImageView 컨트롤을 선택 후 끌어다가 소스에 놓으면 조그마한 팝업창이 뜨는데, 여기에 'sourceView' 라고 입력하면 위쪽 ImageView 컨트롤이  sourceView 변수로 매핑이 되어 ImageView을 제어할 수 있다. 아래쪽 ImageView 컨트롤은 targetView로 매핑하면 된다.



그리고 ViewController.swift 코드에서 viewDidLoad() 함수에 사진을 그레이 코드로 변환하는 코드 한줄만 추가하면 프로그램이 실행될 때 자동으로 변환되어 아래의 ImageView 컨트롤에 표시 된다.

[ViewController.swift]

import UIKit
 
class ViewController: UIViewController {
    @IBOutlet weak var sourceView: UIImageView!
    @IBOutlet weak var targetView: UIImageView!
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        // Do any additional setup after loading the view, typically from a nib.
        targetView.image = OpenCVWrapper.makeGrayImage(sourceView.image);
    }
    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
        // Dispose of any resources that can be recreated.
    }
}


다음은 실행 화면이다.


지금까지 OpenCV을 iOS에서 사용할 수 있도록 프로젝트 생성 과정과 Swift 언어에서 OpenCV을 사용할 수 있는 Wrapper 클래스 생성 및 연동 방법을 설명했다. 이 예제의 소스코드는 아래 링크에서 다운로드 받을 수 있다.



4. Reference

  1. OpenCV 3 with Swift, YouTube: https://www.youtube.com/watch?v=ywUBHqxwM5Q

댓글

  1. Pandora's box2016년 10월 14일 오전 8:10

    다우로드 <- 오자 있네요

    답글삭제
  2. Unknown2017년 4월 13일 오전 11:24

    좋은 강좌 매우 감사합니다.
    근데 OpenCV 3.1 프레임워크와 예제파일을 다운로드 할 수 없어요 ㅠㅠ
    혹시 링크 수정을 부탁드려도 될려는지요..

    답글삭제

댓글 쓰기

이 블로그의 인기 게시물

macOS가 갑자기 부팅이 되지 않을 경우 데이터 복구 또는 백업 방법

이미지
어느날 갑작스럽게 Mac이 부팅 되지 않을 때, 그 안에 담겨진 소중한 자료들을 복구 할 수 있는 방법을 소개 합니다. 최악의 상황인 HW 문제가 있다면 소중한 자료들의 확보는 분명 어렵겠지만, OS적인 문제로 부팅이 되지 않을 경우는 다음과 같은 시도를 통해 확보가 가능할 수 있다. Mac 제품 특히 저장 장치가 SSD인 Mac은 저장장치가 메인 보드에 장착되기 때문에 일반 노트북처럼 2.5인치 내장 저장장치를 꺼내 다른 컴퓨터에 연결할 수 없다. 이런 경우 수리 센터에 맡길 수 있겠지만, 데이터 복구는 개인 정보 때문에 지원받지 못할 수 있다. 그렇다면 어떻게 하면 될까? 바로 '외장 저장장치'에 최신 macOS를 설치 후(시동 디스크 생성과 동일), 이 외장 저장장치로부터 macOS을 부팅하여 Mac 내부에 있는 저장장치에 접근이 가능할 수 있고, 데이터도 복구를 할 수 있다. 1. MacBook 또는 iMac 하드웨어 설정 초기화(NVRAM 초기화) 사용하다가 갑자기 어느날 macOS가 부팅이 안되면 우선 머리가 하얗게 되어 아무런 생각이 없을 것이다. 부팅을 여러번 시도할 것이고, 그래도 안된다면 수리 센터를 생각해 볼 것이다. 비용도 비용이지만 소중한 내 자료를 백업 가능할지 모르겠다. 일반 사용자가 하드웨어 설정(보통 이런 설정은 NVRAM에 저장됨)을 바꾸지는 않을 것이다. 하지만 설치한 하드웨어 또는 소프트웨어들에 의해 값들이 변경될 수 있다. NVRAM에 저장되는 정보의 예를 들면 무선랜에 연결되면 다음에 다시 연결될 수 있도록 연결된 무선랜의 이름과 암호를 저장한다. 이러한 하드웨어 설정들이 동작에 일부 영향을 줄 수 있다. 이 NVRAM을 초기화를 위해서는 전원 버튼을 누른 후 바로 'option' + 'command' + 'P' + 'R' 네 키를 동시에 누르면서  약 20초 동안 유지하면 된다. 애플 로고가 두 세번 보일 수도 ...
자세한 내용 보기

C++로 프로그래밍할 때 인자 또는 리턴 값으로 std::vector 등 STL 데이터 타입 처리하는 좋은 방법

C++ 프로그래밍할 때 std::vector 등 STL 데이터 타입을 호출하는 함수로 넘겨주거나 받아야 할 경우가 있다. 이런 경우 메모리 문제 또는 속도 문제 때문에 고민을 많이 할 것 같은데, C++11 이상을 지원하는 컴파일러를 사용하는 분이라면 이 글에서 도움을 받아 가기 바란다. 함수 인자로 넘길 때 이 경우는 사용이 명확하다. Call by Reference으로 데이터를 넘기면 된다.  Call By Reference로 인자로 넘기는 방법은 pointer 를 사용해도 되지만, reference을 사용하는 것이 좋다. void foo1(std::vector & data) {   ... } void foo2(std::vector const& data) {   ... } void foo3(std::vector data) { } int main(int argc, char* argv[]) {   std::vector my_data {10, 20, 30};   foo1(my_data);   foo2(my_data); } 위 코드에서 foo1()과 foo2()는 Call by Reference로 값을 넘기는 반면에 foo3()는 Call by Value로 main()에서 my_data를 넘기게 된다.  foo1()의 data는 main()의 my_data를 참조(reference)하고 있어서 foo1()에서의 데이터 변경은 main()의 my_data에 영향을 주게 된다. 그리고 foo2()는 main()의 my_data를 참조는 하지만 수정을 할 수가 없는 것이라서 단순히 값만 참조할 수 있게 된다. 반면 foo3()에서의 data는 main()의 my_data를 넘기는 순간에 값을 복사하기 때문에 메모리가 증가하게 된다. 또한 foo3()에서 data를 ...
자세한 내용 보기

Git 저장소를 병합하는 방법(How to merge repositories in Git)

GIT 저장소를 다른 저장소에 병합하는 방법 Git? Git은 컴퓨터 파일의 변경 내용을 추적하고 여러 사람들일 공유하는 파일에 대해 협업할 수 있도록 파일의 변경을 제어하는 버전 제어 시스템이다. 기존에 CVS, SVN 등 다양한 버전 제어 시스템들이 나왔지만, 최근에는 Git으로 통일되는 것 같다. Git은 분산 리비전(개정) 관리 시스템으로서 속도, 데이터 무결성 및 분산 된 비선형 작업 진행을 지원하는 것이 목표이다.  Git은 Linux 커널 개발을 위해 2005년 리누스 토발즈(Linus Torvalds)가 개발 되었으며, 다른 커널 개발자들도 초기 개발에 기여했다. 대부분의 다른 분산 버전 제어 시스템과 마찬가지로 Client-Server 버전 제어 시스템과는 다르게 중앙 서버와 관계없이 모든 컴퓨터의 Git 디렉토리는 파일 변경 이력(버전)을 추적할 수 있는 분산형 저장소이다. Client-Server 버전 제어 시스템으로 많이 사용했던 SVN(Subversion)은 네트워크 연결이 안될 경우 독립적인 위치에서 동시에 개발이 진행될 때 코드 병합과 이력 관리에 많은 어려움이 있었다. Git은 이런 기본적인 문제점들을 해결하면서 보다 진보적인 방법들을 제공한다.  인터넷 검색을 통해 보다 세부적인 내용과 더불어 다양한 기능들에 대해 찾아 보기 바란다. 서로 다른 저장소를 한 곳에 병합하는 방법 프로젝트 특성에 따라 한 개 이상의 저장소들에서 개발이 진행되다가 저장소의 병합이 필요할 때가 있다. 특정 디렉토리를 생성하여 복사해서 추가하면 되겠지만, 이련 경우에는 기존 저장소의 수정 이력(버전) 정보는 포기해야 한다.  쉽게 기존 저장소의 수정 이력 정보를 포함하여 저장소를 병합하는 방법이 있다. 우선 다음과 같이 세 개의 저장소가 있다고 가정한다. git/project1 git/project2 git/project3 project2와...
자세한 내용 보기