Visual Servoing Platform  version 3.0.0
Tutorial: Installation from source on OSX for iOS devices

In this tutorial you will learn how to install ViSP from source on OSX in order to be able to compile and use it for iOS development. These steps have been tested for OSX 10.8.4 but should work with any other distribution as well.

Note
Concerning ViSP installation, we provide also other Tutorials.

Install required software

Install optional packages

ViSP is interfaced with several 3rd party libraries. The complete list is provided here. We recommend to install the following:

  • OpenCV: get OpenCV for iOS Version 2.4.3 or later in http://opencv.org/downloads.html
  • liblapack, libxml2, libjpeg, libpng, ffmpeg should be already included in your OS X package

Install ViSP from source code

Getting ViSP source code

There are different ways to get ViSP source code:

  • 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
    or
    unzip visp-x.y.z.zip
  • You can also download a daily snapshot. Once downloaded, uncompress the file using
    tar xvzf visp-snapshot-yyyy-mm-dd.tar.gz
  • Or you get the cutting-edge ViSP from GitHub repository using the following command
    $ git clone https://github.com/lagadic/visp.git

We suppose now that ViSP source is in a directory denoted <source_dir>, for example $HOME/visp

Configuring ViSP from source

  • Choose the right path for the <source_dir> and the <binary_dir> in c-make gui.

    img-configure-path-iOS.png
  • Press Configure on c-make gui to validate your configuration, choose Xcode as the generator for the project and press Done.

    img-configure-generator-iOS.png
  • Make sure that USE_X11 is unchecked because we will not use the display part of visp for iOS, and USE_COIN is unchecked unless your really need it because their is a known bug on the OSX Coin package.

    img-configure-options-iOS.png
  • Press Configure again. Now we can finish the configuration stage by generating the Xcode project.
  • To generate the Xcode project press Generate on c-make gui. From now, c-make gui can be closed.

Building ViSP library

Open and configure ViSP Xcode project

Launch Xcode (Version 4.6.2) and open ViSP.xcodeproj that should be in the <binary_dir> where you previously built ViSP sources.

Open the VISP Project File at the top of your hierarchy in order to configure the project and select the visp target.

img-getting-started-iOS-project.png

In the Architectures group, edit the following information in this order :

  • Base SDK : Latest iOS
  • Supported Platforms : iOS
  • Architectures : Standard (armv7, armv7s)
img-getting-started-iOS-architectures.png

Generate ViSP library

Now that you have correctly configured your project, choose the visp target and press run.

img-getting-started-iOS-run.png

Next tutorial

You are now ready to see the next Tutorial: How to create and build a CMake project that uses ViSP on iOS that will show you how to use ViSP as a 3rd party to build your own project.