ViSP
Home
General overview
Download
Install from source
Install SDK
Documentation
FAQ
News
Overview
Visual servoing
Image processing
Computer vision
Simulation
Tools
Development
Third-party libraries
InriaGForge
SVN repository
Testing dashboard
Bug tracker
Support
Forum
Mailing lists
Contact us

Overview

This page describes how to build and install ViSP from source code on:

Additional information concerning ViSP build is provided in the getting started documents.

ViSP is interfaced with several optional third-party libraries. Below we indicate how to install most of them.
 

Installing ViSP under Windows

The reader should refer to the more complete getting started for Windows document.

  • Download the ViSP source distribution ViSP-2.6.0.zip
     
  • Install required CMake binary distribution:
    Download and install the lastest Win32 installer from http://www.cmake.org/cmake/resources/software.html.
     
  • Create a directory where you want to put ViSP source code.
     
  • Unzip ViSP-2.6.0.zip archive in this directory.
    You should have the following subdirectories:
    ls ViSP-2.6.0
        example
        include
        src
        test
        ...

  • Create a new directory where you want to build ViSP.
     
  • Build configuration files for your Visual Studio compiler:
    Start CMake GUI.
    Set ViSP source code path and the ViSP build directory path.
    Select your compiler (Visual Studio C++ 2003, 2005, 2008, ...).
    Press "Configure" button until "Generate" button is available.
    Press "Generate" button.
    Quit CMake GUI.
     
    Now in your ViSP build directory path you should found ViSP.sln, a Visual Studio solution file.
     
  • Build ViSP:
    Open ViSP.sln in Visual Studio.
    Set the Release configuration as active.
    Build "all projects" target.
     
    If the build was successful, it should have created libvisp-2.lib in the lib directory. The include files are in include/visp directory.
     
  • Install ViSP library (optional):
    ViSP installation helps the usage of ViSP as a third party library. If you don't want to install ViSP, you can also use ViSP as a third party library but in that case you need to set the VISP_DIR variable to indicate where you build ViSP.
    To install ViSP, in Visual Studio, build "install" target.
     
  • Generate html code API documentation (optional):
    To build the API documentation you may first install Doxygen and Graphviz tools.
     
    Then in Visual Studio, build "html-doc" target.
     
    The documentation entry point is in doc/html/index.html.

 

Installing ViSP under Linux Ubuntu

The reader should refer to the more complete getting started for Unix document.

  • Download the ViSP source distribution ViSP-2.6.0.zip
     
  • Install required CMake from existing Ubuntu packages:
    CMake cross-platform tool is required to build ViSP.
    sudo apt-get install cmake-curses-gui

  • Install optional dependencies from existing Ubuntu packages:
    Install X11, Lapack, Video For Linux, libdc1394, libxml2 third-party libraries.
    sudo apt-get install libx11-dev liblapack-dev libv4l-dev libdc1394-22-dev libxml2-dev

    Install libpng, libjpeg third-party libraries.
    sudo apt-get install libpng12-dev libjpeg62-dev

    Install ffmpeg third-party library.
    sudo apt-get install libswscale-dev libavutil-dev libavformat-dev libavcodec-dev libbz2-dev libbz2-1.0

    Install Coin third-party library.
    sudo apt-get install libcoin60-dev libsoqt4-dev

    Install Ogre 3D third-party library.
    sudo add-apt-repository ppa:ogre-team/ogre
    sudo apt-get update
    sudo apt-get install libogre-dev ogre-samples-media libois-dev

    Install OpenCV third-party library.
    sudo apt-get install libcv-dev libcvaux-dev libhighgui-dev

    Under Ubuntu Lucid 10.04 and Maverick 10.10, install libfreenect third-party library.
    Note that freenect is not packaged for Ubuntu Natty 11.04 and Oneiric 11.10.
    sudo apt-add-repository ppa:arne-alamut/freenect
    sudo apt-get update
    sudo apt-get install freenect
    Then set the video device rights with: sudo adduser your-login video

  • Install optional OpenCV third-party library from source code:
    Download the lastest OpenCV-2.3.0.tar.bz2 release from http://sourceforge.net/projects/opencvlibrary/.

    Unzip the tar ball:
    mkdir OpenCV
    cd OpenCV
    tar xvjf ../OpenCV-2.3.0.tar.bz2

    Build and install OpenCV:
    cd OpenCV-2.3.0
    mkdir build
    cd build
    cmake -DCMAKE_BUILD_TYPE=Release ..
    make
    sudo make install

  • Create a directory where you want to build ViSP:
    mkdir ViSP
    cd ViSP
    unzip ../ViSP-2.6.0.zip

    You should have the following subdirectories:
    ls ViSP-2.6.0
        example
        include
        src
        test
        ...

  • Build ViSP:
    mkdir ViSP-2.6.0/build
    cd ViSP-2.6.0/build
    cmake -DBUILD_SHARED_LIBS=ON -DUSE_SOQT=ON ..
    make

    If the build was successful, it should have created libvisp-2.so in the lib directory. The include files are in include/visp directory.
     
  • Install ViSP library (optional):
    ViSP installation helps the usage of ViSP as a third party library. If you don't want to install ViSP, you can also use ViSP as a third party library but in that case you need to set the VISP_DIR variable to indicate where you build ViSP.
  • To install ViSP, just run:
    sudo make install

  • Generate html code API documentation (optional):
    To build the API documentation you may first install Doxygen.
    sudo apt-get install doxygen graphviz texlive-latex-base

    Now you can generate the documentation:
    make html-doc

    The documentation entry point is in doc/html/index.html.

 

Installing ViSP under Linux Fedora

The reader should refer to the more complete getting started for Unix document.

  • Download the ViSP source distribution ViSP-2.6.0.zip
     
  • Install required CMake from existing Fedora packages:
    su -c "yum install cmake"

  • Install optional dependencies from existing Fedora packages:
    Install X11, Lapack, Video For Linux, libdc1394, libxml2 third-party libraries.
    su -c "yum install libX11-devel lapack-devel libv4l-devel libdc1394-devel libxml2-devel"

    Install libpng, libjpeg third-party libraries.
    su -c "yum install libpng-devel libjpeg-devel"

    Install ffmpeg third-party library.
    su -c "yum install ffmpeg-devel"

    Install Coin third-party library.
    su -c "yum install Coin2-devel SoQt-devel"

    Install Ogre 3D third-party library (only since Fedora 15).
    su -c "yum install ogre-devel ogre-samples ois-devel"

    Install OpenCV third-party library.
    su -c "yum install opencv-devel"

  • Install optional OpenCV third-party library from source code:
    Download the lastest OpenCV-2.3.0.tar.bz2 release from http://sourceforge.net/projects/opencvlibrary/.

    Unzip the tar ball:
    mkdir OpenCV
    cd OpenCV
    tar xvjf ../OpenCV-2.3.0.tar.bz2

    Build and install OpenCV:
    cd OpenCV-2.3.0
    mkdir build
    cd build
    cmake -DCMAKE_BUILD_TYPE=Release ..
    make
    su -c "make install"

  • Create a directory where you want to build ViSP:
    mkdir ViSP
    cd ViSP
    unzip ../ViSP-2.6.0.zip

    You should have the following subdirectories:
    ls ViSP-2.6.0
        example
        include
        src
        test
        ...

  • Build ViSP:
    mkdir ViSP-2.6.0/build
    cd ViSP-2.6.0/build
    cmake -DBUILD_SHARED_LIBS=ON -DUSE_SOQT=ON ..
    make

    If the build was successful, it should have created libvisp-2.so in the lib directory. The include files are in include/visp directory.
     
  • Install ViSP library (optional):
    ViSP installation helps the usage of ViSP as a third party library. If you don't want to install ViSP, you can also use ViSP as a third party library but in that case you need to set the VISP_DIR variable to indicate where you build ViSP.
  • To install ViSP, just run:
    su -c "make install"

  • Generate html code API documentation (optional):
    To build the API documentation you may first install Doxygen.
    su -c "yum install doxygen graphviz"

    Now you can generate the documentation:
    make html-doc

    The documentation entry point is in doc/html/index.html.

 

Installing ViSP under Mac OS X

The reader should refer to the more complete getting started for Unix document.

  • Download the ViSP source distribution ViSP-2.6.0.zip
     
  • Install required CMake binary distribution:
    Download and install the last .dmg installer from http://www.cmake.org/cmake/resources/software.html.
     
  • Install optional dependencies from existing OS X packages:
    Install X11, GSL, libxml2 third-party libraries.
    su -c "sudo fink install x11 x11-dev gsl libxml2"

    Install libpng, libjpeg third-party libraries.
    su -c "sudo fink install libpng3 libjpeg"

  • Install optional OpenCV third-party library from source code:
    Download the lastest OpenCV-2.3.0.tar.bz2 release from http://sourceforge.net/projects/opencvlibrary/.

    Unzip the tar ball:
    mkdir OpenCV
    cd OpenCV
    tar xvjf ../OpenCV-2.3.0.tar.bz2

    Build and install OpenCV:
    cd OpenCV-2.3.0
    mkdir build
    cd build
    cmake -DCMAKE_BUILD_TYPE=Release ..
    make
    sudo make install

  • Create a directory where you want to build ViSP:
    mkdir ViSP
    cd ViSP
    unzip ../ViSP-2.6.0.zip

    You should have the following subdirectories:
    ls ViSP-2.6.0
        example
        include
        src
        test
        ...

  • Build ViSP:
    mkdir ViSP-2.6.0/build
    cd ViSP-2.6.0/build
    cmake -DBUILD_SHARED_LIBS=ON ..
    make

    If the build was successful, it should have created libvisp-2.dylib in the lib directory. The include files are in include/visp directory.
     
  • Install ViSP library (optional):
    ViSP installation helps the usage of ViSP as a third party library. If you don't want to install ViSP, you can also use ViSP as a third party library but in that case you need to set the VISP_DIR variable to indicate where you build ViSP.
  • To install ViSP, just run:
    sudo make install

  • Generate html code API documentation (optional):
    To build the API documentation you may first install Doxygen.
    su -c "sudo fink install doxygen graphviz"

    Now you can generate the documentation:
    make html-doc

    The documentation entry point is in doc/html/index.html.
ViSP 2.6.1 latest release
Download
API documentation
Resources
Getting started
ViSP data set


| Lagadic | Map | Team | Publications | Demonstrations |
Irisa - Inria - Copyright 2012 © Lagadic Project