PapARt installation

#Step 1: Hardware + software installation

Hardware installation

First of all, you have to check if every component is working properly.

###Camera

Linux

The webcam should be working out of the box. Once it is properly plugged in, you must test your camera: to do this you can use VLC or guvcview.

$ vlc v4l2:///dev/video0
or 
$ guvcview --device=/dev/video0 --resolution=640x480

The camera is working properly if the image is clear and smooth. The ideal resolution is 640*480.

Windows

If the camera works in any program, it will work with the "Processing" video input.

DepthCamera

Kinect

The kinect must be installed following the official openKinect guide. If you are on ubuntu or arch linux it is available through the package system:

$ sudo apt-get install freenect   # on Debian / Ubuntu 
 or 
$ sudo yaourt -S aur/libfreenect  # On Arch / Manjaro
 or yaourt libfreenect # and pick package #2

Note: if you are on ArchLinux, add this to your ..

Edit the /etc/default/grub file and change the GRUB_CMDLINE_LINUX_DEFAULT line to add the usbcore.autosuspend=-1 option:

GRUB_CMDLINE_LINUX_DEFAULT="quiet splash usbcore.autosuspend=-1"

After save the file, update grub:

sudo update-grub

Then test your kinect:

$ freenect-glview 

Important: you should test depth and color camera at the same time ie you see both of the video feeds.

RealSense

We use the open source drivers from Intel, follow their installation guide: librealsense.

###Projector The projector is a screen and it should also be instantly working. Start your projector to check if it's working properly. We recommand to set your projector as a second screen (on the right of your computer screen for example).

Important: The resolution used by the projector should be the one set in the calibration file => go see step 2.

Important: if you are using a computer screen and a projector, please note that the Processing applications can be launched only on projector by modifying this line in the settings() method:

fullScreen(P3D, 2);

if the projector is set as a second screen.

Processing installation

Download vanilla Processing, from Processing.org. The current version for PapARt is 3.2.3 (the next ones should also work). Install processing, to do so just unpack the archive to your home folder. We assume processing is installed here: ~/processing.

Test Processing:

$ ~/processing/processing

Libraries installation

Install the libraries from the main page

Testing

Start processing, and select: File -> Examples. In the pop-up window, go to: Contributed Libraries/PapARt/papart-examples/Camera/SeeThroughOnePaper and run the sketch.

If you have the correct hardware and followed the previous steps without errors you can try all of the examples and apps. They are listed in this dedicated github repository.

Next

Go to step 2 to configure your hardware!