Tutorial: Installation from source on OSX for iOS devices

Table of Contents

• Required software
• Getting ViSP source code
• Configuring ViSP from source
  • Optional 3rd party packages
  • Generate Xcode project
• Building ViSP library
  • Open and configure ViSP Xcode project
  • Generate ViSP library

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.

Required software

• CMake gui 2.8 for OSX or higher that could be download at : http://www.cmake.org/cmake/resources/software.html

ViSP is interfaced with several optional third-party libraries. The installation of the corresponding packages is described in Optional 3rd party packages section.

Getting ViSP source code

There are different ways to get ViSP source code:

• You can download the latest stable release as a zip or a tarball. Once downloaded, uncompress the file using either

  tar xvzf ViSP-2.10.0.tar.gz 

  or

  unzip ViSP-2.10.0.zip

• You can also download a more recent snapshot. Once downloaded, uncompress the file using

  unzip ViSP-2.y.z-snapshot-2015.mm.dd.zip

• Or you get the cutting-edge ViSP from Subversion repository. To this end you have first to install subversion and then use the following command

  svn checkout svn://scm.gforge.inria.fr/svn/visp/trunk/ViSP ViSP-trunk

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

Configuring ViSP from source

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

  

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

  

• 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.

  
• Press Configure again.

Optional 3rd party packages

As mentioned previously, ViSP is interfaced with some 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

Once installed, if you want that ViSP exploit the new 3rd parties, you have to configure ViSP again.

Now we can finish the configuration stage by generating the Xcode project.

Generate 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.

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

• Base SDK : Latest iOS
• Supported Platforms : iOS
• Architectures : Standard (armv7, armv7s)

Generate ViSP library

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

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.