macOS Xcode에서 OpenCV 사용하기

macOS Xcode에서 OpenCV 사용하기

macOS에 OpenCV 설치 방법은 구글링을 통해 쉽게 빌드 및 설치가 가능하다. 이 포스팅에서는 간단하게 https://github.com/opencv/opencv에서 소스를 받아 빌드하고 설치하는 방법과 더불어 Xcode에서 빌드된 OpenCV 라이브러리 사용 방법을 소개한다.

1. macOS 및 iOS 플랫폼 OpenCV 빌드 및 설치

OpenCV을 GitHub에서 다운로드 받을 디렉토리로 이동해서 다음과 같이 clone 후 빌드 및 설치를 하면 된다. git과 cmake 툴은 미리 설치되어야 한다.

1.1 opencv git clone

$mkdir ~/git
$cd ~/git
$git clone https://github.com/opencv/opencv.git
$cd opencv

1.2 macOS: cmake을 이용한 라이브러리 빌드 및 설치

$mkdir build
$cd build
$cmake ..
$sudo make install
빌드 후에는 헤더파일과 라이브러리 파일은 각각 /usr/local/include 와 /usr/local/lib 에 복사가 된다.

1.3 macOS: python을 이용한 framework 빌드

python을 이용한 빌드에서는 QT UI 라이브러리도 설치되
$python platforms/osx/build_framework.py macOS

1.4 iOS: python을 이용한 framework 빌드

iOS 빌드 방법은 다음과 같다. 빌드가 완료되면 ~/git/opencv/ios 디렉터리에 opencv2.framework이 생성된다.
$python platforms/ios/build_framework.py ios

현재 OpenCV 3.1 iOS 버전은 png 라이브러리를 사용할 때 다음과 같이 링크 에러가 발생할 수 있다. 'Undefined symbols for architecture arm64: "_png_init_filter_functions_neon", referenced from: _png_read_filter_row in opencv2(pngrutil.o)'.

이 문제를 해결하기 위해서는 Git의 Tag 3.1.0으로 checkout 후 빌드 스크립트를 수정하거나 해당 헤더 파일을 수정 방법 중 하나를 선택 후 재빌드한다.

1.4.1 빌드 스크립트 수정

opencv/platforms/ios/build_framework.py 파일 내용 중 일부를 다음과 같이 수정 후 다시 빌드한다.

Before:
    if arch.startswith("armv"):
        cmakecmd.append("-DENABLE_NEON=ON")
After:
    if arch.startswith("armv") or arch.startswith("arm64"):
        cmakecmd.append("-DENABLE_NEON=ON")

1.4.2 pngpriv.h 헤더 파일 수정

opencv/3rdparty/libpng/pngpriv.h 파일 내용 중 다음 부분을 찾은 후

...
#ifdef _ _ ARM_NEON_ _
#define PNG_ARM_NEON_OPT 2
#else
#define PNG_ARM_NEON_OPT 0
#endif
...
아래 내용을 추가 후 다시 빌드한다.
#define PNG_ARM_NEON_OPT 0

2. Xcode 프로젝트 생성 및 환경 설정

Xcode 프로젝트 생성을 위해 'Mastering OpenCV with Practical Computer Vision Projects' 책의 Cartoonifier 예제를 사용한다.

먼저 Xcode을 실행 후 Cartoonifier 프로젝트를 생성한다. 그리고 두 개의 그룹을 만든다. 그룹은 프로젝트 이름을 선택 후 Ctrl+왼쪽마우스버튼 또는 오른쪽마우스버튼을 누르면 팝업메뉴에서 선택할 수 있다.

      

그리고 src 그룹에 'Add Files to "Cartoonifier"...' 메뉴를 선택해서 다음과 같이 5개의 소스 파일과 헤더파일을 추가한다.

 

그리고 opencv 라이브러리들을 등록한다. 이전에 만들었던 framework 그룹에 opencv 그룹을 하나 더 만들고, 다음과 같이 opencv의 Shared Library 들을 등록한다. Cartoonifier 에서는 등록된 모든 Shared Library을 사용하지 않지만 다른 프로젝트들을 위해 모두 포함시켰다.


참고로 macOS에서는 Shared Library의 확장자는 .dylib 이다. 프로젝트에 포함된 OpenCV의 Shared Library 들은 /usr/local/lib 디렉터리에 있다.

그리고 프로젝트 속성에서 참조할 Header 파일 경로와 Library 파일 경로를 설정한다. 아래 그림처럼 왼쪽에 있는 'Project Navigator'에서 프로젝트 이름인  'Cartoonifier'을 선택하면 중안에 프로젝트 속성 설정이 나타난다. 'TARGETS'에 있는 'Cartoonifier'을 선택 후에 'Build Settings' 탭을 선택한다. 그리고 'Search Paths' 항목에서 'Header Search Paths'와 'Library Search Paths' 항목을 설정한다.
  • Header Search Paths: /usr/local/include/ /usr/local/include/opencv/
  • Library Search Paths: /usr/local/lib/



3. 실행

빌드 오류가 없다면 'RUN' 버튼을 누르면 macOS에서 실행되는 Cartoonifier 프로그램을 만날 수 있다.



4. Xcode 프로젝트 소스 코드

아래 소스코드를 다운로드 후 압축을 푼 후 Cartoonifier_Desktop/xcode/Cartoonifier.xcodeproj 프로젝트 파일을 선택하면 된다.

5. Reference

댓글

  1. Unknown2019년 3월 29일 오전 10:39

    안녕하세요! 혼자 따라보고 실습하는 학생입니다.
    다름이 아니라 1.3 mac OS: python을 이용한 framework 빌드 와 1.4 iOS: python을 이용한 framework 빌드 부분에서 Type error 오류가 나 질문드립니다. 혹시 작업하실 때 에러가 나신 적 있으신지 문의드립니다.

    답글삭제

댓글 쓰기

이 블로그의 인기 게시물

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와...
자세한 내용 보기