Skip to content

Building on Linux

Thorsten Bux edited this page Dec 5, 2017 · 5 revisions

Requirements

  • Compiler: GCC 4.4 is required. GCC 4.8 or later is recommended.

  • OpenGL: install libgl1-mesa-dev

  • libjpeg: install package libjpeg-dev

  • Video capture libraries: Video4Linux, lib1394dc, or GStreamer is required. The corresponding packages required to be installed in your package manager are: libv4l2-dev or libv4l-dev, libdc1394-22-dev1 (for lib1394 version 2.x) or libdc1394-13-dev (for lib1394 version 1.x), libgstreamer1.0-dev

Optional:

GLUT

Required to build libARgsub and the utilities and examples. Note: libARgsub_lite provides equivalent functionality to libARgsub without requiring GLUT. GLUT should be available in your distribution (e.g. packages freeglut3-dev and xorg-dev). Otherwise, GLUT is included in the MESA 3D libraries (e.g. libgl1-mesa-dev)

OpenSceneGraph (OSG)

For details see OSG

Install package libopenscenegraph-dev

Linux build chain

GNU: We recommend building ARToolKit with GNU gcc and g++ (answer first question of the configuration script with no). GNU is recommended because the OpenSceneGraph libraries provided by the package manager of your distribution also build with GNU.

Clang: If you prefer building with Clang, you need to install libc++-dev. Be aware that libARosg and some examples are excluded from this build because per default OpenSceneGraph comes compiled with GNU. If you would like to use them you need to compile OpenSceneGraph with Clang and then build libARosg and the examples manually.

Building

Building proceeds with the usual steps:

  • ./Configure
  • make

During the configure process, you will be asked to select video libraries to build against.

Verify installation

Launch simpleLite from a terminal window from inside the bin directory do ./simpleLite

Dependency shortcut

sudo apt-get install build-essential
sudo apt-get install libjpeg-dev
sudo apt-get install libgstreamer1.0-dev
sudo apt-get install libv4l-dev
sudo apt-get install libdc1394-22-dev
sudo apt-get install libgl1-mesa-dev
sudo apt-get install freeglut3-dev
sudo apt-get install libopenscenegraph-dev
sudo apt-get install libopencv-dev
sudo apt-get install libudev-dev