Getting started¶

AC can only be only compiled from source for now and runs only on Debian-based systems. The software is built with C++ and compiled with CMake into an executable. You can either download the source code and its GitHub submodules like this.

git clone --recurse-submodules https://github.com/ibois-epfl/augmented-carpentry.git

Dependecies¶

First refresh the package list and install the necessary dependencies:

apt-get -qq update && apt-get -qq -y install g++ cmake git git-lfs

And here's the system dependecies for the project:

apt-get -qq update && apt-get -qq -y install \
wget \
curl \
unzip \
xvfb \
freeglut3-dev \
libfreetype-dev \
libassimp-dev \
libboost-all-dev \
libeigen3-dev \
libglew-dev \
libglfw3-dev \
libglm-dev \
libgmp-dev \
libgoogle-glog-dev \
libmpfr-dev \
libimgui-dev \
libopencv-dev

The rest of the other dependecies will be automatically downloaded and installed by the CMake build system in the next steps.

Config and Build¶

Wearable Laptop

cd augmented-carpentry
cmake -S . -B build -DDEPLOY_ON_TOUCH=ON
cmake --build build

cd augmented-carpentry
cmake -S . -B build
cmake --build build

Tip

default_config.ini

While running the code, make sure that config.ini and assets/ exists in the current directory. If errors related to config present, please reconfigure the config.ini by copy-pasting the content from /assets/default_config.ini.

Run¶

To run the code be sure that your USB-Camera is connected and run the following command:

./build/bin/AC

That's it your are running Augmented Carpentry🪚!