{"id":1050,"date":"2012-12-01T17:54:44","date_gmt":"2012-12-01T09:54:44","guid":{"rendered":"http:\/\/nick.workao.org\/?p=1050"},"modified":"2012-12-02T00:41:19","modified_gmt":"2012-12-01T16:41:19","slug":"mac-os-x-opencv-port","status":"publish","type":"post","link":"http:\/\/nick.txtcc.com\/index.php\/mac-os\/1050","title":{"rendered":"Mac OS X OpenCV Port"},"content":{"rendered":"

This page is devoted to information specific to the OS X build of OpenCV. Things are changing quickly due to recent work by Willow Garage, and the transition to the CMake build system.<\/p>\n

Also see the general\u00a0InstallGuide<\/a>.<\/li>\n

For instructions on using the OpenCV libraries in an OS X app see\u00a0 UsingOpenCVUnderOSX<\/a><\/li>\n<\/ul>\n

There are a number of ways to install OpenCV on OS X. The most straightforward way is to download the latest version of OpenCV (currently 2.2.0), and use cmake as described in the general\u00a0 InstallGuide<\/a>\u00a0and below at number 2.<\/p>\n

Each of the numbers below are separate ways to install OpenCV for Mac OS X.<\/p>\n

<\/p>\n

0. Getting a precompiled version ( sorry, but this is only for OpenCV 1.2 and only valid only for i386, Not 2.x – anyone know how to build a Private Framework for 2.x ? ):<\/h2>\n

see:\u00a0 http:\/\/www.ient.rwth-aachen.de\/cms\/software\/opencv\/<\/a><\/a><\/p>\n

<\/p>\n

wget http:\/\/www.ient.rwth-aachen.de\/~asbach\/OpenCV-Private-Framework-1.2.dmg\nopen OpenCV-Private-Framework-1.2.dmg\ncd \/Volumes\/OpenCV\\ Private\\ Framework\/\ncp -R OpenCV.framework\/ \/Library\/Frameworks\/OpenCV.framework<\/pre>\n <\/p>\n1. Build via MacPorts<\/h2>\nFor Snow Leopard users, you can build OpenCV 2.1.0 and above via\u00a0MacPorts<\/a>\u00a0as a 64-bit library with support of QTKit video I\/O and Cocoa GUI.<\/p>\n
Assuming\u00a0MacPorts<\/a>\u00a0installed, first use:<\/p>\n
 <\/p>\n
sudo port selfupdate<\/pre>\nto update the\u00a0MacPorts<\/a>\u00a0base and the port tree. Then, simply:<\/p>\n
 <\/p>\n
sudo port install opencv<\/pre>\nto build OpenCV 2.1.0 in 64-bit.<\/p>\n
If you encounter errors, try installing its dependents with\u00a0+universal<\/tt>\u00a0whenever possible.<\/p>\n
 <\/p>\nsudo port -v install opencv +python26<\/pre>\nto use with Python 2.6 bindings or<\/p>\n
 <\/p>\nsudo port -v install opencv +python27<\/pre>\nto use with Python 2.7 bindings<\/p>\nBy default OpenCV is installed to\u00a0\/opt\/local\/<\/tt>\u00a0according to\u00a0MacPorts<\/a>\u00a0conventions. The opencv_xxxx utilities are located in\u00a0\/opt\/local\/bin\/<\/tt>, the dynamic libraries in\u00a0\/opt\/local\/lib\/<\/tt>\u00a0and the header files in\/opt\/local\/include\/opencv\/<\/tt>.<\/p>\n
To use the libraries, include the required files with standard includes. For example:<\/p>\n
 <\/p>\n
#include \n#include <\/pre>\nIf you use Xcode, the instructions are similar to the ones in method 3. It only differs that\u00a0\/usr\/local<\/tt>\u00a0becomes\u00a0\/opt\/local<\/tt>.<\/p>\n
 <\/p>\n1.1 Build via HomeBrew<\/h2>\nFor users that have and like homebrew:<\/p>\n
 <\/p>\nsudo brew update\nsudo brew install opencv<\/pre>\nIf you need the 32bit version<\/strong>, change the last command to\u00a0sudo\u00a0brew\u00a0install\u00a0opencv\u00a0--build32<\/tt><\/p>\n
OLD METHOD:<\/p>\nAssuming\u00a0HomeBrew<\/a>\u00a0( aka ‘brew’) is installed first:<\/p>\n
 <\/p>\n
sudo brew update\nsudo brew install lame       ( for libmp3lame that opencv needs)\nsudo brew install libpng     ( which theora needs -  part of the ffmpeg package )\nsudo brew link    libpng     ( needed if theora\/ffmpeg can't find it)\nsudo brew install ffmpeg     ( for libavcodec and related stuff that opencv needs)\nsudo brew install python     ( the system python is not good enough)\nsudo brew install doxygen    ( if you compile opencv yourself, you'll want this)\nsudo chmod 000 \/System\/Library\/Frameworks\/Python.framework\/\nsudo chmod 000 \/Library\/Frameworks\/Python.framework\/\n   ( disable system python\/s temporarily just for the next step)\n\neither:\nsudo brew install opencv     ( finally! - this will probably bork? )\n\nor:\nsvn co https:\/\/code.ros.org\/svn\/opencv\/trunk\/opencv cd opencv ( or get sources by hand)\ncd opencv\nccmake .   ( disable everything you can that's not important, maybe you'll figure out how get it to build? don't forget to press 't' for advanced mode.  Edit the settings as you desire, then 'c' and 'g' )\ncmake .\nmake -j8\nmake install ( optional )\n\nsudo chmod 755 \/System\/Library\/Frameworks\/Python.framework\/\nsudo chmod 755 \/Library\/Frameworks\/Python.framework\/\n   ( put it back how it was )<\/pre>\nBy default OpenCV is installed to\u00a0\/opt\/homebrew\/\u00a0<\/tt><\/p>\n
*\u00a0see\u00a0also:\u00a0<\/tt><\/p>\n\u00a0\u00a0\u00a0http:\/\/www.tsd.net.au\/blog\/opencv-python-bindings-macports<\/a><\/tt><\/p>\n
\u00a0\u00a0\u00a0<\/tt>\nhttp:\/\/wiki.nuigroup.com\/Installing_OpenCV_on_Mac_OS_X<\/a><\/tt><\/p>\n
\u00a0\u00a0\u00a0https:\/\/github.com\/mxcl\/homebrew\/issues\/issue\/1792<\/a><\/tt><\/p>\n
See\u00a0MacPort<\/a>\u00a0install for any other details, just replace \/opt\/local with \/opt\/homebrew<\/p>\n
 <\/p>\n
2. Build from source using the CMake build system (new)<\/h2>\nThe GNU autotools methods (configure, make, make install) are being obsoleted. OpenCV has now switched to the CMake build system.<\/p>\n
 <\/p>\nGetting the source code<\/h3>\nMake sure you have subversion installed (built-in since Snow Leopard). If\u00a0MacPorts<\/a>\u00a0is your primary package manager, use:<\/p>\n
 <\/p>\n
sudo port install subversion<\/pre>\nif not using\u00a0MacPorts<\/a>\u00a0or it gives an error, try:<\/p>\n
 <\/p>\n
sudo fink install svn-ssl<\/pre>\nMake sure you have cmake installed. This can also be installed with\u00a0MacPorts<\/a>:<\/p>\n
 <\/p>\n
sudo port install cmake<\/pre>\nCheck out the source code into a clean directory and cd into the source directory after the download is complete:<\/p>\n
 <\/p>\n# previous URL\n# svn co https:\/\/code.ros.org\/svn\/opencv\/trunk\/opencv ; cd opencv\n# current (April 2012) URL\nsvn co http:\/\/code.opencv.org\/svn\/opencv\/trunk\/opencv ; cd opencv<\/pre>\n\n    Note: There’s a “atomic bomb commit” at\u00a0r3060<\/a>\u00a0which largely changed the OpenCV directory structure. If you wish to work with the older structure, you can specify an earlier checkout revision:<\/li>\n<\/ul>\n <\/p>\n# previous URL\n# svn co https:\/\/code.ros.org\/svn\/opencv\/trunk\/opencv -r 3059 ; cd opencv\n# current (April 2012) URL\nsvn co http:\/\/code.opencv.org\/svn\/opencv\/trunk\/opencv -r 3059 ; cd opencv<\/pre>\n <\/p>\nUse CMake to build<\/h3>\nTo use CMake to generate Unix Makefiles, type:<\/p>\n
 <\/p>\n# make a separate directory for building\nmkdir build\ncd build\ncmake -G \"Unix Makefiles\" ..<\/pre>\nYou can specify many configuration options in the above command. For examples:<\/p>\n\n    -D BUILD_TESTS=OFF<\/strong>\u00a0-> if you don’t want to build tests.<\/li>\n    
-D BUILD_NEW_PYTHON_SUPPORT=OFF<\/strong>\u00a0-> if you don’t want the Python interface support.<\/li>\n    -D WITH_CARBON=ON<\/strong>\u00a0-> (mainly for Leopard and below) if you want to use Carbon for UI instead of Cocoa (since\u00a0r2909<\/a>).<\/li>\n    
-D WITH_QUICKTIME=ON<\/strong>\u00a0-> (mainly for Leopard and below) if you want to use\u00a0QuickTime<\/a>\u00a0for Video I\/O insted of QTKit (since\u00a0r2924<\/a>). If you’re using\u00a0Snow<\/em>\u00a0Leopard and do need Carbon and\u00a0QuickTime<\/a>, you must also specify\u00a0-D CMAKE_OSX_ARCHITECTURES=i386<\/strong>,\u00a0-D CMAKE_C_FLAGS=-m32<\/strong>\u00a0and\u00a0-D CMAKE_CXX_FLAGS=-m32<\/strong>.<\/li>\n    
An example configuration of OpenCV 2.2.0 on Mac OSX 10.6 without TPP or Eigen or Carbon is shown at\u00a0http:\/\/imagebin.ca\/view\/A2uboY.html<\/a>.<\/li>\n<\/ul>\nFinally, follow the usual “make, make install” method:<\/p>\n
 <\/p>\nmake -j8\nsudo make install\n\nappend a new line \"export PYTHONPATH=\/usr\/local\/lib\/python2.7\/site-packages\/\" to ~\/.profile:<\/pre>\n<\/pre>\n<\/pre>\nIf you need the CMake GUI for other options, replace\u00a0cmake<\/strong>\u00a0with\u00a0ccmake<\/strong>. If the arrow keys fail, you can use the following commands instead:<\/p>\n
 <\/p>\nctrl + N : next option\nctrl + P : previous options\nctrl + D : down one page\nctrl + U : up one page<\/pre>\nTo compile with Intel Threading Building blocks, use ccmake (the Cmake GUI) to specify the lib and include paths to your installation of TBB.<\/p>\n
After setting the build options, hit ‘c’ to configure. Hit ‘g’ to generate the config file and exit ccmake. Then execute the “make, make install” commands above.<\/p>\n
 <\/p>\n
if got \u00a0\u201cSegmentation fault\u201d during \u201cimport cv\u201d:<\/strong><\/p>\n
In ccmake(ccmake -G "Unix Makefiles" .<\/code>), toggle to the advanced mode pressing\u00a0t<\/code>.<\/p>\n
change\u00a0PYTHON_LIBRARY<\/code><\/strong>\u00a0value to\n\/opt\/local\/lib\/libpython2.7.dylib<\/p>\n
and\u00a0PYTHON_INCLUDE_DIR<\/code><\/strong>\u00a0to\n\/opt\/local\/Library\/Frameworks\/Python.framework\/Versions\/2.7\/include\/python2.7<\/p>\n
Note that the specific path depends, of course, what version of Python you are using (2.6 or 2.7 etc.). Also, if you are using the system Python, instead of MacPorts (which is in \/opt), then you probably want\u00a0PYTHON_LIBRARY<\/strong>\u00a0to be\u00a0\/usr\/lib\/libpython2.7.dylib<\/strong><\/p>\n
 <\/p>\n
 <\/p>\n3. Building as an Xcode Framework using the make_frameworks.sh script (obsoleted)<\/h2>\nNote: the CMake build system should ultimately make this obsolete, one may remove this section when the CMake building is mature on the Mac.\u00a0By the way, the make_framework.sh script has been removed since\u00a0revision 2528<\/a>.<\/strong>The last revision where make_framework.sh successfully builds, as I tested, is r2492.<\/p>\n
OpenCV can now be built as a Mac OS X Framework useable with XCode. Just invoke the ‘.\/make_frameworks.sh’ script and you will obtain a Universal Framework named “OpenCV.framework” meant as a Private Framework.<\/p>\n
Additionally, a pre-built version (universal binary Private Framework, again together with a demo application) is available. See the\u00a0PrivateFramework<\/a>\u00a0wiki page or directly download it from\u00a0http:\/\/www.ient.rwth-aachen.de\/~asbach\/OpenCV-Private-Framework-1.1.dmg<\/a><\/a>\u00a0.<\/p>\n
A more recent version of the framework can be found here\u00a0http:\/\/www.ient.rwth-aachen.de\/cms\/software\/opencv\/<\/a><\/a>\u00a0or downloaded directly from\u00a0http:\/\/www.ient.rwth-aachen.de\/~asbach\/OpenCV-Private-Framework-1.2.dmg<\/a><\/a><\/p>\n
OpenCV 2.0 Universal Framework (tested on ppc and i386 Leopard and Snow Leopard): Here is an universal Framework for Mac ppc\/i386 built from the OpenCV 2.0 released in September09. By the way, I also fixed some bugs and add some improvements:<\/p>\n
 <\/p>\n
-> a bug on Mac (carbon) that prevented cvCloseWindow\/cvCloseAllWindow from working. -> a bug when 2 cameras capture images simultaneously (black bands) (see picture bellow) -> The trackbar now displays its current value (see picture bellow) and is resized according to its name.<\/pre>\nThose fix\/improvements are added to this framework.<\/p>\n\n    http:\/\/vislab.cs.vt.edu\/~vislab\/wiki\/images\/4\/44\/OpenCV2.0.dmg<\/a><\/li>\n<\/ul>\n\u00a0<\/p>\n
 <\/p>\n
4. Building the old UNIX way<\/h2>\nThis was removed since it no longer works.<\/p>\n
 <\/p>\nOther Resources<\/h2>\nLinks:<\/p>\n\n    Creating a universal static OpenCV library with iPhone support<\/a><\/li>\n    
http:\/\/www.ient.rwth-aachen.de\/~asbach\/OpenCV-Private-Framework-1.1.dmg<\/a><\/li>\n    
KirstenJones<\/a>\u00a0– March 2, 2009 – Has notes on building OpenCV using CMake on her blog at\u00a0http:\/\/www.princesspolymath.com<\/a><\/li>\n    
http:\/\/www.opencv.org.cn\/forum\/viewtopic.php?f=1&t=7524&start=0%20Tutorial<\/a>\u00a0of method 3 in Chinese, although it suggests a pre-built Framework instead of building by yourself.<\/li>\n    
Compile OpenCV projects using shell scripts on MacOSX<\/a><\/li>\n<\/ul>\nAttachments:<\/p>\n\n    [get<\/a>\u00a0|\u00a0view<\/a>] (2006-05-30 14:17:41, 6.2 KB) [[attachment:export.cpp]]<\/li>\n<\/ul>\n <\/p>\n
Collected Information<\/h2>\n <\/p>\nCompiling Universal Binaries<\/h3>\nThe\u00a0--enable-universal-build<\/tt>\u00a0switch has been removed again since it doesn’t allow building on intel machines … You can still try out what it did by configuring with:<\/p>\n
 <\/p>\n.\/configure CFLAGS=\"-arch i386 -arch ppc\" CXXFLAGS=\"-arch i386 -arch ppc\" --disable-dependency-tracking<\/pre>\nAs an alternative, we now have a small build script that configures and builds twice (once for ppc, once for intel) and then merges the binaries with lipo. We can and will extend this to more architectures whenever Mac OS X 10.5 Leopard is released, since it finally comes with 64bit compilers for intel. In addition to those then natural 4 platforms (intel\/ppc * 32\/64), it might be nice to provide specially optimized variants for G5, G4, G3 (-mcpu=…) to maximize speed on older hardware. This however requires additional testing (and performance testing).<\/p>\nSee also:\u00a0Compiling for Multiple Architectures<\/a>\u00a0in\u00a0http:\/\/developer.apple.com\/documentation\/Porting\/Conceptual\/PortingUnix\/<\/a><\/a><\/p>\n
A (very old) list of supported quicktime codecs can be found at\u00a0QuickTimeCodecs<\/a><\/p>","protected":false},"excerpt":{"rendered":"
This page is devoted to information specific to the OS X build of OpenCV. Things are changing quickl...<\/p>","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[340],"tags":[],"class_list":["post-1050","post","type-post","status-publish","format-standard","hentry","category-mac-os"],"_links":{"self":[{"href":"http:\/\/nick.txtcc.com\/index.php\/wp-json\/wp\/v2\/posts\/1050","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/nick.txtcc.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/nick.txtcc.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/nick.txtcc.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/nick.txtcc.com\/index.php\/wp-json\/wp\/v2\/comments?post=1050"}],"version-history":[{"count":5,"href":"http:\/\/nick.txtcc.com\/index.php\/wp-json\/wp\/v2\/posts\/1050\/revisions"}],"predecessor-version":[{"id":1054,"href":"http:\/\/nick.txtcc.com\/index.php\/wp-json\/wp\/v2\/posts\/1050\/revisions\/1054"}],"wp:attachment":[{"href":"http:\/\/nick.txtcc.com\/index.php\/wp-json\/wp\/v2\/media?parent=1050"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/nick.txtcc.com\/index.php\/wp-json\/wp\/v2\/categories?post=1050"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/nick.txtcc.com\/index.php\/wp-json\/wp\/v2\/tags?post=1050"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}

4. Building the old UNIX way<\/h2>\nThis was removed since it no longer works.<\/p>\n <\/p>\n

Collected Information<\/h2>\n <\/p>\n

4. Building the old UNIX way<\/h2>\n
This was removed since it no longer works.<\/p>\n
<\/p>\n

Collected Information<\/h2>\n
<\/p>\n