Install required software

Getting OpenCV framework (optional)

We suggest to follow these steps in order to install OpenCV framework in such a way that the resulting ViSP framework builds with OpenCV as 3rd party. This could be useful for users who want to use ViSP and OpenCV together. It will also allow to exploit keypoints throw ViSP classes (vpKltOpencv, vpKeyPoint) or the model-based tracker in his hybrid version (vpMbKltTracker). If you are not interested in capabilities leveraged by using OpenCV as 3rd party, just skip this section.

Download the latest OpenCV for iOS like opencv-3.3.1-ios-framework.zip

Unzip the archive in a directory denoted <framework_dir>/ios. If <framework_dir> is for example the following folder ~/framework just do the following:

$ mkdir -p ~/framework/ios

If the download was performed with Safari, do the following

$ mv ~/Downloads/opencv2.framework ~/framework/ios/

or if the download was either performed with Firefox, do the following

You can also download a daily snapshot. Once downloaded, uncompress the file using

$ tar xvzf visp-snapshot-yyyy-mm-dd.tar.gz -C ~/framework

Or you can download the latest release as a zip or a tarball. Once downloaded, uncompress the file using either

$ tar xvzf visp-x.y.z.tar.gz -C ~/framework

or

$ unzip visp-x.y.z.zip -d ~/framework

We suppose now that ViSP source is in a directory denoted <framework_dir> besides ios folder.

$ ls ~/framework

ios visp

Building ViSP framework

Build ViSP framework

$ cd ~/framework

$ python visp/platforms/ios/build_framework.py ios

Once build, you will have ~/framework/ios/visp3.framework that could be added to a Xcode project for iOS devices. If you follow Getting OpenCV framework (optional) you have also ~/framework/ios/opencv2.framework that should also be added to the Xcode project.

$ ls ~/framework/ios

build opencv2.framework visp3.framework

Note

ViSP framework is build with capabilities that enables the usage of the following 3rd parties: XML, OpenCV, pthread, apriltag, lapack.